cfc/docs/flows/activity-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,shape:box

    subgraph 活动浏览
        A1(("用户")) --> A2[获取活动列表 /list]
        A2 --> A3[获取活动详情 /detail]
    end

    subgraph 报名参与
        A3 --> B1[报名活动 /register]
        B1 --> B2[取消报名 /cancel-registration]
        B2 --> B3[获取我的报名 /my-registrations]
        B3 --> B4[活动签到 /checkin]
    end

    subgraph 规划师活动管理
        A1 --> C1[获取活动列表 /guide/activities/list]
        C1 --> C2[获取详情 /guide/activities/detail]
        C2 --> C3[创建活动 /guide/activities/create]
        C3 --> C4[更新活动 /guide/activities/update]
        C4 --> C5[发布活动 /guide/activities/publish]
        C5 --> C6[取消活动 /guide/activities/cancel]
        C6 --> C7[删除活动 /guide/activities/delete]
    end

    subgraph 管理员审核
        C5 --> D1[活动审核 /admin/activity/review]
        D1 --> D2[提交审核 /admin/activity/submit-review]
        D2 --> D3[审批通过/驳回 /admin/activity/audit]
        D3 --> D4[撤回审核 /admin/activity/withdraw]
        D4 --> D5[重新编辑 /admin/activity/re-draft]
    end

    R1(("👤 用户/规划师")):::actor
    R2(("🔧 管理员")):::role

    A1 -.- R1
    D1 -.- R2

端点明细

端点	说明
/api/activity/list	活动列表
/api/activity/detail	活动详情
/api/activity/create	创建活动
/api/activity/update	更新活动
/api/activity/publish	发布活动
/api/activity/end	结束活动
/api/activity/register	报名活动
/api/activity/cancel-registration	取消报名
/api/activity/my-registrations	我的报名
/api/activity/checkin	签到
/api/guide/activities/list	规划师活动列表
/api/guide/activities/detail	规划师活动详情
/api/guide/activities/create	创建活动(规划师)
/api/guide/activities/update	更新活动
/api/guide/activities/publish	发布活动
/api/guide/activities/cancel	取消活动
/api/guide/activities/delete	删除活动
/api/admin/activity/list	管理员活动列表
/api/admin/activity/review	活动审核
/api/admin/activity/audit	审批操作