来源书籍

深入实践DDD:以DSL驱动复杂软件开发 (杨捷锋)

Skill 版本:v15 工程实践(高信息浓度 + 低稳定性) 304 张卡片

尚未生成整书笔记。

全书大纲

图式:思维导图

选择理由:已对照 216 个实质正文项及章节大纲复核。全书围绕同一问题依次展开概念定义、DDDML 表达、生成实现及工程反思,各部分是主问题的分支而非严格时间顺序或单一路径,继续使用 Markmap 思维导图能保留这种层级关系。附录只复现前三部分的配置例子,不另起主论点。

核心主旨:如何用可解析的 DSL 严格表达领域模型,并把模型用于软件设计与实现。

论述主线:先以领域模型、聚合、限界上下文及统一语言定位复杂性,再用 DDDML 的类型、约束、行为、模式及 Schema 表达模型;接着讨论代码生成、持久化、一致性、REST API 与管理界面的落地边界,最后用订单建模、实例化需求、SaaS 和 Builder 案例说明模型需在业务反馈与工具实现之间持续校正。生成骨架不能替代手写业务逻辑,SaaS 和词汇表 App 的部分能力仍属设想。

# DSL 如何帮助 DDD 落地
## 概念
- 领域模型与边界
- 命令、事件和状态
## 模型表达
- DDDML 类型、关系与约束
- 行为、模式与 Schema
## 工程落地
- 生成代码与手写业务逻辑
- 持久化、一致性与领域事件
- REST API 与管理界面
## 反馈和演进
- 订单模型与实例化需求
- SaaS 的配置、扩展及成本
- Builder、团队分工和统一语言

章节与卡片

01 前言

3 张卡片

章节作用:提出严格表达领域模型这一全书主问题,说明读者对象与四部分阅读路线。

内容脉络:先区分领域模型与图示或零散知识,再追问团队如何保持一致理解;进而提出 DSL 描述和工具化落地,最后说明模型对设计、开发与测试的作用。

# 前言:让领域模型成为共同依据
## 问题
- 模型不是图示或知识全集
- 团队理解和实现可能分歧
## 提案
- 选择性抽象领域知识
- 用 DSL 严格表达
- 用工具链接到实现
## 协作
- 开发映射模型
- 测试围绕业务行为

相关卡片:领域模型是有选择的抽象、领域模型需要严格表达、模型驱动的测试更稳定

  1. 领域模型是有选择的抽象 理解等级:中级 普通读书笔记卡
  2. 领域模型需要严格表达 理解等级:中级 普通读书笔记卡
  3. 模型驱动的测试更稳定 理解等级:中级 普通读书笔记卡

02 第1章 DDD的关键概念

1 张卡片

章节作用:提出 DDD 以领域为焦点,并用命名问题引出领域建模的难点。

内容脉络:先说明大型软件难在理解领域,再由对象命名追溯到职责界定,最后预告战术与战略概念。

# DDD的关键概念导入
## 核心问题
- 认识复杂领域
- 明确对象职责
## 后续路径
- 战术概念
- 战略概念

相关卡片:命名困难源于职责未明

  1. 命名困难源于职责未明 理解等级:中级 普通读书笔记卡

03 1.1 自顶而下、逐步求精

1 张卡片

章节作用:给后续分析方法提供从总体目标逐层细化的背景。

内容脉络:从程序开发方法说起,借建筑设计类比说明先定高层结构、再细化到实现。

# 逐步求精
## 起点
- 总体目标
## 分解
- 高层结构
- 逐层细化
## 终点
- 可执行程序

相关卡片:逐步求精先定高层结构

  1. 逐步求精先定高层结构 理解等级:中级 普通读书笔记卡

04 1.1.1 DDD开创全新分析流派

1 张卡片

章节作用:说明 DDD 如何把领域分析接到软件设计与实现。

内容脉络:从分析与设计的分工问题切入,再提出单一领域模型兼顾业务概念与可实现性。

# DDD的分析与设计
## 分裂的风险
- 业务分析另成一套
- 实现难以承接
## 单一模型
- 表达领域
- 指导设计

相关卡片:同一模型连接分析与设计

  1. 同一模型连接分析与设计 理解等级:中级 普通读书笔记卡

05 1.1.2 什么是软件的核心复杂性

1 张卡片

章节作用:定位领域范围和概念关系是复杂性的主要来源。

内容脉络:先解释概念关系增多为何难以全面理解,再提出切分以缩小每次处理的问题范围。

# 软件的核心复杂性
## 来源
- 领域范围扩大
- 概念关系增多
## 应对
- 切分问题
- 简化局部关系

相关卡片:切分问题限制概念关系

  1. 切分问题限制概念关系 理解等级:中级 普通读书笔记卡

06 1.2 什么是领域模型

1 张卡片

章节作用:明确领域模型既组织知识,也必须能指导代码设计。

内容脉络:先指出纯分析模型易被实现阶段抛弃,再说明开发者参与建模及模型与代码映射的必要性。

# DDD领域模型
## 领域知识
- 系统化与选择性抽象
## 设计关联
- 开发者参与建模
- 代码保持模型映射

相关卡片:模型与代码应保持映射

  1. 模型与代码应保持映射 理解等级:中级 普通读书笔记卡

07 1.3 战术层面的关键概念

0 张卡片

章节作用:说明本书对战术概念只作选择性强调,并引出后续小节。

内容脉络:先界定本书并非 DDD 入门书,再指出战术层面概念已有其他系统介绍,本书将结合作者理解挑选重点。

# 战术概念导读
## 范围
- 不作完整入门
## 后续
- 挑选重要概念说明

相关卡片:无(本章无合格知识卡)

08 1.3.1 实体

1 张卡片

章节作用:确立实体的身份判据,避免将实体简单等同于持久化表。

内容脉络:以银行账户说明属性状态可变而标识延续,再提醒 ORM 的表映射不能代替领域身份判断。

# 实体
## 身份
- 标识保持不变
## 状态
- 属性可以变化
## 边界
- 不等同数据库表

相关卡片:实体以标识延续身份

  1. 实体以标识延续身份 理解等级:初级 普通读书笔记卡

09 1.3.2 值对象

2 张卡片

章节作用:区分值对象与实体,并展示领域类型对原始值的封装价值。

内容脉络:从无身份标识说明值对象宜不可变,再以 Money、Email 等例子说明类型可承载领域约束;ORM 映射仅作示例。

# 值对象
## 身份与变化
- 无身份标识
- 宜不可变
## 领域类型
- Money 封装金额与币种
- Email 等封装原始值
## 映射
- ORM 示例

相关卡片:值对象无标识且宜不可变、领域类型封装原始值

  1. 值对象无标识且宜不可变 理解等级:中级 普通读书笔记卡
  2. 领域类型封装原始值 理解等级:中级 普通读书笔记卡

10 1.3.3 聚合与聚合根、聚合内部实体

2 张卡片

章节作用:用对象边界、访问入口与生命周期界定聚合及其内部实体。

内容脉络:先定义聚合中唯一的根及内部实体经根访问的关系,再说明内部实体依附根的生命周期,最后用订单头和订单行项解释局部标识及聚合与根可不同名。

# 聚合与聚合根
## 边界
- 一组相关实体作为整体
## 聚合根
- 每个聚合只有一个
- 客户端访问入口
## 内部实体
- 生命周期受根控制
- 订单行项可用局部标识
## 命名
- 聚合与根可不同名

相关卡片:聚合根界定聚合的访问与生命周期、聚合内部实体可使用局部标识

  1. 聚合根界定聚合的访问与生命周期 理解等级:中级 普通读书笔记卡
  2. 聚合内部实体可使用局部标识 理解等级:中级 普通读书笔记卡

11 1.3.4 聚合的整体与局部

0 张卡片

章节作用:补充聚合内整体与局部的身份关系。

内容脉络:先说明内部实体可由根标识与局部标识共同定位,再用订单行号及左右手说明局部标识取决于聚合内的区分条件。

# 聚合的整体与局部
## 聚合根
- 提供整体标识
## 内部实体
- 聚合内使用局部标识
- 与根标识合成全局定位
## 示例
- 订单行号
- 左右手

相关卡片:无(本章无合格知识卡)

12 1.3.5 聚合是数据修改的单元

2 张卡片

章节作用:从数据修改时的一致性要求解释聚合边界。

内容脉络:先用订单头总额与行项之和说明不能容忍的中间状态,再引出聚合内事务强一致与聚合间应用逻辑最终一致的建议,最后区分两种一致性契约。

# 聚合的数据修改边界
## 边界判据
- 短暂不一致能否接受
- 订单总额与行项金额
## 聚合内部
- 修改时维持强一致
## 不同聚合之间
- 可设计最终一致
- 处理过程容许短暂差异

相关卡片:用强一致性要求划定聚合边界、聚合内外的一致性选择

  1. 用强一致性要求划定聚合边界 理解等级:中级 普通读书笔记卡
  2. 聚合内外的一致性选择 理解等级:中级 普通读书笔记卡

13 1.3.6 聚合分析是“拆分”的基础

3 张卡片

章节作用:把聚合分析从对象建模推进到服务、数据和一致性边界的设计依据。

内容脉络:先说明分布式系统的扩展动机和成本,再以订单聚合说明候选服务边界与按根 ID 分片,随后对照过宽事务和每实体最终一致两种极端,得出应在编码前辨明一致性边界与妥协的结论;末段还以订单头和订单行项的联接视图说明聚合关系可作为查询读模型的生成线索。

# 聚合分析与拆分
## 分布式动机
- 水平扩展
- 开发运维成本
## 聚合边界的用途
- 候选服务划分
- 依据根标识分片
## 一致性权衡
- 过宽事务造成耦合
- 全部最终一致增加负担
- 预先明确妥协
## 查询模型线索
- 聚合内实体可共同查询
- 订单头与行项可生成联接视图

相关卡片:聚合边界为拆分提供依据、先分析一致性边界再编码、聚合关系可生成读模型

  1. 聚合边界为拆分提供依据 理解等级:中级 普通读书笔记卡
  2. 先分析一致性边界再编码 理解等级:高级 普通读书笔记卡
  3. 聚合关系可生成读模型 理解等级:中级 普通读书笔记卡

14 1.3.7 服务

1 张卡片

章节作用:说明跨聚合或无自然对象归属的领域行为如何放置。

内容脉络:先定义服务的适用情形,再用转账同时修改两个账户聚合,比较归入账户方法与定义 TransferService 的职责表达。

# 领域服务
## 适用情形
- 行为无自然对象归属
- 协调多个聚合实例
## 转账示例
- 两个账户状态变化
- 服务表达完整操作
## 边界
- 服务不自动提供一致性

相关卡片:跨聚合行为宜由领域服务承担

  1. 跨聚合行为宜由领域服务承担 理解等级:中级 普通读书笔记卡

15 1.4 战略层面的关键概念

1 张卡片

章节作用:从系统演化中的概念分歧引出 DDD 战略设计。

内容脉络:先指出多人长期叠加代码可能破坏概念完整性,再以名称、对象与关系的一致解释说明其含义,最后引出限界上下文、防腐层和统一语言。

# 战略设计与概念完整性
## 大系统的问题
- 不同开发者的概念冲突
## 完整性的含义
- 名称指向稳定
- 对象关系一致
## 后续概念
- 限界上下文
- 防腐层
- 统一语言

相关卡片:概念完整性让模型保持一致

  1. 概念完整性让模型保持一致 理解等级:中级 普通读书笔记卡

16 1.4.1 限界上下文

2 张卡片

章节作用:定义模型语义生效的范围,并给出划分范围的判断角度。

内容脉络:先说明术语含义依赖上下文,再定义限界上下文为模型应用边界,最后以团队能否维护概念完整性判断其大小。

# 限界上下文
## 模型语义
- 边界内术语有明确解释
## 划分判断
- 相关概念可同处一域
- 团队需维持概念完整性
## 范围
- 不预设固定大小

相关卡片:限界上下文界定模型语义、上下文大小取决于语义掌控力

  1. 限界上下文界定模型语义 理解等级:中级 普通读书笔记卡
  2. 上下文大小取决于语义掌控力 理解等级:高级 普通读书笔记卡

17 1.4.2 限界上下文与微服务

1 张卡片

章节作用:澄清战略设计的语义边界与微服务架构的部署边界之间的关系。

内容脉络:先提出“一个微服务是否等于一个限界上下文”的疑问,再用外卖系统中订单服务和后厨服务的事件协作作例子;接着检查两个服务共用领域类型和统一语言的事实,最后区分概念边界与物理组件边界。

# 限界上下文与微服务
## 外卖案例
- 订单服务处理下单
- 后厨服务创建工单
- 事件协作完成正常路径
## 共享模型
- 共用 common-api 类型
- 使用统一语言
## 边界判断
- 微服务有独立部署边界
- 限界上下文看概念语义
- 两者不必一一对应

相关卡片:限界上下文不等于微服务

  1. 限界上下文不等于微服务 理解等级:中级 普通读书笔记卡

18 1.4.3 防腐层

2 张卡片

章节作用:说明不同限界上下文需要集成时,如何保护内部模型并安排跨边界转换。

内容脉络:先提出六边形架构的抽象依赖,再用外卖应用与 CRM、送餐系统的概念差异说明外部模型为何不能直接渗入内部;随后以入站和出站适配器落实防腐层,最后强调翻译代码应有清晰的物理边界,但不必独立部署。

# 防腐层
## 问题
- 外卖应用需要外部能力
- 各上下文术语不同
## 内部选择
- 核心定义期望的端口
- 保留内部概念完整性
## 适配器
- 出站连接外部服务
- 入站接收外部通知
- 承担概念翻译
## 边界
- 代码职责应清晰
- 不要求独立部署

相关卡片:防腐层翻译上下文概念、端口和适配器隔离外部系统

  1. 防腐层翻译上下文概念 理解等级:中级 普通读书笔记卡
  2. 端口和适配器隔离外部系统 理解等级:中级 结构图卡

19 1.4.4 统一语言

1 张卡片

章节作用:把限界上下文中的概念一致性落实为团队交流与代码命名的共同语言。

内容脉络:先定义以模型为主干的统一语言,再说明其覆盖交流、文档、图形和代码;接着解释统一词汇如何减少沟通歧义,最后提出用含中英文和词性的词汇表维护关键概念。

# 统一语言
## 基础
- 领域模型作主干
- 关键概念选定词汇
## 使用
- 团队交流与文档
- 图形和代码
## 维护
- 上下文词汇表
- 中英文及词性

相关卡片:统一语言贯穿沟通与代码

  1. 统一语言贯穿沟通与代码 理解等级:中级 普通读书笔记卡

20 1.5 ER模型、OO模型和关系模型

2 张卡片

章节作用:对照常用建模范式及其术语,为后续选择概念表达方式建立基础。

内容脉络:先列 ER、OO 与关系模型,再解释关系、元组、属性的术语;随后用宠物和主人的事实对照三种模型中的一对多关系、对象属性与外键,说明不同形式可以表达同一认知。

# 三种模型范式
## ER 模型
- 实体与关系
- Person 到 Pet 一对多
## OO 模型
- 类与属性
- Owner 与 Pets
## 关系模型
- 关系、元组、属性
- Pet 外键指向 Person
## 共同点
- 表达同一领域事实

相关卡片:关系模型的基本术语、同一关系可由不同模型表达

  1. 关系模型的基本术语 理解等级:初级 普通读书笔记卡
  2. 同一关系可由不同模型表达 理解等级:中级 结构图卡

21 1.6 概念建模与模型范式

1 张卡片

章节作用:澄清概念建模的任务不受特定范式限制,并衔接 DDD 领域模型与实现。

内容脉络:先反驳概念建模必须使用 ER 模型的看法,再以表格、OO/UML 和 DDD 领域模型举例说明多种表示法可行;最后强调筛选关键领域事实时仍要顾及软件实现。

# 概念建模与范式
## 核心任务
- 选择关键领域事实
- 暂时忽略次要细节
## 可选表示
- ER 或关系表格
- OO 与 DDD 模型
## 后续衔接
- 面向软件实现

相关卡片:概念建模不依赖模型范式

  1. 概念建模不依赖模型范式 理解等级:中级 普通读书笔记卡

22 第2章 其他DDD相关概念

0 张卡片

章节作用:承接战略与战术概念,预告本章将讨论的其他建模用语。

内容脉络:先回顾前文已经介绍的 DDD 基础,再点出领域ID、Local ID、Global ID、命令、事件和状态等后续主题;本节尚未解释其定义和机制。

# 其他 DDD 概念导读
## 已有基础
- 战略概念
- 战术概念
## 后续议题
- 各类 ID
- 命令与事件
- 状态

相关卡片:无(本章无合格知识卡)

23 2.1 领域ID

0 张卡片

章节作用:为后续实体标识与数据库键的讨论明确术语并提出问题。

内容脉络:先把实体 ID 称为领域ID,再提出自然键、代理键和实体引用方式的待答问题;本节尚未给出取舍结论。

# 领域ID议题
## 术语
- 实体的标识
## 待答问题
- 与自然键如何对应
- 代理键何时需要
- 实体间如何引用

相关卡片:无(本章无合格知识卡)

24 2.1.1 自然键与代理键

1 张卡片

章节作用:区分领域中的业务标识与技术实现中的代理标识。

内容脉络:先引入自然键来自现实世界已有属性的定义,再引用代理键暴露给用户后产生业务含义的论点,最后提出“是否面向最终用户”这一书内区分启发式。

# 自然键与代理键
## 自然键
- 领域已有属性
- 可作候选键
## 代理键
- 技术用途标识
- 暴露后可能有业务含义
## 判断
- 观察最终用户如何使用

相关卡片:自然键与代理键的语义区别

  1. 自然键与代理键的语义区别 理解等级:中级 普通读书笔记卡

25 2.1.2 DDD实体的ID需要被最终用户看到

2 张卡片

章节作用:论证领域ID不应被隐藏在数据库代理键之后,并澄清生成方式与语义角色的关系。

内容脉络:先强调实体身份应与领域专家共同建模,再提出业务可见领域ID不能由纯技术代理键替代;随后区分键的生成机制与业务用途,并讨论什么时候需要额外代理键。

# 实体领域ID
## 业务身份
- 与领域专家讨论
- 面向领域使用者
## 与代理键
- 技术键不能替代业务身份
- 额外代理键需有理由
## 生成
- 生成方式不决定语义
- 分布式 ID、自增均可使用

相关卡片:领域ID应进入领域讨论、标识生成方式不决定业务角色

  1. 领域ID应进入领域讨论 理解等级:高级 普通读书笔记卡
  2. 标识生成方式不决定业务角色 理解等级:中级 普通读书笔记卡

26 2.1.3 什么时候使用代理键

3 张卡片

章节作用:评估代理键的实际收益与风险,强调领域身份和业务唯一性不能被技术主键掩盖。

内容脉络:先以客户编号变更说明代理键不能消除业务语义迁移,再质疑每表都加代理主键的惯例;随后借重复会员等级导致折扣错误说明备用业务键的价值,最后讨论性能权衡并主张有证据时再引入代理键。

# 代理键的使用时机
## 业务键变更
- 数据库迁移可能减轻
- 代码与接口仍需核对
## 只有代理键的风险
- 业务重复记录
- 会员等级案例
## 取舍
- 保留业务唯一键
- 评估真实性能需求
- 避免预先普遍添加

相关卡片:代理主键不能替代业务唯一键、业务键变更仍需跨系统核对、代理键优化应延后评估

  1. 代理主键不能替代业务唯一键 理解等级:中级 普通读书笔记卡
  2. 业务键变更仍需跨系统核对 理解等级:中级 普通读书笔记卡
  3. 代理键优化应延后评估 理解等级:高级 普通读书笔记卡

27 2.2 ID、Local ID与Global ID

1 张卡片

章节作用:说明聚合内部实体标识的有效范围,以及跨该范围定位实例所需的信息。

内容脉络:先定义局部ID在外部实体实例内唯一,再把局部ID与外部各级ID组合成派生全局ID;最后用订单行项举例,并提出值对象作为显式表示方式。

# 聚合内部实体的 ID
## 局部ID
- 同一外部实体内唯一
## 全局ID
- 外部实体ID组合
- 直接定位内部实例
## 订单行项示例
- 订单号
- 产品ID
## 表示
- 派生属性或值对象

相关卡片:局部ID和全局ID分属不同范围

  1. 局部ID和全局ID分属不同范围 理解等级:中级 普通读书笔记卡

28 2.3 命令、事件与状态

3 张卡片

章节作用:为后续 CQRS 与事件溯源讨论建立基本概念,并提醒聚合内部修改的边界。

内容脉络:先以取款案例区分命令、事件和状态的时间指向,再说明三者不必一一对应;随后把针对内部行项的修改放回订单聚合,最后区分广义请求与狭义状态变更命令。

# 命令、事件与状态
## 时间指向
- 命令:希望发生
- 事件:已经发生
- 状态:某时刻事实
## 聚合范围
- 行项修改可能影响订单头
- 命令属于订单聚合
## 命令用法
- 狭义是状态变更
- 广义是客户端请求

相关卡片:命令事件状态表达不同时态、聚合内部修改仍是聚合命令、命令一词有广义狭义

  1. 命令事件状态表达不同时态 理解等级:中级 普通读书笔记卡
  2. 聚合内部修改仍是聚合命令 理解等级:中级 普通读书笔记卡
  3. 命令一词有广义狭义 理解等级:中级 普通读书笔记卡

29 第3章 CQRS与Event Sourcing

1 张卡片

章节作用:引出 CQRS 与事件溯源两种后续模式,并澄清二者并非同一概念。

内容脉络:先指出二者常与 DDD 同现而容易混淆,再分别说明查询字段维护、跨数据库查询视图和审计追溯的需求;具体机制留给后续正文。

# CQRS 与事件溯源导入
## CQRS 动机
- 查询模型组织
- 跨数据库数据整合
## 事件溯源动机
- 审计
- 状态变化追溯
## 关系
- 可以结合
- 概念并不相同

相关卡片:CQRS和事件溯源解决不同问题

  1. CQRS和事件溯源解决不同问题 理解等级:初级 普通读书笔记卡

30 3.1 命令查询职责分离

2 张卡片

章节作用:解释 CQRS 的概念模型分离,并区分它与数据库层的读写分离。

内容脉络:先定义写模型和读模型的职责,再对比主从复制只分离物理读写的位置;随后讨论跨微服务查询视图与独立读库的实现取舍,并引出事件溯源作为同步方式。

# CQRS
## 核心
- 更新用命令模型
- 查询用查询模型
## 与复制的区别
- 复制分离物理读写
- CQRS 分离概念模型
## 查询实现
- 跨库视图
- 独立读库与同步

相关卡片:CQRS分离读写概念模型、数据库复制不等于CQRS

  1. CQRS分离读写概念模型 理解等级:中级 结构图卡
  2. 数据库复制不等于CQRS 理解等级:中级 普通读书笔记卡

31 3.2 事件溯源

2 张卡片

章节作用:说明状态变更如何以事件保存与重建,并衔接 CQRS 的查询模型更新。

内容脉络:先定义事件序列与事件存储,再给出状态重放关系;接着描述命令校验、追加事件和可选状态快照的处理步骤,最后用去规范化器消费事件解释查询库增量更新。

# 事件溯源
## 记录
- 变更形成事件序列
- 可靠写入事件存储
## 重放
- 重建当前与历史状态
- 快照可选
## 处理命令
- 获取状态并校验
- 合法后追加事件
## 结合 CQRS
- 消费事件
- 更新查询模型库

相关卡片:事件序列可重建历史状态、事件追加驱动查询模型更新

  1. 事件序列可重建历史状态 理解等级:中级 普通读书笔记卡
  2. 事件追加驱动查询模型更新 理解等级:中级 结构图卡

32 3.3 From-Thru模式

0 张卡片

章节作用:引入后续将以 OFBiz 数据模型展开的 From-Thru 模式。

内容脉络:先说明模式来自对 OFBiz 数据模型的观察,再预告它在特定操作下可与事件溯源相关,并可能配合 CQRS;本节尚未给出结构或操作规则。

# From-Thru 导入
## 来源
- OFBiz 数据模型
## 后续讨论
- 与事件溯源的关系
- 与 CQRS 的配合

相关卡片:无(本章无合格知识卡)

33 3.3.1 示例:ProductPrice

2 张卡片

章节作用:用产品价格说明 From-Thru 的时间有效期建模,并给出当前价格读模型的维护选择。

内容脉络:先列出包含 fromDate 的价格主键及 thruDate,再用旧行截止、新行生效保存历史;随后给出按时间点查询与当前价查询,最后比较同聚合和事件驱动读模型两种维护方法。

# ProductPrice
## 历史
- fromDate 纳入主键
- 旧行设置 thruDate
- 新行设置 fromDate
## 查询
- 按时间点查有效价格
- 当前价格查询可另建 Master
## Master 维护
- 同聚合根方法
- CQRS 读模型消费事件

相关卡片:From-Thru记录有效期、当前价格模型的两种维护方式

  1. From-Thru记录有效期 理解等级:中级 结构图卡
  2. 当前价格模型的两种维护方式 理解等级:高级 结构图卡

34 3.3.2 示例:PartyRelationship

1 张卡片

章节作用:用业务参与者关系展示 From-Thru 可用于价格以外的实体。

内容脉络:先解释 Party 的参与者抽象,再列出关系双方与角色构成的主键,最后补充 fromDate、thruDate 和雇佣关系示例。

# PartyRelationship
## Party
- 个人或组织等参与者
## 关系
- 两端 Party 与角色
- fromDate 与 thruDate
## 示例
- 公司雇佣开发者

相关卡片:Party抽象业务参与者、From-Thru记录有效期

  1. Party抽象业务参与者 理解等级:初级 普通读书笔记卡

35 3.4 CQRS、ES与流处理

1 张卡片

章节作用:澄清三种概念的边界,并说明事务场景下事件重放的目的。

内容脉络:先区分 CQRS 与 ES,再比较事务应用中恢复状态、校验命令与分析型流处理的事后事件统计,最后强调技术相似不等于意图相同。

# CQRS、ES 与流处理
## CQRS
- 命令与查询模型分离
## ES
- 事件重放当前状态
- 校验命令后产生事件
## 书中的分析型流处理
- 已发生事件的事后分析

相关卡片:事件溯源与流处理意图不同、CQRS和事件溯源解决不同问题

  1. 事件溯源与流处理意图不同 理解等级:中级 普通读书笔记卡

36 第4章 DDD的DSL是什么

2 张卡片

章节作用:定义 DSL,并介绍本书提出的 DDDML 及本章讨论范围。

内容脉络:先从模型表达的问题引入 DSL,再定义 DSL 与通用语言的区别,最后说明 DDDML 的 DOM 核心与 YAML、JSON 等文档表示。

# DDD 的 DSL
## 背景
- 模型需表达业务认知
- 模型需指导实现
## DSL
- 面向特定应用领域
## DDDML
- 核心是 DOM
- 文档可用 YAML 或 JSON

相关卡片:DSL面向特定应用领域、DDDML以DOM为核心

  1. DSL面向特定应用领域 理解等级:初级 普通读书笔记卡
  2. DDDML以DOM为核心 理解等级:中级 普通读书笔记卡

37 4.1 为什么DDD需要DSL

0 张卡片

章节作用:引用对 DSL 前景的看法,并提出为何 DDD 落地困难的问题。

内容脉络:先引述 Eric Evans 对 DSL 的期待,再把讨论转向 DDD 在实践中的困难;具体成因尚未在本节展开。

# 为什么 DDD 需要 DSL
## Eric Evans 的期待
- DSL 或成为 DDD 的下一步
- 当时工具尚不成熟
## 本节提出的问题
- DDD 为何难以落地
- 原因留待后文分析

相关卡片:无(本章无合格知识卡)

38 4.1.1 为什么实现DDD那么难

1 张卡片

章节作用:从多种参与角色视角列出模型落地障碍,为后续工具与 DSL 讨论建立问题清单。

内容脉络:先说明领域模型抽象带来的理解困难,再列出产品、分析、开发与项目管理的不同担忧,最后收束到产出标准、模型到代码映射及成本问题。

# DDD 落地困难
## 模型表达
- 抽象且不易共享理解
- 产出标准不清
## 实现连接
- 分析结果如何映射代码
- 代码如何忠实反映模型
## 团队成本
- 成员能否使用
- 工作量是否可承受

相关卡片:DDD落地需连接模型与实现

  1. DDD落地需连接模型与实现 理解等级:中级 普通读书笔记卡

39 4.1.2 搞定DDD的“锤子”在哪里

1 张卡片

章节作用:从框架与编程语言的抽象层级不足,推导作者提出 DDD 原生 DSL 的动机。

内容脉络:先比较框架的开发效率与领域约束,再说明通用 OO 语言缺少聚合等高层概念,最后提出以严格模型表述、代码生成和修改约束连接模型与实现。

# DDD 原生工具
## 既有工具缺口
- 通用框架未必提供领域边界
- 通用 OO 语言缺少 DDD 高层概念
## 作者方案
- DSL 严格描述领域模型
- 工具生成模型对应代码
- 后续修改保持映射

相关卡片:DDD原生DSL约束模型映射

  1. DDD原生DSL约束模型映射 理解等级:中级 结构图卡

40 4.2 需要什么样的DSL

1 张卡片

章节作用:列出作者对 DDD DSL 的表达能力和派生产物的设计目标。

内容脉络:先要求集中记录概念与实现细节,再要求生成与模型有映射关系的代码,随后扩展到 API 文档、DDL、状态机图和客户端脚手架等预期产物。

# DSL 目标
## 模型
- 集中记录关键元素
- 概念与实现细节
## 派生
- 代码
- API 文档与 DDL
- 状态机图与客户端脚手架

相关卡片:DSL集中记录并派生模型产物

  1. DSL集中记录并派生模型产物 理解等级:中级 结构图卡

41 4.2.1 在“信仰”上保持中立

1 张卡片

章节作用:解释为何领域建模语言应跨编程语言与框架,选择开放标准的文本表示。

内容脉络:先描述多技术栈团队中技术偏好造成的重复建设,再提出领域概念优先的中立 DSL,最后说明 YAML、XML 等开放标准便于工具复用和集成。

# 技术中立的 DDD DSL
## 背景
- 多技术栈协作
- 重复建设
## 模型表达
- 先共享领域概念
- 开放标准文本格式
## 工具
- 可视化与编辑
- 面向多语言代码生成

相关卡片:DDD建模语言保持技术中立

  1. DDD建模语言保持技术中立 理解等级:中级 普通读书笔记卡

42 4.2.2 DDD原生

1 张卡片

章节作用:说明 DDD 原生模型与数据库反向生成类之间的差异。

内容脉络:先提出概念建模应先于物理建模,再用 Cross 的扁平坐标列对照 Line、Point 对象结构,最后指出缺失领域概念会影响代码与模型映射及操作复用。

# DDD 原生
## 先建概念模型
- 聚合、实体、值对象
## 表反向生成的风险
- 表列直接对应类属性
- Line、Point 被扁平化
## 模型到实现
- 保留领域结构
- 承载可复用操作

相关卡片:从概念模型生成代码保留领域结构

  1. 从概念模型生成代码保留领域结构 理解等级:中级 结构图卡

43 4.2.3 在复杂和简单中平衡

2 张卡片

章节作用:解释 DDD DSL 在领域表达能力与语言复杂度之间的取舍。

内容脉络:先说明丰富表达增加 DSL 复杂性,再以不预设基本类型鼓励值对象、以有限导航和 Set 集合控制语言规模,最后用包含位置的中间对象展示缺少 List 时的变通。

# DSL 设计取舍
## 增加复杂度
- 不预设基本类型
- 鼓励领域值对象
## 控制复杂度
- 有限实体导航
- 属性属性集合只支持 Set
## 变通
- 中间对象保存位置
- 用 Set 表达有序排名

相关卡片:DSL表达能力需权衡复杂度、用带位置的中间对象表达有序集合

  1. DSL表达能力需权衡复杂度 理解等级:中级 普通读书笔记卡
  2. 用带位置的中间对象表达有序集合 理解等级:中级 结构图卡

44 4.2.4 通过DSL重塑软件开发过程

0 张卡片

章节作用:列出作者期望 DSL 贯穿建模、代码生成、可视化和领域专家反馈的开发愿景。

内容脉络:先说明用 DSL 准确记录领域模型,再设想生成可扩展代码和 UI,以便领域专家反馈并快速重做模型;本节是目标陈述,未给出新的工具机制。

# 用 DSL 重塑开发过程的愿景
## 建模
- 提高分析质量
- 准确描述领域模型
## 生成
- 可扩展的实现代码
- 可运行且有界面的软件
## 反馈
- 领域专家确认模型
- 发现偏差后快速重做

相关卡片:无(本章无合格知识卡)

45 4.3 DDDML——DDD的DSL

0 张卡片

章节作用:交代 DDDML 与 DDDML Tools 的作者和用途,安排后续规范与术语说明。

内容脉络:先声明 DDDML 是作者设计的 DDD DSL,再介绍配套工具链用于模型到代码映射,最后引出规范和词汇表;本节未展开新机制。

# DDDML 与工具链导读
## DDDML
- 作者设计的领域建模 DSL
## DDDML Tools
- 将模型映射到实现代码
## 后续
- 规范与术语
- 设计取舍和生成示例

相关卡片:无(本章无合格知识卡)

46 4.3.1 DDDML的词汇表

2 张卡片

章节作用:定义 DDDML 文档对象模型及后文阅读所需的结点和类型术语。

内容脉络:先区分 DOM 树与 YAML/JSON 表面表示,随后用路径定位结点,再逐一定义 Map、Object 和 List 与 JSON 概念的对应关系。

# DDDML 词汇表
## DOM
- 可用 JSON 表达的树
- YAML 只是常用表示
## 结点
- 路径定位
## 类型
- Map 对应 JSON Object
- Object 对应 JSON Value
- List 对应 JSON Array

相关卡片:DDDML模型独立于文本格式、DDDML与JSON类型异名

  1. DDDML模型独立于文本格式 理解等级:中级 普通读书笔记卡
  2. DDDML与JSON类型异名 理解等级:中级 普通读书笔记卡

47 4.3.2 DDDML的Schema

1 张卡片

章节作用:说明可用 JSON Schema 校验 DDDML 文档及其边界。

内容脉络:先提出将 DDDML 结构写为 JSON Schema,再介绍工具与编辑器的校验支持,最后说明所给 Schema 尚不完整,以及 YAML、JSON 表述共享 DOM 的关系。

# DDDML Schema
## 结构规则
- JSON Schema 表述
## 校验入口
- JSON 文档
- 支持插件的 YAML 编辑器
## 边界
- 示例 Schema 不完整

相关卡片:Schema校验DDDML文档

  1. Schema校验DDDML文档 理解等级:中级 普通读书笔记卡

48 4.4 DDDML示例:Car

2 张卡片

章节作用:以汽车维修领域展示聚合、内部实体、值对象、枚举对象和领域方法的 DDDML 表达。

内容脉络:先定义 Car 聚合及 Wheel、Tire、Position 的从属结构,再列出值对象和枚举对象;随后用 Rotate 方法及其成功事件展示行为,最后解释不另设 root 结点的表示选择。

# Car 聚合
## 实体
- Car 聚合根
- Wheel 与 Tire
- Tire 下的 Position
## 其他对象
- TimePeriod 与 TireWheelIdPair 值对象
- WheelId 枚举
## 行为
- Rotate 方法
- 成功后 TireWheelPairsRotated 事件

相关卡片:Car聚合用嵌套结构表示边界、聚合方法成功后产生领域事件

  1. Car聚合用嵌套结构表示边界 理解等级:中级 结构图卡
  2. 聚合方法成功后产生领域事件 理解等级:中级 普通读书笔记卡

49 4.4.1 “对象”的名称在哪里

1 张卡片

章节作用:说明 DDDML 有名模型元素的名称存放位置。

内容脉络:先列举实体、值对象、属性与方法等有名元素,再说明它们位于 Map 中,Map 的键就是名称,不必在键对应的值中重复声明。

# 有名元素
## Map
- Key 是元素名称
- Value 是元素定义
## 适用对象
- 实体和值对象
- 属性和方法

相关卡片:Map键即模型元素名

  1. Map键即模型元素名 理解等级:初级 普通读书笔记卡

50 4.4.2 使用两种命名风格:camelCase与PascalCase

1 张卡片

章节作用:通过两种命名风格提高 DDDML 文档的可读性。

内容脉络:先定义 camelCase 的规范关键字,再定义 PascalCase 的领域对象名称,最后说明路径中的风格差异如何帮助人工阅读。

# DDDML 命名风格
## 规范关键字
- camelCase
- aggregates / entities / id
## 领域名称
- PascalCase
- Car / Wheel / Wheels

相关卡片:命名风格区分关键字与领域名

  1. 命名风格区分关键字与领域名 理解等级:初级 普通读书笔记卡

51 4.4.3 为何引入关键字itemType

1 张卡片

章节作用:解释集合元素类型关键字以及属性与参数两种位置的集合语义。

内容脉络:先展示 Wheels 属性和 Rotate 方法参数的 itemType,随后说明属性状态只用 Set、参数只用 List,最后解释不用数组语法的原因。

# itemType
## 属性位置
- 元素类型由 itemType 指定
- Set 语义,不允许重复
## 方法参数位置
- 元素类型由 itemType 指定
- List 语义,有序且允许重复

相关卡片:itemType依位置定语义、DSL表达能力需权衡复杂度

  1. itemType依位置定语义 理解等级:中级 普通读书笔记卡

52 第5章 限界上下文

1 张卡片

章节作用:把 DDDML 项目目录定义为同一限界上下文的模型文件集合。

内容脉络:先说明限界上下文划定模型适用范围,再介绍工具读取同一目录文件并逻辑合并,最后引出根结点与模块等后续话题。

# 限界上下文项目目录
## 范围
- 同一领域模型的应用边界
## 文件
- 多个 DDDML 文件
## 工具处理
- 逻辑合并为一份模型文档

相关卡片:限界上下文项目目录汇集模型文件

  1. 限界上下文项目目录汇集模型文件 理解等级:初级 普通读书笔记卡

53 5.1 DDDML文档的根结点下有什么

2 张卡片

章节作用:列出 DDDML 根层容器与多文件合并规则。

内容脉络:先规定多文档不得重复定义具体模型路径,再依次介绍聚合、公共值对象、枚举对象、基础类型和全局配置,并区分聚合内部与限界上下文共享概念的位置。

# DDDML 根结点
## 合并规则
- 容器结点可在多文件出现
- 具体模型路径不得重复
## 概念容器
- aggregates
- valueObjects 与 enumObjects
- typeDefinitions
## 全局设置
- configuration

相关卡片:同上下文模型路径不重复、根层与聚合内值对象的作用域不同

  1. 同上下文模型路径不重复 理解等级:中级 普通读书笔记卡
  2. 根层与聚合内值对象的作用域不同 理解等级:中级 结构图卡

54 5.2 限界上下文的配置

2 张卡片

章节作用:解释限界上下文配置根结点的用途及领域默认值到实现平台的设置范围。

内容脉络:先说明配置通常独立成文件,再介绍上下文名称、默认模块与保留属性,接着讲数量类型运算、metadata 扩展,以及语言和 ORM 目标的实现参数。

# configuration
## 上下文默认值
- boundedContextName
- defaultModule
- defaultReservedProperties
## 领域运算
- accountingQuantityTypes
## 扩展与实现
- metadata
- Java / CLR / PHP / TypeScript
- Hibernate / NHibernate

相关卡片:上下文配置区分领域与实现、数量运算模板映射目标语言

  1. 上下文配置区分领域与实现 理解等级:中级 结构图卡
  2. 数量运算模板映射目标语言 理解等级:中级 普通读书笔记卡

55 5.3 名称空间

1 张卡片

章节作用:规定限界上下文的类型名称与对象内部成员名称的唯一性。

内容脉络:先说明不同类型共享上下文类型名称空间,再联系统一语言的词汇表,最后提醒自动生成的类型、属性和方法同样会占用相应名称空间。

# DDDML 名称空间
## 上下文类型名
- 实体、值对象、服务等互不重复
- 自动生成类型占用名称
## 对象成员名
- 属性、方法、引用、约束互不重复
- 自动生成成员也占用名称

相关卡片:上下文类型与成员分别命名

  1. 上下文类型与成员分别命名 理解等级:中级 普通读书笔记卡

56 5.3.1 再谈PascalCase命名风格

1 张卡片

章节作用:给出缩写词命名与自动转换时的词组边界。

内容脉络:先规定两字母缩写与较长缩写在 PascalCase 中的写法,再列举向短横线风格转换的期望值,最后指出逐字母切分会破坏缩写词。

# 名称转换
## PascalCase 缩写
- IO 整体大写
- Html 只首字母大写
## 转短横线风格
- IOHelper → io-helper
- 避免 i-o-helper

相关卡片:首字母缩写词转换需按词组切分

  1. 首字母缩写词转换需按词组切分 理解等级:初级 普通读书笔记卡

57 5.3.2 注意两个字母的首字母缩写词

1 张卡片

章节作用:指出两字母缩写的命名转换会影响 JSON 属性映射。

内容脉络:先以 QQNumber 到 qqNumber 说明正向转换,再用 getQQNumber 与 JSON 键的反向推断展示歧义,最后提示具体类库需配置或显式映射。

# 两字母缩写
## 正向
- QQNumber → qqNumber
## 反向歧义
- qqNumber → QqNumber 或 QQNumber
## 序列化边界
- getter 名称
- 显式属性映射

相关卡片:缩写属性须核对序列化映射

  1. 缩写属性须核对序列化映射 理解等级:中级 普通读书笔记卡

58 5.4 关于模块

2 张卡片

章节作用:说明 DDDML 模块的可选性,以及模块与代码组织、部署边界的可能关系。

内容脉络:先说明模块不必成为 DOM 必需层级或语言包,再用 PhysicalInventory 示例讲可选子包映射,最后提出以模块组合紧密相关聚合为部署组件,并讨论细粒度微服务成本与单体应用适用性。

# DDDML 模块
## 模型中
- 可选 module 属性
- 不必改变 DOM 主结构
## 代码中
- 可映射 package
- 也可留在基础包
## 部署中
- 模块可对应独立组件
- 限界上下文仍是概念边界

相关卡片:模块分组不强制映射命名空间、模块可作为微服务物理边界

  1. 模块分组不强制映射命名空间 理解等级:中级 普通读书笔记卡
  2. 模块可作为微服务物理边界 理解等级:高级 结构图卡

59 第6章 值对象

1 张卡片

章节作用:按作用域与实现方式引入 DDDML 中不同的值对象定义位置。

内容脉络:先列出基础类型、上下文公共值对象和聚合内值对象的位置,再说明枚举对象单列,最后以基础类型和数据值对象的实现差异解释这种划分。

# 值对象位置
## 基础类型
- /typeDefinitions
## 数据值对象
- 根层 /valueObjects
- 聚合内 valueObjects
## 枚举
- enumObjects

相关卡片:值对象按复用范围放置

  1. 值对象按复用范围放置 理解等级:中级 结构图卡

60 6.1 领域基础类型

2 张卡片

章节作用:解释为什么 DDDML 不预设原始类型,并强调先记录领域值对象和业务逻辑。

内容脉络:先比较内置基本类型与领域术语的取舍,再允许先使用未完整定义的值对象,最后说明关键业务逻辑可先在模型中记录、后补实现。

# 领域基础类型
## 类型系统
- 规范不预设原始类型
- 上下文可自定义基础类型
## 概念建模
- 先引用领域值对象
- 先记录关键业务逻辑
## 实现
- 后续补类型映射与代码

相关卡片:领域基础类型无预设原始类型、概念建模先记录关键业务逻辑

  1. 领域基础类型无预设原始类型 理解等级:中级 普通读书笔记卡
  2. 概念建模先记录关键业务逻辑 理解等级:中级 普通读书笔记卡

61 6.1.1 例子:从OFBiz借鉴过来的类型系统

1 张卡片

章节作用:展示 DDDML 基础类型与数据库及目标语言类型的映射。

内容脉络:先介绍 OFBiz XML 字段类型,再迁入 DDDML typeDefinitions 的 SQL、C#、Java 映射,最后说明更细的 baseType、length、precision 为可选,并提及导入工具。

# OFBiz 类型映射
## 来源
- OFBiz 字段类型 XML
## DDDML
- /typeDefinitions
- sqlType
- cSharpType
- javaType
## 可选细化
- baseType / length / precision

相关卡片:领域基础类型映射到多种实现类型

  1. 领域基础类型映射到多种实现类型 理解等级:中级 结构图卡

62 6.1.2 例子:任务的触发器

1 张卡片

章节作用:用 Trigger 值对象示范概念逻辑与可执行逻辑的逐步补充。

内容脉络:先在 Task.Trigger 的 defaultLogic 写 PseudoCode,再在实现阶段补 Java 代码,最后解释 Trigger/Cron 值对象类库使生成代码可执行。

# Trigger 默认逻辑
## 概念阶段
- Trigger 值对象
- PseudoCode @yearly
## 实现阶段
- Java Cron.yearly
- Trigger/Cron 类库
- 代码生成

相关卡片:Trigger伪代码渐进实现

  1. Trigger伪代码渐进实现 理解等级:中级 结构图卡

63 6.2 数据值对象

1 张卡片

章节作用:区分只有属性的数据值对象和带方法的复杂值对象,说明当前 DDDML 工具的生成边界。

内容脉络:从 PersonalName 的 properties 出发,解释定义位置、methods 在现有工具中被忽略,以及复杂值对象可转向 typeDefinitions。

# 数据值对象
## 结构
- properties
- PersonalName
## 定义位置
- 上下文 /valueObjects
- 聚合内部 valueObjects
## 当前工具边界
- 忽略此处 methods
- 复杂值对象放 /typeDefinitions
## 生成优势
- 实现代码
- 序列化与持久化

相关卡片:数据与复杂值对象的边界

  1. 数据与复杂值对象的边界 理解等级:中级 普通读书笔记卡

64 6.3 枚举对象

1 张卡片

章节作用:说明枚举对象的定义作用域及跨目标语言的代码生成选择。

内容脉络:先给出上下文级 DocumentAction,再给出聚合内 WheelId,最后讨论可选 baseType 与常量类等生成方式。

# 枚举对象
## 定义
- 上下文级 DocumentAction
- 聚合内 WheelId
## 描述
- values
- 可选 baseType
## 生成选择
- 原生 enum
- 常量类或基类型
- 兼顾目标语言与持久化

相关卡片:枚举对象的作用域与代码生成方式

  1. 枚举对象的作用域与代码生成方式 理解等级:中级 普通读书笔记卡

65 第7章 聚合与实体

0 张卡片

章节作用:导入第7章议题,提示聚合与聚合根的区别以及实体建模的后续问题。

内容脉络:预告基本关系、ID、不变或动态实体、继承、多态、约束和扩展模型信息;具体机制均待后续各节展开。本项零卡。

# 聚合与实体导读
## 聚合与聚合根
- 概念有别
- DDDML 表达待下节
## 实体建模问题
- 基本关系与 ID
- 不变性与动态性
- 继承与约束

相关卡片:无(本章无合格知识卡)

66 7.1 用同一个结点描述聚合及聚合根

2 张卡片

章节作用:解释 DDDML 聚合与根共用结点的设计取舍,并处理三类名称可能不同的情况。

内容脉络:先以 Car 对比合并结点和嵌套 root 的写法;再用 ProductPrice 价格历史案例说明聚合名、根实体名、内部实体名的变化及生成代码的命名风险。

# 聚合与聚合根
## DDDML 结构
- aggregates/Car 同时描述聚合与根
- 不增加 root 嵌套
## 命名演变
- ProductPrice 聚合
- ProductPriceMaster 成为聚合根
- ProductPrice 成为内部实体
## 生成约束
- 避免名称冲突

相关卡片:聚合与聚合根共用结点的取舍、聚合名不等于根实体名

  1. 聚合与聚合根共用结点的取舍 理解等级:中级 普通读书笔记卡
  2. 聚合名不等于根实体名 理解等级:中级 普通读书笔记卡

67 7.2 实体之间只有一种基本关系

1 张卡片

章节作用:明确当前 DDDML 中外层实体到直属内层实体的关系原语,并区分派生引用。

内容脉络:Car 持有 Wheel 与 Tire、Tire 持有 Position;Position 经 WheelId 引用 Wheel 的关系由值对象属性派生。

# 实体关系
## 基本关系
- 外层实体到直属内层实体
- Set 语义集合属性
## Car 示例
- Car → Wheel / Tire
- Tire → Position
## 派生关系
- Position.WheelId → Wheel
- referenceType / referenceName

相关卡片:外层实体持有直属内层实体

  1. 外层实体持有直属内层实体 理解等级:中级 结构图卡

68 7.3 关于实体的ID

2 张卡片

章节作用:区分聚合内部实体的本地、全局和外层 ID,并规定复合 ID 的列名展开顺序。

内容脉络:从 Wheel 的 CarWheelId 组成讲到 outerId/outerIds,再以 Pair 和嵌套 CarId 说明 columnNames 的外到内、深度优先顺序。

# 聚合内部实体 ID
## 三种职责
- Local ID:实体局部标识
- Global ID:外层 ID + 本地 ID
- Outer ID:取得外层标识的派生属性
## 列名映射
- 最外层在前
- 复合值对象按属性顺序
- 嵌套值对象深度优先
- 必要时 sequenceNumber 保序

相关卡片:本地ID与全局ID的边界、复合ID列按外到内展开

  1. 本地ID与全局ID的边界 理解等级:中级 结构图卡
  2. 复合ID列按外到内展开 理解等级:高级 普通读书笔记卡

69 7.4 不变的实体

1 张卡片

章节作用:用有箱号的 WMS 箱子说明实体可不可变,并展示缓存与拆箱的生命周期边界。

内容脉络:先否定以可变性划分实体和值对象;再以 BoxNumber 和 immutable 声明说明按箱号缓存;最后用拆箱旧条码失效和重新装箱新建实例处理例外。

# 不变的 Box 实体
## 身份
- BoxNumber
## 封箱后
- 内容不变
- 按箱号缓存明细
## 拆箱与重装
- 旧条码失效
- 新箱号与新实例

相关卡片:不可变实体仍有身份

  1. 不可变实体仍有身份 理解等级:中级 普通读书笔记卡

70 7.5 动态对象

1 张卡片

章节作用:界定动态实体在运行时增加属性的含义,并用 API 序列化说明实现边界。

内容脉络:Zoo 标记 isDynamic 后,PUT/GET 的 keeper 应与静态属性同层;只增加 Map 字段可能得到嵌套 JSON,需实现层配合。

# 动态实体 Zoo
## 模型
- isDynamic true
- keeper 未预先声明
## API 期望
- PUT 增加 keeper
- GET 顶层返回 keeper
## 实现边界
- Map 默认可能嵌套
- 序列化与存储需配合

相关卡片:动态属性与静态属性同层

  1. 动态属性与静态属性同层 理解等级:中级 普通读书笔记卡

71 7.6 继承与多态

2 张卡片

章节作用:区分子类型定义、多态代码生成和继承持久化策略,并说明区分标识约束。

内容脉络:subtypes 定义聚合根子类型;polymorphic 决定作者工具是否保留多态;inheritanceMappingStrategy 指定持久化映射;discriminator 定义类型区分属性。

# 继承与多态
## 模型
- 聚合根 subtypes
- 父子 ID 同名同类型
## 代码生成
- polymorphic false:成员提升
- polymorphic true:尽量保留多态
## 持久化
- tpch / tpcc / tps
- JPA 风格别名
## 区分标识
- discriminator 属性名

相关卡片:继承模型与多态生成分开、继承映射与区分值分设

  1. 继承模型与多态生成分开 理解等级:高级 普通读书笔记卡
  2. 继承映射与区分值分设 理解等级:高级 普通读书笔记卡

72 7.6.1 使用关键字inheritedFrom

1 张卡片

章节作用:说明聚合根子类型可跨 DDDML 文档继承父类型。

内容脉络:Party 定义留在第一份文档;LegalOrganization 在第二份用 inheritedFrom 指向 Party,重复 id 被忽略;方法层面用法留待后文。

# 跨文档实体继承
## 父文档
- Party
- 子类型可仍内嵌
## 子文档
- LegalOrganization
- inheritedFrom Party
- id 重复声明被忽略

相关卡片:跨文档定义继承子类

  1. 跨文档定义继承子类 理解等级:中级 普通读书笔记卡

73 7.6.2 超对象

2 张卡片

章节作用:用 Article 抽象区分接口式共享与实体子类型继承,并说明本节示例里的布尔关键字默认值选择。

内容脉络:Package 和 PackagePart 通过 implements 共享 Article 的属性;ID 不必相同;生成形式由目标语言决定。属性示例接着说明 notNull 而非 nullable:省略的布尔关键字按 false 处理。

# Super Objects
## 共享抽象
- Article 属性/方法
- Package implements Article
- PackagePart implements Article
## 与 subtypes 区别
- ID 可不同
- 不必形成实体子类型
## 生成形式
- 接口 / 抽象基类 / Mixin
## 布尔关键字默认值
- 未声明按 false 处理
- notNull 显式表达非空约束

相关卡片:超对象复用不要求同ID、布尔关键字让省略值合乎常态

  1. 超对象复用不要求同ID 理解等级:中级 普通读书笔记卡
  2. 布尔关键字让省略值合乎常态 理解等级:中级 普通读书笔记卡

74 7.7 引用

1 张卡片

章节作用:定义 DDDML 中实体引用的含义,连接后续语法说明。

内容脉络:实体通过自身值对象属性指向目标实体;与外键或多对一关系相似,目标可同类型或自身。

# 实体引用
## 来源
- 实体实例
- 自身一个或多个值对象属性
## 目标
- 另一实体实例
- 可同类型或自身
## 类比
- 数据库外键
- ER 多对一

相关卡片:值对象属性定位实体引用

  1. 值对象属性定位实体引用 理解等级:中级 普通读书笔记卡

75 7.7.1 定义实体的引用

1 张卡片

章节作用:比较属性级与实体级引用写法及其适用范围。

内容脉络:ProductTypeId 用 referenceType 直接指向 ProductType;PartyRelationship 的复合 ID 通过 references 属性路径指向 PartyRole;foreignKeyName 与生成行为由部署和工具决定。

# 引用定义方式
## 简单引用
- 属性 referenceType
- 优先使用
## 复合或具名引用
- 实体 references
- 一个或多个属性路径
## 实现边界
- foreignKeyName 可选
- 生成结果依工具

相关卡片:单属性与复合引用的写法

  1. 单属性与复合引用的写法 理解等级:中级 结构图卡

76 7.7.2 属性的类型与引用类型

1 张卡片

章节作用:限定 referenceType 与属性 type 的合法组合,区分实体引用与值对象属性类型。

内容脉络:属性仍保存目标 ID 值对象;依据目标是聚合根、非根实体,或可在同聚合内用 Local ID 定位,选择相应 type。

# 引用属性类型
## 属性本质
- 值对象类型
- 值保存目标 ID
## 合法组合
- 聚合根 → 根 ID 类型
- 非根实体 → Global ID 类型
- 同聚合可定位 → Local ID 类型
## 省略 type
- 根 ID 可推断
- 同聚合 Local ID 可推断

相关卡片:引用声明不改属性类型

  1. 引用声明不改属性类型 理解等级:高级 普通读书笔记卡

77 7.8 基本属性与派生属性

1 张卡片

章节作用:列出实体的三种基本属性和派生判据。

内容脉络:Person 以 BirthDate、Titles、YearPlans 分别示范单值对象、值对象 Set、内部实体 Set;显式或隐式派生逻辑使属性不再属于基本属性。

# 实体基本属性
## 单值对象
- BirthDate
## 值对象 Set
- Titles
## 直属实体 Set
- YearPlans
## 派生判据
- isDerived 或派生逻辑

相关卡片:实体三种基本属性都不是派生属性

  1. 实体三种基本属性都不是派生属性 理解等级:中级 结构图卡

78 7.8.1 类型为实体集合的派生属性

2 张卡片

章节作用:展示实体集合属性的三种派生描述方式及来源关系。

内容脉络:Package 树以 filter 筛出根部件、inverseOf 反转父部件引用;Agreement 以 itemPropertyMap 按四组字段映射查得关系历史。

# 派生实体集合
## filter
- PackageParts → RootPackageParts
## inverseOf
- ParentPackagePart 引用
- ChildPackageParts 反向集合
## itemPropertyMap
- Agreement 属性
- PartyRelationship ID 字段
- 历史关系集合查询

相关卡片:实体集合可由过滤和反向引用派生、属性映射派生实体集合

  1. 实体集合可由过滤和反向引用派生 理解等级:中级 结构图卡
  2. 属性映射派生实体集合 理解等级:中级 普通读书笔记卡

79 7.8.2 类型为值对象的派生属性

1 张卡片

章节作用:说明值对象派生属性的读取与写入逻辑分别表达。

内容脉络:WarehouseId 是 FacilityId 的别名;读调用 getter,写调用 setter,使用不同关键字明确两种操作。

# 值对象派生属性
## WarehouseId 别名
- 源 FacilityId
## 读取
- derivationLogic
- getFacilityId
## 写入
- setterDerivationLogic
- setFacilityId

相关卡片:值对象派生属性分别定义读写逻辑

  1. 值对象派生属性分别定义读写逻辑 理解等级:中级 普通读书笔记卡

80 7.9 约束

1 张卡片

章节作用:定义约束与不变性的关系,区分实体级和属性级放置位置。

内容脉络:数据变化必须维护的规则可由布尔逻辑表达;DDDML 的 constraints 可记录在实体或属性下,具体写法在后续两节展开。

# 约束与不变性
## 不变性
- 数据变化时仍须成立
## 约束
- 布尔逻辑或其定义
- 实体级
- 属性级

相关卡片:约束维护数据不变性

  1. 约束维护数据不变性 理解等级:初级 普通读书笔记卡

81 7.9.1 在实体层面的约束

1 张卡片

章节作用:展示跨字段业务规则如何在实体级 constraints 中定义。

内容脉络:MovementConfirmationLine 的 QuantitiesConstraint 有“已确认”前提,ScrappedQuantityConstraint 要求报废数量不超过确认数量;validationLogic 记录伪代码和 C# 模板。

# 实体级数量约束
## QuantitiesConstraint
- 已确认才检查
- 目标量 + 差异量 = 确认量
## ScrappedQuantityConstraint
- 报废量 ≤ 确认量
## validationLogic
- PseudoCode
- CSharp 模板

相关卡片:实体约束可校验多数量字段

  1. 实体约束可校验多数量字段 理解等级:中级 普通读书笔记卡

82 7.9.2 在属性层面的约束

1 张卡片

章节作用:说明属性级约束可引用上下文命名模式,具体语义由工具解释。

内容脉络:LocatorId 用 numericDashAlphabetic,配置中的 namedStringPatterns 将名称映射到正则;其他模式只是同机制的变体。

# 属性级约束
## LocatorId
- constraints 列表
- numericDashAlphabetic
## 上下文配置
- namedStringPatterns
- 名称 → Regex
## 执行
- 由工具解释与验证

相关卡片:属性约束引用命名模式

  1. 属性约束引用命名模式 理解等级:中级 普通读书笔记卡

83 7.10 提供扩展点

1 张卡片

章节作用:区分实体技术保留属性与其他元数据,并示范实体级覆盖默认设置。

内容脉络:reservedProperties 与 metadata 提供扩展;Package 将乐观锁字段改为 RowVersion,保留业务 Version 的含义;冲突更新后的处理仍属应用实现。

# 实体扩展点
## reservedProperties
- 技术保留属性
- version → RowVersion
## metadata
- 其他扩展信息
## 配置层级
- 上下文默认
- 实体可覆盖(工具规则)
## 乐观锁
- 条件更新
- 冲突后应用处置

相关卡片:实体元数据覆盖上下文默认

  1. 实体元数据覆盖上下文默认 理解等级:中级 普通读书笔记卡

84 第8章 超越数据模型

1 张卡片

章节作用:从静态状态建模转向行为建模,提出方法、安全性和关键业务逻辑等后续议题。

内容脉络:先说明只有聚合、实体与字段还不足以表达领域;再引出 DDDML 的 methods 和业务规则描述。

# 超越数据模型
## 静态模型
- 聚合 / 实体状态
## 动态模型
- 实体与服务方法
- 方法安全性
- 关键业务逻辑

相关卡片:领域建模还需描述动态行为

  1. 领域建模还需描述动态行为 理解等级:初级 普通读书笔记卡

85 8.1 实体的方法

2 张卡片

章节作用:划分业务行为的承载位置,并说明命令方法与领域事件的基本表达。

内容脉络:Money 等值对象承载局部行为,聚合方法修改单个聚合,领域服务协调多个聚合;Person.ChangeEmail 示范无 result 命令与 eventName。

# 实体方法总览
## 行为位置
- 值对象
- 单个聚合
- 跨聚合领域服务
## 命令方法
- 无 result
- 可声明 eventName
## 一致性
- 非根实体状态属于聚合

相关卡片:业务行为依一致性范围分配、eventName标注可能事件

  1. 业务行为依一致性范围分配 理解等级:中级 结构图卡
  2. eventName标注可能事件 理解等级:中级 普通读书笔记卡

86 8.1.1 聚合根的方法

2 张卡片

章节作用:解释聚合根实例方法的调用参数如何补齐,并区分实例与非实例方法的修改范围。

内容脉络:Person.ChangeEmail 只显式写 NewEmail;审计、幂等、定位和乐观锁所需参数可由工具设置补齐或显式命名;实例方法只应修改一个实体,非实例方法可跨实体。

# 聚合根方法
## 业务输入
- NewEmail
## 调用参数
- RequesterId / CommandId
- AggregateId / Version
- 默认或上下文设置补齐
## 方法范围
- 实例:单实体状态
- 非实例:可能跨实体

相关卡片:聚合方法区分业务与技术参数、实体实例方法限定单实体状态修改

  1. 聚合方法区分业务与技术参数 理解等级:中级 普通读书笔记卡
  2. 实体实例方法限定单实体状态修改 理解等级:中级 普通读书笔记卡

87 8.1.2 非聚合根实体的方法

1 张卡片

章节作用:明确内部实体方法的外部调用仍受聚合边界约束。

内容脉络:YearPlan.ChangeDescription 需要目标 Global ID,聚合根乐观锁还需版本;也可把行为放在聚合根并传入导航用 Local ID。

# 非根实体方法
## 调用边界
- 仍是聚合命令
- 不直接访问内部实体
## 定位与并发
- Entity Global ID
- Aggregate Version
## 替代入口
- 聚合根方法
- Local ID 导航

相关卡片:非根实体方法仍作为聚合命令调用

  1. 非根实体方法仍作为聚合命令调用 理解等级:中级 普通读书笔记卡

88 8.1.3 属性的命令

1 张卡片

章节作用:说明属性命令可把有专门业务规则的状态变更从通用创建、更新命令中隔离。

内容脉络:先说明普通实体方法可修改属性,再以 InOut.DocumentStatus 解释属性命令的意图;声明 DocumentAction 后,生成的 Create/Update 命令不再含该属性,处理器接收动作并返回新状态。

# 属性的命令
## 使用动机
- 属性变更有专门逻辑
- 明确修改意图
## DDDML 声明
- DocumentStatus
- commandType / commandName
## 生成结果
- 通用命令移除该属性
- 属性命令处理器求新状态

相关卡片:属性命令隔离状态修改入口

  1. 属性命令隔离状态修改入口 理解等级:中级 普通读书笔记卡

89 8.1.4 命令ID与请求者ID

1 张卡片

章节作用:交代技术参数的命名与命令去重用途。

内容脉络:先通过上下文配置避免技术参数与领域概念冲突,再给出聚合类型、根 ID、命令 ID 组成的查重键,以及客户端生成 ID 的几种方案;领域服务调用也可能需要这些参数。

# 命令ID与请求者ID
## 参数命名
- 上下文默认
- 方法可覆盖
## 重复命令识别
- 聚合类型
- 聚合根 ID
- Command ID
## 客户端生成
- UUID
- 参数摘要
- 创建时可用根 ID

相关卡片:命令ID用于识别重复调用

  1. 命令ID用于识别重复调用 理解等级:中级 普通读书笔记卡

90 8.2 记录业务逻辑

1 张卡片

章节作用:用表 8-1 汇总 DDDML 中业务逻辑关键字、所在节点与责任,为后续小节定位。

内容脉络:从属性的默认值与派生逻辑,转到集合过滤、实体约束、状态转换守卫和方法的验证与变更逻辑;表的两张图片需合读。

# 业务逻辑关键字
## 属性
- 默认值
- 派生读写
## 集合与引用
- filter
- referenceFilter
## 约束与转换
- validationLogic
- guard
## 方法
- verificationLogic
- mutationLogic

相关卡片:业务逻辑关键字按模型位置放置

  1. 业务逻辑关键字按模型位置放置 理解等级:中级 普通读书笔记卡

91 8.2.1 关于accountingQuantityTypes

0 张卡片

章节作用:展示账务数量类型的基础运算如何作为生成模板配置。

内容脉络:先给出配置节点,再列 zeroLogic、addLogic、negateLogic,最后以 decimal 的 Java 模板说明零值、相加与取反,并在加法中处理第二操作数为空。

# 账务数量类型
## 配置节点
- accountingQuantityTypes / 类型
## 基础运算
- zeroLogic
- addLogic
- negateLogic
## decimal 示例
- BigDecimal.ZERO
- add 时空值按零
- negate

相关卡片:无(本章无合格知识卡)

92 8.2.2 关于derivationLogic

1 张卡片

章节作用:用账目余额说明派生属性读逻辑可以表达由已有数据求出的值。

内容脉络:先定义 derivationLogic 是属性读取的派生逻辑,再指出余额等于分录数量总和,最后在 Account.Balance 上声明 derived 和求和表达式。

# 账目余额的派生
## 来源
- Account.Entries
- 各分录 amount
## Balance
- derived: true
- derivationLogic
- sumOf(Entries.amount)
## 边界
- 不一定独立存库

相关卡片:账目余额可由分录金额派生

  1. 账目余额可由分录金额派生 理解等级:中级 普通读书笔记卡

93 8.2.3 关于filter

0 张卡片

章节作用:通过家庭成员集合示范 filter 对派生属性的筛选语义。

内容脉络:Family.Members 是基础集合;YoungMembers 用年龄小于 18 的 filter 派生;有 filter 时不必再显式声明 derived,相关知识已并入第78章卡。

# filter 派生集合
## 基础集合
- Family.Members
## 筛选规则
- Age 小于 18
## 结果
- YoungMembers
- 隐含 derived

相关卡片:无(本章无合格知识卡)

94 8.2.4 使用关键字referenceFilter

1 张卡片

章节作用:说明引用属性可限制其目标实体实例的资格。

内容脉络:先在 Locator.WarehouseId 上声明 Warehouse 引用,再用 referenceFilter 的 Criterion 要求目标仓库 active 为 true;此约束不改变两者分属不同聚合的事实。

# referenceFilter
## 引用属性
- Locator.WarehouseId
- referenceType: Warehouse
## 目标条件
- active 等于 true
## 模型边界
- 只限制可引用实例
- 不合并聚合

相关卡片:引用过滤器限定目标实体

  1. 引用过滤器限定目标实体 理解等级:中级 普通读书笔记卡

95 8.2.5 业务逻辑代码中的变量

1 张卡片

章节作用:交代作者使用的业务逻辑模板占位符约定与规范边界。

内容脉络:先指出 DDDML 未统一规定代码片段如何处理,再说明生成器可替换花括号变量;参数、操作数和上下文分别用不同占位符,其中 this 的含义由工具解释。

# 模板变量
## 方法参数
- {0}, {1}, ...
## 操作数
- {fst}, {snd}, {trd}
## 上下文
- {this}
## 边界
- 作者实践约定
- 非 DDDML 规范

相关卡片:业务逻辑模板变量由工具解释

  1. 业务逻辑模板变量由工具解释 理解等级:中级 普通读书笔记卡

96 8.2.6 说说区块链

1 张卡片

章节作用:借交易链与事件重放的类比,解释命令检查、状态修改与新状态约束三种逻辑的先后关系。

内容脉络:先介绍 Corda 交易链检查与事件流重放的相似处,再按 verificationLogic、mutationLogic、validationLogic 顺序说明命令执行;普通命令失败应拒绝,历史重放异常需个案判断。

# 命令与事件应用逻辑
## 应用前
- verificationLogic
- 旧状态上的合法性
## 状态变化
- mutationLogic
## 应用后
- validationLogic
- 新状态约束
## 失败
- 普通命令拒绝
- 历史重放个案判断

相关卡片:命令校验变更再验证状态

  1. 命令校验变更再验证状态 理解等级:中级 结构图卡

97 8.3 领域服务

1 张卡片

章节作用:确定服务方法的 DSL 位置与跨聚合业务行为的建模边界。

内容脉络:服务节点是方法分组;TransferService.Transfer 操作两个 Account,LeadFollowupService.UpdateAfterFollowup 更新 Lead 且添加 Followup;实例实体方法最多修改一个聚合实例,跨聚合行为由服务方法或根的非实例方法承担。

# 领域服务
## DSL 位置
- services / 服务组 / methods / 方法
## 单聚合
- 实例实体方法
- 根及内部实体作为整体
## 跨聚合
- Transfer 两个 Account
- Lead 与 Followup
- 服务方法或根非实例方法

相关卡片:跨聚合行为定义为服务方法

  1. 跨聚合行为定义为服务方法 理解等级:中级 普通读书笔记卡

98 8.4 在方法定义中使用关键字inheritedFrom

1 张卡片

章节作用:把 inheritedFrom 从实体子类型扩展到方法参数复用,解释跨聚合服务创建命令的参数组织。

内容脉络:先定义方法继承意味着参数列表包含被继承方法的全部参数,再以员工职位服务继承 Party.Create 并追加职位 ID 集合说明减少重复声明。

# 方法 inheritedFrom
## 被继承方法
- Party.Create
- 创建 Party 的参数
## 服务方法
- EmployeePositionService
- CreateEmployeeAndPositionFulfillments
## 新增参数
- FulfilledPositionIds 集合
## 作用
- 避免重复参数声明

相关卡片:服务方法可继承已有方法参数

  1. 服务方法可继承已有方法参数 理解等级:中级 普通读书笔记卡

99 8.5 方法的安全性

1 张卡片

章节作用:说明方法级授权可在模型中声明角色或权限条件,并由工具映射到框架。

内容脉络:User.Create 开启授权;requiredAnyRole 与 requiredAnyPermission 分别给出列表,调用者满足任一角色或任一权限;示例生成 Spring Security 的 hasAnyAuthority。

# 方法授权
## 开启
- authorizationEnabled
## 条件
- requiredAnyRole 任一角色
- requiredAnyPermission 任一权限
- 两组条件是或关系
## 生成示例
- Spring Security
- hasAnyAuthority

相关卡片:方法授权允许角色或权限择一

  1. 方法授权允许角色或权限择一 理解等级:中级 普通读书笔记卡

100 第9章 模式

1 张卡片

章节作用:定义可复用模式并引出 DDDML 对三种模式的声明能力。

内容脉络:从反复出现的问题抽象和命名方案,过渡到模型中声明模式、工具生成部分执行细节;本章将展开账务、状态机和树结构模式。

# 模式
## 来源
- 反复问题
- 抽象、验证与命名
## DDDML
- 声明采用的模式
- 生成执行细节
## 本章三种模式
- 账务
- 状态机
- 树结构

相关卡片:模式把重复问题映射到可复用方案

  1. 模式把重复问题映射到可复用方案 理解等级:初级 普通读书笔记卡

101 9.1 账务模式

3 张卡片

章节作用:建立可追溯数量模型,并用库存单元说明账目、分录、变化量和来源事件的映射。

内容脉络:先定义 Account 和不可变 Entry,以条目合计得当前值;再说明单式模型与复式财务记账的边界;最后以 InventoryItem 的五个账目、分录变化字段和 Source 唯一约束落到 DDDML 示例。

# 账务模式
## 可追溯数量
- Account 当前值
- Entry 变化记录
- 来源事件
## 库存示例
- 五个逻辑账目
- InventoryItemEntry
- entryAmountPropertyName
## 去重
- Source 组合标识
- 唯一约束
## 边界
- 当前仅基础单式支持
- 复式逻辑另行实现

相关卡片:账目以不可变条目追溯数量变化、库存账目映射到分录变化字段、来源事件唯一约束防止重复分录

  1. 账目以不可变条目追溯数量变化 理解等级:中级 普通读书笔记卡
  2. 库存账目映射到分录变化字段 理解等级:中级 普通读书笔记卡
  3. 来源事件唯一约束防止重复分录 理解等级:中级 普通读书笔记卡

102 9.2 状态机模式

2 张卡片

章节作用:用有限状态机声明单据状态的有效转换,并展示守备条件如何分流同一动作。

内容脉络:先以入库/出库单说明源状态、触发动作、目标状态与属性命令的关系;再以库存移动单展示在途条件对 Complete 和 Reverse 的限制,并核对图9-1、图9-2。

# 状态机模式
## InOut 单据状态
- 初始进入 Drafted
- Complete、Void、Close、Reverse
- trigger 类型不限定
- 命令触发可定义属性命令
## Movement 守备条件
- Complete 按 IsInTransit 分流
- InProgress 经 Confirm 完成
- Reverse 限于不在途
- guard 可写语言表达式

相关卡片:状态机用转换约束单据状态、守备条件区分同一触发的转换

  1. 状态机用转换约束单据状态 理解等级:中级 结构图卡
  2. 守备条件区分同一触发的转换 理解等级:中级 结构图卡

103 9.3 树结构模式

1 张卡片

章节作用:定义树结构对应的层次建模问题,引出后续两种 DDDML 表达方式。

内容脉络:以公司部门和分支机构为例,说明实体的父子层次可构成一棵或多棵树;具体建模方式留待后续小节。

# 树结构模式
## 要表达的关系
- 实体层次
- 父子关系
## 例子
- 部门
- 分支机构
## 后续
- 两种 DDDML 定义方式

相关卡片:树结构表达实体层次关系

  1. 树结构表达实体层次关系 理解等级:初级 普通读书笔记卡

104 9.3.1 简单的树

1 张卡片

章节作用:说明内容与层次关系同属一个实体时的树声明方法。

内容脉络:以仓库货位的父货位关系解释 ParentLocatorId,再用 nodeContentType、parentId 和 rootParentIdValues 指定结点、父关系及根结点特殊值。

# 简单的树
## 货位实体
- Locator 作为结点内容
- ParentLocatorId 指向父货位
## LocatorTree 声明
- nodeContentType
- parentId
- rootParentIdValues

相关卡片:简单树以父ID连接实体

  1. 简单树以父ID连接实体 理解等级:中级 普通读书笔记卡

105 9.3.2 使用关键字structureType

2 张卡片

章节作用:把树的结构关系从结点内容中分离,使同一组织可参加不同体系。

内容脉络:先对比简单树的单实体父 ID,再以 OrganizationStructure 表达组织之间的父子关系;最后区分默认缺席判根与显式特殊父 ID 判根。

# structureType
## 结点与结构分离
- Organization 为内容
- OrganizationStructure 为关系
- parentId、childId 指向关系字段
## 根结点判定
- 默认:未作为子结点出现
- 可选:特殊父 ID 值

相关卡片:结构实体分离树结点内容、关系树用子ID缺席识别根

  1. 结构实体分离树结点内容 理解等级:中级 普通读书笔记卡
  2. 关系树用子ID缺席识别根 理解等级:中级 普通读书笔记卡

106 9.3.3 使用关键字structureTypeFilter

1 张卡片

章节作用:限定参与特定组织树的结构关系实例。

内容脉络:说明组织结构类型可以区分多棵树,再以 structureTypeFilter 的 or/eq 条件挑选两种类型的关系记录,最后点明工具可据树定义生成查询与展示代码。

# 结构类型过滤
## 输入
- Organization 结点内容
- OrganizationStructure 关系
## 条件
- structureTypeFilter
- type3 或 type1
## 结果
- 构成 TestOrganizationTree

相关卡片:结构类型过滤限定树的关系

  1. 结构类型过滤限定树的关系 理解等级:中级 普通读书笔记卡

107 第10章 处理限界上下文与值对象

2 张卡片

章节作用:从模型声明转向生成代码,并提出值对象实现时的跨层问题。

内容脉络:先说明选择静态类型代码展示 DSL 映射逻辑的原因,再列出领域基础类型在持久化、序列化、界面及查询中的问题;本章主要讨论前两项,查询 URL 仅作未解例子。

# 处理限界上下文与值对象
## 从模型到代码
- 静态生成物暴露实现逻辑
- 动态对象与代理为替代路径
## 领域基础类型
- 持久化
- 序列化与反序列化
- UI 呈现
- API 查询条件

相关卡片:静态生成代码显露模型映射、领域基础类型需跨层映射

  1. 静态生成代码显露模型映射 理解等级:中级 普通读书笔记卡
  2. 领域基础类型需跨层映射 理解等级:中级 普通读书笔记卡

108 10.1 项目文件

1 张卡片

章节作用:确定限界上下文代码生成时应加载的完整 DDDML 文件集合。

内容脉络:先解释同一上下文文件的逻辑合并,再比较项目目录与项目文件;以 WMS、IAM 两个入口展示包含、排除及公共文件引用。

# 项目文件
## 上下文输入
- 目录加载
- 文件清单加载
## WMS 示例
- 加载当前目录 YAML
- 排除 IAM 文件
- 引入共享文件
## IAM 示例
- 指定五个文件

相关卡片:项目文件确定限界上下文输入

  1. 项目文件确定限界上下文输入 理解等级:中级 普通读书笔记卡

109 10.2 处理值对象

1 张卡片

章节作用:界定无方法数据值对象的基本代码生成方式。

内容脉络:限定 valueObjects 下只含数据属性的情况,说明 Java 代码生成器逐属性生成字段与访问方法,并指出默认 JSON 序列化可能适用。

# 处理值对象
## 当前范围
- 无方法的数据值对象
## Java 生成
- field
- getter
- setter
## 序列化
- 默认逻辑可能适用

相关卡片:数据值对象可按属性生成访问器

  1. 数据值对象可按属性生成访问器 理解等级:初级 普通读书笔记卡

110 10.2.1 一个需要处理的数据值对象示例

2 张卡片

章节作用:用嵌套值对象与复合 ID 展示领域模型对生成代码的要求。

内容脉络:先定义 PersonalName 与 Contact 的嵌套,再用 PersonalName 加 SequenceId 构成 PersonId;讨论业务唯一性、常用查询身份与技术代理键的边界。

# 数据值对象示例
## 嵌套
- PersonalName
- Contact 包含 PersonalName
- Person.EmergencyContact
## 复合 ID
- PersonId 包含姓名与序号
- 同名时以序号区分
- 身份选择应依据领域与查询

相关卡片:数据值对象可嵌套组合、复合业务属性可作为实体ID

  1. 数据值对象可嵌套组合 理解等级:初级 普通读书笔记卡
  2. 复合业务属性可作为实体ID 理解等级:高级 普通读书笔记卡

111 10.2.2 使用Hibernate存储数据值对象

2 张卡片

章节作用:展示值对象生成代码与嵌套值对象的关系表映射。

内容脉络:先给出 PersonalName、Contact 的 Java 生成物和可变性折中,再用派生访问器压平姓名,最后以 Hibernate component 把紧急联系人映射到 People 表的列。

# Hibernate 存储数据值对象
## Java 生成物
- PersonalName 字段与访问器
- 暂选可变实现
## Contact 嵌套姓名
- 派生 protected 访问器
- 压平属性
## Hibernate 映射
- emergencyContact component
- 属性映射到列

相关卡片:可变值对象简化持久化接口、嵌套值对象可压平映射列

  1. 可变值对象简化持久化接口 理解等级:高级 普通读书笔记卡
  2. 嵌套值对象可压平映射列 理解等级:中级 普通读书笔记卡

112 10.2.3 处理值对象的集合

1 张卡片

章节作用:说明集合属性如何在关系表中保留归属关系。

内容脉络:从 Person 的 Set titles 出发,查看 Hibernate 的 set 映射;PersonTitles 表用展开的复合 PersonId 作为 key,TitlesItem 作为元素列。

# 处理值对象的集合
## 对象模型
- Person.titles 为字符串集合
## 关系映射
- PersonTitles 从表
- 复合 PersonId 三列作 key
- TitlesItem 保存标题

相关卡片:值集合可用关联表持久化

  1. 值集合可用关联表持久化 理解等级:中级 普通读书笔记卡

113 10.2.4 在URL中使用数据值对象

1 张卡片

章节作用:把复合值对象 ID 转为适合 URL 路径的稳定字符串,并说明逆向恢复。

内容脉络:先比较 URL 编码 JSON 的繁琐,再按属性出现顺序深度优先展开 PersonId;通过扁平属性名称、类型及遍历方法构造逗号分隔串,反向按相同顺序拆分并转换类型。

# 在 URL 中使用数据值对象
## 输入
- PersonId 包含嵌套 PersonalName
## 正向编码
- 属性顺序固定
- 深度优先展开
- 转字符串并连接
## 反向恢复
- 分割路径片段
- 按类型转换
- 设置扁平属性

相关卡片:复合ID按属性顺序编码URL

  1. 复合ID按属性顺序编码URL 理解等级:中级 普通读书笔记卡

114 10.2.5 处理领域基础类型

5 张卡片

章节作用:说明领域基础类型从 DSL 到语言、数据库与 JSON 的映射,并用时间值对象说明语义边界。

内容脉络:先以 Money 定义目标语言类型,再分别处理 Hibernate 双列映射与 JSON 双向适配;随后区分本地时间、带时区时间和时刻,说明旧版 Hibernate/MySQL/JDBC 组合中的时区往返风险。

# 处理领域基础类型
## Money
- 映射到 Java 与 C# 类型
- ORM 双列持久化
- JSON 双向适配
## 时间值对象
- 本地日期与时间
- 带时区的时刻
- DateTime 与 Timestamp 命名边界
## 持久化风险
- MySQL DateTime 无时区
- UTC 与驱动版本配置

相关卡片:领域基础类型映射到语言类型、Money持久化需拆出金额币种、Money序列化需双向适配、时间值对象先辨明是否为时刻、时区持久化需验证往返语义

  1. 领域基础类型映射到语言类型 理解等级:中级 普通读书笔记卡
  2. Money持久化需拆出金额币种 理解等级:中级 普通读书笔记卡
  3. Money序列化需双向适配 理解等级:中级 普通读书笔记卡
  4. 时间值对象先辨明是否为时刻 理解等级:中级 普通读书笔记卡
  5. 时区持久化需验证往返语义 理解等级:高级 普通读书笔记卡

115 第11章 处理聚合与实体

2 张卡片

章节作用:引出聚合与实体生成代码的边界,说明哪些代码可再生、哪些由开发者维护,以及框架依赖的隔离位置。

内容脉络:从值对象作为实体构造块过渡到聚合;把生成代码区分为可覆盖部分和特别化脚手架;让聚合核心尽量独立于 Hibernate、Spring,后续再用库存账目与单据状态机说明生成工具的帮助。

# 处理聚合与实体
## 代码归属
- 可再生代码允许覆盖
- 特别化脚手架由开发者维护
## 依赖边界
- 聚合核心保留领域逻辑
- 框架依赖进入特定实现
## 后续示例
- 库存账目
- 单据状态机

相关卡片:生成代码区分覆盖与特别化、聚合核心隔离框架依赖

  1. 生成代码区分覆盖与特别化 理解等级:中级 普通读书笔记卡
  2. 聚合核心隔离框架依赖 理解等级:中级 普通读书笔记卡

116 11.1 生成聚合的代码

1 张卡片

章节作用:用 Car 聚合的 Rotate 流程展示命令、事件、状态和持久化之间的先后关系。

内容脉络:应用服务取得当前状态并创建聚合,聚合执行 Rotate 与业务校验;先生成事件,再由 CarState 的 mutate 更新状态;随后取得变更、追加事件并保存状态。图11-1只呈现交互主线,省略生成接口和实现类细节。

# 生成聚合的代码
## 应用服务
- 读取 CarState
- 创建 CarAggregate 并执行 Rotate
## 聚合内部
- 校验命令
- 生成旋转事件
- CarState.mutate 更新状态
## 持久化
- 取得变更
- 追加事件
- 保存状态

相关卡片:聚合先产事件再更新状态

  1. 聚合先产事件再更新状态 理解等级:中级 结构图卡

117 11.1.1 接口

10 张卡片

章节作用:用 Car 示例列出生成器对状态、命令、事件、聚合、事件存储、仓储和应用服务的接口安排,并解释它们的职责边界。

内容脉络:状态接口从只读延伸到可修改和 SQL 适配,内部实体集合按局部 ID 访问;命令先受生命周期校验,局部更新用额外标志区分清空与不修改;事件既可表示状态变化,也可由不同命令产生,内部实体事件归属聚合;聚合执行校验和事件生成,状态应用事件,仓储与应用服务提供外部入口。章末说明代码结构参考了《实现领域驱动设计》的示例项目。

# 生成聚合的接口
## 状态
- 只读 CarState 与可修改子接口
- 内部实体状态集合
- 局部 ID 与全局 ID
## 命令
- 创建更新删除与自定义命令
- 生命周期校验
- 静态局部更新的置空标志
- 内部实体命令服从聚合边界
## 事件
- 命令与事件不必一一对应
- 事件 ID 含实体与版本
- 状态命令事件保持类型独立
## 执行与访问
- 聚合校验并产生事件
- 状态应用事件
- 事件存储和聚合仓储
- 应用服务提供命令查询入口

相关卡片:状态接口分开读取与修改、聚合内部状态集合按局部ID取值、聚合命令先校验生命周期状态、静态更新命令区分置空与不修改、内部实体命令事件服从聚合边界、命令与事件不必一一对应、事件标识包含实体与版本、状态命令事件不应共用继承层级、仓储以聚合为整体、仓储读取状态不应绕过聚合修改

  1. 状态接口分开读取与修改 理解等级:中级 结构图卡
  2. 聚合内部状态集合按局部ID取值 理解等级:中级 结构图卡
  3. 聚合命令先校验生命周期状态 理解等级:中级 普通读书笔记卡
  4. 静态更新命令区分置空与不修改 理解等级:中级 普通读书笔记卡
  5. 内部实体命令事件服从聚合边界 理解等级:中级 普通读书笔记卡
  6. 命令与事件不必一一对应 理解等级:中级 普通读书笔记卡
  7. 事件标识包含实体与版本 理解等级:中级 普通读书笔记卡
  8. 状态命令事件不应共用继承层级 理解等级:中级 普通读书笔记卡
  9. 仓储以聚合为整体 理解等级:中级 普通读书笔记卡
  10. 仓储读取状态不应绕过聚合修改 理解等级:中级 普通读书笔记卡

118 11.1.2 代码中的命名问题

3 张卡片

章节作用:通过 Delete/Remove 与聚合、实体重名两类场景,说明生成代码名称必须反映不同的业务语义和边界。

内容脉络:先区分聚合根删除与内部实体移除,解释默认事件溯源下同 ID 重建的事件冲突风险;再比较聚合名、根实体名和内部实体名的组合,分别为命令、事件、状态对象及 REST 资源路径选名。实体名路径总可用,聚合名与实体名不同的时候还可考虑提供聚合名路径指向同一资源。

# 代码中的命名问题
## Delete 与 Remove
- 内部实体可移除后再添加
- 聚合根删除后默认不可同 ID 重建
- 事件 ID 与历史追溯约束
## 聚合与实体名称
- 聚合名称可能不同于根实体
- 聚合名称也可能等于内部实体
## 生成对象的名称
- 命令与事件按聚合作用层级
- 状态对象按实体
- REST 路径可按实体名定位资源
- 聚合名与实体名不同可考虑聚合名路径

相关卡片:聚合根删除与内部实体移除不同、聚合命令命名须避开内部实体冲突、聚合与实体名决定资源路径

  1. 聚合根删除与内部实体移除不同 理解等级:中级 普通读书笔记卡
  2. 聚合命令命名须避开内部实体冲突 理解等级:中级 普通读书笔记卡
  3. 聚合与实体名决定资源路径 理解等级:中级 普通读书笔记卡

119 11.1.3 接口的实现

7 张卡片

章节作用:用生成的 Java 实现串起上一节的状态、命令、事件、聚合、仓储与应用服务接口,展示事件溯源路径及扩展点。

内容脉络:状态实现按事件重放并管理懒加载的内部实体集合;命令实现包装默认操作与内部实体命令;事件实现把扩展属性集中序列化;聚合把命令映射为事件,验证自定义 Rotate 后应用事件;应用服务查询或去重命令,再调用聚合并追加事件、保存状态。反射调用业务逻辑与独立 DAO 是本工具的实现选择。

# 接口的实现
## 状态
- 事件重放重建状态
- 懒加载内部实体集合
- 全量操作先取全量
- 自定义事件调用无状态变更逻辑
## 命令与事件
- 内部实体命令携带聚合上下文
- 事件扩展属性序列化到单列
## 聚合
- 命令映射事件
- 校验后应用到状态
- 收集待追加事件
## 应用服务
- 查询经状态查询仓储
- 更新前查重复命令
- 事件追加后保存状态

相关卡片:状态可由事件重放重建、懒加载合并勿删未加载实体、自定义事件变更逻辑保持无状态、懒加载集合的全量操作先取全量、事件扩展属性可集中序列化存储、内部实体事件继承外层命令上下文、命令去重须与版本策略配套

  1. 状态可由事件重放重建 理解等级:中级 普通读书笔记卡
  2. 懒加载合并勿删未加载实体 理解等级:中级 普通读书笔记卡
  3. 自定义事件变更逻辑保持无状态 理解等级:中级 普通读书笔记卡
  4. 懒加载集合的全量操作先取全量 理解等级:中级 普通读书笔记卡
  5. 事件扩展属性可集中序列化存储 理解等级:中级 普通读书笔记卡
  6. 内部实体事件继承外层命令上下文 理解等级:中级 普通读书笔记卡
  7. 命令去重须与版本策略配套 理解等级:中级 普通读书笔记卡

120 11.1.4 事件存储与持久化

6 张卡片

章节作用:说明事件和聚合当前状态在 SQL 数据库中的持久化取舍,并用生成的 Hibernate 实现展示事件标识、状态读取的并发检查、表名与版本约定。

内容脉络:先说明 Schema 对复杂应用与数据迁移的价值;再区分必须保存的事件和可由事件重放的当前状态,指出同时持久化时的事务一致性要求;随后展示 Car/Wheel 事件的复合标识与状态仓储的聚合版本检查;最后说明 DDDML 表名覆盖顺序以及 Hibernate、NHibernate 首次保存导致的事件与状态版本偏移。

# 事件存储与持久化
## SQL 与 Schema
- 结构约束和可读设计文档
- 支持迁移差异比较
## 事件和状态
- 事件追加存储
- 当前状态可重放或使用快照
- 同存须保持事务一致
## 生成实现
- 事件由聚合标识和版本定位
- 内部实体读取核对聚合版本
## 配置与版本
- 显式表名优先于全局和默认规则
- 事件版本比状态版本小一位

相关卡片:数据库模式也是设计文档、事件与当前状态须保持一致、复合事件键映射与读取、内部实体读取核对聚合版本、生成表名遵循覆盖优先级、事件版本与状态版本错一位

  1. 数据库模式也是设计文档 理解等级:中级 普通读书笔记卡
  2. 事件与当前状态须保持一致 理解等级:高级 普通读书笔记卡
  3. 复合事件键映射与读取 理解等级:中级 普通读书笔记卡
  4. 内部实体读取核对聚合版本 理解等级:高级 普通读书笔记卡
  5. 生成表名遵循覆盖优先级 理解等级:中级 普通读书笔记卡
  6. 事件版本与状态版本错一位 理解等级:高级 普通读书笔记卡

121 11.1.5 使用Validation框架

1 张卡片

章节作用:把模型约束落实到实体状态修改后的验证环节,并展示 Java 与 .NET 生成映射的接入方式。

内容脉络:先说明修改后的实体状态需要满足约束;若保存当前状态,验证可以安排在入库前。随后用 LocatorId 的格式规则展示 Hibernate Validator 与 NHibernate Validator 的映射文件及监听器配置。

# 使用 Validation 框架
## 约束时机
- 命令修改实体状态后核验
- 保存当前状态前执行
## Java 示例
- 生成约束映射文件
- Validator 加载映射
## .NET 示例
- 生成属性校验映射
- 插入和更新前监听器

相关卡片:状态约束在持久化前验证

  1. 状态约束在持久化前验证 理解等级:中级 普通读书笔记卡

122 11.1.6 保证静态方法与模型同步更新

1 张卡片

章节作用:处理生成模型与手写业务逻辑之间的契约漂移,补足只靠 Java 方法签名无法发现的参数语义变化。

内容脉络:以 RotateLogic 的 verify、mutate 静态方法为例,说明模型修改或参数名变化可能使手写逻辑失配;生成代码核对方法、类型和名称,可在启动时运行;运行时读取参数名需在编译时保留名称,且示例允许类缺席。

# 静态方法与模型同步
## 风险
- 模型方法修改而手写逻辑未改
- 参数类型不变但名称和语义变化
## 检查
- 生成预期方法与参数清单
- 反射核对静态属性、类型和参数名
- 可在应用启动时执行
## 前提与边界
- Java 编译保留参数名
- 示例允许类缺席

相关卡片:手写静态逻辑须核对模型契约

  1. 手写静态逻辑须核对模型契约 理解等级:高级 普通读书笔记卡

123 11.1.7 不使用事件溯源

1 张卡片

章节作用:说明事件溯源可以按聚合关闭,展示生成物如何从事件与状态并存转为只保留状态相关代码。

内容脉络:JobLevel 聚合在 DDDML 中声明不使用事件溯源;工具不再生成 Event 类,仍生成命令、状态、应用服务、状态仓储与 DTO;部分 DTO 同时供 REST API 与 Java Client SDK 使用。

# 不使用事件溯源
## 聚合配置
- 单个聚合关闭事件溯源
## 服务端生成物
- 不生成 Event 类
- 保留命令与状态
- 保留应用服务与状态仓储
## 接口数据
- 命令和状态 DTO
- REST API 与客户端 SDK 使用

相关卡片:聚合可选择不生成事件溯源

  1. 聚合可选择不生成事件溯源 理解等级:中级 普通读书笔记卡

124 11.2 Override聚合对象的方法

2 张卡片

章节作用:用 Lead.Discard 示例展示实体方法的单聚合边界,以及在生成代码外补写业务逻辑的扩展方式。

内容脉络:先定义实体方法只改变一个聚合实例;再让生成聚合的未实现方法抛异常,由应用服务返回手写聚合扩展类,重写 Discard 并复用状态变更事件;最后说明命令 REST 入口与 C# partial class 的语言对照。

# Override 聚合方法
## 模型边界
- 实体方法只改一个聚合
- 跨聚合操作交给领域服务
## Java 扩展
- 生成未实现的聚合方法
- 应用服务返回扩展聚合
- 重写 Discard 并应用状态事件
## 对外与语言对照
- 命令可生成 REST 入口
- C# 可用 partial class

相关卡片:实体方法只改一个聚合、扩展生成聚合的重写路径、命令去重须与版本策略配套

  1. 实体方法只改一个聚合 理解等级:中级 普通读书笔记卡
  2. 扩展生成聚合的重写路径 理解等级:中级 结构图卡

125 11.3 处理继承

0 张卡片

章节作用:列出 DDDML 支持的三种继承映射策略,并说明主要差别体现在 ORM 映射,作为后三节的导读。

内容脉络:依次提出 TPCH、TPCC、TPS;Java 或 C# 实体代码可能接近,但数据库表与 Hibernate XML 映射不同。具体定义和例子由第126–128章展开。

# 处理继承
## 三种策略
- TPCH:继承树单表
- TPCC:子类分表
- TPS:子类补充表与判别列
## 差异落点
- ORM 持久化映射
- 生成的 Hibernate XML 示例

相关卡片:无(本章无合格知识卡)

126 11.3.1 TPCH

1 张卡片

章节作用:用 Product/ProductGroup 展示继承树共用根表及类型判别列。

内容脉络:产品组作为产品子类型,可复用产品关联的信息;DDDML 选择 tpch,Hibernate 把两种状态映射到 PRODUCT 表,以 PRODUCT_TYPE_ID 的不同值区分子类。

# TPCH
## 模型
- Product 根类型
- ProductGroup 子类型
## 映射
- PRODUCT 共用表
- PRODUCT_TYPE_ID 判别列
- 子类分别有判别值

相关卡片:TPCH以一张表映射继承树

  1. TPCH以一张表映射继承树 理解等级:中级 普通读书笔记卡

127 11.3.2 TPCC

1 张卡片

章节作用:用 Party 的多层继承展示 union-subclass 与多张子类型表。

内容脉络:Person、Organization 等类型构成 Party 继承树;生成的 HBM 使用嵌套 union-subclass,并为多个映射层级指定独立表,包括标为 abstract 的 InformalOrganization。

# TPCC
## Party 继承树
- Person
- Organization 与更深子类
## 映射
- union-subclass
- 不同层级指定各自表名
- 抽象子类的表名也需按映射核对

相关卡片:TPCC按子类分表映射

  1. TPCC按子类分表映射 理解等级:中级 普通读书笔记卡

128 11.3.3 TPS

1 张卡片

章节作用:用 Lead/InvestmentComment 展示根表加子类补充表、同时保留类型判别列的映射。

内容脉络:InvestmentComment 是 Lead 的子类型;根表 LEAD 保存公共属性和判别列,INVESTMENT_COMMENT 表保存专属属性,通过 LEAD_ID 与根表关联。

# TPS
## 根类型
- LEAD 表保存公共状态
- LEAD_TYPE_ID 判别子类
## 子类型
- INVESTMENT_COMMENT 补充表
- LEAD_ID 关联根表
- 专属字段保存在补充表

相关卡片:TPS用子类表补充根表

  1. TPS用子类表补充根表 理解等级:中级 普通读书笔记卡

129 11.4 处理模式

0 张卡片

章节作用:承接第9章对账目与状态机的建模,提示后两节改看代码生成工具如何使用模型中的模式信息。

内容脉络:本节仅点明 accounts 与 stateMachine 两个 DDDML 入口,没有新增定义或案例;具体代码生成机制进入第130–131章。

# 处理模式
## 已有模型定义
- accounts 账目
- stateMachine 状态机
## 后续问题
- 生成工具怎样利用模式信息

相关卡片:无(本章无合格知识卡)

130 11.4.1 处理账务模式

1 张卡片

章节作用:展示 InventoryItem 账目模式如何变成数据库表、命令限制、聚合计算和余额对账。

内容脉络:库存单元与分录分别建表,分录用来源唯一键避免重复且以子序列号允许反转;生成的普通命令不直接设置账目当前值,聚合从分录事件累加变化量;最后以余额等于分录合计的 SQL 约束核验结果。

# 处理账务模式
## 表结构
- InventoryItems 保存当前值
- InventoryItemEntries 保存变化量
- 来源键包含反转子序列号
## 命令与聚合
- 普通命令不能直接改余额
- 条目命令生成内部事件
- 聚合累加变化量
## 核验
- 余额等于分录合计
- SQL 查询异常行数应为零

相关卡片:库存账目映射到分录变化字段、来源事件唯一约束防止重复分录、用分录合计核对库存余额

  1. 用分录合计核对库存余额 理解等级:中级 普通读书笔记卡

131 11.4.2 处理状态机模式

1 张卡片

章节作用:把第9章的状态机定义落实到 InOut 命令与聚合的生成代码,展示如何禁止直接改状态并执行合法转换。

内容脉络:Create/MergePatch 命令不含 DocumentStatusId;聚合把 DocumentAction 包装成 PropertyCommand,提供当前状态读取和事件写入接口;处理器按源状态与触发值选择目标,未命中抛错。

# 处理状态机模式
## 输入限制
- 普通命令不直接带状态字段
- DocumentAction 作为触发值
## 聚合执行
- PropertyCommand 携带状态读取与事件写入
- Handler 匹配合法转换
## 结果
- 命中则写入目标状态事件
- 未命中抛出异常

相关卡片:状态字段只由转换处理器改写、状态机用转换约束单据状态

  1. 状态字段只由转换处理器改写 理解等级:中级 结构图卡

132 第12章 处理领域服务

2 张卡片

章节作用:从单聚合命令转向跨聚合领域服务,提出一致性模型与 Saga 实现的选择。

内容脉络:先界定服务方法协调多个聚合的职责,再对比单聚合本地事务、跨聚合优先最终一致和可妥协的强一致方案;最后介绍协作式、编制式 Saga 及 DDDML 对各自通信代码的支持。

# 处理领域服务
## 跨聚合职责
- 方法修改多个聚合实例
- 服务不自动保证一致性
## 一致性取舍
- 单聚合可用本地事务
- 跨聚合优先最终一致
- 经聚合分析可考虑本地强一致
## Saga 实现
- 协作式:领域事件发布订阅
- 编制式:消息命令与异步响应

相关卡片:跨聚合操作选择一致性模型、两类Saga对应不同代码支持、跨聚合行为宜由领域服务承担

  1. 跨聚合操作选择一致性模型 理解等级:高级 普通读书笔记卡
  2. 两类Saga对应不同代码支持 理解等级:中级 普通读书笔记卡

133 12.1 处理数据的一致性

2 张卡片

章节作用:具体解释跨聚合最终一致性带来的重试、隔离与补偿问题,并说明生成代码提供的基础保护。

内容脉络:先列业务事务的步骤失败与重试问题,再用库存调拨说明已提交步骤被其他业务叠加后为何不能恢复旧快照;最后介绍实体方法的基本幂等处理和命令方法的离线乐观锁。

# 处理数据的一致性
## 业务事务难题
- 步骤失败后的重试与幂等
- 步骤结果可见,缺少统一回滚与隔离
## 库存调拨示例
- 源货位先扣减
- 其他业务再次出库
- 目标增加失败后逆转本次增量
## 生成代码支撑
- 实体方法基本幂等
- 离线乐观锁检测并发冲突

相关卡片:补偿库存调拨应逆转增量、长事务须同时处理重试与并发、跨聚合操作选择一致性模型

  1. 补偿库存调拨应逆转增量 理解等级:高级 普通读书笔记卡
  2. 长事务须同时处理重试与并发 理解等级:中级 普通读书笔记卡

134 12.1.1 使用数据库事务实现一致性

1 张卡片

章节作用:说明在同库和资源约束下,跨聚合服务可暂用本地事务,并以 CRM 线索跟进服务展示生成接口。

内容脉络:先限定所有相关数据同库,再将本地事务作为可接受的强一致方案;生成的服务接口和 REST 入口承接请求,服务实现承担业务逻辑;最后提出缩短事务查询、按 ID 访问写模型仓储等建议。示例的 readOnly=true 注解与更新方法命名并列,实际写入语义待审查。

# 使用数据库事务实现一致性
## 适用条件
- 相关聚合数据同库
- 资源与期限使分库协调暂不合算
## 服务示例
- 生成接口与 REST 入口
- 实现类承载事务和业务逻辑
## 执行建议
- 参数提供所需信息
- 必要时按 ID 查写模型仓储
- 核验只读注解与写入行为

相关卡片:同库跨聚合可用本地事务、跨聚合操作选择一致性模型

  1. 同库跨聚合可用本地事务 理解等级:高级 普通读书笔记卡

135 12.1.2 使用Saga实现最终一致性

3 张卡片

章节作用:定义 Saga 的步骤与补偿,并比较协作式、编制式的控制流程和消息基础设施边界。

内容脉络:Saga 将多个独立提交的本地事务组成业务事务,后续失败由补偿处理;协作式以事件接力,编制式由 Saga Manager 指挥。异步消息可用于跨聚合、跨服务或跨应用协作,但内部消息代理应有清晰的限界上下文归属。

# 使用Saga实现最终一致性
## 业务事务
- 本地事务提交后触发下一步
- 失败时补偿已完成步骤
## 两种协调方式
- 协作式:事件接力,无中心指挥
- 编制式:Saga Manager 决定步骤
## 使用范围与边界
- 跨聚合、跨微服务、跨应用
- 内部消息代理归属单个上下文

相关卡片:Saga用本地事务与补偿、协作式靠事件编制式靠协调者、内部消息代理归属单个上下文

  1. Saga用本地事务与补偿 理解等级:中级 普通读书笔记卡
  2. 协作式靠事件编制式靠协调者 理解等级:中级 普通读书笔记卡
  3. 内部消息代理归属单个上下文 理解等级:高级 普通读书笔记卡

136 12.2 发布与处理领域事件

1 张卡片

章节作用:从 Saga 的一般说明过渡到领域事件发布和处理的生成代码示例,并区分事件与伪事件。

内容脉络:协作式 Saga 依靠各服务的事件接力;伪事件可能只是查询请求或响应,不表示状态改变。生成聚合已有事件溯源基础,本节随后将以 Eventuate Tram 展示事件发布处理代码。

# 发布与处理领域事件
## 协作式 Saga 的消息
- 领域事件:已发生的状态事实
- 伪事件:请求或响应
## 工具衔接
- 聚合已有事件溯源生成物
- 后续示例展示发布与处理

相关卡片:伪事件表达请求而非状态事实、协作式靠事件编制式靠协调者

  1. 伪事件表达请求而非状态事实 理解等级:初级 普通读书笔记卡

137 12.2.1 编写DDDML文档

1 张卡片

章节作用:用 StatusItem 聚合与测试消费服务,展示发布事件和声明事件处理器所需的 DDDML 入口。

内容脉络:ChangeCode 成功后产生 CodeChanged;聚合 metadata 开启 PublishingEventEnabled 才对外发布;消费服务用 domainEventHandler 指定聚合类型及事件类型。示例中只发布事件引用的配置处于注释状态。

# 编写DDDML文档
## 发布方 StatusItem
- ChangeCode 指定 CodeChanged
- PublishingEventEnabled 开启外发
## 消费方测试服务
- forAggregateType 指定聚合
- onEvent 指定事件
- 方法承担对应处理器角色

相关卡片:发布开关与处理器分别声明

  1. 发布开关与处理器分别声明 理解等级:中级 普通读书笔记卡

138 12.2.2 生成的事件发布代码

4 张卡片

章节作用:展开 DDDML 生成的领域事件发布、封包与消费代码,说明框架适配和模型映射的分层。

内容脉络:先定义发布接口及隔离 Eventuate 类型的封包,通用适配器负责转换并调用框架;模型专属的封包映射随 DDDML 变化重生。聚合应用服务在事件追加回调中保存状态并发布事件;消费者按事件类型分派,解包转成消费服务命令,业务逻辑仍须手写。

# 生成的事件发布代码
## 发布适配
- 通用 DomainEventPublisher 接口
- 完整事件或事件引用封包
- 框架适配与模型专属映射分层
## 聚合发布
- 追加事件
- 回调保存状态并发布
## 消费处理
- 按聚合与事件类型分派
- 解包转换成服务命令
- 应用服务实现业务逻辑

相关卡片:事件封包隔离消息框架、框架适配与模型映射分层生成、聚合事件持久化后进入发布回调、事件消费者转为应用服务命令

  1. 事件封包隔离消息框架 理解等级:中级 结构图卡
  2. 框架适配与模型映射分层生成 理解等级:中级 普通读书笔记卡
  3. 聚合事件持久化后进入发布回调 理解等级:中级 结构图卡
  4. 事件消费者转为应用服务命令 理解等级:中级 结构图卡

139 12.2.3 编写生产端聚合的业务逻辑

1 张卡片

章节作用:说明事件发布代码生成后,聚合方法仍需开发者实现具体状态规则。

内容脉络:StatusItem 的创建代码可由工具默认生成;ChangeCode 的 verify 与 mutate 留给开发者。示例中 verify 为空,只展示 mutate 保留旧状态类型、替换状态代码;发布事件由上一节的生成基础设施负责。

# 编写生产端聚合的业务逻辑
## 生成与手写边界
- 默认生成创建聚合的代码
- 手写 ChangeCode 业务逻辑
## 状态变更
- verify 预留校验入口,示例为空
- mutate 保留旧类型并更新状态代码
## 事件发布
- 不在业务逻辑中直接调用发布器

相关卡片:聚合变更逻辑无需处理事件发布、聚合事件持久化后进入发布回调

  1. 聚合变更逻辑无需处理事件发布 理解等级:中级 普通读书笔记卡

140 12.2.4 实现消费端领域事件的处理

0 张卡片

章节作用:补齐消费端应用服务的手写实现示例,说明第138章生成的事件消费者最终把命令交给哪里。

内容脉络:测试服务实现两个 when 方法,分别接收 CodeChanged 和 StatusItemStateCreated 转换出的命令;示例只打印新代码和状态 ID,未给出新的业务处理规则。

# 实现消费端领域事件的处理
## 两个命令处理器
- HelloChangeCode:读取新代码
- HelloStatusItemStateCreated:读取状态 ID
## 示例边界
- 只打印字段
- 真实业务逻辑仍需手写

相关卡片:无(本章无合格知识卡)

141 12.3 支持基于编制的Saga

1 张卡片

章节作用:以库存单元与入库/出库单的跨聚合调整,展示编制式 Saga 的业务步骤和补偿分支。

内容脉络:查询库存后计算目标差值,创建一行单据,再添加库存条目;库存更新成功则完成单据,失败则取消单据作为创建单据的补偿。DDDML 工具可为这些实体方法生成消息命令调用代码,业务步骤仍需设计。

# 支持基于编制的Saga
## 查询与准备
- 查询当前库存
- 计算目标与当前差值
## 跨聚合更新
- 创建一行入库出库单
- 添加库存条目改变余额
## 结果分支
- 成功:完成单据
- 失败:取消单据作为补偿

相关卡片:库存Saga以单据状态补偿、两类Saga对应不同代码支持

  1. 库存Saga以单据状态补偿 理解等级:高级 结构图卡

142 12.3.1 编写DDDML文档

2 张卡片

章节作用:把库存调整 Saga 的查询、分录更新和单据补偿步骤映射为 DDDML 方法与元数据。

内容脉络:库存聚合的非实例入口协调流程,Get 查询开启异步消息命令,添加分录间接改变余额;InOut 聚合提供创建单行单据、完成和取消三个内部方法,取消方法标记补偿角色且内部方法不向 REST 客户端开放。

# 编写DDDML文档
## InventoryItem
- 非实例入口协调跨聚合操作
- Get 开启异步消息命令
- 添加库存条目更新余额
## InOut
- 创建单行单据
- 完成或取消状态
- 内部方法不暴露 REST
- 取消方法标记补偿

相关卡片:异步Saga查询须开启消息命令、内部Saga步骤不对外暴露、库存Saga以单据状态补偿

  1. 异步Saga查询须开启消息命令 理解等级:中级 普通读书笔记卡
  2. 内部Saga步骤不对外暴露 理解等级:中级 普通读书笔记卡

143 12.3.2 生成的Saga命令处理代码

3 张卡片

章节作用:展示 DDDML 如何把领域命令接入 Eventuate Tram Saga 的消息请求与异步响应,同时让消息框架依赖停留在适配层。

内容脉络:先用实现框架接口的封包类隔离原聚合命令;再为库存与入库出库单生成按通道和封包类型分派的处理器,拆出命令交给应用服务;最后在 Spring Boot 配置中注册处理器及分发器。查询回复需把状态转为 DTO;示例中 InternalVoid 的异常重抛与其他方法的失败回复不同,留待审查。

# 生成的Saga命令处理代码
## 命令封包
- 实现框架 Command 接口
- 聚合命令保持框架无关
## 命令处理器
- 通道与封包类型绑定方法
- 转交应用服务并异步回复
- 查询状态转换为 DTO
## Spring Boot 配置
- 注册两类处理器
- 创建对应命令分发器

相关卡片:命令封包隔离消息框架、Saga处理器只负责消息适配、命令分发器须注册处理器

  1. 命令封包隔离消息框架 理解等级:中级 结构图卡
  2. Saga处理器只负责消息适配 理解等级:中级 结构图卡
  3. 命令分发器须注册处理器 理解等级:中级 普通读书笔记卡

144 12.3.3 需要我们编写的Saga代码

3 张卡片

章节作用:接续生成的消息适配层,展示开发者仍须编写的 Saga 步骤、跨步数据和应用服务入口,并提出框架耦合的改进方向。

内容脉络:手写的 Fluent DSL 按查询库存、创建单据、添加库存条目、完成单据的顺序编制步骤,并将取消单据绑定为创建步骤的补偿;Saga Data 保存原命令、库存差量与查询版本,更新步骤将版本写入 AddInventoryItemEntry,作为作者设想的并发检查输入。下一节的手写处理器只按版本是否为空分流,未展示向新 DTO 传递版本,故不能断言检查已贯通。应用服务用 SagaManager 创建并持久化实例。最后区分可重生成的框架适配代码与直接依赖 Eventuate Tram 的手写 Saga,提出自有抽象和 DDDML 声明的设想,但本书未实现。

# 需要我们编写的Saga代码
## Saga定义
- 查询与差量计算
- 建单并绑定取消补偿
- 更新库存后完成单据
## 跨步数据
- 保存原命令与差量
- 保存查询版本并传入后续命令
- 新 DTO 未展示版本传递
## 执行入口
- 应用服务创建 Saga Data
- 管理器持久化并执行实例
## 改进方向
- 自有抽象隔离框架
- 在 DDDML 声明业务步骤

相关卡片:库存Saga以单据状态补偿、Saga数据保存跨步版本、Saga管理器持久化执行实例、手写Saga定义暴露框架依赖

  1. Saga数据保存跨步版本 理解等级:中级 普通读书笔记卡
  2. Saga管理器持久化执行实例 理解等级:中级 普通读书笔记卡
  3. 手写Saga定义暴露框架依赖 理解等级:高级 普通读书笔记卡

145 12.3.4 需要我们实现的实体方法

5 张卡片

章节作用:展示生成的领域骨架仍需填入哪些库存与单据业务规则,以及 Saga 步骤如何落到实体方法。

内容脉络:添加库存条目时依据版本是否为空选择创建或补丁;展示代码未把版本赋给新 DTO,不能以此证明并发检查生效。已有库存先检查预计余额不能为负,再为新分录分配小于现有负序号的序号。创建入库/出库单时以单据状态事件和一条行事件组装草稿单据。完成或取消则调用生成基类的 documentAction,由状态机执行转换。补偿动作以外的大部分实体规则,即使不采用最终一致性方案也需要实现。

# 需要我们实现的实体方法
## 库存条目
- 版本为空走创建
- 已有库存走补丁
- 新 DTO 未展示版本传递
- 拒绝负余额
- 新分录取更小负序号
## 入库出库单
- 单据与单行事件创建草稿
- 完成与取消调用状态机动作
## 实现边界
- 复用生成骨架
- 补偿以外的实体规则仍需手写

相关卡片:库存版本决定创建或补丁、负库存检查先于分录追加、分录序号向负方向分配、单行单据由创建事件组装、单据状态动作复用生成状态机

  1. 库存版本决定创建或补丁 理解等级:中级 普通读书笔记卡
  2. 负库存检查先于分录追加 理解等级:中级 普通读书笔记卡
  3. 分录序号向负方向分配 理解等级:中级 普通读书笔记卡
  4. 单据状态动作复用生成状态机 理解等级:中级 普通读书笔记卡
  5. 单行单据由创建事件组装 理解等级:中级 结构图卡

146 第13章 RESTful

0 张卡片

章节作用:从前几章的服务端领域代码过渡到面向远程客户端的 API 与客户端 SDK。

内容脉络:指出领域层业务逻辑需要远程调用入口,介绍本章将展示基于 DDDML 的 RESTful API 服务端生成代码和 Client SDK 使用示例;REST 架构风格仅被提及,具体设计从后续小节展开。

# 第13章 RESTful 导读
## 远程使用领域逻辑
- 需要应用程序接口
## 本章内容
- RESTful API 服务端生成
- Client SDK 使用示例

相关卡片:无(本章无合格知识卡)

147 13.1 RESTful

1 张卡片

章节作用:为后续 API 生成实践先澄清 HTTP 方法的基本操作语义,不把 HTTP+JSON 直接等同于严格 REST。

内容脉络:按 GET、PUT、PATCH、DELETE、POST 区分读取、整体替换、局部更新、删除和提交处理;指出 GET 安全、PUT 与 DELETE 应幂等。

# RESTful API 的方法语义
## 读取
- GET 安全
## 修改
- PUT 整体替换且应幂等
- PATCH 局部更新
- DELETE 应幂等
- POST 提交处理

相关卡片:HTTP方法承载不同操作语义

  1. HTTP方法承载不同操作语义 理解等级:初级 普通读书笔记卡

148 13.1.1 没有必要绞尽脑汁地寻找名词

1 张卡片

章节作用:说明将 DDD 的聚合方法与领域服务映射成 HTTP API 时,对严格资源名设计作务实取舍。

内容脉络:以 GitHub 星标的资源式 URI 为对照,指出不必为每个领域动作强凑资源名;实体命令可用带 _commands 的路径,并凭生成器的幂等处理选 PUT;领域服务示例用 POST。路径中保留动词意味着部分混搭 RPC 风格,须明确实际方法语义。

# 领域命令的 HTTP 映射
## 资源式表达
- 星标可建模为资源
## 命令式表达
- 聚合方法放在命令路径
- 实体命令示例用 PUT
- 领域服务示例用 POST
## 取舍
- 不为纯粹名词化牺牲领域语义

相关卡片:领域命令不必强凑资源名

  1. 领域命令不必强凑资源名 理解等级:高级 普通读书笔记卡

149 13.1.2 尽可能使用HTTP作为封包

2 张卡片

章节作用:用反例说明重复 JSON 封包与误用 GET 会遮蔽 HTTP 已提供的结果与方法语义。

内容脉络:先反对统一返回 200 或 500 再在响应体内设自定义状态;以商品查询的双层 result 和订单列表分页封包不一致说明多余包装的代价;最后举 GET 调用商品更新的反例,强调读取方法不应产生状态变更。

# 尽可能使用HTTP作为封包
## 结果表达
- HTTP 状态优先
- 避免重复状态与结果封包
## 接口一致性
- 分页包装按实际需求判断
## 方法语义
- GET 不应修改商品

相关卡片:勿用业务封包掩盖HTTP状态、GET查询不应执行状态更新

  1. 勿用业务封包掩盖HTTP状态 理解等级:高级 普通读书笔记卡
  2. GET查询不应执行状态更新 理解等级:初级 普通读书笔记卡

150 13.1.3 异常处理

1 张卡片

章节作用:把领域层和基础设施层的不同失败原因映射到可区分的 HTTP 响应。

内容脉络:正常路径返回业务对象,异常路径尽量复用服务框架的可扩展处理;领域规则拒绝请求可映射 4xx,原样重试通常无益;技术设施异常可映射 5xx,服务端状态可能未知,重试前还须核对幂等与部分执行情况。

# 异常处理
## 正常路径
- 返回业务对象
## 异常路径
- 框架统一处理
- 领域错误映射 4xx
- 技术异常映射 5xx
## 重试判断
- 4xx 先修正请求
- 5xx 核对执行状态

相关卡片:异常类别映射HTTP状态

  1. 异常类别映射HTTP状态 理解等级:中级 普通读书笔记卡

151 13.2 聚合的RESTful

1 张卡片

章节作用:引入按 DDDML 聚合定义生成的 RESTful 服务端入口,并界定 JAX-RS 与 Spring MVC 两种生成目标。

内容脉络:书中的 Java 示例使用 javax.ws.rs 注解,可交给支持 JAX-RS 的 Apache CXF;同一工具也支持生成 Spring MVC 版本。后续小节再以 Car 聚合展示具体接口,因此本节只说明框架适配入口。

# 聚合的 RESTful API
## DDDML 聚合定义
- Car 示例作为生成输入
## 服务端目标
- JAX-RS 注解与 CXF
- Spring MVC 版本
## 后续内容
- 逐项展示生成接口

相关卡片:DDDML生成多种HTTP入口

  1. DDDML生成多种HTTP入口 理解等级:中级 普通读书笔记卡

152 13.2.1 GET

4 张卡片

章节作用:展示 DDDML 生成的 GET 查询端点怎样读取聚合、内部实体和派生集合。

内容脉络:Car 列表支持排序、字段选择、分页范围和两种条件输入,另有 _page 封包与 _count 计数。单项读取使用 Car ID;车轮读取在 Car 路径下继续定位。Package 示例把派生根部件与子部件集合分别暴露为 GET 路径。复杂 ICriterion 示例构造了 filter = Or(...),实际却返回 conjunctionAll;示例 JSON 也对应后者,不能照抄为包含外层 Or 的查询。

# 聚合的 GET 接口
## Car 列表
- 简单查询参数或 JSON Criterion 过滤
- 排序、字段选择和范围
- _page 返回 number、size、totalElements、content
- _count 返回匹配数
## Car 单项及内部实体
- /Cars/{id}
- /Cars/{id}/Wheels
- /Cars/{id}/Wheels/{wheelId}
## Package 派生集合
- /Packages/{id}/RootPackageParts
- /Packages/{id}/PackageParts/{partId}/ChildPackageParts

相关卡片:聚合列表查询条件、分页封包字段、聚合内实体读取路径、派生集合的读取接口

  1. 聚合列表查询条件 理解等级:中级 普通读书笔记卡
  2. 分页封包字段 理解等级:初级 普通读书笔记卡
  3. 聚合内实体读取路径 理解等级:中级 普通读书笔记卡
  4. 派生集合的读取接口 理解等级:中级 普通读书笔记卡

153 13.2.2 PUT

2 张卡片

章节作用:展示聚合创建和命令调用的 PUT 接口,以及路径 ID 与聚合 ID 的一致性处理。

内容脉络:创建 Car 使用 PUT /Cars/{id} 并将创建 DTO 作为命令交给应用服务。Rotate 使用 PUT /Cars/{id}/_commands/Rotate,请求体 ID 为空时补上路径 ID,冲突则报错。修改命令默认需 Command ID 和版本号;DDDML 可配置忽略并发冲突,此时客户端可不提供版本号。

# 聚合的 PUT 接口
## 创建 Car
- /Cars/{id}
- CreateCarDto 转为创建命令
- 核对路径 ID 与聚合 ID
## 调用 Rotate
- /Cars/{id}/_commands/Rotate
- 补填或校验聚合 ID 与路径 ID
## 并发元数据
- 默认 Command ID 与聚合根版本号
- IgnoringConcurrencyConflict 免除版本号

相关卡片:PUT命令校验路径ID、命令版本控制并发

  1. PUT命令校验路径ID 理解等级:中级 普通读书笔记卡
  2. 命令版本控制并发 理解等级:中级 普通读书笔记卡

154 13.2.3 PATCH

2 张卡片

章节作用:说明生成的聚合 PATCH 命令接口与 JSON Merge Patch 规范的区别,并提出静态 DTO 承载删除语义的方案。

内容脉络:PATCH /Cars/{id} 校验路径与命令 ID 后执行 MergePatchCar;名字虽含 MergePatch,原实现并不支持 JSON Merge Patch。作者提出让静态 DTO 的 setter 在收到 null 时记录删除标记,并让 JSON 反序列化保留 null,作为真正支持该语义的实现思路。

# Car 的 PATCH
## 已生成接口
- /Cars/{id}
- MergePatchCar 命令
- 不支持 JSON Merge Patch 规范
## 支持规范的思路
- 静态 DTO 接收 JSON
- null 触发删除标记
- 反序列化保留 null
- 应用服务执行命令

相关卡片:PATCH不等于合并补丁、静态DTO标记字段删除

  1. PATCH不等于合并补丁 理解等级:中级 普通读书笔记卡
  2. 静态DTO标记字段删除 理解等级:高级 普通读书笔记卡

155 13.2.4 DELETE

1 张卡片

章节作用:说明删除聚合时命令元数据经查询参数传递的接口约定。

内容脉络:客户端以 DELETE /Cars/{id} 指向 Car,查询参数提供必填 commandId、version 与可选 requesterId。服务端构造 DeleteCar 命令、核对路径 ID,再交给应用服务。作者选择查询参数,是为了让 DELETE 请求不依赖消息体。

# 删除 Car
## 请求
- DELETE /Cars/{id}
- commandId、version 必填
- requesterId 可选
## 服务端
- 构造 DeleteCar 命令
- 核对路径 ID
- 应用服务执行

相关卡片:删除命令元数据传参

  1. 删除命令元数据传参 理解等级:中级 普通读书笔记卡

156 13.2.5 POST

1 张卡片

章节作用:说明 DDDML 对 POST 创建聚合的两种可选生成模式。

内容脉络:默认没有 POST 创建接口。聚合级配置可允许客户端不提供 Car ID,服务端需实现 ID 生成,并在创建后返回 ID 与 201 状态。限界上下文级配置则为所有聚合生成 POST 创建接口,但请求体仍需提供 ID,逻辑与 PUT 创建相同。书中无 ID 创建示例确实调用 termApplicationService.createWithoutId(cmd),与 Car 应用服务命名不一致;本书没有展示该调用可运行,不能直接照抄。

# POST 创建聚合
## 默认
- 不生成 POST 创建接口
## 聚合级无 ID 模式
- CreationWithoutIdEnabled
- HttpPostCreationEnabled
- 服务端生成 ID,返回 201
## 限界上下文级带 ID 模式
- HttpPostCreationWithIdEnabled
- 请求体仍提供 ID
- 逻辑同 PUT 创建

相关卡片:POST创建两种ID模式

  1. POST创建两种ID模式 理解等级:中级 普通读书笔记卡

157 13.2.6 事件溯源API

1 张卡片

章节作用:展示事件溯源聚合的事件和历史状态按版本读取的 URL。

内容脉络:Product 创建事件在 Events/-1,创建后的首版状态在 _historyStates/0;从版本 0 状态出发的变更事件在 Events/0,第二版状态在 _historyStates/1。这组示例说明事件版本与历史状态版本如何衔接。

# Product 事件溯源查询
## 创建
- Events/-1:创建事件
- _historyStates/0:第一版状态
## 后续变更
- Events/0:版本 0 状态下的变更事件
- _historyStates/1:第二版状态

相关卡片:事件与历史状态版本

  1. 事件与历史状态版本 理解等级:中级 普通读书笔记卡

158 13.2.7 树的查询接口

1 张卡片

章节作用:说明 DDDML 树结构在 RESTful API 中的根结点与子结点查询方式。

内容脉络:LocatorTrees 集合路径取得根货位,加入 parentId 取得指定父货位下的子货位;OrganizationTrees 还能用 id.organizationStructureTypeId 筛选特定组织树的根结点。

# 树的 GET 查询
## LocatorTree
- /LocatorTrees:根结点
- ?parentId=...:指定父结点的孩子
## OrganizationTree
- ?id.organizationStructureTypeId=...
- 按结构类型筛选根结点

相关卡片:树节点查询以父级过滤

  1. 树节点查询以父级过滤 理解等级:中级 普通读书笔记卡

159 13.3 服务的RESTful

1 张卡片

章节作用:说明 DDDML 服务方法如何生成 HTTP 入口,以及默认选择 POST 的原因。

内容脉络:CRM 的 LeadFollowupService.UpdateAfterFollowup 被生成成 Spring MVC 控制器的 POST 方法,请求体命令交给应用服务。生成器默认不确认服务方法的幂等性,因此采用 POST。

# 服务方法的 RESTful 入口
## DDDML 服务方法
- LeadFollowupService.UpdateAfterFollowup
## 生成控制器
- POST /LeadFollowupService/UpdateAfterFollowup
- 请求体转换为命令
- 应用服务 when 执行
## 方法选择
- 幂等性未确认
- 默认 POST

相关卡片:服务方法默认用POST

  1. 服务方法默认用POST 理解等级:中级 普通读书笔记卡

160 13.4 身份与访问管理

2 张卡片

章节作用:划清身份声明与访问决策的职责,并给后续令牌机制设定讨论前提。

内容脉络:IM 核实客户端代表谁、用户具有什么属性,产出 Claims;AM 决定持有这些声明的客户端能做什么。书中后续以 OAuth 2.0 Bearer Token 加 JWT 为假设:授权服务器签发令牌,资源服务器验证可信性并依据 Claims 作决策。ASP.NET 框架的历史评价只作背景,不作为结论。

# IAM 职责
## 身份管理 IM
- 认证客户端与用户关系
- 产出 Claims
## 访问管理 AM
- 将 Claims 用于权限判断
## 书中假设的令牌流程
- 授权服务器签发
- 客户端携带令牌
- 资源服务器验证并决策

相关卡片:身份声明与访问决策分离、令牌验证后做授权决策

  1. 身份声明与访问决策分离 理解等级:中级 普通读书笔记卡
  2. 令牌验证后做授权决策 理解等级:中级 结构图卡

161 13.4.1 获取OAuth

2 张卡片

章节作用:展示书中获取 Bearer Token 的客户端调用,并区分 JWT 的注册与私有 Claims。

内容脉络:示例以 Form URL Encoded 的 password grant 请求授权服务器,成功后读取 access_token。Bearer Token 对客户端应是不依赖内部结构的字符串,服务器可能使用 JWT。书中 JWT 样本含 sub、exp、iss、aud 四个注册名称,以及 role、user_groups 两个私有名称。这是书中的历史调用示例,不能据此推定其适合新系统。

# 获取 Bearer Token
## 客户端请求
- POST oauth2/token
- Form URL Encoded
- grant_type=password 等字段
## 返回
- access_token
- 客户端视作令牌字符串
## JWT 示例
- 注册 Claims:sub、exp、iss、aud
- 私有 Claims:role、user_groups

相关卡片:Bearer令牌获取示例、JWT声明分标准与私有

  1. Bearer令牌获取示例 理解等级:中级 普通读书笔记卡
  2. JWT声明分标准与私有 理解等级:中级 普通读书笔记卡

162 13.4.2 在资源服务器上处理授权

2 张卡片

章节作用:说明 DDDML 授权声明到资源入口的生成,以及需资源属性参与时的手写授权。

内容脉络:Locator.Create 声明角色或权限要求,生成端可映射为 ASP.NET 的 Authorize 或 Spring Security 的 PreAuthorize。两种示例都让 SystemAdministrator 与 LocatorManagement 进入可接受的 Authority/Role 集。若只允许仓库管理员创建本仓库货位,还需比较 JWT 的 user_groups 与请求 warehouseId。原文示例以字符串 contains 比对,遇到相似 ID 可能误匹配;实际授权应比较解析后的完整仓库 ID。

# 资源服务器授权
## 静态方法声明
- requiredAnyRole
- requiredAnyPermission
- 生成 Authorize 或 PreAuthorize
## 资源属性授权
- 读取 JWT user_groups
- 对照请求 warehouseId
- 不符时拒绝

相关卡片:权限声明映射资源入口、资源属性须参与授权

  1. 权限声明映射资源入口 理解等级:中级 普通读书笔记卡
  2. 资源属性须参与授权 理解等级:高级 普通读书笔记卡

163 13.5 生成Client

1 张卡片

章节作用:说明服务端生成的静态 DTO 契约如何支撑多语言 Client SDK。

内容脉络:工具能生成 Java/C# 服务端 RESTful API 与多语言客户端 SDK。服务端输入和返回一般用 DTO 静态类型,状态、命令、事件等类型也进入静态语言 SDK,让调用方在 IDE 和编译期使用明确契约。后续小节再展开具体调用。

# Client SDK 的类型基础
## DDDML 模型
- 状态对象
- 命令对象
- 事件对象
## 服务端 RESTful API
- 输入 DTO
- 返回 DTO
## 客户端 SDK
- 生成静态类型
- 支持 Java、C# 等调用方

相关卡片:客户端SDK复用DTO契约

  1. 客户端SDK复用DTO契约 理解等级:中级 普通读书笔记卡

164 13.5.1 创建聚合实例

1 张卡片

章节作用:用 Client SDK 的静态 DTO 演示嵌套聚合创建命令的组装与提交。

内容脉络:CreatePersonDto 聚合两个年度计划,2020 年计划再包含月度计划,并设置请求者与命令 ID。普通 JSON 序列化把嵌套 DTO 转为命令树,随后作为 PUT /People/Yang,Jiefeng,1 的请求体创建 Person。

# 创建 Person 聚合
## CreatePersonDto
- 基本属性
- RequesterId、CommandId
## 嵌套命令
- CreateYearPlanDto 2020/2021
- 2020 下含 CreateMonthPlanDto
## 发送
- 序列化为 JSON
- PUT /People/Yang,Jiefeng,1

相关卡片:嵌套创建命令序列化

  1. 嵌套创建命令序列化 理解等级:中级 普通读书笔记卡

165 13.5.2 更新聚合实例

1 张卡片

章节作用:展示 Client SDK 如何把嵌套创建与更新动作合成一次聚合 PATCH 命令。

内容脉络:Person 根命令更新生日并携带版本、命令 ID、请求者;2020 年计划更新状态并标记删除描述字段;月计划数组一项为 MergePatch、一项为 Create。序列化后提交到 Person 的 PATCH 路径。示例文字称新建二月计划,但代码未给 Month 赋值,展示的 JSON 中为 0;不能把该请求当作已正确创建二月计划的证据。

# 更新 Person 聚合
## 根命令 MergePatchPersonDto
- BirthDate
- Version、CommandId、RequesterId
## 2020 年计划 MergePatch
- Active
- 删除 Description 标记
## 月计划数组
- 既有月计划 MergePatch
- 新月计划 Create
## 发送
- PATCH /People/Yang,Jiefeng,1

相关卡片:嵌套更新混合命令

  1. 嵌套更新混合命令 理解等级:中级 普通读书笔记卡

166 13.5.3 使用Retrofit2

1 张卡片

章节作用:说明 DDDML 生成的 Java 静态类型如何进一步构成 Retrofit2 客户端接口。

内容脉络:CarsClient 用 @GET、@PUT、@PATCH、@DELETE 描述 Car 的查询和更新,@Path 定位资源,@Query 传过滤/命令参数,@Body 传命令 DTO。示例若干写操作的返回类型为 Call<String>,前文服务端方法却声明 void;书中未提供端到端响应体证据,不能据签名推定实际返回字符串。

# CarsClient
## GET
- getAll、getWheel
- 静态状态 DTO
## 写操作
- put、patch、delete、rotate
- @Body 命令 DTO
- @Query 命令元数据
## 地址绑定
- @Path 聚合及内部实体 ID

相关卡片:Retrofit映射聚合API

  1. Retrofit映射聚合API 理解等级:中级 普通读书笔记卡

167 第14章 直达UI

0 张卡片

章节作用:提出从 DDDML 的领域模型描述推导默认 Admin UI 的问题,为后续生成路径铺垫。

内容脉络:传统元数据框架的管理界面有重复的列表、详情和菜单布局,仍需大量 UI 编码。作者设想利用 DDDML 对领域核心概念的表达,生成基本可用的默认 Admin UI;此处未描述生成规则,具体路线见后续章节。

# 直达 UI 的问题
## 重复劳动
- 菜单、列表、详情
- 传统元数据框架仍需 UI 编码
## 设想
- DDDML 已描述领域核心
- 推导默认 Admin UI
## 待后文验证
- 能生成到什么程度

相关卡片:无(本章无合格知识卡)

168 14.1 两条路线的斗争

0 张卡片

章节作用:列出从 DDDML 领域模型和从 RESTful 服务描述开发 Admin UI 的两种入口,后文分别展开。

内容脉络:第一条路线要求前端理解 DDDML 描述的领域模型;第二条路线只让前端依赖服务 API,其他 UI/UE 信息另取。作者团队对前一路线做过 Vue.js 试验但未投产,对后一路线做过 Angular 生产应用。这里是案例背景,尚未提供可比较的生成规则或通用结论。

# Admin UI 开发入口
## 领域模型路线
- 前端理解 DDDML
- 团队试验未投产
## 服务描述路线
- 前端理解 RESTful API
- 其他 UI/UE 信息另取
- 团队曾用于生产
## 待后文展开
- 两条路线的实现方式

相关卡片:无(本章无合格知识卡)

169 14.1.1 前端“知道”领域模型

2 张卡片

章节作用:给出前端直接读取领域模型的元数据分层,以及生成 JSON/DDDML 的具体映射路径。

内容脉络:JSON/DDDML 与 YAML/DDDML 保持结构和 Schema 一致;另设 UI 层元数据描述界面元素与领域对象之间的关系。生成前端文档时,工具先解析 DDDML DOM,再剪裁字段、映射为字典并序列化。DictionaryMapper 示例展示字段大小写转换、级联集合和深层属性裁剪。

# 前端知道领域模型
## 领域模型元数据
- YAML/DDDML → JSON/DDDML
- 结构与 Schema 一致
## UI 层元数据
- 领域对象与界面元素映射
- 标签可不同于 name/description
## 输出流程
- 解析 DDDML DOM
- 剪裁并映射字典
- JSON 序列化

相关卡片:领域模型与UI元数据分层、DDDML前端映射流程

  1. 领域模型与UI元数据分层 理解等级:中级 结构图卡
  2. DDDML前端映射流程 理解等级:中级 普通读书笔记卡

170 14.1.2 前端“只知道”RESTful

1 张卡片

章节作用:说明只依赖 RESTful 服务描述时,如何从路径惯例推断局部领域结构及其适用边界。

内容脉络:OrderHeaders/{orderId}/OrderItems 及单项路径暗示聚合根与内部实体的关联,可用于默认生成订单详情页中的行项列表。该推断依赖项目遵守资源路径惯例,仍需核对模型。服务描述路线可覆盖没有 DDDML 的团队,或 DDDML 未建模的查询侧;界面体验信息需另外提供。

# 从 API 服务描述生成界面
## 输入
- RESTful 路径与服务描述
## 推断
- OrderHeader 聚合根
- OrderItem 内部实体
## 输出
- 订单详情与行项列表
## 边界
- 依赖路径惯例
- 模型关系需核对
- UI/UE 信息另取

相关卡片:从API路径推断聚合

  1. 从API路径推断聚合 理解等级:中级 普通读书笔记卡

171 14.2 生成Admin

1 张卡片

章节作用:给出 DDDML 领域元数据到 Admin UI 默认控件的四类映射。

内容脉络:枚举集合可选多选框,LocatorTree 可呈现树层级,实体命令方法可生成按钮和参数录入界面,referenceType 可用实体列表选择器。图 14-1 展示树列表与结点详情。具体的引用过滤、属性约束和 UI 层补充元数据由后文继续说明。

# DDDML → Admin UI
## 属性
- 枚举集合:多选框
- referenceType:实体选择列表
## 结构
- LocatorTree:树与结点详情
## 行为
- 命令方法:按钮与参数表单

相关卡片:DDDML元数据映射界面

  1. DDDML元数据映射界面 理解等级:中级 结构图卡

172 14.2.1 使用referenceFilter

1 张卡片

章节作用:将 DDDML 引用属性的过滤规则连接到 Admin UI 的实体选择列表。

内容脉络:Locator.WarehouseId 引用 Warehouse 并声明 active eq true。前端读取 JSON/DDDML 的过滤条件,编码为 /Warehouses?filter=... 查询,意图是展示已启用仓库供选择。书中的布尔值在请求示例变为字符串,未展示后端类型转换,不能将过滤结果视为已验证。

# referenceFilter
## 领域属性
- WarehouseId → Warehouse
- active eq true
## 前端查询
- Criterion 编码为 filter
- GET /Warehouses
## 用户界面
- 已启用仓库列表
- 选择实例代替手输 ID

相关卡片:引用过滤生成选择列表

  1. 引用过滤生成选择列表 理解等级:中级 普通读书笔记卡

173 14.2.2 展示派生的实体集合属性

1 张卡片

章节作用:展示派生集合如何同时表达领域概念与驱动 Admin UI 分组。

内容脉络:会议记录既有全部讨论事项,又有定义为 Open 或 On Hold 的未决事项派生集合。详情页可分别以两个 Tab 显示原集合和派生集合。示例中的 # isDerived: ture 是注释,Java 字符串 == 比较可能不按文本值判断;因此界面分组是设计意图,代码片段并非已验证实现。

# 会议记录详情
## DiscussionDetails
- 全部讨论事项
## PendingDiscussionDetails
- Open 或 On Hold
- 派生集合
## Admin UI
- 两个 Tab 分组呈现

相关卡片:派生集合驱动界面分组

  1. 派生集合驱动界面分组 理解等级:中级 普通读书笔记卡

174 14.2.3 使用属性层面的约束

1 张卡片

章节作用:说明 Admin UI 从领域模型元数据读取属性约束,形成输入时的即时校验。

内容脉络:email 引用 Email 约束;locatorId 引用 numericDashAlphabetic,后者的正则在限界上下文配置里定义。前端依据约束名执行校验并提示用户。示例正则没有结尾锚点,若采用前缀匹配就不能保证完整值有效,实际校验须明确匹配方式。

# 前端属性校验
## JSON/DDDML 属性
- email → Email
- locatorId → numericDashAlphabetic
## 配置
- namedStringPatterns 查规则
## Admin UI
- 输入时执行规则
- 立即提示用户

相关卡片:属性约束驱动前端校验

  1. 属性约束驱动前端校验 理解等级:中级 普通读书笔记卡

175 14.2.4 使用UI层元数据

1 张卡片

章节作用:说明默认控件不足时,UI 层元数据如何指定组件与显示细节。

内容脉络:LocalDateTime 可选文本框或日期时间选择器。Term.Tags 的关联实体集合默认可用 Tab 表格,也可用标签组件;后一方案需声明 TermTag.SequenceNumber 作为排序依据、被引用 Tag.Name 作为标签文本。图 14-2 已核对,展示标签项及新增入口。

# UI 层元数据
## 控件选择
- 日期时间:文本或选择器
- 关联实体集合:表格或标签
## 标签细节
- 顺序:TermTag.SequenceNumber
- 文本:Tag.Name

相关卡片:UI元数据指定控件映射

  1. UI元数据指定控件映射 理解等级:中级 普通读书笔记卡

176 14.2.5 构建更实时的应用

1 张卡片

章节作用:提出命令后获取真实服务端状态与其他客户端变更推送的改进方向,明确属于作者未完成的设想。

内容脉络:现有生成 API 命令成功后不返回实体状态,需要额外 GET。作者设想同步响应返回 ID 和最新状态,或 202 Accepted 后异步处理并推送;对于其他客户端造成的状态变更,前端可直接覆盖或请求用户确认。具体生成实现未展示。

# 客户端状态同步设想
## 命令后
- 现状:再次 GET
- 同步:响应带 ID 与状态
- 异步:202 后推送
## 其他客户端变更
- 推送最新状态
- 直接覆盖或先确认

相关卡片:命令后同步客户端状态

  1. 命令后同步客户端状态 理解等级:中级 普通读书笔记卡

177 第15章 找回敏捷的软件设计

1 张卡片

章节作用:讨论复杂领域中设计与编码的节奏,避免仓促实现和无限分析。

内容脉络:需求分析、领域建模和产品定义属于编码前的软件设计,开发人员应参与。只靠流程图和 UI 原型仓促开工会留下领域理解缺口;重度设计若迟迟不收敛也可能分析瘫痪。作者主张根据领域理解和反馈调整节奏,核心是形成反映领域认知的模型。具体重构边界由下节展开。

# 复杂领域的设计节奏
## 过早编码
- 模型理解不足
- 开发中返工
## 过度设计
- 分析瘫痪
- 可用有限编码试探
## 目标
- 开发人员参与设计
- 形成领域模型

相关卡片:复杂领域的设计节奏

  1. 复杂领域的设计节奏 理解等级:中级 普通读书笔记卡

178 15.1 重构不是万能灵药

2 张卡片

章节作用:限定重构的条件,并澄清“代码即文档”仍要承担设计和沟通工作。

内容脉络:运行系统缺少重写资源时,可先用自动化测试保护外部行为,再小步重构;若深层设计缺口没有被识别,局部修改不足以形成领域模型。BDD 实例化需求可让部分设计成为可执行测试,但写出它仍需系统分析。通用语言代码在面向非开发人员沟通时有局限。

# 重构与设计
## 既有系统
- 测试保护外部行为
- 小步多次重构
## 深层问题
- 领域分析与建模
## 代码即文档
- 可执行需求示例
- 跨角色沟通仍需可理解表达

相关卡片:重构需要测试与设计、代码即文档仍需建模

  1. 重构需要测试与设计 理解等级:中级 普通读书笔记卡
  2. 代码即文档仍需建模 理解等级:中级 普通读书笔记卡

179 15.2 数据建模示例:订单的装运与支付

0 张卡片

章节作用:设置一个工期紧、从购物应用的“我的订单”界面分类着手建模的案例,后续再讨论订单、装运和支付结构。

内容脉络:图 15-1 展示待付款、待发货、待收货、评价、退款/售后入口。本项仅提出案例场景,尚未给出数据模型;作者假设团队不熟悉 DDD,后文不使用专有术语。

# 电商建模案例输入
## 项目条件
- 两周交付假设
- 团队不使用 DDD 术语
## 界面线索
- 待付款、待发货、待收货
- 评价、退款/售后
## 后续问题
- 订单与装运、支付如何建模

相关卡片:无(本章无合格知识卡)

180 15.2.1 订单与订单行项

1 张卡片

章节作用:以过度简化的订单状态设计,引出分批装运与混合支付的建模问题。

内容脉络:表 15-1 展示订单与多行项的基础结构。示例 Order 又直接挂 IsPaid、PaymentNumber、IsShipped、IsReceipted、ShipmentNumber。客户可能先收到部分商品,也可能以储值余额和第三方支付组合付款;单个布尔位与编号不足以完整记录这些过程。改进模型见后文。

# 订单反例
## 订单行项
- 产品与数量
## 单一状态字段
- IsShipped、ShipmentNumber
- IsPaid、PaymentNumber
## 新需求
- 分批发货
- 混合支付与积分

相关卡片:订单布尔状态遮蔽履约

  1. 订单布尔状态遮蔽履约 理解等级:中级 普通读书笔记卡

181 15.2.2 订单与订单装运组

1 张卡片

章节作用:用订单装运组和行项关联表示一次订单中的分批发货计划。

内容脉络:订单一对多对应装运组,组 ID 包含订单 ID 与组序号;组内关联 ID 再加订单行项序号,并记录应划拨数量。表 15-2 展示有些行项本次发,有些暂不发。多个订单的需求还可合并进实际装运单,细节由后文展开。

# 分批发货模型
## Order
- 多个 OrderShipGroup
## OrderShipGroup
- 一次发货计划
- 库存保留、备货、拣货信息
## 行项关联
- 订单行项
- 本组应发数量
## Shipment
- 可合并多订单需求

相关卡片:订单装运组表达分批发货

  1. 订单装运组表达分批发货 理解等级:中级 结构图卡

182 15.2.3 订单与装运单

1 张卡片

章节作用:区分订单级发货计划与跨订单实际装运,并提出关联职责问题。

内容脉络:装运组与装运单可多对多;表 15-3 显示张三两个订单的行项并入一张装运单。原关联中的数量是计划发货量,实际装运量还需记录。作者质疑把装运单 ID、装运行项 ID 和实际数量全塞进既有关联的方案,下一节继续建模。

# 发货计划与实际装运
## OrderShipGroup
- 某订单的计划需求
- 计划发货数量
## Shipment
- 可合并多订单需求
- 实际装运行项与数量
## 待解决
- 多对多关联承载何种职责

相关卡片:装运组与装运单分离

  1. 装运组与装运单分离 理解等级:中级 结构图卡

183 15.2.4 订单的项目发货

2 张卡片

章节作用:用独立实际发货记录连接订单装运计划与装运单,并说明订单发货状态的派生性质。

内容脉络:ItemIssuance 以独立 ID 记录计划行项、装运行项、实际数量和可选的 SN。表 15-4、15-5 展示一条装运行项可拆为两条单件发货记录。订单状态可由装运事实派生,待发和已发部分可并存;派生结果可按性能需要缓存。

# 发货事实
## 计划
- OrderItemShipGroupAssociation
## 实际
- ItemIssuance 数量与 SN
- ShipmentItem
## 订单视图
- 状态由履约事实派生
- 部分已发与待发可并存

相关卡片:项目发货记录实际履约、订单发货状态应由事实派生

  1. 项目发货记录实际履约 理解等级:中级 结构图卡
  2. 订单发货状态应由事实派生 理解等级:中级 普通读书笔记卡

184 15.2.5 订单的支付

3 张卡片

章节作用:以订单支付模型补足装运案例,并论证目标模型对长期重构的指导作用。

内容脉络:Order、Invoice 和 Payment 分别表示订购、请求付款、实际付款;计费实体连接订单/装运与付款请求,PaymentApplication 连接付款与请求并分配金额。订单支付状态由请求和已完成付款的分配额派生,可出现部分支付。跨外部支付系统需处理一致性中间态。作者主张为复杂旧系统明确目标模型,再让代码逐步与模型对齐。表 15-6 已核对。

# 订单支付模型
## 业务事实
- Order 订购
- Invoice 付款请求
- Payment 实际付款
## 关联
- Billing 连接订单或装运
- PaymentApplication 分配付款金额
## 派生
- 已支付或部分支付
## 演进
- 目标模型指导重构

相关卡片:订单计费与支付分离、订单支付状态由分配派生、目标模型指导重构

  1. 订单计费与支付分离 理解等级:中级 结构图卡
  2. 订单支付状态由分配派生 理解等级:中级 普通读书笔记卡
  3. 目标模型指导重构 理解等级:中级 普通读书笔记卡

185 15.3 中台是一个轮回

2 张卡片

章节作用:区分限界上下文的概念边界与服务部署边界,讨论中台扩大统一概念范围的成本。

内容脉络:大型 ERP 在大范围保持概念完整性困难;拆分上下文与服务降低局部复杂度,但增加跨上下文集成。过细微服务可能让一个上下文跨多个物理服务。中台在概念上重新扩大统一范围,可减少客户的概念转换,却要承担更大的统一建模工作。决策取决于目标和资源。

# 概念边界的范围
## 大范围统一
- 使用者少做概念转换
- 命名与规则协调成本高
## 较小上下文
- 局部概念完整性
- 防腐层与集成代码增加
## 物理服务
- 粒度可与上下文不同

相关卡片:限界上下文与服务边界、中台范围与防腐层取舍

  1. 限界上下文与服务边界 理解等级:中级 结构图卡
  2. 中台范围与防腐层取舍 理解等级:中级 普通读书笔记卡

186 15.4 实例化需求与行为驱动测试

0 张卡片

章节作用:引出以实例化需求参与产品定义的主题,并给出背景书目。

内容脉络:作者认为开发前要弄清客户期望的产品,提到实例化需求,并引用 Gojko Adzic 的《Specification by Example》。本项没有展开示例编写或行为驱动测试方法,具体机制由后文说明。

# 产品定义
## 问题
- 客户想要什么
## 方法线索
- 实例化需求
- 后文展开 BDD

相关卡片:无(本章无合格知识卡)

187 15.4.1 什么是实例化需求

2 张卡片

章节作用:界定实例化需求的目标和步骤,说明其最终产物为何是活文档。

内容脉络:实例化需求从商业目标划定范围,经协作制订说明、用具体例子描述并精炼,再以自动化验收频繁验证。需求说明保留自然语言形式,验收测试使其能够跟踪系统现有行为;持续维护是活文档成立的条件。本节定义引自 InfoQ 中文书评,尚未展示本书自己的完整实例。

# 实例化需求
## 产品目标
- 范围与商业需求
## 协作说明
- 用例子澄清并精炼
## 验证
- 自然语言说明
- 自动化验收与频繁运行
## 产物
- 描述当前行为的活文档

相关卡片:实例化需求以例子协作、活文档随验收测试更新。

  1. 实例化需求以例子协作 理解等级:中级 普通读书笔记卡
  2. 活文档随验收测试更新 理解等级:中级 普通读书笔记卡

188 15.4.2 BDD工具

1 张卡片

章节作用:用 Cucumber、Gherkin 和 SpecFlow 展示实例化需求怎样落到可读且可执行的验收场景。

内容脉络:作者提醒 BDD 一词在当时尚无精确定义,不把它与实例化需求视作严格等同。Cucumber 读取 Gherkin 说明并核对行为;计算器示例以功能、场景、前提、操作、结果组织。SpecFlow 是书中给出的 .NET 项目工具;这些是书中当时的示例,不能据此推断工具当前的支持范围。

# 可执行的需求实例
## Gherkin 场景
- Feature 与 Scenario
- Given 前提
- When 触发
- Then 结果
## 工具
- Cucumber 验证行为
- SpecFlow 用于 .NET

相关卡片:Gherkin场景表达验收行为。

  1. Gherkin场景表达验收行为 理解等级:中级 普通读书笔记卡

189 15.4.3 BDD工具应与DDD相得益彰

1 张卡片

章节作用:说明可执行需求与领域建模的职责差异,并提出用统一语言连接二者。

内容脉络:BDD 场景澄清客户所需的外部行为,却不自动产生反映领域知识的实现。产品、业务、开发和测试人员共同使用统一语言写需求,让场景可读、可维护并指导命名;应直接描述业务逻辑,避免绑在易变的 UI 操作上。计算器例子主要用于演示语法,不能代表复杂业务的完整实例。

# BDD 与 DDD
## BDD
- 澄清与验证外部行为
## DDD
- 分析领域并形成模型
## 连接
- 团队共享统一语言
- 场景描述业务规则
- 少绑定 UI 细节

相关卡片:BDD需求与领域模型互补。

  1. BDD需求与领域模型互补 理解等级:高级 普通读书笔记卡

190 15.4.4 不要在验收测试中使用固件数据

2 张卡片

章节作用:解释固定数据库备份作为验收测试前置条件的反模式,并给出可重复运行的替代做法。

内容脉络:单元测试通常隔离数据库、网络和文件系统;验收测试为验证业务行为可使用接近生产的数据库,但仍应尽量自行设置独立前置条件。共享固定备份会带来场景顺序依赖、偶发失败和模式变更后的备份维护。测试代码为本场景构造数据,避免人工恢复与清理,支持重复运行及 CI/CD。

# 验收测试数据
## 固定备份
- 共享状态随测试变化
- 顺序依赖与闪烁
- 模式变更后过期
## 自行构造
- 场景独立数据
- 接近生产的外部环境
- 自动且可重复运行

相关卡片:固定固件数据使验收测试闪烁、验收测试自行构造前置数据。

  1. 固定固件数据使验收测试闪烁 理解等级:中级 普通读书笔记卡
  2. 验收测试自行构造前置数据 理解等级:中级 普通读书笔记卡

191 15.4.5 制造“制造数据”的工具

2 张卡片

章节作用:展示如何把已有聚合状态变成可复用的创建命令模板,让验收测试通过业务入口自行造数。

内容脉络:SQL 直接造数难以维护复杂关联;WMS 示例改用应用服务的创建命令。先读 InOut 单据及行项状态,用 MixIn 去掉版本、审计、不可创建状态等属性,结合元数据识别聚合及 ID 类型,得到 JSON 模板。测试替换单号占位符、反序列化为 CreateInOut,再通过应用服务创建新聚合。模板中的其他业务引用是否有效仍取决于测试环境。三个连续正文单元均已核对。

# 测试造数
## 策略
- 使用业务命令而非直接 SQL
## 提取模板
- 应用服务读取聚合状态
- 过滤不可创建字段
- 保存 JSON
## 执行
- 替换单号
- 转成创建命令
- 创建新聚合供测试使用

相关卡片:用业务命令制造验收数据、状态模板转创建命令。

  1. 用业务命令制造验收数据 理解等级:中级 普通读书笔记卡
  2. 状态模板转创建命令 理解等级:高级 结构图卡

192 15.5 要领域模型驱动,不要UI驱动

2 张卡片

章节作用:批评直接照着界面原型建立数据模型,强调维护业务概念完整性。

内容脉络:作者将产品原型评审后直接做表、逻辑和界面称为 UI 驱动开发;其风险是实现虽可工作,却缺少稳定的领域模型。反例包括产品与促销混合、业务角色和系统用户混合、用户账号与登录方式混合。SKU 及定制属性案例进一步展示界面需求如何使字段向订单、装运、库存等实体扩散;应先明确产品、规格和定制配置的身份关系。

# 建模依据
## UI 原型
- 展示当前交互
- 易变且可能遮蔽业务事实
## 领域模型
- 澄清身份与关系
- 维护概念完整性
## 反例
- 产品与促销混同
- 账号与登录方式混同
- SKU 字段补丁扩散

相关卡片:界面原型不能代替领域模型、SKU补丁蔓延暴露概念缺口。

  1. 界面原型不能代替领域模型 理解等级:高级 普通读书笔记卡
  2. SKU补丁蔓延暴露概念缺口 理解等级:高级 普通读书笔记卡

193 15.6 不要用“我”的视角设计核心模型

1 张卡片

章节作用:以订单和直运案例引入第三人称、旁观者式的核心业务建模。

内容脉络:买家界面将订单称为采购,卖家界面称为销售。若按单个参与者视角将两者固定为独立实体,供应商直运给客户的新业务就会暴露关系难以表达的问题。应先记录多方参与和交易事实,再给各方不同界面视图。作者在本项引述《数据模型资源手册》和 OFBiz 作为转变思路的背景,具体模型在后文展开。

# 核心模型的视角
## 第一人称
- 我的销售订单
- 我的采购订单
- 直运时关系变复杂
## 旁观者
- 记录参与方与业务事实
- 为角色提供不同视图

相关卡片:核心模型采用旁观者视角。

  1. 核心模型采用旁观者视角 理解等级:高级 普通读书笔记卡

194 15.6.1 让User消失

1 张卡片

章节作用:将业务参与方与软件用户分开,为后续 Party 模型清理概念边界。

内容脉络:操作软件的人或程序并不等于业务流程的参与方。供应商可能有联系人信息,也可能有人登录系统,但更多供应商并不使用系统;因此不能仅因字段相似或部分人登录,就将供应商建为 User 子类型。一般业务核心记录 Party 及其关系;用户管理系统是 User 可成为核心概念的例外。

# 参与方与用户
## Party
- 业务事实中的各方
- 供应商等不必登录
## User
- 软件操作主体
- 可代录他方业务
## 建模判断
- 核心业务以参与方为中心
- 用户管理系统另论

相关卡片:业务参与方不等于系统用户。

  1. 业务参与方不等于系统用户 理解等级:中级 普通读书笔记卡

195 15.6.2 认识一下Party

4 张卡片

章节作用:定义 Party 及其外部标识、业务角色和对象间关系,提供多方业务建模的基本构件。

内容脉络:Party 是自然人或组织等业务参与方,与软件用户及 DDD 实体术语不同。PartyIdentification 把多个可变外部标识连到稳定 Party ID。RoleType 是业务身份,区别于权限角色;PartyRole 支持一方多角色,PrimaryRoleTypeId 仅是可选冗余。OrderRole 表示某方在具体订单中的角色;PartyRelationship 记录两方及其角色、关系类型和有效时间。

# Party 模型
## 参与方
- Person 或 Organization 等
## 标识
- 稳定 Party ID
- 多种外部 PID
## 角色
- RoleType 业务身份
- PartyRole 多对多
## 关系
- OrderRole 订单上下文
- PartyRelationship 双方与时效

相关卡片:Party统一表示业务参与方、外部标识不宜充当PartyID、业务角色与权限角色分离、关系实体记录参与方的上下文。

  1. Party统一表示业务参与方 理解等级:中级 普通读书笔记卡
  2. 外部标识不宜充当PartyID 理解等级:中级 普通读书笔记卡
  3. 业务角色与权限角色分离 理解等级:中级 结构图卡
  4. 关系实体记录参与方的上下文 理解等级:高级 结构图卡

196 15.7 我们想要的敏捷设计

1 张卡片

章节作用:总结敏捷设计应如何连接需求、领域模型和可运行软件。

内容脉络:自下而上编码重构与自上而下分析设计可以结合。作者希望借低代码工具尽快把模型变成可运行结果,让领域专家确认;有偏差则重新分析、调整模型和实现。最终留下与模型保持对应的代码资产。低代码工具的效果在本项是方法愿景,仍需检验。

# 敏捷设计循环
## 输入
- 需求分析
- 领域建模
## 反馈
- 快速产出软件
- 领域专家确认
- 修正模型与实现
## 资产
- 深度领域模型
- 对应的可扩展代码

相关卡片:敏捷设计贯通需求模型与代码。

  1. 敏捷设计贯通需求模型与代码 理解等级:高级 普通读书笔记卡

197 第16章 说说SaaS

1 张卡片

章节作用:引出 SaaS 的企业工具价值及其工程基础设施挑战。

内容脉络:SaaS 的企业用户以软件辅助生产,区别于消费型应用用户。作者强调持续交付服务需要匹配商业模式的底层基础设施,难点常在工程细节;本项尚未展开具体机制。

# SaaS 导论
## 客户
- 企业生产工具
## 交付
- 持续提供应用价值
## 难点
- 匹配商业模式的基础设施

相关卡片:SaaS难点在服务化工程。

  1. SaaS难点在服务化工程 理解等级:中级 普通读书笔记卡

198 16.1 何为SaaS

1 张卡片

章节作用:给出 SaaS 交付方式与面向企业客户的成本主张。

内容脉络:供应商统一部署、维护,客户按约定范围与期限通过网络使用。书中强调租用降低初始采购门槛,集中运维理论上可分摊成本;实际成本比较仍需核算。本项定义引自百度百科并经作者删改。

# SaaS 交付
## 供应商
- 统一部署维护
## 客户
- 网络使用
- 按约定付费
## 成本主张
- 降低初始投入
- 集中运维可能摊薄成本

相关卡片:SaaS交付模式分摊使用成本。

  1. SaaS交付模式分摊使用成本 理解等级:中级 普通读书笔记卡

199 16.2 多租户技术

2 张卡片

章节作用:定义多租户并解释共享核心版本为何影响 SaaS 的运维经济性。

内容脉络:SaaS 是商业交付模式,多租户是一种常用技术路线。多个租户共享系统组件,但数据必须隔离。统一核心代码便于一次部署升级;客户自行修改、独立部署核心源码则造成版本分叉,修复同一缺陷可能要重复处理。作者用百套源码的假设说明成本,提到通过 API 扩展外围功能。

# 多租户
## 共享
- 核心代码和组件
- 集中升级维护
## 隔离
- 租户数据
## 定制边界
- API 外围扩展
- 核心源码分叉增加成本

相关卡片:多租户共享组件隔离数据、客户源码分叉抬高SaaS运维。

  1. 多租户共享组件隔离数据 理解等级:中级 普通读书笔记卡
  2. 客户源码分叉抬高SaaS运维 理解等级:高级 普通读书笔记卡

200 16.3 构建成功的SaaS有何难

0 张卡片

章节作用:提出 SaaS 转型困难的讨论范围,引出后续成本与定制问题。

内容脉络:本项以国内 SaaS 发展问题起笔,作者归因为方法论不成熟和小厂商门槛高,但没有数据或具体机制。技术原因由后续小节展开。

# SaaS 困难导读
## 问题
- 产品与转型为何困难
## 作者判断
- 方法论和资源门槛
## 后续
- 多租户成本
- 定制化需求

相关卡片:无(本章无合格知识卡)

201 16.3.1 多租户系统的构建成本

1 张卡片

章节作用:说明 SaaS 早期投入和未来单位客户成本之间的时间差,提出平台承担共性复杂性的方向。

内容脉络:开发多租户基础设施的初始成本高于单客户私有部署;商业上期待新增租户边际成本下降。低估投入会使产品到 MVP 前就失败。作者设想由技术底座处理多租户、数据隔离和运维,让应用代码聚焦业务;80% 只是作者期望,不是测量结果。

# 多租户成本
## 早期
- 隔离与运维基础设施投入
- MVP 前资金风险
## 后期目标
- 新增客户边际成本下降
## 技术底座
- 承担共性复杂性

相关卡片:多租户前期投入换边际成本。

  1. 多租户前期投入换边际成本 理解等级:高级 普通读书笔记卡

202 16.3.2 难以满足的定制化需求

2 张卡片

章节作用:讨论统一 SaaS 产品面对租户差异时,配置和平台扩展各能解决什么问题。

内容脉络:客户有独特需求,逐一修改共享核心代码会破坏标准化成本优势。声明式配置先抽象业务变体,再由租户表述所需结果;其灵活性受原模型预见范围限制。新需求仍要求低成本修改领域模型。PaaS 面向开发者,可提供更开放的扩展能力,但对外开放平台比提供配置项更难;二者边界未必清楚。

# SaaS 定制层次
## 统一核心
- 共享代码与运维
## 租户配置
- 声明式表达差异
- 受模型预见范围限制
## 平台扩展
- 开发者可创造新行为
- 工具与维护成本更高

相关卡片:租户配置依赖领域抽象、配置与PaaS扩展能力分层。

  1. 租户配置依赖领域抽象 理解等级:高级 普通读书笔记卡
  2. 配置与PaaS扩展能力分层 理解等级:高级 普通读书笔记卡

203 16.3.3 负重前行的传统软件公司

1 张卡片

章节作用:说明存量客户交付与新 SaaS 基础设施建设争夺同一团队资源。

内容脉络:传统厂商可能有旧架构和技术债,仍要做客户定制、私有部署与人工运维;SaaS 转型同时需要持续投资共享基础设施。作者据此判断转型困难。这里是特定厂商处境的分析,未提供量化证据或通用成功率。

# 转型负担
## 存量
- 客户定制与私有部署
- 人工运维
- 旧系统技术债
## 新投入
- SaaS 基础设施
- 共享产品架构
## 结果
- 过渡期资源竞争

相关卡片:SaaS转型受存量交付牵制。

  1. SaaS转型受存量交付牵制 理解等级:高级 普通读书笔记卡

204 16.4 SaaS需要DDD

1 张卡片

章节作用:说明 DDD 在战略和战术两层如何辅助大型 SaaS 划定边界。

内容脉络:组件化支持局部功能与非功能改进。战略层用限界上下文和防腐层保持概念完整性并集成;战术层用聚合组织规则、区分聚合内强一致性与跨聚合最终一致性。作者据此主张 DDD 有助于扩展,但多租户隔离等能力仍须独立设计。

# DDD 拆分
## 战略层
- 限界上下文
- 防腐层集成
## 战术层
- 聚合
- 聚合内强一致性
- 跨聚合最终一致性
## 效果
- 局部优化与扩展边界

相关卡片:DDD分层拆分SaaS复杂性。

  1. DDD分层拆分SaaS复杂性 理解等级:高级 普通读书笔记卡

205 第17章 更好的“锤子”

2 张卡片

章节作用:收束前文的 DDDML 应用,介绍已有生成工具链及尚未实现的协作工具设想。

内容脉络:DDDML Tools 已从模型生成不同语言的后端、客户端 SDK、文档和管理界面;两个 Java 生成器采用不同实现风格,说明 DSL 共享不等于代码架构统一。作者随后希望用 Viewer 帮团队核对领域模型,认为它比图形设计器更急需;更多语言、数据存储及 PaaS 支持仍属计划。

# 更好的 DDDML 工具
## 已有工具链
- 多语言后端
- 客户端与接口文档
- 管理界面
- Java 生成器架构可不同
## 希望补强
- Viewer 支持团队核对模型
- 图形设计器
- 更多语言与存储支持
- 在线协作平台

相关卡片:领域模型驱动多端生成、领域模型可视化先于图形编辑。

  1. 领域模型驱动多端生成 理解等级:中级 普通读书笔记卡
  2. 领域模型可视化先于图形编辑 理解等级:中级 普通读书笔记卡

206 17.1 我们制作的一个DDDML

0 张卡片

章节作用:引出 DDDML Builder 及后续图形工具案例。

内容脉络:本项只说明团队制作了一个 GUI 工具,且距离预期仍有差距;未展开功能机制,具体示例从后续小节开始。

# DDDML Builder 导读
## 已有
- 一个图形界面工具
## 后续
- 展示具体用法
## 限制
- 尚未达到作者预期

相关卡片:无(本章无合格知识卡)

207 17.1.1 给领域建模提供起点

1 张卡片

章节作用:说明如何利用已有数据模型帮助团队启动领域分析。

内容脉络:《数据模型资源手册》与 OFBiz 提供可参考的通用或行业数据模型。作者设想把关系/ER 模型重新整理为 DDDML 模型库,或开放搜索、转换和编辑工具;Builder 已能搜索、转换 OFBiz 模型。现成模型只是起点,不能代替对当前业务边界和规则的判断。

# 领域建模起点
## 参考素材
- 通用与行业数据模型
- OFBiz 模型
## 转换方向
- 关系或 ER 模型
- DDDML 描述
## 目标
- 共享模型库
- 降低分析起步成本

相关卡片:现成数据模型是建模起点。

  1. 现成数据模型是建模起点 理解等级:中级 普通读书笔记卡

208 17.1.2 创建新的限界上下文

2 张卡片

章节作用:示范用 Builder 从已有配置创建新项目,并启动模型变更后的代码生成。

内容脉络:先读入真实项目用过的生成配置,替换项目名称、根目录及环境参数,再生成新项目;这样降低维护独立模板的成本。项目创建后,Watch 监控 dddml 目录,文件变化会触发模板转换引擎生成或更新源代码。界面按钮与命名规则属于工具细节,不代替对生成结果的检查。

# 创建限界上下文
## 项目起点
- 复用已验证配置
- 替换旧项目设置
## 项目创建
- 生成新配置
- 创建项目与复制代码
## 模型反馈
- 监控 DDDML 目录
- 触发相关代码更新

相关卡片:复用已验证配置创建项目、模型目录变更触发代码生成。

  1. 复用已验证配置创建项目 理解等级:中级 普通读书笔记卡
  2. 模型目录变更触发代码生成 理解等级:中级 结构图卡

209 17.1.3 从OFBiz中“借鉴”数据模型

1 张卡片

章节作用:用 OFBiz 的 StatusItem 展示从既有 ER 模型选择性导入 DDDML 的过程。

内容脉络:Builder 载入 OFBiz 的 XML 实体模型,搜索 StatusItem 并可保存其数据用于测试;导出前把 StatusItem 设为起点,把不想带入的关联实体 StatusType 排除,再转换到新上下文的 DDDML 目录。目录监视器随后触发代码更新。关键取舍在于显式控制导入范围,而不是把旧数据结构整批复制。

# OFBiz 模型借鉴
## 查找
- 载入 XML 实体模型
- 搜索 StatusItem
## 控制范围
- 指定起点实体
- 排除 StatusType
## 导出
- 转为 DDDML
- 可另存测试数据
- 触发代码更新

相关卡片:旧模型导入须限制关联范围。

  1. 旧模型导入须限制关联范围 理解等级:中级 普通读书笔记卡

210 17.1.4 构建项目并运行应用

1 张卡片

章节作用:把导出的 DDDML 示例推进到可运行服务和可查询数据。

内容脉络:先构建项目,再创建 Schema,导入前节保存的 StatusItem XML 数据,启动 REST 服务,最后以 GET 读取导入的数据。每步有独立成功信号,最终查询检验示例链路连通;按钮与端口只是该工具的具体界面设置。

# 构建与验证
## 准备运行
- Maven 构建
- 创建 Schema
- 导入 XML 种子数据
## 对外验证
- 启动 REST 服务
- GET 核对导入数据

相关卡片:生成应用分阶段启动验证。

  1. 生成应用分阶段启动验证 理解等级:中级 结构图卡

211 17.1.5 使用HTTP

1 张卡片

章节作用:示范客户端指定实体 ID 的 PUT 创建以及 GET 结果核验。

内容脉络:向包含 TEST_STATUS_1 的 StatusItem URL 发 PUT,JSON 放状态类型、代码和描述等属性;示例服务返回 200。随后对同一 URL 发 GET,确认响应中的 ID 和属性与预期相符。该状态码与 URL 是本书服务示例,不是所有 API 的固定要求。

# PUT 创建示例
## 请求
- URL 指定 StatusItem ID
- JSON 提供属性
## 响应
- 此服务返回 200
## 验证
- 同 URL GET
- 对照 ID 与属性

相关卡片:PUT指定资源ID创建实体。

  1. PUT指定资源ID创建实体 理解等级:中级 普通读书笔记卡

212 17.1.6 给聚合增加方法

1 张卡片

章节作用:展示从 DDDML 方法声明到手写业务逻辑、命令调用和状态核对的完整示例。

内容脉络:为 StatusItem 增加 ChangeCode(code),参数使用领域基础类型 short-varchar;Builder 生成独立方法项目和逻辑入口。开发者在 mutate 中实现 statusCode 更新,复制回项目并重新构建。PUT 命令携带新代码与版本 0,随后 GET 看到属性变化和版本 1。verify 在示例中留空,不代表所有方法都无需校验;在线工具与 Serverless 只是作者愿景。

# 聚合方法示例
## 模型声明
- ChangeCode 方法
- code 参数与基础类型
## 业务实现
- 生成逻辑入口
- 手写 mutate
- 回拷并构建
## 行为验证
- PUT 命令携版本
- GET 核对状态与版本

相关卡片:生成方法骨架仍须实现业务逻辑。

  1. 生成方法骨架仍须实现业务逻辑 理解等级:中级 普通读书笔记卡

213 17.1.7 生成限界上下文的Demo

1 张卡片

章节作用:展示从已创建的限界上下文生成并运行独立的管理界面项目。

内容脉络:Builder 读取刚创建的上下文信息,生成 Demo Admin UI 项目;这个项目独立于 REST API 服务,需要单独构建和启动。浏览器中的 StatusItem 列表是界面与接口结合后的示例结果,按钮和端口属于工具细节。

# Demo Admin UI
## 输入
- 已创建的限界上下文
## 生成
- 独立界面项目
## 运行
- 构建并启动
- 查看 StatusItem 列表

相关卡片:管理界面与API独立生成。

  1. 管理界面与API独立生成 理解等级:初级 普通读书笔记卡

214 17.1.8 让不同层级的开发人员各尽其能

1 张卡片

章节作用:由 Builder 演示推广到模型协作和按复杂度分配业务开发任务。

内容脉络:团队共同设计和评审 DDDML 模型;局部实体方法可给熟悉基础语法的成员实现,资深成员建设领域基础类型、跨聚合服务、工具链及基础设施。原书期望工具链降低对底层框架细节的依赖,但人员职责不能只凭职级机械划分。业务逻辑的三处归属与第85项相呼应。

# 团队分工设想
## 共同协作
- 维护模型概念完整性
## 局部业务实现
- 实体方法逻辑
## 复杂共性工作
- 领域基础类型
- 跨聚合服务
- 工具链与基础设施
## 边界
- 能力评审和风险决定分工

相关卡片:按业务逻辑复杂度分配开发职责。

  1. 按业务逻辑复杂度分配开发职责 理解等级:高级 普通读书笔记卡

215 17.2 以统一语言建模

1 张卡片

章节作用:由代码生成和人员分工转向统一语言,说明命名讨论如何反过来帮助识别领域概念。

内容脉络:原书团队设想按上下文维护词汇表,记录英文标识、中文含义与讨论笔记,并从代码用法检验名称;再让 DDDML 模型名称与词汇表相互核对,使生成代码及默认界面文案沿用一致语义。词汇表 App、聊天采集和设计器集成尚未完成,只能作为方法设想。

# 上下文词汇表
## 输入
- 业务讨论与笔记
- 既有代码用法
## 核对
- 英文标识与中文含义
- 模型中的对象、方法与状态名称
## 预期用途
- 生成代码名称一致
- 默认界面文案可读
## 实现状态
- 工具集成仍是设想

相关卡片:按上下文维护领域词汇表。

  1. 按上下文维护领域词汇表 理解等级:中级 普通读书笔记卡

216 附录 DDDML示例与缩写表

0 张卡片

章节作用:提供可回查的 DDDML 配置实例,将正文的聚合、继承、实体标识与值对象写法集中展示。

内容脉络:Package 示例组合内部实体、超对象、派生集合及反向引用;Party 示例展示鉴别列、继承映射和子类型;Person 示例展示多层内部实体 ID、方法参数及组合值对象。它们是正文机制的配置复现,未提出新的建模规则;末尾图片缩写表列出 DDD、DOM、DSL 等 11 项已有术语或基础释名。

# DDDML 配置实例
## Package
- 超对象与内部实体
- 派生集合和反向引用
## Party
- 区分标识与继承映射
- 子类型
## Person
- 嵌套实体标识
- 命令参数与组合值对象
## 缩写表
- 图中有 11 项英文缩写及释义
- 用于回查已有术语

相关卡片:无(本章无合格知识卡)

全书概览

深入实践DDD:以DSL驱动复杂软件开发

四象限评级:工程实践(高信息浓度 + 低稳定性)

书籍类别:领域建模类

评级理由: 这本书的高浓度来自它不只复述 DDD 名词,而是围绕“为什么 DDD 难落地、为什么需要 DSL、如何把模型变成可运行软件”展开权衡。前言把云原生、FaaS、中台和产业互联网都落回“领域模型能否严格表达”的问题;第1章用命名、聚合、限界上下文解释软件核心复杂性来自领域;第4章明确把严格、可解析的 DSL 作为 DDD 落地工具;第7-9章讨论聚合、实体行为和领域模式;第12-13章把一致性、领域事件和 REST API 接到实现边界上;第15-17章进一步讨论敏捷设计、SaaS 与工具链分工。它的稳定性低于“经典原理”,因为大量篇幅绑定 DDDML 语法、Java/Hibernate/JAX-RS、生成代码、Admin UI 和具体工具链形态;这些实现细节会随技术栈变化而过时。因此整体属于高浓度但受具体工程方案约束的“工程实践”。

历史章组进度(参考)

章节号 章节标题 精读/略读 状态 卡片数
1 DDD的关键概念 精读 pending 6
2 其他DDD相关概念 精读 pending 3
3 CQRS与Event Sourcing 精读 pending 3
4 DDD的DSL是什么 精读 pending 4
5 限界上下文 略读 pending 0
6 值对象 略读 pending 0
7 聚合与实体 精读 pending 5
8 超越数据模型 精读 pending 3
9 模式 精读 pending 4
10 处理限界上下文与值对象 略读 pending 0
11 处理聚合与实体 略读 pending 0
12 处理领域服务 精读 pending 4
13 RESTful API 精读 pending 4
14 直达UI 略读 pending 0
15 找回敏捷的软件设计 精读 pending 5
16 说说SaaS 精读 pending 4
17 更好的“锤子” 精读 pending 5

2026-10-16 续跑:历史 17 章 done 缺 spine 逐项覆盖及大纲,已恢复 pending;旧卡数仅记录历史文件数。

章节进度追踪表

原书 216 个实质 spine 项按源顺序映射为本笔记的独立章号;原书第 1–17 章只作章组参考。此表是 Cardbox 章号真源,旧 17 章进度表仅留作历史追溯。

章节号 章节标题 状态(pending/done) 卡片数
01 前言 done 3
02 第1章 DDD的关键概念 done 1
03 1.1 自顶而下、逐步求精 done 1
04 1.1.1 DDD开创全新分析流派 done 1
05 1.1.2 什么是软件的核心复杂性 done 1
06 1.2 什么是领域模型 done 1
07 1.3 战术层面的关键概念 done 0
08 1.3.1 实体 done 1
09 1.3.2 值对象 done 2
10 1.3.3 聚合与聚合根、聚合内部实体 done 2
11 1.3.4 聚合的整体与局部 done 0
12 1.3.5 聚合是数据修改的单元 done 2
13 1.3.6 聚合分析是“拆分”的基础 done 3
14 1.3.7 服务 done 1
15 1.4 战略层面的关键概念 done 1
16 1.4.1 限界上下文 done 2
17 1.4.2 限界上下文与微服务 done 1
18 1.4.3 防腐层 done 2
19 1.4.4 统一语言 done 1
20 1.5 ER模型、OO模型和关系模型 done 2
21 1.6 概念建模与模型范式 done 1
22 第2章 其他DDD相关概念 done 0
23 2.1 领域ID done 0
24 2.1.1 自然键与代理键 done 1
25 2.1.2 DDD实体的ID需要被最终用户看到 done 2
26 2.1.3 什么时候使用代理键 done 3
27 2.2 ID、Local ID与Global ID done 1
28 2.3 命令、事件与状态 done 3
29 第3章 CQRS与Event Sourcing done 1
30 3.1 命令查询职责分离 done 2
31 3.2 事件溯源 done 2
32 3.3 From-Thru模式 done 0
33 3.3.1 示例:ProductPrice done 2
34 3.3.2 示例:PartyRelationship done 1
35 3.4 CQRS、ES与流处理 done 1
36 第4章 DDD的DSL是什么 done 2
37 4.1 为什么DDD需要DSL done 0
38 4.1.1 为什么实现DDD那么难 done 1
39 4.1.2 搞定DDD的“锤子”在哪里 done 1
40 4.2 需要什么样的DSL done 1
41 4.2.1 在“信仰”上保持中立 done 1
42 4.2.2 DDD原生 done 1
43 4.2.3 在复杂和简单中平衡 done 2
44 4.2.4 通过DSL重塑软件开发过程 done 0
45 4.3 DDDML——DDD的DSL done 0
46 4.3.1 DDDML的词汇表 done 2
47 4.3.2 DDDML的Schema done 1
48 4.4 DDDML示例:Car done 2
49 4.4.1 “对象”的名称在哪里 done 1
50 4.4.2 使用两种命名风格:camelCase与PascalCase done 1
51 4.4.3 为何引入关键字itemType done 1
52 第5章 限界上下文 done 1
53 5.1 DDDML文档的根结点下有什么 done 2
54 5.2 限界上下文的配置 done 2
55 5.3 名称空间 done 1
56 5.3.1 再谈PascalCase命名风格 done 1
57 5.3.2 注意两个字母的首字母缩写词 done 1
58 5.4 关于模块 done 2
59 第6章 值对象 done 1
60 6.1 领域基础类型 done 2
61 6.1.1 例子:从OFBiz借鉴过来的类型系统 done 1
62 6.1.2 例子:任务的触发器 done 1
63 6.2 数据值对象 done 1
64 6.3 枚举对象 done 1
65 第7章 聚合与实体 done 0
66 7.1 用同一个结点描述聚合及聚合根 done 2
67 7.2 实体之间只有一种基本关系 done 1
68 7.3 关于实体的ID done 2
69 7.4 不变的实体 done 1
70 7.5 动态对象 done 1
71 7.6 继承与多态 done 2
72 7.6.1 使用关键字inheritedFrom done 1
73 7.6.2 超对象 done 2
74 7.7 引用 done 1
75 7.7.1 定义实体的引用 done 1
76 7.7.2 属性的类型与引用类型 done 1
77 7.8 基本属性与派生属性 done 1
78 7.8.1 类型为实体集合的派生属性 done 2
79 7.8.2 类型为值对象的派生属性 done 1
80 7.9 约束 done 1
81 7.9.1 在实体层面的约束 done 1
82 7.9.2 在属性层面的约束 done 1
83 7.10 提供扩展点 done 1
84 第8章 超越数据模型 done 1
85 8.1 实体的方法 done 2
86 8.1.1 聚合根的方法 done 2
87 8.1.2 非聚合根实体的方法 done 1
88 8.1.3 属性的命令 done 1
89 8.1.4 命令ID与请求者ID done 1
90 8.2 记录业务逻辑 done 1
91 8.2.1 关于accountingQuantityTypes done 0
92 8.2.2 关于derivationLogic done 1
93 8.2.3 关于filter done 0
94 8.2.4 使用关键字referenceFilter done 1
95 8.2.5 业务逻辑代码中的变量 done 1
96 8.2.6 说说区块链 done 1
97 8.3 领域服务 done 1
98 8.4 在方法定义中使用关键字inheritedFrom done 1
99 8.5 方法的安全性 done 1
100 第9章 模式 done 1
101 9.1 账务模式 done 3
102 9.2 状态机模式 done 2
103 9.3 树结构模式 done 1
104 9.3.1 简单的树 done 1
105 9.3.2 使用关键字structureType done 2
106 9.3.3 使用关键字structureTypeFilter done 1
107 第10章 处理限界上下文与值对象 done 2
108 10.1 项目文件 done 1
109 10.2 处理值对象 done 1
110 10.2.1 一个需要处理的数据值对象示例 done 2
111 10.2.2 使用Hibernate存储数据值对象 done 2
112 10.2.3 处理值对象的集合 done 1
113 10.2.4 在URL中使用数据值对象 done 1
114 10.2.5 处理领域基础类型 done 5
115 第11章 处理聚合与实体 done 2
116 11.1 生成聚合的代码 done 1
117 11.1.1 接口 done 10
118 11.1.2 代码中的命名问题 done 3
119 11.1.3 接口的实现 done 7
120 11.1.4 事件存储与持久化 done 6
121 11.1.5 使用Validation框架 done 1
122 11.1.6 保证静态方法与模型同步更新 done 1
123 11.1.7 不使用事件溯源 done 1
124 11.2 Override聚合对象的方法 done 2
125 11.3 处理继承 done 0
126 11.3.1 TPCH done 1
127 11.3.2 TPCC done 1
128 11.3.3 TPS done 1
129 11.4 处理模式 done 0
130 11.4.1 处理账务模式 done 1
131 11.4.2 处理状态机模式 done 1
132 第12章 处理领域服务 done 2
133 12.1 处理数据的一致性 done 2
134 12.1.1 使用数据库事务实现一致性 done 1
135 12.1.2 使用Saga实现最终一致性 done 3
136 12.2 发布与处理领域事件 done 1
137 12.2.1 编写DDDML文档 done 1
138 12.2.2 生成的事件发布代码 done 4
139 12.2.3 编写生产端聚合的业务逻辑 done 1
140 12.2.4 实现消费端领域事件的处理 done 0
141 12.3 支持基于编制的Saga done 1
142 12.3.1 编写DDDML文档 done 2
143 12.3.2 生成的Saga命令处理代码 done 3
144 12.3.3 需要我们编写的Saga代码 done 3
145 12.3.4 需要我们实现的实体方法 done 5
146 第13章 RESTful done 0
147 13.1 RESTful done 1
148 13.1.1 没有必要绞尽脑汁地寻找名词 done 1
149 13.1.2 尽可能使用HTTP作为封包 done 2
150 13.1.3 异常处理 done 1
151 13.2 聚合的RESTful done 1
152 13.2.1 GET done 4
153 13.2.2 PUT done 2
154 13.2.3 PATCH done 2
155 13.2.4 DELETE done 1
156 13.2.5 POST done 1
157 13.2.6 事件溯源API done 1
158 13.2.7 树的查询接口 done 1
159 13.3 服务的RESTful done 1
160 13.4 身份与访问管理 done 2
161 13.4.1 获取OAuth done 2
162 13.4.2 在资源服务器上处理授权 done 2
163 13.5 生成Client done 1
164 13.5.1 创建聚合实例 done 1
165 13.5.2 更新聚合实例 done 1
166 13.5.3 使用Retrofit2 done 1
167 第14章 直达UI done 0
168 14.1 两条路线的斗争 done 0
169 14.1.1 前端“知道”领域模型 done 2
170 14.1.2 前端“只知道”RESTful done 1
171 14.2 生成Admin done 1
172 14.2.1 使用referenceFilter done 1
173 14.2.2 展示派生的实体集合属性 done 1
174 14.2.3 使用属性层面的约束 done 1
175 14.2.4 使用UI层元数据 done 1
176 14.2.5 构建更实时的应用 done 1
177 第15章 找回敏捷的软件设计 done 1
178 15.1 重构不是万能灵药 done 2
179 15.2 数据建模示例:订单的装运与支付 done 0
180 15.2.1 订单与订单行项 done 1
181 15.2.2 订单与订单装运组 done 1
182 15.2.3 订单与装运单 done 1
183 15.2.4 订单的项目发货 done 2
184 15.2.5 订单的支付 done 3
185 15.3 中台是一个轮回 done 2
186 15.4 实例化需求与行为驱动测试 done 0
187 15.4.1 什么是实例化需求 done 2
188 15.4.2 BDD工具 done 1
189 15.4.3 BDD工具应与DDD相得益彰 done 1
190 15.4.4 不要在验收测试中使用固件数据 done 2
191 15.4.5 制造“制造数据”的工具 done 2
192 15.5 要领域模型驱动,不要UI驱动 done 2
193 15.6 不要用“我”的视角设计核心模型 done 1
194 15.6.1 让User消失 done 1
195 15.6.2 认识一下Party done 4
196 15.7 我们想要的敏捷设计 done 1
197 第16章 说说SaaS done 1
198 16.1 何为SaaS done 1
199 16.2 多租户技术 done 2
200 16.3 构建成功的SaaS有何难 done 0
201 16.3.1 多租户系统的构建成本 done 1
202 16.3.2 难以满足的定制化需求 done 2
203 16.3.3 负重前行的传统软件公司 done 1
204 16.4 SaaS需要DDD done 1
205 第17章 更好的“锤子” done 2
206 17.1 我们制作的一个DDDML done 0
207 17.1.1 给领域建模提供起点 done 1
208 17.1.2 创建新的限界上下文 done 2
209 17.1.3 从OFBiz中“借鉴”数据模型 done 1
210 17.1.4 构建项目并运行应用 done 1
211 17.1.5 使用HTTP done 1
212 17.1.6 给聚合增加方法 done 1
213 17.1.7 生成限界上下文的Demo done 1
214 17.1.8 让不同层级的开发人员各尽其能 done 1
215 17.2 以统一语言建模 done 1
216 附录 DDDML示例与缩写表 done 0

章节取舍说明

  • 第1章《DDD的关键概念》:精读,DDD 的核心术语、聚合、限界上下文和统一语言构成本书方法论底座。
  • 第2章《其他DDD相关概念》:精读,领域 ID、命令、事件、状态是后续 DSL 与实现设计的基础概念。
  • 第3章《CQRS与Event Sourcing》:精读,CQRS、事件溯源和 From-Thru 模式具有较强可迁移架构价值。
  • 第4章《DDD的DSL是什么》:精读,解释为什么用 DSL 让领域模型严格化,是全书主命题。
  • 第5章《限界上下文》:略读,主要展开 DDDML 根节点、命名空间和模块配置,偏语法说明。
  • 第6章《值对象》:略读,主要是 DDDML 对领域基础类型、数据值对象和枚举的描述方式。
  • 第7章《聚合与实体》:精读,围绕聚合、实体关系、继承、多态、引用和约束展开,是核心建模章节。
  • 第8章《超越数据模型》:精读,强调模型不只是数据结构,还应承载命令、方法和业务逻辑。
  • 第9章《模式》:精读,账务、状态机、树结构体现领域模式如何沉淀进 DSL。
  • 第10章《处理限界上下文与值对象》:略读,大量内容绑定 Hibernate、URL、生成代码等实现细节。
  • 第11章《处理聚合与实体》:略读,篇幅很大但主要展示生成接口、持久化、校验与具体代码模板。
  • 第12章《处理领域服务》:精读,一致性、领域事件、Saga 和服务编排具备通用架构价值。
  • 第13章《RESTful API》:精读,用聚合与命令视角重新组织 REST API,兼具实践与原则。
  • 第14章《直达UI》:略读,主要讨论生成 Admin UI 和元数据配置,工具时效性较强。
  • 第15章《找回敏捷的软件设计》:精读,从重构、数据模型、中台和 OFBiz 反思敏捷设计,很有方法论价值。
  • 第16章《说说SaaS》:精读,把 SaaS、多租户、定制化与 DDD 拆分能力联系起来。
  • 第17章《更好的“锤子”》:精读,总结 DDDML 工具链、模型库、图形化和团队分工的演进方向。

正文 spine 阅读计划

以下按 OPF spine 顺序列出可读正文;Sxxx 是唯一源项标识,章组保留原书第 1–17 章。旧 17 章 done 缺阅读覆盖与章节大纲,全部失效。正文项均为 pending,待逐项通读;正式章号见四列进度表。

正文项 原书章组与位置 正文源路径 状态
S003 前言:前言 OEBPS/Text/chapter.xhtml pending
S005 第1章:第1章 DDD的关键概念 OEBPS/Text/chapter2.xhtml pending
S006 第1章:1.1 自顶而下、逐步求精 OEBPS/Text/chapter3.xhtml pending
S007 第1章:1.1.1 DDD开创全新分析流派 OEBPS/Text/chapter4.xhtml pending
S008 第1章:1.1.2 什么是软件的核心复杂性 OEBPS/Text/chapter5.xhtml pending
S009 第1章:1.2 什么是领域模型 OEBPS/Text/chapter6.xhtml pending
S010 第1章:1.3 战术层面的关键概念 OEBPS/Text/chapter7.xhtml pending
S011 第1章:1.3.1 实体 OEBPS/Text/chapter8.xhtml pending
S012 第1章:1.3.2 值对象 OEBPS/Text/chapter9.xhtml pending
S013 第1章:1.3.3 聚合与聚合根、聚合内部实体 OEBPS/Text/chapter10.xhtml pending
S014 第1章:1.3.4 聚合的整体与局部 OEBPS/Text/chapter11.xhtml pending
S015 第1章:1.3.5 聚合是数据修改的单元 OEBPS/Text/chapter12.xhtml pending
S016 第1章:1.3.6 聚合分析是“拆分”的基础 OEBPS/Text/chapter13.xhtml pending
S017 第1章:1.3.7 服务 OEBPS/Text/chapter14.xhtml pending
S018 第1章:1.4 战略层面的关键概念 OEBPS/Text/chapter15.xhtml pending
S019 第1章:1.4.1 限界上下文 OEBPS/Text/chapter16.xhtml pending
S020 第1章:1.4.2 限界上下文与微服务 OEBPS/Text/chapter17.xhtml pending
S021 第1章:1.4.3 防腐层 OEBPS/Text/chapter18.xhtml pending
S022 第1章:1.4.4 统一语言 OEBPS/Text/chapter19.xhtml pending
S023 第1章:1.5 ER模型、OO模型和关系模型 OEBPS/Text/chapter20.xhtml pending
S024 第1章:1.6 概念建模与模型范式 OEBPS/Text/chapter21.xhtml pending
S025 第2章:第2章 其他DDD相关概念 OEBPS/Text/chapter22.xhtml pending
S026 第2章:2.1 领域ID OEBPS/Text/chapter23.xhtml pending
S027 第2章:2.1.1 自然键与代理键 OEBPS/Text/chapter24.xhtml pending
S028 第2章:2.1.2 DDD实体的ID需要被最终用户看到 OEBPS/Text/chapter25.xhtml pending
S029 第2章:2.1.3 什么时候使用代理键 OEBPS/Text/chapter26.xhtml pending
S030 第2章:2.2 ID、Local OEBPS/Text/chapter27.xhtml pending
S031 第2章:2.3 命令、事件与状态 OEBPS/Text/chapter28.xhtml pending
S032 第3章:第3章 CQRS与Event OEBPS/Text/chapter29.xhtml pending
S033 第3章:3.1 命令查询职责分离 OEBPS/Text/chapter30.xhtml pending
S034 第3章:3.2 事件溯源 OEBPS/Text/chapter31.xhtml pending
S035 第3章:3.3 From-Thru模式 OEBPS/Text/chapter32.xhtml pending
S036 第3章:3.3.1 示例:ProductPrice OEBPS/Text/chapter33.xhtml pending
S037 第3章:3.3.2 示例:PartyRelationship OEBPS/Text/chapter34.xhtml pending
S038 第3章:3.4 CQRS、ES与流处理 OEBPS/Text/chapter35.xhtml pending
S040 第4章:第4章 DDD的DSL是什么 OEBPS/Text/chapter37.xhtml pending
S041 第4章:4.1 为什么DDD需要DSL OEBPS/Text/chapter38.xhtml pending
S042 第4章:4.1.1 为什么实现DDD那么难 OEBPS/Text/chapter39.xhtml pending
S043 第4章:4.1.2 搞定DDD的“锤子”在哪里 OEBPS/Text/chapter40.xhtml pending
S044 第4章:4.2 需要什么样的DSL OEBPS/Text/chapter41.xhtml pending
S045 第4章:4.2.1 在“信仰”上保持中立 OEBPS/Text/chapter42.xhtml pending
S046 第4章:4.2.2 DDD原生 OEBPS/Text/chapter43.xhtml pending
S047 第4章:4.2.3 在复杂和简单中平衡 OEBPS/Text/chapter44.xhtml pending
S048 第4章:4.2.4 通过DSL重塑软件开发过程 OEBPS/Text/chapter45.xhtml pending
S049 第4章:4.3 DDDML——DDD的DSL OEBPS/Text/chapter46.xhtml pending
S050 第4章:4.3.1 DDDML的词汇表 OEBPS/Text/chapter47.xhtml pending
S051 第4章:4.3.2 DDDML的Schema OEBPS/Text/chapter48.xhtml pending
S052 第4章:4.4 DDDML示例:Car OEBPS/Text/chapter49.xhtml pending
S053 第4章:4.4.1 “对象”的名称在哪里 OEBPS/Text/chapter50.xhtml pending
S054 第4章:4.4.2 使用两种命名风格:camelCase与PascalCase OEBPS/Text/chapter51.xhtml pending
S055 第4章:4.4.3 为何引入关键字itemType OEBPS/Text/chapter52.xhtml pending
S056 第5章:第5章 限界上下文 OEBPS/Text/chapter53.xhtml pending
S057 第5章:5.1 DDDML文档的根结点下有什么 OEBPS/Text/chapter54.xhtml pending
S058 第5章:5.2 限界上下文的配置 OEBPS/Text/chapter55.xhtml pending
S059 第5章:5.3 名称空间 OEBPS/Text/chapter56.xhtml pending
S060 第5章:5.3.1 再谈PascalCase命名风格 OEBPS/Text/chapter57.xhtml pending
S061 第5章:5.3.2 注意两个字母的首字母缩写词 OEBPS/Text/chapter58.xhtml pending
S062 第5章:5.4 关于模块 OEBPS/Text/chapter59.xhtml pending
S063 第6章:第6章 值对象 OEBPS/Text/chapter60.xhtml pending
S064 第6章:6.1 领域基础类型 OEBPS/Text/chapter61.xhtml pending
S065 第6章:6.1.1 例子:从OFBiz借鉴过来的类型系统 OEBPS/Text/chapter62.xhtml pending
S066 第6章:6.1.2 例子:任务的触发器 OEBPS/Text/chapter63.xhtml pending
S067 第6章:6.2 数据值对象 OEBPS/Text/chapter64.xhtml pending
S068 第6章:6.3 枚举对象 OEBPS/Text/chapter65.xhtml pending
S069 第7章:第7章 聚合与实体 OEBPS/Text/chapter66.xhtml pending
S070 第7章:7.1 用同一个结点描述聚合及聚合根 OEBPS/Text/chapter67.xhtml pending
S071 第7章:7.2 实体之间只有一种基本关系 OEBPS/Text/chapter68.xhtml pending
S072 第7章:7.3 关于实体的ID OEBPS/Text/chapter69.xhtml pending
S073 第7章:7.4 不变的实体 OEBPS/Text/chapter70.xhtml pending
S074 第7章:7.5 动态对象 OEBPS/Text/chapter71.xhtml pending
S075 第7章:7.6 继承与多态 OEBPS/Text/chapter72.xhtml pending
S076 第7章:7.6.1 使用关键字inheritedFrom OEBPS/Text/chapter73.xhtml pending
S077 第7章:7.6.2 超对象 OEBPS/Text/chapter74.xhtml pending
S078 第7章:7.7 引用 OEBPS/Text/chapter75.xhtml pending
S079 第7章:7.7.1 定义实体的引用 OEBPS/Text/chapter76.xhtml pending
S080 第7章:7.7.2 属性的类型与引用类型 OEBPS/Text/chapter77.xhtml pending
S081 第7章:7.8 基本属性与派生属性 OEBPS/Text/chapter78.xhtml pending
S082 第7章:7.8.1 类型为实体集合的派生属性 OEBPS/Text/chapter79.xhtml pending
S083 第7章:7.8.2 类型为值对象的派生属性 OEBPS/Text/chapter80.xhtml pending
S084 第7章:7.9 约束 OEBPS/Text/chapter81.xhtml pending
S085 第7章:7.9.1 在实体层面的约束 OEBPS/Text/chapter82.xhtml pending
S086 第7章:7.9.2 在属性层面的约束 OEBPS/Text/chapter83.xhtml pending
S087 第7章:7.10 提供扩展点 OEBPS/Text/chapter84.xhtml pending
S088 第8章:第8章 超越数据模型 OEBPS/Text/chapter85.xhtml pending
S089 第8章:8.1 实体的方法 OEBPS/Text/chapter86.xhtml pending
S090 第8章:8.1.1 聚合根的方法 OEBPS/Text/chapter87.xhtml pending
S091 第8章:8.1.2 非聚合根实体的方法 OEBPS/Text/chapter88.xhtml pending
S092 第8章:8.1.3 属性的命令 OEBPS/Text/chapter89.xhtml pending
S093 第8章:8.1.4 命令ID与请求者ID OEBPS/Text/chapter90.xhtml pending
S094 第8章:8.2 记录业务逻辑 OEBPS/Text/chapter91.xhtml pending
S095 第8章:8.2.1 关于accountingQuantityTypes OEBPS/Text/chapter92.xhtml pending
S096 第8章:8.2.2 关于derivationLogic OEBPS/Text/chapter93.xhtml pending
S097 第8章:8.2.3 关于filter OEBPS/Text/chapter94.xhtml pending
S098 第8章:8.2.4 使用关键字referenceFilter OEBPS/Text/chapter95.xhtml pending
S099 第8章:8.2.5 业务逻辑代码中的变量 OEBPS/Text/chapter96.xhtml pending
S100 第8章:8.2.6 说说区块链 OEBPS/Text/chapter97.xhtml pending
S101 第8章:8.3 领域服务 OEBPS/Text/chapter98.xhtml pending
S102 第8章:8.4 在方法定义中使用关键字inheritedFrom OEBPS/Text/chapter99.xhtml pending
S103 第8章:8.5 方法的安全性 OEBPS/Text/chapter100.xhtml pending
S104 第9章:第9章 模式 OEBPS/Text/chapter101.xhtml pending
S105 第9章:9.1 账务模式 OEBPS/Text/chapter102.xhtml pending
S106 第9章:9.2 状态机模式 OEBPS/Text/chapter103.xhtml pending
S107 第9章:9.3 树结构模式 OEBPS/Text/chapter104.xhtml pending
S108 第9章:9.3.1 简单的树 OEBPS/Text/chapter105.xhtml pending
S109 第9章:9.3.2 使用关键字structureType OEBPS/Text/chapter106.xhtml pending
S110 第9章:9.3.3 使用关键字structureTypeFilter OEBPS/Text/chapter107.xhtml pending
S112 第10章:第10章 处理限界上下文与值对象 OEBPS/Text/chapter109.xhtml pending
S113 第10章:10.1 项目文件 OEBPS/Text/chapter110.xhtml pending
S114 第10章:10.2 处理值对象 OEBPS/Text/chapter111.xhtml pending
S115 第10章:10.2.1 一个需要处理的数据值对象示例 OEBPS/Text/chapter112.xhtml pending
S116 第10章:10.2.2 使用Hibernate存储数据值对象 OEBPS/Text/chapter113.xhtml pending
S117 第10章:10.2.3 处理值对象的集合 OEBPS/Text/chapter114.xhtml pending
S118 第10章:10.2.4 在URL中使用数据值对象 OEBPS/Text/chapter115.xhtml pending
S119 第10章:10.2.5 处理领域基础类型 OEBPS/Text/chapter116.xhtml pending
S120 第11章:第11章 处理聚合与实体 OEBPS/Text/chapter117.xhtml pending
S121 第11章:11.1 生成聚合的代码 OEBPS/Text/chapter118.xhtml pending
S122 第11章:11.1.1 接口 OEBPS/Text/chapter119.xhtml pending
S123 第11章:11.1.2 代码中的命名问题 OEBPS/Text/chapter120.xhtml pending
S124 第11章:11.1.3 接口的实现 OEBPS/Text/chapter121.xhtml pending
S125 第11章:11.1.4 事件存储与持久化 OEBPS/Text/chapter122.xhtml pending
S126 第11章:11.1.5 使用Validation框架 OEBPS/Text/chapter123.xhtml pending
S127 第11章:11.1.6 保证静态方法与模型同步更新 OEBPS/Text/chapter124.xhtml pending
S128 第11章:11.1.7 不使用事件溯源 OEBPS/Text/chapter125.xhtml pending
S129 第11章:11.2 Override聚合对象的方法 OEBPS/Text/chapter126.xhtml pending
S130 第11章:11.3 处理继承 OEBPS/Text/chapter127.xhtml pending
S131 第11章:11.3.1 TPCH OEBPS/Text/chapter128.xhtml pending
S132 第11章:11.3.2 TPCC OEBPS/Text/chapter129.xhtml pending
S133 第11章:11.3.3 TPS OEBPS/Text/chapter130.xhtml pending
S134 第11章:11.4 处理模式 OEBPS/Text/chapter131.xhtml pending
S135 第11章:11.4.1 处理账务模式 OEBPS/Text/chapter132.xhtml pending
S136 第11章:11.4.2 处理状态机模式 OEBPS/Text/chapter133.xhtml pending
S137 第12章:第12章 处理领域服务 OEBPS/Text/chapter134.xhtml pending
S138 第12章:12.1 处理数据的一致性 OEBPS/Text/chapter135.xhtml pending
S139 第12章:12.1.1 使用数据库事务实现一致性 OEBPS/Text/chapter136.xhtml pending
S140 第12章:12.1.2 使用Saga实现最终一致性 OEBPS/Text/chapter137.xhtml pending
S141 第12章:12.2 发布与处理领域事件 OEBPS/Text/chapter138.xhtml pending
S142 第12章:12.2.1 编写DDDML文档 OEBPS/Text/chapter139.xhtml pending
S143 第12章:12.2.2 生成的事件发布代码 OEBPS/Text/chapter140.xhtml pending
S144 第12章:12.2.3 编写生产端聚合的业务逻辑 OEBPS/Text/chapter141.xhtml pending
S145 第12章:12.2.4 实现消费端领域事件的处理 OEBPS/Text/chapter143.xhtml pending
S146 第12章:12.3 支持基于编制的Saga OEBPS/Text/chapter144.xhtml pending
S147 第12章:12.3.1 编写DDDML文档 OEBPS/Text/chapter145.xhtml pending
S148 第12章:12.3.2 生成的Saga命令处理代码 OEBPS/Text/chapter146.xhtml pending
S149 第12章:12.3.3 需要我们编写的Saga代码 OEBPS/Text/chapter147.xhtml pending
S150 第12章:12.3.4 需要我们实现的实体方法 OEBPS/Text/chapter147-1.xhtml pending
S151 第13章:第13章 RESTful OEBPS/Text/chapter148.xhtml pending
S152 第13章:13.1 RESTful OEBPS/Text/chapter149.xhtml pending
S153 第13章:13.1.1 没有必要绞尽脑汁地寻找名词 OEBPS/Text/chapter150.xhtml pending
S154 第13章:13.1.2 尽可能使用HTTP作为封包 OEBPS/Text/chapter151.xhtml pending
S155 第13章:13.1.3 异常处理 OEBPS/Text/chapter152.xhtml pending
S156 第13章:13.2 聚合的RESTful OEBPS/Text/chapter153.xhtml pending
S157 第13章:13.2.1 GET OEBPS/Text/chapter154.xhtml pending
S158 第13章:13.2.2 PUT OEBPS/Text/chapter155.xhtml pending
S159 第13章:13.2.3 PATCH OEBPS/Text/chapter156.xhtml pending
S160 第13章:13.2.4 DELETE OEBPS/Text/chapter157.xhtml pending
S161 第13章:13.2.5 POST OEBPS/Text/chapter158.xhtml pending
S162 第13章:13.2.6 事件溯源API OEBPS/Text/chapter159.xhtml pending
S163 第13章:13.2.7 树的查询接口 OEBPS/Text/chapter160.xhtml pending
S164 第13章:13.3 服务的RESTful OEBPS/Text/chapter161.xhtml pending
S165 第13章:13.4 身份与访问管理 OEBPS/Text/chapter162.xhtml pending
S166 第13章:13.4.1 获取OAuth OEBPS/Text/chapter163.xhtml pending
S167 第13章:13.4.2 在资源服务器上处理授权 OEBPS/Text/chapter164.xhtml pending
S168 第13章:13.5 生成Client OEBPS/Text/chapter165.xhtml pending
S169 第13章:13.5.1 创建聚合实例 OEBPS/Text/chapter166.xhtml pending
S170 第13章:13.5.2 更新聚合实例 OEBPS/Text/chapter167.xhtml pending
S171 第13章:13.5.3 使用Retrofit2 OEBPS/Text/chapter168.xhtml pending
S172 第14章:第14章 直达UI OEBPS/Text/chapter169.xhtml pending
S173 第14章:14.1 两条路线的斗争 OEBPS/Text/chapter170.xhtml pending
S174 第14章:14.1.1 前端“知道”领域模型 OEBPS/Text/chapter171.xhtml pending
S175 第14章:14.1.2 前端“只知道”RESTful OEBPS/Text/chapter172.xhtml pending
S176 第14章:14.2 生成Admin OEBPS/Text/chapter173.xhtml pending
S177 第14章:14.2.1 使用referenceFilter OEBPS/Text/chapter174.xhtml pending
S178 第14章:14.2.2 展示派生的实体集合属性 OEBPS/Text/chapter175.xhtml pending
S179 第14章:14.2.3 使用属性层面的约束 OEBPS/Text/chapter176.xhtml pending
S180 第14章:14.2.4 使用UI层元数据 OEBPS/Text/chapter177.xhtml pending
S181 第14章:14.2.5 构建更实时的应用 OEBPS/Text/chapter178.xhtml pending
S183 第15章:第15章 找回敏捷的软件设计 OEBPS/Text/chapter180.xhtml pending
S184 第15章:15.1 重构不是万能灵药 OEBPS/Text/chapter181.xhtml pending
S185 第15章:15.2 数据建模示例:订单的装运与支付 OEBPS/Text/chapter182.xhtml pending
S186 第15章:15.2.1 订单与订单行项 OEBPS/Text/chapter183.xhtml pending
S187 第15章:15.2.2 订单与订单装运组 OEBPS/Text/chapter184.xhtml pending
S188 第15章:15.2.3 订单与装运单 OEBPS/Text/chapter185.xhtml pending
S189 第15章:15.2.4 订单的项目发货 OEBPS/Text/chapter186.xhtml pending
S190 第15章:15.2.5 订单的支付 OEBPS/Text/chapter187.xhtml pending
S191 第15章:15.3 中台是一个轮回 OEBPS/Text/chapter188.xhtml pending
S192 第15章:15.4 实例化需求与行为驱动测试 OEBPS/Text/chapter189.xhtml pending
S193 第15章:15.4.1 什么是实例化需求 OEBPS/Text/chapter190.xhtml pending
S194 第15章:15.4.2 BDD工具 OEBPS/Text/chapter191.xhtml pending
S195 第15章:15.4.3 BDD工具应与DDD相得益彰 OEBPS/Text/chapter192.xhtml pending
S196 第15章:15.4.4 不要在验收测试中使用固件数据 OEBPS/Text/chapter193.xhtml pending
S197 第15章:15.4.5 制造“制造数据”的工具 OEBPS/Text/chapter194.xhtml pending
S198 第15章:15.5 要领域模型驱动,不要UI驱动 OEBPS/Text/chapter195.xhtml pending
S199 第15章:15.6 不要用“我”的视角设计核心模型 OEBPS/Text/chapter196.xhtml pending
S200 第15章:15.6.1 让User消失 OEBPS/Text/chapter197.xhtml pending
S201 第15章:15.6.2 认识一下Party OEBPS/Text/chapter198.xhtml pending
S202 第15章:15.7 我们想要的敏捷设计 OEBPS/Text/chapter199.xhtml pending
S203 第16章:第16章 说说SaaS OEBPS/Text/chapter200.xhtml pending
S204 第16章:16.1 何为SaaS OEBPS/Text/chapter201.xhtml pending
S205 第16章:16.2 多租户技术 OEBPS/Text/chapter202.xhtml pending
S206 第16章:16.3 构建成功的SaaS有何难 OEBPS/Text/chapter203.xhtml pending
S207 第16章:16.3.1 多租户系统的构建成本 OEBPS/Text/chapter204.xhtml pending
S208 第16章:16.3.2 难以满足的定制化需求 OEBPS/Text/chapter205.xhtml pending
S209 第16章:16.3.3 负重前行的传统软件公司 OEBPS/Text/chapter206.xhtml pending
S210 第16章:16.4 SaaS需要DDD OEBPS/Text/chapter207.xhtml pending
S211 第17章:第17章 更好的“锤子” OEBPS/Text/chapter208.xhtml pending
S212 第17章:17.1 我们制作的一个DDDML OEBPS/Text/chapter209.xhtml pending
S213 第17章:17.1.1 给领域建模提供起点 OEBPS/Text/chapter210.xhtml pending
S214 第17章:17.1.2 创建新的限界上下文 OEBPS/Text/chapter211.xhtml pending
S215 第17章:17.1.3 从OFBiz中“借鉴”数据模型 OEBPS/Text/chapter212.xhtml pending
S216 第17章:17.1.4 构建项目并运行应用 OEBPS/Text/chapter213.xhtml pending
S217 第17章:17.1.5 使用HTTP OEBPS/Text/chapter214.xhtml pending
S218 第17章:17.1.6 给聚合增加方法 OEBPS/Text/chapter215.xhtml pending
S219 第17章:17.1.7 生成限界上下文的Demo OEBPS/Text/chapter216.xhtml pending
S220 第17章:17.1.8 让不同层级的开发人员各尽其能 OEBPS/Text/chapter217.xhtml pending
S221 第17章:17.2 以统一语言建模 OEBPS/Text/chapter218.xhtml pending
S222 附录:附录 DDDML示例与缩写表 OEBPS/Text/chapter219.xhtml pending

非正文排除

spine项 类型 排除理由
0 / titlepage / titlepage.xhtml 封面 只有 Cover 字样和封面元素,无正文论述
1 / copyright.xhtml / OEBPS/Text/copyright.xhtml 版权页 只有书目、版权与客服信息,无论述
2 / content / OEBPS/Text/content.html 目录 通篇列出前言、部分、章和节标题,无展开内容
4 / chapter1.xhtml / OEBPS/Text/chapter1.xhtml 部分题页 仅列第一部分标题与所含章节
39 / chapter36.xhtml / OEBPS/Text/chapter36.xhtml 部分题页 仅列第二部分标题与所含章节
111 / chapter108.xhtml / OEBPS/Text/chapter108.xhtml 部分题页 仅列第三部分标题与所含章节
182 / chapter179.xhtml / OEBPS/Text/chapter179.xhtml 部分题页 仅列第四部分标题与所含章节

待关联术语

术语名 出现章节 一句话语境
Repository(存储库) 14、117 第14项仅提及;第117项说明它以聚合为整体,与实体 DAO 区分。
Factory(工厂) 14 与领域服务并列提及的 DDD 战术概念,本项未展开定义。

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境
人月神话 书 15 原文指出该书强调软件概念完整性,未在此展开其论证。
领域驱动设计精简版 书 15 原文指出其第5章讨论战略设计,此处仅作为延伸阅读。
JSON Merge Patch(RFC 7386) 论文 117 用作比较静态类型的 MergePatchCar 命令如何区分置空与不修改。
实现领域驱动设计 书 117 作者说明聚合生成代码结构受该书示例项目影响。
lokad-iddd-sample 源码项目 117 作者说明生成代码结构受该示例项目影响。
Eventuate Tram 框架 136 本节说明生成代码用它发布领域事件,称其用于可靠的事务性消息通信;未展开实现机制。
Eventuate Tram Saga 框架 141 本节仅把它作为支持 DSL 的编制式 Saga 框架示例。
Apache CXF 框架 151 作为支持 JAX-RS 的 RESTful Services 实现框架被提及;本节未展开其内部机制。
Specification by Example(Gojko Adzic) 书 186 本节仅引作实例化需求方法的背景书目,具体方法由后文展开。
数据模型资源手册(卷1–3) 书 193、207 第193项提及卷1对旁观者视角的启发;第207项概述三卷分别讨论通用模型、行业专门化和建模模式。
OFBiz 源码项目 193、207 第193项提及数据模型启发;第207项说明 Builder 可搜索、转换其中的数据模型。

主题索引维护

卡片标题 结论(已复用/已创建/无需加入/待复核) 主题文件或原因
领域模型是有选择的抽象 已复用 notes/_topics/domain-modeling-analysis.md
领域模型需要严格表达 已复用 notes/_topics/modeling-purpose-notation.md
模型驱动的测试更稳定 已复用 notes/_topics/testing-effectiveness.md
命名困难源于职责未明 已复用 notes/_topics/code-readability.md
逐步求精先定高层结构 已复用 notes/_topics/domain-modeling-analysis.md
同一模型连接分析与设计 已复用 notes/_topics/domain-modeling-analysis.md
切分问题限制概念关系 已复用 notes/_topics/ddd-strategic-design.md
模型与代码应保持映射 已复用 notes/_topics/model-implementation-separation.md
实体以标识延续身份 已复用 notes/_topics/ddd-tactical-modeling.md
值对象无标识且宜不可变 已复用 notes/_topics/ddd-tactical-modeling.md
领域类型封装原始值 已复用 notes/_topics/ddd-tactical-modeling.md
聚合根界定聚合的访问与生命周期 已复用 notes/_topics/ddd-tactical-modeling.md
聚合内部实体可使用局部标识 已复用 notes/_topics/ddd-tactical-modeling.md
用强一致性要求划定聚合边界 已复用 notes/_topics/ddd-tactical-modeling.md
聚合内外的一致性选择 已复用 notes/_topics/ddd-tactical-modeling.md
聚合边界为拆分提供依据 已复用 notes/_topics/microservice-boundaries-evolution.md
先分析一致性边界再编码 已复用 notes/_topics/ddd-tactical-modeling.md
聚合关系可生成读模型 已复用 notes/_topics/cqrs-read-write-models.md
跨聚合行为宜由领域服务承担 已复用 notes/_topics/domain-logic-organization.md
概念完整性让模型保持一致 已复用 notes/_topics/ddd-strategic-design.md
限界上下文界定模型语义 已复用 notes/_topics/ddd-strategic-design.md
上下文大小取决于语义掌控力 已复用 notes/_topics/ddd-strategic-design.md
限界上下文不等于微服务 已复用 notes/_topics/ddd-strategic-design.md
防腐层翻译上下文概念 已复用 notes/_topics/ddd-strategic-design.md
端口和适配器隔离外部系统 已复用 notes/_topics/layered-architecture-ports.md
统一语言贯穿沟通与代码 已复用 notes/_topics/ddd-strategic-design.md

| 关系模型的基本术语 | 已复用 | notes/_topics/relational-model-foundations.md | | 同一关系可由不同模型表达 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 概念建模不依赖模型范式 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 自然键与代理键的语义区别 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 领域ID应进入领域讨论 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 标识生成方式不决定业务角色 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 代理主键不能替代业务唯一键 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 业务键变更仍需跨系统核对 | 已复用 | notes/_topics/model-implementation-separation.md | | 代理键优化应延后评估 | 已复用 | notes/_topics/model-implementation-separation.md | | 局部ID和全局ID分属不同范围 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 命令事件状态表达不同时态 | 无需加入 | 现有主题侧重事件消息或状态图,未覆盖命令、事件与状态三种时态语义 | | 聚合内部修改仍是聚合命令 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 命令一词有广义狭义 | 已复用 | notes/_topics/cqrs-read-write-models.md | | CQRS和事件溯源解决不同问题 | 已复用 | notes/_topics/cqrs-read-write-models.md | | CQRS分离读写概念模型 | 已复用 | notes/_topics/cqrs-read-write-models.md | | 数据库复制不等于CQRS | 已复用 | notes/_topics/cqrs-read-write-models.md | | 事件序列可重建历史状态 | 无需加入 | 现有事件日志主题侧重系统集成与消息代理,未覆盖用领域事件重放聚合状态 | | 事件追加驱动查询模型更新 | 已复用 | notes/_topics/dataflow-unbundled-databases.md | | From-Thru记录有效期 | 无需加入 | 现有数据库设计主题未覆盖有效时间区间和历史版本建模 | | 当前价格模型的两种维护方式 | 已复用 | notes/_topics/cqrs-read-write-models.md | | Party抽象业务参与者 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 事件溯源与流处理意图不同 | 无需加入 | 现有流处理主题侧重窗口与背压,未覆盖其与事件溯源的意图区分 | | DSL面向特定应用领域 | 已复用 | notes/_topics/modeling-purpose-notation.md | | DDDML以DOM为核心 | 已复用 | notes/_topics/modeling-purpose-notation.md | | DDD落地需连接模型与实现 | 已复用 | notes/_topics/model-implementation-separation.md |

| DDD原生DSL约束模型映射 | 已复用 | notes/_topics/model-implementation-separation.md | | DSL集中记录并派生模型产物 | 已复用 | notes/_topics/model-implementation-separation.md | | DDD建模语言保持技术中立 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 从概念模型生成代码保留领域结构 | 已复用 | notes/_topics/model-implementation-separation.md | | DSL表达能力需权衡复杂度 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 用带位置的中间对象表达有序集合 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | DDDML模型独立于文本格式 | 已复用 | notes/_topics/modeling-purpose-notation.md | | DDDML与JSON类型异名 | 已复用 | notes/_topics/modeling-purpose-notation.md | | Schema校验DDDML文档 | 已复用 | notes/_topics/modeling-purpose-notation.md | | Car聚合用嵌套结构表示边界 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 聚合方法成功后产生领域事件 | 无需加入 | 现有领域事件主题聚焦跨聚合和跨服务一致性,未覆盖聚合方法成功与事件生成的先后关系 | | Map键即模型元素名 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 命名风格区分关键字与领域名 | 已复用 | notes/_topics/modeling-purpose-notation.md | | itemType依位置定语义 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 限界上下文项目目录汇集模型文件 | 已复用 | notes/_topics/ddd-strategic-design.md | | 同上下文模型路径不重复 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 根层与聚合内值对象的作用域不同 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 上下文配置区分领域与实现 | 已复用 | notes/_topics/model-implementation-separation.md | | 数量运算模板映射目标语言 | 已复用 | notes/_topics/model-implementation-separation.md | | 上下文类型与成员分别命名 | 已复用 | notes/_topics/ddd-strategic-design.md | | 首字母缩写词转换需按词组切分 | 已复用 | notes/_topics/code-readability.md | | 缩写属性须核对序列化映射 | 无需加入 | 现有主题未覆盖缩写词属性名与 JSON 序列化的往返映射 | | 模块分组不强制映射命名空间 | 无需加入 | 现有主题未覆盖 DDDML 模块属性与目标语言命名空间之间的可选映射 | | 模块可作为微服务物理边界 | 已复用 | notes/_topics/microservice-boundaries-evolution.md | | 值对象按复用范围放置 | 已复用 | notes/_topics/ddd-tactical-modeling.md |

| 领域基础类型无预设原始类型 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 概念建模先记录关键业务逻辑 | 已复用 | notes/_topics/model-implementation-separation.md | | 领域基础类型映射到多种实现类型 | 已复用 | notes/_topics/model-implementation-separation.md | | Trigger伪代码渐进实现 | 已复用 | notes/_topics/model-implementation-separation.md | | 数据与复杂值对象的边界 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 枚举对象的作用域与代码生成方式 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 聚合与聚合根共用结点的取舍 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 聚合名不等于根实体名 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 外层实体持有直属内层实体 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 本地ID与全局ID的边界 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 复合ID列按外到内展开 | 已复用 | notes/_topics/object-relational-mapping.md | | 不可变实体仍有身份 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 动态属性与静态属性同层 | 无需加入 | 现有主题未覆盖动态实体属性的 API 展平、序列化与持久化约束 | | 继承模型与多态生成分开 | 已复用 | notes/_topics/model-implementation-separation.md | | 继承映射与区分值分设 | 已复用 | notes/_topics/object-relational-mapping.md | | 跨文档定义继承子类 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 超对象复用不要求同ID | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 布尔关键字让省略值合乎常态 | 无需加入 | 现有主题没有覆盖 DSL 布尔关键字的默认值命名规则 | | 值对象属性定位实体引用 | 已复用 | notes/_topics/object-relational-mapping.md | | 单属性与复合引用的写法 | 已复用 | notes/_topics/object-relational-mapping.md | | 引用声明不改属性类型 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 实体三种基本属性都不是派生属性 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 实体集合可由过滤和反向引用派生 | 已复用 | notes/_topics/model-implementation-separation.md | | 属性映射派生实体集合 | 已复用 | notes/_topics/model-implementation-separation.md | | 值对象派生属性分别定义读写逻辑 | 已复用 | notes/_topics/model-implementation-separation.md | | 约束维护数据不变性 | 已复用 | notes/_topics/ddd-tactical-modeling.md |

| 实体约束可校验多数量字段 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 属性约束引用命名模式 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 实体元数据覆盖上下文默认 | 已复用 | notes/_topics/model-implementation-separation.md | | 领域建模还需描述动态行为 | 已复用 | notes/_topics/domain-logic-organization.md | | 业务行为依一致性范围分配 | 已复用 | notes/_topics/domain-logic-organization.md | | eventName标注可能事件 | 已复用 | notes/_topics/domain-events-eventual-consistency.md | | 聚合方法区分业务与技术参数 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 实体实例方法限定单实体状态修改 | 已复用 | notes/_topics/domain-logic-organization.md | | 非根实体方法仍作为聚合命令调用 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 属性命令隔离状态修改入口 | 已复用 | notes/_topics/domain-logic-organization.md | | 命令ID用于识别重复调用 | 已复用 | notes/_topics/rpc-retry-timeouts.md | | 业务逻辑关键字按模型位置放置 | 已复用 | notes/_topics/domain-logic-organization.md | | 账目余额可由分录金额派生 | 无需加入 | 现有数据流主题聚焦跨系统事件日志,未覆盖账目余额由分录派生的账务建模 | | 引用过滤器限定目标实体 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 业务逻辑模板变量由工具解释 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 命令校验变更再验证状态 | 已复用 | notes/_topics/domain-logic-organization.md | | 跨聚合行为定义为服务方法 | 已复用 | notes/_topics/domain-logic-organization.md | | 服务方法可继承已有方法参数 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 方法授权允许角色或权限择一 | 已复用 | notes/_topics/least-privilege-access-control.md | | 模式把重复问题映射到可复用方案 | 无需加入 | 现有模式语言主题侧重 Alexander 的生成系统,未覆盖 DDDML 声明式领域模式 | | 账目以不可变条目追溯数量变化 | 无需加入 | 现有主题未覆盖以不可变账目分录追溯业务数量变化的账务模型 | | 库存账目映射到分录变化字段 | 无需加入 | 现有主题未覆盖库存多账目与分录变化字段的映射 | | 来源事件唯一约束防止重复分录 | 无需加入 | 现有主题未覆盖追加分录的业务来源唯一性与反转分录区分 | | 状态机用转换约束单据状态 | 已复用 | notes/_topics/state-activity-modeling.md |

| 守备条件区分同一触发的转换 | 已复用 | notes/_topics/state-activity-modeling.md | | 树结构表达实体层次关系 | 无需加入 | 现有主题未覆盖领域实体的树形层次关系 | | 简单树以父ID连接实体 | 无需加入 | 现有主题未覆盖以父 ID 表达业务实体简单树 | | 结构实体分离树结点内容 | 无需加入 | 现有主题未覆盖结点内容与多种组织树关系实体的分离 | | 关系树用子ID缺席识别根 | 无需加入 | 现有主题未覆盖结构关系树的根结点判定 | | 结构类型过滤限定树的关系 | 无需加入 | 现有主题未覆盖按结构类型过滤树关系 | | 静态生成代码显露模型映射 | 已复用 | notes/_topics/model-implementation-separation.md | | 领域基础类型需跨层映射 | 已复用 | notes/_topics/model-implementation-separation.md | | 项目文件确定限界上下文输入 | 已复用 | notes/_topics/ddd-strategic-design.md | | 数据值对象可按属性生成访问器 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 数据值对象可嵌套组合 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 复合业务属性可作为实体ID | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 可变值对象简化持久化接口 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 嵌套值对象可压平映射列 | 已复用 | notes/_topics/object-relational-mapping.md | | 值集合可用关联表持久化 | 已复用 | notes/_topics/object-relational-mapping.md | | 复合ID按属性顺序编码URL | 无需加入 | 现有主题未覆盖复合实体 ID 的 URL 路径双向编码协议 | | 领域基础类型映射到语言类型 | 已复用 | notes/_topics/model-implementation-separation.md | | Money持久化需拆出金额币种 | 已复用 | notes/_topics/object-relational-mapping.md | | Money序列化需双向适配 | 已复用 | notes/_topics/model-implementation-separation.md | | 时间值对象先辨明是否为时刻 | 无需加入 | 现有主题未覆盖日期、时间、时区与时刻的领域语义区分 | | 时区持久化需验证往返语义 | 已复用 | notes/_topics/object-relational-mapping.md | | 生成代码区分覆盖与特别化 | 已复用 | notes/_topics/model-implementation-separation.md | | 聚合核心隔离框架依赖 | 已复用 | notes/_topics/layered-architecture-ports.md | | 聚合先产事件再更新状态 | 无需加入 | 现有领域事件主题聚焦跨服务传播,未覆盖事件溯源聚合的事件生成与状态变更顺序 | | 状态接口分开读取与修改 | 已复用 | notes/_topics/solid-principles.md |

| 聚合内部状态集合按局部ID取值 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 聚合命令先校验生命周期状态 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 静态更新命令区分置空与不修改 | 无需加入 | 现有主题未覆盖静态局部更新命令中置空与未提交字段的区分 | | 内部实体命令事件服从聚合边界 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 命令与事件不必一一对应 | 已复用 | notes/_topics/domain-events-eventual-consistency.md | | 事件标识包含实体与版本 | 无需加入 | 现有事件日志主题未覆盖聚合根和内部实体事件的复合物理标识 | | 状态命令事件不应共用继承层级 | 已复用 | notes/_topics/model-implementation-separation.md | | 仓储以聚合为整体 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 仓储读取状态不应绕过聚合修改 | 已复用 | notes/_topics/cqrs-read-write-models.md | | 聚合根删除与内部实体移除不同 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 聚合命令命名须避开内部实体冲突 | 已复用 | notes/_topics/code-readability.md | | 聚合与实体名决定资源路径 | 已复用 | notes/_topics/rpc-rest-api.md | | 状态可由事件重放重建 | 无需加入 | 现有事件日志主题侧重消息代理,未覆盖聚合状态按领域事件重放重建 | | 懒加载合并勿删未加载实体 | 已复用 | notes/_topics/object-relational-mapping.md | | 自定义事件变更逻辑保持无状态 | 已复用 | notes/_topics/domain-logic-organization.md | | 懒加载集合的全量操作先取全量 | 已复用 | notes/_topics/object-relational-mapping.md | | 事件扩展属性可集中序列化存储 | 已复用 | notes/_topics/object-relational-mapping.md | | 内部实体事件继承外层命令上下文 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 命令去重须与版本策略配套 | 已复用 | notes/_topics/rpc-retry-timeouts.md | | 数据库模式也是设计文档 | 无需加入 | 现有数据库建模主题未覆盖把 Schema 用作团队设计文档的判断 | | 事件与当前状态须保持一致 | 无需加入 | 现有数据流主题侧重跨系统集成,未覆盖事件溯源中当前状态与事件的一致性 | | 复合事件键映射与读取 | 已复用 | notes/_topics/object-relational-mapping.md | | 内部实体读取核对聚合版本 | 已复用 | notes/_topics/object-relational-mapping.md | | 生成表名遵循覆盖优先级 | 已复用 | notes/_topics/object-relational-mapping.md | | 事件版本与状态版本错一位 | 已复用 | notes/_topics/object-relational-mapping.md | | 状态约束在持久化前验证 | 已复用 | notes/_topics/ddd-tactical-modeling.md |

| 手写静态逻辑须核对模型契约 | 已复用 | notes/_topics/model-implementation-separation.md | | 聚合可选择不生成事件溯源 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 实体方法只改一个聚合 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 扩展生成聚合的重写路径 | 已复用 | notes/_topics/model-implementation-separation.md | | TPCH以一张表映射继承树 | 已复用 | notes/_topics/object-relational-mapping.md | | TPCC按子类分表映射 | 已复用 | notes/_topics/object-relational-mapping.md | | TPS用子类表补充根表 | 已复用 | notes/_topics/object-relational-mapping.md | | 用分录合计核对库存余额 | 无需加入 | 现有主题未覆盖库存余额与分录合计的领域账务对账 | | 状态字段只由转换处理器改写 | 已复用 | notes/_topics/state-activity-modeling.md | | 跨聚合操作选择一致性模型 | 已复用 | notes/_topics/distributed-transactions.md | | 两类Saga对应不同代码支持 | 已复用 | notes/_topics/distributed-transactions.md | | 补偿库存调拨应逆转增量 | 已复用 | notes/_topics/distributed-transactions.md | | 长事务须同时处理重试与并发 | 已复用 | notes/_topics/distributed-transactions.md | | 同库跨聚合可用本地事务 | 已复用 | notes/_topics/distributed-transactions.md | | Saga用本地事务与补偿 | 已复用 | notes/_topics/distributed-transactions.md | | 协作式靠事件编制式靠协调者 | 已复用 | notes/_topics/distributed-transactions.md | | 内部消息代理归属单个上下文 | 已复用 | notes/_topics/ddd-strategic-design.md | | 伪事件表达请求而非状态事实 | 已复用 | notes/_topics/enterprise-integration-patterns.md | | 发布开关与处理器分别声明 | 已复用 | notes/_topics/domain-events-eventual-consistency.md | | 事件封包隔离消息框架 | 已复用 | notes/_topics/layered-architecture-ports.md | | 框架适配与模型映射分层生成 | 已复用 | notes/_topics/layered-architecture-ports.md | | 聚合事件持久化后进入发布回调 | 已复用 | notes/_topics/domain-events-eventual-consistency.md | | 事件消费者转为应用服务命令 | 已复用 | notes/_topics/domain-events-eventual-consistency.md | | 聚合变更逻辑无需处理事件发布 | 已复用 | notes/_topics/domain-logic-organization.md | | 库存Saga以单据状态补偿 | 已复用 | notes/_topics/distributed-transactions.md |

| 异步Saga查询须开启消息命令 | 已复用 | notes/_topics/distributed-transactions.md | | 内部Saga步骤不对外暴露 | 已复用 | notes/_topics/distributed-transactions.md | | 命令封包隔离消息框架 | 已复用 | notes/_topics/layered-architecture-ports.md | | Saga处理器只负责消息适配 | 已复用 | notes/_topics/enterprise-integration-patterns.md | | 命令分发器须注册处理器 | 已复用 | notes/_topics/enterprise-integration-patterns.md | | Saga数据保存跨步版本 | 已复用 | notes/_topics/distributed-transactions.md | | Saga管理器持久化执行实例 | 已复用 | notes/_topics/distributed-transactions.md | | 手写Saga定义暴露框架依赖 | 已复用 | notes/_topics/layered-architecture-ports.md | | 库存版本决定创建或补丁 | 已复用 | notes/_topics/distributed-transactions.md | | 负库存检查先于分录追加 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 分录序号向负方向分配 | 无需加入 | 现有主题未覆盖库存分录局部序号向负方向分配的具体约定 | | 单据状态动作复用生成状态机 | 已复用 | notes/_topics/state-activity-modeling.md | | 单行单据由创建事件组装 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | HTTP方法承载不同操作语义 | 已复用 | notes/_topics/rpc-rest-api.md | | 领域命令不必强凑资源名 | 已复用 | notes/_topics/rpc-rest-api.md | | 勿用业务封包掩盖HTTP状态 | 已复用 | notes/_topics/rpc-rest-api.md | | GET查询不应执行状态更新 | 已复用 | notes/_topics/rpc-rest-api.md | | 异常类别映射HTTP状态 | 已复用 | notes/_topics/rpc-rest-api.md | | DDDML生成多种HTTP入口 | 已复用 | notes/_topics/layered-architecture-ports.md | | 聚合列表查询条件 | 已复用 | notes/_topics/rpc-rest-api.md | | 分页封包字段 | 已复用 | notes/_topics/rpc-rest-api.md | | 聚合内实体读取路径 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 派生集合的读取接口 | 已复用 | notes/_topics/rpc-rest-api.md | | PUT命令校验路径ID | 已复用 | notes/_topics/rpc-rest-api.md | | 命令版本控制并发 | 无需加入 | 现有主题未覆盖聚合命令版本号与乐观并发控制的协议约定 |

| PATCH不等于合并补丁 | 已复用 | notes/_topics/rpc-rest-api.md | | 静态DTO标记字段删除 | 已复用 | notes/_topics/rpc-rest-api.md | | 删除命令元数据传参 | 已复用 | notes/_topics/rpc-rest-api.md | | POST创建两种ID模式 | 已复用 | notes/_topics/rpc-rest-api.md | | 事件与历史状态版本 | 已复用 | notes/_topics/rpc-rest-api.md | | 树节点查询以父级过滤 | 已复用 | notes/_topics/rpc-rest-api.md | | 服务方法默认用POST | 已复用 | notes/_topics/rpc-rest-api.md | | 身份声明与访问决策分离 | 已复用 | notes/_topics/least-privilege-access-control.md | | 令牌验证后做授权决策 | 已复用 | notes/_topics/auth-and-cryptography.md | | Bearer令牌获取示例 | 已复用 | notes/_topics/auth-and-cryptography.md | | JWT声明分标准与私有 | 已复用 | notes/_topics/auth-and-cryptography.md | | 权限声明映射资源入口 | 已复用 | notes/_topics/least-privilege-access-control.md | | 资源属性须参与授权 | 已复用 | notes/_topics/least-privilege-access-control.md | | 客户端SDK复用DTO契约 | 已复用 | notes/_topics/model-implementation-separation.md | | 嵌套创建命令序列化 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 嵌套更新混合命令 | 已复用 | notes/_topics/ddd-tactical-modeling.md | | Retrofit映射聚合API | 已复用 | notes/_topics/rpc-rest-api.md | | 领域模型与UI元数据分层 | 已复用 | notes/_topics/extensible-application-architecture.md | | DDDML前端映射流程 | 已复用 | notes/_topics/model-implementation-separation.md | | 从API路径推断聚合 | 已复用 | notes/_topics/rpc-rest-api.md | | DDDML元数据映射界面 | 已复用 | notes/_topics/extensible-application-architecture.md | | 引用过滤生成选择列表 | 已复用 | notes/_topics/extensible-application-architecture.md | | 派生集合驱动界面分组 | 已复用 | notes/_topics/extensible-application-architecture.md | | 属性约束驱动前端校验 | 已复用 | notes/_topics/extensible-application-architecture.md | | UI元数据指定控件映射 | 已复用 | notes/_topics/extensible-application-architecture.md |

| 命令后同步客户端状态 | 已复用 | notes/_topics/rpc-rest-api.md | | 复杂领域的设计节奏 | 已复用 | notes/_topics/iterative-process-tailoring.md | | 重构需要测试与设计 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 代码即文档仍需建模 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 订单布尔状态遮蔽履约 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 订单装运组表达分批发货 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 装运组与装运单分离 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 项目发货记录实际履约 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 订单发货状态应由事实派生 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 订单计费与支付分离 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 订单支付状态由分配派生 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 目标模型指导重构 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 限界上下文与服务边界 | 已复用 | notes/_topics/ddd-strategic-design.md | | 中台范围与防腐层取舍 | 已复用 | notes/_topics/ddd-strategic-design.md | | 实例化需求以例子协作 | 已复用 | notes/_topics/use-cases-requirements.md | | 活文档随验收测试更新 | 无需加入 | 现有需求表述主题未覆盖把实例化需求与自动化验收连接成活文档的维护机制 | | Gherkin场景表达验收行为 | 已复用 | notes/_topics/use-cases-requirements.md | | BDD需求与领域模型互补 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 固定固件数据使验收测试闪烁 | 已复用 | notes/_topics/testing-effectiveness.md | | 验收测试自行构造前置数据 | 已复用 | notes/_topics/testing-effectiveness.md | | 用业务命令制造验收数据 | 已复用 | notes/_topics/testing-effectiveness.md | | 状态模板转创建命令 | 已复用 | notes/_topics/testing-effectiveness.md | | 界面原型不能代替领域模型 | 已复用 | notes/_topics/domain-modeling-analysis.md | | SKU补丁蔓延暴露概念缺口 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 核心模型采用旁观者视角 | 已复用 | notes/_topics/domain-modeling-analysis.md |

| 业务参与方不等于系统用户 | 已复用 | notes/_topics/domain-modeling-analysis.md | | Party统一表示业务参与方 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 外部标识不宜充当PartyID | 已复用 | notes/_topics/ddd-tactical-modeling.md | | 业务角色与权限角色分离 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 关系实体记录参与方的上下文 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 敏捷设计贯通需求模型与代码 | 已复用 | notes/_topics/domain-modeling-analysis.md | | SaaS难点在服务化工程 | 无需加入 | 现有主题未覆盖 SaaS 持续交付与运营的总体工程难点 | | SaaS交付模式分摊使用成本 | 无需加入 | 现有主题未覆盖 SaaS 订阅交付模式的客户成本主张 | | 多租户共享组件隔离数据 | 已复用 | notes/_topics/multi-tenant-isolation.md | | 客户源码分叉抬高SaaS运维 | 已复用 | notes/_topics/multi-tenant-isolation.md | | 多租户前期投入换边际成本 | 已复用 | notes/_topics/multi-tenant-isolation.md | | 租户配置依赖领域抽象 | 已复用 | notes/_topics/reference-architecture-product-line.md | | 配置与PaaS扩展能力分层 | 已复用 | notes/_topics/extensible-application-architecture.md | | SaaS转型受存量交付牵制 | 已复用 | notes/_topics/business-driven-tech-evolution.md | | DDD分层拆分SaaS复杂性 | 已复用 | notes/_topics/ddd-strategic-design.md | | 领域模型驱动多端生成 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 领域模型可视化先于图形编辑 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 现成数据模型是建模起点 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 复用已验证配置创建项目 | 无需加入 | 现有主题未覆盖复用生成配置建立项目的具体操作与风险 | | 模型目录变更触发代码生成 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 旧模型导入须限制关联范围 | 已复用 | notes/_topics/domain-modeling-analysis.md | | 生成应用分阶段启动验证 | 已复用 | notes/_topics/testing-effectiveness.md | | PUT指定资源ID创建实体 | 已复用 | notes/_topics/rpc-rest-api.md | | 生成方法骨架仍须实现业务逻辑 | 已复用 | notes/_topics/domain-logic-organization.md | | 管理界面与API独立生成 | 已复用 | notes/_topics/modeling-purpose-notation.md | | 按业务逻辑复杂度分配开发职责 | 无需加入 | 现有主题未覆盖模型驱动开发中团队职责分配与人员能力边界 | | 按上下文维护领域词汇表 | 已复用 | notes/_topics/ddd-strategic-design.md |

当前 304 张知识卡的主题结论均已记录:269 张复用现有主题,35 张无需加入,0 张新建,0 张待复核。2026-10-20 按这些决定恢复本书 269 个主题成员后,247 个主题文件共有 15424 个成员;格式、去重与目标卡片全库校验为 0 错误。_workflow-s2-snapshot-20261019.json 是修订前历史快照,S4 语义复核与最终快照仍待完成。

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 建立卡片盒领域词汇表 真实任务 done 215 五词条表与命名评审结论
002 检验卡片盒聚合边界 证据验证 done 12 不变量表、候选边界图与失败情境分析

筛选说明:两项分别面向命名与一致性边界,能以本仓库真实对象形成可检查产物;“自行重写 DDDML 生成器”“完整重做 SaaS 平台”和仅跟随书中按钮操作的候选成本高或缺独立验证问题,未采用。以上均为待执行的实践计划,未执行现实行动。

类别清单核对

维度 覆盖状态(已覆盖/补充生成/未覆盖) 关联卡片标题或未覆盖理由
建模方法论/流程 已覆盖 [[逐步求精先定高层结构]]、[[敏捷设计贯通需求模型与代码]]
核心构建块/元语言 已覆盖 [[实体以标识延续身份]]、[[值对象无标识且宜不可变]]、[[聚合根界定聚合的访问与生命周期]]
边界划分原则 已覆盖 [[限界上下文界定模型语义]]、[[用强一致性要求划定聚合边界]]、[[聚合边界为拆分提供依据]]
模型与代码的映射关系 已覆盖 [[模型与代码应保持映射]]、[[静态生成代码显露模型映射]]
一致性与事务边界 已覆盖 [[聚合内外的一致性选择]]、[[跨聚合操作选择一致性模型]]
模型演化与重构 已覆盖 [[目标模型指导重构]]、[[重构需要测试与设计]]
反模式/常见建模误区 已覆盖 [[界面原型不能代替领域模型]]、[[聚合边界为拆分提供依据]];前者讨论以界面代替模型,后者讨论随意拆分聚合的代价,未把“贫血模型”或“上帝对象”强加为书中术语

相关主题

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

主题索引

微服务拆分与演进

比较微服务拆分的边界依据、粒度与非业务因素,以及从单体演进和持续重组的策略。

444 张卡片 · 71 本书

主题索引

聚合、实体与值对象

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

375 张卡片 · 17 本书

主题索引

测试有效性与验证手段

比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。

366 张卡片 · 63 本书

主题索引

领域划分与限界上下文

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

330 张卡片 · 31 本书

主题索引

分布式事务与一致性

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

308 张卡片 · 61 本书

主题索引

远程调用与REST设计

比较 RPC 要解决的基本问题与历代框架取舍,以及 REST 的资源抽象、统一接口、成熟度与局限。

303 张卡片 · 53 本书

主题索引

领域事件与最终一致性

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

263 张卡片 · 46 本书

主题索引

认证与密码学基础

比较 HTTP 认证方案、OAuth2 与 JWT、会话状态,以及摘要、加密、签名、证书与 TLS 的密码学基础。

253 张卡片 · 58 本书

主题索引

建模的用途与表示法边界

比较建模语言作为草稿、蓝图或编程语言的不同用途,以及表示法规则、元模型与版本演化的边界。

248 张卡片 · 29 本书

主题索引

领域建模与需求理解

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

212 张卡片 · 17 本书

主题索引

分层、洋葱与六边形架构

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

196 张卡片 · 43 本书

主题索引

事务与离线并发控制

系统事务的隔离与锁,以及跨越多个请求的业务事务如何用乐观/悲观离线锁、粗粒度锁和隐含锁保持一致。

188 张卡片 · 35 本书

主题索引

用例与需求表述

比较以用户目标组织需求的用例写法、粒度分层与特性粒度的取舍。

181 张卡片 · 25 本书

主题索引

最小特权与访问控制

比较最小权限、多方审批、紧急绕过与访问审计的设计取舍。

175 张卡片 · 72 本书

主题索引

可扩展应用与插件架构

比较以数据模型、扩展点与插件为核心的应用架构,如何在开放扩展与稳定性、安全性之间取舍。

173 张卡片 · 41 本书

主题索引

对象-关系映射模式

对象模型与关系数据库之间的映射:数据源架构、工作单元、标识映射、延迟加载、结构映射、元数据映射与查询。

155 张卡片 · 13 本书

主题索引

数据交换格式设计

比较数据交换格式的简洁性、互通性与安全解析要求。

146 张卡片 · 38 本书

主题索引

数据集成与分拆:一份真源与多份衍生

多个数据系统怎样连成一套:分拆数据库与读写路径、CDC 与日志捕获、双写与发件箱、数据共享与缓存复制、数据湖与湖仓分工、端到端正确性与可审计性。

103 张卡片 · 23 本书

主题索引

企业集成模式

比较管道过滤器、各类消息通道、命令/文档/事件消息结构、路由(内容、动态、分离聚合、分散聚集、处理过程管理器)、转换(封装、丰富、过滤、存放证、标准化、规范模型)与端点模式的适用场景和取舍。

99 张卡片 · 24 本书

主题索引

状态与活动建模

比较状态机与活动图在表达事件响应、并发、流程与责任划分上的用法。

93 张卡片 · 13 本书

主题索引

迭代开发与过程裁剪

比较迭代与预测式开发、时间盒与过程裁剪在不同需求稳定性下的适用性。

93 张卡片 · 26 本书

主题索引

CQRS与读写模型分离

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

88 张卡片 · 13 本书

主题索引

业务驱动的技术演进

比较业务规模与复杂度变化如何驱动技术选型和架构分阶段演进。

88 张卡片 · 37 本书

主题索引

SOLID设计原则

比较单一职责、开闭、里氏替换、接口隔离、依赖反转五原则的准确含义,及其从类层面扩展到架构层面的用法。

86 张卡片 · 12 本书

主题索引

业务事务与离线并发

业务事务比系统事务长得多,中间隔着用户思考时间:乐观离线锁与悲观离线锁怎么选、粗粒度锁与隐含锁的代价、版本号与条件更新怎样防止覆盖、预留与冻结怎样替代事后校验,以及离线并发为什么能免则免。

79 张卡片 · 28 本书

主题索引

模型与实现分离

比较逻辑模型与物理实现、值与变量、派生视图与存储结构之间的边界。

79 张卡片 · 13 本书

主题索引

领域逻辑的组织方式

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

78 张卡片 · 17 本书

主题索引

RPC重试与期限管理

比较远程调用在不同失败语义下的重试条件、幂等边界、总期限与目标节点选择。

61 张卡片 · 25 本书

主题索引

代码可读性与命名

比较命名、注释、变量提取与结构选择等降低阅读负担、让代码表达意图的做法。

57 张卡片 · 15 本书

主题索引

对象与关系的结构映射

对象与关系在粒度、继承、标识和关联上的阻抗不匹配:单表/类表/具体表三种继承映射的取舍,嵌入值与值集合怎样摊平或拆表,复合主键与关联表怎么写,命名与元数据怎样保持映射透明。

56 张卡片 · 7 本书

主题索引

数据库设计与E-R建模

比较数据库设计各阶段、数据抽象方法、E-R 模型的要素与集成冲突、向关系模型的转换规则,以及存取方法与重组织、重构的取舍。

56 张卡片 · 16 本书

主题索引

架构师与团队协作

比较架构师通过提问、请求协助、会议选择和答疑时间与开发团队协作的做法及边界。

44 张卡片 · 13 本书

主题索引

参考架构与产品线

比较参考架构与参考模型的抽象层次、参考架构的建立与评估,以及产品线架构中可变性管理、决策模型与产品衍生的方法。

42 张卡片 · 11 本书

主题索引

模式语言与复杂关系

比较 Alexander 的树与半格、模式语言与生成系统如何描述复杂关系,以及它们迁移到软件模式时的得失。

42 张卡片 · 6 本书

主题索引

多租户隔离与定制

比较多租户系统在数据隔离(共享表、分表、分库)、元数据定制与成熟度演进上的取舍。

41 张卡片 · 13 本书

主题索引

资源库与查询

资源库为什么取代 DAO、集合式接口怎样隐藏存取细节,规约与查询对象怎样表达条件而不泄漏表结构,加载深度、N+1 与懒加载的取舍,以及原生 SQL、类型化查询与查询构建器各自的边界。

31 张卡片 · 8 本书

主题索引

反射与运行时动态性

比较反射机制换取的动态能力及其可设置性约束和性能代价。

25 张卡片 · 9 本书

主题索引

关系模型的理论基础

比较关系模型的来源、精确定义、目标与基本原理,以及它与其他数据模型在理论根基上的差异。

13 张卡片 · 4 本书