来源书籍

程序员必读之软件架构

Skill 版本:v23 软件架构方法论类 高信息浓度 × 高稳定性 128 张卡片

[英]Simon Brown · 邓钢 译 · 人民邮电出版社 · 2015 · ISBN 978-7-115-37107-2

类别清单覆盖

7/7

已覆盖 7 补充生成 0 未覆盖 0

章节与卡片

00

2 张卡片
  1. 区分能力角色与头衔 理解等级:初级 普通读书笔记卡
  2. 既有模型也会遮蔽问题 理解等级:高级 普通读书笔记卡

01

1 张卡片
  1. 架构兼具动静 理解等级:未标注 普通读书笔记卡

02

1 张卡片
  1. 架构共性 理解等级:未标注 普通读书笔记卡

03

3 张卡片
  1. 架构看全局 理解等级:未标注 普通读书笔记卡
  2. 企业架构不同 理解等级:未标注 普通读书笔记卡
  3. 应用与系统架构范围 理解等级:初级 普通读书笔记卡

04

3 张卡片
  1. 敏捷是相对速度 理解等级:未标注 普通读书笔记卡
  2. 敏捷不是免费 理解等级:未标注 普通读书笔记卡
  3. OODA连接响应速度 理解等级:中级 结构图卡

05

2 张卡片
  1. 架构是难改设计 理解等级:未标注 普通读书笔记卡
  2. 解耦转移重量 理解等级:未标注 普通读书笔记卡

06

1 张卡片
  1. 泥球源于失焦 理解等级:未标注 普通读书笔记卡

08

4 张卡片
  1. 角色不是级别 理解等级:未标注 普通读书笔记卡
  2. 技术选择即风险 理解等级:未标注 普通读书笔记卡
  3. 架构需要照料 理解等级:未标注 普通读书笔记卡
  4. 质量保证聚焦 理解等级:未标注 普通读书笔记卡

09

3 张卡片
  1. 架构师应编码 理解等级:未标注 普通读书笔记卡
  2. 原型连接架构 理解等级:未标注 普通读书笔记卡
  3. 评审不能长期替代编码 理解等级:高级 普通读书笔记卡

10

2 张卡片
  1. 建造大师 理解等级:未标注 普通读书笔记卡
  2. 学徒式传承 理解等级:未标注 普通读书笔记卡

11

1 张卡片
  1. 看责任深度 理解等级:未标注 普通读书笔记卡

12

2 张卡片
  1. T形技术能力 理解等级:未标注 普通读书笔记卡
  2. 结对架构 理解等级:未标注 普通读书笔记卡

13

4 张卡片
  1. 软技能是架构力 理解等级:未标注 普通读书笔记卡
  2. 情绪会放大 理解等级:未标注 普通读书笔记卡
  3. 指导与辅导职责不同 理解等级:中级 普通读书笔记卡
  4. 授权不转移最终责任 理解等级:中级 普通读书笔记卡

14

1 张卡片
  1. 架构不是接力 理解等级:未标注 普通读书笔记卡

15

1 张卡片
  1. 控制像操纵杆 理解等级:未标注 普通读书笔记卡

16

1 张卡片
  1. 缩小角色鸿沟 理解等级:未标注 普通读书笔记卡

17

1 张卡片
  1. 架构需刻意练习 理解等级:未标注 普通读书笔记卡

18

2 张卡片
  1. 角色随成熟变化 理解等级:未标注 普通读书笔记卡
  2. 敏捷仍需架构 理解等级:未标注 普通读书笔记卡

19

2 张卡片
  1. 责任配权威 理解等级:未标注 普通读书笔记卡
  2. 咨询先补领域理解 理解等级:高级 普通读书笔记卡

21

3 张卡片
  1. 驱动力塑造架构 理解等级:未标注 普通读书笔记卡
  2. 约束激发设计 理解等级:未标注 普通读书笔记卡
  3. 区分约束与原则 理解等级:初级 普通读书笔记卡

22

9 张卡片
  1. 质量属性进基础 理解等级:未标注 普通读书笔记卡
  2. 性能与伸缩性不同 理解等级:初级 普通读书笔记卡
  3. 可用性不等于灾难恢复 理解等级:初级 普通读书笔记卡
  4. 监测与管理读写有别 理解等级:初级 普通读书笔记卡
  5. 灵活性与扩展性不同 理解等级:初级 普通读书笔记卡
  6. 国际化与本地化不同 理解等级:初级 普通读书笔记卡
  7. 可访问性涵盖使用障碍 理解等级:中级 普通读书笔记卡
  8. 审计保留变更上下文 理解等级:中级 普通读书笔记卡
  9. 可维护性需要维护语境 理解等级:中级 普通读书笔记卡

23

2 张卡片
  1. 非功能要量化 理解等级:未标注 普通读书笔记卡
  2. 成本澄清优先级 理解等级:未标注 普通读书笔记卡

24

3 张卡片
  1. 约束是设计输入 理解等级:未标注 普通读书笔记卡
  2. 人员也是约束 理解等级:未标注 普通读书笔记卡
  3. 约束也能划分优先级 理解等级:高级 普通读书笔记卡

25

8 张卡片
  1. 原则带来一致 理解等级:未标注 普通读书笔记卡
  2. 最佳实践看语境 理解等级:未标注 普通读书笔记卡
  3. 无状态组件便于复制 理解等级:中级 普通读书笔记卡
  4. 分层以抽象隔离访问 理解等级:中级 普通读书笔记卡
  5. 业务逻辑位置需要统一 理解等级:中级 普通读书笔记卡
  6. 领域模型富贫有别 理解等级:初级 普通读书笔记卡
  7. 会话策略关联扩容方式 理解等级:高级 普通读书笔记卡
  8. 一致性目标取决于语境 理解等级:高级 普通读书笔记卡

26

2 张卡片
  1. 技术不是细节 理解等级:未标注 普通读书笔记卡
  2. 解耦不是免费 理解等级:未标注 普通读书笔记卡

27

2 张卡片
  1. 分层增加复杂度 理解等级:未标注 普通读书笔记卡
  2. 内网数据服务仍需授权 理解等级:高级 问题卡

28

1 张卡片
  1. 协作暴露假设 理解等级:未标注 普通读书笔记卡

29

1 张卡片
  1. 架构承载对话 理解等级:未标注 普通读书笔记卡

30

1 张卡片
  1. 平台项目也要架构 理解等级:未标注 普通读书笔记卡

32

1 张卡片
  1. 要可视化软件 理解等级:未标注 普通读书笔记卡

33

1 张卡片
  1. 草图建共同愿景 理解等级:未标注 普通读书笔记卡

34

3 张卡片
  1. 无效图缺关系 理解等级:未标注 普通读书笔记卡
  2. 图要喊出业务 理解等级:未标注 普通读书笔记卡
  3. 部署文件不等于运行进程 理解等级:初级 普通读书笔记卡

35

2 张卡片
  1. C4分层视图 理解等级:未标注 结构图卡
  2. 抽象胜过标记 理解等级:未标注 普通读书笔记卡

36

1 张卡片
  1. 语境图定边界 理解等级:未标注 普通读书笔记卡

37

2 张卡片
  1. 容器图开盒子 理解等级:未标注 普通读书笔记卡
  2. 容器视图不同部署实例 理解等级:中级 普通读书笔记卡

38

1 张卡片
  1. 组件图分职责 理解等级:未标注 普通读书笔记卡

39

1 张卡片
  1. 技术让图落地 理解等级:未标注 普通读书笔记卡

40

1 张卡片
  1. 图要照进代码 理解等级:未标注 普通读书笔记卡

41

3 张卡片
  1. 架构代码映射 理解等级:未标注 普通读书笔记卡
  2. 组件封装喊业务 理解等级:未标注 普通读书笔记卡
  3. 组件封装收拢实现 理解等级:中级 结构图卡

42

3 张卡片
  1. 工具不是前提 理解等级:未标注 普通读书笔记卡
  2. 区分四类建模工具 理解等级:初级 普通读书笔记卡
  3. 静态结构需补运行行为 理解等级:中级 普通读书笔记卡

43

2 张卡片
  1. 图例降低误读 理解等级:未标注 普通读书笔记卡
  2. 评审图看九点 理解等级:未标注 普通读书笔记卡

44

3 张卡片
  1. C4守住层次 理解等级:未标注 普通读书笔记卡
  2. 企业语境承接系统地图 理解等级:中级 普通读书笔记卡
  3. 通用依赖可用注记压缩 理解等级:中级 普通读书笔记卡

46

1 张卡片
  1. 代码不讲全貌 理解等级:未标注 普通读书笔记卡

47

2 张卡片
  1. 文档是指南 理解等级:未标注 普通读书笔记卡
  2. 产品文档长存 理解等级:未标注 普通读书笔记卡

49

1 张卡片
  1. 功能概览保留架构关联 理解等级:中级 普通读书笔记卡

50

1 张卡片
  1. 质量目标写清适用范围 理解等级:中级 普通读书笔记卡

51

1 张卡片
  1. 约束要记录来源和影响 理解等级:中级 普通读书笔记卡

54

1 张卡片
  1. 接口文档记录行为契约 理解等级:中级 普通读书笔记卡

55

1 张卡片
  1. 实现指南聚焦重要机制 理解等级:中级 普通读书笔记卡

56

1 张卡片
  1. 数据文档跨越软件寿命 理解等级:中级 普通读书笔记卡

57

1 张卡片
  1. 基础设施文档明确承载 理解等级:中级 普通读书笔记卡

58

1 张卡片
  1. 部署映射说明运行状态 理解等级:中级 普通读书笔记卡

59

1 张卡片
  1. 运维指南留下处置入口 理解等级:中级 普通读书笔记卡

60

1 张卡片
  1. 决策日志留语境 理解等级:未标注 普通读书笔记卡

62

2 张卡片
  1. 架构划定范围 理解等级:未标注 普通读书笔记卡
  2. 架构非大预设 理解等级:未标注 普通读书笔记卡

63

1 张卡片
  1. 风险要拆两维 理解等级:未标注 普通读书笔记卡

64

2 张卡片
  1. 风险风暴 理解等级:未标注 结构图卡
  2. 技术风险归架构 理解等级:未标注 普通读书笔记卡

65

4 张卡片
  1. 预设有两种过度 理解等级:未标注 普通读书笔记卡
  2. 重要来自成本 理解等级:未标注 普通读书笔记卡
  3. 最小架构实践 理解等级:未标注 普通读书笔记卡
  4. 用演练校准设计深度 理解等级:高级 普通读书笔记卡

66

3 张卡片
  1. 小步引入架构 理解等级:未标注 普通读书笔记卡
  2. 角色要显性化 理解等级:未标注 普通读书笔记卡
  3. 把架构纳入完成标准 理解等级:中级 普通读书笔记卡

68

2 张卡片
  1. 案例驱动架构 理解等级:未标注 普通读书笔记卡
  2. 完成时限不同服务可用 理解等级:中级 普通读书笔记卡

69 软件指南示例

6 张卡片
  1. 示例发布按版本切换 理解等级:中级 操作参考卡
  2. 历史MySQL启动核验 理解等级:中级 操作参考卡
  3. 历史MongoDB启动核验 理解等级:中级 操作参考卡
  4. 历史Web服务启动核验 理解等级:中级 操作参考卡
  5. 历史更新器启动与日志 理解等级:中级 操作参考卡
  6. 历史数据库备份检查 理解等级:中级 操作参考卡

69

2 张卡片
  1. 配置独立于发布包 理解等级:中级 普通读书笔记卡
  2. 持续集成形成发布物 理解等级:中级 普通读书笔记卡

全书概览

程序员必读之软件架构

类别:软件架构方法论类

历史 Skill 版本:首次生成时未记录。本次实际使用规则:book-notes v8(2026-09-25 v8 复核:卡片正文与标题已合规,摘录 76⁄76 逐字复核并更正 28 张;补做阶段四实践点子卡、阶段五类别清单核对与审查报告,另补主题索引维护),详见 _workflow.md。 作者:[英]Simon Brown | 出版:人民邮电出版社 | EPUB 标题:程序员必读之软件架构 (图灵程序设计丛书)

评级结论:经典原理(最高级别)

四象限判断:高信息浓度 × 高稳定性 - 高信息浓度:全书围绕“为什么这样做架构”展开,重点不是工具步骤,而是结构与愿景、改变成本、架构角色、质量属性、约束、风险、C4 可视化、文档和恰如其分的预先设计等底层判断。比如第5章用“改变成本”区分架构与一般设计,第21章把功能需求、质量属性、约束和原则归为架构驱动力,第65章用风险驱动方式界定预先设计的多少。 - 高稳定性:内容不绑定特定框架版本或界面操作,即使示例里出现 SharePoint、Silverlight、Java EE、.NET、UML 等时代性技术,落点仍是可迁移原则:技术选择不是实现细节、更多分层带来复杂度、代码不会讲述完整故事、敏捷不等于不要架构。这些判断在新技术栈中仍然成立。

章节筛选概览

本轮全文读取81项实质正文,排除7项非正文;共128张知识卡,其中52张本轮新增。旧50精读/18略读为历史口径,本轮不沿用为阅读证据。

章节进度追踪表

章节号 章节标题 状态 卡片数
spine 6 推荐序一:架构师真正要学会的事情 done 2
spine 7 推荐序二 done 0
spine 8 译者序2.0 done 0
spine 9 序 done 0
spine 10 关于本书 done 0
spine 12 Part Ⅰ 什么是软件架构 done 0
spine 13 第 1 章 什么是架构 done 1
spine 14 第 2 章 架构的种类 done 1
spine 15 第 3 章 软件架构是什么 done 3
spine 16 第 4 章 敏捷软件架构是什么 done 3
spine 17 第 5 章 架构对上设计 done 2
spine 18 第 6 章 软件架构重要吗 done 1
spine 19 第 7 章 问题 done 0
spine 20 Part Ⅱ 软件架构的角色 done 0
spine 21 第 8 章 软件架构的角色 done 4
spine 22 第 9 章 软件架构师应该编码吗 done 3
spine 23 第 10 章 软件架构师应该是建造大师 done 2
spine 24 第 11 章 从开发者到架构师 done 1
spine 25 第 12 章 拓展T done 2
spine 26 第 13 章 软技能 done 4
spine 27 第 14 章 软件架构不是接力运动 done 1
spine 28 第 15 章 软件架构要引入控制吗 done 1
spine 29 第 16 章 小心鸿沟 done 1
spine 30 第 17 章 未来的软件架构师在哪里 done 1
spine 31 第 18 章 每个人都是架构师,除非他们有其他身份 done 2
spine 32 第 19 章 软件架构咨询师 done 2
spine 33 第 20 章 问题 done 0
spine 34 Part Ⅲ 设计软件 done 0
spine 35 第 21 章 架构驱动力 done 4
spine 36 第 22 章 质量属性(非功能需求) done 8
spine 37 第 23 章 处理非功能需求 done 2
spine 38 第 24 章 约束 done 3
spine 39 第 25 章 原则 done 8
spine 40 第 26 章 技术不是实现细节 done 2
spine 41 第 27 章 更多分层等于更高复杂度 done 2
spine 42 第 28 章 协同设计是一把双刃剑 done 1
spine 43 第 29 章 软件架构是对话的平台 done 1
spine 44 第 30 章 SharePoint项目也需要软件架构 done 1
spine 45 第 31 章 问题 done 0
spine 46 Part Ⅳ 可视化软件 done 0
spine 47 第 32 章 沟通障碍 done 1
spine 48 第 33 章 对草图的需要 done 1
spine 49 第 34 章 无效的草图 done 3
spine 50 第 35 章 C4:语境、容器、组件和类 done 2
spine 51 第 36 章 语境图 done 1
spine 52 第 37 章 容器图 done 2
spine 53 第 38 章 组件图 done 1
spine 54 第 39 章 是否包含技术选择 done 1
spine 55 第 40 章 你会那样编码吗 done 1
spine 56 第 41 章 软件架构和编码 done 3
spine 57 第 42 章 你不需要UML工具 done 3
spine 58 第 43 章 有效的草图 done 2
spine 59 第 44 章 C4的常见问题 done 3
spine 60 第 45 章 问题 done 0
spine 61 Part Ⅴ 为软件生成文档 done 0
spine 62 第 46 章 代码不会讲述完整的故事 done 1
spine 63 第 47 章 软件文档即指南 done 2
spine 64 第 48 章 语境 done 0
spine 65 第 49 章 功能性概览 done 1
spine 66 第 50 章 质量属性 done 1
spine 67 第 51 章 约束 done 1
spine 68 第 52 章 原则 done 0
spine 69 第 53 章 软件架构 done 0
spine 70 第 54 章 外部接口 done 1
spine 71 第 55 章 代码 done 1
spine 72 第 56 章 数据 done 1
spine 73 第 57 章 基础设施架构 done 1
spine 74 第 58 章 部署 done 1
spine 75 第 59 章 运营和支持 done 1
spine 76 第 60 章 决策日志 done 1
spine 77 第 61 章 问题 done 0
spine 78 Part Ⅵ 开发生命周期中的软件架构 done 0
spine 79 第 62 章 敏捷和架构的冲突:神话还是现实 done 2
spine 80 第 63 章 量化风险 done 1
spine 81 第 64 章 风险风暴 done 2
spine 82 第 65 章 恰如其分的预先设计 done 4
spine 83 第 66 章 初识软件架构 done 3
spine 84 第 67 章 问题 done 0
spine 85 Part Ⅶ 金融风险系统 done 0
spine 86 第 68 章 金融风险系统 done 2
spine 87 Part Ⅷ 附录:“技术部落”的软件指南 done 8

历史章节筛选理由(旧版口径,非本轮取材结论)

章节号 理由
01 架构的定义不止静态结构,还包含基于需求设定愿景和技术领导。
02 用不同 IT 架构类型抽象出共同要素:结构与愿景。
03 区分应用、系统、软件与企业架构,能校准架构讨论边界。
04 讨论架构如何支撑变化,并解释敏捷不是免费的属性。
05 用改变成本区分架构决策与一般设计决策,浓度高。
06 说明缺乏结构与愿景会如何演变为泥球和交付风险。
07 本章是复盘问题清单,无新增核心概念。
08 系统定义架构角色的职责范围,是全书角色观的核心。
09 解释实践型架构师为什么要保持代码触感。
10 用建造大师类比强调技术领导、实践经验与师徒传承。
11 讨论架构能力如何从参与度、影响力和责任感中演进。
12 阐明架构师需要技术深度与广度并存。
13 把领导、沟通、影响和责任纳入架构能力模型。
14 反对交付式架构文档,强调愿景要随交付持续演化。
15 讨论指导、一致性与团队自主之间的控制尺度。
16 聚焦架构师和开发团队脱节的组织风险。
17 指出架构设计经验需要培养,不能只靠日常编码自然获得。
18 把架构角色分配和团队成熟度联系起来。
19 咨询语境中的领域知识、权威和信任对架构落地很关键。
20 本章是角色部分的复盘问题,无新增核心概念。
21 把功能需求、质量属性、约束和原则归为架构输入。
22 列举质量属性及其对基础设计的影响。
23 说明非功能需求需要主动捕捉、量化和成本化。
24 展示时间、技术、人员、组织等约束如何塑造架构。
25 讨论原则如何带来一致性,以及最佳实践的语境限制。
26 强调技术选择会影响非功能目标、约束和一致性。
27 用富客户端案例说明每增加一层都增加设计、测试、部署负担。
28 说明不同专长会带来偏见,协作可暴露假设并提升共识。
29 把架构过程定位为跨利益相关者的沟通平台。
30 借平台项目说明定制开发之外也需要技术领导和质量目标。
31 本章是设计部分的复盘问题,无新增核心概念。
32 揭示团队常会可视化流程,却不会可视化正在构建的软件。
33 说明草图是轻量沟通共同愿景的工具。
34 大量反例揭示图表失效的根因:缺职责、交互、语境和抽象层次。
35 提出 C4 抽象层次,是全书可视化方法核心。
36 解释语境图如何回答系统、用户和环境依赖。
37 解释容器图如何表达高层技术选择和职责分布。
38 解释组件图如何承接容器内逻辑分解和交付估算。
39 说明技术选择能让架构图从概念回到现实。
40 用代码实现反推图表边界,避免虚构抽象。
41 讨论架构图与代码组织之间的映射。
42 强调工具不是架构设计前提,白板和纸也能有效。
43 给出草图标题、标签、线条、颜色、图例等评审标准。
44 补充 C4 在混合抽象、共享组件和企业语境中的处理。
45 本章是可视化部分的复盘问题,无新增核心概念。
46 说明代码无法完整表达设计意图、运行语境和历史理由。
47 提出产品级软件指南,替代厚重静态文档。
48 文档指南的一个栏目说明,内容偏模板化。
49 文档指南的一个栏目说明,内容偏模板化。
50 文档指南的一个栏目说明,主要复用前文质量属性概念。
51 文档指南的一个栏目说明,主要复用前文约束概念。
52 文档指南的一个栏目说明,主要复用前文原则概念。
53 文档指南的一个栏目说明,主要落在文档结构。
54 文档指南的一个栏目说明,偏清单化。
55 文档指南的一个栏目说明,偏清单化。
56 文档指南的一个栏目说明,偏清单化。
57 文档指南的一个栏目说明,偏清单化。
58 文档指南的一个栏目说明,偏清单化。
59 文档指南的一个栏目说明,偏清单化。
60 说明记录重要决策的语境和取舍,便于未来维护。
61 本章是文档部分的复盘问题,无新增核心概念。
62 澄清敏捷和架构不冲突,冲突来自团队结构和大型预先设计。
63 给出概率与影响矩阵,为架构风险排序。
64 提出协作式、可视化的架构风险识别方法。
65 总结风险驱动的最小架构实践。
66 给出把架构重新引入团队的实践建议。
67 本章是生命周期部分的复盘问题,无新增核心概念。
68 作为贯穿案例,完整呈现需求、质量属性和约束。

历史 EPUB 处理记录

  • 解压目录:notes/程序员必读之软件架构/_epub-src
  • OPF 文件:_epub-src/content.opf
  • 目录文件:_epub-src/toc.ncx
  • 正文章节:第1章至第68章,对应 _epub-src/OEBPS/text00000_split_011.html 至 _epub-src/OEBPS/text00000_split_084.html 中的主体章节文件。

类别清单核对(软件架构方法论类)

维度 覆盖状态 关联卡片标题或未覆盖理由
架构的定义、目标与问题识别 已覆盖 架构兼具动静、架构看全局、架构是难改设计、泥球源于失焦
概念、抽象与模型边界 已覆盖 C4分层视图、抽象胜过标记、语境图定边界、C4守住层次
切分、分层与职责分配 已覆盖 容器图开盒子、组件图分职责、分层增加复杂度、组件封装喊业务
业务、技术与系统的关系 已覆盖 驱动力塑造架构、技术不是细节、约束是设计输入、图要喊出业务
架构治理、权责与组织协作 已覆盖 角色不是级别、责任配权威、架构不是接力、控制像操纵杆、协作暴露假设
质量属性与长期演化 已覆盖 质量属性进基础、非功能要量化、重要来自成本、解耦不是免费、决策日志留语境
方案验证、落地与反馈 已覆盖 原型连接架构、风险要拆两维、风险风暴、最小架构实践、评审图看九点

核对结论:7/7 已覆盖(2026-09-25 按 v8 补做,未新增卡片)。

历史实践卡进度(本轮计划另见下文)

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
1 为cardbox画C4语境与容器图 真实任务 done 第35–37章 语境图、容器图与隐含假设清单(计划)
2 对批处理工作流做风险风暴 真实任务 done 第63–64章 风险评分表与缓解措施(计划)

其余候选(如结对架构、学徒式传承、软技能)依赖团队环境,本仓库为单人维护,缺少可观察的协作对象,未强行生成。

主题索引维护

本书围绕架构角色、架构驱动力、C4 可视化、文档与敏捷中的恰如其分预先设计展开;新建“C4模型与架构可视化”1 个主题收纳第32–44章的图示方法,其余卡片按内容并入架构认知、架构师成长、非功能需求、架构决策、风险驱动、组织协同、技术沟通、设计原则与迭代过程等已有主题。

卡片标题 结论 主题文件或原因
架构兼具动静 已复用 notes/_topics/architecture-cognition-intent.md
架构共性 已复用 notes/_topics/architecture-cognition-intent.md
架构看全局 已复用 notes/_topics/architecture-cognition-intent.md
企业架构不同 已复用 notes/_topics/architecture-cognition-intent.md
敏捷是相对速度 已复用 notes/_topics/iterative-process-tailoring.md
敏捷不是免费 已复用 notes/_topics/iterative-process-tailoring.md
架构是难改设计 已复用 notes/_topics/architecture-cognition-intent.md
解耦转移重量 已复用 notes/_topics/architecture-principles-complexity.md
泥球源于失焦 已复用 notes/_topics/architecture-cognition-intent.md
角色不是级别 已复用 notes/_topics/architect-growth.md
技术选择即风险 已复用 notes/_topics/architecture-decision-making.md
架构需要照料 已复用 notes/_topics/architect-growth.md
质量保证聚焦 已复用 notes/_topics/architect-growth.md
架构师应编码 已复用 notes/_topics/architect-growth.md
原型连接架构 已复用 notes/_topics/architect-growth.md
建造大师 已复用 notes/_topics/architect-growth.md
学徒式传承 已复用 notes/_topics/architect-growth.md
看责任深度 已复用 notes/_topics/architect-growth.md
T形技术能力 已复用 notes/_topics/architect-growth.md
结对架构 已复用 notes/_topics/architect-growth.md
软技能是架构力 已复用 notes/_topics/architect-growth.md
情绪会放大 已复用 notes/_topics/architect-growth.md
架构不是接力 已复用 notes/_topics/org-architecture-alignment.md
控制像操纵杆 已复用 notes/_topics/org-architecture-alignment.md
缩小角色鸿沟 已复用 notes/_topics/org-architecture-alignment.md
架构需刻意练习 已复用 notes/_topics/architect-growth.md
角色随成熟变化 已复用 notes/_topics/architect-growth.md
敏捷仍需架构 已复用 notes/_topics/iterative-process-tailoring.md
责任配权威 已复用 notes/_topics/org-architecture-alignment.md
驱动力塑造架构 已复用 notes/_topics/nfr-in-design.md
约束激发设计 已复用 notes/_topics/architecture-decision-making.md
质量属性进基础 已复用 notes/_topics/nfr-in-design.md
非功能要量化 已复用 notes/_topics/nfr-in-design.md
成本澄清优先级 已复用 notes/_topics/nfr-in-design.md
约束是设计输入 已复用 notes/_topics/architecture-decision-making.md
人员也是约束 已复用 notes/_topics/architecture-decision-making.md
原则带来一致 已复用 notes/_topics/architecture-principles-complexity.md
最佳实践看语境 已复用 notes/_topics/architecture-principles-complexity.md
技术不是细节 已复用 notes/_topics/architecture-decision-making.md
解耦不是免费 已复用 notes/_topics/architecture-principles-complexity.md
分层增加复杂度 已复用 notes/_topics/architecture-principles-complexity.md
协作暴露假设 已复用 notes/_topics/technical-communication.md
架构承载对话 已复用 notes/_topics/technical-communication.md
平台项目也要架构 已复用 notes/_topics/iterative-process-tailoring.md
要可视化软件 已创建 notes/_topics/c4-architecture-visualization.md
草图建共同愿景 已创建 notes/_topics/c4-architecture-visualization.md
无效图缺关系 已创建 notes/_topics/c4-architecture-visualization.md
图要喊出业务 已创建 notes/_topics/c4-architecture-visualization.md
C4分层视图 已创建 notes/_topics/c4-architecture-visualization.md
抽象胜过标记 已创建 notes/_topics/c4-architecture-visualization.md
语境图定边界 已创建 notes/_topics/c4-architecture-visualization.md
容器图开盒子 已创建 notes/_topics/c4-architecture-visualization.md
组件图分职责 已创建 notes/_topics/c4-architecture-visualization.md
技术让图落地 已创建 notes/_topics/c4-architecture-visualization.md
图要照进代码 已创建 notes/_topics/c4-architecture-visualization.md
架构代码映射 已创建 notes/_topics/c4-architecture-visualization.md
组件封装喊业务 已创建 notes/_topics/c4-architecture-visualization.md
工具不是前提 已创建 notes/_topics/c4-architecture-visualization.md
图例降低误读 已创建 notes/_topics/c4-architecture-visualization.md
评审图看九点 已创建 notes/_topics/c4-architecture-visualization.md
C4守住层次 已创建 notes/_topics/c4-architecture-visualization.md
代码不讲全貌 已复用 notes/_topics/technical-communication.md
文档是指南 已复用 notes/_topics/technical-communication.md
产品文档长存 已复用 notes/_topics/technical-communication.md
决策日志留语境 已复用 notes/_topics/architecture-decision-making.md
架构划定范围 已复用 notes/_topics/iterative-process-tailoring.md
架构非大预设 已复用 notes/_topics/iterative-process-tailoring.md
风险要拆两维 已复用 notes/_topics/risk-driven-architecture.md
风险风暴 已复用 notes/_topics/risk-driven-architecture.md
技术风险归架构 已复用 notes/_topics/risk-driven-architecture.md
预设有两种过度 已复用 notes/_topics/risk-driven-architecture.md
重要来自成本 已复用 notes/_topics/risk-driven-architecture.md
最小架构实践 已复用 notes/_topics/risk-driven-architecture.md
小步引入架构 已复用 notes/_topics/iterative-process-tailoring.md
角色要显性化 已复用 notes/_topics/org-architecture-alignment.md
案例驱动架构 已复用 notes/_topics/iterative-process-tailoring.md

2026-10-24 当前成果

执行模式:light

建档进度:done

本轮规则book-workflow v4 / book-notes v23,保留历史首次缺版本、旧v8记录和评级。原书与缓存全部匹配;本轮完整读取81正文项、查看44张必要图片,7项非正文已说明排除。共有128张知识卡(52新、76历史),操作参考6张、问题卡1张、结构图卡4张。历史卡不批量回填学习元数据;来源位置及实际摘录已核对。

整书笔记覆盖全部81正文项,每卡唯一primary,131处引用、128项真实出处;覆盖记录保存候选去向和83个阅读单元。未执行笔记复核、独立审查及审查结果优化,不用旧报告声称本轮审查通过。

整书笔记schema:1

整书笔记SHA-256:be1d339418a770980794d469e5f7faf4fc32da129c7c34452dd07dd12f6e09ac

当前原书与非正文排除

来源项目:a19c7933-4eda-4176-aebd-30fe7e1ad292;原书books/架构归档2/程序员必读之软件架构.epub;SHA-256e27058c170d872cc3b6944d13b1dc96d983f0ac63ca0a6210c4df760614b5402。当前缓存extracted/程序员必读之软件架构/_epub-src,142个成员与原书匹配。

spine项 类型与排除理由
1 封面样式与书名,无实质论述
2 版权元数据与使用声明
3 纯全书目录
4 版权授权声明
5 献词
11 课程推广,重复内容简介与联系信息
88 出版方阅读后联络与促销说明

待关联术语

术语名 出现章节 一句话语境
WYSIWYG 推荐序一:架构师真正要学会的事情 以所见所得的旧界面经验讨论观察的局限
WIMP 推荐序一:架构师真正要学会的事情 作为旧图形界面理念的背景
VCL 推荐序一:架构师真正要学会的事情 用于回顾界面构建经验的历史例子
RadPHP 推荐序一:架构师真正要学会的事情 用VCL经验处理网站设计的例子
OWASP 第 22 章 质量属性(非功能需求) 作为安全学习入口,未展开其具体检查项
JMX 第 22 章 质量属性(非功能需求) 作为平台监测集成接口示例
SNMP 第 22 章 质量属性(非功能需求) 作为集中监测警报示例
认证 第 22 章 质量属性(非功能需求) 安全性需要关注的身份问题,未展开协议
授权 第 22 章 质量属性(非功能需求) 安全性需要关注的权限问题,未展开完整模型
SOLID 第 25 章 原则 作为关注点分离原则组被提名,未逐项解释
存储过程 第 25 章 原则 用于说明团队应明确数据访问原则,未展开内部机制
HTTP会话 第 25 章 原则 会话选择与状态和扩容关联已成卡,协议细节待关联
Silverlight 第 27 章 更多分层等于更高复杂度 富客户端技术选择的历史案例,机制未展开
WCF 第 27 章 更多分层等于更高复杂度 新增数据服务技术的历史案例,机制未展开
MDA 第 42 章 你不需要UML工具 模型驱动工具类别的具体名称
xUML 第 42 章 你不需要UML工具 模型驱动工具中表达行为的语言例子
OCL 第 42 章 你不需要UML工具 模型驱动工具中表达约束的语言例子
Visio 第 42 章 你不需要UML工具 绘图工具示例,未提供操作教程
OmniGraffle 第 42 章 你不需要UML工具 绘图工具示例,未提供操作教程
TDD 第 62 章 敏捷和架构的冲突:神话还是现实 局部开发实践不是系统级架构的替代
BDD 第 62 章 敏捷和架构的冲突:神话还是现实 与架构范围内的开发实践并列提名
DDD 第 62 章 敏捷和架构的冲突:神话还是现实 与架构范围内的开发实践并列提名
RDD 第 62 章 敏捷和架构的冲突:神话还是现实 与架构范围内的开发实践并列提名
Pingdom Part Ⅷ 附录:“技术部落”的软件指南 历史站点可访问性监测工具,未验证当前产品状态
Lucene Part Ⅷ 附录:“技术部落”的软件指南 历史搜索存储技术,未展开索引算法
Spring Part Ⅷ 附录:“技术部落”的软件指南 历史组件配置和装配框架,未展开容器机制

引用文献

标题 类型 出现章节 一句话语境
《观止》 书 推荐序一:架构师真正要学会的事情 作为Windows NT研发及旧经验的背景
敏捷宣言 框架 第 62 章 敏捷和架构的冲突:神话还是现实 说明响应变化并不等于拒绝计划
techtribesje 源码项目 Part Ⅷ 附录:“技术部落”的软件指南 附录软件指南对应的历史示例项目
《敏捷教练:如何打造优秀的敏捷团队》 书 第 9 章 软件架构师应该编码吗 用作团队辅导的补充阅读入口,未独立读取该书
《敏捷教练:如何打造优秀的敏捷团队》 书 第 10 章 软件架构师应该是建造大师 建造大师与辅导的引文背景,未独立读取该书
《恰如其分的软件架构:风险驱动的设计方法》 书 第 41 章 软件架构和编码 模范代码差距概念的引用背景,未独立读取该书
《软件系统架构》 书 第 47 章 软件文档即指南 软件指南和文档结构的补充阅读,未独立读取该书
Coding: Packaging by vertical slice 文章 第 41 章 软件架构和编码 垂直切片组织代码的被引博文,本轮只读本书的说明
Screaming Architecture 文章 第 34 章 无效的草图 业务含义应在图和代码中可见的引用背景
Screaming Architecture 文章 第 41 章 软件架构和编码 组件封装讨论的被引文章,本轮未独立读取原文
《壮志凌云》 电影 第 4 章 敏捷软件架构是什么 帮助理解飞行员OODA情境的文化引用
《星球大战》 电影 第 13 章 软技能 技术领导信心的比喻,并非技术机制

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

本书金融风险练习给出需求与约束,不是具体支付扣款或账务安全事故;未虚构案例配对。

本轮实践交付

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
1 绘制工作台两层架构图 真实任务 done 第35—37、43章 实践计划;未执行
2 整理本批流程风险图 真实任务 done 第63—64章 实践计划;未执行

实践候选筛选:done

结对设计、导师培养等候选需要已确认的合作对象与观察条件,本次不虚构参与者;旧系统运行命令仅保留历史参考,不直接执行。优先先画两层图,再整理风险位置。

导入与归档:pending,仍需dry-run、正式导入、文件/数据库对账、旧关系核对和新增卡归档。

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

主题索引

变更发布与回滚安全

比较变更速度、渐进发布、紧急发布与回滚边界的工程控制。

312 张卡片 · 75 本书

主题索引

组织与架构协同演进

比较团队边界、组织结构与技术架构如何对齐,以及组织惯性对架构变革的影响。

255 张卡片 · 57 本书

主题索引

建模的用途与表示法边界

比较建模语言作为草稿、蓝图或编程语言的不同用途,以及表示法规则、元模型与版本演化的边界。

248 张卡片 · 29 本书

主题索引

CI/CD流水线设计

流水线的资源模型、任务隔离与显式依赖、定义与运行分离、事件触发,以及构建/发布/运行分离和配置外置如何让同一制品安全跨环境交付。

231 张卡片 · 36 本书

主题索引

架构设计原则与复杂度来源

比较架构要解决的复杂度来源(性能、可用性、扩展、成本、安全、规模)以及合适、简单、演化等设计原则。

228 张卡片 · 40 本书

主题索引

分层、洋葱与六边形架构

比较分层、洋葱与六边形架构如何隔离核心业务逻辑与外部技术细节,以及各层职责与调用规则。

196 张卡片 · 43 本书

主题索引

一致性模型与CAP权衡

比较顺序一致性、线性一致性、外部一致性等一致性模型,以及 CAP、弱 CAP、HAT、PACELC 对系统取舍的刻画。

193 张卡片 · 49 本书

主题索引

最小特权与访问控制

比较最小权限、多方审批、紧急绕过与访问审计的设计取舍。

175 张卡片 · 72 本书

主题索引

架构决策方法

比较在不确定性下做架构决策的方法:以风险而非结果评价决策、期望值与决策树、认知偏差、根因追问与避免不必要的决策。

168 张卡片 · 45 本书

主题索引

日志、审计与取证

日志该记什么、怎么分级与结构化,采集管道与存储成本,以及审计证据与安全事件还原。

167 张卡片 · 46 本书

主题索引

架构师成长路径

比较架构师所需的判断力、执行力、创新力及其积累方式与成长阶段。

157 张卡片 · 36 本书

主题索引

系统扩展的维度

比较水平复制、按业务拆分与数据分片等不同维度的扩展手段及其适用问题。

134 张卡片 · 52 本书

主题索引

技术沟通与架构表达

比较面向不同受众的技术写作、演示与架构图方法:循序渐进的讲解、文档与幻灯片的取舍,以及让图表达连接与语义。

124 张卡片 · 27 本书

主题索引

配置中心与配置治理

比较配置外置到版本仓库、启动配置与业务配置的分离、按应用与环境匹配资源、敏感配置加密、配置服务高可用与消息总线动态刷新的做法与取舍。

99 张卡片 · 29 本书

主题索引

迭代开发与过程裁剪

比较迭代与预测式开发、时间盒与过程裁剪在不同需求稳定性下的适用性。

93 张卡片 · 26 本书

主题索引

会话状态管理

有状态与无状态会话的取舍,以及会话状态存放在客户端、服务器或数据库的代价与清理。

81 张卡片 · 37 本书

主题索引

架构认知与架构意图

比较认识系统的方式(感受、知得与识得、真相与事实)以及架构意图如何识别、取舍与避免臆断。

81 张卡片 · 14 本书

主题索引

风险驱动的架构设计

比较以失败风险决定架构投入多少、做何分析的方法,包括风险的定义与分类、分析技术光谱、设计过程对风险的安排。

81 张卡片 · 14 本书

主题索引

领域逻辑的组织方式

事务脚本、领域模型、表模块与服务层的选型、演化与边界:业务逻辑放在哪里、以何种结构组织。

78 张卡片 · 17 本书

主题索引

架构视图与视点

比较用多视图与视点组织架构描述:模块、组件与分配结构的划分依据,视图与质量问题的对应,跨视图映射、视图一致性与文档入口。

66 张卡片 · 16 本书

主题索引

用声明表达接口契约

比较如何借助语言声明(删除、重写标记、异常规格、常量性、作用域等)让编译器强制接口意图。

62 张卡片 · 22 本书

主题索引

软件架构的定义与流派

比较组成派与决策派等软件架构定义流派的关注点与局限,以及架构学科从软件危机和开发阶段演进中分化出来的动因。

49 张卡片 · 18 本书

主题索引

架构师与团队协作

比较架构师通过提问、请求协助、会议选择和答疑时间与开发团队协作的做法及边界。

44 张卡片 · 13 本书

主题索引

C4模型与架构可视化

比较用语境、容器、组件、类四层抽象描述软件架构的方法:草图的常见缺陷、分层视图的边界、图与代码的映射、图例与评审清单。

30 张卡片 · 3 本书