提示8-3:将概念文档限制在最重要的主题!
提示8-3:将概念文档限制在最重要的主题! #concept arc42包含20多个重复主题的提案列表——对于大多数现实生活系统来说太多了。 因此,您应该在以下步骤中处理这些概念: 选择那些与您的系统绝对相关或必要的 其中,分配优先级 阐述最优先的概念: 创建一个参考实现, 表和/或文本解释来解释一些概念 提供其他信息的链接 ...
提示8-2:概念是方法、规则、原则、战术、策略等......
提示8-2:概念是方法、规则、原则、战术、策略等…… #concept 有些人喜欢用不同的名字来称呼横切切面。在实践中,我们遇到了以下术语: 方法 方面:如“面向方面的编程” 概念:我们最喜欢的 原则 规定 规则 战术:就像设计战术一样,一个由软件工程研究所于2003年创造的术语。他们将战术定义为“可用于实现所需质量属性要求的架构决策” 策略 ...
提示8-5:记录业务、领域模型!
提示8-5:记录业务、领域模型! #concept #domain 业务或领域模型是“交叉的”业务或领域模型或元素(数据、活动、流程、服务、工具、材料)最常(而且绝对应该!)反映在源代码中。对于小型或简单的系统,您可以在构建块视图中描述这些元素……但是: 此类业务或领域元素将从许多构建块中引用,因此非常适合跨领域主题。 因此:在arc42第8节中记录(解释、指定)业务或领域模型或元素。 领域模型和简单的替代方案如果您遵循领域驱动设计方法(DDD)方法来设计和开发系统,您将 ...
提示8-6:将业务、领域模型与术语表相结合!
提示8-6:将业务、领域模型与术语表相结合! #concept #domain #glossary 您可以在 arc42 第8节(概念)中包含您的业务或领域模型的图形概述,并将文本定义推迟到第12节(术语表)。 在概念中,您可以专注于概述和域不同部分之间的关系。 这与原生支持横切引用的工具配合使用。 ...
提示9-5:将决策记录为“架构决策记录”(ADR)!
提示9-5:将决策记录为“架构决策记录”(ADR)! #decision Michael Nygard写了一篇关于以模式形式记录重要架构决策的博文: 我们将使用只有几个部分的格式,因此每个文档都易于消化。格式只有几个部分。 标题 这些文件的名称是短名词短语。例如,“ADR 1:在Ruby on Rails 3.0.10上部署”或“ADR 9:用于多租户集成的LDAP” 上下文 本节描述起作用的力量,包括技术、政治、社会和本地项目。这些力量可能处于紧张状态,应该这样称呼。本节中 ...
提示9-3:提供重要决定的理由!
提示9-3:提供重要决定的理由! #decision #essential 任何决定的“为什么”对于理解来说往往比纯粹的“什么”更重要。因此,提供重要决定的理由。记录决策背后的推理链。 如果您有明确的决策标准,这种推理可能会更容易(见提示9-2(决策标准))。 ...
可视化架构设计
关于 arch42 arc42 是用于软件和系统架构文档的模板,由 Peter Hruschka 博士、GernotStarke 博士和其他贡献者创建、维护和拥有。该模板的版本号为8.2 EN.(基于AsciiDoc版本),发布日期为2023年1月。 您可以在 arch42.cn 上找到更多信息。 这个版本的模板包含了一些帮助和解释,用于熟悉 arc42 并理解其中的概念。但如果要为您自己的系统编写文档,最好使用简洁版。 目录 介绍和目标 需求概述 质量目标 利益 ...
arc42
...