来源书籍

程序员必读之软件架构

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

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

类别清单覆盖

7/7

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

全书导读

软件架构把系统的重要结构、决定和共同方向联系起来。本书面向开发人员说明:怎样知道哪些决定值得先想,怎样与团队共同承担责任,以及怎样用图、指南和风险讨论把判断带回实现。案例技术属于出版时的环境,阅读重点是它们如何体现选择、约束和反馈。

全书主线

先界定架构的范围:既包括代码怎样组织,也包括应用如何集成与运行;再确认由谁理解并照看整体。角色与能力明确后,设计要从功能、质量要求、约束和原则出发,而不是从流行技术清单出发。

C4 通过不同层次的图帮助团队看见结构,软件指南补足代码难以表达的目的、背景、部署和支持信息。风险方法将这些认识用于决定前期设计的深度:优先验证代价高、不确定性大的部分,随后随着交付继续调整。这些工作互相反馈,并非做完一份文档便永久结束。

推荐序一:架构师真正要学会的事情

架构能力、实际承担的角色与职位头衔是不同层面的事。推荐序先借既有产品和学习经历讨论经验怎样帮助观察,也怎样限制观察,再提醒读者不要把获得他人认可的头衔当作学习的全部目标。“忘掉”是一种放下固有设定的比喻;这里没有给出心理实验或普遍历史因果证明。

区分能力角色与头衔

架构能力是识别结构、作出权衡的本领;架构角色是工作中承担的责任;架构师职位是组织赋予的头衔。三者可能重合,也可能分离:开发人员可以承担架构责任,有头衔的人也未必履行了这些职责。辨别三者,才能讨论需要补什么能力、由谁做哪些事,而不把争职位当作解决设计问题。

知识卡及原书摘录。

原书依据 · 1 处

既有模型也会遮蔽问题

学习架构不只是积累现成模型,也要识别模型的适用条件。沿用熟悉的分类,可能使人只寻找已经知道的答案,忽视眼前系统真正的限制。“看、听、做,然后忘掉”提示把经验作为可重新检查的工具;这里的“忘掉”不是丢弃知识,而是不让既有解释代替观察。这是推荐序的学习主张,并非经过实验验证的普遍心理规律。

知识卡及原书摘录。

原书依据 · 1 处

推荐序二

推荐序将主动承担问题与等待职位任命区分开来。成为能够帮助项目的人,要从已有工作中观察、判断并行动,而不是先争取一个称号。这与前一篇的能力、角色、职位区分相接,也为后面把软件架构视为团队责任作铺垫。该序没有展开另一套可独立执行的管理方法。

译者序2.0

译者用参与企业项目的经历说明,架构并非只画高层图:理解系统、写代码、学习新技术和与团队协作往往共同发生。译文希望缩小开发人员与架构师之间的距离。这里的个人经历提供阅读背景,不能用来证明某一组织的做法必然适用于所有团队。

序

软件开发中既有远离实现的设计,也有以速度为由忽略整体的做法。序言引出务实的中间道路:理解需要作出的重要决定,并在交付中持续检验。它说明本书为何面向开发人员,而不是提供与后文无关的新架构层次。

关于本书

本书围绕五个相互连接的主张:敏捷仍需要架构,架构并不等于一次性做完全部设计;职责可以在团队中共享,但仍需技术领导、编码和辅导;交流结构不必依赖特定工具或统一建模语言。后面的角色、驱动因素、图、软件指南与风险方法分别使这些主张可落地。介绍、受众及阅读安排不另拆知识卡。

Part Ⅰ 什么是软件架构

第一部分先澄清架构是什么,再讨论它与软件、敏捷及设计选择的关系。这里仅交代本部分的问题范围,实际定义和论证在随后六章展开,不把导语重复写成新卡。

第 1 章 什么是架构

架构既指已经形成的结构,也指推动结构形成和演进的工作。只看当前组件清单,会遗漏目标和方向;只谈愿景,也无法解释组件怎样配合。名词与动词两种视角使“现在是什么”和“要往哪里去”能够相互检查。

架构兼具动静

架构既是名词也是动词:名词侧重组件、模块、接口和交互等结构,动词侧重理解需求、设定愿景和做关键决策。发散:只画结构图而不传播愿景,团队仍会各自实现;只谈愿景而没有结构,也无法落到代码。

知识卡及原书摘录。

原书依据 · 1 处

第 2 章 架构的种类

应用、系统、基础设施等架构名称指向不同对象,但都涉及结构与愿景。共同点不意味着所有领域需要相同图纸或知识,而是提示讨论前先说明对象与尺度;本章以连接办公室的基础设施例子说明,简单拼接未必形成可维护的整体。

架构共性

不同 IT 架构类型看似分散,底层都离不开结构和愿景:先理解问题与环境约束,再组织组件协同达成目标。发散:评审任何“架构方案”时,都可以先问两件事:结构是否清楚,愿景是否能被参与者复述。

知识卡及原书摘录。

原书依据 · 1 处

第 3 章 软件架构是什么

应用程序架构关心代码、组件和框架的组织;系统架构进一步关心多个应用、基础设施和集成。两者结合才能从实现走到实际运行。企业架构则把范围扩大到组织如何利用人员、流程与技术实现战略,因此不是把软件类图再画大一点。

架构看全局

软件架构不只是类和代码组织,还包括横切关注点、质量属性、互操作、部署、运营和维护等会影响系统成败的元素。发散:开发者视角容易贴近代码,架构视角则要求把代码放回生产环境和组织约束中审视。

知识卡及原书摘录。

原书依据 · 1 处

企业架构不同

企业架构关注组织如何利用人员、流程和技术达成战略,软件架构关注具体软件系统如何从代码到部署形成可运行整体。发散:把企业架构当成软件架构师的自然晋升,会误把广度战略能力和深度技术能力混为一谈。

知识卡及原书摘录。

原书依据 · 1 处

应用与系统架构范围

应用架构主要关心一个应用的代码怎样组织,如模块、层和依赖。系统架构把范围扩大到硬件、网络、多个应用及其集成。讨论“软件架构”时需要说明两种范围怎样配合:只检查应用内部代码,无法回答它部署在哪里、如何与外部系统协作;反过来,系统框图也不能代替关键模块的设计。

知识卡及原书摘录。

原书依据 · 1 处

第 4 章 敏捷软件架构是什么

敏捷需要相对于环境变化来判断,而非只按固定迭代周期贴标签。观察、判断、决定、行动构成持续反馈的 OODA 循环;软件结构和组织协作会影响每次调整的速度。更小的服务可能减小局部改动范围,也可能增加沟通与集成成本,因此敏捷没有不付代价的结构选择。

敏捷是相对速度

敏捷不是仪式或标签,而是软件交付能否跟上环境变化的速度。一个月交付在缓慢组织里可能足够,在初创场景则可能太慢。发散:评估架构敏捷性时,应先看业务变化频率,而不是默认微服务或整体架构更先进。

知识卡及原书摘录。

原书依据 · 1 处

敏捷不是免费

小型松耦合服务能提升替换、扩展和独立测试能力,但会带来治理、部署和运维成本。发散:架构风格的选择应匹配所需变化速度;不需要高适应性时,简单整体系统可能更经济。

知识卡及原书摘录。

原书依据 · 1 处

OODA连接响应速度

OODA 是观察、判断形势、决策、行动组成的循环。行动后重新观察,才能调整下一轮判断。架构支持敏捷,意味着软件和团队能跟上环境变化,而不只是执行某种开发仪式。将系统拆小有时能缩短局部变化周期,但也会增加跨边界协作成本;循环的意义在于持续响应,不能据此推定微服务一定比单体敏捷。

结构图:

flowchart TD
 O[观察环境] --> R[判断形势]
 R --> D[作出决定]
 D --> A[采取行动]
 A --> O

知识卡及原书摘录。

原书依据 · 1 处

第 5 章 架构对上设计

并非每个设计决定都具有同样重量。改变成本高、后果重要的选择更值得架构层面关注。通过抽象层隔离数据库,可以降低更换数据库的直接影响,却使抽象层自身成为重要决定;重要性被转移,不能据此声称设计已经没有需要权衡的技术选择。

架构是难改设计

所有架构都是设计,但不是所有设计都是架构;真正的架构决策,是那些改变成本高、不能靠一个下午轻松重构的选择。发散:技术栈、整体结构和核心模式要更早验证,小型类设计则可在编码中演化。

知识卡及原书摘录。

原书依据 · 1 处

解耦转移重量

引入抽象层能让某个选择不再重要,却会把重要性转移到抽象层本身,这延续了“架构是难改设计”的判断。发散:每次“为了灵活”加层,都要问它消灭了风险还是换了风险。

知识卡及原书摘录。

原书依据 · 1 处

第 6 章 软件架构重要吗

失去整体方向后,每次局部修补都可能继续增加混乱,逐渐形成难以解释和修改的“大泥球”。架构工作的意义在于使局部实现与共同目标保持联系,并将性能、安全、可用性等质量要求纳入基础。它不保证设计永不出错,而是避免无人照看整体。

泥球源于失焦

软件架构天然存在;区别在于它是被主动设计,还是在无人负责大局时自然沉积成泥球。发散:结构、愿景和技术领导不是仪式感,它们是防止代码质量、安全、性能和可维护性同时失控的早期干预。

知识卡及原书摘录。

原书依据 · 1 处

第 7 章 问题

本章用自问问题收束第一部分:团队怎样定义架构、谁关注大局、什么决定难以改变、敏捷与结构如何相互影响。它帮助把前面的概念带回自己的项目,没有提供新的答案或方法,因此作为自评提示保留,不另成卡。

Part Ⅱ 软件架构的角色

第二部分把讨论从系统转向人:谁承担架构责任,需要哪些技术与协作能力,以及责任如何在团队成长时调整。本段是结构导语,具体职责与做法由后续各章承担。

第 8 章 软件架构的角色

架构角色包括理解驱动因素、设计、选择技术并处理风险、持续演化、参与编码及质量保证。角色是一组责任,不是高于开发者的级别。技术可行性与整体一致性需要在交付中持续照看,不能在画完一轮图后结束。

角色不是级别

软件架构师首先是角色而非级别,职责可以由一个人承担,也可以由团队共同承担。发散:给人头衔不能自动产生架构能力,团队需要明确这个角色要负责哪些决策、协作和质量结果。

知识卡及原书摘录。

原书依据 · 1 处

技术选择即风险

技术选择本质上是风险管理:复杂度或不确定性高时要降低风险,有利可图时才承担风险。发散:采购产品、引入框架或采用开源库,都应被证明能在给定约束下工作,而不是相信宣传材料。

知识卡及原书摘录。

原书依据 · 1 处

架构需要照料

架构不是先画完再交棒的产物,而要在交付过程中随需求、反馈和实现约束持续演化。发散:持续技术领导能把架构从静态方案变成活的决策系统,避免愿景与代码逐步分离。

知识卡及原书摘录。

原书依据 · 1 处

质量保证聚焦

架构质量保证不是检查每一行代码,而是聚焦架构显著、业务关键、复杂和高可见的部分。发散:有限精力应放在会放大风险的地方,比如安全边界、核心组件、一致性规则和关键交互。

知识卡及原书摘录。

原书依据 · 1 处

第 9 章 软件架构师应该编码吗

亲手做技术工作能让架构判断接触真实限制。可选入口包括原型、框架、重要实现和代码评审;原型尤其适合验证不确定之处。评审能够补充了解实现,却不宜长期替代编码。这不是要求架构负责人做完所有开发,而是要求其判断有实际工作支撑。

架构师应编码

架构图最终要变成代码,架构师保持编码实践能验证设计是否可实现,也能缩短与开发团队的距离。发散:不必成为团队最高产程序员,但完全脱离代码会让“实现细节”变成逃避现实的借口。

知识卡及原书摘录。

原书依据 · 1 处

原型连接架构

当日常编码不现实,原型、概念证明和基础框架建设能让架构师继续接触实现。发散:原型不是炫技,而是用最小成本回答“这个架构是否管用”的高风险问题。

知识卡及原书摘录。

原书依据 · 1 处

评审不能长期替代编码

代码评审能发现实现偏差,却不能长期替代亲手做技术工作。只从外部检查成果,容易错过工具、框架和限制在实际使用时暴露的问题。承担架构职责的人可参与原型、框架、复杂功能或日常实现,以保持判断与现实相连;这并不要求所有时间都编码,也不意味着参与一次评审就足以理解全部实现。

知识卡及原书摘录。

原书依据 · 1 处

第 10 章 软件架构师应该是建造大师

“建造大师”用设计与建造相连的比喻讨论技术领导。承担架构责任的人既理解整体,也应能参与实现,并把经验传给同伴。类比不能代替完整建筑史证据,其用途是反思设计者与建设者完全分离时的知识断层。

建造大师

软件架构师更像建造大师:既懂设计,也理解材料、工艺、团队组织和现场约束。发散:只会抽象表达、不懂实现的人很难承担技术领导,因为架构判断必须落在可建造性上。

知识卡及原书摘录。

原书依据 · 1 处

学徒式传承

未来架构师无法只靠阅读产生,需要在资深技术人员指导下逐步承担更大设计责任。发散:团队若把资深者都推向管理岗位,会失去培养架构判断力的现场。

知识卡及原书摘录。

原书依据 · 1 处

第 11 章 从开发者到架构师

从开发者走向架构角色,不应只按任职年限衡量。更有用的是考察在理解需求、设计、技术风险、演化、编码与质量等责任上达到多深程度。不同人在不同维度可能长短不一,职位名称不能概括全部能力。

看责任深度

从开发者到架构师的差别不只在经验年限,而在对驱动力、技术风险、演化、编码和质量结果承担多深的责任。发散:面试架构师时,比起问“做过什么项目”,更应追问他负责过哪些不可轻易反悔的决策。

知识卡及原书摘录。

原书依据 · 1 处

第 12 章 拓展T

T 形能力把某些技术的深入经验与较广的方案视野结合起来。只熟悉一种工具,容易用同一种办法处理所有问题;但不可能独自精通全部领域,因此还需要结对设计和向专家学习。广度用于看见选择,深度用于评价与实现,协作补齐个人知识边界。

T形技术能力

架构师需要技术深度来判断方案是否可行,也需要技术广度来比较不同选项的取舍。发散:只有一把技术锤子时,所有问题都会变成钉子;广度能让架构讨论从偏好回到语境。

知识卡及原书摘录。

原书依据 · 1 处

结对架构

没有人能精通一个系统涉及的全部技术,承认知识缺口并找懂的人一起设计,是架构能力的一部分。发散:像结对编程一样结对架构,可以减少盲区,也让团队更容易认同关键决策。

知识卡及原书摘录。

原书依据 · 1 处

第 13 章 软技能

技术领导不仅处理技术,还要帮助人员朝共同方向工作。沟通、信心、合作、指导、辅导、激励、授权和责任感分别影响团队能否理解并实现设计。负责人的情绪会影响周围的人;委派任务也不能免除对整体结果的关注。

软技能是架构力

架构是一种领导角色,沟通、影响、合作、指导、辅导和责任感会直接影响技术愿景能否落地。发散:再正确的架构方案,如果不能被团队理解、挑战和共同拥有,也只是漂亮的孤岛。

知识卡及原书摘录。

原书依据 · 1 处

情绪会放大

架构师处在高影响力位置,主动、热情和乐观会带动团队,冷漠和悲观也会迅速扩散。发散:技术领导不是只做决策,还要维护团队愿意跟随愿景前进的心理能量。

知识卡及原书摘录。

原书依据 · 1 处

指导与辅导职责不同

指导更依赖已有经验:向同伴解释技术、提供建议,帮助其学习某个领域。辅导侧重帮助对方思考、澄清方向并找到自己的办法。承担技术领导责任时需要区分这两种需求;对缺少必要知识的人只提问可能无助,对已经能够判断的人事事给答案又会压缩自主性。根据人员与问题选择方式,比把帮助等同于代做更合适。

知识卡及原书摘录。

原书依据 · 1 处

授权不转移最终责任

把设计或实现任务交给同伴,可以分散工作并培养判断能力;但承担软件架构角色的人仍要关注整体结果。授权时需要讲清目标和范围,保持必要的支持与反馈,而不是交办后不再过问。任务可以委派,架构责任不会自动消失;这也不要求负责人亲自完成每个决定。

知识卡及原书摘录。

原书依据 · 1 处

第 14 章 软件架构不是接力运动

把架构当作前一组设计、后一组照做的接力,会在交接中丢失背景、权衡与意图。持续参与使设计可以根据实现反馈调整,也能帮助同伴理解为什么如此选择。责任连续不意味着一个人永久垄断所有决定,而是避免交付文档后无人继续照看方向。

架构不是接力

架构不是先由某人设计再交给团队实现的接力棒;愿景背后的上下文若随文档交接丢失,开发团队很难真正负责。发散:架构角色应贯穿交付,持续解释、调整和承担结果。

知识卡及原书摘录。

原书依据 · 1 处

第 15 章 软件架构要引入控制吗

技术控制程度更像可以调节的操纵杆,不能只有全面控制或完全放任两档。团队经验、任务风险和组织文化会影响应当提供多少指导。明确边界、给予支持并观察结果,才能在一致性与自主性之间逐步调整。

控制像操纵杆

架构需要一定控制来保持一致性,但控制不是开关,而是随团队经验、规模、复杂度和约束调节的操纵杆。发散:团队总问“为什么、怎么办”时需要更多指导;团队持续抵触时可能控制过量。

知识卡及原书摘录。

原书依据 · 1 处

第 16 章 小心鸿沟

开发者与架构师之间的鸿沟可能由双方共同维持:前者不理解整体约束,后者不愿接触代码与日常困难。两边都需要主动交流、共同工作并澄清责任。单靠改变头衔或宣称不要架构,无法让设计与实现自然一致。

缩小角色鸿沟

开发者只盯代码细节、架构师只在高处下令,都会制造鸿沟。有效架构需要架构师理解底层痛感,开发者理解大局和决策语境。发散:协作式架构能把挑战决策变成共同改进,而不是身份对抗。

知识卡及原书摘录。

原书依据 · 1 处

第 17 章 未来的软件架构师在哪里

日常编码、重构与测试的练习机会很多,从零设计一个由团队实现的系统却较少发生。架构能力因此需要刻意练习、指导和辅导;让资深技术人员只能转管理岗,也可能削弱团队的导师来源。它强调培养路径,不声称所有晋升制度都相同。

架构需刻意练习

多数开发者很少从零设计一个由团队实现的软件系统,因此架构能力不会自然从日常编码中长出来。发散:组织需要为设计、评审、指导和演练留出空间,否则未来架构师会断层。

知识卡及原书摘录。

原书依据 · 1 处

第 18 章 每个人都是架构师,除非他们有其他身份

团队能否共同承担大局,决定架构职责适合集中还是分享。生存型、学习型与自组织型是用于选择领导方式的模型:分别更需要直接引导、辅导或支持。敏捷并未取消结构、技术风险和一致性问题,角色的分散需要真实能力支撑。

角色随成熟变化

生存型团队处于混乱中,通常需要较直接的指挥;学习型团队逐步理解共同工作方式,需要辅导;已经能共同承担大局的自组织团队,则适合由领导者提供帮助并分散架构责任。这是书中引用的团队成熟度模型,不是给人员永久分级。

共享架构角色需要实际能力支撑,不能只靠“人人都是架构师”的口号。如果团队缺少整体设计经验,应明确有人对架构负责,再通过共同工作培养能力。

知识卡及原书摘录。

原书依据 · 1 处

敏捷仍需架构

敏捷反对的是大型预先设计,不是架构本身。复杂非功能需求、约束和关键风险不会因为迭代开发而消失。发散:把“不要大设计”误解为“不需要架构”,常会把团队推向混乱。

知识卡及原书摘录。

原书依据 · 1 处

第 19 章 软件架构咨询师

咨询工作需要技术判断,也需要迅速理解业务领域及组织情境。跨项目经验不自动包含客户的规则与历史;承担结果责任时,也应明确能够作什么决定。领域理解、沟通以及权责相称共同影响咨询能否带来实际帮助。

责任配权威

咨询场景下,如果架构师要为技术交付负责,就必须拥有足够决策权;只有责任没有权力,会让每个关键选择都陷入许可和摩擦。发散:权威不只是职位,也来自领域理解、信任关系和能与团队一起交付。

知识卡及原书摘录。

原书依据 · 1 处

咨询先补领域理解

外部顾问可能有广泛的技术经验,却不了解组织的业务规则、人员关系和历史限制。咨询开始时需要补齐这些领域知识,才能判断技术方案是否可行;与此同时,客户也应说明顾问拥有何种决策权。快速学习业务与明确权责相互配合,不能用跨项目经验代替具体情境,也不能要求缺少授权的人单独承担全部结果。

知识卡及原书摘录。

原书依据 · 1 处

第 20 章 问题

本章要求读者检查团队如何分担架构责任、人员需要补什么技能、如何安排编码与辅导。问题用于评价第二部分在具体团队中的适用性,没有额外给出普遍分工比例,保留为自评而不生卡。

Part Ⅲ 设计软件

第三部分进入设计输入:先理解什么驱动结构,再决定如何分解系统。导语只连接前面的角色责任与接下来的功能、质量、约束和原则,不重复生卡。

第 21 章 架构驱动力

架构受到四类因素共同驱动:功能需求说明要完成什么任务,质量属性说明要达到何种表现,约束限制可选范围,原则提供团队主动采用的方向。质量要求不宜等实现完成后再补;同时需分清被规定的限制和可以重新评价的偏好。

驱动力塑造架构

架构由功能需求、质量属性、约束和原则共同驱动。缺少这些输入就开始设计,容易得到看似合理却不满足目标的方案。发散:每次架构评审都应先确认驱动力是否清楚,再讨论结构是否优雅。

知识卡及原书摘录。

原书依据 · 1 处

约束激发设计

约束会减少选择,也能迫使设计更有创造力。完全自由常导致杂乱,明确边界反而帮助做出明智决策。发散:把约束列清楚不是消极服从,而是让团队知道哪些地方能创新、哪些地方要尊重现实。

知识卡及原书摘录。

原书依据 · 1 处

区分约束与原则

约束是设计必须面对的限制,如已经指定的平台、预算或交付时间;原则是团队主动采用的设计方向,如保持一致的分层方式。两者都会影响选择,但改变它们的路径不同:调整约束常需找到规定它的人,修改原则则需重新评价团队的设计依据。记录时应分清既定限制与主动选择,避免把偏好写成无法协商的事实。

知识卡及原书摘录。

原书依据 · 1 处

质量属性进基础

性能、可伸缩性、可用性、安全等质量属性常是横切的,越晚加入越困难。发散:这些属性不是验收末尾的优化项,而应在结构、技术和部署策略中提前占位。

知识卡及原书摘录。

原书依据 · 1 处

第 22 章 质量属性(非功能需求)

质量属性把“好软件”展开为不同问题。性能关注速度,可伸缩性关注负载增长;可用性关注服务运行,灾难恢复关注严重故障后的继续服务;可访问性关注使用障碍。安全涉及身份、权限和机密性;监测提供观察,管理允许改变运行状态。审计保留谁、何时、为何改变了什么;灵活性适应既有工作变化,扩展性增加新能力。维护者、法规、语言与地区格式又分别带来维护、保留、国际化和本地化要求。这些是需要选择和具体化的需求,不能仅靠一份标签清单满足。

性能与伸缩性不同

性能关心在给定条件下完成工作有多快,例如请求响应时间;伸缩性关心负载或数据量增大后,系统能否继续满足要求,以及需要增加什么资源。一次请求很快,并不证明并发增加后仍然快。分别记录当前负载下的目标和增长条件,才能判断优化单次处理与扩大承载能力各需要解决什么问题。

知识卡及原书摘录。

原书依据 · 1 处

可用性不等于灾难恢复

可用性关心服务在需要时能否使用;灾难恢复关心发生严重故障后如何重新提供服务,以及恢复需要多久。两者有关联,却不是同一个要求:日常运行稳定,不能证明机房失效后的数据与服务能够恢复。写质量目标时应分别说明服务时间和重大故障后的恢复期待,避免用一个“高可用”词包办不同问题。

知识卡及原书摘录。

原书依据 · 1 处

监测与管理读写有别

监测让人读取系统状态,例如健康情况和运行指标;管理允许在运行期间改变系统状态或配置。一个只展示信息的仪表板,并不自动具备安全修改配置的能力。区分这两个需求,才能进一步确定需要展示什么、谁可以改变什么,以及变更后怎样观察结果,避免把“能够看见”误写成“能够控制”。

知识卡及原书摘录。

原书依据 · 1 处

灵活性与扩展性不同

灵活性关注既有功能适应变化的能力,例如改变现有流程的参数或组合;扩展性关注加入新功能的难易。能通过配置切换已有行为,并不代表能轻松增加一种全新能力。表达需求时应举出预期变化:是调节已支持的任务,还是新增任务;否则“未来要灵活”无法为当前设计提供清楚的取舍依据。

知识卡及原书摘录。

原书依据 · 1 处

国际化与本地化不同

国际化使软件能够支持不同语言和地区;本地化把产品适配到具体地区的语言、日期、数字或货币等惯例。翻译界面文字只是其中一部分。区分这两种工作,有助于先确定需要支持哪些地区及变化方式,再检查格式、输入与展示,而不是将“英文版能够运行”当作所有地区已经适用。

知识卡及原书摘录。

原书依据 · 1 处

可访问性涵盖使用障碍

可访问性关注有视觉等障碍的人能否使用软件,与服务是否在线是不同问题。系统即使没有停机,也可能因为呈现或交互方式使部分用户无法完成任务。写质量需求时,应明确需要支持的用户及使用条件;不能以可用性指标替代无障碍要求。本章指向相关标准作为继续了解的入口,没有给出完整实施检查表。

知识卡及原书摘录。

原书依据 · 1 处

审计保留变更上下文

审计日志保留改变数据或系统行为的事件,使之后可以追查由谁、何时、为什么作出变更,必要时还包括变更前后的值。它与只为排错留下技术信息的日志用途不同。涉及资金或受监管数据时,相关保留要求也会影响设计;具体范围应依据系统实际要求确定,本章并未给出所有行业通用的合规规则。

知识卡及原书摘录。

原书依据 · 1 处

可维护性需要维护语境

“易维护”取决于以后由谁维护、需要进行什么变化,不能只给代码贴一个质量标签。先了解维护者的技能和环境,再决定采用哪些架构与开发原则,让代码更容易理解和修改。代码组织、测试等做法可以帮助维护,但本章没有提供一个可脱离人员与系统背景的统一量化指标。

知识卡及原书摘录。

原书依据 · 1 处

第 23 章 处理非功能需求

收集质量需求后,需要继续澄清范围、量化目标、质疑不现实的承诺,并让成本帮助相关人员排序。例如声称永远不中断,没有说明代价与条件,就不能直接成为可实现的设计输入。目标应当能被检查,也要说明在哪些情况下检查。

非功能要量化

“系统必须快、安全、100%可用”没有设计价值,必须转成并发量、响应时间、停机容忍度、保护对象等可验证条件。发散:量化不是官僚主义,而是让架构能被测试和取舍。

知识卡及原书摘录。

原书依据 · 1 处

成本澄清优先级

当所有人都说需求“必不可少”时,说明不同方案的成本能帮助利益相关者重新排序。发散:架构讨论不只是能不能做,更要让业务看见每个质量目标背后的价格。

知识卡及原书摘录。

原书依据 · 1 处

第 24 章 约束

约束可能来自技术清单、部署平台、人员技能、资源和组织。先听清楚限制的原因,才能判断它如何塑造设计。约束还可能相互冲突:本章在得到客户接受的前提下,以交付期限的重要性协商技术清单例外,并不是允许团队自行绕过规定。

约束是设计输入

时间、预算、批准技术、部署平台、互操作标准和组织政治都会塑造架构。发散:忽视约束不是保持纯粹,而是在未来制造返工;好的架构会把现实条件纳入设计。

知识卡及原书摘录。

原书依据 · 1 处

人员也是约束

团队规模、技能、维护方能力和培训资源都会限制技术选择。发散:让 Java 团队交付 .NET 方案不是技术中立,而是在把学习成本和交付风险藏进架构里。

知识卡及原书摘录。

原书依据 · 1 处

约束也能划分优先级

约束之间可能冲突,例如既要按期交付,又必须使用组织规定但不适合任务的技术。先说明每项约束由谁设定、对设计有什么影响,再比较哪项更重要,必要时向有权决定的人申请例外。识别优先级不等于工程师自行忽略规定;它使冲突可以被明确讨论,而不是把所有限制默认为同样不可改变。

知识卡及原书摘录。

原书依据 · 1 处

第 25 章 原则

原则是团队为一致性选定的设计方向。分层、关注点分离、无状态组件、业务逻辑位置、会话状态及数据一致性等选择,都有特定适用条件。无状态可以帮助复制扩容,但不能抹掉系统数据。SOLID 等在此作为继续关联的名称保留,不补造本书未展开的完整教程。

原则带来一致

原则用于让团队以一致方式构建软件,例如分层策略、数据访问方式、会话使用和一致性模型。发散:原则不是装饰性口号,只有能约束日常决策,才会降低代码库的认知和维护成本。

知识卡及原书摘录。

原书依据 · 1 处

最佳实践看语境

最佳实践并非任何时候都最佳;快速战术方案若套用复杂分层,可能比问题本身更重。发散:原则要服务目标和约束,团队反馈是判断原则是否帮助而非阻碍的信号。

知识卡及原书摘录。

原书依据 · 1 处

无状态组件便于复制

无状态组件不把后续请求必须依赖的会话状态只留在自身实例中,因此新增或替换实例时,不必先把该实例的会话搬过去。这使复制和负载分配更容易,但不表示整个系统没有状态;数据和会话仍需要有明确归属。把无状态作为设计原则时,应说明哪些状态存在哪里,不能只给组件贴标签。

知识卡及原书摘录。

原书依据 · 1 处

分层以抽象隔离访问

UI、业务和数据访问是不同职责。若希望切换存储时较少影响业务,就让数据访问层提供抽象,业务层通过它使用数据,而不直接依赖具体存储机制。这个原则需要落实到调用位置,例如不把数据访问逻辑放入 UI 或领域对象。隔离会带来额外结构成本,是否值得仍需结合系统规模和变化需要判断。

知识卡及原书摘录。

原书依据 · 1 处

业务逻辑位置需要统一

业务逻辑分散或重复,可能使不同入口逐渐执行不同规则。团队需要明确哪些规则放在什么位置:例如由服务器承担处理,或继续使用已有后端中的规则而不再复制。选择位置时要考虑性能、维护和现有系统;一致性不是要求所有系统采用同一种层次,而是避免同一规则被无意维护多份。

知识卡及原书摘录。

原书依据 · 1 处

领域模型富贫有别

丰富的领域模型让对象承载较多领域行为;贫瘠的模型主要由数据结构组成,再由较粗粒度的组件或服务处理它们。两种组织方式把行为放在不同位置,团队需要知道采用哪一种并保持一致。本章只描述差异及一致性问题,没有证明其中一种在所有情境中更好。

知识卡及原书摘录。

原书依据 · 1 处

会话策略关联扩容方式

把请求之间的临时信息存入 HTTP 会话,会使系统需要决定状态放在哪里。扩容或服务器故障时,后续请求能否取得它,取决于是否需要固定路由到同一实例、是否复制会话,以及复制的成本。是否使用会话不能只凭方便决定,应与伸缩和故障策略一起考虑,并让所有开发者理解约定。

知识卡及原书摘录。

原书依据 · 1 处

一致性目标取决于语境

不同业务对“立即看到更新”的需要不同。某些状态展示能够接受延迟,从而为性能或伸缩性留下空间;另一些情境则不能随意延迟。先说明哪些数据在何时必须一致,再选择方式,并在团队中保持一致理解。本章用社交状态更新举例,只说明需求取舍,没有提供一致性协议或允许所有业务牺牲正确性。

知识卡及原书摘录。

原书依据 · 1 处

第 26 章 技术不是实现细节

技术选择会改变安全、成本、开发与运行方式,因此不能一概推迟为实现细节。加入抽象层可能隔离某项选择,也会引入新的重要依赖。合理延迟需要知道迟做能获得什么信息,以及未来要付出什么代价,而不是默认所有决定都可无成本撤回。

技术不是细节

技术选择会影响非功能需求、组织约束、一致性、计划和成本,因此不是可以完全推迟给实现阶段的细节。发散:它与“技术让图落地”相连,关键技术选项能逼团队讨论真实可行性。

知识卡及原书摘录。

原书依据 · 1 处

解耦不是免费

解耦可以推迟某些技术决策,但抽象层、框架和额外分层本身会成为新的重要决策,呼应“解耦转移重量”。发散:为了未来可能变化而加层,要证明变化收益大于复杂度成本。

知识卡及原书摘录。

原书依据 · 1 处

第 27 章 更多分层等于更高复杂度

金融系统练习中的客户端选择,进一步引出数据服务、认证授权、测试和部署需求。Silverlight 与 WCF 是历史案例的技术,不作为当前选型建议;可迁移的认识是:新增一层或一种技术,会改变周围的工作,内网部署也不能代替数据权限设计。

分层增加复杂度

每增加一层都会带来新的接口、安全、部署、测试和运维问题。发散:富客户端、中间服务和数据库的组合不是“免费增强”,而是更多可移动部件;架构收益必须覆盖新增复杂度。

知识卡及原书摘录。

原书依据 · 1 处

内网数据服务仍需授权

Silverlight 客户端不能直接沿用原有的数据库访问方式,新增 WCF 数据服务又引出了身份与权限问题。即使服务只在局域网使用,也需要判断调用者能读写哪些数据,不能把网络位置当作权限检查的替代。增加服务层还带来测试与部署工作;技术选型的成本应包括这些配套变化,而不只计算新界面的开发量。

知识卡及原书摘录。

原书依据 · 1 处

第 28 章 协同设计是一把双刃剑

不同技术专长的人容易从各自经验出发,默认为某些假设成立。共同设计使这些假设显现,并让方案接受其他角度的挑战。协作不保证自动达成一致,但可以把隐含选择变成可讨论的依据。

协作暴露假设

不同专家会按自身经验设计同一需求,Web、服务端和数据库视角可能各执一词。发散:白板协作的价值在于尽早让假设暴露、被挑战并形成共识,而不是让最强势的人独自决定结构。

知识卡及原书摘录。

原书依据 · 1 处

第 29 章 软件架构是对话的平台

架构图和设计讨论连接开发、业务、运维、安全等利益相关者。不同群体关心的风险和质量不同,技术设计需要让这些需求被看见。交流不是单向通知最终答案,而是用适合受众的表达检查整体是否满足真实期待。

架构承载对话

软件架构是与开发、运维、安全、审计、数据库和未来维护者对话的平台。发散:五分钟跨团队沟通常能发现隐藏驱动力,避免交付前才撞上服务器、许可证、安全政策或支持流程。

知识卡及原书摘录。

原书依据 · 1 处

第 30 章 SharePoint项目也需要软件架构

使用现成平台并不消除架构工作。平台提供能力和限制,团队仍需判断如何组织、配置、集成与部署它,以满足本系统的目标。是否写了大量自定义代码,不能决定是否需要设计。

平台项目也要架构

即使用 SharePoint、SAP 或 CRM 这类平台,集成、定制代码、质量属性、文档和技术领导仍然存在。发散:平台降低了部分实现成本,但没有取消大局、约束和一致性问题。

知识卡及原书摘录。

原书依据 · 1 处

第 31 章 问题

本章让读者回查功能、质量、约束、原则与人员视角是否已经纳入设计。自评问题用于暴露尚未说清的输入,不构成一个脱离项目条件的强制标准或新机制。

Part Ⅳ 可视化软件

第四部分讨论怎样让结构被看见。开发看板能显示工作状态,却不能解释软件由什么组成、各部分如何交互;因此过程可视化与软件可视化需要分别处理。导语承接设计输入,后续章节给出草图与分层表达方式。

第 32 章 沟通障碍

看板和流程图回答工作如何推进,系统结构图回答运行单元、职责与依赖怎样组织。只把迭代任务贴满墙,并不能帮助新人理解系统全貌。两种图服务不同目的,应先确定想让读者理解的对象。

要可视化软件

团队善于用看板可视化流程,却常不会可视化正在构建的软件。发散:理解架构不等于能表达架构;没有有效图表,敏捷团队也会缺方向、共识和技术领导。

知识卡及原书摘录。

原书依据 · 1 处

第 33 章 对草图的需要

草图用简单、可讨论的方式传达软件大局,不是追求艺术效果,也不必建成包罗万象的模型。共享的图能让团队共同检查边界、职责和关键选择;其价值来自解释与交流,而不是选了多昂贵的绘图工具。

草图建共同愿景

草图不是艺术作品,也不是综合模型,而是在短时间内传达大局、建立共同愿景和支撑协作设计的工具。发散:语境、容器、组件图往往比厚重模型更适合让团队快速对齐。

知识卡及原书摘录。

原书依据 · 1 处

第 34 章 无效的草图

本章逐一分析十一个常见草图问题:只列购物清单、只有框没有关系、含义不明的颜色、过密连线、泛泛的业务逻辑标签、技术缺失、制品与运行对象混用、协议不明、无所属容器的对象、把结构混成流程,以及难以辨识的白板。它们共同提醒读者标明对象、职责、边界和交互,不能靠作者现场解释补齐所有缺口。

无效图缺关系

只有框没有线、职责和交互的图,无法表达软件架构。发散:结构不仅是“有什么东西”,还包括它们如何协作;线条和标签不是装饰,而是理解系统行为的关键。

知识卡及原书摘录。

原书依据 · 1 处

图要喊出业务

充满“业务逻辑”“处理器”等泛化词的图很难说明系统真正解决什么问题。发散:架构图应像代码结构一样喊出业务领域,让人一眼看出这是风险系统、银行系统还是内容平台。

知识卡及原书摘录。

原书依据 · 1 处

部署文件不等于运行进程

JAR 等部署文件说明代码如何打包,却未必说明系统运行时有哪些进程。一个文件可能被不同运行单元使用,多个文件也可能在同一应用中运行。如果图把文件直接画成独立服务,读者就可能误判通信与故障边界。先确定图表达打包结构还是运行结构,再标明进程、容器及交互,避免混用抽象层次。

知识卡及原书摘录。

原书依据 · 1 处

第 35 章 C4:语境、容器、组件和类

C4 用语境、容器、组件和类逐层进入同一系统。先建立共同抽象,再选择足够清楚的表示法;不必强迫所有人先学习一整套符号。每层保持问题范围明确,才能向不同受众解释不同深度的结构。

C4分层视图

C4 用不同抽象层次描述同一个软件系统。语境图先说明系统服务谁、与哪些外部系统交互;容器层打开系统,展示可运行软件单元或数据存储;组件层说明某个容器内部的职责分组;类层进一步解释组件如何由代码类型实现。

每层回答的范围不同,不能把所有细节堆成一张图。这里的容器是逻辑运行和部署抽象,不特指某个虚拟化产品;具体服务器、副本和故障切换需要部署视图补充。

结构图:

flowchart TD
 S[系统语境 用户与外部系统] --> C[容器 运行单元与存储]
 C --> P[组件 容器内部职责]
 P --> T[类 组件的代码结构]

知识卡及原书摘录。

原书依据 · 1 处

抽象胜过标记

团队先共享系统、容器、组件、类等抽象,比强行统一 UML 标记更重要。发散:非正式图可以灵活,只要用图例和一致约定补上可理解性。

知识卡及原书摘录。

原书依据 · 1 处

第 36 章 语境图

语境图把当前系统放回用户、外部系统和环境中,回答系统是什么、谁使用、怎样融入周围工作。它从边界与价值出发,通常避免不必要的底层技术细节,为后面的容器和组件图规定观察对象。

语境图定边界

语境图回答系统是什么、谁使用它、它如何融入现有 IT 环境。发散:它不追求技术细节,而是先消除关于用户、外部系统和系统边界的隐含假设。

知识卡及原书摘录。

原书依据 · 1 处

第 37 章 容器图

容器图打开系统,说明主要运行单元和数据存储、各自职责、技术以及通信方向与方式。此处“容器”是 C4 的逻辑抽象。物理机器数量、多个副本和故障切换并不由这张图完整表达,需要部署视图补充。

容器图开盒子

容器图打开系统盒子,展示可独立部署或运行的主要容器、技术选择、职责和通信方式。发散:它承接“语境图定边界”,连接高层语境和细节组件,是开发、运维和支持都能读懂的技术大图。

知识卡及原书摘录。

原书依据 · 1 处

容器视图不同部署实例

C4 容器视图说明软件由哪些可运行单元或数据存储组成,以及它们的职责、技术和通信。这里的容器是架构抽象,不特指 Docker 容器,也不要求每个容器独占操作系统进程。它通常不表达负载均衡后的多个物理副本;副本位于哪些机器、怎样切换,需要另用部署视图说明。

知识卡及原书摘录。

原书依据 · 1 处

第 38 章 组件图

组件图聚焦某一个容器内部,把协作完成工作的代码组织为职责明确的组件,并说明接口和关系。共享核心并非凭空独立运行的服务:若它作为库随多个容器部署,就应在各自实际位置表示。技术部落示例将 Web 与更新器使用的核心能力联系起来。

组件图分职责

组件图展示某个容器内的关键逻辑组件、职责和依赖,是“容器图开盒子”之后的放大层。发散:如果一个需求找不到承接它的组件,架构可能已经漏掉了重要职责。

知识卡及原书摘录。

原书依据 · 1 处

第 39 章 是否包含技术选择

标注技术有助于判断结构能否实现:数据库、协议、运行平台会带来不同限制。图如果只留下抽象盒子,读者可能无法评价关键技术风险。技术细节的多少应服从图的受众与层次,而不是完全不写或全部堆入。

技术让图落地

架构图包含技术选择能消除歧义,让讨论从概念分解回到真实实现、通信和约束。发散:如果图上没有技术,人们很容易假设“随便什么都行”,直到非功能需求证明并非如此。

知识卡及原书摘录。

原书依据 · 1 处

第 40 章 你会那样编码吗

架构图必须能映射到实际代码与部署。共享库若分别装在两个容器中,应画出实际存在的位置;分层图也应对应真实调用关系。否则图看起来整齐,却会让维护者误判边界和运行行为。

图要照进代码

架构图应该反映将如何编码和部署,而不是画出不存在的概念物。发散:共享库就画在使用它的容器中,独立服务才画成独立运行单元;图和代码越能互相映射,沟通成本越低。

知识卡及原书摘录。

原书依据 · 1 处

第 41 章 软件架构和编码

代码按层组织时,一项业务能力可能分散在服务层和数据访问层;按特性组织靠近业务,但仍需管理内部边界。组件封装把公开接口与内部实现收拢,使图里的组件能在代码中找到。tweet 示例包含真实接口、实现和 DAO;附录的一张左右标签与本章图示相反,理解类型关系采用本章图28、29,不沿用那个错标签。

架构代码映射

架构图谈组件,代码却按层散落,会形成“模范代码的差距”,也解释了“图要照进代码”的重要性。发散:当代码结构无法支持架构理解时,代码不是唯一真相,而是另一种需要修正的表达。

知识卡及原书摘录。

原书依据 · 1 处

组件封装喊业务

以组件组织代码能让包结构对应架构图中的业务能力,而不只是 UI、服务、数据访问等技术层。发散:整体系统也可以通过组件边界获得更清晰的所有权和可迁移性。

知识卡及原书摘录。

原书依据 · 1 处

组件封装收拢实现

组件封装把实现一个业务能力的接口和内部实现放在同一组件边界内,外部通过公开接口使用它。书中的 tweet 组件公开 TweetComponent,TweetComponentImpl 实现它,并使用 MongoDbTweetDao 访问存储。这样外部代码不必逐层接触实现细节。图保留原书的三个真实类型与关系;原文未列方法签名,因此不补造方法。

结构图:

classDiagram
 class TweetComponent {
 <<interface>>
 }
 class TweetComponentImpl
 class MongoDbTweetDao
 TweetComponent <|.. TweetComponentImpl : 实现
 TweetComponentImpl --> MongoDbTweetDao : 使用

知识卡及原书摘录。

原书依据 · 1 处

第 42 章 你不需要UML工具

绘图、反向工程、往返工程和模型驱动工具承担不同工作。C4 主要表达静态结构,运行交互可补序列或协作图,流程可用活动图,领域关系和模式可用类图,状态及部署也有相应表达。工具选择应跟着沟通问题走,不必全用,也不能以“不需要工具”否定这些图的用途。

工具不是前提

架构设计不依赖昂贵 UML 工具,白板、纸和便利贴常常更适合协作。发散:工具应在团队明白如何设计和沟通之后再提升流程,而不是替代思考。

知识卡及原书摘录。

原书依据 · 1 处

区分四类建模工具

建模工具可以只用来画图,也可以从代码反向提取结构;往返工程进一步尝试保持模型和代码对应;模型驱动方式则以模型生成实现。它们对模型的权威性、维护方式和投入要求不同。选择前先决定要辅助沟通、观察现状,还是让模型参与生成,不能仅因工具会画 UML 图就认为其用途相同。

知识卡及原书摘录。

原书依据 · 1 处

静态结构需补运行行为

C4 的分层结构图说明系统由什么组成,却不能单独讲清一次请求如何执行。重要流程可以补充时序图或活动图,状态变化可以补充状态图;这些图回答交互次序、分支或状态转移等不同问题。先找读者尚不理解的行为,再选择表达方式,不必给每个组件机械配齐所有图。

知识卡及原书摘录。

原书依据 · 1 处

第 43 章 有效的草图

有效草图需要标题、标签、可理解的形状与线条、职责、边界和必要图例。颜色与箭头若承担含义,就要说明。九点评审清单进一步检查多个抽象层次、大局、容器组件、可追踪性、业务领域及实现策略,目的在于验证读者能否理解方案。

图例降低误读

非正式草图需要标题、标签、线条含义、颜色编码、边框和缩略语说明。发散:只要画图者必须口头解释箭头含义,就应该把这个解释放进图例里。

知识卡及原书摘录。

原书依据 · 1 处

评审图看九点

有效架构图应能展示抽象层次、大局、容器、组件职责、表示法、可追踪性、业务领域和实现策略。发散:评审图不是挑美观,而是检验它能否帮助团队做一致决策。

知识卡及原书摘录。

原书依据 · 1 处

第 44 章 C4的常见问题

常见问题包括层次能否混画、共享组件怎样表示、工具组件怎样减轻重复连线,以及多个系统怎样汇成企业语境。共享库仍按实际部署出现;所有组件都使用的工具能力可以用说明压缩重复。更高层企业系统地图在本书被称作 C5,是该书的扩展称呼。

C4守住层次

C4 常见问题的核心是保持抽象层次清晰:简单系统可合图,但一旦混乱就拆开,组件也要归属到实际容器。发散:画法应服务理解,不能为了省图而牺牲边界。

知识卡及原书摘录。

原书依据 · 1 处

企业语境承接系统地图

单一系统的语境图把该系统与用户、外部系统联系起来;当读者需要了解多个系统怎样服务组织时,还可以在更高层画企业范围的系统地图。Simon Brown 在这里将这种补充称为 C5。它用于连接组织全景与某个系统的细节,是本书提出的扩展说法,不能据此当成正式统一的行业标准。

知识卡及原书摘录。

原书依据 · 1 处

通用依赖可用注记压缩

日志等公共设施可能被许多组件共同使用。若把每条重复依赖都画成箭头,图会被交叉线淹没。可把适用于全图的公共依赖写成醒目的注记,并说明范围;关键业务依赖仍须明确展示。这是在保留信息的前提下压缩重复表达,不是把实际存在的共享设施从设计中删掉。

知识卡及原书摘录。

原书依据 · 1 处

第 45 章 问题

本章以问题检查草图是否能传达设计以及是否与实现一致。它要求读者回看自己的图,而没有提供新的结构类型;自评入口保留,知识解释由前面各章承担。

Part Ⅴ 为软件生成文档

第五部分把结构交流延伸到能够长期查阅的软件指南。导语关注文档怎样帮助维护与支持,不将文档页数等同于理解程度;具体指南部分在随后章节展开。

第 46 章 代码不会讲述完整的故事

代码会说明具体实现,却很难完整回答系统为何这样设计、怎样融入环境、技术为什么被选择,以及怎样部署和满足质量要求。新人如果缺少地图,就不得不靠命名与目录猜测。文档的职责是补充这些背景,而不是复制代码能够直接表达的一切。

代码不讲全貌

代码能显示实现,却难以解释系统如何融入环境、为什么选技术、组件如何部署、质量属性如何满足。发散:新成员读代码前若没有地图,会把大量时间耗在猜测设计意图上。

知识卡及原书摘录。

原书依据 · 1 处

第 47 章 软件文档即指南

软件指南像旅行指南,帮助读者认识范围、重要地点、历史和实用信息。产品持续演进,围绕产品的指南应保留关键背景;只按单次项目交付的文件,容易在项目结束后失去维护。指南的每一部分都有用途,应按真实需要选择内容。

文档是指南

软件文档应像旅游指南:提供地图、景点、历史文化和实用信息,帮助人快速探索,而不是试图成为静态百科全书。发散:短小、持续更新、指向关键兴趣点的文档,比厚重模板更有用。

知识卡及原书摘录。

原书依据 · 1 处

产品文档长存

产品级软件指南描述当前系统如何工作和演化,项目文档只记录某次变化。发散:长期系统若只有项目文档,新人必须考古多年材料;一份产品指南能成为稳定入口。

知识卡及原书摘录。

原书依据 · 1 处

第 48 章 语境

语境部分用简短篇幅交代系统目的、用户与环境,并可使用语境图。它是读者进入指南的起点,先说明为何需要这个系统,再进入技术结构。这里将已有语境图解释应用到文档场景,不因换了章节而重复生成同一想法。

进一步参见语境图定边界。

原书依据 · 1 处

第 49 章 功能性概览

功能概览总结关键能力,并把对架构有影响的用例、故事或流程连接到结构选择。它不代替需求规格,而是解释为什么后面的组件与交互需要这样存在。

功能概览保留架构关联

软件指南中的功能概览让读者知道系统提供什么能力,并看见这些能力为什么影响结构。选出重要用例、用户故事或工作流,说明它们涉及哪些处理与协作即可;不必复制完整需求规格。它连接系统目的与后续容器、组件及关键交互,使架构图里的边界能够回到真实任务来解释。

知识卡及原书摘录。

原书依据 · 1 处

第 50 章 质量属性

质量属性部分说明可衡量、现实且有范围的要求。明确不在范围的语言支持等内容也有价值,可避免读者误以为所有常见属性都已承诺。它把前面收集和量化需求的工作变成维护者可查的依据。

质量目标写清适用范围

“响应快”无法用于评价设计,质量目标需要可衡量的条件,也要说明适用范围。例如应交代什么操作、什么负载和什么运行环境下满足何种期待,以及哪些情境不在范围内。目标还要现实可行、与相关人员确认。省略条件会让相同数字被理解成不同承诺,单有一个看似精确的阈值仍不够。

知识卡及原书摘录。

原书依据 · 1 处

第 51 章 约束

约束部分记录什么被限定、为什么、由谁规定及如何影响设计。限制可能随时间改变,保留来源和理由,有助于未来判断是否仍需遵守以及找谁重新协商。

约束要记录来源和影响

在软件指南中记录约束时,应说明限制是什么、为什么存在、由谁规定,以及它怎样影响架构。这样读者能区分技术事实、组织要求和历史选择;条件改变后,也知道应该找谁重新讨论。只列“必须用某技术”会掩盖决策背景,并让已经失效的限制继续支配设计。

知识卡及原书摘录。

原书依据 · 1 处

第 52 章 原则

原则部分总结团队采用的方向及短解释,使后续维护者理解设计应保持何种一致性。它与约束不同:原则说明选择,约束说明限制。这里延用原则卡的定义,并把它放进指南的使用场景。

进一步参见原则带来一致。

原书依据 · 1 处

第 53 章 软件架构

软件架构部分汇总容器、组件以及有必要的运行交互。重要用户故事可以解释组件怎样共同工作,但不需把每条路径都画完。C4 的不同层次在此成为查阅地图,而非新增一种文档专属架构。

进一步参见C4分层视图。

原书依据 · 1 处

第 54 章 外部接口

外部接口是系统边界上的重要风险来源。接口说明应记录双方、技术、格式和行为,按实际需要讨论同步异步、交付、排序、重复、可用性、所有者和版本等。只有一个地址,不能使另一方理解交互失败后该怎么办。

接口文档记录行为契约

外部接口的说明需要让双方知道谁向谁传递什么,以及交互怎样发生。除格式和协议外,还应按实际需要说明同步或异步、交付与排序、重复处理、可用性等行为,并明确所有者、版本和服务约定。复杂接口应提供足够细节;只写一个端点地址,无法让对接方判断失败或重试时会发生什么。

知识卡及原书摘录。

原书依据 · 1 处

第 55 章 代码

实现部分帮助理解复杂或重要机制,可使用适量高层类关系和代码位置。不必罗列每个方法;内容应解释那些单看代码较难理解的选择,同时控制随实现变化带来的维护负担。

实现指南聚焦重要机制

实现指南解释架构中重要或复杂的机制怎样落地,例如关键类之间的协作、约定与模式。它需要帮助维护者理解实现方向,不必穷尽每个类和方法。选择相对稳定的高层关系,并指出可继续查找的代码位置,才能在提供必要背景与随代码变动反复维护之间取得平衡。

知识卡及原书摘录。

原书依据 · 1 处

第 56 章 数据

数据可能比当前软件活得更久。指南因此要说明重要数据模型、归属、存储、规模及保留、归档和备份要求。架构层说明生命周期与责任,细字段定义可由其他资料承接。

数据文档跨越软件寿命

软件可能被替换,积累的数据却仍要迁移、保存或供其他系统使用。因此软件指南需要交代重要数据及模型、归属、存储方式、规模,以及归档、备份和保留要求。重点是让读者理解数据的生命周期与责任,不是把全部字段字典塞进架构文档。忽视这些说明,可能在应用更新后仍留下无法解释的数据。

知识卡及原书摘录。

原书依据 · 1 处

第 57 章 基础设施架构

基础设施部分描述承载软件的物理或虚拟资源与网络,以及容量、冗余、环境差异、所有权和支持关系。即使架构角色不负责采购硬件,也需理解这些条件对软件表现和失败方式的影响。

基础设施文档明确承载

基础设施视图说明软件由什么硬件、虚拟资源与网络承载,包括容量、故障与冗余安排。还需要指出资源归谁管理、出现问题找谁支持,以及开发、测试、生产环境有何差异。这些信息帮助评估运行条件是否满足质量要求;只有软件模块图,不能说明资源受限或节点故障时的表现。

知识卡及原书摘录。

原书依据 · 1 处

第 58 章 部署

部署部分将软件容器映射到基础设施,说明实例、副本、活动备用状态,以及必要的故障切换、复制与回滚。它补足容器图没有展示的物理运行安排,也与描述“怎样执行动作”的脚本互相配合。

部署映射说明运行状态

部署视图把软件容器映射到基础设施,说明每种运行单元落在哪里、有多少副本,以及是否为活动或备用。必要时补充资源分配、切换、数据复制和回滚安排。部署脚本记录动作,部署映射记录目标运行结构;两者互补,不能只凭“脚本能启动”判断生产拓扑与故障处理已经讲清。

知识卡及原书摘录。

原书依据 · 1 处

第 59 章 运营和支持

运营和支持部分留下启动、停止、观察、配置、诊断、手工作业和归档的入口,并说明谁负责支持。指南不必复制所有操作细节,但应帮助值守者找到状态信息和后续处置路径。

运维指南留下处置入口

运维指南面向需要运行和支持软件的人,应能找到启动、停止、监测、管理和诊断的入口。记录配置位置、是否需要重启、日志在哪里、定时或手工作业怎样处理,并明确支持角色。它不必代替所有操作手册,但应使接手者知道从哪里判断状态、从哪里继续处置,而不必依赖原开发者在场。

知识卡及原书摘录。

原书依据 · 1 处

第 60 章 决策日志

决策日志保存作出选择时的上下文、备选方案和理由。它不是只写结论,也不应事后把真实的不确定性改写成必然正确。与指南其他部分配合,未来维护者才能判断条件变化后是否需要重新决策。

决策日志留语境

决策日志记录重要技术和架构选择、备选方案、评估方式和被迫接受的约束。发散:未来团队面对同一问题时,需要知道当时为什么这样选,而不只是看到结果。

知识卡及原书摘录。

原书依据 · 1 处

第 61 章 问题

本章请读者检查现有文档是否真正能帮助理解、运行与维护,以及哪些内容值得长期保留。它是指南章节的自评收束,没有另创文档评分公式,保留具体提问用途而不生卡。

Part Ⅵ 开发生命周期中的软件架构

第六部分把前面定义、职责、驱动因素和交流方法带回交付节奏:预先设计多少,取决于不确定性和风险,而不是是否使用敏捷这一名称。导语不重复后面风险方法的解释。

第 62 章 敏捷和架构的冲突:神话还是现实

敏捷与架构的冲突常来自角色隔离或大量一次性预设计。局部的测试驱动、行为驱动等实践,不能独自回答系统级安全、部署和质量风险;架构提供需要共同关注的边界,并允许在实现反馈中调整。

架构划定范围

TDD、BDD、DDD 等实践不能替代架构;架构先处理驱动力、质量属性、约束和原则,为这些实践划定工作范围。发散:没有边界的局部设计很容易优化代码,却错过系统级风险。

知识卡及原书摘录。

原书依据 · 1 处

架构非大预设

敏捷和架构不冲突,冲突来自把架构等同于大型预先设计。发散:恰当预先思考只需提供结构、愿景和风险框架,尺度可参考“预设有两种过度”,后续仍可随反馈演化。

知识卡及原书摘录。

原书依据 · 1 处

第 63 章 量化风险

先把风险发生的可能性与负面影响分开评价,再用粗略等级组合帮助排序。书中的 1—3 分矩阵是一种团队讨论工具,并非经过校准的真实概率模型;分数相同也可能需要不同缓解措施。

风险要拆两维

将风险拆成发生可能性与负面影响两个维度,可以比较“容易发生的小问题”和“不常发生但严重的问题”。本书用两项各 1—3 的等级相乘,得到排序用的粗略分数。

可能性\影响 低1 中2 高3
低1 1 2 3
中2 2 4 6
高3 3 6 9

书中的颜色分组为 1、2 绿色,3、4 褐色,6、9 红色。等级是团队判断的辅助工具,不是经校准的真实概率;乘积也不是损失金额或数学期望。相同分数仍需讨论具体原因和可采取的措施。

知识卡及原书摘录。

原书依据 · 1 处

第 64 章 风险风暴

风险风暴先准备架构图,再让每人独立写下并评分风险,贴到相关位置,最后讨论差异和优先级。独立阶段减少只听到领导者意见的机会;零可能性或零影响的判断也值得比较。后续缓解与再次观察,才使便笺成为实际改进的入口。

风险风暴

风险风暴让团队在架构图上共同发现技术风险。先准备可理解的图,每人独立安静地写风险并按“风险要拆两维”评分,再把便笺贴到有关组件或交互位置,最后讨论分歧、排优先级并安排缓解措施。独立阶段约五至十分钟,用来避免只有设计者或领导者的意见被听见。

被某人评为零可能性或零影响的条目也应带进讨论,差异可能暴露隐含假设。后续可通过学习、原型或修改设计减少风险,再重复观察;贴完便笺不等于风险已经消除。

结构图:

flowchart TD
 A[准备架构图] --> B[独立识别与评分]
 B --> C[贴到有关位置]
 C --> D[讨论分歧并排序]
 D --> E[缓解与再次观察]
 E --> A

知识卡及原书摘录。

原书依据 · 1 处

技术风险归架构

技术风险不应只归项目经理记录,架构角色要主动打理那些会让系统失败的风险。发散:共享架构角色也意味着共享风险所有权,而不是把风险藏在进度表之外。

知识卡及原书摘录。

原书依据 · 1 处

第 65 章 恰如其分的预先设计

预先设计太少,会让重要问题在昂贵阶段才暴露;设计太多,又可能为尚不存在的问题投入成本。恰如其分需要识别改变代价高、复杂、新颖或存在重大风险的部分。限时小组架构练习与公开评审,可以帮助团队校准需要多少细节;练习时长不是项目通用配额。

预设有两种过度

预先设计太少会缺边界、愿景、风险和一致性,太多则会信息过载、分析瘫痪和僵化。发散:好的预设不是数量问题,而是是否覆盖改变成本高、复杂或新的元素。

知识卡及原书摘录。

原书依据 · 1 处

重要来自成本

架构上重要的东西,是改变成本高、风险高或会塑造基础的决策,如核心结构、技术选择、安全、性能和可用性。发散:能用一个下午重构的细节,可以留给演化;不能轻易反悔的东西要提前验证。

知识卡及原书摘录。

原书依据 · 1 处

最小架构实践

恰如其分的架构至少要提供结构、风险和愿景:用容器/组件理解结构,用风险风暴和实验降低风险,用图传达共同方向。发散:这套最小集合能支撑交付,而不必滑向厚重设计。

知识卡及原书摘录。

原书依据 · 1 处

用演练校准设计深度

设计练习让小组针对同一问题形成结构和风险判断,再通过讲解接受反馈。书中采用两三人一组、约九十分钟的架构演练,讨论图是否清楚、细节是否足够、控制方式和关键决定是否合适。时间与人数是练习设置,并非所有项目的标准。反复比较结果,才能形成适合本团队的“设计到什么程度”准则。

知识卡及原书摘录。

原书依据 · 1 处

第 66 章 初识软件架构

把架构带入日常工作,可以从教育、回顾、完成标准、显性分配角色和短练习逐步开始。先证明某个小改进的实际价值,再调整做法;“先行动”的表达不授权绕过组织既有权限或现实发布程序。

小步引入架构

团队没时间做架构时,可以先识别缺架构造成的问题和风险,再用小步改善证明价值。发散:修一处混乱配置、补一张高层图、记录一个关键决策,都比等待三个月重构许可更现实。

知识卡及原书摘录。

原书依据 · 1 处

角色要显性化

把软件架构角色显性分配给合适的人,能让大局、风险和一致性有明确所有者。发散:起初一个人承担,随着团队成熟再共享,通常比一开始假装所有人都自组织更稳。

知识卡及原书摘录。

原书依据 · 1 处

把架构纳入完成标准

如果团队只把功能能运行算作完成,架构约定就容易在日常交付中失去位置。可以将适用的架构要求纳入完成标准,让设计讨论、实现检查与反馈成为正常工作;再用教育、回顾和小范围改进帮助团队理解其价值。标准需要贴合实际问题,不应成为每次变更都必须完成全套文档的形式门槛。

知识卡及原书摘录。

原书依据 · 1 处

第 67 章 问题

本章询问团队如何决定前期设计的多少、如何识别风险、如何在迭代中持续调整。它检验前面的工具是否能进入真实工作,没有增加另一个固定流程,作为自评收束保留。

Part Ⅶ 金融风险系统

第七部分提供金融风险练习,让读者将功能、质量和约束共同变成方案。它说明练习任务,而不是对现实银行系统作现状调查;所有人数、交易量、技术和时间均属于案例设定。

第 68 章 金融风险系统

金融风险系统从交易和交易对手来源导入数据、计算风险并分发报告。案例分别给出交易规模、用户数量、截止时间、权限、审计、数据保留和错误处理要求。报告须在新加坡交易开始前完成,而可用性另有可容忍中断,不能混成一个指标。单个交易对手计算失败要求记录并继续,不等于可把不完整报告冒充完整结果;该例用于练习澄清需求,并不直接给出现实风控结论。

案例驱动架构

金融风险系统案例把功能需求、质量属性、约束和互操作放在一起,迫使团队从真实驱动力出发设计。发散:好的架构练习不是凭空画图,而是在性能、审计、安全、监测和时间窗口等约束下做取舍。

知识卡及原书摘录。

原书依据 · 1 处

完成时限不同服务可用

金融风险系统示例要求交易日结束后完成处理,并在新加坡上午九点前提供报告;同时允许服务因维护或故障出现一定时长的中断。报告完成时限衡量批处理是否赶上业务使用窗口,可用性衡量服务在约定时间内是否能用。两项应分别设计、监测,不能用日常在线时长证明报告已经按时生成。这里的时间和容忍度属于书中练习系统。

知识卡及原书摘录。

原书依据 · 1 处

Part Ⅷ 附录:“技术部落”的软件指南

附录用 2014 年技术部落网站展示一份完整软件指南:用户与数据来源、性能和预算约束、组件封装、逻辑容器、基础设施、构建部署与运行支持互相连接。Web 与更新器共享核心组件,但分别运行;外置配置避免把环境设置写进发布包;持续集成先编译、测试和打包,再复制到服务器。其单台服务器、旧技术版本和 Pingdom 监测方式只是历史例子,不能当作当前部署推荐。下列分组保留发布、各服务启动及备份入口,并明确自动启动与手动启动的区别。附录图40的左右封装标签与第41章图示相反,图43部分组件描述也有重复;说明组件职责时采用该章文字与第38章图24、25,不传播错标签。

示例发布按版本切换

2014 年 TechTribes 示例通过版本化发布包和链接切换选择运行版本,再重启服务。示例命令是 ~/bin/deploy.sh XYZ,其中 XYZ 是待部署的版本;重新选择旧版本也是回退路径。运行前需要核对目标版本、配置及部署脚本的实际行为。这里保存的是历史系统的操作入口,不能把该命令直接当作当前项目的部署指令。

知识卡及原书摘录。

原书依据 · 1 处

历史MySQL启动核验

2014 年 TechTribes 示例中的 MySQL 预期随服务器启动。先用 sudo netstat -tap | grep mysql 检查相关监听信息,需要启动时使用 sudo service mysql start。监听检查只提供运行线索,不证明数据正确或业务可用。命令依赖该历史 Ubuntu 环境;当前系统的服务名、权限和管理方式须另行确认。

知识卡及原书摘录。

原书依据 · 1 处

历史MongoDB启动核验

2014 年 TechTribes 示例中的 MongoDB 预期自动启动。可用 sudo netstat -tap | grep mongo 查找监听线索,并查看 /var/log/mongodb/mongodb.log;需要启动时,示例使用 sudo service mongodb start。先观察进程和日志,再决定动作,避免只看到服务命令成功就认定数据库可用。这组路径和命令只属于书中的历史环境。

知识卡及原书摘录。

原书依据 · 1 处

历史Web服务启动核验

2014 年 TechTribes 示例中的 Tomcat 预期自动启动。用 ps -Af | grep tomcat 查看进程线索,检查 /var/lib/tomcat7/logs/catalina.out 获取运行信息;手动启动入口为 ~techtribesje/bin/start-tomcat.sh。进程存在不代表应用能够正确服务,仍需检查日志和实际请求。本卡记录历史示例,不作为当前 Tomcat 安装说明。

知识卡及原书摘录。

原书依据 · 1 处

历史更新器启动与日志

2014 年 TechTribes 示例的更新器需要手动启动,与自动启动的数据库和 Web 服务不同。示例使用 ~techtribesje/bin/start-updater.sh XYZ 选择版本并启动,用 ~techtribesje/bin/updater-logs.sh XYZ 查看对应日志。操作时需要明确版本和运行状态,避免漏启或重复启动。路径和生命周期假设属于该历史系统,不可直接套用到当前部署。

知识卡及原书摘录。

原书依据 · 1 处

历史数据库备份检查

2014 年 TechTribes 示例用定时任务在 GMT 凌晨三点导出 MySQL 与 MongoDB 数据,并放入同步目录。用 crontab -l 检查调度;书中行是 0 3 * * * /home/techtribesje/bin/backup-data.sh > /dev/null。它仅重定向标准输出,不能据此声称错误输出也被丢弃。还需核对实际导出物;存在调度不证明备份成功,更不证明可恢复。这里保留历史操作参考,未执行任何备份或恢复。

知识卡及原书摘录。

原书依据 · 1 处

配置独立于发布包

技术部落示例将组件配置放在发布制品之外的 Java properties 文件中,使同一构建版本可以从开发、测试移到生产而不改代码包。这样分开的是程序版本与环境设置;它并不自动保证配置正确或保密。理解部署时,应同时确认版本与对应配置,不能仅核对发布包。

知识卡及原书摘录。

原书依据 · 1 处

持续集成形成发布物

技术部落历史示例通过持续集成服务器统一编译、运行自动化测试并生成发布包,再将成功构建的包复制到部署服务器。这使发布物与一套可重复的构建流程相连,减少只在某台开发机能够工作的问题。构建成功不等于部署后业务一定正确,仍需观察实际运行;TeamCity 和 build.xml 是该例的实现选择。

知识卡及原书摘录。

原书依据 · 1 处

跨章综合

责任、证据与表达彼此补充。明确架构角色后,仍需通过编码与原型接触真实限制;有了技术证据,还需用图与指南让其他人理解;共同理解之后,才可能在交付中共享责任。共享不等于所有人同时作所有决定,具体控制程度随团队经验与风险调整。

功能、质量和约束决定哪些问题重要,C4 则帮助把问题定位到边界与交互。容器图说明逻辑组成,部署视图补充物理实例和切换,运维指南再提供观察与动作入口。这些视图回答不同问题,不能用一张图同时替代全部内容。

金融风险练习从需求出发,技术部落指南从已有系统出发,二者都要求追踪技术选择的周围代价。前者检验设计输入是否清楚,后者检验维护者是否能理解和运行系统;它们不能证明某套历史技术栈普遍最优。

flowchart TD
 D[理解目标 质量与约束] --> S[选择重要结构]
 S --> E[编码 原型与风险验证]
 E --> V[用图和指南交流]
 V --> R[交付中观察与调整]
 R --> D

读者延伸与实践

保留两项真实任务计划:为当前工作台绘制语境与容器两层图;针对本批读书导入流程整理风险位置、评分理由和缓解措施。前者以当前文件和入口为依据,不沿用旧版路径假设;后者将单人先记录后复看明确作为改编,不能宣称已复现多人独立讨论的效果。两项交付均是计划,尚未绘图、执行风险演练或开展恢复实验。

生成进度与管理记录

程序员必读之软件架构

类别:软件架构方法论类

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