chore(docs): docs/ 目录全面重新编号 + 重组

**重构前**（旧编号 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 行
2026-08-03 18:46:55 +08:00
parent 3a44141eac
commit 44e77dcb0e
494 changed files with 78494 additions and 14075 deletions
@@ -0,0 +1,118 @@
+classDiagram
+    direction LR
+
+    %% ====== 数据模型（已存在） ======
+    class Message {
+        +UUID id
+        +UUID conversation_id
+        +string sender_type
+        +string sender_id
+        +string content
+        +string msg_type
+        +dict extra_data
+        +datetime created_at
+        +string status
+    }
+
+    class OptionSelectExtraData {
+        +string question_id
+        +string option_id
+        +string option_value
+        +string client_msg_id
+        +string selected_from_message_id
+        +string option_label_masked
+        +string option_label_original
+    }
+    OptionSelectExtraData --o Message : embedded in extra_data JSONB
+
+    %% ====== 服务类（已存在 + v1.1 新增） ======
+    class OptionSelectHandler {
+        +__init__(session_factory)
+        +handle(payload, employee_id) Message
+        -acquire_advisory_lock(db, key)
+        -find_duplicate(db, payload)
+        -persist(db, payload, employee_id)
+    }
+
+    class ConnectionManager {
+        +dict active_connections
+        +dict employee_connections
+        +__init__()
+        +broadcast(data)
+        +broadcast_to_employees(ids, data)
+    }
+    OptionSelectHandler --> ConnectionManager : broadcast + broadcast_to_employees (v1.1)
+
+    %% ★ 新增 v1.1
+    class BackendObserver {
+        <<singleton>>
+        +list events
+        +record_event(metric_name, value, tags) void
+        +get_metrics(name_filter) list
+        +metric_names$ list~string~
+    }
+    ConnectionManager ..> BackendObserver : triggers latency record
+    OptionSelectHandler ..> BackendObserver : commit_ts record
+
+    class SensitiveMask {
+        <<utility>>
+        +mask_sensitive_text(text) string
+        +mask_sensitive_value(value) string
+    }
+    class H5MessageEndpoint {
+        +h5_get_messages(limit, before)
+        -_mask_outbound(messages) list
+    }
+    H5MessageEndpoint --> SensitiveMask : masks option_select content
+
+    %% ====== 前端 store / component ======
+    class ConversationStore {
+        +Message[] messages
+        +bool wsConnected
+        +Ref~string[]~ selectedOptionLabels
+        +Ref~string[]~ selectedOptionIdsFromHistory
+        +sendOptionSelect(value,label,sourceId,qId,oId) void
+        +handleNewMessage(data) void
+        +handleAiReply(data) void
+        +groupedMessagesByQuestion() Message[]
+        +latestSelectionForQuestion(qId) string|null
+    }
+    ConversationStore o-- Message : owns
+
+    class MessageBubble {
+        +Message msg
+        +bool isLatestInGroup
+        +bool isOptionSelectedComputed
+        +computed data-question-id
+    }
+    MessageBubble --> ConversationStore : reads
+    MessageBubble --> Message : renders
+
+    class ChatPanel {
+        +computed groupedMessages
+        +render bubbles
+    }
+    ChatPanel --> ConversationStore : groupedMessagesByQuestion
+    ChatPanel --> MessageBubble : iter
+
+    class UseH5WebSocket {
+        +Ref wsConnected
+        +computed rttMs
+        +onmessage handler
+    }
+    UseH5WebSocket --> BackendObserver : report e2e latency
+    UseH5WebSocket --> ConversationStore : dispatch
+
+    class MeasureOptionLatencyScript {
+        <<puppeteer script>>
+        +run() Report
+        -employeeClick() timestamp
+        -agentRender() timestamp
+        -diff() ms
+    }
+    MeasureOptionLatencyScript ..> BackendObserver : queries metrics
+
+    %% 不变量标注
+    note for ConversationStore "selectedOptionLabels v1.1 标 deprecated\n仅作日志兼容, UI 判定走 selectedOptionIdsFromHistory"
+    note for BackendObserver "命名约定: {feature}_{aspect}_{metric}_{unit}\n例: option_select_broadcast_latency_ms"
+    note for Message "msg_type 选项 select 类型\nv1.1 不引入新枚举"