# SuperBizAgent MVP 文档

**更新日期**：2026-07-29

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

## 当前入口

| 目录/文档 | 用途 |
|---|---|
| [architecture/README.md](architecture/README.md) | **现行架构**（系统现在怎么跑） |
| [engineering/README.md](engineering/README.md) | **工程纪要**（问题 / 决策 / 思路 / E2E 导读） |
| [architecture/current-mvp-architecture.md](architecture/current-mvp-architecture.md) | 当前可运行系统架构 |
| [architecture/agent-orchestration.md](architecture/agent-orchestration.md) | Agent 编排架构 |
| [architecture/harness-quality-gates.md](architecture/harness-quality-gates.md) | Harness 与质量门禁 |
| [architecture/session-trace-lifecycle.md](architecture/session-trace-lifecycle.md) | 会话与 Trace 生命周期 |
| [architecture/RAG知识检索架构.md](architecture/RAG知识检索架构.md) | 当前检索架构（py-rag 知识服务接入） |
| [issues/README.md](issues/README.md) | MVP issue 索引 |
| [tables/README.md](tables/README.md) | 当前 MySQL 表说明 |
| [demo/README.md](demo/README.md) | Demo 运行和演示材料 |
| [eval/README.md](eval/README.md) | 诊断评测材料 |

**读法**：改行为先看 `architecture/`；要理解「为什么这样定、踩过什么坑」再看 `engineering/`。  
早期个人学习笔记仍在仓库根目录 `docs/learning/` 等，**可能过时**，不以之为现行口径。

## 文档结构

```text
mvp/
  architecture/          # 现行架构规范
  engineering/           # 工程纪要（问题/决策/E2E）
    README.md
    rag/
    diagnosis/
  issues/
  tables/
  demo/
  eval/
  archive/
```

## 归档说明

历史材料按归档批次保存：

- [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。

归档内容仅用于追溯历史决策，不代表当前 runtime、API、数据模型或验收口径。