来源书籍

复杂软件设计之道:领域驱动设计全面解析与实战

Skill 版本:v23 领域建模类 经典原理(高信息浓度 + 高稳定性) 264 张卡片

彭晨阳 · 机械工业出版社 · 2020-08 · 2020年8月第1版 · ISBN 9787111661122

类别清单覆盖

尚未完成类别清单核对。

全书导读

本书以领域建模连接业务知识和软件实现。先界定模型适用的语境与共同语言,再把需要共同保护的规则放进聚合,区别实体身份和值对象含义,最后讨论读写模型、事件历史和跨边界协作。技术框架是案例载体,不能用包名、注解或服务数量替代对真实业务规则的判断。

全书主线

第1–2章从需求、技术债与上下文入手,建立战略设计;第3–4章将规则落实到聚合、实体、值对象、服务与仓储;第5–6章讨论CQRS、事件溯源、补偿、投影和数据演进;第7章以货物运输贯通需求、事件、边界、命令及代码。

贯穿全书的检验问题是:谁有权作决定,哪些事实必须一起提交,哪些变化可以迟后传播,失败与重试由谁承担。原文中的部分绝对化判断及教学代码缺陷在各章明确限定,不能把事件日志、聚合类或框架注解视为自动的一致性保证。

内容简介与出版信息

本书以复杂企业软件的业务边界和规则为主线,从战略建模逐步进入聚合、实体值对象、CQRS、事件溯源,并以货物运输贯穿分析实现。Java示例是表达媒介,读者应结合实际上下文辨别方法收益。版权页记录彭晨阳编著、机械工业出版社、2020年8月第1版及ISBN978-7-111-66112-2;其中CIP标注2020.7,出版信息应保留不同字段来源。

前言

领域驱动设计用于连接业务认识与技术实现。业务专家、产品与开发需要在共同语言中反复校正理解;有界上下文、聚合等概念用来明确范围,而非单纯增加技术层次。前言安排由整体业务分析进入模型与架构,再用完整运输案例串联,并说明本书包含作者实践立场,读者应将案例结论放回适用场景。

第1章 领域驱动设计基础

DDD把软件开发看成共同学习业务、逐步建立模型的过程。产品经理、专家和开发对同一需求可能各有默认前提,文档再详细也未必覆盖现场集成。先把假设、真实事件及例外放到共同讨论中,再用代码和使用反馈检验,能减少“代码可运行、业务不能用”的偏差。技术质量的长期价值体现在变化成本:依赖混杂会让新增功能先变成拆解旧结构,测试、重构和适度设计则帮助持续交付。复用需要真实共同语义,暂时重复有时比提前抽错共享核心更可控。

模型不是工具图形本身,而是对问题的一组概念、关系和规则。ER表示偏重数据结构,领域对象还把行为和约束纳入表达;二者可以协同,不能据选择类或表便断言已完成建模。面对面研讨将事件按时间排列,再问流程为何如此;逆向工程从实体、接口和时序还原旧系统规则,所得仍需专家核实。事件先后既可能是因果依赖,也可能是企业政策:付款后发货与货到付款是不同业务规则,并非一个通用顺序。

理解复杂性要从内外两个方向确认边界:内部结构显示哪些对象共同变化,外部上下文决定同一个词的意义。分类要保持标准一致,命名则应暴露边界。统一语言是在特定上下文中共享且可执行的表达,跨上下文可以保留不同模型并显式翻译。业务固有的参与者与约束不一定能消除,但可分解为较少互相干扰的范围;难懂的表达、意外耦合则应持续减少。模块、有界上下文、聚合与部署服务不自动一一对应。

业务策略规定方向,业务规则把方向转成可操作、可测试的约束,流程安排动作落实规则,监控稽核检查执行效果。租车公司的延长车辆寿命目标,要进一步落到保养周期与里程条件;货运系统则区分路线目标、行程计划和分段装卸作业。面对已有流程,反问“没有这一步会怎样”,可挖出岗位术语背后的规则。专家没有现成的完美模型,需要共同识别隐藏概念、量化条件和例外。职场Person只保留工作用途需要的属性与行为,体现有目的地简化;模型必须在简单、通用与严格之间权衡,保留决策真正需要的细节。

事件溯源保存权威事实历史,状态仍会通过折叠、快照与投影产生。合法事件与状态迁移仍须校验,异步投影可能滞后,日志不会自动避免未支付发货,也不自动提供并发或跨服务事务。单纯把文档CRUD和搜索拆成服务,还会留下副本同步、故障恢复与数据所有权问题。因此是否采用DDD取决于业务规则、学习成熟度和成本收益,并不存在只能用于第二版、所有CRUD都不适合或金融系统天然正确的定律。工程师也要理解产品目的,提出产品效果与工程成本的双向取舍,并通过实际反馈修正。

需求理解落差、技术债与适度设计、数据与行为建模的详细机制:共同建模填补需求留白、业务现场检验文档假设、内部质量影响交付成本、延迟抽象避免错误共享、适度设计避免双向欠账、分类要统一判断标准、单一职责限制变化牵连、技术债会滚大、贫血模型代价。

分析实现衔接、事件建模与状态保证边界的详细机制:分析模型须经实现验证、事件风暴找事实、分散状态放行未付发货、订单集中检查状态迁移、状态可以作为派生缓存、同步投影与异步取舍。

协作及逆向建模、边界分类、复杂性和数据结构的详细机制:协作建模先找知识人、逆向代码还原业务规则、事件顺序区分因果策略、固有复杂与理解负担、按规则判断建模投入、一套配置不覆盖所有域、边界先于命名、CRUD吞掉业务。

产品参与、策略规则分层、业务分析与货运规则的详细机制:产品与工程双向折中、策略规则流程分层、规则必须可测量、四类业务分析用途、路线行程作业分层、产品意识工程师。

流程反问、统一语言、模型提炼、DDD采用与服务拆分的详细机制:隐藏概念跨岗位提炼、反问流程发现规则、模型按用途删减属性、模型严格性照顾例外、小模型与精度权衡、按认知成熟度引入DDD、按业务边界拆服务、模型表示不等于模型、复杂性藏在规则、统一语言在边界内、日志派生视图仍有前提。

原书依据 · 48 处

第2章 领域驱动战略设计

战略设计讨论模型的适用范围与集成责任,战术设计再把规则落实到对象中。上下文内的统一语言需要业务与技术人员共同维护,同一名称在不同边界可有不同含义;这既是理解保险、电费与电商案例的前提,也是检查部门分工和部署划分是否合理的尺度。

上下文关系包含共同模型、服务协议、事件契约与翻译责任。子域按竞争价值分配投入,时间线、能力、流程与领域故事用于提出边界候选,再以规则完整性检验。原书早期把上下文直接等同微服务、把所有共享代码称为共享内核的说法过宽,结尾模块化单体示例和官方定义提供了必要限定。

事件风暴把事实、命令、角色和例外放在同一时间线上。电影票失败及超时释放座位揭示资源生命周期必须闭合;股票账户按业务复制事件并不自动保证余额约束,具体并发扣款问题在第6章继续解释。流程图和工具帮助记录并比较候选模型,模型是否可用仍由业务规则和实现反馈检验。

战略设计先讨论模型的适用边界、共同语言和上下文协作,战术设计再用聚合、实体和值对象表达内部规则。两者是不同观察尺度,实践可以往返迭代;不是必须一次完成全部战略分析后才能写代码。 见战略先定边界。

统一语言由开发人员、领域专家及其他参与者共同发展,在特定有界上下文中消除关键歧义,并进入讨论、文档和代码。采购电价与零售电价可以同名却含义不同,因此不能把全公司词汇统一成一个模型。词汇应持续用实际案例校验,不是上级强制发布的一张固定词典。关联:[[边界先于命名]] 见统一语言在边界内。

核心子域支撑企业差异化,值得重点投入建模和工程能力;支持子域帮助核心运转,通用子域可以考虑成熟产品或服务。分类取决于当前业务战略而非模块名称,也不表示支持系统必然简单、通用功能必然外购。先看竞争价值、规则复杂性与采购代价,再决定投入。 见子域决定投入。

上下文映射同时描述模型依赖、接口契约及团队协作。共享内核要求共同维护小片模型,开放主机服务面向多个使用者提供稳定协议,发布的语言定义交换含义,事件订阅改变调用时机但仍依赖事件契约。传输方式不能独自决定边界独立性;防腐层负责隔离语义,不必单独部署成一个微服务。 见上下文关系即集成。

领域事件描述业务中已经发生的事实。把不同岗位理解的事实放到同一时间线上,追问原因、约束和例外,可以发现规则及边界。事实视角与对象职责互相补充,不能据此断定事件永远比对象更真实,或要求每个事件都跨两个对象、两个上下文。 见事件风暴找事实。

业务平台应围绕稳定能力明确模型所有权和交接规则,只抽公共代码或按表拆服务不能保证团队自治。共享账户被多个业务使用时,应先明确余额规则和负责者,再选择服务或模块边界。DDD与事件溯源是可选方法,原书把二者作为中台唯一定义的说法不宜推广;共享代码也不一概有害。 见中台边界需业务。

同一个Person在工作场景关注工号和职位,在家庭场景可能关注子女;有界上下文规定模型与术语在哪些条件下有效。模型边界不自动等于微服务、数据库或事务边界,模块化单体也可以保持多个模型边界。本章结尾亦承认“微服务就是有界上下文”过分简化,宜以模型语义而非部署数量划界。 见上下文界定模型适用范围。

部门分工可以提示业务职责,但重组部门不一定改变业务能力,也不能据此机械地一部门一个服务。先确认每项能力的目标、规则和输出,再检查同一模型能否一致解释;部门名称、调用频率与代码仓库数量都不能替代这一判断。 见组织部门只是划界线索。

共享内核是两个上下文共同维护的一小片领域模型及相关代码或数据库结构,变更需协商并通过持续集成检查。它能减少重复翻译,也会引入协调成本;应限制共享范围。普通工具库或一个独立提供目录API的服务不自动构成Shared Kernel。此处按Evans《DDD Reference》定义限定原书过宽的类比。 见共享内核需要共同治理。

开放主机服务为多个客户端提供清楚、一致且可演进的访问协议,避免每来一个集成方就私下增加一套接口。RPC或HTTP只是实现手段,存在同步调用本身不足以证明采用此模式。接口改变时仍需兼容策略,特殊下游也可用翻译层隔离;不能把所有协商都视为应消除的低效。 见开放主机服务面向共同协议。

发布者不必同步等待所有订阅者,能降低直接调用和可用时间的耦合,但消费者仍依赖事件的含义、版本、顺序及交付条件。必须分别考虑重复、延迟和失败后的处理;断路器隔离资源故障,不会自动回滚已经完成的业务。领域事件也可在单进程内使用,不必然要求消息中间件。 见事件订阅仍有契约耦合。

不同模型之间需要一份可共同解释的交换契约,明确字段、业务含义与合法状态,再在边界处转换成本地模型。原书以HL7说明行业标准语言可减少逐对猜测。采用XML、JSON或BPMN的格式本身不保证业务语义一致;发布的语言应是被文档化和理解的领域表达。 见发布的语言固定交换含义。

先按时间整理功能,再追问为什么相邻、是否为共同目标维护同一组规则。尝试移走某功能、检查边界是否过大及规则能否完整实施,可以检验候选上下文。时间邻近只是线索,并发流程和偶然相邻活动不应因此强行合并。 见时间邻近需再检验职责。

订单上下文中的“支付”可能只表示确认订单已支付,真正扣款由支付上下文负责。下单、扣款和发货的接口名称相近,也需要区分谁有权完成外部动作、谁只记录结果。代码中改变订单状态不能作为真实资金转移成功的证据。 见订单状态区别外部业务完成。

目的:让业务专家与开发共同检查一个用例如何完成。选一个具体用户目标,用参与者、动作和工作对象按顺序讲述,标明每次交接的输入、输出与规则,再反问例外和职责。原有部门流程可提供线索,仍须区分管理审批与业务所必需能力。本次只整理书中建模方法,未召开实际研讨会。 见领域故事追踪目标与交接。

划出订单、支付和发货等候选上下文后,还应从用户目标出发串联交互,检查整体能否完成任务以及失败时由谁处理。边界局部看起来整洁,若关键结果无人负责或双方都作决定,仍说明模型有缺口。用例、时序与类图是互补证据,不规定只能采用这三种图。 见上下文串联须覆盖完整用例。

命令表达希望业务执行的动作,事件表达已经发生的结果。命令须经过权限和业务规则校验,可能失败、无动作或产生多个事实;事件不应把尚未完成的意图伪装成成功结果。命令不必源于按钮,不强制使用某一种英文词形,也不意味着每个订阅者都必须响应。 见命令表达意图事件表达事实。

“商品加入购物车”可从商品管理或购物场景观察;明确本次事实由哪个业务边界解释,能避免只按名词归类。购物车增加商品关注购买关系,商品目录关注商品资料,两者可以用不同模型表达同一商品标识。过去式名称帮助讨论,但不存在禁止所有Changed或Canceled名称的通用规则。 见事件归属看业务语境。

目的:把分散业务知识转为可检验模型。先用橙色便签写已发生事实,按时间排序,再加入蓝色命令、黄色角色和规则;标出争议、失败路径及候选上下文。并行探索能暴露分歧,聚焦一条流程又帮助达成共识,二者可交替。便签和图只是工作材料,还要形成明确决策与测试场景。本次未执行研讨会。 见事件风暴按事实规则迭代。

围绕每个事实追问“为什么发生”“若断电、拒付或中断会怎样”,能把正常路径隐藏的前提、超时和补救责任显式化。未知问题先记录假设和待确认对象,不为让流程图闭合而编造业务答案。研讨会短时间完成图示,也不等于实现已覆盖全部边界情况。 见反事实问题挖掘异常路径。

电影票教学案例中,选择座位先占用库存,支付可能失败或用户一直不支付。如果模型只保留选座与支付成功路径,未完成交易仍可能长期占座,影响其他用户购买。根因是资源占用生命周期缺少结束条件与责任者;对应改进见[[失败超时回收座位]]。这是原书流程风险示例,不是已发生的生产事故。 见缺失释放路径会占住座位。

为[[缺失释放路径会占住座位]]补上PaymentFailed→ReleaseSeat→SeatReleased,并让座位管理上下文同时拥有选座与释放职责;未支付超时也触发释放。书中20分钟是案例策略,真实期限由业务确定。该流程明确了回收责任,但尚未证明晚到支付、重复释放和并发抢座均已解决,实施时还需单独校验这些竞争条件。 见失败超时回收座位。

本书介绍Kubel将输入案例变为可拖动词汇,再把词汇放到不同上下文分组,用于比较哪些概念能够凝聚。它辅助讨论候选边界,不能替代业务规则或自动证明分组正确。原书入口为https://robertreppel.github.io/kubel/,这里登记其当时用途,未验证当前服务可用性,也未实际运行。 见Kubel辅助比较词汇分组。

单体可以有清楚模块,微服务也可能形成分布式泥球。图2-23把部署形式与依赖是否清楚分成两条轴,说明拆进程不能代替模型划界。应先明确能力、契约和所有权,再权衡独立部署的收益与通信、运维成本;不按“一个上下文必等于一个服务”机械拆分。 见模块边界与部署方式分开。

原书依据 · 26 处

第3章 聚合设计

聚合把必须一起维护的业务规则收敛到边界内。医生处方、门诊排班、货运行程揭示根的选择需要同时考虑职责、时间尺度和并发;主谓换位与事件风暴只是提出候选的方法。订单案例继续把商品标识、地址快照、状态迁移和外部支付分开,避免把整个交易流程包成一个大对象。聚合类本身不提供事务原子性,事件溯源也不消除写入竞争;这些实现条件须独立落实。

有界上下文划分领域外部边界,聚合划分上下文内部对象边界。聚合把生命周期一致、规则一致、必须共同维护不变性的对象收在一起,让模型按业务一致性而不是表关系组织。 见聚合是内部边界。

聚合设计追求紧密对象放在一起、松散对象进一步解耦。边界越清楚,外部越只能通过聚合根访问内部状态,模型越能把变化限制在小范围内。关联:[[聚合是内部边界]] 见高聚合低关联。

一个聚合可对应一段活动及其必须共同维护的规则。把“开处方”命令与“处方开具成功”事件放到预约、诊断、取药的时间线中,才能发现药物与病情规则由处方承担,而不是因为医生是语法主语就把医生选作根。整条时间线可能跨多个聚合,事件分类是发现边界的线索,不能把全部流程直接塞进一个聚合。 见事件识别聚合。

必须在同一事务中一起改变的对象,往往属于同一聚合;不需要同步一致的对象,应通过引用或事件协作。发散:聚合过大拖垮并发,过小又把业务一致性交给调用方。 见事务边界定粒度。

当多个对象都需要某项数据时,优先让真正拥有该信息生命周期的对象负责维护,其他对象只引用或查询。这样能减少重复状态,也避免业务事实在多个聚合中互相打架。 见信息拥有者模式。

领域对象应表达“做什么”和规则约束,具体技术步骤、持久化、通知等“怎么做”交给应用层或基础设施。发散:把流程脚本塞进实体,会污染模型;把业务规则扔给服务,也会掏空模型。 见做什么怎么做分离。

订单项随订单存在,商品目录却有独立生命周期,因此订单拥有订单项,跨界商品只以标识引用。判断组合关系要看删除、修改和不变式由谁负责,不能看到Java字段引用或数据库外键就认定同一聚合。书中Product与Category的画法是特定建模选择;共享分类也可能是独立聚合。UML空心菱形、实心菱形与DDD聚合含义不能混用。 见关系强弱须看业务约束。

NumberRange用lower与upper共同表达区间。setLower先读upper再赋值,setUpper先读lower再赋值;两个线程可各自通过旧值检查,最后组合出不满足大小关系的新状态。单个字段的合法性不足以保证联合不变式。应把“读旧状态—校验—发布新状态”作为不可分割操作,参见[[联合不变式原子更新]]。书中代码用大于/小于判断而允许相等,是否允许空区间也需业务定义。 见分开校验会撕裂区间。

修复[[分开校验会撕裂区间]],首先确定lower与upper的联合规则,再让所有修改路径在同一锁、版本比较交换或数据库条件更新内完成校验与发布。统一设置上下限的方法能缩小入口,却不会自动让多个步骤原子化;只锁其中一个setter也不够。多实例服务还必须在共享持久层协调,单JVM锁只保护该进程中使用同一锁的调用。 见联合不变式原子更新。

把“用户订购商品”改写成“商品被用户订购”“订单由用户建立”,比较候选对象承载的规则和规模。用户涵盖所有购买、商品涵盖所有买家时,往往过大;订单记录一次交易关系,更容易限定条目和金额等不变式。语法换位用于提出候选,最终要靠业务约束、生命周期与并发边界检验,不能靠语法主语直接决定聚合。 见主谓换位发现关系对象。

应用服务接收用例请求,加载对象、委托行为并保存结果;聚合拥有足够信息后检查业务规则并决定状态能否迁移。服务接口仍可暴露开始比赛或发货,但不应在多个方法里各写一套状态判断。分配职责时问“谁知道这些事实、谁有权决定”,比按技术层名称机械搬方法更有效。领域服务仍可承载不自然属于单个实体的领域策略。 见协调职责与决策职责。

货运中的路线、行程、行程段代表不同尺度:路线说明总体去向,行程描述一段安排,行程段对应具体装卸。预约也可从半小时槽位上升到一天的排班,发现跨槽位约束。时间范围用于揭示共同变化的业务概念,不是“一天内全部对象必须一起锁”的结论;尺度应由实际不变式和并发代价决定。 见按时间尺度寻找聚合。

同一患者一天只应预约一次专家,但若每个半小时槽位分别处理,两个请求可能各自看到“尚未预约”并成功占用不同槽位。每笔数据库事务都成功,也未必保护了患者与日期维度的唯一约束。问题在于业务检查与受保护范围错位,不能归因于开发者无法控制数据库事务。参见[[按患者日期保护预约]]。 见槽位成功仍可重复预约。

针对[[槽位成功仍可重复预约]],将同日重复预约规则纳入明确的一致性边界,可建每日预约模型,或用患者、医生/科室、日期等真实规则对应的唯一约束和原子提交保护。医院稍后确认、取消后重排属于长流程,应另建状态和补偿策略,不能为了覆盖数日流程把聚合无限扩大。书中提出按天重划边界,实际落地仍需存储并发机制。 见按患者日期保护预约。

账务主表余额由期初余额和进出明细共同决定。只写入进账30元、出账20元明细,却未同步把100元余额变为110元,或者只改余额未留明细,都会让查询口径互相矛盾。外键只能约束引用完整性,不会自动计算余额或保证两次业务写入原子完成。参见[[余额明细共同提交]]。 见余额明细脱节的风险。

针对[[余额明细脱节的风险]],把同一账户的一次入账行为封装成领域操作,在一个明确的事务中保存业务明细与对应余额变化,失败一起回滚。跨账户或跨系统仍要重新界定交易规则,不能从“一起放进类”推导分布式原子性。若以事件作为权威记录重建余额,则需另行保证事件追加的版本顺序、幂等与投影追赶,避免把事件日志与普通明细表直接等同。 见余额明细共同提交。

EmployeeService把dao.task1到task4委托给Employee.update,不等于已经形成聚合;若数据仍在边界外被任意修改,不变式没有得到封装。应识别共同维护的业务对象A/B/C/D,把业务决定与对象状态一起组织,再由仓储处理保存。图仅转写书中已给类型与update签名,task1等是原文示意任务,不补造其方法契约。 见事务脚本重构须带数据。

书中把@Transactional直接解释成JTA两阶段提交,容易误导。注解声明事务语义,实际事务范围由事务管理器、资源及调用方式决定;本地单库事务同样可以使用该注解。重构前应识别参与资源、原子性要求、实际管理器和回滚边界,再判断能否收敛为本地事务或需要跨系统协调。打开连接到关闭也不自动等于一个完整事务。 见事务注解不等于两阶段。

会议、酒店、机票、巴士预订不能长期占着一个数据库事务。把每步当成可独立提交的业务动作,记录流程进度;后续失败时对已完成步骤发起取消或业务补偿。补偿本身可能失败,也未必能抹掉已发生事实,应保留重试、人工处理与不可逆步骤的规则。它实现业务可接受的结果收敛,不等于数据库隔离和瞬时回滚。 见长流程用补偿收敛。

事件溯源把事实按顺序追加并重放得到状态,但两个命令仍可能基于同一历史版本作出冲突决定。书中“无需锁、并发和事务也不需要”过强;追加需要期望版本、单写者或等价序列化机制,跨资源发布还需可靠协调。代码示例本身已有Version字段与未提交_changes集合,可见事实不可变并不消除提交阶段的竞争。 见事件溯源仍需并发控制。

订单需要的是成交时选择的送货信息,直接持有地址管理实体会把两个生命周期和后续变更耦合。使用地址标识和必要字段组成订单自己的值对象快照,可记录当时事实;以后是否允许改收货地址由订单规则决定。标识引用与复制快照用途不同,只有ID并不能保证地址历史不变。删除订单项也不应级联删除独立商品或用户地址。 见订单引用地址快照。

在订单之外再加一个“交易”总根,若只是包住订单、支付和发货而没有新不变式,就会把整条流程变成大聚合。抽象应解释一种具体业务关系或规则,并有清晰生命周期,而不是单纯增加父类或层级。书中用奥卡姆剃刀提醒避免上帝对象;不能把“三层树一定过度设计”当成普遍阈值。 见抽象必须增加业务解释。

在不支持货到付款的规则下,下单、付款、打包、发货服务各自修改订单状态,容易漏掉“付款成功后才能发货”的前置条件。只在某个服务检查一次,挡不住其他路径绕过规则;仅检查当前支付许可,也不能证明支付平台已扣款。参见[[订单集中检查状态迁移]]与[[支付成功后确认订单]]。 见分散状态放行未付发货。

针对[[分散状态放行未付发货]],让订单业务方法统一检查允许的状态迁移,使用状态表或状态类型显式表达规则。书中OrderStatus.next()返回下一状态,Payment/Delivery为子类;但setOrderStatus图中把next与当前m_OrderStatus比较,未比较传入目标,不能照抄。校验对象应是请求目标与允许目标,并把比较和更新原子化;新增状态还需补全迁移而非只加子类。 见订单集中检查状态迁移。

“允许支付”是扣款前的业务许可,“已支付”是扣款结果确认后的事实。订单先判断许可,再委托支付接口;成功才能确认状态,失败、超时未知或重试必须有可辨认结果。针对[[分散状态放行未付发货]],不能先写已支付再尝试扣款。书中单机锁或消息排队只约束局部调用顺序,无法独自解决外部扣款与本地保存间的崩溃窗口,仍需支付幂等、结果查询和补偿协调。 见支付成功后确认订单。

把最初用例图、时序图与最终服务接口逐一对照:下单placeOrder、付款payment、发货delivery是否都有入口,是否委托了正确领域规则,是否返回真实业务结果。书中OrderService返回不同状态的Order,但模拟数据入库仅证明这条演示路径,不证明支付与发货已经实现。保留缺失的第三方扣款、物流细节作为实现边界。 见用用例接口校验模型。

书中将领域类、服务接口和仓储分包,让OrderRepo扩展CrudRepository,用Spring Data JDBC保存整个订单聚合,并以Swagger发请求、H2控制台核对订单和子表。复现实验应先创建匹配的聚合映射及表,再下单并检查父子记录与回滚。源码使用模拟条目、findById失败时new Order及不完整状态代码,属于建模演示;HTTP200和一行父表不构成生产正确性的证明。 见聚合持久化演示的边界。

同时观察哪些规则需原子改变、哪些命令争用同一资源、哪些功能常一起发布,有助于发现耦合与边界错位。但有界上下文可以含多个聚合,多个聚合也可部署在同一服务;发布包大小和字段个数不能直接推出领域边界。书中三个边界提供架构诊断视角,最终仍应分别明确一致性单位与部署单位,避免把一对一当作DDD强制规则。 见聚合边界不等于部署边界。

原书依据 · 30 处

第4章 实体和值对象

实体以跨时间的身份连续性组织生命周期,值对象以整体值表达语义。Wallet案例说明把余额规则留在外部服务会掏空实体;ProductSpec与OrderId展示从基础字段提炼领域概念的路径。构造、工厂和Builder需确保完整有效对象,服务分别承担领域策略或应用编排,仓储则隔离存储并以聚合为写入单位。持久化是否已分配ID并不决定实体或值对象的性质。

贫血模型把对象降成字段容器,把行为放到服务里,看似简单,却让业务规则散落在流程脚本中。充血模型让数据和行为共同维护不变性,更适合复杂领域演进。 见贫血模型代价。

实体的核心是连续身份,而不是当前属性值。只要业务上认定它是同一个对象,属性变化不改变其身份;因此实体设计要先问生命周期和标识来源,而不是先堆字段。 见实体靠标识。

值对象没有独立身份,靠一组属性整体表达含义,适合金额、地址、规格等不可拆散的概念。发散:值对象把隐性规则封装成类型,比到处传基础字段更能防止业务语义泄漏。 见值对象靠整体。

领域服务适合表达不自然属于某个实体或值对象的领域行为;应用服务负责编排用例、事务和外部协作。把所有规则都放进服务,会让[[贫血模型代价]]重新出现。 见领域服务别滥用。

仓储用集合视角管理聚合,隐藏数据库、缓存、全文索引等基础设施差异。领域模型只关心对象获取与保存,不应被SQL方言、ORM细节或表结构牵着走。 见仓储隔离存储。

PaymentService取得Wallet后,在外部读取余额并决定是否调用subtractMoney,令余额规则分散且暴露可变对象。并发付款还可同时通过旧余额判断;书中使用严格大于判断会拒绝恰好足额,float金额也不适合直接承担精确货币语义。把规则放回钱包只是第一步,参见[[钱包原子扣款护余额]]。 见外部读余额再扣款。

修复[[外部读余额再扣款]],让钱包自己接受扣款意图,校验金额、币种和余额,在受保护的一次更新中扣减并返回真实成功或拒绝结果。书中Wallet.addMoney(float)/subtractMoney(float)只示范职责归属,未实现并发、幂等、精确金额或失败契约;实际系统应使用明确金额类型与持久层版本/条件更新,不能靠隐藏getter就宣称资金安全。 见钱包原子扣款护余额。

实体身份回答“属性变化后是否仍是同一个业务对象”,不是名称、地址等当前值的拼接。标识需在约定范围内唯一、稳定并可重建引用,可用业务键或系统分配ID;数据库主键只是实现选择。书中把ID说成“类型区别+数值区别”是一种说明方式,不意味着改名要改ID,也不意味着没有入库生成ID的对象就自动成为值对象。 见标识区别于属性摘要。

Cargo运输模型重点是目的地和运输行为,不必把客户与货物详情的数百字段全展开;可以引用它们的标识,把低内聚信息提取到独立对象。整体职责决定聚合候选,身份保证同一实例跨时间可跟踪。字段是否复杂不是实体能否成为根的唯一条件;一个只含基本字段的实体也可能是独立聚合根,物理发动机号更不自动赋予第二个写入入口。 见先区分整体职责与细节。

实体创建必须决定身份来源、必需字段和初始有效状态。把构造入口收敛到工厂,可在同一处校验并禁止半成品逃逸。书中PersonFactory.create(int ID,String name)调用私有Person构造函数,演示创建与使用分工;原图早期示意曾硬编码123456,不能当作正确身份分配。简单实体可直接用有效构造函数,工厂或Builder并非每个领域对象的强制仪式。 见工厂集中实体创建契约。

Builder把身份、名称等参数拆为具名步骤,适合参数多或聚合部件需逐步准备的构建。逐字段提示不能保证最终有效:书中withID/withName只打印错误仍继续赋值,调用者还可能跳过步骤。build应统一验证必需字段与联合约束,不通过就显式失败,避免发布半成品;临时Builder不能被当作已创建实体使用。 见构建器须在完成时校验。

值对象按整体值理解,变化应返回新值而非原地修改,因而可安全复制或共享。final仅禁止字段重新赋值;若字段指向可变集合,集合内容仍可变。应保护输入输出的可变引用、进行防御复制或使用真正不可变元素,并定义符合业务语义的相等与散列。对象是否含名为ID的字段并不决定它是实体;上下文是否用其连续身份才是关键。 见值对象要深度不可变。

将Product的型号、规格、长宽高提炼为ProductSpec,让Product聚焦身份和业务行为。相同规格可共享同一个不可变实例;更改某商品规格应替换该商品引用的值对象,不能修改共享实例而影响其他商品。这里共享的是值,不是所有产品同生共死的实体所有权。实现需保证集合和嵌套对象也不可变。 见规格值对象收拢细节。

绘画只关心“红色”是否满足需要,几支同色蜡笔可以互换;制造追踪则需区分每支笔的批次与经历。这说明实体或值对象由上下文的身份需求决定,不由是否持久化决定。商品在目录中是可追踪实体,在订单里可以表现为带商品ID的购买快照;仍保留ID值也不等于共享目录实体的生命周期。 见同一概念可切换模型角色。

把String返回值包装成OrderId,把String输入包装成AccessToken,先让签名暴露业务含义,再观察行为应归属哪个概念。这可作为旧系统渐进采用DDD的入口,比直接重做实体、聚合和表结构风险小。封装需要有真实验证和语义,不能只换类名;邮件标题与正文若仍是两个同类型构造参数,也需具名步骤或不同类型防止颠倒。 见基础类型换成领域类型。

书中将OrderService.decode(AccessToken)迁入AccessToken.getOrderId(),让值对象承载行为并减少服务脚本。但示例方法内部仍调用远程API,这会把网络失败、权限协议与值语义耦合。判断归属不仅看返回哪个类型,还要看依赖资源和职责;纯本地转换可归值对象,远程查询通常由端口及应用协调返回OrderId。不可变字段并不意味着行为无副作用。 见行为迁移仍要保护纯度。

领域服务表达不自然归属单个实体或值对象的领域动作,可以协调多个模型或实现领域策略,但不应保存某个客户会话、当前交易状态或跨请求可变实体字段。状态通过参数或所操作实体承载,让服务实例可复用。无状态不等于没有数据库副作用,也不等于不能注入无状态依赖;仅有Map字段就一律禁止是过度简化。 见领域服务无状态的含义。

加载聚合、安排事务、调用仓储、发布消息是用例编排;是否允许签订合同、选哪类合同等才是领域规则。JSON反序列化属于适配器技术,外来事件转成本地命令含翻译语义,可放防腐层并调用领域行为。书中服务命名较混杂,不能因为代码出现Order或DomainEvent就判为领域服务。服务网格也只能处理部分通信基础设施,不能替代业务流程编排。 见应用编排与领域策略分开。

仓储不是逐表DAO的改名:它提供聚合的获取与保存契约,隐藏关系库、缓存或搜索实现。写入边界应与不变式对齐,避免外部绕过根更新内部明细。查询可用专用读取模型处理大集合,不必为一页列表加载整个聚合;但不能把真正的领域决定全塞进SQL或调用方,令领域模型重新退化为容器。 见仓储以聚合为写入单位。

书中演示先构建无数据库ID的订单,再save获取自增ID;这是所选持久化策略,不应称该订单因此由值对象变成实体。实体和值对象按业务身份语义区分。Spring Data JDBC还可借@Version或Persistable等策略识别新实体,预分配ID并非只有大型系统可用;具体方案需和框架版本、映射与并发控制配套。 见空ID是框架新建策略。

JiveJdon先由DAO加载帖子核心及关联ID,再由MessageDirector补全作者、版块、讨论关系和过滤规则。拆阶段是为了组合数据库与缓存来源,不能把仅有ID的临时对象误当完整实体发布。查询首帖/回帖时还需保持实际类型与缓存键一致;Builder完成前必须有明确的未就绪状态和禁止使用约束,避免不同入口得到不同质量的对象。 见仓储加载分核心与补全。

原书依据 · 23 处

第4章 仓储构建与论坛实践

论坛案例把内容、回复关系与可变显示状态分开,并以分阶段Builder、DTO隔离及统一身份构建管理生命周期。最新回复失效既与数据库反查有关,也与误把可变ForumThread复制成值对象有关;多构造入口和双向引用进一步制造半成品与重复实例。作者以“双聚合根”解释历史实现,实际设计仍须明确各一致性边界与更新契约,不能照搬为无约束的两个写入入口。

公开setter让外部任意改状态,聚合就无法保证自己的不变性。把状态变化收敛到命名清晰的业务方法中,既表达统一语言,也让每次修改都经过规则检查。 见私有Setter护规则。

本书用JiveJdon的ForumMessage管理帖子内容,用ForumThread管理回复关系与最新回复状态,并把这种分工称为“双聚合根”。这是作者解决历史模型和缓存生命周期问题的案例,不宜推广为一个聚合随意开放两个根。通常DDD以一个根保护一个一致性边界;若保留两个可独立访问的实体,应明确它们属于同一事务边界还是两个协作聚合,并为并发、缓存实例和跨边界更新制定规则。 见双聚合根取舍。

RequireMessageCore.messageCore返回RequireMessageVO,后者.messageVO返回RequireForum,让编译器引导必需部件的提供顺序,最终生成FinalStageVO再完成实体赋值。这比一个可任意跳步的流式Builder约束更强,但仍须校验空值及跨字段规则。synchronized只互斥同一对象的协作访问,不自动提供数据库事务、异常回滚或安全发布。 见分阶段构建编码必需顺序。

ForumMessage同时接收表单、映射持久化和维护帖子规则,会让一个字段修改牵动三种协议。提取AnemicMessageDTO承担边界数据交换与技术注解,让领域模型只通过业务入口、构造和受控Builder保持有效性。DTO本身可以合理存在,不必将所有数据结构都强行做成充血模型;表单DTO与持久化DTO是否继续共用也需看各自变化,不能再次制造万能容器。 见把DTO职责移出领域实体。

帖子显示需要文本转HTML、敏感词及图片处理等规则。JiveJdon在构建ForumMessage时显式提供FilterPipleSpec,使完整对象携带当前规则并把过滤委托给对应对象,避免服务在外部随意改内容。需要区分原始内容与显示投影、规则版本及重新渲染需求;把一个规则对象注入模型不代表持久化事务或所有输入校验已经解决。 见过滤规则随构建显式注入。

Forum→ForumThread→ForumMessage是全局论坛容器结构,但发帖上下文关注帖子内容与回复关系。不能因Forum处在树顶就把所有主题、作者和帖子锁成一个聚合。选择根需看外部以什么身份定位、内部维护哪些不变式及写入并发,而不是照搬物理包含层次;相似的树形图只提供表达形式,不提供边界正确性的证明。 见容器顶点不是业务聚合根。

标题和正文共同表达帖子内容,可提取MessageVO,实体保留messageId、生命周期和修改入口,将内容过滤与输出等行为委托给值对象。相同内容并不意味着同一帖子,重复检测的相似度也不是实体身份。书中图有字段重名及排版缺陷,理解结构应以语义为准;不可变内容变更应生成新值并由实体受控替换,不能任由外界修改共享内容。 见内容值对象卸下实体细节。

发布回帖是事实,回复数与最后回复是由事实导出的状态。把事实与当前显示状态分开,可以在将来新增订阅通知、作者发帖数等投影时复用事件。前提是事件确实持久记录、可识别顺序与重复处理;仅在内存广播一次不能保证重放。查询到回复数增加也未必证明当前用户这次命令成功,应使用自己的命令标识或结果定位。 见事件导致状态并支持新投影。

addChild接收回帖命令,构建ForumMessageReply,再委托ForumThread.addNewMessage维护关系树与最新回复等状态,随后发布回帖事实。内部需要一起成立的变化应在明确一致性边界完成;跨聚合通知可异步。书中示例捕获异常只打印并继续,且未展示可靠提交/发布机制,不能据此认为消息和持久化已经原子一致。先确定边界再选同步或异步。 见回复命令先维护内部一致。

发布回帖后再查数据库重建整棵关系树,不仅耗费查询与遍历,也可能在事务完成前读到旧的最新回复。JiveJdon把新帖加入已有ForumThread关系模型,并直接维护最后回复,减少重复读取。这要求该实例是真正受控的写入对象,不能把缓存永远当权威;必须协调持久化失败、版本与多进程更新,避免内存先成功但数据库失败。 见更新对象后反查会读旧值。

把含可变ForumThreadState的ForumThread误当值对象复制,会让回帖更新其中一份,而列表浏览另一份,造成最新回复时有时无。它有持续身份与可变状态,应按实体管理。参见[[按身份统一构建实例]]。不可变值可复制或共享且效果等价;必须同步所有副本才能“共享”的对象,不是这个意义的值对象。 见可变讨论状态不能复制。

针对[[可变讨论状态不能复制]],在同一工作单元或明确缓存作用域内,让同一主题ID解析到同一受控ForumThread实例,构建首帖和回帖时复用该实例。统一身份映射、缓存键、实际类型及构建入口,并检查部分对象不会替换完整对象。多节点不可能仅靠本机缓存获得全局唯一内存实例,仍需版本、失效或单写者协调。 见按身份统一构建实例。

帖子标题属于ForumMessage内容,关系树、整体浏览数和主题标签由ForumThread管理,是本书案例的一种职责分法。为了给两个根都提供方便而各存一份标题或标签,会引入额外同步规则;应让一个对象拥有事实,其他入口委托或读取投影。继承使只属于首帖的标签泄漏给回帖时,也应重新考察类型职责,不能仅为躲字段继承随意挪位置。 见职责划分保留单一数据源。

在单例服务的整个发回帖方法上加锁,会让无关主题也串行;若规则只涉及一个主题,可以将互斥收敛到该主题实体的受控更新。前提是同一主题不会产生多个各自加锁的实例。多进程部署仍需持久层条件更新或明确单写路由,不能把“方法属于实体”当作线程安全保证。缩锁前先写清被保护的联合状态与失败恢复。 见按实体锁缩小争用范围。

默认构造函数、外部new后补Builder、仓储直接映射等入口并存,会让同一ID出现不同实际类型、缺Forum名称或solid=false的半成品。私有setter缩小排查入口后,可以在构建处验证必要部件并定位来源。参见[[统一构建再发布到缓存]]。默认构造本身不是错误,危险在于未完成初始化的对象被业务流程当作有效对象使用。 见多构造入口制造半成品。

针对[[多构造入口制造半成品]],收敛到有效构造流程,把实际new放在构建器内部,补齐身份、内容、关联与规则后再向缓存和调用方发布。构造受限是防绕过手段,完成态检查和安全发布才是目标;简单有效构造函数也可满足。若运行中允许重建或刷新,要明确旧实例失效与版本策略,不能仅把构造函数改private就保证一致性。 见统一构建再发布到缓存。

ForumThread构建首帖,首帖又请求ForumThread,可能无限递归或重复创建。MessageDirector提供getMessage(Long)与getMessage(Long,ForumThread)两个入口;由主题构建首帖时传入已有主题,帖子构建过程检测并复用它。传递已有对象用于打破构建环,仍须防止半成品外泄;依赖环过多也提示应重新检查聚合边界和ID引用方案。 见双向引用复用在建对象。

原书依据 · 18 处

第5章 CQRS架构

CQRS首先是一种职责分离:命令表达希望系统执行的业务意图,查询返回为读取设计的信息。它不要求一开始就拆数据库或引入消息系统。本段先比较实现DDD的架构:三层把请求、协调和持久化分开,但若规则都堆进服务或数据库,业务仍会被技术形状约束;DDD领域对象应承接规则,DTO及ORM实体则分别服务传输与存储边界。 参见CQRS保护写模型。 参见数据库别绑领域。 参见六边形看边界。 参见垂直切片按用例。 参见关注分离先明确变化方向。 参见MVC模型不等于领域模型。

清洁架构把源代码依赖指向内部业务策略,用例负责组织资源,适配器转换外部协议。六边形架构进一步用输入端口表达用例、输出端口表达核心需要的外部能力。运行时可以访问基础设施,源码却依赖内部定义的契约。以转账端口和JiveJdon异步适配为例,可以观察接口、实现及事件消费者如何分工,不能把框架注解或包名当成边界已成立的证明。 参见三层分工仍有业务耦合。 参见三类对象服务不同边界。 参见领域服务别滥用。 参见清洁架构依赖向内。 参见私有Setter护规则。 参见SOLID约束核心边界。

垂直切片按具体用例组织变化,查询可直接访问适当数据源,写入仍按业务规则保护聚合。切片不必等于微服务或有界上下文。CQRS可从分离处理器和模型开始,继续共用同一数据库,再根据实际瓶颈引入专用读存储和可靠同步。CQS的方法副作用规则与CQRS模型分离也须区分。 参见按职责重排项目包。 参见输入输出端口按核心定义。 参见转账端口的实现分离。 参见异步适配仍需可靠边界。 参见JiveJdon示范渐进架构。 参见垂直切片不必等于微服务。

查询端不应强迫写聚合承担所有搜索、报表和分页字段。论坛示例先取得分页标识,再加载所需对象,减少完整模型构建。写侧和读侧也可以由不同能力的人员协作,但架构模式并不强制团队或部署一一对应。 参见CQS方法与CQRS模型不同。 参见渐进引入CQRS。 参见处理器传递不替聚合决策。 参见分页标识与对象分开加载。 参见团队可按职责协作。

原书依据 · 25 处

第5章 CQRS架构(续)

本段接续论坛查询案例:内存排序和推荐规则可在后台预计算并缓存,以减少每次请求的工作;复杂读取可以设计专用DTO和存储组合,而不改变写模型。规格模式把满足条件的要求独立成对象,可用于验证、筛选及按目标创建,再用逻辑组合复用规则。 参见CAP决定同步策略。 参见事件同步读模型。 参见派生排序可后台预计算。 参见输入命令表达具体意图。 参见不可变命令固定请求内容。 参见显示过滤不应写回原文。

命令端由应用服务准备身份与附件等数据,转换成表达具体意图的命令,再让聚合判断并发出结果事件。命令不可变有助于异步传递,但final引用不代表深度不可变。论坛读写共享对象时,显示过滤可能被写回数据库而重复应用,说明输入规范化、业务规则和输出格式必须各自定位。 参见读模型重复换取直接查询。 参见结构分离不自动提速。 参见查询DAO组合多种存储。 参见规格封装可组合条件。 参见用规格复用查询条件。

读模型可按界面预先组织字段,用重复换取直接查询;职责拆分本身不会提速。读写存储分开后,同步事务、数据库复制、可靠异步消息等都有能力前提与代价。CAP约束的是分区时线性一致与持续完成请求的选择,不表示所有业务约束都可以放宽。事件载荷、回查及缓存失效还需明确提交和处理顺序,自增ID不证明业务因果或提交总序。 参见目标规格不是当前状态。 参见同步方式依赖存储能力。 参见持久异步隔离同步故障。 参见事件载荷与回查权衡。 参见删缓存须协调持久化。

Axon4.2的历史订单演示将命令、聚合、事件重放、查询投影和API串起来:下单命令交给聚合,OrderPlacedEvent重建状态并更新OrderedProduct视图,查询消息经处理器返回列表。代码展示架构协作,省略了完整规则、持久化及故障恢复,不能据此认定已具备生产级正确性。 参见自增主键不证明事件顺序。 参见Axon连接命令与投影。 参见搭建书中Axon演示。 参见Axon区分命令与重放。 参见查询投影使用独立模型。

原书依据 · 21 处

第6章 事件溯源

事件溯源把导致状态改变的事件序列作为权威记录,当前状态可以按顺序重建,也可保存为派生缓存或快照。它改变的是事实来源与建模视角,并不消除状态、不变量或并发控制。追溯事件需要足够内容重建聚合,普通集成事件则可能只用于通知其他上下文,使用事件驱动不等于已经采用事件溯源。 参见事件是事实来源。 参见事件替代状态。 参见日志顺序保一致。 参见Saga用补偿解耦。 参见追溯事件与集成事件不同。

从活动及事件入手,可以帮助发现聚合和业务阶段。论坛讨论线索承接回帖集合,购物车阶段关注条目变动,订单履约阶段关注支付和发货;这些都是按上下文判断的模型选择。活动窗口与基准余额减少一次重建范围,比赛开始命令与开始事件的处理则展示决策和重放的不同职责。 参见状态可以作为派生缓存。 参见活动视角帮助发现聚合。 参见阶段改变事件的含义。 参见事件修正不等于界面只追加。 参见活动窗口限定重建范围。

历史不可改写不代表界面只能追加原始事件,可以由修订事件投影出当前正文。异步统计和快照提高读取效率,却带来延迟及可靠刷新要求。审计、调试与历史分析是保留事件的重要价值,同时也引入版本、存储和恢复成本。BPMN可协调流程,但各聚合仍须验证业务规则。 参见账户窗口按方向算余额。 参见活动与事件重放分工。 参见BPMN协调不取代业务规则。 参见异步状态读取允许滞后。 参见审计价值来自完整事实。

日志先行可使关系库与搜索索引按同一事实重建,避免直接双写的一边成功或顺序颠倒,但它提供的是有前提的最终收敛。2PC只协调原子提交决定,不能独立替代本地隔离。共识日志、CRDT与工作量证明具有不同的排序、合并和信任假设,不能一概解释为选一个单写者。 参见两段提交只协调原子决定。 参见日志派生视图仍有前提。 参见共识日志与CRDT不同。 参见工作量证明不是物理钟。 参见三种交付语义各有代价。

消息传递语义必须指明边界:至少一次可能重复,Kafka生产者幂等并非按任意业务UUID自动去重,Kafka内事务也不自动覆盖外库副作用。按聚合ID规划分区能帮助维持相应流顺序,但不同分区之间仍没有总序。这些约束引出下段Saga补偿与消费一致性的具体问题。 参见Kafka幂等不靠业务UUID。 参见按聚合键规划顺序。 参见OLEP把日志置于核心。 参见从事件价值选择适用域。

原书依据 · 26 处

第6章 事件溯源(续)

Saga把跨服务流程分为本地步骤,持久记录进度并通过新业务动作补偿失败。协调器集中流程知识,但需要恢复能力;超时并不证明参与者没有执行,可靠消息也不会抹掉迟到结果。补偿是语义上的新动作,不会真正把邮件或外部世界倒带。 参见投射连接读写。 参见CDC是演进桥梁。 参见Outbox保证交付。 参见Saga日志与参与者日志分工。 参见超时不证明业务失败。 参见补偿是新的业务操作。 参见补偿可穿透已用余额。

账户案例明确暴露隔离问题:50元余额加100、支出150,再撤销入账100,最终成了负100。事件顺序正确也不能保证“不透支”成立,需隔离待确认资金或使用适当并发约束。并发命令读取同一余额、重复取消及越界后仍追加成功事件,也都需要各自的拒绝、去重和原子提交边界;本次对原书代码指出问题并给出限定方案,未运行。 参见待确认资金先隔离。 参见追加不防并发透支。 参见校验与追加共同提交。 参见拒绝转账仍可记成功。 参见拒绝分支禁止追加。 参见重复取消会再冲抵。

事件流与快照应记录版本边界,折叠重放应确定且无外部副作用。Kafka既可作为集成消息总线,也可构建事件记录基础设施,选择Topic、键、分区与保留策略时需分别考虑顺序、恢复及契约。外库入账和Kafka偏移不在一个自动事务中,应把业务及幂等记录共同落库后再确认,或采用有明确恢复规则的消费位置方案。 参见取消按原交易去重。 参见三个标识串起流程与事件。 参见快照带边界而非改事实。 参见隔离级别不等于锁住全库。 参见Kafka主题不是每实例一份。 参见事件存储必须保留可恢复历史。 参见偏移量与入账可脱节。

投影把同一事实流变成各类读模型,存储可以是内存、关系库、搜索或文件。同步投影便于即时读取但拉长写入依赖,异步投影便于独立扩展与重建但允许滞后。两个投影互相依赖会产生混合版本,投影器、状态存储和进度提交必须协作。 参见入账与去重一起落库。 参见流折叠要求确定性处理。 参见用Streams维护派生状态。 参见投影按读取用例保存。 参见投影依赖会制造重建竞态。 参见同步投影与异步取舍。

CDC在遗留数据库上捕获行变更,可用Debezium与Connect或嵌入式引擎驱动搜索等派生视图;它不自动生成业务意图,也不等同完整事件溯源。Outbox把业务修改和待发布事实放入同一本地事务,以事件ID去重、聚合ID维持相应分区顺序。最终是否引入事件存储,应依据追溯需求和多方价值,而非把区块链或某个产品视为自动正确的答案。 参见投影器与状态存储分工。 参见Outbox字段各有语义。 参见Debezium捕获行变更。 参见嵌入式CDC需补运维。 参见时间维度不取代当前视图。 参见共享账本仍需信任边界。

原书依据 · 33 处

货物运输系统(上)

货物运输综合案例从一份混合了岗位、管理目标和系统需求的文档开始。建模第一步并非立即设计表,而是确定运输系统的输入、输出与周边责任:仓库、堆场和市场提供哪些事实,运输过程又为人事财务提供哪些原始资料。工资核算被需求提及,并不自动意味着工资规则归运输系统所有。核心子域的判断也以当前企业的竞争目标为前提,案例选择委托受理和计划调度,而不是宣称所有企业的GPS、收费或客户管理永远属于同一种类别。

从动作提取已发生的事件,是发现模型的起点。接受、确认、生成业务编号等事实形成初步时间线;再比较它们共享的规则、标志性结果与前后依赖,才能判断能力环节。一级和二级调度显示两个职责尺度,但岗位设置本身不应直接决定软件边界。可用反事实追问:换成自动算法后,该能力与约束是否仍然存在?事件风暴便于各方拼接局部知识,UML顺序图和类图则帮助把时间顺序、对象关系表达精确;两者都是交流工具,不能代替业务核实。

深层模型在用语冲突中逐渐显现。受理侧准备货物与路线要求,作业侧安排具体行程与资源。Route Specification是运输要求,Itinerary是实现该要求的整体计划,Leg是其中一段。只知道装卸段不足以替代完整行程,只有打印报表也不足以成为另一个上下文的有效输入。统一语言需要既照顾企业熟悉的称谓,又精确说明规则;有界上下文是模型含义的边界,可以存在于单体内,并不自动等于一个微服务。

聚合设计再追问一次受理活动应产出什么、哪些规则不能被破坏。委托单、箱号与装箱信息在案例中共同构成业务完整性线索,Cargo这个名称突出被受理货物,BookingId追踪一次业务受理,技术主键则承担存储身份。业务动作在不同时间完成,并不意味着一个数据库事务应跨人工等待一直持锁;聚合边界仍需在正确性、并发、模型复杂度和加载保存成本之间权衡。路线要求与Delivery资源信息应按职责区分,不能仅凭字段来自同一表就认为语义相同。

静态结构还需与行为相连:命令表达希望发生的事,事件表达已发生的事实,状态标识当前阶段。案例画出预订、确认、生成编号的链条,但命令一般可能被拒绝、产生零个或多个事件,不存在通用的一一对应定律。应用服务协调输入、调用和持久化,聚合守护业务决定。事件作为重建状态的历史与作为跨上下文通知是不同用途。当前状态、流程协调和事件存储各有代价,事件溯源仍需并发控制,不能以“没有覆盖写状态”推导无需一致性保障。

最后用本章源码截图检查模型。Spring Boot/JPA实现和Axon实现展示不同持久化方式,也暴露模型与技术依赖的折中;包名有六边形分层不等于领域完全不依赖框架。practicalddd的命令划分和Delivery内容与本章概念图并不完全相同,阅读时需对齐职责。CargoBookingCommandService传入路线规格,取得具体行程后更新Cargo;这些片段用于理解协作形状,未展示的网络失败、并发控制与持久化原子性不能被默认补齐。运输能力和行程模型又把我们引向后半章:货物要求与运输工具计划如何匹配。

相关知识:从动词找事件;流程划分上下文;聚合命名看活动;命令影响模型;案例压测抽象;先定位系统输入输出;按业务差异识别核心;管理步骤未必业务必需;按事件凝聚发现能力;事件触发不只人工;能力名应表达目的;深层模型靠矛盾推进;流程与边界不是一比一;从事件集合中过滤边界;路线要求区别具体行程;统一语言仍须精确定义;聚合边界要平衡四项;业务标识区别技术主键;按职责区分作业与资源;状态变化区别稳定结构;状态持久化有不同取舍;命令意图不等于既成事实;服务协调聚合决定;保存事件与发布通知分工;示例源码先核对语义;框架注解也是实现依赖;业务路由调用链须可追;路由与行程是满足关系;货物行程关联车辆行程;运输效率是多指标权衡;命名围绕业务创建语境。

原书依据 · 31 处

货物运输系统(续)

后半章把上下文协作落实为输入、结果和实际资源。运输作业若只需路线规格,获取整个Cargo会扩大依赖;案例由预订服务发送RouteSpecification、取得CargoItinerary后更新本地聚合,以缩小交换范围。它是当前场景的选择,不是所有系统都必须遵循的调用方向。业务上的“行程实现路线要求”也不等同Java类型继承;依赖注入、依赖反转和RPC分别讨论装配、依赖方向与跨进程通信,应按真实接口和代码关系判断。

行程安排需要把货物的整体路径与运输工具的运行段对应。一批货可经多段运送,一段又可承载多批货。Voyage、Schedule与CarrierMovement让带日期的运行计划成为显式资源,车辆可用率、重载里程、吨位利用等则构成效率权衡。类图表达了模型形状,不能替代路径搜索和容量校验。本章名为findOptimalRoute的截图展示遍历航次和转换首段,未展示请求过滤或最优性计算;因此不能据这个名称声称算法已经找到最优方案,起止地点与到离时间方向也需核对。

外部行程生成后,预订侧需要相应的命令入口和模型调整。既可由人工确认结果就绪后发命令读取,也可让计算完成的一方发布结果事件。人工参与导致完成时间不确定,却不必然排斥异步。同步RPC可以使用独立契约,异步JSON也有版本、顺序和重复处理约束;协议形式不自动决定是否共享领域模型或实现松耦合。

长期流程把恢复带进业务:哪些步骤已提交,哪些可重试,哪些只能补偿,哪些不可逆,必须显式表达。补偿是新的业务动作,不能保证抹去所有外部后果;事件日志也不会自动带来幂等。跨边界强一致要求可提示重新检查划界,但不能据此宣布所有分布式事务都不可能。原书有关CAP、原子时钟、通用事务及事件存储免ACID的宽泛推断,在本次笔记中限定为设计讨论;实际事件流仍需原子追加和并发条件,具体数据库的两阶段协议也有真实实现与运行代价。

全章收束到投资与命名:核心应是当前有差异化价值且需要实质规则的能力,简单CRUD界面背后可能隐藏人工复杂决策,也可能确实无需复杂建模。原来差异化的能力会商品化,算法难不等于必须永远自建。由业务术语命名、用规则检验边界、再回到代码检查实现,是一次反复收敛的过程;不是套完DDD概念就能证明系统正确。本轮保持light,完成生成时图文和来源核对,没有追加独立内容审查。

相关知识:依赖方向也建模;建模要避算法陷阱;航次计划显式承载时段;最优路由名称不是证明;行程确定会反推聚合入口;同步异步都有契约依赖;依赖注入不等于远程调用;人工作业完成须显式通知;长流程恢复进入业务模型;跨边界一致性先问规则;核心能力会被商品化;简单界面可能藏着核心;事件历史仍需一致性保障。

原书依据 · 13 处

跨章综合

模型边界、事务边界、服务边界与团队边界相互影响,却没有机械一一对应。统一语言让规则可讨论,聚合把决定收敛到合适对象;仓储、应用服务和基础设施协作实现提交,代码类型本身不会提供并发原子性。模型需要以用例、失败路径和实现反馈反复校正。

资金、库存和预约案例进一步说明:先检查再写入可能竞争,余额与明细需共同提交,补偿可能穿透已被消费的余额,重复取消和消费确认还需去重。事件溯源保存历史有助恢复与审计,仍要处理流版本、投影延迟和通知可靠性;CQRS不自动意味着独立数据库或放弃业务一致性。

发散与实践

保留两项与当前Cardbox本地实现直接相关的实践:归档不变式的实现深读,以及恢复边界标记的决策。首轮已经核对具体本地提交、实现文件和官方事务资料;主题以Markdown为真源,DTO本身不作为缺陷。当前成果是材料映射和后续计划,未改应用、写DB、执行测试或现实恢复。

cardbox归档不变式深读(计划:ideas/idea-001-cardbox归档不变式的聚合边界审查.md;材料:ideas/materials/filing-invariant-first-pass.md);cardbox恢复边界标记评估(计划:ideas/idea-002-cardbox贫血模型的可恢复性标记评估.md;材料:ideas/materials/recoverability-decision-first-pass.md)。

生成进度与管理记录

复杂软件设计之道:领域驱动设计全面解析与实战

  • 历史 Skill 版本:概览未记录该字段(v7 重跑产物,见 _workflow.md),不补写。
  • 历史规则记录:book-notes v8(2026-09-24),保留历史事实;本轮实际使用book-notes v23 / book-workflow v4。

类别:领域建模类

整体评级

四象限结论:经典原理(高信息浓度 + 高稳定性)

评级理由: 这本书的主体不是框架教程,而是围绕 DDD 如何处理复杂软件中的业务边界、模型一致性和演进压力展开。第1章从需求表达偏差、技术负债、ER建模与面向对象建模差异切入,解释为什么复杂业务不能只靠 CRUD 和技术分层消化;第2章把战略设计落到有界上下文、统一语言、核心/支持/通用子域和事件风暴;第3~4章讨论聚合、实体、值对象、仓储与充血模型如何维护不变性;第5~6章把 CQRS、CAP、领域事件、事件溯源、Saga 和 CDC 放在一致性与读写模型分离的权衡里。书中确有 Spring Boot、Axon、Kafka 等实现片段,但这些更像案例载体,核心推理即使换成其他语言、框架或消息系统仍然成立,因此归为“经典原理”。

执行模式:light

建档进度:done

原书身份:彭晨阳编著,机械工业出版社,版权页2020年8月第1版第1次印刷,ISBN9787111661122;OPF的2020-07-14为文件元数据时间,与纸书版权月分别记录。

原文来源:books/架构归档7/复杂软件设计之道:领域驱动设计全面解析与实战.epub;SHA-256 cbb342491789d66a904bcb1d4f32ece952bdb5437338f8175d183039f39d59ad;当前489 ZIP成员逐一匹配,历史派生_chapter_text不作为本轮来源。

整书笔记:_book_note.md(schema 1;SHA-256 1ec638679532b1557167b97ad92a94bc584c2eaa44dc0f60ce559390a676c5f7)。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
None 内容简介与出版信息 done 0
1 第1章 领域驱动设计基础 done 32
2 第2章 领域驱动战略设计 done 24
3 第3章 聚合设计 done 28
4 第4章 实体和值对象 done 38
5 第5章 CQRS架构 done 42
6 第6章 事件溯源 done 56
7 货物运输系统 done 44

非正文排除

spine项 类型 排除理由
0 / titlepage.xhtml 封面 封面、作者履历或扉页;原图已读,无实质知识正文
1 / OEBPS/Text/chapter1.xhtml 作者简介 封面、作者履历或扉页;原图已读,无实质知识正文
2 / OEBPS/Text/chapter2.xhtml 书名页 封面、作者履历或扉页;原图已读,无实质知识正文
16 / OEBPS/Text/chapter11.xhtml 出版推荐广告 已实际读取原图;出版社其他图书广告或封底重复内容,不是独立正文机制
17 / OEBPS/Text/chapter12.xhtml 封底简介 已实际读取原图;出版社其他图书广告或封底重复内容,不是独立正文机制

待关联术语

术语名 出现章节 一句话语境
SOA 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
NoSQL 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
DevOps 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
DRY 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
BPMN 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
OOAD 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
作用域 1 作为技术背景或比较中的提名;实质机制在本章或后章卡解释,未补造独立原理
miro 2 作为框架、绘图工具或案例名称提名,原文未展开独立机制
lucidchart 2 作为框架、绘图工具或案例名称提名,原文未展开独立机制
Activiti 2 作为框架、绘图工具或案例名称提名,原文未展开独立机制
Camunda 2 作为框架、绘图工具或案例名称提名,原文未展开独立机制
HL7 2 作为框架、绘图工具或案例名称提名,原文未展开独立机制
聚合 3 事务、并发与对象职责的边界
Saga 3 跨步骤业务补偿
事件溯源 3 保存事实后重建状态,仍需并发控制
信息拥有者模式 3 订单掌握条目与地址信息
奥卡姆剃刀 3 无新规则时避免增加交易总根
Spring Data JDBC 3 聚合持久化演示
值对象 4 整体值与不可变语义
实体 4 连续身份与生命周期
Builder 4 完整有效对象构建
Repository 4 隔离存储的聚合契约
GRASP 4 对象职责分配
六边形架构 4 领域与外界适配器分离
JiveJdon 4 论坛生命周期及职责案例
Jdon 4 单写和领域事件框架
ServiceMesh 4 通信基础设施不等于业务编排
Zeebe 4 流程引擎提及
MVP/MVVM 5 界面职责变体,边界差异并入MVC模型卡
Maven/Ant 5 依赖梳理工具提名
Spring/JPA/JDBC 5 历史技术实现与持久化方式,未逐API扩展
ElasticSearch/Redis/Ehcache 5 查询存储的技术选择示例
JTA/XA/JNDI 5 跨资源事务的实现术语,能力前提已成卡
Avro/Calcite/Omid/Avatica/KCache 5 数据库组装组件提名,未实际展开机制
LMAX Disruptor 5 Jdon进程内消息数据结构提名,不声称端到端无锁保证
WORM 6 硬件级只写一次可增强审计保护,已并入审计价值卡
Paxos/Raft 6 共识协议提名,与CRDT区别已保留
Spanner/GPS 6 原书时间同步背景提名,未引申具体部署
ZooKeeper 6 原书以此声称Kafka死锁迁移原因,未采纳未经核验的历史因果
OLTP/OLAP 6 与OLEP对比的处理范式提名
工作流/BPM引擎 7 原文泛述长流程协调,未展开具体引擎机制,不将所有框架归为长时间数据库锁

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境
Domain-Driven Design: Tackling Complexity in the Heart of Software 书 前言/1 DDD起源与本书概念梳理对象
UNIX哲学 书 前言/1 引用数据结构与算法关系观点,非完整介绍
JiveJdon 源码项目 前言/1 论坛系统演进例,完整项目机制见第5章
Axon 框架 前言/1 前言介绍第5章实现案例
Domain Storytelling 方法网站 2 原书实际介绍以故事探索业务语言,https://domainstorytelling.org
Kubel 工具 2 原书实质介绍实验性上下文词汇分组工具,已成延伸参考卡;未联网核验当前服务
事件风暴专题 专题网站 2 原书提供https://www.jdon.com/tags/45214,作为进一步阅读入口
Greg Young 人物 3 事件溯源聚合示例
Mathias Verraes 人物 3 聚合三个边界的新定义
Eric Evans 人物 3 DDD方法继续发展
https://github.com/banq/order 项目 3 Spring Boot订单演示源码
类与数据结构的比较 文章 4 鲍勃大叔对象封装与数据结构比较
Blake Caldwell 人物 4 Builder创建聚合讨论
Jive 项目 4 JiveJdon沿用其历史数据表
https://github.com/banq/jivejdon 项目 4 论坛实现
https://www.jdon.com/ddd/jivejdon/1.html 文章 4 进一步设计说明
Martin Fowler 人物 4 继承与组合观点
测试驱动的面向对象软件开发 书 5 六边形架构采用来源提名
banq/order 源码项目 5 清洁架构重构与分层示例
thombergs/buckpal 源码项目 5 端口与账户窗口代码结构实读
mahanhz/clean-architecture-example 源码项目 5 仅参考地址
practicalddd/implementations 源码项目 5 货运微服务按Domain/Application/Infrastructure/Interfaces组织,已并入分层及切片协作
Axon Framework 框架 5 已生成实质延伸参考及操作、结构卡
JiveJdon/JdonFramework 源码项目 5 论坛案例与异步适配,实质已成卡
OLEP ACM Queue文章 论文 6 日志提升为应用模型的来源,已成延伸参考卡
Conflict-free Replicated Data Types (CRDTs) 论文 6 原作者综述用于纠正并发合并并非总序
Bitcoin: A Peer-to-Peer Electronic Cash System 论文 6 原始白皮书校正PoW与Merkle树用途
Camunda/Activiti 框架 6 流程活动和补偿示例;历史产品演化断言未当当前事实
Debezium/outbox示例 源码项目 6 Outbox字段与CDC桥接
sohangp/embedded-debezium 源码项目 6 嵌入式StudentCDC演示用途已保留
confluentinc/kafka-streams-examples 源码项目 6 流式聚合完整示例提名
practicalddd/practicaldddbook Chapter5 源码项目 7 本章Cargo Spring Boot/JPA、Axon及routingms技术实现截图,实际对照范围仅本书版本
领域驱动设计(Eric Evans) 书 7 Cargo案例与统一语言背景;不是本轮逐页阅读该外部书
Camunda 框架 7 状态设计章节只推荐查看工作流框架,未实际展开其运行机制;不编具体版本或当前性能结论

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明
分散状态放行未付发货 分散状态放行未付发货 订单集中检查状态迁移 1 第1章复用第3章问题方案,不重复生卡;事件历史也不能自动免除状态迁移校验。
缺失释放路径会占住座位 缺失释放路径会占住座位 失败超时回收座位 2 电影票教学流程:支付失败或超时后需释放所选座位;非真实事故,不声称竞态已全部解决
补偿可穿透已用余额 补偿可穿透已用余额 待确认资金先隔离 6 入账被并发消费后再补偿产生负余额
追加不防并发透支 追加不防并发透支 校验与追加共同提交 6 读余额和追加之间存在检查竞争
拒绝转账仍可记成功 拒绝转账仍可记成功 拒绝分支禁止追加 6 原代码取消后仍追加成功事件
重复取消会再冲抵 重复取消会再冲抵 取消按原交易去重 6 重复补偿导致重复金额影响
偏移量与入账可脱节 偏移量与入账可脱节 入账与去重一起落库 6 消费确认与外库业务效果不原子
槽位成功仍可重复预约 槽位成功仍可重复预约 按患者日期保护预约 03 按半小时槽位分别保护,却未对患者同日最多一次预约这一跨槽位约束原子校验。
余额明细脱节的风险 余额明细脱节的风险 余额明细共同提交 03 余额与明细应共同变化,分开写入或误信外键导致金额口径脱节。
分散状态放行未付发货 分散状态放行未付发货 订单集中检查状态迁移、支付成功后确认订单 03 订单状态决策散落多个服务,或把支付许可误当资金扣款成功,导致不满足前置条件仍发货。
外部读余额再扣款 外部读余额再扣款 钱包原子扣款护余额 04 外部先读余额后决定扣款,规则外泄且检查扣减未原子化;示例还使用float及严格大于。

具体风险来自书中教学流程和代码;补充方案均写明保证范围,不宣称生产事故已发生或全部竞态已被解决。

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 cardbox归档不变式深读 实现深读 done 03 ideas/idea-001-cardbox归档不变式的聚合边界审查.md;ideas/materials/filing-invariant-first-pass.md
002 cardbox恢复边界标记评估 决策实践 done 04 ideas/idea-002-cardbox贫血模型的可恢复性标记评估.md;ideas/materials/recoverability-decision-first-pass.md

实践候选筛选:done

保留两张真实对象实践:归档不变式读实现;恢复标记作决策。去除未证实历史事故和旧行号/唯一入口断言,明确DTO可合理存在、Markdown主题可重建。其余建模机制由知识卡覆盖,不重复生成无真实对象的重构或实验。

首轮已读当前本地实现及相关原文,已核验官方事务资料/Fowler论述;未改应用、未写DB、未跑测试或现实恢复。

本次交接

沿用44张旧卡的文件名和身份,新卡经全书语义去重;被合并的本轮ch05-011/013留空号并把真实来源补给早章旧卡。必要图像和代码已经实际读取,具体原图与原书勘误边界见各章交付;light跳过生成后复核与独立审查。

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

主题索引

聚合、实体与值对象

比较实体、值对象、聚合与聚合根、工厂等战术建模要素的判定标准与设计原则。

375 张卡片 · 17 本书

主题索引

领域划分与限界上下文

比较子域划分、通用语言、限界上下文与事件风暴等战略设计方法如何确定业务边界。

330 张卡片 · 31 本书

主题索引

分布式事务与一致性

比较内部与外部一致性、XA/2PC/3PC、CAP 与 BASE,以及可靠事件队列、TCC、SAGA、AT 等柔性事务方案。

308 张卡片 · 61 本书

主题索引

领域事件与最终一致性

比较领域事件、消息中间件、事件总线与数据对账在跨聚合、跨服务一致性上的做法与取舍。

263 张卡片 · 46 本书

主题索引

领域建模与需求理解

比较用类图、状态图刻画领域概念与关系的方法,以及领域建模如何促进沟通、破解分析瘫痪、决定并受功能扩展驱动。

212 张卡片 · 17 本书

主题索引

分层、洋葱与六边形架构

比较分层、洋葱与六边形架构如何隔离核心业务逻辑与外部技术细节,以及各层职责与调用规则。

196 张卡片 · 43 本书

主题索引

领域驱动设计统一过程

比较以全局分析、架构映射、领域建模三阶段组织领域驱动设计的过程方法,及其魔方知识体系、交付物、纪律与能力评估。

174 张卡片 · 3 本书

主题索引

架构师成长路径

比较架构师所需的判断力、执行力、创新力及其积累方式与成长阶段。

157 张卡片 · 36 本书

主题索引

中台战略与能力复用

比较中台与平台的差异、业务/数据中台的建设目标,以及消除重复建设、沉淀与编排企业级能力的方法。

142 张卡片 · 20 本书

主题索引

CQRS与读写模型分离

比较命令与查询的职责、模型及读取路径,并标明薄读取层的适用边界。

88 张卡片 · 13 本书

主题索引

领域逻辑的组织方式

事务脚本、领域模型、表模块与服务层的选型、演化与边界:业务逻辑放在哪里、以何种结构组织。

78 张卡片 · 17 本书

主题索引

简单性与复杂度控制

比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。

72 张卡片 · 25 本书