zhuyongxin
584639fa2a
Relocate RAG and diagnosis decision/E2E writeups from docs/ root into mvp/engineering so architecture, issues, and engineering narrative stay together. Update indexes and cross-links; leave docs/learning as legacy.
2.4 KiB
2.4 KiB
SuperBizAgent MVP 文档
更新日期：2026-07-29
本目录保存 MVP 阶段的架构、工程纪要、问题、演示、评测和数据表说明。当前材料按“当前入口”和“历史归档”拆开，避免把早期设计稿当成当前实现。
当前入口
| 目录/文档 | 用途 |
|---|---|
| architecture/README.md | 现行架构（系统现在怎么跑） |
| engineering/README.md | 工程纪要（问题 / 决策 / 思路 / E2E 导读） |
| architecture/current-mvp-architecture.md | 当前可运行系统架构 |
| architecture/agent-orchestration.md | Agent 编排架构 |
| architecture/harness-quality-gates.md | Harness 与质量门禁 |
| architecture/session-trace-lifecycle.md | 会话与 Trace 生命周期 |
| architecture/RAG知识检索架构.md | 当前 hybrid 检索架构 |
| issues/README.md | MVP issue 索引 |
| tables/README.md | 当前 MySQL 表说明 |
| demo/README.md | Demo 运行和演示材料 |
| eval/README.md | 诊断评测材料 |
读法：改行为先看 architecture/；要理解「为什么这样定、踩过什么坑」再看 engineering/。
早期个人学习笔记仍在仓库根目录 docs/learning/ 等，可能过时，不以之为现行口径。
文档结构
mvp/
architecture/ # 现行架构规范
engineering/ # 工程纪要（问题/决策/E2E）
README.md
rag/
diagnosis/
issues/
tables/
demo/
eval/
archive/
归档说明
历史材料按归档批次保存：
- architecture/archive/2026-07-05-legacy/：早期架构设计、实现计划和知识检索方案。
- architecture/archive/2026-07-22-legacy/：单 Diagnosis Agent + Harness 切换前的多角色编排、双入口和旧证据链架构。
- archive/2026-07-09-doc-cleanup/：文档清理时迁移的历史材料。
- issues/archived/：已关闭或已被当前架构替代的 Issue。
归档内容仅用于追溯历史决策，不代表当前 runtime、API、数据模型或验收口径。