Skip to content

架构决策记录(ADR)

记录"为什么这么设计",避免后来人重新踩坑或推翻既定决策。只增不改:决策变了就写一篇新的,标注取代旧的。

编号决策状态
0001vem-web 用 user 账号体系,不新建账户类型✅ 生效
0002保护模块(hiapi-core-public)不放 JPA 实体/仓库✅ 生效
0003授权服务端迁入 nuwa,license-server 废弃✅ 生效
0004商城不自建支付,全部复用 finance✅ 生效
0005多账户类型 Controller 共享逻辑用组合,不用中间继承✅ 生效
0006AI 开放接口用静态令牌,不新增应用/微服务✅ 生效
0007已知凭据泄漏(AWS 长期密钥/Stripe/SSH 私钥)业主决定暂不轮换⚠️ 已决定不处理
0008客户配置与交付编排收拢到 nuwa,废弃 git+SOPS+Argo✅ 生效
0009客户集群 workload 变更由独立 agent 执行(public 不碰 k8s),应用授权挂 License✅ 生效
0010schema 以 Flyway 为唯一真相源,ddl-auto 切 validate,迁移在业务 Pod 内跑(不加 Job)✅ 生效

新增 ADR 模板

markdown
# ADR-XXXX: <一句话决策>
- 日期:YYYY-MM-DD  状态:生效/被 ADR-YYYY 取代
## 背景(什么问题)
## 决策(怎么定的)
## 理由(为什么,包括否掉了哪些备选)
## 影响(约束了什么,谁要遵守)