Simon
44e77dcb0e
**重构前**（旧编号 02-11）： - docs/02-产品需求/ → 00 产品规划/PRD - docs/03-技术架构/ → 01-05 子目录散落 - docs/04-原型设计/ → 01-02 产品设计（HTML 原型） - docs/05-原型设计/ → screens/ - docs/06-测试素材/ → 02-E2E / 03-功能 / 04-版本测试 - docs/07-项目管理/ → 任务说明书/日报/计划 - docs/08-安全审计/ → 审计报告 - docs/09-堡垒运维/ → toolbox / deploy - docs/10-项目管理/ → 任务说明书（重复） - docs/11-历史归档/ → deploy-nas-archived **重构后**（新编号 00-07，语义化）： - docs/00-产品开发流程与文档管理规范.md - docs/00-版本迭代总览.md - docs/01-产品文档/ （PRD/原型/认证/会话/AI 服务/坐席/集成） - docs/02-技术文档/ （技术方案/架构图/重构记录/前端改造/实现配置） - docs/03-测试文档/ （E2E/功能用例/版本报告/缺陷单） - docs/04-运维文档/ （部署运维/运维指南） - docs/05-运营文档/ （品牌推广/用户手册） - docs/06-安全审计/ （审计报告） - docs/07-项目管理/ （任务说明书/日报/计划/看板） **净收益**： - 目录编号与产品文档管理规范对齐（按文档阶段 01-07 编号） - 消除 02-产品需求 与 10-项目管理 的编号重叠 - 子目录按文档类型分组（如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录） - 把运维/安全/项目管理从 0X 散落改为 04/06/07 合计 494 文件 + 78495 行 / - 14076 行
75 lines
3.3 KiB
Plaintext
75 lines
3.3 KiB
Plaintext
%% 分诊主流程时序图
|
|
%% 来源：增量设计-知识库迭代-开发任务分解-20260712.md §2.5
|
|
|
|
sequenceDiagram
|
|
participant H5 as H5 员工端
|
|
participant API as FastAPI 后端
|
|
participant TriSvc as TriageService
|
|
participant DifyTri as Dify 分诊应用
|
|
participant DB as PostgreSQL
|
|
participant AG as 坐席端看板
|
|
participant WS as WebSocket
|
|
|
|
rect rgb(255, 243, 224)
|
|
Note over H5,DB: 阶段1：发起分诊
|
|
H5->>API: POST /api/h5/triage/start {conversation_id, question}
|
|
API->>TriSvc: start_triage(conversation_id, question)
|
|
TriSvc->>DB: INSERT triage_sessions (status=triaging)
|
|
TriSvc->>DifyTri: 调用分诊 prompt（拆分问题为分步选择题）
|
|
alt Dify 5秒内响应
|
|
DifyTri-->>TriSvc: {steps[], confidence, urgency, suggested_route, problem_type}
|
|
TriSvc->>DB: UPDATE triage_sessions SET triage_steps, confidence, urgency, suggested_route
|
|
TriSvc-->>API: {triage_id, steps, total, confidence, urgency, suggested_route}
|
|
API-->>H5: {triage_id, steps, total, ...}
|
|
else Dify 超时(>5s)
|
|
TriSvc->>DB: UPDATE triage_sessions SET status=timeout
|
|
TriSvc-->>API: 超时，自动转人工
|
|
API-->>H5: 分诊超时，已转人工
|
|
end
|
|
end
|
|
|
|
rect rgb(227, 242, 253)
|
|
Note over H5,DB: 阶段2：分步选择 + 坐席协同
|
|
loop 每一步
|
|
H5->>API: POST /api/h5/triage/step {triage_id, step_index, selected_label}
|
|
API->>TriSvc: submit_step(triage_id, step_index, selected_label)
|
|
TriSvc->>DB: 记录 collected_context
|
|
TriSvc->>DifyTri: 根据选择动态调整后续步骤
|
|
DifyTri-->>TriSvc: next_step
|
|
TriSvc-->>API: {next_step, collected_context}
|
|
API-->>H5: {next_step, collected_context}
|
|
end
|
|
|
|
Note over AG: 坐席看板实时查看分诊进度
|
|
AG->>API: GET /api/agent/triage/pending
|
|
API-->>AG: 待分诊列表
|
|
AG->>API: GET /api/agent/triage/{triage_id}
|
|
API-->>AG: 分诊详情
|
|
|
|
opt 坐席排除选项
|
|
AG->>API: POST /api/agent/triage/{triage_id}/exclude-options {excluded_labels}
|
|
API->>WS: WS 推送 excluded_labels 到 H5
|
|
WS-->>H5: {type: "triage_exclude", excluded_labels}
|
|
H5->>H5: TriageCard.setExcludedOptions(labels)
|
|
end
|
|
end
|
|
|
|
rect rgb(232, 245, 233)
|
|
Note over H5,DB: 阶段3：分诊完成 / 转人工
|
|
alt 所有步骤完成
|
|
H5->>API: POST /api/h5/triage/complete {triage_id, context}
|
|
API->>TriSvc: complete_triage(triage_id, context)
|
|
TriSvc->>DifyTri: 根据收集的上下文生成最终回复
|
|
DifyTri-->>TriSvc: {reply, confidence}
|
|
TriSvc->>DB: UPDATE triage_sessions SET status=routed, route_action=ai_self
|
|
TriSvc-->>API: {reply, confidence}
|
|
API-->>H5: AI 回复
|
|
else 转人工
|
|
H5->>API: POST /api/h5/triage/transfer {triage_id, context}
|
|
API->>TriSvc: transfer_to_human(triage_id, context)
|
|
TriSvc->>DB: UPDATE triage_sessions SET status=routed, route_action=human
|
|
TriSvc-->>API: 转人工成功
|
|
API-->>H5: 已转人工
|
|
end
|
|
end
|