docs(mvp): move engineering notes under mvp/engineering
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.
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
# MVP 工程纪要(Engineering Notes)
|
||||
|
||||
**更新日期**:2026-07-29
|
||||
**定位**:项目推进中真实遇到的问题、决策、解决思路与 E2E 验收叙事。
|
||||
|
||||
与其它目录分工:
|
||||
|
||||
| 目录 | 读什么 |
|
||||
|---|---|
|
||||
| [architecture/](../architecture/) | **现行架构**(系统现在怎么跑) |
|
||||
| **engineering/**(本目录) | **为何这样定**、踩坑、方案取舍、live 验收导读 |
|
||||
| [issues/](../issues/) | 未完成事项与状态 |
|
||||
| [tables/](../tables/) | 表结构说明 |
|
||||
| `docs/learning/` 等 | 早期学习/分析(可能过时,不以之为现行口径) |
|
||||
| `devflow/projects/` | 单次变更的 brief/decisions/evidence 切片 |
|
||||
|
||||
本文档**不是** API 规范的唯一真理源;冲突时以 `architecture/` 与代码为准。
|
||||
|
||||
---
|
||||
|
||||
## RAG
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [rag/RAG排序-多路召回与RRF.md](rag/RAG排序-多路召回与RRF.md) | K、多路融合、RRF、L0 边界 |
|
||||
| [rag/RAG-Hybrid质量分与后处理.md](rag/RAG-Hybrid质量分与后处理.md) | qualityScore 统一、L2 伪装废止、后处理 |
|
||||
| [rag/RAG-Agent如何读relevance_level.md](rag/RAG-Agent如何读relevance_level.md) | Agent 侧相关度标签含义与误读 |
|
||||
| [rag/RAG离线评测-基线设计.md](rag/RAG离线评测-基线设计.md) | Golden/Fixture、hybrid 评测与闸门 |
|
||||
| [rag/Milvus-Hybrid接入清单.md](rag/Milvus-Hybrid接入清单.md) | Hybrid 交付拆分与接入清单 |
|
||||
| [rag/RAG审计补丁-stepid-query-E2E验收.md](rag/RAG审计补丁-stepid-query-E2E验收.md) | step_id / query 审计 live 验收 |
|
||||
|
||||
架构对照:
|
||||
|
||||
- [architecture/RAG知识检索架构.md](../architecture/RAG知识检索架构.md)
|
||||
- [architecture/RAG检索可观测性与审计.md](../architecture/RAG检索可观测性与审计.md)
|
||||
|
||||
相关 Issue:
|
||||
|
||||
- [ISS-017 L0 过滤收窄与 Fallback 加固](../issues/active/ISS-017-rag-l0-filter-fallback-hardening.md)(暂缓,保持现网)
|
||||
|
||||
---
|
||||
|
||||
## 诊断 / E2E
|
||||
|
||||
| 文档 | 内容 |
|
||||
|---|---|
|
||||
| [diagnosis/一次诊断全流程-E2E导读.md](diagnosis/一次诊断全流程-E2E导读.md) | SUCCESS 全流程:阶段、token、timeline、字段 |
|
||||
|
||||
架构对照:
|
||||
|
||||
- [architecture/current-mvp-architecture.md](../architecture/current-mvp-architecture.md)
|
||||
- [architecture/session-trace-lifecycle.md](../architecture/session-trace-lifecycle.md)
|
||||
- [architecture/agent-orchestration.md](../architecture/agent-orchestration.md)
|
||||
Reference in New Issue
Block a user