研发效能 DDD 落地实践 - 架构师眼中的餐厅 | 京东云技术团队

京东云开发者 · 2024年01月03日 · 2600 次阅读

本文以餐厅场景为叙事主线,以领域驱动为核心思想,结合架构设计与功能设计方法论。是从领域分析到落地的全过程案例,内容偏重于落地,因此不乏一些探讨,欢迎指正。

文章较长、全程干货、耐心读完、必有收获。

本文不针对餐厅的实现细节,重在探讨设计思想和方法。

1、领域设计

让我们抛开技术人员的本能技术视角、站在纯业务视角来分析领域问题。

领域设计的核心是分而治之,目的是实现业务领域的自治性。

就像你平时不会将枕头和被子放在厨房或卫生间一样,你的床上不会放着大米白面,否则你想睡觉是一件很复杂的事情,软件系统也是如此,这就是我们要解决的问题。

1.1 宏观流程

假如我要设计一个餐厅,由于分而治之的需要,我会首先从宏观流程去分析,可以帮我们迅速找到重要的区域。

因此会得到几个明确的行为区域,我将餐厅划分为 “菜品域”,“订单域”,“厨房域”,“用餐域”,这是业务级别的领域划分,后续应该针对每个区域单独分析。

产出物是:宏观流程和参与角色

1.2 统一语言

语言贯穿于整个开发过程,从需求分析到设计、从设计到编码,因此好的语言非常重要,好的语言体现了清晰的业务概念。

在这个阶段,我们需要通过梳理,找到业务中都有哪些实体与行为,对其做一些归纳。我们的核心问题是:“谁” 通过什么 “行为” 影响了 “谁”,其中的三个要素分别是:角色、行为、实体。 我的建议是先找到 “实体”、“角色”、“行为”,并对其归类,我常常关注角色以及具体身份、实体以及实体实例,功能以及包含的重要步骤。

角色:是施事主语、是名词,是主动发起行为的一类实体。

行为:是动词、是做了什么事情,是行为本身。

实体:是名词,是除 “角色” 之外的其他实体。

推荐使用脑图画出来,我认为归纳后的脑图有助于我们识别根本要素。

产出物是:名词、概念定义、相关脑图。

1.3 用例分析

在这一步、我们不需要进入用例的细节分析,使用相对宏观的分析,掌握角色与行为之间的关系。

产出物:用例图

以做菜为例,如图

1.4 领域划分

我们在分析宏观流程时,划分了几个行为区域,但那是业务级别的。在那基础之上,我们需要拉进某个区域的视角,再结合之前的用例分析,按照 “功能相关性”、“角色相关性” 进一步划分领域。

功能相关性:任何业务都是由一套用例组成的,业务的某个领域也不例外,所以领域的划分应该以功能相关性为主,例如与做菜相关的用例都应该归属于厨房,所以我们确认了厨房域,这是很自然的事。

角色相关性:其次是角色,常用于划分子域,某个区域涉及多个角色参与,可以按照角色的分工,拆分为多个子域,从而满足不同角色的个性化需要。例如厨房的采购人员负责买菜、刀工负责切菜、大厨负责烹饪。我们就会考虑将厨房划分为 “采购域”、“加工域”、“烹饪域”。

通常来说,子域不具备独立的问题空间,不会作为独立的领域存在。

产出物:领域、子域

以厨房域为例,如图

1.5 领域建模

这是大家比较熟知的阶段,重点分析实体与领域之间关系(领域聚合),实体与实体的关系(OO 聚合)。

领域模型是实现功能的基石、需要有对功能的本质理解,才能找到最核心的实体,实体之间的 OO 聚合关系决定了功能的扩展性,OO 聚合是最重要的核心点。

组合、聚合

聚合(aggregation):聚合关系是一种弱的关系,整体和部分可以相互独立。

组合(composition):组合关系是一种强的整体和部分的关系,整体和部分具有相同的生命周期。

可以使用如下案例,既能表达领域聚合,又能表达 OO 聚合的关系。

产出物:聚合、实体、值对象、实体的属性

(领域服务和事件在后续的功能设计中提供)

1.6 领域上下游

领域上下游关系,不是领域的依赖关系,依赖关系指的是能力的依赖,是共用了某些能力,依赖关系是固定的。领域上下游关系,也不是调用关系,调用关系是与用例相关的,并非描述领域处境的。

领域上下游关系指的是影响力的关系,上游影响下游,影响力分为 “逻辑影响” 和 “数据影响”,一般说来我们更应该关注 “数据影响”,所以领域上下游关系是一种数据流向的限定,是业务发生的顺序限定,用于规定该领域所使用的数据,是下游领域依赖上游领域 “准备就绪” 的体现。合理的上下游限定,有助于减少领域之间的不必要依赖,有利于数据的复用并减少重复计算。

领域上下游是与场景相关的,并不是一成不变的,不同的场景存在不同的上下游,各场景应该独立说明。

产出物:各场景的上下游说明

例:在【菜品管理】场景下

如果厨房的某些食材不足了,或者某个厨师休假了,就会影响到菜品的展示,从而影响到客户的订单。

例:在【客户消费】场景下

客户的订单、影响厨房生产的菜,从而影响刀工的行为,也影响到了采购。

请对比下面两个图,用于理解领域的上下游

实际上,厨师不应该依赖采购人员的采购功能,也不依赖刀工的切菜功能,他只是依赖 “初加工食材” 而已,而 “初加工食材” 就是被处理好的数据,厨师在做饭时,“初加工食材” 就已经被处理好了,上面的图例只是为了说明一个关于领域上下游的问题,这是业务发生顺序以及数据来源的问题。

我们常常使用领域事件串联业务流程,在使用领域事件时,不止要关注点对点的解耦,更应该使业务流程符合领域上下游限定,让各个领域独立运行,减少领域之间的功能依赖,降低领域之间的耦合,减少业务变化带来的影响。

2、架构设计

架构设计是为了解决软件系统复杂度带来的问题,找到系统中的元素并搞清楚他们之间关系。

架构的目标是用于管理复杂性、易变性和不确定性,以确保在长期的系统演化过程中,一部分架构的变化不会对其它部分产生不必要的负面影响。这样做可以确保业务和研发效率的敏捷,让应用的易变部分能够频繁地变化,对应用的其它部分的影响尽可能地小。

架构设计三原则:合适原则、简单原则、演化原则

2.1 分层架构

我们需要按照 接口层、领域层(领域用例层、领域模型层)、依赖层、基础层 构建架构模型。

接口层:为外部提供服务的入口,是适配层的北向网关。不实现任何业务逻辑,也不处理事务,是跨领域的,是流程编排层,是门面服务。

领域用例层:是领域服务层,是领域用例的实现层、隶属于某个领域、是业务逻辑层,是事务层,业务逻辑应该在这层完整体现,不要分散到其他层级。

领域模型层:是领域模型(实体、值对象、聚合)的所在位置,专注于领域模型自身的能力,不包含业务功能,可以处理事务,是原子化的能力,是领域对象的自我实现

依赖层: 是连接外部服务的出口,是适配层的南向网关。包括仓储,端点、RPC 等,主要作用是领域和外部解耦,用于保持领域的独立性,是跨领域的。

基础层:与业务无关的,与领域无关的,通用的技术能力,技术组件等。

2.2 架构映射

架构的视角,从大到小依次是:系统->应用(微服务)->模块(包)->子模块 这样的从大到小的层级。

业务领域映射:我们将划分好的领域,按照对应的视角映射为对应的元素,领域模型映射到架构模型时,应该是视角对等的,如果餐厅是系统、那么厨房就是应用,如果餐厅是应用、那么厨房就是模块。也应该层级匹配的,将用例的实现映射到用例层,将领域模型的实现映射到领域模型层。

技术和抽象问题:有时候、业务领域分析不能体现那些共性的技术问题,所以需要适当结合技术视角,可能需要对领域模型微调。同时、我们需要找到共同需要的基础能力,例如 “水”、“电”、“煤气” 等等,将这些作为额外的考虑因素,要做到业务问题与技术问题解耦,不要将技术问题和业务逻辑揉成一团。

领域设计,类似餐厅设计师,他设计餐厅有几个区域,区域的用途是什么。

架构设计,类似建筑设计师,他设计如何走水电煤气、如何施工等。

产出物:分层架构图

以厨房为视角,其架构如下

以餐厅为视角,其架构如下

分层架构图,体现逻辑上的层级分布,而不是代表组件的具体含义,组件是应用还是模块、需要结合实际情况而定。

2.3 必要的约束

1、分层架构越往下层就越是稳定的:下层是被上层依赖的,下层不可以反向依赖上层(扩展点除外)。因为分层架构的核心原则是将容易变化的逻辑上浮,将共性的、原子化的、通用的逻辑下沉,被依赖的下层应该是稳定的,这要求上层承接更多业务变化。下层离开上层应该是可以独立存在的,例如在接口层定义的 DTO 不可以在下层被使用,但领域层定义的实体可以被上层使用。

2、在使用充血模型时,应该符合面向对象编程原则:不要随意的将一些能力都充到领域实体模型中。以 “菜” 为例,重量和规格是 “菜” 的自身的属性,激发味蕾是 “菜” 的能力,“菜” 可以维护自身的持久化状态。但是、请注意、“菜” 不可以 “炒菜”,因为 “炒菜” 的时候,“菜” 还没有出现呢,“菜” 不是自己的上帝,“菜” 需要被做出来,所以 “菜” 被做出来之前是没有 “菜” 的,这是个时间上的概念,不要错把 “炒菜” 的能力放在 “菜” 的身上。“炒菜” 用到的 “水 + 电 + 气 + 食材 + 调料 + 厨具” 不应该是 “菜” 的属性范围,这些元素都在 “厨房” 的范围中,不要让领域的模型包含不属于自身的元素,领域的实体模型只是领域的一部分,只用于实现通用的模型能力。

3、接口层和依赖层是与领域无关的:他们是与技术相关的层级,不属于任何领域,领域也不一定要有这两层,领域也可以独立拥有这两层,这两层不能包含业务逻辑。

4、领域层是与环境无关的:无论某个领域是应用还是模块,都应该具备独立的用例层和独立的模型层,即使多个领域在同一个应用当中,也要按照他们是分别独立去看待,无论是领域是应用还是模块,领域对外部的交互,不可以绕过依赖层和接口层。

5、领域应该是最小完备的:把一个领域拆分为子域、子子域、子子子,,,无限拆分,拆分到一定程度之后,某个子域就不完整了,不完整的子域是不可以独立存在的。拆分不不够或者过度拆分,都是不符合低耦合高内聚原则的。子域只是用于区分边界,所以同一个领域的子域之间不必严格解耦,不需要通过依赖层访问本领域的其他子域,他们之间可以直接调用。

6、领域服务层就是领域用例层:他们俩是同一回事儿,都是用于实现领域内的用例的。不要将领域服务与领域用例视为两个独立的层,也不要将领域服务与领域模型视为同一层,否则会导致逻辑的分散(一部分在领域服务层、一部分在领域模型层、还有一部分可能在用例层),也会导致每个层的职责不明确,容易搞乱。如果将业务逻辑写在领域模型中,会导致业务逻辑进一步下沉,业务逻辑的不确定性太大,是不适合下沉的,是违反分层架构原则的。领域模型对应的是实体、领域服务对应的是用例。

7、领域用例层只能承接符合自身领域的用例:我们划分出领域的目的,就是为了区分每个领域的职责所在,因此他们必须严格按照职责办事,我们在之前已明确了用例和领域之间的关系,需要严格遵守。

8、领域模型层遵循最小依赖原则:只可以依赖必要的资源,必要资源指的是领域模型实现自身能力需要的资源,不包括实现业务逻辑包含的资源。例如领域模型需要依赖 DB 完成持久化,可以依赖数据访问资源,但不应该依赖其他领域资源、不可以依赖 RPC 资源等。

2.4 微服务划分

服务划分以领域划分为参考,主要看我们要拆分到什么粒度,这 应该符合低耦合高内聚原则,不破坏领域实体的聚合关系。

产出物:微服务

例如餐厅:餐厅是有必要拆分的,餐厅的 “菜品域”,“订单域”,“厨房域” 有独立的问题空间。

例如厨房:厨房是没有必要拆分的,厨师与刀工的耦合非常高,他们都在做饭,分开之后是不完整的,分开就是没有必要的。

餐厅被拆分为:厨房(Kitchen)、菜品(Category)、订单(Order)三个微服务,当然还有两个非领域的服务:餐厅门面服务、餐厅基础服务

一般情况下,依赖层不会作为单独的服务,会被以组件的形式嵌入到领域服务之中

3、功能设计(用例实现)

如果说领域设计是餐厅的设计师、架构设计是餐厅的建筑师、那么功能设计就是餐厅的厨师或服务员。

任何设计都要落地到功能设计,如果厨师不守规则,偏偏要去洗手间洗菜,最后的结果依然是一团乱,最终会导致设计无法落地。

功能设计是实现 “面向扩展开放、面向修改关闭” 的途径,是指导研发落地必备环节。

3.1 功能的概念

功能迭代时,功能会发生一些变化,所以他的含义是可能变化的,所以我们需要再次审视功能的概念,及时加以调整。

例如、我们实现了一个 “做蛋炒饭” 的功能,后来又实现了一个 “做辣椒炒蛋” 的功能,那么我们应该将功能升级为 “炒菜”,甚至是 “制作菜品” 等。

明确功能的概念,是功能设计的前提。

产出物:更新语言库,更新脑图

3.2 用例的位置

我们在领域分析章节,已明确了用例与角色的关系,用例与领域的关系。

然而一个新功能的加入,我们仍然要再次评估,以确保他处于正确的位置。

产出物:更新用例图

3.3 事件风暴

我们需要深入功能的细节,首推的方法是事件风暴,适用于解构复杂功能。

事件风暴的作用并不限于功能分析,只是我觉得很适用于功能分析,事件风暴的一张图包含很多内容,正好是功能设计所需要的。

将功能拆分为多个子功能(步骤)。(在后续使用)

确认参与该步骤的角色和领域。(在后续的 3.6 章节落地)

确认步骤的串联流程和领域事件。(在后续的 3.6 章节落地)

确认参与该步骤的领域实体。(在后续的 3.7 章节落地)

产出物:事件风暴模型

3.4 用例分析

首先、我们需要关注共性和差异问题,以确保功能的扩展性。

确认用例的泛化 + 差异点,实现功能的扩展。

寻找共同包含的步骤,实现逻辑的复用。

产出物:用例分析图

例:制作菜品(做大拌菜、做铁锅炖、做炒鸡蛋、做蒸米饭、做炒米饭)

3.5 用例实现类(领域服务类)结构图

专注于用例层的类设计,实现 “面相修改关闭,面相扩展开放”。

用例的类结构图是用例分析图的一种映射。

出物:用例层的类结构图

3.6 用例流程图

我们更进一步,将事件风暴模型落实到代码层面。

我们将步骤分配到实现类中、步骤就是该类的一个方法,进一步明确由哪个类和方法来实现该步骤,从而就规定了步骤所在的领域。

我们将步骤和领域事件串联起来,规定了业务实现流程。推荐使用泳道图表达上述内容。泳道的纵向组件是用例的实现类。

这是真实业务流程的映射。

产出物:用例流程图

以炒鸡蛋为例,其用例流程图如下

试想一下、把业务逻辑放在领域模型当中(例如聚合),如何实现 “面相扩展开放、面相修改关闭” 呢?显然是很难的,功能逻辑和领域实体模型不是同一类技术问题。

3.7 活动图(时序图)

我们进一步将事件风暴模型落实到代码层面,我们使用时序图,体现依赖和调用关系,规定了步骤与领域实体模型的关系,进一步说明用例是如何实现的。

这时候,为了简便、我们可以收起领域服务类(用例层)的泳道。

产出物:时序图、活动图


4、编码实现

编码实现...... 我决定还是...... 偷个懒吧...... 哈哈哈。

但是我们回顾一下之前的内容,是否足够了? 不同的研发人员依照设计去编码,是否会写出不一样的代码?


系统名

餐厅系统

相关应用

厨房应用、菜品应用、订单应用,门面应用、基础应用

系统架构图

厨房应用 - 领域模型

厨房应用 - 用例层

厨师模块、刀工模块、买菜员模块

厨房应用 - 用例层 - 厨师模块(服务类结构)

厨房应用 - 用例层 - 厨师模块(类中的方法、方法含义、执行流程)

厨房应用 - 用例层 - 厨师模块(方法的依赖、调用关系)


最后、我们的目标是 “解决软件复杂度带来的问题”,而实现这个目标的途径是 “设计指导研发落地”。

作者:京东科技 董健

来源:京东云开发者社区 转载请注明来源

暂无回复。
需要 登录 后方可回复, 如果你还没有账号请点击这里 注册