DEV SAGA

关卡 3-4 · 章 IX · 世界 3, 设计高原 · 案例

软件架构

学习「软件架构」的顺序:4 本书,从入门到参考;5 个工作中用的 AI skill;以及值得关注的人。

阅读路线(按顺序)

  1. 1. 从这里开始Fundamentals of Software ArchitectureMark Richards, Neal Ford在豆瓣查看
  2. 2. 深入架构整洁之道Robert C. Martin在豆瓣查看
  3. 3. 深入Software Architecture: The Hard PartsNeal Ford et al.在豆瓣查看
  4. 4. 参考书演进式架构Neal Ford, Rebecca Parsons, Patrick Kua在豆瓣查看

日常工作用的 AI skills

/decision-record

架构决策没人记得当初为什么这么定。

  • 把一次讨论整理成架构决策记录(ADR)
  • 写明被否决的备选方案和取舍
  • 追问这个决策让哪些东西换了位置
  • 区分可逆决策与不可逆决策

怎么用: 使用 skill decision-record,整理昨天关于消息队列的讨论。

/explicit-tradeoff

架构选择凭喜好辩护,而不是看后果。

  • 并排比较两到三个方案
  • 说清每个方案得到什么、失去什么、把什么挪了位置
  • 指出每个选择的回退成本
  • 给出明确推荐,并写明反方观点

怎么用: 使用 skill explicit-tradeoff,比较票据服务用消息队列还是同步调用。

/c4-diagrams

架构只存在于画图那个人的脑子里。

  • 阅读代码或系统描述
  • 生成上下文图、容器图和组件图
  • 附上图例和元素说明表
  • 说明哪些图在这个场景下不值得画

怎么用: 使用 skill c4-diagrams,为周五的汇报梳理这个仓库。

/coupling-and-cohesion

模块总是一起改,依赖关系绕成了圈。

  • 绘制模块之间的依赖关系
  • 指出循环依赖和依赖一切的模块
  • 从 git 历史中找出总是一起修改的文件
  • 建议在哪里划定边界

怎么用: 使用 skill coupling-and-cohesion,分析计费单体应用。

/architecture-rules

约定好的架构设计,半年后代码就忘了。

  • 把架构决策变成自动化测试
  • 检测代码何时偏离设计
  • 在流水线中运行,违规即构建失败
  • 把每条规则关联到产生它的决策(ADR)

怎么用: 使用 skill architecture-rules,约束订单服务的分层。

值得关注的人

在地图上玩这一关

Dev Saga 是一张像素风世界地图,包含成为 Staff 工程师之路的 30 个关卡。你可以独自或和读书会一起记录读过的书、用过的 skill,并导出进度给你的上级看。

在地图上打开第 3-4 关 带到我的团队