实践中的C4模型

如何解决实践中的C4模型

在阅读了 C4 model 并听了 Simon Brown's talk 之后，我仍然不明白如何在实践中使用它。

AFAIK，C4 模型的主要贡献是对简单抽象的“协议”，使图表和文档更接近开发人员。在同一个 C4 中更多的是关于建议，你必须自己弄清楚一些东西（这再次打破了与自定义抽象的“协议”）。

如果C4缺少细节我该怎么办？我应该自定义到什么程度？

例如：

1. 基础设施、数据流或业务流程等支持图表如何适合 C4？
   例如，路由器/防火墙/api-网关/服务总线是 C4 的基础设施图表中的容器?我找不到任何示例。
2. 扩展 C4 的级别是个好主意吗？
   C4 模型只有 4 个级别（不是递归的）。如果我需要第 5 个子系统级别怎么办。
3. 容器图（级别 2）中的“数据库容器”是否应该包含有关数据库名称、架构名称或数据库技术的信息？
   从示例中，doesn't contain，ro { {3}}。
4. 是否可以从官方文档中找到除微不足道之外的 C4 示例？

解决方法

C4 model 旨在简化。在许多细节仍不确定的时候，它简化了早期的建筑工作。它有助于与不完全熟悉 UML 符号的所有微妙之处的人进行团队讨论。

(1)

它并不打算成为所有东西的通用图表技术。所以不，没有业务流程建模。上下文级别图提供了更多信息，作为有关用户与系统交换内容的用例图。但它停在那里。 BPMN（或 demonstrated 与 BPMN 一样具有表现力的 UML 活动图）仍有市场。

它既不打算取代基础架构图表，也不打算取代硬件设计。它专门针对软件密集型系统的需求：什么软件在哪里以及如何运行。如果需要细节，UML 部署图并没有死。话虽如此，我认为添加一些框来表示防火墙很容易，就好像它们是软件元素一样，如果需要了解架构。并且 API 网关最终获得了 C4 图片（以类似于 this example 的风格）。

(2)

C4 级别 3 是组件。第 4 级允许您使用任何现有的建模符号来显示更多细节。没有必要重新发明轮子。如果组件仍然非常复杂，您可以使用 UML 的全部功能及其递归方式，根据需要（并且仅在需要时）进行更深入的研究。

(3)

这是需要的。您可能会开始您的架构，只是确定需要一个数据库。但也许以后，您的环境中会有多个模式，您需要消除歧义。或者只是想记录名称。

(4)

当然可以，但这超出了这里的范围。

,

1. 基础架构、数据流或业务流程等支持图表如何融入 C4？例如，路由器/防火墙/api-网关/服务总线是 C4 的基础设施图中的容器吗？我找不到任何示例。

构成 C4 模型的核心图旨在专注于静态结构，具有不同的细节层次。 c4model.com 上还定义了一些补充图，其中一个是部署图……这是我对路由器、防火墙、负载平衡器等进行建模的地方。

还有其他几种图表符号可用于数据流（DFD、UML 序列图、UML 协作/通信图等）和业务流程（BPMN、ArchiMate、UML 活动图等）。我的建议是，团队不要重新发明轮子，而是根据需要使用这些现有的图表/符号来补充他们的 C4 模型图表。

来自 c4model.com 常见问题解答：“C4 模型的重点是构成软件系统的静态结构，处于不同的抽象级别。如果您需要描述其他方面，请随时补充 C4 图UML图、BPML图、ArchiMate图、实体关系图等"

2. 这是扩展 C4 级别的好主意吗？ C4 模型只有 4 个级别（不是递归的）。如果我需要第 5 个子系统级别怎么办。

当然，我见过团队这样做。只需确保团队/组织中的每个人都记录并理解您的“扩展”。

3. 容器图（级别 2）中的“数据库容器”是否应该包含有关数据库名称、架构名称或数据库技术的信息？ 从示例中，不包含，ro 确实包含。

这取决于你。如果您的数据库是标准的 RDBMS 数据库/模式，并且不使用任何专有功能，那么您不一定需要指定技术。相反，您可以在部署图上提及该技术。但是，如果您的数据库正在使用 RDBMS 的特定功能（例如 Oracle 存储过程），并且无法部署到不同的 RDBMS 上，那么您最好指定技术来说明这一点。

4. 是否可以从官方文档中找到除了微不足道的 C4 示例？

不幸的是，很难找到公开的例子......这只是组织不想公开他们的文档的性质。在 GitHub 上搜索“c4 模型”应该会找到一些示例。