aggregate-design-canvas

aggregate-design-canvas

Aggregate Design Canvas 聚合设计建模工具

Aggregate Design Canvas 是一个领域建模工具,用于优化聚合设计和业务逻辑实现。它提供结构化框架,涵盖聚合的名称、描述、状态转换、不变量和纠正策略等要素。通过分析命令处理、事件创建、吞吐量和大小,此工具帮助评估和改进聚合边界,平衡一致性与性能。适用于进行领域驱动设计的开发团队,有助于提升建模质量。

Aggregate Design Canvas领域建模聚合设计DDD设计工具Github开源项目

聚合设计画布

聚合设计画布是一种建模工具,旨在用于设计级别的领域建模活动。

聚合是由Eric Evans最初描述的生命周期模式。我们将聚合理解为一个对象图,它是我们领域策略的一致性边界。根据聚合的设计,我们可以强制执行这些策略(使其不变)或被迫采取纠正性策略。因此,设计好聚合的边界很重要,因为它们会影响我们领域内建模的行为。

画布有一个建议的工作顺序,有助于迭代讨论聚合设计的不同方面。

聚合设计画布

下载

v1.1:

v1.0:

如何使用

1. 名称

为您的聚合取一个好名字。在某些领域,将周期长度或其他聚合生命周期指标包含在名称中是有意义的。

2. 描述

总结聚合的主要职责和目的。最好包括选择这些边界的原因以及与其他设计相比做出的权衡。

3. 状态转换

通常聚合会经历明确的状态转换,这会影响与之交互的方式。过多的转换可能表明流程边界没有正确建模,可以拆分。非常简单/朴素的转换可能表明聚合是贫血的,逻辑被推到了服务中。在画布的这一部分列出可能的状态或绘制一个小的转换图。

4. 强制不变量 & 5. 纠正策略

聚合的主要工作之一是强制执行业务不变量。这些不变量保护业务逻辑。在这一部分列出主要的不变量将确保你们就聚合的责任达成一致。大量的强制不变量可能表明聚合实现的局部复杂度很高。

如果你决定改变聚合的边界并放松一些不变量(例如减少并发冲突的机会),那么可能需要一些额外的业务逻辑来纠正一些不一致性。在这个画布的上下文中,我们称这种逻辑为纠正策略。大量此类策略可能表明业务逻辑被推到了聚合之外,这可能增加实现的复杂性。

在画布上列出不变量和纠正策略都将使设计权衡变得明确,并帮助你决定你确定的边界是否有用。

6. 处理的命令 & 7. 创建的事件

在这一部分,你列出聚合能够处理的所有命令以及将创建的所有事件。在它们之间创建连接器可能是个好主意,以验证你没有遗漏任何构建块。

8. 吞吐量

这一部分的目标是估计单个聚合实例涉及并发冲突的可能性(当两个或多个竞争调用者同时尝试进行更改时)。对每个指标估计平均值和最大值 - 这将�助您推理异常值,因为它们通常驱动边界重新评估。

命令处理率指标描述了聚合处理新命令的速率。另一方面,客户端总数说明了可能发出这些命令的客户端数量。

举个例子 - 如果一个聚合模拟网站上的购物篮,那么可能只有一个客户端向这个购物篮发出命令。如果我们将其与模拟会议预订系统的聚合进行比较,那么可能会有数十或数百个客户试图预订票。

聚合并发冲突机会评估图表

聚合并发冲突机会评估图表

将这些指标放在图表上会给你一个并发冲突机会的粗略估计,这正是我们最终要寻找的。为多个替代方案绘制平均值和最大值将允许你明确讨论吞吐量的权衡。一般来说,瞄准较小的冲突机会会提供更好的客户体验,但也会增加实现的复杂性。或者换个说法:更大的聚合会有更高的并发冲突机会,但需要更少的策略来纠正数据。

9. 大小

画布的最后一部分将帮助你估计聚合的假设大小。在这种情况下,大小本身是以每个聚合实例的事件数量来衡量的。根据你如何建模领域,事件可能最终变得细粒度或粗粒度,所以事件的大小也将发挥作用。

例如,OrderCreated事件可能有多个LineItems作为事件的一部分,或者将这些行项目建模为单独的LineItemAdded事件。在粗粒度事件的情况下,聚合的总体大小会更大,即使事件数量很少。

事件增长率指标应估计单个聚合实例附加了多少事件。实例的生命周期将告诉我们实例将存活多长时间,因此当我们需要处理新命令时,将累积和获取多少事件。

聚合大小评估图表

聚合大小评估图表

中等和大量的事件可能会影响客户体验并使命令处理变慢。幸运的是,在大多数情况下,这可以通过使用快照来解决。另一个需要注意的是长寿命实例(可能无限)。这可能在归档数据和不断增长的流时造成问题。因此,通常一个好的启发式方法是将聚合限定在特定的时间段内(例如计费期)。

额外资源

示例

简单银行账户

聚合设计画布

贡献者

感谢所有现有和未来的贡献者,感谢Mathew McLoughlinMarijn Huizendveld对聚合设计画布的贡献:

这个画布的灵感来自限界上下文画布

贡献和反馈

聚合设计画布可供您免费使用。此外,我们欢迎您的反馈和想法以改进画布或创建新版本。

也欢迎您向我们发送包含您示例的拉取请求。

CC BY 4.0

本作品采用知识共享署名 4.0 国际许可协议进行许可。

CC BY 4.0

编辑推荐精选

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

TRELLIS

TRELLIS

用于可扩展和多功能 3D 生成的结构化 3D 潜在表示

TRELLIS 是一个专注于 3D 生成的项目,它利用结构化 3D 潜在表示技术,实现了可扩展且多功能的 3D 生成。项目提供了多种 3D 生成的方法和工具,包括文本到 3D、图像到 3D 等,并且支持多种输出格式,如 3D 高斯、辐射场和网格等。通过 TRELLIS,用户可以根据文本描述或图像输入快速生成高质量的 3D 资产,适用于游戏开发、动画制作、虚拟现实等多个领域。

ai-agents-for-beginners

ai-agents-for-beginners

10 节课教你开启构建 AI 代理所需的一切知识

AI Agents for Beginners 是一个专为初学者打造的课程项目,提供 10 节课程,涵盖构建 AI 代理的必备知识,支持多种语言,包含规划设计、工具使用、多代理等丰富内容,助您快速入门 AI 代理领域。

AEE

AEE

AI Excel全自动制表工具

AEE 在线 AI 全自动 Excel 编辑器,提供智能录入、自动公式、数据整理、图表生成等功能,高效处理 Excel 任务,提升办公效率。支持自动高亮数据、批量计算、不规则数据录入,适用于企业、教育、金融等多场景。

UI-TARS-desktop

UI-TARS-desktop

基于 UI-TARS 视觉语言模型的桌面应用,可通过自然语言控制计算机进行多模态操作。

UI-TARS-desktop 是一款功能强大的桌面应用,基于 UI-TARS(视觉语言模型)构建。它具备自然语言控制、截图与视觉识别、精确的鼠标键盘控制等功能,支持跨平台使用(Windows/MacOS),能提供实时反馈和状态显示,且数据完全本地处理,保障隐私安全。该应用集成了多种大语言模型和搜索方式,还可进行文件系统操作。适用于需要智能交互和自动化任务的场景,如信息检索、文件管理等。其提供了详细的文档,包括快速启动、部署、贡献指南和 SDK 使用说明等,方便开发者使用和扩展。

Wan2.1

Wan2.1

开源且先进的大规模视频生成模型项目

Wan2.1 是一个开源且先进的大规模视频生成模型项目,支持文本到图像、文本到视频、图像到视频等多种生成任务。它具备丰富的配置选项,可调整分辨率、扩散步数等参数,还能对提示词进行增强。使用了多种先进技术和工具,在视频和图像生成领域具有广泛应用前景,适合研究人员和开发者使用。

爱图表

爱图表

全流程 AI 驱动的数据可视化工具,助力用户轻松创作高颜值图表

爱图表(aitubiao.com)就是AI图表,是由镝数科技推出的一款创新型智能数据可视化平台,专注于为用户提供便捷的图表生成、数据分析和报告撰写服务。爱图表是中国首个在图表场景接入DeepSeek的产品。通过接入前沿的DeepSeek系列AI模型,爱图表结合强大的数据处理能力与智能化功能,致力于帮助职场人士高效处理和表达数据,提升工作效率和报告质量。

Qwen2.5-VL

Qwen2.5-VL

一款强大的视觉语言模型,支持图像和视频输入

Qwen2.5-VL 是一款强大的视觉语言模型,支持图像和视频输入,可用于多种场景,如商品特点总结、图像文字识别等。项目提供了 OpenAI API 服务、Web UI 示例等部署方式,还包含了视觉处理工具,有助于开发者快速集成和使用,提升工作效率。

下拉加载更多