cfc/docs/flows/admin-overview-flow.md

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

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

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	运行状态	⚙️系统自动