跳转到内容

Architecture Diagramming Guide(架构图绘制指南)

知识库位置:FDE Knowledge Base/11 Tools/03-Architecture/01-Architecture-Diagramming-Guide.md

Rule 1 — One Diagram, One Question(一图一问)

Section titled “Rule 1 — One Diagram, One Question(一图一问)”

不要一张图同时解释:

  • Business Process(业务流程)
  • Infrastructure(基础设施)
  • Network(网络)
  • Data Flow(数据流)
  • Deployment(部署)

1. Context Diagram(系统上下文图)

Section titled “1. Context Diagram(系统上下文图)”

回答:

系统和谁交互?

User(用户)
↓
Solution(方案)
↔ CRM(客户关系管理)
↔ ERP(企业资源计划)
↔ LLM Provider(大语言模型服务)

回答:

系统内部有哪些主要模块?


回答:

数据从哪里来,到哪里去?


回答:

一个请求按时间顺序怎么执行?


Prototype(原型)阶段图应该尽量简单:

5–10 major components(5–10 个主要组件)

详细图可以之后补。


Diagram Checklist(架构图检查清单)

Section titled “Diagram Checklist(架构图检查清单)”

每张架构图应尽量能回答:

  • User(用户)在哪里?
  • Trust Boundary(信任边界)在哪里?
  • External System(外部系统)在哪里?
  • Data Store(数据存储)在哪里?
  • AI 在哪里?
  • Authentication(认证)在哪里?
  • Human Review(人工审核)在哪里?
  • Failure Dependency(故障依赖)在哪里?