zhuyongxin
473bb5d004
- rewrite RAG architecture doc for py-rag service contract mapping, ingest and rebuild ops - refresh observability/trace doc for post-L0 single-attempt semantics - add py-rag chain exploration note; mark superseded Milvus/L0 notes with status banners - close ISS-017 (superseded by L0 sinking); mark knowledge_domain table orphaned - refresh architecture/mvp/engineering indexes
52 lines
2.5 KiB
Markdown
52 lines
2.5 KiB
Markdown
# 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、数据模型或验收口径。
|