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

> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动

```mermaid
flowchart TD
    %% ============ 颜色定义 ============
    classDef actor fill:#e1f5fe,stroke:#0288d1,stroke-width:2px
    classDef action fill:#fff3e0,stroke:#f57c00,stroke-width:1px
    classDef system fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
    classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
    classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
    classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2

    subgraph 管理员登录
        A1(("🔧 管理员")):::portAdmin --> A2[🖥 发送验证码 /send-code]:::portAdmin
        A2 --> A3[🖥 登录 /login]:::portAdmin
        A3 --> A4[🖥 获取信息 /info]:::portAdmin
        A4 --> A5[🖥 修改密码 /change-password]:::portAdmin
        A5 --> A6[🖥 密码登录 /login-by-password]:::portAdmin
    end

    subgraph 用户管理
        A6 --> B1[🖥 用户列表 /admin/users]:::portAdmin
        B1 --> B2[🖥 创建用户 /admin/users/create]:::portAdmin
        B2 --> B3[🖥 用户详情 /admin/users/:id]:::portAdmin
        B3 --> B4[🖥 更新用户 /admin/users/:id/update]:::portAdmin
        B4 --> B5[🖥 重置密码 /admin/users/:id/reset-password]:::portAdmin
        B5 --> B6[🖥 搜索用户 /admin/user/search]:::portAdmin
        B6 --> B7[🖥 删除用户 /admin/users/:id/delete]:::portAdmin
    end

    subgraph 孩子管理
        B7 --> C1[🖥 孩子列表 /admin/children]:::portAdmin
        C1 --> C2[🖥 详情 /admin/children/:id]:::portAdmin
        C2 --> C3[🖥 更新 /admin/children/:id/update]:::portAdmin
        C3 --> C4[🖥 调整积分 /admin/children/:id/adjust-points]:::portAdmin
    end

    subgraph 家庭管理
        C4 --> D1[🖥 家庭列表 /admin/families]:::portAdmin
        D1 --> D2[🖥 详情 /admin/families/:id]:::portAdmin
        D2 --> D3[🖥 成员 /admin/families/:id/members]:::portAdmin
        D3 --> D4[🖥 更新 /admin/families/:id/update]:::portAdmin
        D4 --> D5[🖥 删除 /admin/families/:id/delete]:::portAdmin
    end

    subgraph 任务审核
        D5 --> E1[🖥 任务列表 /admin/tasks]:::portAdmin
        E1 --> E2[🖥 任务统计 /admin/tasks/stats]:::portAdmin
    end

    subgraph 奖励审核
        E2 --> F1[🖥 奖励列表 /admin/rewards]:::portAdmin
        F1 --> F2[🖥 模板列表 /admin/rewards/templates]:::portAdmin
        F2 --> F3[🖥 创建模板 /admin/rewards/create]:::portAdmin
        F3 --> F4[🖥 审批 /admin/rewards/:id/approve]:::portAdmin
    end

    subgraph 积分管理
        F4 --> G1[🖥 积分日志 /admin/points/logs]:::portAdmin
        G1 --> G2[🖥 积分统计 /admin/points/stats]:::portAdmin
    end

    subgraph 任务模板管理
        G2 --> H1[🖥 模板列表 /admin/task-templates]:::portAdmin
        H1 --> H2[🖥 创建 /admin/task-templates/create]:::portAdmin
    end

    subgraph 规划师审核
        H2 --> I1[🖥 待审批列表 /admin/guide/applications/pending]:::portAdmin
        I1 --> I2[🖥 审批通过 /admin/guide/applications/:id/approve]:::portAdmin
        I2 --> I3[🖥 驳回 /admin/guide/applications/:id/reject]:::portAdmin
        I3 --> I4[🖥 列表 /admin/guide/guides]:::portAdmin
    end

    subgraph 商品审核
        I4 --> J1[🖥 商品列表 /admin/product/list]:::portAdmin
        J1 --> J2[🖥 审核商品 /admin/product/review]:::portAdmin
        J2 --> J3[🖥 上下架 /admin/product/shelve]:::portAdmin
    end

    subgraph 订单管理
        J3 --> K1[🖥 订单列表 /admin/product/order/list]:::portAdmin
        K1 --> K2[🖥 发货 /admin/product/order/ship]:::portAdmin
        K2 --> K3[🖥 退款审核 /admin/product/order/refund/approve]:::portAdmin
    end

    subgraph 系统管理
        K3 --> L1[⚙️ 健康检查 /system/health]:::portSystem
    end

    R1(("🔧 管理员")):::actor
    R2(("📊 统计系统")):::system

    A1 -.- R1
    E2 -.- R2
```

## 主要管理端点

| 领域 | 端点示例 | 说明 | 端口 |
|------|----------|------|------|
| 认证 | `/api/admin-auth/login` | 管理员登录 | 🖥管理后台 |
| 用户 | `/api/admin/users` | 用户管理 | 🖥管理后台 |
| 孩子 | `/api/admin/children` | 孩子管理 | 🖥管理后台 |
| 家庭 | `/api/admin/families` | 家庭管理 | 🖥管理后台 |
| 任务 | `/api/admin/tasks` | 任务管理 | 🖥管理后台 |
| 奖励 | `/api/admin/rewards` | 奖励审批 | 🖥管理后台 |
| 积分 | `/api/admin/points/logs` | 积分管理 | 🖥管理后台 |
| 模板 | `/api/admin/task-templates` | 任务模板 | 🖥管理后台 |
| 规划师 | `/api/admin/guide/applications/pending` | 规划师审批 | 🖥管理后台 |
| 商品 | `/api/admin/product/review` | 商品审核 | 🖥管理后台 |
| 订单 | `/api/admin/product/order/list` | 订单管理 | 🖥管理后台 |
| 健康 | `/api/system/health` | 运行状态 | ⚙️系统自动 |