Architecture Reading Roadmap

软件架构阅读路线与场景导航

架构分支已经覆盖了决策、设计、集成、安全、数据契约等专题方向,但不再适合"从头看到尾"。 这张页按角色和场景分流:先判断你现在是什么身份、想解决什么问题,再推荐对应的读法。

先问场景
系统设计者 / 架构评审者 / 技术演进者
按时间读
30 分钟 / 半天 / 1 天
读后有输出
ADR、架构图、评审清单、演进计划
读法原则: 架构能力不是靠读一本本书堆出来的。先确认你现在遇到的判断问题("决策没记录"、"服务不知道怎么拆"、"系统越改越乱"),然后按对应专题页的读法进入。读完专题后能回到这张页换一条路线。
一、按角色进入

同"学架构"不同角色应该进入不同页面。先定位你现在在做什么,再选路线。

我想先看懂架构全貌
全景
先用架构总览页建立宏观地图:决策层、设计层、实现与运行层分别覆盖什么,各专题页在哪里。
全景分类路线
我是系统设计者,要从零设计一个系统
设计
走 8 层 20 步架构设计路线:从业务目标、系统边界、模块服务、数据架构、接口集成到安全和运维。
8层路线设计方法20步
我是架构评审者,需要判断方案好坏
评审
看 ADR、架构评审机制、风险评估和例外管理,把评审从"走过场"变成可追溯的判断系统。
ADR评审风险评估
我在做系统集成,需要决定 API 风格和契约
集成
看 API 选型(REST/gRPC/GraphQL)、幂等版本策略、外部系统集成和数据契约设计。
APIgRPC契约
我在设计身份和权限系统
安全
看认证协议、权限模型、MFA、Session 管理、企业 IAM 架构和零信任架构设计。
IAMRBACOAuth2
系统越改越乱,我想处理架构债
演进
看架构债分类、度量方法、优先级判断和偿还策略——识别"高利贷"债,优先还。
技术债重构演进
我的系统有数据不一致的问题
可靠性
看补偿事务、对账机制、事件重放和最终一致场景下的数据修复策略。
Saga对账重放
我在做 API 治理,接口越来越难管
治理
看 API 生命周期管理:设计规范、版本化、废弃策略、网关、门户和合规。
生命周期治理废弃
二、按时间读法

如果你不是带着具体角色和问题进来,只是想系统性地补架构能力,按可用时间选读法。

时间读什么路线
30 分钟 理解架构知识的分层结构 架构总览(15 分钟看完全景和 8 层表)→ 设计路线(15 分钟看 8 层概要)
半天 建立一个判断框架 架构决策与评审(1h)→ 设计路线(1h 重点看几层)→ 判断训练(1h 做 2-3 个练习)
1 天 系统补架构能力 总览(30 min)→ ADR + 评审(1h)→ 设计路线 8 层(1.5h)→ API 集成(1h)→ IAM(1h)→ 补偿对账(45 min)→ 架构债(45 min)→ 判断训练(1h)
1 周 建立完整的架构判断体系 1 天路线 → 读 2-3 本书页(DDD、演进式架构、微服务模式三选一)→ 用判断训练复盘自己项目的架构问题 → 画一份当前系统的架构现状图 + 债项清单
三、常见架构问题场景

如果你已经遇到具体问题,直接对号入座。

场景可能的根因推荐读法
架构决策没有记录,几年后没人知道为什么这样做 缺少 ADR 机制 架构决策与评审
评审变成走过场,没人真正质疑方案 评审没有围绕质量和风险 架构决策与评审(评审机制部分)
微服务拆了又合并,不知道拆多细 缺少模块化判断框架 设计路线(模块与服务设计层)
接口越来越多,版本管理混乱 缺少 API 生命周期管理 API 生命周期管理 + 数据契约
系统出了问题很难恢复数据一致性 缺少补偿和重放机制 补偿、对账与重放
权限模型混乱,用户能看到不该看的数据 IAM 设计不完整 身份认证与 IAM
每次重构都推不动,系统越改越慢 缺少架构债管理 架构债
外部系统集成常出问题,没有降级策略 集成模式缺失 API 与系统集成
读完以后: 建议去 判断训练 用练习验证理解,或者回到 总览页 换一条路线继续。