# ADR 索引与规则（Architecture Decision Records）

## 规则
- 每个持久架构决策一个文件：`ADR-NNNN-简短名称.md`。
- 内容固定：**背景 / 决策 / 后果 / 状态 / 关联规格**。
- 状态：`Proposed → Accepted → Deprecated / Superseded by ADR-NNNN`。
- 变更已 Accepted 的 ADR 须走 governance 审批矩阵。

## 索引

| ADR | 标题 | 状态 | 关联规格 |
| --- | --- | --- | --- |
| [ADR-0001](ADR-0001-hybrid-storage.md) | 混合架构：DB 权限 + FS 内容 | Accepted | PO-1/2/3, DV-0002 |
| [ADR-0002](ADR-0002-uuid-storage-key.md) | 磁盘目录用 UUID（storage_key）映射 | Accepted | DV-0002 |
| [ADR-0003](ADR-0003-tech-stack.md) | 技术栈选型（FastAPI/React/SQLAlchemy/Redis/JWT） | Accepted | 全部 DV |
| [ADR-0004](ADR-0004-dual-search-engine.md) | 全文（Whoosh）+ 语义（ZVec）双检索引擎 | Accepted | DV-0005/0006/0007 |
| [ADR-0005](ADR-0005-rag-citations.md) | RAG 答案可溯源：编号引用 + 支撑句对齐 | Accepted | DV-0007/0011 |
| [ADR-0006](ADR-0006-async-index-sync.md) | 写路径异步索引同步（后台任务） | Accepted | DV-0002/0006/0010 |
| [ADR-0007](ADR-0007-idempotent-migrations.md) | 轻量幂等数据库迁移（非 Alembic） | Accepted | DV-0010, NFR-7 |
| [ADR-0008](ADR-0008-compose-v2.md) | 部署仅支持 Docker Compose v2 + Engine ≥ 25 | Accepted | NFR-6, DV-0000(部署) |

> 注：DV-0000 为「部署/环境」逻辑单元，对应 NFR-6/ADR-0008，不生成独立功能规格文件，仅作追踪占位。