设计决策总览
决策文档的入口:每个重大选择都回答 为什么选 / 放弃了什么 / 代价是什么。已裁决的进 ADR,未成文的在此给出 「架构分析推导」(不冒充原作者决策记录)。
决策地图
| 主题 | 页面 | 状态 |
|---|---|---|
| 全部技术栈的选型与理由 | 技术选型总表 | 代码事实 + 文档佐证 |
| 为什么是 Rust(而不是 Go/Java) | 为什么是 Rust | 架构分析推导 |
| 为什么 Istio 只用 ambient L4(治理在应用层) | 为什么是 Istio ambient | 架构分析推导 |
| 为什么不是纯 Rust mesh / 客户端发现 / Gateway-only… | 「为什么不是」系列 | 架构分析推导 |
| 已裁决决策记录 | ADR 索引 | 仓库 docs/adr/ |
裁决优先级(项目宪章)
text
REQUIRE.md(需求事实源)
> docs/design/ 设计分册
> DESIGN.md(历史参考)
> 其他文档代码与文档冲突时:以代码为准,并在架构证据链 登记差异。本站遵循同一原则。
已裁决的关键决策(摘要)
| ID | 决策 | 落点 |
|---|---|---|
| D-RLM01-B | 对象存储锁 aws-sdk-s3 路线对接 RustFS | docs/adr/ADR-D-RLM01-B.md |
| D-TR01-B | 全文引擎锁 tantivy =0.22.1(positions 必开) | docs/adr/ADR-D-TR01-B.md |
| D-CB01-A | 授权内核自研(casbin 语义等价,因 rhai feature 冲突) | docs/adr/ADR-D-CB01-A.md |
| D-PLG01 | 插件走独立进程 gRPC 契约(非 wasm/动态库) | crates/plugin-sdk |
| D-INF01 | 自建 IDC、云无关 | 分册 08 |
| D-CP01 | 性能预算(权限 P99 2ms、网关 P99 50ms 等) | 分册 00 §8 |