来源书籍

架构整洁之道

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

全书导读

本书关心的是软件能否以较小的人力代价持续满足构建和维护的需要。软件架构不仅是外观图或采用的框架,更体现在代码怎样组织、职责怎样分开,以及某种变化会迫使哪些部分一起修改。

阅读顺序从目标开始,经过编程范式、对象与组件原则,进入边界和依赖方向,再回到数据库、Web、框架及具体项目的取舍。附录中的职业案例提供这些判断怎样在历史约束中形成的背景。具体产品和设备属于书内语境;本笔记不把示例当成所有系统必须照搬的目录模板。

全书主线

先区分程序此刻能否工作与今后是否容易改变,再用编程范式说明约束能力怎样帮助组织代码。SOLID把讨论推进到中等尺度的职责和依赖,组件原则则处理共同变化、复用和构建发布之间的张力。后半部把这些认识用于用例、实体、边界、测试及部署:高层策略应能通过所需抽象使用外部机制,尽量不被某一技术选择反向控制。

这些原则互相支持,却不是依次执行就必然得到好架构的步骤。边界有代价,推迟选择也有适用条件;开发、运行、部署和维护的需要必须放在同一具体情境里衡量。

推荐序一

推荐序从代码“能运行”逐步转向可维护性,再转向必须作取舍的设计。它提出,业务逻辑回答用户的问题,运行控制安排线程、通信、服务发现或部署等实现条件;分开理解两者有助于降低认知与修改负担。这不是要把所有基础设施都隐藏起来,而是让不同职责有明确边界。末尾的“简单与简陋”等词语作为留给读者的问题,没有给出成套答案,笔记也不补造答案。

分离业务逻辑与运行控制进一步保留这个想法的解释和边界。

原书依据 · 1 处

推荐序二

推荐序中的系统在不修改时较稳定,但外围需求发布会通过混乱依赖影响核心功能。临时处理方式是先分开两类请求:一组运行稳定版本,一组接收更新,用代理决定流向,并将所需共享状态集中管理。这个案例用于说明按变化职责形成边界、为后续改造争取时间;它保留了共享状态等依赖,不能理解成所有故障都已完全隔离。

后半段把结构化编程、面向对象和函数式思路对应到系统层面:可理解的层级组织、可替换接口、受控的可变状态,都能帮助定位复杂度。它们与后文第4–6章形成呼应;具体工程措施仍需按实际约束验证,不能仅凭序言中的成功经历保证可复制。

按变化职责隔离发布进一步保留这个想法的解释和边界。

原书依据 · 1 处

序言

软件结构具有递归性:服务由组件构成,组件又包含更细的模块,最终都落实到代码。任何一幅图只能突出其中某些关系,图中未表达的细节仍可能影响结果。理解架构要同时看视图的选择与代码的实际组织。

变更成本帮助识别决策的重要程度。好的结构应让常规变化进入日常维护,而不是每次都成为昂贵的重建工程。面对无法完整预知的未来,序言批评两种极端:靠僵硬流程压制变化,或为猜测中的需求建立大量通用参数和代码。另一条路线是在原则指导下实现、观察和测量,逐步检验设计猜想。

架构视图需要说明取舍进一步保留这个想法的解释和边界。

原书依据 · 1 处

前言

前言通过作者在嵌入式、批处理、实时控制、Web和不同并发模型中的经历提出本书的问题:为什么许多设计经验能跨系统复用?它把硬件能力、工具质量、程序规模的变化,与代码基本控制构造的相对延续区分开来。

作者由此主张研究组织代码的共同规则。本笔记保留这个写作论点,同时区分论证范围:经历和类比可以揭示值得研究的共性,不足以证明所有运行约束都与年代或平台无关。后续章节将具体说明这些原则如何通过职责、依赖和边界起作用,而不只以“古老智慧”作为权威理由。

从代码构造认识设计共性进一步保留这个想法的解释和边界。

原书依据 · 1 处

第1部分 概述

核心讲解

架构工作的对象是软件构建和后续维护的方式。仅让程序成功运行一次,与让它长期容易修改,是两种不同难度的任务。一个组件纠缠的系统,即使功能已经上线,也可能让很小的改动变成数周工作,使人力、士气和组织持续承压。

好的架构把变更限制在较小、清晰的范围内,让构建和维护需求能用更少人力完成,并同时照顾功能与灵活性。这是后面评价设计的尺度,详见架构目标是最小人力成本。导言中的亲历经验用来建立这个问题意识,不把“好架构必然减少人员”当作无条件保证。

原书依据 · 2 处

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

核心讲解

设计与架构在这里不是底层和高层两个互不相干的阶段,而是从整体布局到实现细节的一系列连续决策。房屋图纸既有房间形状,也要注明插座、开关、管线的位置;软件中的高层结构也必须由底层实现支撑。设计与架构是连续体解释这种连续性,它不表示所有细节必须在开工前一次定完。

评价这组决策,要看系统整个生命周期内满足构建和维护需求所需的人力成本,而不是只看首版上线。匿名案例里,人员和工资快速上升,新增代码增长却逐渐停滞,每行代码变更成本持续上升,说明增加人手不能消除乱麻系统造成的工作负担。图1.1–1.5是同一案例的不同观察面;代码行数是本案例采用的简化指标,不能单独等同于业务价值。架构目标是最小人力成本说明成本尺度。

乱麻的形成未必来自偷懒,也可能来自对未来补救能力过度自信:先赶上线、以后重构,可市场压力持续存在,重构时间不会自动出现。图1.6中的六天罗马数字小实验,采用TDD的三次耗时比不采用的三次更少,是“循规蹈矩未必更慢”的案例证据,并不能单凭这个小实验推出所有项目固定省10%。要跑得快先跑得稳连接整洁、速度与持续负责;若没有改变造成混乱的习惯,推倒重来也可能重复失败。

原书依据 · 5 处

第2章 两个价值维度

核心讲解

软件的行为价值,是现在能按需求做什么;架构价值,是需求改变时还能否方便地改变它。变更的“范畴”指要改变多少功能,“形状”指这些功能与现有组织结构是否碰巧吻合。好的架构应减少这种形状不匹配带来的额外阻力,让成本更多随实际变更范围变化。行为价值与架构价值解释两个维度。

二者不是让团队只顾结构而不交付功能。这里采用两个极端作比较:能运行但事实上改不动的系统,一旦需求变动便失去价值;暂时有错但易修改的系统,还能改好并继续演进。所谓事实上不能改,可能是修改成本超过收益,而不是技术上绝对不可能。架构价值高于行为价值说明为什么持续可变更性关系到行为价值能否延续。

紧急与重要是另一个维度。艾森豪威尔矩阵把工作分成重要且紧急、重要不紧急、不重要但紧急、不重要不紧急四类,并按此排序。架构往往重要而不紧急,功能需求往往紧急但未必重要;不能把所有功能都放进第一类,让重要结构工作一直让位。保护可维护性、解释长期成本并与其他利益相关方协商,是开发人员和架构师本身的职责。为好架构持续斗争将这种责任具体化。

原书依据 · 4 处

第2部分 从基础构件开始:编程范式

核心讲解

编程范式是组织程序的模式,回答什么时候使用何种代码结构,与具体语言的关系小于语言语法本身。理解架构不能只停留在图上,架构最终由代码实现,因此本部分从代码受到哪些限制开始。

导言简述从二进制程序、汇编器、编译器到高级语言的演变:这些工具提高表达和转换效率;范式的变迁则改变程序员怎样组织控制与状态。下章将分别解释结构化、面向对象和函数式三类约束,见编程范式都在移除能力。其中“只有三个范式”的结论应放在作者采用的“通过移除能力施加约束”这个讨论框架里理解。

原书依据 · 4 处

第3章 编程范式总览

核心讲解

编程范式在本章被视为对程序员自由度施加的纪律。结构化编程限制控制权直接转移,用顺序、分支和循环代替任意跳转;面向对象编程规范控制权间接转移,用受约束的多态调用组织原本能由函数指针完成的分派;函数式编程则限制赋值,以不可变性约束状态变化。编程范式都在移除能力将三者放在同一张关系图中。

这些约束不是简单禁止某个关键词。结构化约束使算法能够拆解;多态让调用方依赖稳定的接口,使实现可以在边界另一侧替换;不可变性让数据在哪里变化、谁能修改更容易被控制。它们因此分别连接架构中的功能实现、组件独立性与数据管理。

历史部分说明三者并不按流行时间先后发明:函数式思想追溯到λ演算,面向对象的出现也早于结构化编程的广泛倡导。作者据移除无限制跳转、函数指针和赋值这三个角度提出“可能只有这三类”的判断;这是本章的归纳框架,不应把它读成所有编程方法已经被穷尽。

原书依据 · 4 处

第4章 结构化编程

核心讲解

结构化编程限制不受约束的控制跳转,使程序能够递归分解成较小的单元。顺序、分支与循环足以表达程序,同时又允许逐层分析。Dijkstra追求像数学定理一样证明程序正确:顺序和分支跟踪输入输出,循环则借助归纳以及起止条件。结构化编程与goto解释为何限制goto是为了保留这种可分解结构,并不等于把一切异常或受限跳转视为相同危险。

这种分解还能按功能组织:先把大型问题拆成高级函数,再拆为更低层函数,直到每块责任足够清楚。这让模块、组件和服务都能成为可单独分析的对象。完整形式化证明并未成为日常开发的普遍做法,测试提供了另一条更常用的验证途径。

测试能找到反例,展示缺陷存在,但有限次通过不能证明不存在缺陷。把系统拆成清楚、可测试的小单元,可以更有效地尝试证伪,并在当前目的下建立足够信心;可证伪的程序单元解释这种从数学证明转向经验检验的联系。这里不能把“含goto”直接等同于“任何测试都无法发现错误”:关键是任意跳转会破坏可分析性,测试的证明边界对所有程序都存在。架构师也应在较大层次保留清楚边界,让模块、组件和服务便于测试。

原书依据 · 2 处

第5章 面向对象编程

核心讲解

面向对象编程不能仅用“数据与函数组合”或“模拟现实”解释。封装是把内部数据和实现隐藏起来,只提供需要使用的入口;C用不透明结构体的前置声明就能做到。继承让一种结构提供另一种结构的能力,C也能通过相同的起始成员布局模拟单继承,但需要人工转换。封装与继承非OOP独有说明它们并非面向对象语言独有的发明;这段比较聚焦源码可见性和语言便利,不是对所有语言封装强度作绝对排名。

多态让同一入口随具体实现不同而执行不同操作。书中用FILE结构的open、close、read、write、seek函数指针说明,getchar通过STDIN的read指针读取设备;设备可更换,复制程序不用改。面向对象语言的贡献是更安全、方便地遵循这些调用约定,让插件式使用更普遍。多态催生插件式架构解释设备独立性,它不表示插件架构此前不存在。

源码依赖是编译时必须知道谁,控制流则是运行时谁调用谁,二者可以不同。图5.2里HL1依赖接口I,ML1实现I的F();运行时调用从HL1进入ML1,源码依赖却由ML1指向I。依赖反转是OOP的本质说明这种依赖反转怎样让UI与数据库依赖业务逻辑,把底层实现变成高层策略的插件,并为独立开发、部署创造条件。这些收益仍以契约稳定、组件边界真实可分为条件,接口不是对所有变化的魔法屏障。

原书依据 · 6 处

第6章 函数式编程

核心讲解

不可变性指一个值建立后不再被原地更改。Java平方例子不断改变循环变量i;Clojure例子以range产生整数、map计算平方、take选择前25项,再用println输出。无穷序列并不是预先创建无穷对象,只有被访问的元素才生成。这个对比先让读者看见“不靠反复赋值来描述计算”的含义。

不共享可写状态,可以消除大量由并发修改引发的竞争与更新协调问题。但现实中通常仍要记录变化,因此要把纯计算与修改状态的组件分开,让大部分逻辑保持不可变,只在小范围内保护可变状态。不可变性与可变性隔离解释这种可变性隔离。书中atom示例通过读取旧值、计算新值、比较并替换,冲突则重试来安全递增;它只覆盖单个值,不自动解决多个相关变量的一致更新。

事件溯源把历史变化作为持久记录:账户不直接覆盖余额,而是追加存取款记录,查询时从记录累计。事件溯源解释以存储和重放计算换取减少原地更新的思路。日志越来越长会增加容量与重算成本,必须在生命周期内可承受;只追加不能自动消除事件的顺序、重复或跨事件业务约束,不能把书中简化模型扩大为“系统再无任何并发问题”。本章最后回到三种范式的共同点:通过限制跳转、间接调用或赋值,使软件更容易组织。

惰性序列把元素的生成推迟到真正读取时。Clojure平方示例先用range描述从0开始的整数序列,再用map描述各元素的平方,最后take只取前25项;因此无须先创建无穷多个整数或平方结果。它把“如何产生序列”与“这次实际需要多少项”分开,使有限需求可以使用概念上无限的序列。参见惰性序列按需计算。

原书依据 · 5 处

第3部分 设计原则

核心讲解

SOLID讨论的是怎样将数据和函数分组、再把这些组连接为程序。这里的“类”泛指数据与函数的分组,不限于拥有class语法的面向对象语言。代码质量像砖的质量,中层组织像把砖组合起来的结构,两者都重要;好的中层结构也不能单独保证整体架构正确。

中层设计的目标是容忍变更、容易理解并形成可以复用的组件。五项原则分别要求:模块围绕一类行为者改变(SRP只对一类行为者负责);以扩展减少旧代码改动(OCP保护高层组件);替换组件仍遵守同一契约(LSP与正方形长方形);避免依赖不需要的东西(依赖不需要的东西有害);使底层实现依赖高层策略(DIP关注易变实现)。这些原则先处理贴近代码的模块组织,后文还会把讨论推进到组件与整体架构。

上述中层职责及其与整体架构的边界,详见SOLID处理中层结构。

原书依据 · 15 处

第7章 SRP:单一职责原则

核心讲解

单一职责原则不只是“函数只做一件事”。这里的职责,是模块服务哪一类提出相似变更需求的行为者:可以是同部门多人,也可以是跨部门但诉求相同的人。模块可以是一个源文件,也可以是一组紧密相关的数据和函数。SRP只对一类行为者负责用Employee说明边界:calculatePay面向财务,reportHours面向HR,save面向DBA。

两段代码目前相同,不代表它们属于同一职责。工资和工时报表共享regularHours后,财务改变工时计算就可能悄悄破坏HR报表;两类团队同时改同一文件,也会扩大合并冲突和回归影响。风险来自变更原因不同的代码被绑在一起,而不是文件行数本身。

解法是把各类行为者的函数分开。可以让PayCalculator、HourReporter、EmployeeSaver共同使用EmployeeData;也可以用EmployeeFacade统一入口,内部仍委托各实现;还可以把核心工资逻辑保留在Employee内,把其他责任移走。按行为者拆分代码比较这些分法。每个类可能包含许多私有函数,重点是这些函数都服务同一变化方向。相同思想在组件层次变成共同闭包原则,在架构层次成为划分边界的变更轴。

原书依据 · 5 处

第8章 OCP:开闭原则

核心讲解

开闭原则要求软件易于扩展,同时尽量减少对既有代码的修改。它不是承诺任何新需求都不动旧代码,而是让预期变化发生在受控制的范围内。财务报表例子中,网页需要滚动显示和红色负数,打印版需要分页、页眉页尾及括号负数;共同计算可以保留,展示方式应分开。

先按职责把财务数据分析与具体呈现分组,再用依赖反转组织关系。图8.2、8.3里Interactor承载核心业务策略,Controller、Presenter、View和Database的源码依赖有方向地指向受保护层:底层实现或展示改变时,不强迫高层策略跟着改变。OCP保护高层组件说明SRP负责找出分组,DIP负责控制方向,两者一起实现OCP目标。

接口还有不同用途。FinancialDataGateway用于把数据库依赖反向指向业务侧;FinancialReportRequester则隐藏Interactor内部实体,让Controller只看所需入口,避免传递依赖FinancialEntities。接口的信息隐藏作用说明反转方向与减少暴露细节不能混为同一件事。划分组件时,既要问谁不应受谁的修改影响,也要问调用方到底需要知道多少。

原书依据 · 4 处

第9章 LSP:里氏替换原则

核心讲解

里氏替换原则要求替换实现后,使用者依赖的行为契约仍成立。这里的“相同”不是要求所有实现产生同样数值,而是都满足接口承诺:Billing可以通过License的calcFee()计算不同许可证费用,而不用判断具体许可类别。LSP与正方形长方形再用正方形反例说明,数学上的包含关系不自动等于软件子类型关系。若Rectangle承诺宽高可独立设定,Square同时改变两边就会破坏先设宽5、再设高2、面积应为10的预期。调用方被迫识别Square,说明原来的替换契约已不成立。

这种原则也适用于服务。出租车调度接口约定pickupAddress、pickupTime、destination等字段,Acme却改用dest,调用者就不能只按共同协议操作。硬编码公司名分支还会随着企业合并扩散。LSP在架构层面说明可以用请求构造组件和配置表隔离URI格式差异,但它是为兼容不一致接口支付的复杂度,而不是违约没有代价。类继承、动态语言共同方法、REST服务都应先明确调用者所依赖的承诺,再评估替换性。

原书依据 · 5 处

第10章 ISP:接口隔离原则

核心讲解

接口隔离原则要求使用者只依赖自己需要的能力。OPS集中提供op1、op2、op3时,User1虽然只调用op1,却可能在源码与构建层面依赖整个OPS。把U1Ops、U2Ops、U3Ops分别作为小接口,OPS再实现它们,可以让各使用者只看自己的入口。ISP的源码级成因解释图10.1和10.2中依赖的变化。

这里的重新编译、重新部署影响取决于语言和构建组织。静态类型代码常通过显式类型引用形成源码依赖;动态分派可以减轻某些这类耦合,但不能保证动态语言没有模块依赖,更不能把静态语言中任一函数体改动都等同于必然重部署所有调用者。原则关注的是不必要依赖扩大了受影响范围。

同样问题还出现在组件之上。系统S为了某种能力引入框架F,F又绑定数据库D,D中无关能力的变化或错误也可能沿这条链影响S。依赖不需要的东西有害说明因此要审视依赖包带入了多少不需要的部分,而不能把ISP简化为选择某种语言。第13章的共同复用原则会把这个判断进一步用于组件边界。

原书依据 · 5 处

第11章 DIP:依赖反转原则

核心讲解

依赖反转原则要求源码依赖尽量指向稳定的抽象,而不是频繁变化的具体实现。重点是“易变”:稳定的String或平台接口没有必要再套一层抽象。接口的修改往往迫使实现响应,而实现内部的变化未必需要改接口,所以设计时应努力让接口保持稳定。DIP关注易变实现给出四条约束:少引用易变具体类,不从易变实现派生,不通过覆盖已有实现继续继承其依赖,避免把易变实现名称写进高层逻辑。

对象创建是难点,因为直接构造ConcreteImpl通常需要知道具体类型。图11.1通过ServiceFactory.makeSvc()返回Service,Application只依赖Service和ServiceFactory,ServiceFactoryImpl承担创建ConcreteImpl的工作。抽象工厂与依赖反转解释这种抽象工厂怎样把不可避免的具体创建集中到边界外侧。Main再负责创建工厂实现并交给应用。

边界两侧的关系需要分清:Application运行时最终使用具体服务,源码却无需引用它;具体服务与工厂实现反过来依赖抽象接口。具体实现组件内部仍会有对具体类的创建依赖,目标是把它隔离,不是让整个程序完全没有具体类依赖,也不是说系统所有调用方向都必须与依赖相反。后文的依赖守则将沿用这个跨边界指向抽象层的安排。

原书依据 · 5 处

第4部分 组件构建原则

核心讲解

组件构建原则把讨论从类和模块推进到更大的组合单位。SOLID像指导怎样把砖砌成墙和房间,而这一部分要讨论如何把房间组合成房屋:什么算组件、内部应放哪些元素、组件彼此怎样协作。

下一章把组件定义为部署单元,见组件是最小部署单元;随后分别讨论内部聚合与外部耦合。导言只是确立层次与后文范围,不另增加独立的技术定义卡。

原书依据 · 1 处

第12章 组件

核心讲解

组件是部署过程中可独立处理的最小单位,如jar、gem、DLL。它既可组合成可执行文件,也可在运行时以插件形式加载;关键是能够保持独立开发与发布的边界,不是文件扩展名本身。组件是最小部署单元解释这个部署视角。

早期程序必须指定起始地址,库以源码一同编译;库单独编译后又占固定区域,应用扩展就得绕开它,形成碎片。可重定位二进制把待调整的地址标记保留给加载器,使同一程序段能放到不同基础地址。外部引用与外部定义再以函数名元数据匹配,解决分别编译的程序段怎样连接。

链接加载器最初把调整地址和匹配符号放在加载时完成;程序规模增长后,链接太慢,于是独立链接器提前生成已完成符号链接的可重定位文件,加载器再快速装入。硬件提速之后,部分链接又能在加载时实时完成,使动态插件成为常见构建方式。插件式架构的历史保留这一演进:历史不是纯年代清单,而是编译、链接、加载成本反复推动边界变化。

重定位解决程序段放在哪里:二进制文件保留需调整地址的记号,加载器按实际起始位置修正地址。符号链接解决程序段怎样找到彼此:编译器把调用的函数名保存为外部引用,把实现的函数名保存为外部定义,链接阶段将二者匹配。两者配合,使程序和库能够分别编译,再装入共同的运行环境;链接器还可以把耗时的符号匹配提前完成,避免每次加载重复做。参见重定位与符号链接。

原书依据 · 4 处

第13章 组件聚合

核心讲解

组件聚合决定哪些类应该一起发布。复用/发布等同原则(REP)要求复用粒度与发布粒度一致:使用者要知道版本、变更内容和发布时间,才能判断兼容性并决定升级;因此一组同时发布的类也应具有共同主题。REP复用发布等同说明它建立发布纪律,但仅说“合理组合”不足以决定精确边界。

共同闭包原则(CCP)按变更原因聚合:会因相同目的同时修改的类放在一起,让一次变更尽量只涉及少数组件,降低重新验证和部署范围。这是SRP从函数、类推进到组件的版本,也是在不可能完全闭包时战略性选择要共同保护的变化点。CCP共同闭包原则解释为何开发早期常优先维护速度。

共同复用原则(CRP)则按使用范围排除:不要让使用者为了需要某几个类而依赖一整包无关类。容器与其遍历器通常一起用,适合组合;彼此独立被使用的功能则不应硬绑。CRP共同复用原则把ISP“不依赖不用的函数”推广为“不依赖不用的类”。

三者存在张力。REP和CCP倾向聚合,CRP倾向拆分;忽视CCP会使一次变化散落许多组件,忽视CRP会造成过多无关发布,忽视REP则难以复用。图13.1不是固定最优解:早期重开发速度,成熟后外部使用者增多,边界就要重新平衡。组件聚合张力图说明组件结构应随成熟度和使用方式演进,而不是仅按业务名词永久划分。

原书依据 · 5 处

第14章 组件耦合

核心讲解

组件耦合讨论组件之间怎样依赖。无依赖环原则(ADP)要求沿有向依赖边不能回到起点,即形成DAG。若团队直接同步别人的未发布代码,可能昨天能工作、今天就失效;每周集中集成又会随规模增长积累越来越大的批次。把组件独立版本化发布,让使用者决定何时升级,可以把集成分散成渐进步骤;无环结构使发布顺序和影响范围可追踪。ADP无依赖环原则说明图14.1中依赖箭头由使用者指向被依赖者,构建顺序则先处理依赖较少的底层组件。

一旦Entities反过来依赖Authorizer,就与Interactors形成环,测试或发布其中一个也要拉入其余成员,名义上的独立组件变成联合维护单元。打破循环依赖说明两种解环方法:在Entities中定义所需Permissions接口、由Authorizer实现;或将共同使用的类移到新的Permissions组件。组件结构会因此随需求抖动,不是功能分解图完成后就永久固定。

稳定依赖原则(SDP)要求依赖指向更稳定的组件。这里稳定指改变牵连的工作量大,不是指历史上更新次数少。被许多外部类依赖使组件难改,而依赖许多外部类增加它响应外界变化的理由。Fan-in统计外部依赖内部的类数,Fan-out统计内部依赖的外部类数;不稳定性I=Fan-out/(Fan-in+Fan-out),图14.7中3个入向类、1个出向类得到I=1/4。SDP稳定依赖原则说明沿依赖方向让I下降的意义:不能让本应稳定的策略绑定本应容易变化的实现。图14.11通过UServer中的US接口把Stable与Flexible分开,保持Flexible易变。

稳定抽象原则(SAP)解决“稳定却还要扩展”的问题:稳定组件提供抽象契约,不稳定组件承担具体实现,通过扩展实现而不是不断修改稳定部分来响应需求。SAP稳定抽象原则说明SDP和SAP一起把依赖推向稳定且较抽象的方向,但组件可以部分抽象,不必都落在极端。

抽象比例A=Na/Nc,Na是抽象类与接口数,Nc是类总数。把A与I画在二维图上,接近(0,0)的组件具体却难改,是痛苦区;接近(1,1)的组件抽象却几乎无人依赖,是无用区。主序列连接(0,1)和(1,0),D=|A+I-1|表示偏离程度;可以观察系统分布,也可跟踪同一组件跨版本漂移。主序列与I/A图解释图14.12–14.15。指标只是约定模型,稳定且几乎不变的基础工具不必因落在痛苦区就强行重构,均值或阈值也不能代替实际设计判断。

组件依赖图描述构建和维护时谁受谁影响,不等同于系统功能分解图。项目早期还不清楚哪些类共同变化、哪些能力会被复用,因此不能一次把组件结构完美定死。应随模块实现和使用者增长,应用共同闭包隔离频繁变更,应用共同复用调整边界,并持续消除循环;结构变化是对新证据的响应,不是设计失败的证明。参见组件依赖随构建演进。

原书依据 · 11 处

第15章 什么是软件架构

架构职责与生命周期

软件架构讨论的不是一个响亮职称,而是系统如何切成组件、怎样安排依赖和通信,使开发、部署、运行与维护更顺利。架构师持续参与代码工作,才能直接感受设计给团队带来的困难,避免把想象中的整齐结构当成有效设计。

这些目标并不自动一致。小团队可能靠简单单体高效工作,多团队则需要清晰组件和稳定接口;微服务可以方便分工,也可能增加部署、连接配置和启动顺序的复杂性。运行需求必须满足,但仅能正常运行并不能证明架构良好。长期维护还包含两类成本:找到应该修改的位置,以及修改可能伤害其他部分的风险。稳定边界能缩小这两类成本。

相关卡片:架构师应写代码;架构对四阶段的影响。

原书依据 · 2 处

策略与细节的选择空间

策略是业务规则和流程,细节是使人、外部系统或程序员能够使用这些规则的具体技术,例如数据库、Web交付和框架。保留可选项的意思是让策略不依赖某个已选技术,使以后能根据信息和实验调整选择,并不意味着项目永远不作决定。

即使企业已经指定某种数据库,也可以在代码结构上保留替换它的能力。这样,组织层面的决定不必成为高层业务代码中的永久依赖。延迟决定的价值来自隔离能力,而不是拖延本身。

相关卡片:保持可选项。

原书依据 · 1 处

设备无关性与地址抽象

设备无关性把业务所需的读写操作与具体设备分开。早期程序直接操作读卡器,改用磁带就必须重写;操作系统提供抽象记录读写后,同一程序可以切换设备。广告打印案例进一步说明:先把姓名地址写到磁带,再由离线打印机批量输出,不必改动格式化业务逻辑。

磁盘例子有相同结构。若业务记录硬编码柱面、磁头和扇区,换盘会牵动大量代码;改为连续的相对扇区地址,再由转换程序解释物理位置,就把硬盘结构变成局部细节。这些故事共同解释了保留选择空间怎样降低真实迁移成本。

相关卡片:设备无关性的历史案例。

原书依据 · 1 处

第16章 独立性

独立性服务四类目标

独立性不是让所有部分彼此无关,而是让各部分能在适当边界内改变。架构同时服务用例、运行、开发和部署:顶层结构应让人看出这是购物车等什么系统;运行方式要满足吞吐和响应;团队要能并行修改;构建完成后要容易部署。

这些条件会随着系统成长而改变。把运行模型固定为单体或服务,未必比先管理好组件依赖更有利。康威定律提醒:组织的沟通结构容易投射进系统,架构需要为团队分工提供隔离,但不能只追求一种目标而忽略其他阶段。

相关卡片:良好架构的四大目标。

原书依据 · 1 处

按变更原因双向切分

水平分层把变更原因不同的技术与规则分开:界面、应用特定规则、领域通用规则及存储不必一起变化。垂直切片则按用例分开,例如添加订单与删除订单可能有不同的演进需求。两种分割可以同时存在,每个用例会涉及若干层。

这样,高吞吐用例可与低吞吐用例分开演进,界面和规则团队也能减少干扰。真正跨服务器运行仍需要相应通信形式,源码隔离本身并不会自动产生远程服务;它为以后选择部署方式创造条件。

相关卡片:水平分层与垂直切分。

原书依据 · 1 处

重复判断与解耦粒度

代码现在相似,不等于未来应该共享。真正的重复要求每次修改同步到各副本;表面重复的片段虽然相似,却有不同变更原因。把两个偶然相似的用例强行共用实现,会使未来拆分更难。数据库记录与视图模型字段相似,也不足以取消层间的数据转换。

解耦还应区分粒度:源码边界管理模块依赖,部署边界形成可单独发布的单元,服务边界进一步允许独立进程与网络通信。服务增加资源和研发成本,因此可以先把依赖隔离好,按真实需求提升粒度;需求减少时,也应尽可能支持回退。

相关卡片:表面重复与真正重复;三种解耦粒度。

原书依据 · 3 处

第17章 划分边界

边界与过早决定

架构边界是约束两侧代码依赖的分割线,目的是让某些变化不必穿透整个系统。应优先保护业务规则,避免过早选定框架、数据库或分布式拓扑,把尚未验证的假设永久写进实现。

P公司为从未需要的服务器集群支付了序列化、协议与多层对象同步成本;W公司把简单联系人更新扩成服务注册、复杂消息和多服务启动。问题不在服务技术本身,而在没有真实需求时,就让沉重机制决定日常开发方式。

相关卡片:边界推迟不成熟决策;P公司与W公司的教训。

原书依据 · 2 处

FitNesse以接口延后存储

FitNesse先确立“下载一个jar即可运行”的交付目标,再把页面访问放在WikiPage接口后面。解析wiki文本不需要数据库时使用空方法,需要数据行为时使用内存实现,真正需要保存才引入文件实现。这里是让产品功能推动持久化能力,而不是等待数据库先就绪。

后来客户需要MySQL时,可以另写实现接入,原有业务逻辑不必重写。这个案例的要点是接口先于实现细节、接口服务于实际使用;它没有证明所有项目都应使用文件,也没有否认数据库在别处的价值。

相关卡片:FitNesse推迟数据库。

原书依据 · 1 处

让插件依赖核心

数据库边界应让业务规则拥有自己需要的数据访问接口,数据库侧负责实现这个接口并翻译成具体查询。于是业务规则只知道操作能力,数据库实现反过来依赖这些约定。图17.1—17.3把类级关系提升为组件关系,方向始终是具体实现指向业务抽象。

GUI也可以采用相同的插件关系。游戏模型即使没有屏幕,也应能处理游戏事件;界面负责呈现和输入,而不成为规则存在的前提。所谓I/O无关紧要,是说它不应主导核心策略的源代码依赖,并不是说用户体验没有价值。

相关卡片:数据库边界的画法。

原书依据 · 1 处

边界沿变化轴分布

插件式架构把数据库、界面等可替换部分接到独立核心上。依赖关系具有不对称性:插件需要理解核心提供的接口,核心不应知道某个具体插件。ReSharper与Visual Studio的例子用来说明这种不对称如何隔离团队的工作。

边界应沿不同的变更原因和速率来画,而不只是按可见页面或部署机器划分。它能减少不相关改动的传播,但替换插件仍可能需要适配新交互方式;保留替换可能性不等于承诺替换没有成本。

相关卡片:I/O无关紧要。

原书依据 · 1 处

第18章 边界剖析

控制流与源码依赖

跨边界调用是运行中的函数调用与数据传递;架构真正需要约束的则是源码依赖。低层调用高层时,两者方向可以一致。高层需要调用低层实现时,应先定义高层接口,让低层实现它,保持源码仍由低层指向高层。

因此,一个可执行文件也可以有有意义的架构边界。它们虽然不在部署拓扑上显现,仍能隔离团队、测试和变更。图18.1与18.2中的Data分别位于高层被调用方或高层调用方,数据定义的归属也是依赖管理的一部分。

相关卡片:跨边界调用的依赖方向。

原书依据 · 1 处

物理边界与通信代价

同进程的源码组件和动态链接组件通常用便宜的函数调用通信;动态库还提供可独立交付的部署单元。本地进程有独立地址空间,需要系统调用、编码和上下文切换;服务进一步假定网络通信,应考虑更高延迟并减少细碎往返。

线程表示执行和调度方式,可以位于一个组件内,也可穿过多个组件,所以线程本身不是架构边界或部署单元。真实系统常同时包含不同边界,不能只用“单体”或“服务”一个标签概括全部结构。

相关卡片:四种边界物理形式。

进一步辨析:线程不是架构边界。

原书依据 · 2 处

第19章 策略与层次

策略层次与加密例子

策略描述系统如何把输入变为输出。架构把变更原因、时间和层次相同的策略放在一起,再约束组件间依赖。这里的层次按离输入输出的距离定义:直接管理设备的是低层,较独立的业务变换是高层,源码依赖应指向后者。

加密例子的读入、转换、写出构成数据流,但源码不必沿同一方向。直接调用readChar和writeChar会让加密策略依赖设备;将Encrypt依赖的CharReader、CharWriter接口放在核心内,由ConsoleReader、ConsoleWriter实现,就能保持核心不认识控制台。图19.2与19.3分别展示类级和组件级的同一规则。

相关卡片:层次按离I/O远近定义;加密程序案例。

原书依据 · 2 处

第20章 业务逻辑

实体、用例与边界数据

关键业务逻辑指不因是否采用计算机而改变的业务规则,例如贷款计息;关键数据则是规则所需的本金、利率和还款安排。业务实体把这些数据与行为聚合成独立模块,可以用类表达,也可以用其他组织方式,关键是不依赖界面和存储。

用例描述特定应用如何完成任务,包括输入、输出和步骤,并协调实体。贷款预估用例先收集和验证联系信息,再检查信用条件,最后进入计算流程。用例更贴近应用输入输出,依赖实体,而实体不需要了解是谁在调用。

请求与响应模型应采用独立的简单数据结构,避免继承Web框架请求对象,也避免直接搬运实体。字段暂时相同不代表职责相同,分开的表示允许界面、应用流程与领域规则按不同原因演进。图20.1提供Loan实体方法,图20.2说明用例流程。

相关卡片:业务实体;用例;请求响应模型。

原书依据 · 3 处

第21章 尖叫的软件架构

让架构表达用途

“尖叫”指系统结构应鲜明地表达用途。看到顶层目录和模块,应先知道这是医疗、账务或库存系统,而不是只看到某个框架名称。用例是结构的组织主题,框架和Web只是帮助交付的工具。

围绕用例并不表示禁止使用框架。它要求明确采用成本,避免让框架生命周期和数据类型支配核心代码。一个可检查的结果是:用例和实体可以在不启动Web服务器、不连接真实数据库的情况下测试;新成员先认识业务做什么,再认识它用什么技术交付。

相关卡片:尖叫的架构;框架是工具不是信条。

原书依据 · 2 处

第22章 整洁架构

整洁架构的分层与边界

整洁架构把一组相近思想组织成同心圆:内层保存更通用的策略,外层保存更具体的机制。实体包含关键业务规则,用例实现应用任务,适配器转换数据,框架与驱动承载数据库、Web等实现细节。四圈是说明性分法,不是固定层数配额。

不变的是源码依赖向内。内层不能引用外层定义的类名、函数名或框架数据格式。控制流却可以由控制器经过用例再到展示器:用例先依赖自己的输出接口,展示器在外层实现它,就能在向外执行时保持源码向内依赖。

跨边界的数据应是独立、简单且适合内层使用的结构,避免把数据库行对象或实体直接传进去。Java例子串起Controller、InputBoundary、UseCaseInteractor和Entities,再通过OutputBoundary交给Presenter。Presenter将结果转换成ViewModel里的字符串和开关,View只负责显示。数据流与源码依赖必须分开阅读,不能从箭头顺序误认接口实现方向。

相关卡片:整洁架构的依赖规则;整洁架构四层职责;跨边界的输出端接口;整洁架构Java案例。

原书依据 · 4 处

第23章 展示器和谦卑对象

把难测机制缩成谦卑对象

谦卑对象模式将难以测试的机制与可测试的规则拆开,并把前者尽量缩小。界面显示本身难以直接单元测试,日期格式、金额符号、负数颜色和按钮可用性却可以先由展示器计算,填进简单视图模型;视图只加载这些结果。

数据库网关采用相同结构:用例依赖数据访问接口,具体实现执行数据库操作,测试时替换成桩或替身。ORM在这里被解释为数据映射器,应放在数据库侧,避免其格式进入核心。服务监听器同样只负责接收、转换和转交。难测不代表完全不用测试,而是把可测试行为从依赖外部环境的机制中分离出来。

相关卡片:谦卑对象模式;谦卑对象在网关与ORM。

原书依据 · 2 处

第24章 不完全边界

用不完全边界控制投入

完整边界涉及接口、输入输出结构、依赖约束以及独立发布维护;尚不确定是否需要时,可以保留不完全边界。第一种做法把代码按独立组件设计,却仍合并编译部署,节省版本和发布管理。FitNesse的经验也提醒,长期不用的隔离可能逐渐弱化。

第二种是单向边界:Client依赖ServiceBoundary,由ServiceImpl实现,已获得一个方向的依赖反转,反向通道仍靠纪律维护。第三种是Facade转发:它简化调用,却不反转对Service的传递依赖,因此不能保证客户端免于服务实现变动。

这些方法提供不同的成本和隔离强度,既可升级成完整边界,也可在需求不成立时降解。选择的对象是实际演进风险,不是为了形式上把组件分得越细越好。

相关卡片:省掉最后一步的边界;单向边界与门户模式。

原书依据 · 2 处

第25章 层次与边界

从游戏发现更多变化轴

UI、业务规则、数据库三块只是一种粗略起点。文字冒险游戏需要多语言时,语言应与游戏规则分开;输入又可能来自终端、短信或聊天,通信方式也应与语言分开。持久化介质与联网协作则形成另外的变化轴。

图25.1—25.5逐步增加这些边界,简化图中的依赖箭头指向高层规则,而输入输出可来回流动。API由需要它的高层使用方定义约定,由对应的低层实现提供能力;不能把源码依赖与数据流混画为一回事。

更复杂的游戏还可把洞穴移动规则与玩家生命、输赢等更高层策略分开,甚至部署到客户端与服务器。这个例子用来寻找潜在边界,并不是建议给200行小游戏真的建设整套分布式系统。架构师应反复比较当下建边界的成本、未来补边界的风险,观察收益超过成本的时点。

相关卡片:Wumpus游戏案例;数据流持续分裂;边界决策需持续权衡。

原书依据 · 3 处

第26章 Main组件

Main装配具体世界

Main是系统的装配入口。它知道配置、具体工厂、外部资源和启动方式,建立对象后把控制交给高层规则,因此处于整洁架构外圈。最高业务策略不应反过来依赖Main。

本章代码图片具体展示Main实现HtwMessageReceiver,准备游戏名称与环境字符串,再用HtwFactory.makeGame创建游戏,建立输入流并将命令转交给游戏对象;createMap负责生成地图。这些字符串和输入设备细节没有必要进入游戏核心。依赖注入框架可以在入口帮助组装,而不必成为全系统都直接引用的设施。

Main也可以作为插件替换,为开发、测试、生产或不同地区提供不同启动配置。变化集中在外圈装配层,核心应用因此能复用。

相关卡片:Main组件也是插件。

原书依据 · 1 处

第27章 服务:宏观与微观

服务与真正隔离的关系

服务隔离了进程变量,却未必隔离共享数据和行为。当一条记录的含义改变时,相关服务仍需协调理解和发布。因此,服务是一种通信和部署方式,不能仅凭服务数量判定架构质量。

出租车系统新增猫咪配送后,寻找车辆、筛选、派车和界面都要理解过敏条件及车辆历史。原本按功能划分的服务被同一个需求同时击中,暴露出横跨型变更。解决方向是让稳定抽象承载共同流程,让Rides与Kittens等扩展组件提供不同实现;UI工厂负责选择具体对象。

同样的组件结构可以存在于服务内部。新增能力可能是部署一个扩展组件,而不是重写每个服务。关键是低层扩展依赖稳定抽象,以及变更是否真正受边界约束;架构边界可能落在服务之间,也可能穿过服务内部,不能把任何一种位置绝对化。

相关卡片:服务不等于架构;运送猫咪的难题;服务边界非架构边界。

原书依据 · 3 处

第28章 测试边界

测试组件也需要演进边界

测试也是系统组件,依赖被测代码,通常处于架构外圈。它们支持开发而非用户运行,却同样需要设计。若通过容易变化的登录页面和导航路径验证稳定业务,界面一改,大量业务测试就可能受影响,使团队反过来害怕修改产品。

测试专用API可以直接进入业务交互、设置状态,并替换昂贵外部资源。它隔离的不只是界面,还包括生产类与测试类一一对应造成的结构性耦合,使产品趋向抽象、测试趋向具体的演进可以各自进行。

具有绕过安全检查等高权限的测试实现必须作为独立可部署组件管理,防止进入生产环境。这是书中提出的测试隔离方法,不能简单理解为给线上系统开放无约束的超级接口。

相关卡片:测试是最外圈组件;测试专用API。

原书依据 · 2 处

第29章 整洁的嵌入式架构

从依赖理解固件

本章把“固件”扩展为一种架构警示:本可长期使用的逻辑,如果强依赖具体硬件或平台,就会随它们过时而被迫改变。这是作者为了讨论依赖关系采用的解释,不宜当作所有领域唯一的术语定义。

TDM向VOIP迁移时,业务通话规则与技术实现纠缠,使团队只能从旧代码反推需求;消息处理器若把解析规则和UART寄存器操作放在一个文件,也会把可复用逻辑绑到设备上。目标是缩小不可避免的硬件依赖范围,使更多代码保有软件的可变性。

相关卡片:固件的重新定义。

原书依据 · 1 处

可运行还不足以长期演进

先让代码工作,再改善结构,最后按需要优化性能,是本章引用的构建顺序。能在当前板卡运行,只通过了“程序适用测试”,没有证明它容易理解、测试或迁移。

源文件示例把转速计算、采样平均、硬件中断、按钮响应、原始A/D读取、闪存存取混在一起。按职责重新认识这些函数,就能发现业务计算与设备访问并非同一类变化。若所有代码都使用特定工具链扩展,还只能在目标硬件上测试,硬件未就绪就会阻塞大量开发工作。

相关卡片:程序适用测试的局限。

原书依据 · 1 处

以HAL越过硬件瓶颈

目标硬件瓶颈指只有拿到特定硬件才能运行测试,导致开发被平台供应和调试拖慢。硬件抽象层HAL把软件需要的服务与固件操作分开:上层需要保存名值对,而不应知道闪存字节布局;上层需要指示电池电量低,而不只是点亮某个GPIO位。

这种接口按应用含义定义,让硬件接线成为局部实现。软件与固件之间原本模糊的分界被明确后,软件即可用替代实现脱离板卡测试。HAL本身也可以分层,抽象层数取决于所要隐藏的变化。

相关卡片:硬件抽象层HAL。

原书依据 · 1 处

处理器与类型扩展要局部化

厂商工具链可能提供方便的寄存器变量和特殊类型,却使普通代码离开该编译器就难以构建。示例acmetypes.h按处理器定义不同的整数底层类型,直接散布引用会把迁移工作扩到全系统。使用统一的stdint.h接口并局部适配,可限制这种变化。

直接访问中断、串口缓冲等寄存器的代码不可完全消失,应集中在固件或处理器抽象层PAL中,令其调用方能替换实现测试。原书批评二进制整数字面量不属标准C的说法具有出版时期限制;本章长期有效的核心是控制平台依赖,而非把这种语法判断当作永久事实。

相关卡片:处理器是实现细节。

原书依据 · 1 处

隔离操作系统与实现细节

有操作系统时,HAL仍可隔离硬件,但它本身不保证应用与操作系统无关。直接依赖某个RTOS的API、语义和同步原语,换系统时会牵动大量代码。OSAL按应用需要统一这些服务,使迁移更多集中在一套新实现,同时提供脱离目标操作系统测试的替换点。

模块头文件也应只暴露使用接口所需的声明,避免把实现专属结构和常量带给所有调用者。成千上万处BOARD_V2条件编译则是依赖扩散的另一种形式:把板型差异收敛到HAL实现,通过链接或加载选择实现,可以减少重复平台判断。

相关卡片:操作系统抽象层;用HAL取代条件编译。

原书依据 · 2 处

章节小结与集中脚注

本章最后把长期健康与可测试性联系起来:尽量让应用逻辑在硬件、处理器和操作系统之外测试,把无法避免的细节留在可替换边界之外。篇末集中脚注还补充了前面章节的来源和限制:200行游戏只是演示边界,并不需要真的实现庞大架构;图中的某些箭头表达源码依赖,而不是数据流;静态多态虽然可用于单体边界管理,却不总能避免重新编译。

脚注进一步解释:静态多态与重编译。

原书依据 · 1 处

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

核心讲解

“数据库只是实现细节”区分了数据模型与存储工具。业务中的数据结构、关系和规则当然重要;Oracle或某种表存储产品却是实现存取的选择,业务用例不应被它的行对象、表结构和查询方式绑住。数据库是实现细节说明为什么认识表格式的代码应限制在外层,而不是让数据库框架对象穿过整个系统。

本章用磁盘时代的成本说明工具产生的背景:机械寻道、旋转等待和整扇区读取,使索引、缓存和查询优化很重要。文件系统擅长按名字组织文档,关系数据库擅长按属性查找记录,两者为不同访问模式作组织。假设全部数据已在内存中,应用仍会采用列表、树、哈希表等自然结构;假设磁盘不存在借思想实验强调业务对象不应取决于落盘格式。本书关于磁盘终将被RAM取代的预测只是当时论述背景,这里不把它作为当前市场事实。性能仍是架构关注点,主张是把数据访问优化尽量封装在边界外,而不是保证任何性能问题都能局部解决。

T1监控系统的故事又引入市场约束:工程上不需要关系库,客户采购却把它列为必选项。只争论技术合理性不能使这种需求消失;可以在系统一角接上受限访问的数据库,同时保留核心模型。市场驱动的数据库说明隔离实现细节也使团队能回应真实的商业条件。

原书依据 · 6 处

第31章 Web是实现细节

核心讲解

本章把Web放回计算资源集中与分散的历史振荡里:从大型机、瘦终端到客户端/服务器,再到浏览器、Ajax与服务器JavaScript,变化的是交付技术与计算放在哪里,业务所要完成的目的未必同时变化。计算资源的钟摆说明架构师应避免把某一次技术潮流写死到核心规则中,而不是断言Web没有任何实际价值。

GUI是用户交互方式,Web是其中一种交付环境。Q公司的财务软件随市场要求改成浏览器风格又改回桌面风格,说明界面决定常受业务之外的风潮影响。因而要分离UI与业务用例,不能让界面改版迫使核心规则重写。GUI与Web是实现细节讨论如何找到边界:不必把鼠标拖拽、浏览器交互等所有细节都模拟成UNIX字符设备;可以在输入数据完整的时刻调用用例,让用例处理后返回完整结果,再由UI继续展现。

这里被标准化的是用例的输入和输出数据,而不是所有屏幕行为。找到正确粒度可能需要反复尝试,但这条边界使相同业务行为有机会通过不同设备或界面交付。

原书依据 · 3 处

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

核心讲解

框架提供共享机制和约定,能大幅减少重复劳动,但不等同于某个应用的架构。框架作者解决自己了解的问题,不可能保证恰好适合每一使用者;应用若围绕框架基类、注解和生命周期深入设计,退出代价就由自己承担。与框架的单向婚姻以“单向婚姻”概括这种控制权不对称:框架可能侵入核心、能力赶不上产品需求、朝不需要的方向演进,或阻碍未来迁移。

应对方式是有限使用并保持边界。让外层代理或适配代码承担框架约定,把它们作为业务规则的插件;Spring可以连接依赖,但核心业务对象无需处处标注框架注解,组装工作可以放到Main。不要嫁给框架强调先局部试用、延后不可逆承诺。

这不要求对一切标准库构建替代抽象。C++的STL、Java标准类库等很难避免,稳定基础设施的长期依赖也可能是合理选择;重要的是知道自己接受了什么约束,并主动判断其代价。

原书依据 · 4 处

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

核心讲解

案例要把前面的原则放到同一个设计里。收费视频网站允许个人购买在线或下载许可,企业批量购买在线播放许可;购买者与观看者不一定是同一人。图33.1中的四类架构行为者是作者、购买者、观看者、管理员,而不是按个人和企业简单分四组。作者提交视频和材料,管理员管理目录与价格,购买者选择许可,观看者使用已有许可。视频网站用例分析说明先识别角色与用例,再按各类变化原因分区。

“查看目录”和“购买许可”可以抽出共同策略,再由不同具体用例使用;这是分析复用的选择,不是功能正确的必要条件。组件图又沿另一维度区分Controller、Interactor、Presenter、View:控制器接收输入,交互器执行用例,展示器格式化结果,视图呈现。源码依赖通过抽象指向较高策略,不必跟随运行时调用方向。控制流与依赖分离解释为什么目录View和Presenter的抽象由具体角色组件实现,而不是让抽象反过来依赖具体实现。

代码和构建边界也不必等于交付包数量。各组件应可单独构建,部署时却可以合并成五个jar、更少jar,或随需求再拆分。角色隔离应对不同变更原因,层次隔离应对不同变更速率,这两种边界一起为部署保留选择。

原书依据 · 3 处

第34章 拾遗

核心讲解

本章由Simon Brown撰写,追问架构如何成为编译器真正能限制的代码。按层封装把Web、业务、持久化横向分类,初期简单,却难直接展示业务领域;按功能封装把订单等业务相关类型放在一处,便于定位,但只改包名仍不保证真正的边界。按层与按功能封装解释这两种分组。

端口与适配器把领域放在内部,把UI、数据库和第三方交互放在外部,源码依赖由外向内。订单持久化接口在内部称为Orders,用领域词汇表达需求,外部JdbcOrdersRepository实现它;端口和适配器解释这与原先业务直接依赖数据层的区别。

按组件封装则围绕一个粗粒度功能接口,把业务和持久化的相关实现聚合进一个包,UI在外。这里的“组件”采用C4的定义,是运行环境中某个清晰接口背后的一组相关功能,不强制等于一个jar。按组件封装说明这是与前文部署单元定义不同的观察维度;组件内部仍须划分职责。

严格分层只允许依赖相邻下层,但Controller直接注入Repository也能画出所有箭头向下的图,却绕过业务层及可能的权限控制。宽松分层的陷阱说明问题不是图是否漂亮,而是规则是否被实际执行。CQRS等场景可能有意分开读写路径,不能把所有跨层访问一概视为错误。

如果所有类型都public,包只是分类文件夹,外部仍可绕开接口直接创建实现。通过包级可见性隐藏实现,只公开真实入口,才能让编译器拒绝非法依赖;用访问修饰符强制架构比较四种分组下需公开的边界。原书把Java包级可见性称作“包protected”并不准确,Java的无修饰符访问才是package-private,不能把protected修饰符直接套在顶层类型上。

模块的导出规则和分开的源码树还能加强边界。业务、Web、持久化三个构建模块可使外两者只依赖业务;若折中成领域与基础设施两棵树,仍需防止Web绕过领域直接调同属外部的数据库代码。其他解耦合模式用环城公路式的Périphérique反模式提醒我们:部署、编译与访问控制都必须服务于预期结构,不能仅凭包名宣称解耦。

原书依据 · 12 处

后序

核心讲解

Jason Gorman回顾了从前期巨型蓝图到敏捷响应式设计的转变。只画图而不能影响代码的架构工作脱离实现;但把设计完全交给即时编码也不会自动得到可演进结构,程序员仍须学会像架构师一样考虑下一次修改。台球类比强调每次击球既要进当前球,也要留下下一杆的位置,设计决策同样需要保留后续选择。

因此架构应进入日常反馈过程:分析现有代码里的设计问题,通过重构修复;TDD每轮测试后及时检查设计,提交前邀请同伴评审,在构建管道增加质量门禁;同时在团队讨论什么算清晰的边界与合理依赖。后序强调这些是需要练习的技能,读懂原则并不等于已掌握,更不等于已经执行实践。

这几种检查位置如何共同形成设计反馈,详见把设计检查融入迭代。

原书依据 · 1 处

附录A 架构设计考古

这些项目由作者回顾,用于说明架构思想在具体限制和失败中如何形成。文件名ch35只是卡片归档编号;原书内容始终按附录A阅读。

历史语境与财务系统设备

本附录用作者回忆的项目说明设计思想从何而来。早期工会财务系统负责Agent、Employer和Member记录的增删改查与记账,主要困难却来自有限内存、缓慢终端和缺少操作系统。硬件照片A.1—A.6提供规模与设备形态的背景,不是金融业务正确性的证据。理解这些约束,才知道后续换入换出和输出抽象为什么能产生价值。

交换空间与两类边界

应用先运行到输出缓冲填满,再换到磁盘等待;任务管理器按终端速度输出,缓冲快排空时才重新加载应用继续工作。慢终端使换入换出的开销有了可用的时间窗口。图A.7明确画出任务管理器、终端缓冲、交换内存和磁盘。

这里存在两类边界。应用把字符串交给任务管理器,因而源码与控制流同向;管理器启动应用时只跳到约定内存入口,不需要依赖某个应用的编译结果。这表明反转调用依赖不必依靠现代面向对象语言,稳定调用约定本身就能建立隔离。

相关卡片:换入换出配合输出缓冲;固定入口反转调用依赖。

原书依据 · 2 处

激光切割中的DSL与弱边界

激光切割程序需要协调定位台、测量装置与激光,开发环境甚至要求顺序编辑磁带。领域语言让客户能够用移动、测量和切割等命令描述任务,降低了编程难度。

不过,命令语言更友好不等于系统已经解耦。MOP总执行程序与工具代码相互回调、需要特殊修改,语言层也知道下面的细节。这个案例区分表达抽象和依赖隔离:前者改善使用方式,后者才使模块能够独立演进。

相关卡片:有DSL仍可能强耦合。

原书依据 · 1 处

铝压铸监控与中断调度

铝压铸监控在机器每次完成周期时更新统计,并把消息交给中央主机显示。其架构特点是用软件指令触发中断,使处理器能够处理其他较低优先级工作。书中以Thread.yield作历史类比;这里不把二者当作现代操作系统语义完全相同的保证。穿戴与工作文化的插曲交代经历,不另推导成软件设计原则。

相关卡片:软件中断移交执行。

原书依据 · 1 处

4-TEL按交互位置拆分职责

电话测试系统原来让远端COLT负责测量和界面,维护中心SAC只转发内容,低速链路使用户长期等待。把测量留在现场,把结果分析和报表生成移到用户所在的维护中心后,跨边界只需传递DIAL、MEASURE等少量命令和数据。响应速度改善,远端内存也减少。

随后,系统迁到EPROM芯片上,获得更低硬件成本,却出现更新部署问题:单个整体二进制地址改变,会迫使所有芯片一起更换。这个变化引出下一个独立部署机制。

相关卡片:让分析靠近交互端。

原书依据 · 1 处

向量表让固件局部部署

团队把程序拆成各自固定加载位置的小模块,每个芯片先保存子程序入口表。启动时把这些表复制进内存向量区,调用改为经向量间接跳转。某个模块内部地址变化时,调用方仍通过稳定槽位定位,所以现场更新可以只换受影响芯片。

同一层间接关系还允许把某个入口重定向到空闲内存中的补丁,不必立即现场换芯片。这是当时平台和运维方式下的具体机制;它说明稳定间接层怎样支持独立部署,并不构成对任意现代生产系统热补丁的操作建议。

相关卡片:向量表支撑局部更新。

原书依据 · 1 处

SAC核心规则冻结与设备耦合

维护中心依据测量判断应派哪类修理工,是系统节约资源的核心功能。这段代码难以理解,每次修复又引入缺陷,最终被禁止修改。代码仍在运行,却失去可演进能力,说明工作正常不能替代结构清晰。

调制解调器控制也散落在业务与UI代码中。新硬件改变接口后,团队没有在清晰抽象后替换驱动,而是在底层通信口识别旧字节序列,再重排成新设备命令和时序。它能暂时工作,却把复杂性塞进难以理解的协议翻译层,反过来证明应尽早局部化设备依赖。

相关卡片:难懂核心会被冻结;串口翻译难替代抽象。

原书依据 · 2 处

大型重写与地区分叉

重写团队面对的目标不是静止旧程序。旧系统持续修复和添加功能,新实现必须追赶变化;同时业务进入欧洲,地域规则和组织方式不同,复制出的分支又不断独立演进。

同样的缺陷需要两地各修一次,而接口和模块逐渐改变,使补丁不再容易移植。后续把差异改为配置的尝试也受既有分歧和市场变化影响。重写与合并因此都要处理移动目标,不能只按某个静态版本估算工作量。

相关卡片:重写追逐移动目标;地区分叉积累合并成本。

原书依据 · 2 处

交叉开发环境与BOSS

新的开发机和交叉编译链让程序员能在较舒适环境中构建8085代码,再下载到目标板。工具更换降低了编写负担,但不自动替代架构。

BOSS提供一个非抢占式任务切换器:任务等待事件时调用block并登记检查函数;系统轮询这些函数,发现某个返回true就恢复对应任务。调度发生在任务显式等待的位置,因此它和自动按中断抢占的方式不同。这个机制后来被多个项目复用。

相关卡片:BOSS协作式任务调度。

原书依据 · 1 处

pCCU按实际约束缩小交付

数字化线路使拨号和铜线测量分处不同地点,原本一体化的COLT需要拆开。完整方案长期延迟,客户却突然即将上线。团队检查了这个客户的实际规模:只有两个分发点,已有设备可用,号码中又有足够路由信息,于是交付一个转发命令的过渡程序。

这里的经验是从当前要完成的具体任务出发,寻找比完整未来平台更小的可交付路径。它依赖当时的设备和号码条件,不能直接推广为“复杂系统都能一周写完”。

相关卡片:按真实约束缩小交付。

原书依据 · 1 处

DLU和DRU的两种有效组织

远程显示单元用一条较高速链路复用多个终端字符流,再在另一端分发。两端在相同平台上采用了不同的软件组织。

DLU像流水线:小任务只处理一段工作,通过队列把结果交给下一任务,允许分支和汇聚。DRU则让每个终端对应一个较大任务,负责这个终端的全过程。两者都能完成目标,说明结构是否有效需要结合工作分配与约束判断,不能仅凭个人熟悉某种图形就判另一种错误。

相关卡片:流水线与终端自治。

原书依据 · 1 处

VRS与数据库供应商锁定

语音应答让修理工直接拨入系统,按指令完成测量,无须另一位测试员逐步转述。产品功能成功,但数据库依赖随后成为长期问题。

团队把UNIFY的SQL方言和私有API嵌到大量C代码中,产品停止开发后,替换数据库变成遍历整个系统的改写。迁移尝试失败,最终只能持续支付维护旧产品的费用。这个案例把数据库抽象的重要性落到具体机制:依赖散布越广,退出供应商的成本越大。

相关卡片:内嵌SQL锁定供应商。

原书依据 · 1 处

电子前台的进程状态交接

电子前台按来电状态交接工作:监听进程接到呼叫后启动处理程序,当前程序决定下个状态,把必要状态写到磁盘文件,再启动下一个程序并退出。每个服务关心自己的职责,可以单独部署。

这还不是完整的插件式架构,却已有清晰进程边界。技术运行成功后,产品仍因公司不熟悉目标市场而失败。附录保留这个区别作为项目背景,不把个人专利和市场排名叙述当作经过独立核验的历史结论。

相关卡片:状态交接拆成独立进程。

原书依据 · 1 处

CDS外部状态机与跨进程数据

修理工派遣系统把状态转换放在外部文本里,事件到来时据此选择下个服务。增加处理步骤可通过新增服务和修改状态机组合完成,体现将控制策略从具体服务中分离的效果。

快速状态切换使磁盘文件传递太慢,于是改用3DBB共享数据。不同进程有不同地址空间,裸指针在另一进程没有相同含义,因此不能直接交换带指针的树或链表。FLD在内部表示带名字的层级数据,对外转换成字符串,通过3DBB传递,再还原和查询。这是解决进程表示差异的序列化机制,而不是宣称它与后来的XML或JSON语法相同。

相关卡片:外部状态机控制服务流;跨进程不传裸指针;层级数据用字符串传输。

原书依据 · 3 处

创业经历与设计思想形成

Clear公司采用进程、消息队列和完整协议栈,却也积累了庞大难懂函数。这个对照提醒:使用高级机制与保持代码清晰并不是同一件事。作者后来通过语言学习、阅读和公开设计讨论逐步形成判断框架。

外号、招聘与职业转折说明这些观点的个人来源。它们没有提供新的实现步骤或可独立验证的架构机制,因此保留在章节讲解中,不逐一做成知识卡;提名的设计著作进入文献登记。

ROSE的分层、方向与过度设计

ROSE让图形模型先变成内部表示,再由规则修改并存入对象数据库。它有明确层次与独立开发能力,但源码依赖一路跟随控制流指向数据库,未能保护高层策略。

对象数据库带来的侵入式框架与过多层级使修改、通信和开发成本上升。这里的失败并不证明分层本身无用,而说明层数、方向、第三方耦合和问题规模都需要同时权衡。对桌面工具采用重型企业设计,可能使架构成本超过收益。

相关卡片:分层不代表依赖正确。

原书依据 · 1 处

用多个应用验证复用框架

考试系统需要18个图形答题应用及评分程序。团队先围绕一个最复杂应用制作通用框架,交付后才发现其他应用存在细小但关键的不匹配。第二轮改为并行开发四个真实应用,一边使用一边提炼公共组件,之后复用才得到验证。

依赖方向也不能仅按“框架”和“应用”的名称决定:GUI共同策略在框架时,应用作为插件;评分高层策略在具体应用时,评分框架反而是插件。原则始终是实现细节依赖高层策略,而不是所有代码都无条件依赖框架。

相关卡片:多应用验证复用框架。

原书依据 · 1 处

收束与脚注

附录是个人经历的选择性回顾,既包含成功模式,也包含代价高昂的失败。贯穿这些项目的认识是:稳定接口和适当依赖能让实现变化保持局部,而把某项技术当成永久前提,会延长后续修复和迁移的代价。末尾脚注补充CRT、EPROM、CASE等背景,以及设备和个人故事,不额外构成新的架构规则。

跨章综合

依赖方向把本书几个尺度的讨论连接起来。对象层面,接口让调用者表达自己需要的能力;组件层面,发布和复用使变更传播可被管理;系统层面,把实现细节放到边界外,才能让业务规则不随每次框架或存储调整一起修改。运行时的调用顺序和源码中的依赖方向不是同一件事,不能从箭头的外观或部署位置直接推断。

可测试性提供了边界是否有效的一种观察方式。如果核心规则必须等真实数据库、界面和设备都准备好才能验证,说明应进一步检查依赖和职责。这里的目标不是把所有机制都消除,而是让必要机制通过明确的契约接入,并把不可避免的变化限制在可理解的范围。

软件架构还需要演进。过早把每个未来需求都做成参数,会把猜测本身变成负担;忽略已经明显存在的变化,又会让日常维护变成昂贵工程。书中的案例和附录因此应与具体约束一起读:学习的是判断依据及失败原因,而非把某个年代的产品选择当成永久答案。

发散与实践

读者延伸:本次保留源码深读、当前cardbox责任与依赖的证据观察,以及三种架构表达的横向比较三条路径。已固定公开样本提交、确认入口并填写首轮资料;完整实现阅读、全库审计及实际重构仍未执行。计划见本书ideas目录。

生成进度与管理记录

架构整洁之道

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

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 本书