mula.liu
f92fff6546
|
||
|---|---|---|
| .. | ||
| ADR-0001-hybrid-storage.md | ||
| ADR-0002-uuid-storage-key.md | ||
| ADR-0003-tech-stack.md | ||
| ADR-0004-dual-search-engine.md | ||
| ADR-0005-rag-citations.md | ||
| ADR-0006-async-index-sync.md | ||
| ADR-0007-idempotent-migrations.md | ||
| ADR-0008-compose-v2.md | ||
| README.md | ||
README.md
ADR 索引与规则（Architecture Decision Records）
规则
- 每个持久架构决策一个文件：
ADR-NNNN-简短名称.md。 - 内容固定：背景 / 决策 / 后果 / 状态 / 关联规格。
- 状态：
Proposed → Accepted → Deprecated / Superseded by ADR-NNNN。 - 变更已 Accepted 的 ADR 须走 governance 审批矩阵。
索引
| ADR | 标题 | 状态 | 关联规格 |
|---|---|---|---|
| ADR-0001 | 混合架构：DB 权限 + FS 内容 | Accepted | PO-1/2/3, DV-0002 |
| ADR-0002 | 磁盘目录用 UUID（storage_key）映射 | Accepted | DV-0002 |
| ADR-0003 | 技术栈选型（FastAPI/React/SQLAlchemy/Redis/JWT） | Accepted | 全部 DV |
| ADR-0004 | 全文（Whoosh）+ 语义（ZVec）双检索引擎 | Accepted | DV-0005/0006/0007 |
| ADR-0005 | RAG 答案可溯源：编号引用 + 支撑句对齐 | Accepted | DV-0007/0011 |
| ADR-0006 | 写路径异步索引同步（后台任务） | Accepted | DV-0002/0006/0010 |
| ADR-0007 | 轻量幂等数据库迁移（非 Alembic） | Accepted | DV-0010, NFR-7 |
| ADR-0008 | 部署仅支持 Docker Compose v2 + Engine ≥ 25 | Accepted | NFR-6, DV-0000(部署) |
注：DV-0000 为「部署/环境」逻辑单元，对应 NFR-6/ADR-0008，不生成独立功能规格文件，仅作追踪占位。