cfc/docs/flows/market-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(("👤 家长")):::portMiniApp --> A2[📱 获取公开模板列表 /packages]:::portMiniApp
        A2 --> A3[📱 获取模板详情 /packages/:id]:::portMiniApp
        A3 --> A4[📱 获取任务项 /packages/:id/items]:::portMiniApp
        A4 --> A5[📱 通过分享码获取 /share/:code]:::portMiniApp
    end

    subgraph 购买流程
        A5 --> B1[📱 获取模板价格 /price]:::portMiniApp
        B1 --> B2[📱 获取可用指导师 /available-guides]:::portMiniApp
        B2 --> B3[📱 创建订单 /order/create]:::portMiniApp
        B3 --> B4[⚙️ 获取微信支付参数 /wechat params]:::portSystem
        B4 --> B5[⚙️ 微信支付回调 /notify]:::portSystem
        B5 --> B6[⚙️ 支付成功后应用 /apply]:::portSystem
        B6 --> B7[📱 购买并应用模板 /packages/:id/purchase]:::portMiniApp
    end

    subgraph 我的计划
        B7 --> C1[📱 获取我的计划 /plans]:::portMiniApp
        C1 --> C2[📱 获取计划详情 /plans/:id]:::portMiniApp
        C2 --> C3[📱 获取计划任务项 /plans/:id/items]:::portMiniApp
        C3 --> C4[📱 取消计划 /plans/:id/cancel]:::portMiniApp
    end

    subgraph 模板创建(管理员/规划师)
        A2 --> D1[🖥 创建模板 /create]:::portAdmin
        D1 --> D2[🖥 更新模板 /:id/update]:::portAdmin
        D2 --> D3[🖥 添加任务项 /:id/items]:::portAdmin
        D3 --> D4[🖥 提交审核 /:id/submit]:::portAdmin
        D4 --> D5[🖥 审核通过后发布 /:id/publish]:::portAdmin
    end

    R1(("👤 家长")):::actor
    R2(("📋 规划师/管理员")):::role
    R3(("💳 微信支付")):::system

    A1 -.- R1
    D1 -.- R2
    B5 -.- R3

端点明细

端点	说明	端口
/api/market/packages	获取公开模板列表	📱小程序
/api/market/packages/{id}	获取模板详情	📱小程序
/api/market/packages/{id}/items	获取任务项	📱小程序
/api/market/share/{code}	通过分享码获取	📱小程序
/api/market/packages/{id}/purchase	购买并应用	📱小程序
/api/market/plans	获取我的计划	📱小程序
/api/market/plans/{id}	计划详情	📱小程序
/api/market/plans/{id}/items	计划任务项	📱小程序
/api/market/plans/{id}/cancel	取消计划	📱小程序
/api/package/price	模板价格	📱小程序
/api/package/available-guides	可用指导师	📱小程序
/api/package/order/create	创建订单	📱小程序
/api/package/order/{orderNo}	订单详情	📱小程序
/api/payment/create	创建支付订单	📱小程序
/api/payment/wechat params	微信支付参数	⚙️系统自动
/api/payment/notify	支付回调	⚙️系统自动
/api/payment/apply	应用模板	⚙️系统自动
/api/packages/create	创建模板	🖥管理后台
/api/packages/{id}/update	更新模板	🖥管理后台
/api/packages/{id}/submit	提交审核	🖥管理后台
/api/packages/{id}/publish	发布/下架	🖥管理后台