docs: test reports + knowledge iteration design + PRDs

提交 OTP/RBAC/Tier0/Tier1/P0+P2 测试报告、方案A E2E 验证、知识库迭代设计(PRD/mermaid/html 原型)、项目状态看板更新; 根配置 docker-compose.yml/mkdocs.yml。
2026-07-09 11:50:19 +08:00
parent 584c975e7f
commit e4e2de47bb
21 changed files with 3311 additions and 214 deletions
@@ -27,7 +27,7 @@

 | 编号 | 决策 | 本 PRD 落地要点 |
 |------|------|----------------|
-| D1 | 存储边界：2.5 桥接 | `KnowledgeSuggestion` 预埋图结构字段（issue/action/relation_type/parent_issue 等）；Neo4j 落地后 `approve_suggestion` 一步双写。当前仅预埋，不连 Neo4j。 |
+| D1 | 存储边界：解读2 合一（直接写 Neo4j 图） | 知识迭代产出**直接写 Neo4j 图**（图即真相源）；`KnowledgeSuggestion` 携带图结构字段（issue/action/relation_type/parent_issue 等）；flat `KnowledgeBase` 降为图的派生视图，非独立存储。 |
 | D2 | AI 后端 | **Dify 生成**（复用 `WingmanService` 的 `generate_summary`/`suggest_tags` 范式）+ **RAGFlow** 作非标准文档格式输入的上游 ingestion/ETL 第一道筛选/整理。二者互补。 |
 | D3 | 置信门控 | AI 回复统一输出 `confidence`；低于**全局阈值 0.7** 时前端渲染"转人工"入口并附已收集上下文；上线后按**转人工率**回调。 |
 | D4 | 一次一问 | 分诊卡片**自适应**（AI 判断复杂度决定一次给几步）+ **专家模式开关**（老手可一把梭）。 |
@@ -47,8 +47,8 @@ flowchart LR
    B[通道B: 训练师<br/>直接录入] -->|手动| KS
    C[通道C: 文档<br/>非标准格式] -->|RAGFlow 整理/ETL| KS
    KS -->|D7 内联审批/独立队列| APPROVE[approve_suggestion]
-    APPROVE -->|D1 2.5桥接·当前仅flat KB| KB[(KnowledgeBase<br/>Postgres)]
-    APPROVE -.->|D1 未来动作·不实现| NEO[(Neo4j 图存储<br/>Issue/Action/关系)]
+    APPROVE -->|D1 解读2·直接写图| NEO[(Neo4j 图存储<br/>Issue/Action/关系)]
+    NEO -.->|派生视图| KB[(KnowledgeBase<br/>Postgres 派生)]
 ```

 - **通道 A（P0/P1，痛点⑤核心）**：会话 → Dify → `KnowledgeSuggestion`（自动）。覆盖分诊门控、坐席代答、vision、置信门控。
@@ -188,7 +188,7 @@ stateDiagram-v2

 ### 7.1 依赖项（前置，本 PRD 不实现）
 - **RBAC 修复（P0 安全漏洞，看板验真④）**：`app/api/admin_users.py` 鉴权 422 失效。训练师审批写入、独立队列读取依赖正常角色鉴权，须作为**独立 BugFix 轨道**先解（P0-7 已列为依赖）。
- **Neo4j 未来双写（2.5 桥接后续动作）**：本 PRD 仅定义**字段契约**（P0-4）与**未来双写占位**（`graph_sync_status='pending'`），**不实现** Neo4j 客户端（当前 backend 无 Neo4j 模块，重构方案 v1.1 为其落点）。
+- **Neo4j 直接写图（解读2 合一）**：本 PRD 定义**字段契约**（P0-4）并要求**实现 Neo4j 客户端 + 图 schema 作为前置阶段**（当前 backend 无 Neo4j 模块，须新建；技术方向见主 PRD `../02-产品需求/02-产品需求文档PRD-v1.2-20260704.md` §11.1）

 ### 7.2 明确不在范围
 - **敏感词 BLOCK 升级**：已决仅 WARN（看板验真⑤）。本 PRD 不升级为 BLOCK；截图隐私仅留接口（D6）。
@@ -207,7 +207,7 @@ stateDiagram-v2
 6. **坐席代答边界**：P1-2 坐席排除错误项后，若用户迟迟不确认，坐席能否发提醒 / 是否允许超时自动采用"推荐标记"项（仍须用户最终确认）？
 7. **Qwen-VL 部署资源**：D5 本地部署的显存/算力是否就绪？视觉理解的延迟 SLA 与降级策略？
 8. **audience 枚举**：D8 目前 `employee_quick_reply` / `engineer_workguide` 两类，是否需第三类（如"管理运营 KB"）？
-9. **2.5 桥接双写触发时机**：Neo4j 落地后 `approve_suggestion` 双写的具体发布窗口（本 PRD 不实现，仅占位）。
+9. **Neo4j 图客户端与图 schema 的分期**：前置实现落在 Tier0 还是随 Tier1（本 PRD 要求实现，分期见架构设计）。

 ---