来源书籍

架构整洁之道

Skill 版本:v23 软件设计与复杂性管理类 经典原理(高信息浓度 + 高稳定性) 126 张卡片

精读第一章"设计与架构究竟是什么"确认:全书开篇即用真实公司团队规模扩张但生产力 持续下滑(每行代码变更成本8个版本内暴涨40倍)的案例,论证"软件架构的终极目标是用最小人力 成本满足构建和维护系统的需求"这一核心命题,随后用类比与实验数据(TDD 6天实验:稳扎稳打反而 更快)层层展开为什么"过度自信、延迟治理代码质量"必然导致系统退化——这是纯粹讲"为什么"的 论证而非讲某个工具"怎么用"的操作手册。信息浓度极高。稳定性方面,全书虽然援引Java/C++等语言 特性和具体框架(Web框架、数据库驱动)作为例证,但这些始终是用来讲解SOLID原则、组件聚合与 耦合、依赖方向、架构边界这些跨语言跨技术栈长期成立的设计原则的载体——"高层策略应独立于低层 实现细节"这类结论不会因为某个框架或数据库产品的迭代而过时。综合定级:高信息浓度+高稳定性= 经典原理。 **类别说明**:核对`category-checklists.md`中"系统架构类"(判定标准:"以讲解大型软件系统 整体架构设计(微服务、分层架构等,不针对单一具体框架)为主要目标的书籍",必答清单聚焦服务 拆分、跨服务通信、跨服务一致性、可观测性、熔断降级、部署发布策略)——本书主线是单一代码库 内部的组件边界、依赖方向、SOLID原则与实现细节隔离,并非围绕微服务/分布式系统的服务拆分与 跨服务治理展开,与该类别必答清单逐条对不上。检索全书章节标题与目录,也未发现契合"编程语言 类""框架类""领域建模类""数据库/存储引擎类""分布式系统类""可观测性/监控类""工程管理/团队 协作类"等其他已定义类别判定标准的主线内容。本书主题(面向对象架构设计原则)足够通用、后续 可能有同类书籍复用,但因当前处于无人值守自动化流程中,无法与用户交互确认是否新增类别,故 暂不记录类别字段,阶段五按规则跳过;待后续人工复核时,可考虑提议新增"面向对象架构设计类" 类别(必答清单草案:SRP/OCP/LSP/ISP/DIP五原则的应用边界、组件聚合与耦合的度量、依赖方向与 架构边界划分、"细节可替换"的判定标准、整洁架构的同心圆分层)。

[美] Robert C. Martin · 孙宇聪 译 · 电子工业出版社 · 2018-09 · 2018年9月第1版 · ISBN 9787121347962

类别清单覆盖

7/7

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

章节与卡片

01 第1章 设计与架构究竟是什么

1 张卡片
  1. 设计与架构是连续体 理解等级:未标注 普通读书笔记卡

01 设计与架构究竟是什么

1 张卡片
  1. 架构目标是最小人力成本 理解等级:未标注 普通读书笔记卡

01 第1章 设计与架构究竟是什么

1 张卡片
  1. 要跑得快先跑得稳 理解等级:未标注 普通读书笔记卡

02 两个价值维度

3 张卡片
  1. 行为价值与架构价值 理解等级:未标注 普通读书笔记卡
  2. 架构价值高于行为价值 理解等级:未标注 普通读书笔记卡
  3. 为好架构持续斗争 理解等级:未标注 普通读书笔记卡

03 编程范式总览

1 张卡片
  1. 编程范式都在移除能力 理解等级:未标注 结构图卡

04 结构化编程

1 张卡片
  1. 结构化编程与goto 理解等级:未标注 普通读书笔记卡

04 第4章 结构化编程

1 张卡片
  1. 可证伪的程序单元 理解等级:未标注 普通读书笔记卡

05 第5章 面向对象编程

3 张卡片
  1. 封装与继承非OOP独有 理解等级:未标注 结构图卡
  2. 多态催生插件式架构 理解等级:未标注 结构图卡
  3. 依赖反转是OOP的本质 理解等级:未标注 结构图卡

06 第6章 函数式编程

3 张卡片
  1. 不可变性与可变性隔离 理解等级:未标注 普通读书笔记卡
  2. 事件溯源 理解等级:未标注 普通读书笔记卡
  3. 惰性序列按需计算 理解等级:中级 普通读书笔记卡

07 第7章 SRP:单一职责原则

3 张卡片
  1. SRP只对一类行为者负责 理解等级:未标注 结构图卡
  2. 按行为者拆分代码 理解等级:未标注 结构图卡
  3. SOLID处理中层结构 理解等级:中级 普通读书笔记卡

08 OCP:开闭原则

1 张卡片
  1. OCP保护高层组件 理解等级:未标注 结构图卡

08 第8章 OCP:开闭原则

1 张卡片
  1. 接口的信息隐藏作用 理解等级:未标注 结构图卡

09 第9章 LSP:里氏替换原则

1 张卡片
  1. LSP与正方形长方形 理解等级:未标注 结构图卡

09 LSP:里氏替换原则

1 张卡片
  1. LSP在架构层面 理解等级:未标注 普通读书笔记卡

10 第10章 ISP:接口隔离原则

1 张卡片
  1. ISP的源码级成因 理解等级:未标注 结构图卡

10 ISP:接口隔离原则

1 张卡片
  1. 依赖不需要的东西有害 理解等级:未标注 普通读书笔记卡

11 DIP:依赖反转原则

1 张卡片
  1. DIP关注易变实现 理解等级:未标注 普通读书笔记卡

11 第11章 DIP:依赖反转原则

1 张卡片
  1. 抽象工厂与依赖反转 理解等级:未标注 结构图卡

12 组件

2 张卡片
  1. 组件是最小部署单元 理解等级:未标注 普通读书笔记卡
  2. 插件式架构的历史 理解等级:未标注 普通读书笔记卡

12 第12章 组件

1 张卡片
  1. 重定位与符号链接 理解等级:中级 普通读书笔记卡

13 组件聚合

3 张卡片
  1. REP复用发布等同 理解等级:未标注 普通读书笔记卡
  2. CCP共同闭包原则 理解等级:未标注 普通读书笔记卡
  3. CRP共同复用原则 理解等级:未标注 普通读书笔记卡

13 第13章 组件聚合

1 张卡片
  1. 组件聚合张力图 理解等级:未标注 结构图卡

14 第14章 组件耦合

2 张卡片
  1. ADP无依赖环原则 理解等级:未标注 结构图卡
  2. 打破循环依赖 理解等级:未标注 结构图卡

14 组件耦合

3 张卡片
  1. SDP稳定依赖原则 理解等级:未标注 普通读书笔记卡
  2. SAP稳定抽象原则 理解等级:未标注 普通读书笔记卡
  3. 主序列与I/A图 理解等级:未标注 结构图卡

14 第14章 组件耦合

1 张卡片
  1. 组件依赖随构建演进 理解等级:中级 普通读书笔记卡

15 什么是软件架构

4 张卡片
  1. 架构师应写代码 理解等级:未标注 普通读书笔记卡
  2. 架构对四阶段的影响 理解等级:未标注 普通读书笔记卡
  3. 保持可选项 理解等级:未标注 普通读书笔记卡
  4. 设备无关性的历史案例 理解等级:未标注 普通读书笔记卡

16 独立性

4 张卡片
  1. 良好架构的四大目标 理解等级:未标注 普通读书笔记卡
  2. 水平分层与垂直切分 理解等级:未标注 结构图卡
  3. 表面重复与真正重复 理解等级:未标注 普通读书笔记卡
  4. 三种解耦粒度 理解等级:未标注 普通读书笔记卡

17 划分边界

5 张卡片
  1. 边界推迟不成熟决策 理解等级:未标注 普通读书笔记卡
  2. P公司与W公司的教训 理解等级:未标注 普通读书笔记卡
  3. FitNesse推迟数据库 理解等级:未标注 普通读书笔记卡
  4. 数据库边界的画法 理解等级:未标注 结构图卡
  5. I/O无关紧要 理解等级:未标注 普通读书笔记卡

18 边界剖析

3 张卡片
  1. 跨边界调用的依赖方向 理解等级:未标注 结构图卡
  2. 四种边界物理形式 理解等级:未标注 普通读书笔记卡
  3. 线程不是架构边界 理解等级:初级 普通读书笔记卡

19 策略与层次

2 张卡片
  1. 层次按离I/O远近定义 理解等级:未标注 普通读书笔记卡
  2. 加密程序案例 理解等级:未标注 结构图卡

20 业务逻辑

3 张卡片
  1. 业务实体 理解等级:未标注 普通读书笔记卡
  2. 用例 理解等级:未标注 普通读书笔记卡
  3. 请求响应模型 理解等级:未标注 普通读书笔记卡

21 尖叫的软件架构

2 张卡片
  1. 尖叫的架构 理解等级:未标注 普通读书笔记卡
  2. 框架是工具不是信条 理解等级:未标注 普通读书笔记卡

22 整洁架构

4 张卡片
  1. 整洁架构的依赖规则 理解等级:未标注 结构图卡
  2. 整洁架构四层职责 理解等级:未标注 普通读书笔记卡
  3. 跨边界的输出端接口 理解等级:未标注 结构图卡
  4. 整洁架构Java案例 理解等级:未标注 结构图卡

23 展示器和谦卑对象

2 张卡片
  1. 谦卑对象模式 理解等级:未标注 普通读书笔记卡
  2. 谦卑对象在网关与ORM 理解等级:未标注 普通读书笔记卡

24 不完全边界

2 张卡片
  1. 省掉最后一步的边界 理解等级:未标注 普通读书笔记卡
  2. 单向边界与门户模式 理解等级:未标注 普通读书笔记卡

25 层次与边界

3 张卡片
  1. Wumpus游戏案例 理解等级:未标注 结构图卡
  2. 数据流持续分裂 理解等级:未标注 普通读书笔记卡
  3. 边界决策需持续权衡 理解等级:未标注 普通读书笔记卡

26 Main组件

1 张卡片
  1. Main组件也是插件 理解等级:未标注 普通读书笔记卡

27 服务:宏观与微观

3 张卡片
  1. 服务不等于架构 理解等级:未标注 普通读书笔记卡
  2. 运送猫咪的难题 理解等级:未标注 普通读书笔记卡
  3. 服务边界非架构边界 理解等级:未标注 结构图卡

28 测试边界

2 张卡片
  1. 测试是最外圈组件 理解等级:未标注 普通读书笔记卡
  2. 测试专用API 理解等级:未标注 普通读书笔记卡

29 整洁的嵌入式架构

7 张卡片
  1. 固件的重新定义 理解等级:未标注 普通读书笔记卡
  2. 程序适用测试的局限 理解等级:未标注 普通读书笔记卡
  3. 硬件抽象层HAL 理解等级:未标注 普通读书笔记卡
  4. 处理器是实现细节 理解等级:未标注 普通读书笔记卡
  5. 操作系统抽象层 理解等级:未标注 普通读书笔记卡
  6. 用HAL取代条件编译 理解等级:未标注 普通读书笔记卡
  7. 静态多态与重编译 理解等级:中级 普通读书笔记卡

30 数据库只是实现细节

1 张卡片
  1. 数据库是实现细节 理解等级:未标注 普通读书笔记卡

30 第30章 数据库只是实现细节

1 张卡片
  1. 假设磁盘不存在 理解等级:未标注 普通读书笔记卡

30 数据库只是实现细节

1 张卡片
  1. 市场驱动的数据库 理解等级:未标注 普通读书笔记卡

31 Web是实现细节

2 张卡片
  1. 计算资源的钟摆 理解等级:未标注 普通读书笔记卡
  2. GUI与Web是实现细节 理解等级:未标注 普通读书笔记卡

32 应用程序框架是实现细节

2 张卡片
  1. 与框架的单向婚姻 理解等级:未标注 普通读书笔记卡
  2. 不要嫁给框架 理解等级:未标注 普通读书笔记卡

33 第33章 案例分析:视频销售网站

2 张卡片
  1. 视频网站用例分析 理解等级:未标注 普通读书笔记卡
  2. 控制流与依赖分离 理解等级:未标注 结构图卡

34 拾遗

1 张卡片
  1. 按层与按功能封装 理解等级:未标注 普通读书笔记卡

34 第34章 拾遗

4 张卡片
  1. 端口和适配器 理解等级:未标注 结构图卡
  2. 按组件封装 理解等级:未标注 结构图卡
  3. 宽松分层的陷阱 理解等级:未标注 结构图卡
  4. 用访问修饰符强制架构 理解等级:未标注 结构图卡

34 拾遗

1 张卡片
  1. 其他解耦合模式 理解等级:未标注 普通读书笔记卡

34 第34章 拾遗

1 张卡片
  1. 把设计检查融入迭代 理解等级:中级 普通读书笔记卡

00

4 张卡片
  1. 分离业务逻辑与运行控制 理解等级:中级 普通读书笔记卡
  2. 按变化职责隔离发布 理解等级:高级 普通读书笔记卡
  3. 架构视图需要说明取舍 理解等级:中级 普通读书笔记卡
  4. 从代码构造认识设计共性 理解等级:高级 普通读书笔记卡

35 架构设计考古

20 张卡片
  1. 换入换出配合输出缓冲 理解等级:中级 普通读书笔记卡
  2. 固定入口反转调用依赖 理解等级:中级 普通读书笔记卡
  3. 有DSL仍可能强耦合 理解等级:中级 普通读书笔记卡
  4. 让分析靠近交互端 理解等级:中级 普通读书笔记卡
  5. 向量表支撑局部更新 理解等级:中级 普通读书笔记卡
  6. 难懂核心会被冻结 理解等级:中级 普通读书笔记卡
  7. 串口翻译难替代抽象 理解等级:中级 普通读书笔记卡
  8. 重写追逐移动目标 理解等级:中级 普通读书笔记卡
  9. 地区分叉积累合并成本 理解等级:中级 普通读书笔记卡
  10. BOSS协作式任务调度 理解等级:中级 普通读书笔记卡
  11. 按真实约束缩小交付 理解等级:中级 普通读书笔记卡
  12. 流水线与终端自治 理解等级:中级 普通读书笔记卡
  13. 内嵌SQL锁定供应商 理解等级:中级 普通读书笔记卡
  14. 状态交接拆成独立进程 理解等级:中级 普通读书笔记卡
  15. 外部状态机控制服务流 理解等级:中级 普通读书笔记卡
  16. 跨进程不传裸指针 理解等级:中级 普通读书笔记卡
  17. 层级数据用字符串传输 理解等级:中级 普通读书笔记卡
  18. 分层不代表依赖正确 理解等级:中级 普通读书笔记卡
  19. 多应用验证复用框架 理解等级:中级 普通读书笔记卡
  20. 软件中断移交执行 理解等级:中级 普通读书笔记卡

全书概览

架构整洁之道

类别:软件设计与复杂性管理类

Skill 版本:v7

执行模式:light

建档进度:done

本次实际使用规则:book-notes v8(2026-09-25 按 _card_review.md 完成 S4:78 张普通卡正文压缩至 200 字内、95 张卡标题压缩至 15 字内并统一文件名、清除归因句式、断链修复、摘录 95⁄95 逐字复核;补做阶段五类别清单核对与主题索引维护),详见 _workflow.md。

四象限结论:经典原理(高信息浓度 + 高稳定性)

理由:精读第一章”设计与架构究竟是什么”确认:全书开篇即用真实公司团队规模扩张但生产力 持续下滑(每行代码变更成本8个版本内暴涨40倍)的案例,论证”软件架构的终极目标是用最小人力 成本满足构建和维护系统的需求”这一核心命题,随后用类比与实验数据(TDD 6天实验:稳扎稳打反而 更快)层层展开为什么”过度自信、延迟治理代码质量”必然导致系统退化——这是纯粹讲”为什么”的 论证而非讲某个工具”怎么用”的操作手册。信息浓度极高。稳定性方面,全书虽然援引Java/C++等语言 特性和具体框架(Web框架、数据库驱动)作为例证,但这些始终是用来讲解SOLID原则、组件聚合与 耦合、依赖方向、架构边界这些跨语言跨技术栈长期成立的设计原则的载体——”高层策略应独立于低层 实现细节”这类结论不会因为某个框架或数据库产品的迭代而过时。综合定级:高信息浓度+高稳定性= 经典原理。

类别说明:核对category-checklists.md中”系统架构类”(判定标准:”以讲解大型软件系统 整体架构设计(微服务、分层架构等,不针对单一具体框架)为主要目标的书籍”,必答清单聚焦服务 拆分、跨服务通信、跨服务一致性、可观测性、熔断降级、部署发布策略)——本书主线是单一代码库 内部的组件边界、依赖方向、SOLID原则与实现细节隔离,并非围绕微服务/分布式系统的服务拆分与 跨服务治理展开,与该类别必答清单逐条对不上。检索全书章节标题与目录,也未发现契合”编程语言 类”“框架类”“领域建模类”“数据库/存储引擎类”“分布式系统类”“可观测性/监控类”“工程管理/团队 协作类”等其他已定义类别判定标准的主线内容。本书主题(面向对象架构设计原则)足够通用、后续 可能有同类书籍复用,但因当前处于无人值守自动化流程中,无法与用户交互确认是否新增类别,故 暂不记录类别字段,阶段五按规则跳过;待后续人工复核时,可考虑提议新增”面向对象架构设计类” 类别(必答清单草案:SRP/OCP/LSP/ISP/DIP五原则的应用边界、组件聚合与耦合的度量、依赖方向与 架构边界划分、”细节可替换”的判定标准、整洁架构的同心圆分层)。

章节进度追踪表

全部实质正文按spine完整读取,不再按历史“略读/类别”预排除。卡片数按整书笔记primary所属正文项统计;附录A的ch35仅是文件技术编号,不冒充原书第35章。

章节号 章节标题 状态(pending/done) 卡片数
preface-1 推荐序一 done 1
preface-2 推荐序二 done 1
preface-3 序言 done 1
preface-4 前言 done 1
part-01-intro 第1部分 概述 done 0
01 第1章 设计与架构究竟是什么 done 3
02 第2章 两个价值维度 done 3
part-02-intro 第2部分 从基础构件开始:编程范式 done 0
03 第3章 编程范式总览 done 1
04 第4章 结构化编程 done 2
05 第5章 面向对象编程 done 3
06 第6章 函数式编程 done 3
part-03-intro 第3部分 设计原则 done 1
07 第7章 SRP:单一职责原则 done 2
08 第8章 OCP:开闭原则 done 2
09 第9章 LSP:里氏替换原则 done 2
10 第10章 ISP:接口隔离原则 done 2
11 第11章 DIP:依赖反转原则 done 2
part-04-intro 第4部分 组件构建原则 done 0
12 第12章 组件 done 3
13 第13章 组件聚合 done 4
14 第14章 组件耦合 done 6
15 什么是软件架构 done 4
16 独立性 done 4
17 划分边界 done 5
18 边界剖析 done 3
19 策略与层次 done 2
20 业务逻辑 done 3
21 尖叫的软件架构 done 2
22 整洁架构 done 4
23 展示器和谦卑对象 done 2
24 不完全边界 done 2
25 层次与边界 done 3
26 Main组件 done 1
27 服务:宏观与微观 done 3
28 测试边界 done 2
29 整洁的嵌入式架构 done 7
30 第30章 数据库只是实现细节 done 3
31 第31章 Web是实现细节 done 2
32 第32章 应用程序框架是实现细节 done 2
33 第33章 案例分析:视频销售网站 done 2
34 第34章 拾遗 done 6
postface 后序 done 1
appendix-a 附录A 架构设计考古 done 20

类别清单核对(软件设计与复杂性管理类)

维度 覆盖状态 关联卡片标题或未覆盖理由
复杂性的来源与度量 已覆盖 架构目标是最小人力成本、要跑得快先跑得稳、主序列与I/A图
简约性与可理解性原则 已覆盖 尖叫的架构、表面重复与真正重复、用例
模块边界与抽象分层 已覆盖 整洁架构的依赖规则、整洁架构四层职责、四种边界物理形式、SRP只对一类行为者负责
变化、演化与维护成本 已覆盖 行为价值与架构价值、保持可选项、边界决策需持续权衡、三种解耦粒度
缺陷、质量与设计反馈 已覆盖 可证伪的程序单元、LSP在架构层面、固件的重新定义
测试、验证与重构安全 已覆盖 测试是最外圈组件、测试专用API、谦卑对象模式
设计决策与团队沟通 已覆盖 为好架构持续斗争、架构师应写代码、边界推迟不成熟决策

核对结论:7/7 维度已覆盖(2026-09-25 按 v8 补做;类别字段早已记为软件设计与复杂性管理类,此前因无人值守跳过了核对),均由既有卡片支撑,未为凑清单补卡。

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 go-clean-arch源码深读 实现深读 done 11/22/26 固定公开提交及首轮入口映射、快速与详细阅读计划
002 审计cardbox依赖方向 证据验证 done 14/17/30 实际源代码首轮责任样本及待验证清单
003 三种架构横向比较 横向学习 done 22⁄34 原始文章已读后的首轮对照与后续问题

实践筛选完成:是。保留实际实现、当前应用责任观察与架构表达比较三种不同目标,合并重复的重构/造轮子候选;不另造完整应用。已准备专项首轮材料,不等于完成全项目阅读、全库审计、重构或现实干预,未执行部分如实保留。

非正文排除

spine项 类型 排除理由
1 封面 SVG封面图,无论述
2 扉页 书名作者译者出版社信息
3 版权/出版简介 内容简介介绍全书安排和适合读者,无展开独立机制;其余核验版次ISBN出版信息
8 致谢与服务 贡献者名单、勘误服务入口,不含软件设计论述
9 作者简介 出版时的职业履历和作品名单,不将历史职务当作当前事实
10 审校者简介 履历及译作名单,无独立知识解释
11 目录 纯目录结构,用于核对阅读范围,不替代正文阅读

待关联术语

术语名 出现章节 一句话语境
CAP preface-1 用作取舍类比,仅提名,不采用“任意三选二”作为定理表述。
Redis preface-2 案例中集中共享状态的产品,未介绍内部实现。
PDP-8 preface-4 作者早期编程设备示例,未展开体系结构。
FORTRAN preface-4 用于比较代码基础构造的语言例子。
测试驱动开发(TDD) 01 实验对比方法,仅介绍名称与耗时,未展开开发流程。
汇编器 part-02-intro 编程语言或工具发展史中提名,未展开机制。
编译器 part-02-intro 编程语言或工具发展史中提名,未展开机制。
FORTRAN part-02-intro 编程语言或工具发展史中提名,未展开机制。
COBOL part-02-intro 编程语言或工具发展史中提名,未展开机制。
PL/1 part-02-intro 编程语言或工具发展史中提名,未展开机制。
SNOBOL part-02-intro 编程语言或工具发展史中提名,未展开机制。
Pascal part-02-intro 编程语言或工具发展史中提名,未展开机制。
λ演算 06 函数式编程思想来源,未展开演算规则。
Clojure 06 函数式语言示例,语法与惰性求值已在正文及对应卡解释,不将语言误登记为框架。
康威定律 part-03-intro 用开发组织内部结构与软件结构关系概括SRP背景,主旨已并入SRP语境。
REST 09 服务接口协议示例,未展开REST约束。
Active-X 12 组件打包、管理或演进例子中纯提名。
摩尔定律 12 组件打包、管理或演进例子中纯提名。
PDP-8 12 组件打包、管理或演进例子中纯提名。
Maven 13 模块管理工具的纯提名示例。
Leiningen 13 模块管理工具的纯提名示例。
RVM 13 模块管理工具的纯提名示例。
REST 15 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
SOA 15 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
依赖注入框架 15 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
PDP-8 15 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
SOA 16 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
WSDL 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
BPEL 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
SOA 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Maven 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
MySQL 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Couch 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Datomic 17 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
WAR 18 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
DLL 18 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Ruby Gem 18 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
socket 18 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
URI 18 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
HttpRequest 20 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
HttpResponse 20 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Rails 21 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Spring 21 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Hibernate 21 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Tomcat 21 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
ASP 21 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Hibernate 23 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
微服务 25 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
依赖注入框架 26 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
SOLID 27 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
Cucumber 28 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
TDD 28 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
BDD 28 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
SpecFlow 28 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
JBehave 28 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
TDM 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
VOIP 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
UART 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
EPROM 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
RTOS 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
GPIO 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
A/D 29 在本章作为具体技术、工具或跨章概念例子出现,未独立展开其完整机制;不根据提名另造卡片。
查询优化器 30 硬盘与数据访问机制历史中提名,未展开具体算法。
SQL 30 硬盘与数据访问机制历史中提名,未展开具体算法。
T1线路 30 硬盘与数据访问机制历史中提名,未展开具体算法。
Oracle 30 关系型数据库产品提名,未展开产品特性。
MySQL 30 关系型数据库产品提名,未展开产品特性。
SQL Server 30 关系型数据库产品提名,未展开产品特性。
Applets 31 计算资源集中分散演变中的技术提名。
Ajax 31 计算资源集中分散演变中的技术提名。
Web 2.0 31 计算资源集中分散演变中的技术提名。
Node.js 31 计算资源集中分散演变中的技术提名。
客户端/服务器 31 计算资源集中分散演变中的技术提名。
STL 32 难免的稳定标准类库依赖示例,未展开容器/算法。
CQRS 34 实现约束或工具列表中提名,未单独展开机制。
OSGi 34 实现约束或工具列表中提名,未单独展开机制。
Java 9模块系统 34 实现约束或工具列表中提名,未单独展开机制。
Ndepend 34 实现约束或工具列表中提名,未单独展开机制。
Structure101 34 实现约束或工具列表中提名,未单独展开机制。
Checkstyle 34 实现约束或工具列表中提名,未单独展开机制。
Maven 34 实现约束或工具列表中提名,未单独展开机制。
Gradle 34 实现约束或工具列表中提名,未单独展开机制。
MSBUILD 34 实现约束或工具列表中提名,未单独展开机制。
聚合根 34 实现约束或工具列表中提名,未单独展开机制。
反射 34 实现约束或工具列表中提名,未单独展开机制。
测试驱动开发(TDD) postface 用测试后的短反馈间隔加入设计检查,未展开TDD全部步骤。
CRT 附录A 早期单色字符终端,作为设备环境出现;脚注释名。
CRUD 附录A 财务记录增删改查的简写,不据此补造资金并发案例。
GE Datanet 30 附录A 早期记账系统硬件平台。
Varian 620/f 附录A 替换早期大型硬件的小型机。
M365 附录A 电话测试系统的早期硬件平台。
8085 附录A 后续嵌入式硬件平台,未介绍指令集。
EPROM 附录A 芯片烧录和独立更新的设备背景,脚注说明紫外擦除。
CICS-COBOL 附录A 主机显示统计结果的技术环境,未展开。
UNIX 附录A 系统重写所用环境,未展开操作系统机制。
MP/M-86 附录A 电子前台的多任务操作系统环境,未展开其内部机制。
BPEL 附录A 作者对外部状态机可组合流程的后见类比,未展开标准。
T1 附录A 创业项目监测的数字传输线路背景。
X-Window 附录A 当时图形界面技术环境。
UUCP 附录A 早期拨号通信与网络讨论背景。
Netnews 附录A 作者参与公开设计讨论的媒介,非独立设计方法。
CASE 附录A 计算机辅助软件工程工具背景,脚注释名。
UML 附录A Booch表达法的后续关联,未在附录展开。
CAD 附录A 答题图形界面的操作形式类比,未展开工具方法。

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境
代码整洁之道 书 preface-1 对照由代码组织到架构设计的讨论范围。
代码整洁之道:程序员的职业素养 书 preface-1 对照职业修养与本书软件设计目标。
Big Ball of Mud 论文 preface-3 序言对软件结构缠绕现象的概念引用,未介绍论文内容。
伊索寓言 书 01 龟兔赛跑用来类比过度自信。
Go To Statement Considered Harmful 论文 04 Dijkstra在CACM发表的关于无限制跳转的信件。
Data Abstraction and Hierarchy 论文 09 Liskov子类型定义出处;完整脚注位于本部分末章11。
Agile Software Development, Principles, Patterns, and Practices 书 11 SOLID相关原则扩展阅读。
Object Oriented Software Construction 书 11 OCP出处补充脚注。
Data Abstraction and Hierarchy 论文 11 LSP定义出处补充脚注。
Minecraft 源码项目 12 以jar放入目录安装模块的例子。
Resharper 框架 12 DLL插件安装的例子,未展开内部原理。
Object Oriented Software Engineering: A Use-Case Driven Approach 书 21 用例驱动架构的引用来源。
Growing Object Oriented Software with Tests 书 22 六边形架构的推荐来源,未介绍全书。
DCI架构 框架 22 与其他关注点分离架构并列提名,未展开专属方法。
BCE架构 框架 22 与其他架构并列列举,未独立展开。
六边形架构(端口与适配器) 框架 22 用于说明共同的关注点分离目标,独有机制未展开。
Object Oriented Software Engineering: A Use-Case Driven Approach 书 22 BCE架构的引用来源。
The Growing Importance of Sustaining Software for the DoD 论文 29 Doug Schmidt关于软件寿命、硬件演进与维护的文章,借其观点发起本章讨论。
人月神话 书 29 引用“抛弃一个设计”解释学习后重写,不实质介绍全书。
The Pragmatic Programmer 书 29 集中脚注24中的DRY原则参考来源。
The Practical Guide to Structured Systems Design 书 29 集中脚注8、17中的中央转换器来源,对应第19、25章。
Object Oriented Software Engineering 书 29 集中脚注9中的业务实体术语来源,对应第20章。
xUnit Test Patterns: Refactoring Test Code 书 29 集中脚注11中的谦卑对象模式参考来源,对应第23章。
Patterns of Enterprise Application Architecture 书 29 集中脚注13中的数据库网关参考来源,对应第23章。
Presentation Domain Data Layering 论文 34 Martin Fowler论述初始分层结构的文章。
Big Ball of Mud 论文 34 一团泥巴的延伸链接。
The C Programming Language 书 附录A 学习C语言的阅读背景,未展开该书内容。
The C++ Programming Language 书 附录A 对象设计学习时列举的著作,未实质介绍。
The Annotated C++ Reference Manual 书 附录A 对象设计学习的著作提名。
Designing Object Oriented Software 书 附录A 责任驱动设计的阅读背景,未介绍该书方法。
OOA 书 附录A Peter Coad的面向对象著作提名。
OOD 书 附录A Peter Coad的面向对象著作提名。
OOP 书 附录A Peter Coad的面向对象著作提名。
Smalltalk-80 书 附录A Adele Goldberg著作的阅读背景。
Advanced C++ Programming Styles and Idioms 书 附录A James O. Coplien著作的阅读背景。
Object Oriented Design with Applications 书 附录A Grady Booch的对象设计著作,作为个人学习背景出现。
Object-Oriented Analysis and Design with Applications 书 附录A Booch表达法的著作来源,未介绍全书。
Designing Object-Oriented C++ Applications Using the Booch Method 书 附录A 作者写作经历所提著作,未展开该书内容。

资金安全问题案例

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

主题索引维护

本书以 SOLID、组件原则与整洁架构为主线;新建 SOLID 设计原则、组件聚合与耦合原则 2 个主题,其余并入架构原则、编程范式、分层/端口架构、测试、嵌入式、微服务边界等已有主题。

卡片标题 结论 主题文件或原因
设计与架构是连续体 已复用 notes/_topics/architecture-principles-complexity.md
架构目标是最小人力成本 已复用 notes/_topics/architecture-principles-complexity.md
要跑得快先跑得稳 已复用 notes/_topics/architecture-principles-complexity.md
行为价值与架构价值 已复用 notes/_topics/architecture-principles-complexity.md
架构价值高于行为价值 已复用 notes/_topics/architecture-principles-complexity.md
为好架构持续斗争 已复用 notes/_topics/architecture-principles-complexity.md
编程范式都在移除能力 已复用 notes/_topics/programming-paradigm-design.md
结构化编程与goto 已复用 notes/_topics/programming-paradigm-design.md
可证伪的程序单元 已复用 notes/_topics/programming-paradigm-design.md
封装与继承非OOP独有 已复用 notes/_topics/programming-paradigm-design.md
多态催生插件式架构 已复用 notes/_topics/programming-paradigm-design.md
依赖反转是OOP的本质 已创建 notes/_topics/solid-principles.md
不可变性与可变性隔离 已复用 notes/_topics/programming-paradigm-design.md
事件溯源 已复用 notes/_topics/programming-paradigm-design.md
SRP只对一类行为者负责 已创建 notes/_topics/solid-principles.md
按行为者拆分代码 已创建 notes/_topics/solid-principles.md
OCP保护高层组件 已创建 notes/_topics/solid-principles.md
接口的信息隐藏作用 已创建 notes/_topics/solid-principles.md
LSP与正方形长方形 已创建 notes/_topics/solid-principles.md
LSP在架构层面 已创建 notes/_topics/solid-principles.md
ISP的源码级成因 已创建 notes/_topics/solid-principles.md
依赖不需要的东西有害 已创建 notes/_topics/solid-principles.md
DIP关注易变实现 已创建 notes/_topics/solid-principles.md
抽象工厂与依赖反转 已创建 notes/_topics/solid-principles.md
组件是最小部署单元 已创建 notes/_topics/component-cohesion-coupling.md
插件式架构的历史 已创建 notes/_topics/component-cohesion-coupling.md
REP复用发布等同 已创建 notes/_topics/component-cohesion-coupling.md
CCP共同闭包原则 已创建 notes/_topics/component-cohesion-coupling.md
CRP共同复用原则 已创建 notes/_topics/component-cohesion-coupling.md
组件聚合张力图 已创建 notes/_topics/component-cohesion-coupling.md
ADP无依赖环原则 已创建 notes/_topics/component-cohesion-coupling.md
打破循环依赖 已创建 notes/_topics/component-cohesion-coupling.md
SDP稳定依赖原则 已创建 notes/_topics/component-cohesion-coupling.md
SAP稳定抽象原则 已创建 notes/_topics/component-cohesion-coupling.md
主序列与I/A图 已创建 notes/_topics/component-cohesion-coupling.md
架构师应写代码 已复用 notes/_topics/architecture-principles-complexity.md
架构对四阶段的影响 已复用 notes/_topics/architecture-principles-complexity.md
保持可选项 已复用 notes/_topics/architecture-principles-complexity.md
设备无关性的历史案例 已复用 notes/_topics/architecture-principles-complexity.md
良好架构的四大目标 已复用 notes/_topics/architecture-principles-complexity.md
水平分层与垂直切分 已复用 notes/_topics/modularity-information-hiding.md
表面重复与真正重复 已复用 notes/_topics/modularity-information-hiding.md
三种解耦粒度 已复用 notes/_topics/microservice-boundaries-evolution.md
边界推迟不成熟决策 已复用 notes/_topics/layered-architecture-ports.md
P公司与W公司的教训 已复用 notes/_topics/layered-architecture-ports.md
FitNesse推迟数据库 已复用 notes/_topics/layered-architecture-ports.md
数据库边界的画法 已复用 notes/_topics/layered-architecture-ports.md
I/O无关紧要 已复用 notes/_topics/layered-architecture-ports.md
跨边界调用的依赖方向 已复用 notes/_topics/layered-architecture-ports.md
四种边界物理形式 已复用 notes/_topics/layered-architecture-ports.md
层次按离I/O远近定义 已复用 notes/_topics/layered-architecture-ports.md
加密程序案例 已复用 notes/_topics/layered-architecture-ports.md
业务实体 已复用 notes/_topics/layered-architecture-ports.md
用例 已复用 notes/_topics/layered-architecture-ports.md
请求响应模型 已复用 notes/_topics/layered-architecture-ports.md
尖叫的架构 已复用 notes/_topics/layered-architecture-ports.md
框架是工具不是信条 已复用 notes/_topics/layered-architecture-ports.md
整洁架构的依赖规则 已复用 notes/_topics/layered-architecture-ports.md
整洁架构四层职责 已复用 notes/_topics/layered-architecture-ports.md
跨边界的输出端接口 已复用 notes/_topics/layered-architecture-ports.md
整洁架构Java案例 已复用 notes/_topics/layered-architecture-ports.md
谦卑对象模式 已复用 notes/_topics/testing-effectiveness.md
谦卑对象在网关与ORM 已复用 notes/_topics/testing-effectiveness.md
省掉最后一步的边界 已复用 notes/_topics/layered-architecture-ports.md
单向边界与门户模式 已复用 notes/_topics/layered-architecture-ports.md
Wumpus游戏案例 已复用 notes/_topics/layered-architecture-ports.md
数据流持续分裂 已复用 notes/_topics/layered-architecture-ports.md
边界决策需持续权衡 已复用 notes/_topics/layered-architecture-ports.md
Main组件也是插件 已复用 notes/_topics/layered-architecture-ports.md
服务不等于架构 已复用 notes/_topics/microservice-boundaries-evolution.md
运送猫咪的难题 已复用 notes/_topics/microservice-boundaries-evolution.md
服务边界非架构边界 已复用 notes/_topics/microservice-boundaries-evolution.md
测试是最外圈组件 已复用 notes/_topics/testing-effectiveness.md
测试专用API 已复用 notes/_topics/testing-effectiveness.md
固件的重新定义 已复用 notes/_topics/embedded-software-design.md
程序适用测试的局限 已复用 notes/_topics/embedded-software-design.md
硬件抽象层HAL 已复用 notes/_topics/embedded-software-design.md
处理器是实现细节 已复用 notes/_topics/embedded-software-design.md
操作系统抽象层 已复用 notes/_topics/embedded-software-design.md
用HAL取代条件编译 已复用 notes/_topics/embedded-software-design.md
数据库是实现细节 已复用 notes/_topics/storage-model-choices.md
假设磁盘不存在 已复用 notes/_topics/storage-model-choices.md
市场驱动的数据库 已复用 notes/_topics/storage-model-choices.md
计算资源的钟摆 已复用 notes/_topics/layered-architecture-ports.md
GUI与Web是实现细节 已复用 notes/_topics/layered-architecture-ports.md
与框架的单向婚姻 已复用 notes/_topics/layered-architecture-ports.md
不要嫁给框架 已复用 notes/_topics/layered-architecture-ports.md
视频网站用例分析 已复用 notes/_topics/architecture-design-process.md
控制流与依赖分离 已复用 notes/_topics/architecture-design-process.md
按层与按功能封装 已复用 notes/_topics/layered-architecture-ports.md
端口和适配器 已复用 notes/_topics/layered-architecture-ports.md
按组件封装 已复用 notes/_topics/layered-architecture-ports.md
宽松分层的陷阱 已复用 notes/_topics/layered-architecture-ports.md
用访问修饰符强制架构 已复用 notes/_topics/layered-architecture-ports.md
其他解耦合模式 已复用 notes/_topics/layered-architecture-ports.md

本次v23生成交接(2026-10-24)

  • 历史首次Skill版本v7保留;本轮book-notes v23、book-workflow v4,light模式。
  • 阅读正文与定位真源为_book_note.md,阅读证据为_coverage.md;来源核验在_work-v4-20261024/source-manifest.json,历史概览在overview-before-v23.md。
  • 44个实质spine正文项全文读取,原图实际查看;现有126张知识卡,其中新增31张,3张实践卡。整书笔记schema1、118个稳定位置、172条原书出处,每卡唯一primary与至少一处有效来源。
  • 第20章贷款信用分500的临界值图文歧义已明示,不自行裁定真实业务规则;用例及依赖规则解释不依赖这一阈值。
  • 轻量模式:未执行生成后的笔记复核、独立审查及审查结果优化;历史报告不代替本次生成验收。
  • 当前仅阅读生成,待导入dry-run、数据库对账与归档;不得因历史95张卡filed就标本轮完成。

相关主题

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

主题索引

存储模型选型

比较关系型、键值、列式、文档与全文检索等存储模型的特性取舍与适用场景。

699 张卡片 · 63 本书

主题索引

微服务拆分与演进

比较微服务拆分的边界依据、粒度与非业务因素,以及从单体演进和持续重组的策略。

444 张卡片 · 71 本书

主题索引

测试有效性与验证手段

比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。

366 张卡片 · 63 本书

主题索引

架构方案设计与评估

比较备选方案设计、评估选择、容量预估与详细设计等架构设计流程中的判断方法。

352 张卡片 · 40 本书

主题索引

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

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

228 张卡片 · 40 本书

主题索引

单机高性能与I/O模型

比较进程/线程并发模型、I/O 多路复用、Reactor 与 Proactor 等单机高性能设计。

226 张卡片 · 46 本书

主题索引

模块化与信息隐藏

比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。

209 张卡片 · 51 本书

主题索引

分层、洋葱与六边形架构

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

196 张卡片 · 43 本书

主题索引

数据交换格式设计

比较数据交换格式的简洁性、互通性与安全解析要求。

146 张卡片 · 38 本书

主题索引

架构重构

比较识别重构目标、沟通推动与分段实施等架构重构方法。

138 张卡片 · 29 本书

主题索引

组件聚合与耦合原则

比较 REP、CCP、CRP 的组件聚合张力,以及无依赖环、稳定依赖、稳定抽象原则与 I/A 指标对组件耦合的度量。

127 张卡片 · 31 本书

主题索引

线程与任务抽象

线程的创建、状态、join/sleep/中断与收束,任务抽象为什么高于线程,线程池与 ForkJoin 的并行度与工作窃取,守护线程、ThreadLocal 与线程私有栈在什么条件下成立,以及并发结构怎样划分执行与状态;Actor/角色把状态隔离到单一线程、用 Inbox 串行收消息,是这条线的另一种解法。

112 张卡片 · 27 本书

主题索引

分布边界与远程接口

何时才需要分布、远程接口为何要粗粒度,以及远程外观、数据传输对象与序列化格式的设计。

93 张卡片 · 29 本书

主题索引

迭代开发与过程裁剪

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

93 张卡片 · 26 本书

主题索引

SOLID设计原则

比较单一职责、开闭、里氏替换、接口隔离、依赖反转五原则的准确含义,及其从类层面扩展到架构层面的用法。

86 张卡片 · 12 本书

主题索引

架构认知与架构意图

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

81 张卡片 · 14 本书

主题索引

编程范式与设计

比较函数式与面向对象、一切皆对象、鸭子类型与泛型等语言范式对模块化、复用与扩展的影响。

77 张卡片 · 11 本书

主题索引

引擎运行时与状态管理

引擎的三大核心功能与部署形态(嵌入、独立、共享引擎),流程实例的持久化、调度与等待不占线程,流程版本与实例迁移,外部任务与人工任务的执行分离,以及故障恢复、撤销与审计数据的落地方式。

76 张卡片 · 7 本书

主题索引

架构视图与视点

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

66 张卡片 · 16 本书

主题索引

架构腐蚀、坏味道与技术债

比较预期架构与实际架构偏离的成因,架构与代码坏味道、技术债的识别与偿还,以及腐蚀的最小化、预防与修补策略。

64 张卡片 · 19 本书

主题索引

嵌入式硬件认知与抽象

从原理图、数据表、寄存器与引脚出发,怎样把一块板子抽象成软件可用的接口:板级头文件、硬件抽象层、门面与适配器、依赖注入,以及处理器选型、器件版本与文档阅读的判断依据。

57 张卡片 · 5 本书