《后端架构设计·架构基础与边界》7.2 事件、命令与消息的语义差异
用订单域的 OrderPlaced、ReserveInventory 和传输信封说明事件、命令、消息三者的语义差异,给出 Kind 校验、单处理者命令与多订阅者事件的 Go 实现,以及七组表驱动与路由测试的真实输出,并列出把事件当命令、把命令当广播的四类误用后果。
tag
用订单域的 OrderPlaced、ReserveInventory 和传输信封说明事件、命令、消息三者的语义差异,给出 Kind 校验、单处理者命令与多订阅者事件的 Go 实现,以及七组表驱动与路由测试的真实输出,并列出把事件当命令、把命令当广播的四类误用后果。
把 arch-lab 下单链路拆成库存预留、支付授权、订单落库三段,从 800ms 总预算拆出 200/400/100ms 子预算,说明超时如何逐级收缩、失败如何分类传播;给出可重试与不可重试边界、补偿策略、五组假端口测试的真实输出,以及支付结果不应留在同步响应里的 ADR。
不重复 CQRS 定义,只回答订单列表与详情读模型何时值得单独建投影:给出可量化的引入判据、必须同时满足的条件、投影幂等与重建实现,以及读模型不再划算时的五条退出条件与删除步骤;并用 Go 测试验证重复投递、旧版本晚到与列表过滤,强调退出是监控数据推翻假设后的正常回收。
把订单状态与 outbox 消息收进同一个本地事务,用快照回滚验证“要么都成功、要么都不可见”;再实现至少一次投递与消费端按 message_id 去重,给出 outbox 表结构、Go 实现、内存版测试与真实 go test 输出,并说明 PostgreSQL 索引的 L3 验证边界。
先确定 orders 与 order_items 的唯一写 owner,再按点查、客户列表、运营筛选与状态迁移四类读写模式筛选存储;给出选择 PostgreSQL 的 ADR、MySQL 作为等价备选以及 DynamoDB、文档库被否决的具体理由,并用仓储契约与内存实现测试锁定版本冲突、过滤与隔离拷贝语义,最后说明触发重审的量化条件。
把错误码、HTTP 状态、retryable 与版本窗口固化成可测试的契约,用表驱动测试覆盖领域错误映射、字段兼容和版本协商,说明哪些变更只能新增、哪些必须升版,并解释 Sunset 过期后为何必须拒绝,以及测试如何证明承诺没有被破坏的边界。
把 OpenAPI 文档当作唯一契约源,用一个最小 spec 覆盖 arch-lab 的五个订单操作,在 Go 侧校验路由、路径参数与错误码,并用生成文件比对测试阻止 spec 与代码悄悄漂移,同时说明 -update 为何只能由开发者执行。
以 arch-lab 的五个订单端点为例,给出资源与命令的分界线、幂等键与 If-Match 的约定,用可运行的 net/http 处理器和表驱动测试固定参数校验、重放与错误映射,并说明哪些字段绝不能由客户端决定,以及 201 与 200 的取舍。
第三方支付渠道有自己的状态码、签名与回调重试。本篇在 arch-lab 写一个可运行的防腐层:外部 DTO 到领域事件的翻译、失败码映射、未知状态兜底、回调验签与重放保护,并用表驱动测试覆盖成功、拒付、未知状态、签名错误与重复回调,最后讨论引入 ACL 的代价与不值得引入的判据。
端口与适配器最容易退化成目录表演。本篇在 arch-lab 定义 OrderRepository、InventoryPort、PaymentPort 三个端口,给出内存适配器与可注入延迟/错误的故障适配器,用同一套契约测试验证 ErrNotFound、ErrConflict、ErrUnavailable 语义一致,并用 go list -deps 断言领域包的传递依赖不出现 adapters。
模块化单体的关键不是目录分层,而是把边界写成可校验的数据:模块清单、公开包、私有包、数据所有权与依赖方向。本篇给出 arch-lab 的模块描述符与 Go 校验器,检查依赖成环、私有包越界与 internal 包无主,并预演库存模块独立部署时需要移动的包、改动的接口与数据库切分步骤。
围绕 arch-lab 订单系统回答聚合该多大:给出 Order、InventoryReservation、Payment 的边界清单,解释库存为何不能塞进订单聚合,拆解总额、状态迁移、重复支付三条不变式,并用 internal/order 聚合、假端口补偿测试与真实 go test -race 输出验证跨聚合一致性的失败路径。
记录一次五小时订单域事件风暴工作坊:五类角色、时间盒、11 条命令、13 个事件、9 条策略与 6 个热点,明确哪些进 ADR、哪些留到卷二;随后把产出编码成 internal/eventstorm 包,用校验器检查命令归属、事件生产者、策略引用与孤立事件,并附真实 go test 输出。
以 arch-lab 订单系统为样本,按变化频率、业务差异化与团队归属划出核心域、支撑域和通用域,给出七条限界上下文的职责、数据、上下游、集成模式与包边界对照表,并把映射表编码成可校验的 internal/contextmap 包,用表驱动测试守住唯一 owner、无环依赖和共享内核引用。
以一次明确标注为演练的 arch-lab 卷一评审为线索,记录订单、库存、支付、SRE、安全五类角色的议程、五个决策点的反对意见与结论;给出覆盖一致性、可用性、安全、演进、运维的九条风险台账,并用 Go 工具校验必填字段、等级矩阵、负责人与关闭条件,附真实命令输出。
从 ADR-003 到 ADR-007 给出 arch-lab 卷一的五份具体决策:存储选型、下单同步与履约异步的边界、模块间端口通信、outbox 事件持久化、单部署单元与模块开关灰度;每份都有状态、约束、备选否决理由、正负后果和重评触发条件,并把登记表编码成可校验的 Go 包与表驱动测试。
直接给出 arch-lab 的四级 C4 视图——系统上下文、容器、组件与代码,逐级说明读者、要回答的问题和刻意不画的内容;再把容器归属与组件依赖编码成 Go 数据结构,用表驱动校验器检查空归属、未知容器、未知依赖与孤儿组件,附 darwin/arm64 上的真实测试输出。
用团队规模、独立部署、数据一致性、故障域、演进成本、运维复杂度与订单系统适配度七个维度对比五种架构风格,给出 arch-lab 的 ADR-001 与被否方案,并用可运行的 Go 依赖检查器把包结构规则固化成可执行命令,说明它只是护栏而非证明。
把“高可用、低延迟”还原成六条可测的质量属性场景,逐条落到 arch-lab 的模块与断言;给出状态机不变式和幂等重放的可执行 Go 测试,并用 ADR-lite 记录一次一致性取舍的备选方案、否决理由与重新评估条件,最后列出常见误用边界。
从 arch-lab 订单系统一个把所有逻辑塞进 HTTP handler 的朴素实现出发,逐条推演它在状态、并发、故障、变更、观测与安全上付出的代价,再给出第一版 Go 领域模型与显式状态机,说明架构为何是一组可验证、可回退的约束与决策边界。