《后端架构设计·架构基础与边界》附录 A 术语表
卷一术语表:按领域建模、架构风格、数据一致性、接口通信、运行可用性、组织治理六组收录常用词,给出英文、本书用法和常见混淆;单列十组最容易混用的概念、五个容易过时的定义、常见缩写与章节对照,并在写作 ADR、接口文档和评审记录时提供统一口径,方便阅读时快速定位。
tag
卷一术语表:按领域建模、架构风格、数据一致性、接口通信、运行可用性、组织治理六组收录常用词,给出英文、本书用法和常见混淆;单列十组最容易混用的概念、五个容易过时的定义、常见缩写与章节对照,并在写作 ADR、接口文档和评审记录时提供统一口径,方便阅读时快速定位。
把卷一的基线、未知项和未决问题整理成可交接清单:八条基线中五项没有生产数据,六个问题全部带 owner、截止日期和对应卷二主题;Go 就绪门禁检查 measured 是否可复核、unknown 是否有计划、阻塞问题是否有截止日期,并明确“可以开始卷二”不等于“可以宣称性能指标”。
评审一个与 2.3 不同的候选方案:把订单与库存合并为 order-core 单服务。先固定六条证据、四条反对意见和三个重审条件,再用 Go 评分器把证据缺口、未关闭的阻断意见与决策一致性折算成分数;演练明确基于 arch-lab,不是真实公司会议。
把卷一散落在各章的决策收敛成一条可检查的链:需求与约束先变成驱动因素,七条 ADR 再按依赖关系排序;给出带 drivers、depends_on、备选与否决理由、正负后果的 Go 索引结构,并用校验器捕获孤立 ADR、缺失备选、无后果、非法日期与依赖环。
卷一收口最后一步,把性能、可用性、安全与可维护性写成刺激-响应-度量的可测场景,再把未验证项整理成带概率、影响、owner 与可执行关闭条件的风险台账。本篇给出 Go 数据结构、属性覆盖与逾期校验测试,并明确所有阈值只是口径,不是压测结果。
卷一收口第二步,把 arch-lab 的模块清单、依赖方向、部署单元与数据 owner 冻成一份带指纹的快照。本篇给出可机器读取的 Go 结构、三者闭合校验器和黄金指纹测试,并说明唯一运行时单元、单库数据所有权与 PostgreSQL L3 核对步骤。
卷一收口的第一步,是把 arch-lab 的业务需求、技术与组织约束、延迟/可用性/容量/安全指标压成一份可机器校验的基线。本篇给出三种状态口径、一张标清目标与实测的 NFR 表,以及能拒收缺失 owner、目标与实测混用的 Go 校验器和真实基准输出。
以 arch-lab 的状态清单为例,区分事实来源、派生状态、缓存与临时状态,说明有状态服务为什么仍然可以部署;给出可运行的 stateinv 校验器,检查无主状态、来源无备份或恢复、派生状态无重建路径、本地盘持久化和破坏性迁移,并附本机真实 go test 输出。
以 arch-lab 的配置加载器为例,说明默认值、配置文件、环境变量与密钥的分层优先级,为什么未知键和危险默认值必须在启动时失败;给出可运行的 config 包与失败测试,覆盖缺失、非法、密钥入文件、生产环境误用假支付和沙箱地址,并附本机真实 go test 输出。
以 arch-lab 订单系统的七个部署单元为例,说明哪些模块必须同进程、哪些可以独立发布,单点与故障域如何登记;给出可运行的 deploymap 校验器,把未声明单点、无超时或无降级的跨单元强依赖、故障域重叠变成 go test 能抓住的违规,并用同步闭包计算一次发布的影响面。
把支付回调当作不可信外部输入:用 HMAC 覆盖 provider、kid、时间戳、nonce 与 body 哈希,按密钥有效期选择 kid,验签后查重放并核对订单金额与币种;附密钥轮换重叠窗、四类失败路径的测试与真实 go test 输出。
从订单 API 的 JSON 边界讲到业务边界:64 KiB 体积上限、未知字段拒绝、单对象校验、SKU/数量/金额/总额范围与重复项拒绝,再把日志字段分为 public/internal/pii/payment/secret 五类做脱敏,附表驱动测试与真实 go test 输出。
把用户身份与服务身份分开建模:用 HMAC 自签令牌区分 subject 与 actor,把订单归属校验写成纯函数策略,并用九个越权用例覆盖跨客户读取、服务无 actor、缺 scope、未知动作与资源类型,附 go test 实测输出与内部调用传递规则。
以 arch-lab 的最小治理流程为例,只保留 ADR、例外、季度复审和三个指标四个动作,并把规则写成可运行的 govcheck 校验器;表驱动测试覆盖 ADR 不完整、复审过期、替代失效、缺适应度测试、例外超期与指标越线,附真实运行输出。
以 arch-lab 的决策权矩阵为例,把谁决策、谁执行、谁验收写成 D/E/V/C 四类角色,并给出平台团队与业务团队的可验收契约字段;配套 decision 校验器用纯函数检查决策越权、缺咨询、自审、缺验收与破坏性变更通知,附真实测试输出。
以 arch-lab 的五团队十一模块映射为例,说明康威定律如何同时解释和塑造包边界;给出有向沟通通道模型与可运行的 orgmap 校验器,把无主模块、一人跨域、通道方向与依赖方向冲突变成 go test 能抓到的违规,并附本机真实运行输出。
架构约束失效往往不是没人知道,而是没人执行。本篇把 arch-lab 的包边界写成 tools/fitfunc:用 go/parser 扫描依赖、类型命名、契约测试存在性和文件预算,违规时退出码非零;再给出干净树与故意改坏的树两次真实运行输出,并说明它与 deplint、依赖测试的分工。
双写最危险的不是写两次,而是两次写的顺序、失败语义和退出条件都没有定义。本篇在 arch-lab 用 Branch 抽象收窄新旧实现的契约,给出主写→意图→影子→确认的协调器、归一化后的双读比对与差异分类,并用可执行的退出判据说明什么时候才能停止双写,附真实运行输出。
库存模块的迁移不是把代码搬到新目录,而是让同一份库存始终只有一本账。本篇用 arch-lab 的 SKU 分桶路由、读路径双跑和可执行的退出判据,说明绞杀者模式落到有状态资源上时如何避免双扣、如何回退,以及什么时候才允许删掉旧路径,并给出可运行的 Go 实现与测试。
把一次重复下单拆到 API 幂等键中间件、领域支付守卫和消息 Inbox 三层,明确每层的去重键、承诺与不负责的部分;给出可重放的 HTTP 中间件、按 ProviderRef 幂等的 MarkPaid、消费者去重实现,以及四组重复请求测试的真实输出。