设计系统框架基础之规范画系统框架图

系统框架图是一种用于描述系统组成部分及其相互关系的图形表示方法。它帮助设计者和利益相关者理解系统的整体结构和工作原理。以下是绘制系统框架图的基本步骤和一些建议：

绘制系统框架图的步骤

1. 收集信息：首先，需要了解系统的基本构成和功能。这包括系统的各个模块、组件以及它们之间的关系
2. 确定连接关系：明确系统中各个模块之间如何相互连接和通信。这有助于理解数据如何在系统内部流动
3. 绘制图形：使用专业的系统架构图绘制工具，如boardmix，开始绘制系统的架构图。首先画出四个基本部分：顶部导航栏、左侧菜单栏、中部内容区和底部操作栏。然后将系统组件放入相应的位置，并用线条表示组件之间的联系
4. 评估调整：分析系统框图的优点和不足，根据实际情况进行调整，以确保框架图准确反映系统的结构和功能

设计原则

• 关注业务挑战：设计时应关注业务本身而不是技术，以确保架构能够适应业务的发展变化
• 追求扩展性：系统架构应关注扩展性而不是仅仅性能，以便更容易添加业务功能
• 使用成熟的技术方案：考虑如何接纳主流趋势而不是保住自己原来一套思路，使用成熟的技术方案

规范绘制系统框架图的方法

• 基本元素和组成部分：

  • 方框：表示系统的组成部分，如硬件设备、软件模块或功能模块。
  • 箭头：表示方框之间的相互关系和信息流动。
  • 标签：说明方框或箭头的具体名称和功能。
  • 接口：表示系统与外部实体之间的交互。
  • 其他元素：如椭圆（表示数据存储）、菱形（表示数据处理）等，根据实际需求使用

• 绘制步骤：

  1. 收集信息：了解系统的基本构成和功能。
  2. 确定连接关系：明确系统中各个模块之间如何相互连接和通信。
  3. 绘制图形：使用专业的系统架构图绘制工具，如boardmix，开始绘制系统的架构图。
  4. 评估调整：分析系统框图的优点和不足，根据实际情况进行调整

提高系统框架图可读性和可维护性的建议

• 使用Clean Architecture原则：确保每一层都有特定的责任，并且不会侵犯其他层，保持清晰的边界
• 遵循SOLID原则：在整个架构中应用SOLID原则（单一责任、开放/封闭、Liskov替换、接口隔离、依赖关系反转），以确保可维护性、灵活性和可扩展性
• 使用干净的代码实践：保持代码整洁、可读且可维护，对类、方法和变量使用有意义的名称
• 持续精益求精：根据不断变化的需求和反馈定期审查和优化架构
• 文档和注释：在必要时提供有意义的注释和文档，以帮助其他开发人员理解和将来的维护