# 用户使用流程图 — 管理后台

> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
>
> **分层说明**: 🏠 页面 → 🔗 API → ⚙️ Service → 📦 数据实体

```mermaid
flowchart TD
    %% ============ 颜色定义 ============
    classDef page fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
    classDef api fill:#fff3e0,stroke:#f57c00,stroke-width:1px
    classDef service fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
    classDef data fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
    classDef actor fill:#e1f5fe,stroke:#0288d1,stroke-width:2px,stroke-dasharray:5 3

    %% ============ 角色 ============
    RP(("🔧 管理员")):::actor

    %% ================================================================
    %% 阶段一：管理员认证
    %% ================================================================
    subgraph 阶段一[阶段一：管理员认证]
        direction TB
        P1["🏠 管理后台：登录页"]:::page
        P1 -->|"发送验证码"| A1["🔗 POST /api/admin-auth/send-code"]:::api
        A1 -->|"手机号"| S1["⚙️ VerificationCodeService.generateCode()"]:::service
        S1 -->|"验证码, 过期时间"| D1["📦 sms_codes 表（写入）"]:::data

        P1 -->|"验证码登录"| A2["🔗 POST /api/admin-auth/login"]:::api
        A2 -->|"手机号, 验证码"| S2["⚙️ AdminAuthController.login()"]:::service
        S2 -->|"用户信息"| D_USER["📦 users 表（查询）"]:::data

        P1 -->|"密码登录"| A2a["🔗 POST /api/admin-auth/login-by-password"]:::api
        A2a -->|"手机号, 密码"| S2a["⚙️ 密码校验 + JWT生成"]:::service
        S2a -->|"用户信息"| D_USER

        D_USER -->|"用户ID, 角色"| S_JWT["⚙️ JwtConfig.generateToken()"]:::service
        S_JWT -->|"JWT token"| D_JWT["📦 JWT Token（返回前端）"]:::data

        D_JWT -->|"token"| P2["🏠 管理后台：首页"]:::page
        P2 -->|"获取管理员信息"| A3["🔗 POST /api/admin-auth/info"]:::api
        A3 -->|"用户ID（token提取）"| S3["⚙️ 用户信息查询"]:::service
        S3 -->|"管理员信息"| D_USER

        P2 -->|"修改密码"| A4["🔗 POST /api/admin-auth/change-password"]:::api
        A4 -->|"旧密码, 新密码"| S4["⚙️ UserService.setPassword()"]:::service
        S4 -->|"更新密码字段"| D_USER
    end

    %% ================================================================
    %% 阶段二：用户与家庭管理
    %% ================================================================
    subgraph 阶段二[阶段二：用户与家庭管理]
        P2 -->|"用户列表"| B1["🏠 管理后台：用户管理页"]:::page
        B1 -->|"分页参数, 角色筛选"| A5["🔗 POST /api/admin/users"]:::api
        A5 -->|"userId, role, page"| S5["⚙️ UserMapper.selectPage()"]:::service
        S5 -->|"分页用户列表"| D_USER

        B1 -->|"创建用户"| A6["🔗 POST /api/admin/users/create"]:::api
        A6 -->|"手机号, 昵称, 角色"| S6["⚙️ 创建用户记录"]:::service
        S6 -->|"新用户记录"| D_USER

        B1 -->|"用户详情"| A7["🔗 POST /api/admin/users/{id}"]:::api
        A7 -->|"用户ID"| S7["⚙️ UserMapper.selectById()"]:::service

        B1 -->|"更新用户"| A8["🔗 POST /api/admin/users/{id}/update"]:::api
        A8 -->|"用户ID, 更新字段"| S8["⚙️ UserMapper.updateById()"]:::service

        B1 -->|"重置密码"| A9["🔗 POST /api/admin/users/{id}/reset-password"]:::api
        A9 -->|"用户ID, 新密码"| S9["⚙️ UserService.resetPassword()"]:::service

        B1 -->|"搜索用户"| A10["🔗 POST /api/admin/user/search"]:::api
        A10 -->|"关键词"| S10["⚙️ 模糊搜索（nickname/phone/realName）"]:::service

        B1 -->|"删除用户"| A11["🔗 POST /api/admin/users/{id}/delete"]:::api
        A11 -->|"用户ID"| S11["⚙️ UserService.deleteUser()"]:::service

        P2 -->|"孩子管理"| C1["🏠 管理后台：孩子管理页"]:::page
        C1 -->|"分页"| A12["🔗 POST /api/admin/children"]:::api
        C1 -->|"详情"| A13["🔗 POST /api/admin/children/{id}"]:::api
        C1 -->|"更新"| A14["🔗 POST /api/admin/children/{id}/update"]:::api
        C1 -->|"调整积分"| A15["🔗 POST /api/admin/children/{id}/adjust-points"]:::api
        A15 -->|"孩子ID, 积分数额, 原因"| S15["⚙️ 积分调整 + PointsLog写入"]:::service
        S15 -->|"更新余额, 写入流水"| D_POINTS["📦 family_members + points_logs"]:::data

        P2 -->|"家庭管理"| D1["🏠 管理后台：家庭管理页"]:::page
        D1 -->|"列表"| A16["🔗 POST /api/admin/families"]:::api
        D1 -->|"详情"| A17["🔗 POST /api/admin/families/{id}"]:::api
        D1 -->|"成员"| A18["🔗 POST /api/admin/families/{id}/members"]:::api
        D1 -->|"更新"| A19["🔗 POST /api/admin/families/{id}/update"]:::api
        D1 -->|"删除"| A20["🔗 POST /api/admin/families/{id}/delete"]:::api
        A18 -->|"家庭ID"| S18["⚙️ 查询家长列表 + 孩子列表"]:::service
        S18 -->|"家长+孩子数据"| D_FAMILY["📦 families + users + family_members"]:::data
    end

    %% ================================================================
    %% 阶段三：任务与奖励审核
    %% ================================================================
    subgraph 阶段三[阶段三：任务与奖励审核]
        P2 -->|"任务列表"| E1["🏠 管理后台：任务管理页"]:::page
        E1 -->|"分页, 状态筛选"| A21["🔗 POST /api/admin/tasks"]:::api
        A21 -->|"page, status, familyId"| S21["⚙️ TaskMapper.selectPage()"]:::service
        S21 -->|"分页任务列表"| D_TASK["📦 tasks 表"]:::data
        E1 -->|"任务统计"| A22["🔗 POST /api/admin/tasks/stats"]:::api
        A22 -->|""| S22["⚙️ 任务总数 + 今日任务数"]:::service

        P2 -->|"奖励列表"| F1["🏠 管理后台：奖励管理页"]:::page
        F1 -->|"分页, 状态"| A23["🔗 POST /api/admin/rewards"]:::api
        F1 -->|"模板列表"| A24["🔗 POST /api/admin/rewards/templates"]:::api
        F1 -->|"创建模板"| A25["🔗 POST /api/admin/rewards/create"]:::api
        F1 -->|"审批通过/拒绝"| A26["🔗 POST /api/admin/rewards/{id}/approve"]:::api
        A26 -->|"奖励ID, approved标志"| S26["⚙️ 状态更新 + 积分退还（拒绝时）"]:::service
        S26 -->|"更新奖励状态, 退积分"| D_TASK
    end

    %% ================================================================
    %% 阶段四：积分与模板管理
    %% ================================================================
    subgraph 阶段四[阶段四：积分与模板管理]
        P2 -->|"积分日志"| G1["🏠 管理后台：积分管理页"]:::page
        G1 -->|"分页, 孩子ID, 类型"| A27["🔗 POST /api/admin/points/logs"]:::api
        A27 -->|"childId, type, page"| S27["⚙️ PointsLogMapper.selectPage()"]:::service
        S27 -->|"分页积分流水"| D_POINTS
        G1 -->|"积分统计"| A28["🔗 POST /api/admin/points/stats"]:::api
        A28 -->|""| S28["⚙️ 孩子总数统计"]:::service

        P2 -->|"任务模板"| H1["🏠 管理后台：任务模板页"]:::page
        H1 -->|"列表"| A29["🔗 POST /api/admin/task-templates"]:::api
        H1 -->|"详情"| A30["🔗 POST /api/admin/task-templates/{id}"]:::api
        H1 -->|"创建"| A31["🔗 POST /api/admin/task-templates/create"]:::api
        H1 -->|"更新"| A32["🔗 POST /api/admin/task-templates/{id}/update"]:::api
        H1 -->|"删除"| A33["🔗 POST /api/admin/task-templates/{id}/delete"]:::api
        A31 -->|"模板内容"| S31["⚙️ TaskTemplateMapper.insert()"]:::service
        S31 -->|"新模板记录"| D_TTPL["📦 task_templates 表"]:::data
    end

    %% ================================================================
    %% 阶段五：规划师审核与套餐
    %% ================================================================
    subgraph 阶段五[阶段五：规划师审核与套餐]
        P2 -->|"规划师审核"| I1["🏠 管理后台：规划师审核页"]:::page
        I1 -->|"待审批列表"| A34["🔗 POST /api/admin/guide/applications"]:::api
        I1 -->|"待审批数量"| A34a["🔗 POST /api/admin/guide/pending-count"]:::api
        I1 -->|"通过"| A35["🔗 POST /api/admin/guide/approve/{userId}"]:::api
        I1 -->|"驳回"| A36["🔗 POST /api/admin/guide/reject/{userId}"]:::api
        A35 -->|"用户ID"| S35["⚙️ 更新user角色 + 创建admins记录"]:::service
        S35 -->|"更新users表, 插入admins表"| D_USER

        I1 -->|"规划师列表"| A37["🔗 POST /api/admin/guide/guides"]:::api
        I1 -->|"等级筛选"| A38["🔗 POST /api/admin/guide/guides/level/{level}"]:::api

        P2 -->|"套餐管理"| I2["🏠 管理后台：套餐管理页"]:::page
        I2 -->|"套餐列表"| A39["🔗 POST /api/admin/guide/packages"]:::api
        I2 -->|"创建套餐"| A40["🔗 POST /api/admin/guide/packages/create"]:::api
        I2 -->|"更新"| A41["🔗 POST /api/admin/guide/packages/{id}/update"]:::api
        I2 -->|"状态"| A42["🔗 POST /api/admin/guide/packages/{id}/status"]:::api
        A40 -->|"套餐内容"| S40["⚙️ GuidePackageService.save()"]:::service
        S40 -->|"新套餐记录"| D_GPKG["📦 guide_packages 表"]:::data

        P2 -->|"营养师审核"| I3["🏠 管理后台：营养师审核页"]:::page
        I3 -->|"列表"| A43["🔗 POST /api/admin/nutritionist/applications"]:::api
        I3 -->|"通过"| A44["🔗 POST /api/admin/nutritionist/approve/{userId}"]:::api
        I3 -->|"驳回"| A45["🔗 POST /api/admin/nutritionist/reject/{userId}"]:::api
    end

    %% ================================================================
    %% 阶段六：商品与订单
    %% ================================================================
    subgraph 阶段六[阶段六：商品与订单管理]
        P2 -->|"商品管理"| J1["🏠 管理后台：商品管理页"]:::page
        J1 -->|"列表"| A46["🔗 POST /api/admin/product/list"]:::api
        J1 -->|"审核"| A47["🔗 POST /api/admin/product/review"]:::api
        J1 -->|"上下架"| A48["🔗 POST /api/admin/product/shelve"]:::api
        J1 -->|"创建"| A49["🔗 POST /api/admin/product/create"]:::api
        J1 -->|"更新"| A50["🔗 POST /api/admin/product/update"]:::api
        J1 -->|"删除"| A51["🔗 POST /api/admin/product/delete"]:::api
        A47 -->|"productId, action"| S47["⚙️ ProductService.review()"]:::service
        S47 -->|"更新审核状态"| D_PROD["📦 products 表"]:::data

        P2 -->|"订单管理"| K1["🏠 管理后台：订单管理页"]:::page
        K1 -->|"列表"| A52["🔗 POST /api/admin/product/order/list"]:::api
        K1 -->|"详情"| A53["🔗 POST /api/admin/product/order/detail"]:::api
        K1 -->|"发货"| A54["🔗 POST /api/admin/product/order/ship"]:::api
        K1 -->|"退款审核"| A55["🔗 POST /api/admin/product/order/refund/approve"]:::api
        K1 -->|"关闭订单"| A56["🔗 POST /api/admin/product/order/close"]:::api
        A54 -->|"orderNo, trackingNumber, expressCompany"| S54["⚙️ ProductOrderService.ship()"]:::service
        S54 -->|"更新发货状态"| D_ORDER["📦 product_orders 表"]:::data
    end

    %% ================================================================
    %% 阶段七：系统配置
    %% ================================================================
    subgraph 阶段七[阶段七：系统配置]
        P2 -->|"食材管理"| L1["🏠 管理后台：食材管理页"]:::page
        L1 -->|"CRUD"| A57["🔗 POST /api/admin/foods/*"]:::api
        A57 -->|"食材数据"| S57["⚙️ FoodService CRUD"]:::service
        S57 -->|"食材记录"| D_FOOD["📦 foods 表"]:::data

        P2 -->|"能量配置"| L2["🏠 管理后台：五维能量配置页"]:::page
        L2 -->|"来源列表"| A58["🔗 POST /api/admin/energy-config/source-list"]:::api
        A58 -->|""| S58["⚙️ 查询能量来源配置"]:::service
        S58 -->|"能量来源配置列表"| D_ENERGY["📦 energy_source_config 表"]:::data

        P2 -->|"会员管理"| L3["🏠 管理后台：会员管理页"]:::page
        L3 -->|"等级列表"| A59["🔗 POST /api/admin/membership/levels"]:::api
        L3 -->|"概览"| A60["🔗 POST /api/admin/membership/overview"]:::api

        P2 -->|"测评订单"| L4["🏠 管理后台：测评管理页"]:::page
        L4 -->|"待分配列表"| A61["🔗 POST /api/admin/assessment/pending-list"]:::api
        L4 -->|"可用规划师"| A62["🔗 POST /api/admin/assessment/available-guides"]:::api
        L4 -->|"订单列表"| A63["🔗 POST /api/admin/assessment/orders"]:::api
        L4 -->|"分配规划师"| A64["🔗 POST /api/admin/assessment/assign-guide"]:::api
    end

    RP -.- P1
    RP -.- P2
```

## 端点明细

### 管理员认证

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin-auth/send-code` | 发送管理员登录验证码 | 🖥管理后台 | `{phone}` | `{success}` |
| `POST /api/admin-auth/login` | 验证码登录 | 🖥管理后台 | `{phone, code}` | `{token, adminId, username, role, roles}` |
| `POST /api/admin-auth/login-by-password` | 密码登录 | 🖥管理后台 | `{phone, password}` | `{token, adminId, username, role, roles}` |
| `POST /api/admin-auth/info` | 获取当前管理员信息 | 🖥管理后台 | Header: `Authorization` | `{id, nickname, phone, role, roles, user}` |
| `POST /api/admin-auth/change-password` | 修改密码 | 🖥管理后台 | `{oldPassword, newPassword}` | `{success}` |
| `POST /api/admin-auth/update-info` | 更新个人信息 | 🖥管理后台 | `{nickname, phone}` | `{nickname, phone}` |
| `POST /api/admin-auth/reset-password` | 验证码重置密码 | 🖥管理后台 | `{phone, code, newPassword}` | `{success}` |

### 用户管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/users` | 用户分页列表 | 🖥管理后台 | `{page, size, role, nickname, phone}` | `Page<User>` |
| `POST /api/admin/users/create` | 创建用户 | 🖥管理后台 | `{phone, nickname, role, realName}` | `User` |
| `POST /api/admin/users/{id}` | 用户详情 | 🖥管理后台 | path: `id` | `User` |
| `POST /api/admin/users/{id}/update` | 更新用户 | 🖥管理后台 | path: `id`, body: `User字段` | `{success}` |
| `POST /api/admin/users/{id}/reset-password` | 重置用户密码 | 🖥管理后台 | path: `id`, body: `{password}` | `{success}` |
| `POST /api/admin/user/search` | 搜索用户（下拉选择用） | 🖥管理后台 | `{keyword}` | `List<User>` |
| `POST /api/admin/users/{id}/delete` | 删除用户 | 🖥管理后台 | path: `id` | `{success}` |

### 孩子管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/children` | 孩子分页列表 | 🖥管理后台 | `{page, size}` | `Page<FamilyMember>` |
| `POST /api/admin/children/{id}` | 孩子详情 | 🖥管理后台 | path: `id` | `FamilyMember` |
| `POST /api/admin/children/{id}/update` | 更新孩子信息 | 🖥管理后台 | path: `id`, body: `FamilyMember字段` | `{success}` |
| `POST /api/admin/children/{id}/adjust-points` | 手动调整孩子积分 | 🖥管理后台 | path: `id`, body: `{amount, reason}` | `{newBalance}` |

### 家庭管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/families` | 家庭分页列表 | 🖥管理后台 | `{page, size, name}` | `Page<Family>` |
| `POST /api/admin/families/{id}` | 家庭详情 | 🖥管理后台 | path: `id` | `Family` |
| `POST /api/admin/families/{id}/members` | 家庭成员详情（含家长+孩子） | 🖥管理后台 | path: `id` | `{family, parents, children}` |
| `POST /api/admin/families/{id}/update` | 更新家庭信息 | 🖥管理后台 | path: `id`, body: `Family字段` | `{success}` |
| `POST /api/admin/families/{id}/delete` | 删除家庭 | 🖥管理后台 | path: `id` | `{success}` |

### 任务管理与奖励

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/tasks` | 任务分页列表 | 🖥管理后台 | `{page, size, status, familyId}` | `Page<Task>` |
| `POST /api/admin/tasks/stats` | 任务统计 | 🖥管理后台 | — | `{total, today}` |
| `POST /api/admin/rewards` | 奖励分页列表 | 🖥管理后台 | `{page, size, status, familyId}` | `Page<Reward>` |
| `POST /api/admin/rewards/templates` | 获取奖励模板列表 | 🖥管理后台 | — | `List<Reward>` |
| `POST /api/admin/rewards/create` | 创建奖励模板 | 🖥管理后台 | `Reward字段` | `{id}` |
| `POST /api/admin/rewards/{id}/approve` | 审批奖励兑换 | 🖥管理后台 | path: `id`, body: `{approved}` | `{success}` |

### 积分管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/points/logs` | 积分日志分页 | 🖥管理后台 | `{page, size, childId, type}` | `Page<PointsLog>` |
| `POST /api/admin/points/stats` | 积分统计概览 | 🖥管理后台 | — | `{totalChildren}` |

### 任务模板管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/task-templates` | 模板分页列表 | 🖥管理后台 | `{page, size, category, difficulty, isActive}` | `Page<TaskTemplate>` |
| `POST /api/admin/task-templates/{id}` | 模板详情 | 🖥管理后台 | path: `id` | `TaskTemplate` |
| `POST /api/admin/task-templates/create` | 创建模板 | 🖥管理后台 | `TaskTemplate字段` | `{id}` |
| `POST /api/admin/task-templates/{id}/update` | 更新模板 | 🖥管理后台 | path: `id`, body: `TaskTemplate字段` | `{success}` |
| `POST /api/admin/task-templates/{id}/delete` | 删除模板 | 🖥管理后台 | path: `id` | `{success}` |

### 规划师审核

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/guide/applications` | 规划师申请列表 | 🖥管理后台 | `{page, size, status}` | `Page<User>` |
| `POST /api/admin/guide/applications/pending` | 待审批申请列表 | 🖥管理后台 | — | `List<GuideApplication>` |
| `POST /api/admin/guide/approve/{userId}` | 通过规划师审核 | 🖥管理后台 | path: `userId` | `{success}` |
| `POST /api/admin/guide/reject/{userId}` | 驳回规划师审核 | 🖥管理后台 | path: `userId`, body: `{reason}` | `{success}` |
| `POST /api/admin/guide/pending-count` | 待审核数量 | 🖥管理后台 | — | `{count}` |
| `POST /api/admin/guide/applications/{id}/approve` | 通过申请（AdminGuideController） | 🖥管理后台 | path: `id`, param: `adminId` | `{success}` |
| `POST /api/admin/guide/applications/{id}/reject` | 驳回申请 | 🖥管理后台 | path: `id`, param: `adminId, reason` | `{success}` |
| `POST /api/admin/guide/guides` | 规划师列表 | 🖥管理后台 | — | `List<Guide>` |
| `POST /api/admin/guide/guides/level/{level}` | 按等级筛选规划师 | 🖥管理后台 | path: `level` | `List<Guide>` |

### 套餐与商品管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/guide/packages` | 套餐列表 | 🖥管理后台 | — | `List<GuidePackage>` |
| `POST /api/admin/guide/packages/create` | 创建套餐 | 🖥管理后台 | `GuidePackage字段` | `{success}` |
| `POST /api/admin/guide/packages/{id}/update` | 更新套餐 | 🖥管理后台 | path: `id`, body: `GuidePackage字段` | `{success}` |
| `POST /api/admin/guide/packages/{id}/status` | 更新套餐状态 | 🖥管理后台 | path: `id`, param: `status` | `{success}` |
| `POST /api/admin/guide/packages/pending` | 待审核套餐数量 | 🖥管理后台 | — | `{count}` |
| `POST /api/admin/product/list` | 商品分页列表 | 🖥管理后台 | `{page, size, status, productType, keyword}` | `{records, total}` |
| `POST /api/admin/product/review` | 审核商品（通过/驳回） | 🖥管理后台 | `{productId, action, reason}` | `Result` |
| `POST /api/admin/product/shelve` | 商品上下架 | 🖥管理后台 | `{productId, shelve}` | `Result` |
| `POST /api/admin/product/create` | 创建商品 | 🖥管理后台 | `ProductCreateRequest` | `ProductDTO` |
| `POST /api/admin/product/update` | 更新商品 | 🖥管理后台 | `ProductCreateRequest` | `ProductDTO` |
| `POST /api/admin/product/delete` | 删除商品 | 🖥管理后台 | `{productId}` | `Result` |
| `POST /api/admin/product/detail` | 商品详情 | 🖥管理后台 | `{productId}` | `ProductDTO` |

### 订单管理

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/product/order/list` | 订单分页列表 | 🖥管理后台 | `{page, size, status, keyword, startDate, endDate}` | `{records, total}` |
| `POST /api/admin/product/order/detail` | 订单详情 | 🖥管理后台 | `{orderNo}` | `ProductOrderDTO` |
| `POST /api/admin/product/order/ship` | 订单发货 | 🖥管理后台 | `{orderNo, trackingNumber, expressCompany}` | `Result` |
| `POST /api/admin/product/order/close` | 关闭订单 | 🖥管理后台 | `{orderNo}` | `Result` |
| `POST /api/admin/product/order/refund/approve` | 退款审核通过 | 🖥管理后台 | `{orderNo}` | `Result` |
| `POST /api/admin/product/order/refund/reject` | 退款审核拒绝 | 🖥管理后台 | `{orderNo}` | `Result` |

### 系统配置

| 端点 | 说明 | 端口 | 请求数据 | 响应数据 |
|------|------|------|---------|---------|
| `POST /api/admin/foods/list` | 食材列表 | 🖥管理后台 | `{category}` | `List<Map>` |
| `POST /api/admin/foods/create` | 新增食材 | 🖥管理后台 | `Food字段` | `Food` |
| `POST /api/admin/foods/update` | 更新食材 | 🖥管理后台 | `Food字段` | `{success}` |
| `POST /api/admin/foods/delete` | 删除食材 | 🖥管理后台 | `{id}` | `{success}` |
| `POST /api/admin/foods/detail` | 食材详情（含应季月份） | 🖥管理后台 | `{id}` | `Map` |
| `POST /api/admin/foods/saveMonths` | 保存应季月份 | 🖥管理后台 | `{id, months}` | `{success}` |
| `POST /api/admin/energy-config/source-list` | 能量来源配置列表 | 🖥管理后台 | — | `List<Map>` |
| `POST /api/admin/membership/levels` | 会员等级列表 | 🖥管理后台 | — | `List<MembershipLevel>` |
| `POST /api/admin/membership/overview` | 会员概览统计 | 🖥管理后台 | — | `{freeCount, familyCount, providerCount, ...}` |
| `POST /api/admin/membership/upgrade-records` | 会员升级记录 | 🖥管理后台 | `{page, size}` | `Page<MemberUpgradeRecord>` |
| `POST /api/admin/assessment/pending-list` | 待分配规划师的测评列表 | 🖥管理后台 | `{page, size}` | `{records, total}` |
| `POST /api/admin/assessment/available-guides` | 可选规划师列表 | 🖥管理后台 | — | `List<Map>` |
| `POST /api/admin/assessment/orders` | 测评订单列表 | 🖥管理后台 | `{page, size, status, keyword}` | `{records, total}` |
| `POST /api/admin/assessment/assign-guide` | 分配规划师 | 🖥管理后台 | `{appointmentId, guideId}` | `null` |
| `POST /api/admin/assessment/change-guide` | 更换规划师 | 🖥管理后台 | `{orderId, guideId}` | `null` |
| `POST /api/admin/nutritionist/applications` | 营养师申请列表 | 🖥管理后台 | `{page, size, status}` | `Page<User>` |
| `POST /api/admin/nutritionist/approve/{userId}` | 通过营养师审核 | 🖥管理后台 | path: `userId` | `{success}` |
| `POST /api/admin/nutritionist/reject/{userId}` | 驳回营养师审核 | 🖥管理后台 | path: `userId`, body: `{reason}` | `{success}` |

## 完整性分析

| # | 维度 | 评估 | 说明 |
|---|------|------|------|
| 1 | **流程完整性** | ✅ 完整 | 覆盖管理员认证、用户/孩子/家庭管理、任务/奖励审核、积分/模板管理、规划师/营养师审核、商品/订单管理、系统配置共7个阶段 |
| 2 | **异常路径** | ⚠️ 部分覆盖 | Token过期引导重新登录已覆盖；验证码错误、密码错误、重复手机号等在Service层处理，前端已有提示 |
| 3 | **端点覆盖** | ✅ 完整 | 52+个端点全部映射到流程图中，涵盖AdminAuthController、AdminController、AdminGuideController、AdminProductController、AdminProductOrderController、AdminFoodController、AdminEnergyConfigController |
| 4 | **角色覆盖** | ✅ 完整 | 管理员(admin)全量管理功能覆盖；规划师(teacher)审核等跨角色操作已标注 |
| 5 | **数据实体** | ✅ 完整 | users、family_members、families、tasks、rewards、points_logs、task_templates、guide_packages、products、product_orders、foods、admins等表均在图中映射 |
| 6 | **一致性** | ✅ 与代码一致 | 所有端点路径与实际Controller中的`@PostMapping`匹配，无重复路由 |