|
|
@@ -0,0 +1,125 @@
|
|
|
+# 用户使用流程图 — DAN专注力测评
|
|
|
+
|
|
|
+```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
|
|
|
+
|
|
|
+ subgraph 注册与准备
|
|
|
+ P1(("家长<br>开始")) --> P2[微信授权登录]
|
|
|
+ P2 --> P3[创建/加入家庭]
|
|
|
+ P3 --> P4[添加孩子为家庭成员]
|
|
|
+ end
|
|
|
+
|
|
|
+ subgraph 选购套餐与下单
|
|
|
+ P4 --> S1[浏览测评套餐/材料<br>POST /material/list]
|
|
|
+ S1 --> S2[选择成长规划师<br>浏览规划师列表]
|
|
|
+ S2 --> S3{是否首次测评?}
|
|
|
+ S3 -->|是| S4[填写孩子信息快照<br>身高/体重/学校等]
|
|
|
+ S3 -->|否| S5[选择已有孩子档案]
|
|
|
+ S4 --> S6[创建订单含预约信息<br>POST /order/create]
|
|
|
+ S5 --> S6
|
|
|
+ S6 --> S7[选择支付方式<br>POST /order/pay]
|
|
|
+ S7 --> S8[支付完成<br>订单状态: paid]
|
|
|
+ end
|
|
|
+
|
|
|
+ subgraph 预约与执行
|
|
|
+ S8 --> A1[系统创建预约记录<br>POST /appointment/create]
|
|
|
+ A1 --> A2[规划师确认预约<br>POST /appointment/confirm]
|
|
|
+ A2 --> A3[家长与孩子赴约<br>线下/线上测评]
|
|
|
+ A3 --> A4[规划师完成测评执行<br>POST /appointment/complete]
|
|
|
+ end
|
|
|
+
|
|
|
+ subgraph 结果录入与上传
|
|
|
+ A4 --> R1{报告来源?}
|
|
|
+ R1 -->|系统执行端录入| R2[规划师录入测评结果<br>POST /result/record]
|
|
|
+ R1 -->|PDF报告上传| R3[上传DAN PDF报告<br>POST /dan-assessment/report/parse-preview]
|
|
|
+
|
|
|
+ R3 --> R4[AI解析PDF<br>Phase 1 /parse-preview]
|
|
|
+ R4 --> R5[家长预览解析结果<br>编辑/确认]
|
|
|
+ R5 --> R6[确认入库<br>Phase 2 /confirm]
|
|
|
+ R6 --> R7[独立化流程: <br>/api/dan-report/confirm]
|
|
|
+ R7 --> R8[完成分析<br>/complete-analysis]
|
|
|
+
|
|
|
+ R2 --> R9[测评结果写入<br>DanAssessmentResult]
|
|
|
+ R8 --> R9
|
|
|
+ end
|
|
|
+
|
|
|
+ subgraph 测评报告与AI解读
|
|
|
+ R9 --> V1[家长查看测评报告]
|
|
|
+ V1 --> V2{是否需要<br>AI解读?}
|
|
|
+ V2 -->|是| V3[AI聊天解读<br>POST /api/ai/chat/send<br>传入 reportId]
|
|
|
+ V3 --> V4[AI分析各维度得分<br>注意力/记忆力/逻辑等]
|
|
|
+ V4 --> V5[AI生成个性化建议<br>训练方案/改善计划]
|
|
|
+ V5 --> V6[家长查看AI解读结果]
|
|
|
+ V2 -->|否| M1
|
|
|
+ end
|
|
|
+
|
|
|
+ subgraph 专业身份介入
|
|
|
+ V6 --> M1{是否需要<br>深度服务?}
|
|
|
+ M1 -->|全方位跟进| M2[管家介入]
|
|
|
+ M1 -->|成长规划| M3[规划师深度介入]
|
|
|
+ M1 -->|自行训练| M4[查看成长档案]
|
|
|
+
|
|
|
+ M2 --> M2a[申请管家服务]
|
|
|
+ M2a --> M2b[管家审核建档]
|
|
|
+ M2b --> M2c[管家协调规划师+营养师]
|
|
|
+ M2c --> M2d[定期跟踪测评进展]
|
|
|
+ M2d --> M4
|
|
|
+
|
|
|
+ M3 --> M3a[规划师分析测评报告]
|
|
|
+ M3a --> M3b[规划师制定成长任务]
|
|
|
+ M3b --> M3c[孩子执行任务<br>含小游戏训练]
|
|
|
+ M3c --> M3d[规划师审核任务]
|
|
|
+ M3d --> M3e[调整下一阶段方案]
|
|
|
+ M3e --> M4
|
|
|
+ end
|
|
|
+
|
|
|
+ subgraph 成长档案追踪
|
|
|
+ M4 --> T1[测评结果进入成长档案<br>GrowthRecordController]
|
|
|
+ T1 --> T2[系统生成五维能量变化]
|
|
|
+ T2 --> T3[家长查看成长趋势]
|
|
|
+ T3 --> T4{是否需要<br>下一轮测评?}
|
|
|
+ T4 -->|是| S1
|
|
|
+ T4 -->|否| T5[结束]
|
|
|
+ end
|
|
|
+
|
|
|
+ %% ============ 角色标注 ============
|
|
|
+ RP1(("👤 家长")):::actor
|
|
|
+ RC(("👶 孩子")):::actor
|
|
|
+ RT(("📋 成长规划师")):::role
|
|
|
+ RA(("🤖 AI教练")):::role
|
|
|
+ RB(("🏠 管家")):::role
|
|
|
+
|
|
|
+ P4 -.- RC
|
|
|
+ S2 -.- RT
|
|
|
+ A2 -.- RT
|
|
|
+ A4 -.- RT
|
|
|
+ V3 -.- RA
|
|
|
+ M2 -.- RB
|
|
|
+ M3 -.- RT
|
|
|
+```
|
|
|
+
|
|
|
+## 角色说明
|
|
|
+
|
|
|
+| 角色 | 系统映射 | 职责 |
|
|
|
+|:----|:---------|:-----|
|
|
|
+| **家长** | `role=parent` | 发起测评、选购套餐、下单支付、查看报告、选择服务 |
|
|
|
+| **孩子** | `role=child` | 接受测评、执行训练任务 |
|
|
|
+| **成长规划师** | `role=teacher` | 确认预约、执行测评、录入结果、制定改善任务、审核跟踪 |
|
|
|
+| **AI教练** | `AIChatController` + Dify + DAN知识库 | 自动解析PDF报告、解读维度得分、生成建议与训练方案 |
|
|
|
+| **管家** | `ButlerService` / `butler` role | 全程服务协调，对接规划师/营养师等资源 |
|
|
|
+| **管理员** | `role=admin` | 测评材料管理、套餐配置、审核管理（后台） |
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 文件保存位置
|
|
|
+
|
|
|
+- **身体健康检测流程图**: `docs/flows/health-detection-flow.md`
|
|
|
+- **DAN测评流程图**: `docs/flows/dan-assessment-flow.md`
|
|
|
+
|
|
|
+> 使用支持 Mermaid 的 Markdown 渲染器（如 GitHub、VS Code 插件）查看流程图。两张图分别覆盖了完整的用户旅程和所有角色交互节点。
|
iwt