docs(mvp): organize mvp documentation

2026-07-09 13:40:08 +08:00
parent 9c9a0024d4
commit 841437fa06
57 changed files with 452 additions and 675 deletions
@@ -0,0 +1,40 @@
+# MVP 数据表索引
+
+**更新日期**：2026-07-09  
+**状态**：当前表文档入口
+
+本目录保存当前 MVP 使用的数据表说明。详细结构以 Flyway migration 和实体类为准；本目录用于面试讲解、排查索引和快速理解数据流。
+
+## 当前表
+
+| 表 | 用途 | 文档 |
+|---|---|---|
+| `diagnosis_session` | 会话级主记录，保存 query、状态、最终答案和自评估 | [诊断会话表-diagnosis_session.md](诊断会话表-diagnosis_session.md) |
+| `agent_step` | Agent 步骤记录，按 `step_index` 回放执行链路 | [Agent步骤表-agent_step.md](Agent步骤表-agent_step.md) |
+| `tool_invocation` | 工具调用记录，支撑 Trace、Verifier 和评测 | [工具调用表-tool_invocation.md](工具调用表-tool_invocation.md) |
+| `api_document` | 知识库文档元数据，和向量库 chunk 通过 `doc_id` 关联 | [文档元数据表-api_document.md](文档元数据表-api_document.md) |
+| `knowledge_domain` | 知识域元数据，支撑 RAG domain hint 和检索策略 | [知识域表-knowledge_domain.md](知识域表-knowledge_domain.md) |
+| `case_library` | 用户反馈沉淀出的高质量诊断案例 | [案例库表-case_library.md](案例库表-case_library.md) |
+
+## 已归档表
+
+| 表 | 归档原因 | 文档 |
+|---|---|---|
+| `diagnosis_record` | 已由 `V007` 删除，被 `diagnosis_session + agent_step + tool_invocation` 替代 | [archive/2026-07-09-doc-cleanup/旧诊断记录表-diagnosis_record.md](archive/2026-07-09-doc-cleanup/旧诊断记录表-diagnosis_record.md) |
+
+## 核心关系
+
+```text
+diagnosis_session.session_id
+  -> agent_step.session_id
+  -> tool_invocation.session_id
+  -> case_library.diagnosis_id
+
+api_document.doc_id
+  -> vector chunk metadata.docId / doc_id
+
+knowledge_domain.domain_id
+  -> api_document metadata.category / vector chunk metadata.category
+```
+
+当前实现主要使用逻辑关联，不依赖数据库外键。