40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
# AIOS V2 Architecture Decision Records
|
||
|
||
本目录记录影响多个模块、长期演进、兼容性、安全或交付流程的关键架构决策。
|
||
|
||
## ADR 列表
|
||
|
||
| ADR | 决策 |
|
||
|---|---|
|
||
| [ADR-001](ADR-001-single-control-plane.md) | AIOS 作为唯一控制面 |
|
||
| [ADR-002](ADR-002-openclaw-hermes-decoupling.md) | OpenClaw/Hermes 与控制面解耦 |
|
||
| [ADR-003](ADR-003-gitops-only-change-flow.md) | 所有变更必须通过 GitOps |
|
||
| [ADR-004](ADR-004-multi-tenant-isolation.md) | 多租户隔离默认拒绝 |
|
||
| [ADR-005](ADR-005-document-code-sync-gate.md) | 文档与代码同步门禁 |
|
||
| [ADR-006](ADR-006-candidate-persistence-strategy.md) | 候选持久化采用可替换 SQLite Snapshot |
|
||
|
||
## ADR 状态
|
||
|
||
- `Proposed`：提出但未采纳。
|
||
- `Accepted`：当前有效决策。
|
||
- `Superseded`：被新 ADR 替代。
|
||
- `Deprecated`：保留历史但禁止新实现采用。
|
||
|
||
## 何时必须新增或更新 ADR
|
||
|
||
以下变化必须新增或更新 ADR：
|
||
|
||
1. 控制面与 Runtime 权限边界变化；
|
||
2. 多租户隔离模型变化；
|
||
3. API、数据模型或状态机出现不兼容变化；
|
||
4. 持久化、消息、密钥、审计或部署方案发生跨模块变化；
|
||
5. GitOps、发布、回滚或文档门禁变化；
|
||
6. 替换 OpenClaw、Hermes、Agent Router 或核心基础设施。
|
||
|
||
ADR 变化必须同步更新：
|
||
|
||
- `02-TARGET-ARCHITECTURE.md`
|
||
- `04-MODULE-CONTRACTS.md`
|
||
- `05-TRACEABILITY-MATRIX.md`
|
||
- 对应代码、测试和部署资产
|