zhuyongxin
7ae9707a3b
Persist provider reasoning and assistant text separately on agent_reasoning_audit (DeepSeekAssistantMessage path), extract diagnosis_run.conclusion, enrich RAG tool audit (step_id/query/qualityScore), gate empty mysql tools, drop devtools, and align MVP docs after live E2E verification.
MVP 数据表索引
更新日期：2026-07-23 状态：当前表文档入口
本目录保存当前 MVP 使用的数据表说明。详细结构以 Flyway migration 和实体类为准；本目录用于面试讲解、排查索引和快速理解数据流。
当前表
| 表 | 用途 | 文档 |
|---|---|---|
chat_session |
Chat 会话目录 metadata；不保存完整消息历史 | 聊天会话表-chat_session.md |
diagnosis_run |
/api/chat 运行主记录，保存 intent、终态与安全发布结果 |
诊断运行表-diagnosis_run.md |
agent_step |
Diagnosis Agent metadata-only 模型步骤审计 | Agent步骤表-agent_step.md |
tool_invocation |
Harness ToolBoundary metadata-only 长期审计 | 工具调用表-tool_invocation.md |
diagnosis_trace_event |
按 Run 追加的统一诊断生命周期 Timeline | 诊断Trace事件表-diagnosis_trace_event.md |
agent_reasoning_audit |
Provider reasoning 独立敏感审计；不属于普通 Trace | Agent推理审计表-agent_reasoning_audit.md |
api_document |
知识库文档元数据，和向量库 chunk 通过 doc_id 关联 |
文档元数据表-api_document.md |
knowledge_domain |
知识域元数据，支撑 RAG domain hint 和检索策略 | 知识域表-knowledge_domain.md |
case_library |
用户反馈沉淀出的高质量诊断案例 | 案例库表-case_library.md |
diagnosis_session |
历史兼容和回滚表，新执行写入不再依赖它 | 诊断会话表-diagnosis_session.md |
已归档表
| 表 | 归档原因 | 文档 |
|---|---|---|
diagnosis_record |
已由 V007 删除，历史上被 diagnosis_session + agent_step + tool_invocation 替代；当前新模型是 chat_session + diagnosis_run + trace detail |
archive/2026-07-09-doc-cleanup/旧诊断记录表-diagnosis_record.md |
核心关系
chat_session.session_id
-> diagnosis_run.session_id
-> agent_step.run_id
-> tool_invocation.run_id
-> diagnosis_trace_event.run_id
-> agent_reasoning_audit.run_id (restricted)
-> case_library.diagnosis_id (new AUTO cases use run_id)
diagnosis_session.session_id
-> historical compatibility / rollback only
api_document.doc_id
-> vector chunk metadata.docId / doc_id
knowledge_domain.domain_id
-> api_document metadata.category / vector chunk metadata.category
当前实现主要使用 session_id + run_id 逻辑关联，不依赖数据库外键。agent_reasoning_audit 是敏感审计数据，不与普通 Trace、Evidence Snapshot 或业务结果合并读取。