docs(mvp): align architecture and audit table design

2026-07-23 20:16:29 +08:00
parent 49180abccf
commit e47f2dead0
12 changed files with 227 additions and 124 deletions
@@ -1,6 +1,6 @@
 # SuperBizAgent MVP 文档

-**更新日期**：2026-07-10
+**更新日期**：2026-07-23

 本目录保存 MVP 阶段的架构、问题、演示、评测和数据表说明。当前材料按“当前入口”和“历史归档”拆开，避免把早期设计稿当成当前实现。

@@ -10,27 +10,15 @@
 |---|---|
 | [architecture/README.md](architecture/README.md) | 当前 MVP 架构入口 |
 | [architecture/current-mvp-architecture.md](architecture/current-mvp-architecture.md) | 当前可运行系统架构 |
-| [architecture/interview-one-pager.md](architecture/interview-one-pager.md) | 面试一页式架构讲解 |
 | [architecture/agent-orchestration.md](architecture/agent-orchestration.md) | Agent 编排架构 |
-| [architecture/executor-evidence-pipeline-refactor.md](architecture/executor-evidence-pipeline-refactor.md) | Executor 证据链路改造记录 |
 | [architecture/harness-quality-gates.md](architecture/harness-quality-gates.md) | Harness 与质量门禁 |
-| [architecture/rag-architecture.md](architecture/rag-architecture.md) | RAG/知识检索新架构 |
-| [architecture/retrieval-observability.md](architecture/retrieval-observability.md) | 检索与可观测性架构 |
-| [architecture/feedback-architecture.md](architecture/feedback-architecture.md) | 反馈与自评估架构 |
 | [architecture/session-trace-lifecycle.md](architecture/session-trace-lifecycle.md) | 会话与 Trace 生命周期 |
-| [architecture/knowledge-base-authoring.md](architecture/knowledge-base-authoring.md) | 知识库文档编写与维护 |
-| [architecture/data-model.md](architecture/data-model.md) | 数据模型总览 |
-| [architecture/evolution-roadmap.md](architecture/evolution-roadmap.md) | Agent 架构演进路线 |
 | [issues/README.md](issues/README.md) | MVP issue 索引 |
-| [issues/archived/rag-refactor-plan.md](issues/archived/rag-refactor-plan.md) | 已过时的 RAG 重构计划（仅供历史追溯） |
 | [tables/README.md](tables/README.md) | 当前 MySQL 表说明 |
-| [demo/README.md](demo/README.md) | Demo 运行和面试演示材料 |
-| [demo/ten-minute-interview-demo.md](demo/ten-minute-interview-demo.md) | 10 分钟面试演示脚本 |
+| [demo/README.md](demo/README.md) | Demo 运行和演示材料 |
 | [eval/README.md](eval/README.md) | 诊断评测材料 |

-## 当前系统一句话
-
-SuperBizAgent MVP 是一个可追踪的故障诊断 Agent：Chat 和 AIOps 入口进入 Agent 编排，Executor 显式调用知识库、日志、指标等工具收集证据；多轮会话元数据落到 `chat_session`，每次诊断运行落到 `diagnosis_run`，步骤和工具明细通过 `agent_step.run_id`、`tool_invocation.run_id` 关联，最终通过 Trace API、Verifier 和评测脚本证明结果可解释、可回放、可对比。
+当前架构、运行链路和后续规划分别以 `architecture/`、`issues/README.md`、`tables/README.md` 以及 OpenSpec/devflow 的最新记录为准。

 ## 文档结构

@@ -39,18 +27,12 @@ mvp/
  architecture/
    README.md
    current-mvp-architecture.md
-    interview-one-pager.md
    agent-orchestration.md
-    executor-evidence-pipeline-refactor.md
    harness-quality-gates.md
-    rag-architecture.md
-    retrieval-observability.md
-    feedback-architecture.md
    session-trace-lifecycle.md
-    knowledge-base-authoring.md
-    data-model.md
-    evolution-roadmap.md
    archive/
+      2026-07-05-legacy/
+      2026-07-22-legacy/
  issues/
    README.md
    active/
@@ -76,51 +58,13 @@ mvp/
  archive/
 ```

-## 当前核心设计
-
- `lookup_knowledge` 保持显式 Agent Tool，不隐藏到 Chat Advisor。
- L0 降级为 domain/entity hint，不再默认承担最终召回决策。
- `VectorSearchService` 是检索稳定门面。
- Spring AI VectorStore 是当前读取主路径，Milvus SDK 保留为 fallback。
- AIOps payload 会生成推荐知识库 query，保留业务语义。
- `sessionId` 表示多轮会话上下文，`runId` 表示一次可回放诊断运行。
- Trace API 聚合 `diagnosis_run`、`agent_step.run_id`、`tool_invocation.run_id` 和 self evaluation。
- RAG 行为通过 offline baseline 和 live acceptance 脚本做回归验证。
-
-## 关键运行链路
-
-```text
-Chat
-  -> ChatService
-  -> Planner / Executor / Verifier
-  -> evidence tools
-  -> chat_session / diagnosis_run
-  -> agent_step.run_id / tool_invocation.run_id
-  -> DiagnosisTraceService
-
-AIOps
-  -> AiOpsService
-  -> PAYLOAD_TARGETED or AUTO_DISCOVERY
-  -> Planner / Executor
-  -> Prometheus / logs / lookup_knowledge
-  -> AiOpsRuleEvaluationService
-  -> diagnosis_run(agent_flow=AI_OPS)
-  -> DiagnosisTraceService
-
-RAG
-  -> lookup_knowledge
-  -> L0 domain/entity hint
-  -> VectorSearchService
-  -> Spring AI VectorStore / Milvus SDK fallback
-  -> relevance normalization
-  -> tool_invocation
-```
-
 ## 归档说明

-历史材料分两类：
+历史材料按归档批次保存：

- 旧架构文档：[architecture/archive/2026-07-05-legacy/](architecture/archive/2026-07-05-legacy/)
- 本次文档清理归档：[archive/2026-07-09-doc-cleanup/](archive/2026-07-09-doc-cleanup/)
+- [architecture/archive/2026-07-05-legacy/](architecture/archive/2026-07-05-legacy/)：早期架构设计、实现计划和知识检索方案。
+- [architecture/archive/2026-07-22-legacy/](architecture/archive/2026-07-22-legacy/)：单 Diagnosis Agent + Harness 切换前的多角色编排、双入口和旧证据链架构。
+- [archive/2026-07-09-doc-cleanup/](archive/2026-07-09-doc-cleanup/)：文档清理时迁移的历史材料。
+- [issues/archived/](issues/archived/)：已关闭或已被当前架构替代的 Issue。

-归档文档只用于追溯设计历史。当前实现和后续规划以 `architecture/`、`issues/README.md`、`tables/README.md` 和 OpenSpec/devflow 的最新记录为准。
+归档内容仅用于追溯历史决策，不代表当前 runtime、API、数据模型或验收口径。