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
    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[🖥 创建活动 /create]:::portAdmin
        A2 --> A3[🖥 设置基本信息：标题/描述/封面/维度]:::portAdmin
        A3 --> A4[🖥 设置活动类型 offline/online/campaign]:::portAdmin
        A4 --> A5[🖥 设置时间地点：开始/结束/位置]:::portAdmin
        A5 --> A6[🖥 设置报名规则]:::portAdmin
        A6 --> A7{🖥 是否限制人数?}:::portAdmin
        A7 -->|是| A8[🖥 设置最大人数 maxParticipants]:::portAdmin
        A7 -->|否| A9[不限制人数]
        A8 --> A10[🖥 设置价格体系]:::portAdmin
        A9 --> A10
        A10 --> A11[🖥 普通价 price]:::portAdmin
        A11 --> A12[🖥 会员价 memberPrice]:::portAdmin
        A12 --> A13[🖥 签到积分 checkinPoints]:::portAdmin
        A13 --> A14[🖥 设置可见范围 public/restricted/member]:::portAdmin
        A14 --> A15[🖥 保存草稿]:::portAdmin
    end

    subgraph 活动审核流程
        A15 --> B1[🖥 提交审核 /submit-review]:::portAdmin
        B1 --> B2{🖥 管理员审核 /audit}:::portAdmin
        B2 -->|通过| B3[活动发布]
        B2 -->|驳回| B4[🖥 查看驳回原因]:::portAdmin
        B4 --> B5[🖥 编辑后重新提交]:::portAdmin
        B5 --> B1
    end

    subgraph 发布与下架
        B3 --> C1[🖥 发布活动 /publish]:::portAdmin
        C1 --> C2[活动上线]
        C2 --> C3{活动到期或结束操作}
        C3 -->|手动结束| C4[🖥 结束活动 /end]:::portAdmin
        C3 -->|截止时间到| C4
        C4 --> C5[活动结束<br/>不可再报名]
    end

    subgraph 用户浏览与报名
        C2 --> D1(("👤 家长")):::portMiniApp --> D2[📱 浏览活动列表 /list]:::portMiniApp
        D2 --> D3[📱 查看详情 /detail]:::portMiniApp
        D3 --> D4{📱 报名条件检查}:::portMiniApp
        D4 -->|人数已满| D5[📱 提示已满员]:::portMiniApp
        D4 -->|已截止| D6[📱 提示报名结束]:::portMiniApp
        D4 -->|可报名| D7[📱 选择参加的孩子 childId]:::portMiniApp
        D7 --> D8[📱 填写参加人身份信息]:::portMiniApp
        D8 --> D9{📱 用户会员等级}:::portMiniApp
        D9 -->|普通用户| D10[📱 普通价 price]:::portMiniApp
        D9 -->|会员用户| D11[📱 会员价 memberPrice]:::portMiniApp
        D10 --> D12[📱 提交报名 /register]:::portMiniApp
        D11 --> D12
        D12 --> D13{📱 报名需审核?}:::portMiniApp
        D13 -->|是| D14[📱 等待管理员审批]:::portMiniApp
        D13 -->|否| D15[📱 报名成功]:::portMiniApp
        D14 --> D16{🖥 管理员操作}:::portAdmin
        D16 -->|通过| D15
        D16 -->|拒绝| D17[📱 报名被驳回]:::portMiniApp
    end

    subgraph 报名管理
        D15 --> E1[📱 我的报名 /my-registrations]:::portMiniApp
        E1 --> E2{📱 活动开始前?}:::portMiniApp
        E2 -->|是| E3[📱 取消报名 /cancel-registration]:::portMiniApp
        E2 -->|否| E4[📱 等待签到]:::portMiniApp
    end

    subgraph 签到
        E4 --> F1[📱 签到 /checkin]:::portMiniApp
        F1 --> F2{📱 需审核签到?}:::portMiniApp
        F2 -->|是| F3[📱 等待审核]:::portMiniApp
        F2 -->|否| F4[📱 签到成功<br/>发放积分]:::portMiniApp
    end

    subgraph 活动反馈（活动结束后）
        C5 --> G1[📱 已签到参与者]:::portMiniApp
        G1 --> G2[📱 提交活动反馈]:::portMiniApp
    end

    subgraph 管理员报名管理
        D14 --> H1[🖥 报名列表 /admin/activity/registration/list]:::portAdmin
        H1 --> H2[🖥 审批 /approve]:::portAdmin
        H2 --> H3[🖥 拒绝 /reject]:::portAdmin
    end

    subgraph 管理后台
        B2 --> I1[🖥 活动列表 /admin/activity/list]:::portAdmin
        I1 --> I2[🖥 活动审核 /review]:::portAdmin
        I2 --> I3[🖥 撤回 /withdraw]:::portAdmin
        I3 --> I4[🖥 转草稿 /re-draft]:::portAdmin
    end

    R1(("🔧 活动管理员<br/>role=activity_admin")):::actor
    R2(("👤 家长")):::actor
    R3(("👶 孩子")):::role
    R4(("🔧 管理员")):::role

    A1 -.- R1
    D1 -.- R2
    D7 -.- R3
    B2 -.- R4

业务规则

规则	说明
角色	活动由 activity_admin（活动管理员）管理，非规划师。admin 也可管理。
替他人报名	家长可替多个孩子报名，每个报名需指定 childId
身份信息	报名时需填写参加人的信息（孩子信息）
价格分层	price 普通价 vs memberPrice 会员价，不同级别用户不同价格
人数限制	maxParticipants=0/null 表示不限制人数
报名截止	endTime 即报名截止时间
自动截止	达到 maxParticipants 或超过 endTime 自动停止报名
签到	活动签到 checkin，可设置签到审核和签到积分 checkinPoints
反馈	活动结束后，已签到的参与者可提交反馈

端点明细

端点	说明	端口
/api/activity/list	活动列表（支持维度过滤+分页）	📱小程序
/api/activity/detail	活动详情	📱小程序
/api/activity/register	报名（activityId + childId）	📱小程序
/api/activity/cancel-registration	取消报名	📱小程序
/api/activity/my-registrations	我的报名列表	📱小程序
/api/activity/checkin	签到	📱小程序
/api/activity/create	创建活动（需admin/activity_admin）	🖥管理后台
/api/activity/update	修改活动（需admin/activity_admin）	🖥管理后台
/api/activity/publish	发布活动	🖥管理后台
/api/activity/end	结束活动	🖥管理后台
/api/admin/activity/list	管理员活动列表	🖥管理后台
/api/admin/activity/detail	活动详情	🖥管理后台
/api/admin/activity/review	审核	🖥管理后台
/api/admin/activity/submit-review	提交审核	🖥管理后台
/api/admin/activity/audit	审批(通过/驳回)	🖥管理后台
/api/admin/activity/withdraw	撤回审核	🖥管理后台
/api/admin/activity/re-draft	转草稿	🖥管理后台
/api/admin/activity/registration/list	报名列表	🖥管理后台
/api/admin/activity/registration/approve	审批报名通过	🖥管理后台
/api/admin/activity/registration/reject	拒绝报名	🖥管理后台