此笔记位置已失效,请从目录继续阅读。
全书导读
软件架构把系统的重要结构、决定和共同方向联系起来。本书面向开发人员说明:怎样知道哪些决定值得先想,怎样与团队共同承担责任,以及怎样用图、指南和风险讨论把判断带回实现。案例技术属于出版时的环境,阅读重点是它们如何体现选择、约束和反馈。
全书主线
先界定架构的范围:既包括代码怎样组织,也包括应用如何集成与运行;再确认由谁理解并照看整体。角色与能力明确后,设计要从功能、质量要求、约束和原则出发,而不是从流行技术清单出发。
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 形能力把某些技术的深入经验与较广的方案视野结合起来。只熟悉一种工具,容易用同一种办法处理所有问题;但不可能独自精通全部领域,因此还需要结对设计和向专家学习。广度用于看见选择,深度用于评价与实现,协作补齐个人知识边界。
原书依据 · 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 章 处理非功能需求
收集质量需求后,需要继续澄清范围、量化目标、质疑不现实的承诺,并让成本帮助相关人员排序。例如声称永远不中断,没有说明代价与条件,就不能直接成为可实现的设计输入。目标应当能被检查,也要说明在哪些情况下检查。
原书依据 · 1 处
原书依据 · 1 处
第 24 章 约束
约束可能来自技术清单、部署平台、人员技能、资源和组织。先听清楚限制的原因,才能判断它如何塑造设计。约束还可能相互冲突:本章在得到客户接受的前提下,以交付期限的重要性协商技术清单例外,并不是允许团队自行绕过规定。
原书依据 · 1 处
原书依据 · 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 章 协同设计是一把双刃剑
不同技术专长的人容易从各自经验出发,默认为某些假设成立。共同设计使这些假设显现,并让方案接受其他角度的挑战。协作不保证自动达成一致,但可以把隐含选择变成可讨论的依据。
原书依据 · 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 处
原书依据 · 1 处
第 36 章 语境图
语境图把当前系统放回用户、外部系统和环境中,回答系统是什么、谁使用、怎样融入周围工作。它从边界与价值出发,通常避免不必要的底层技术细节,为后面的容器和组件图规定观察对象。
原书依据 · 1 处
第 37 章 容器图
容器图打开系统,说明主要运行单元和数据存储、各自职责、技术以及通信方向与方式。此处“容器”是 C4 的逻辑抽象。物理机器数量、多个副本和故障切换并不由这张图完整表达,需要部署视图补充。
容器图开盒子
容器图打开系统盒子,展示可独立部署或运行的主要容器、技术选择、职责和通信方式。发散:它承接“语境图定边界”,连接高层语境和细节组件,是开发、运维和支持都能读懂的技术大图。
原书依据 · 1 处
容器视图不同部署实例
C4 容器视图说明软件由哪些可运行单元或数据存储组成,以及它们的职责、技术和通信。这里的容器是架构抽象,不特指 Docker 容器,也不要求每个容器独占操作系统进程。它通常不表达负载均衡后的多个物理副本;副本位于哪些机器、怎样切换,需要另用部署视图说明。
原书依据 · 1 处
第 38 章 组件图
组件图聚焦某一个容器内部,把协作完成工作的代码组织为职责明确的组件,并说明接口和关系。共享核心并非凭空独立运行的服务:若它作为库随多个容器部署,就应在各自实际位置表示。技术部落示例将 Web 与更新器使用的核心能力联系起来。
原书依据 · 1 处
第 39 章 是否包含技术选择
标注技术有助于判断结构能否实现:数据库、协议、运行平台会带来不同限制。图如果只留下抽象盒子,读者可能无法评价关键技术风险。技术细节的多少应服从图的受众与层次,而不是完全不写或全部堆入。
原书依据 · 1 处
第 40 章 你会那样编码吗
架构图必须能映射到实际代码与部署。共享库若分别装在两个容器中,应画出实际存在的位置;分层图也应对应真实调用关系。否则图看起来整齐,却会让维护者误判边界和运行行为。
原书依据 · 1 处
第 41 章 软件架构和编码
代码按层组织时,一项业务能力可能分散在服务层和数据访问层;按特性组织靠近业务,但仍需管理内部边界。组件封装把公开接口与内部实现收拢,使图里的组件能在代码中找到。tweet 示例包含真实接口、实现和 DAO;附录的一张左右标签与本章图示相反,理解类型关系采用本章图28、29,不沿用那个错标签。
架构代码映射
架构图谈组件,代码却按层散落,会形成“模范代码的差距”,也解释了“图要照进代码”的重要性。发散:当代码结构无法支持架构理解时,代码不是唯一真相,而是另一种需要修正的表达。
原书依据 · 1 处
原书依据 · 1 处
组件封装收拢实现
组件封装把实现一个业务能力的接口和内部实现放在同一组件边界内,外部通过公开接口使用它。书中的 tweet 组件公开 TweetComponent,TweetComponentImpl 实现它,并使用 MongoDbTweetDao 访问存储。这样外部代码不必逐层接触实现细节。图保留原书的三个真实类型与关系;原文未列方法签名,因此不补造方法。
结构图:
classDiagram
class TweetComponent {
<<interface>>
}
class TweetComponentImpl
class MongoDbTweetDao
TweetComponent <|.. TweetComponentImpl : 实现
TweetComponentImpl --> MongoDbTweetDao : 使用
原书依据 · 1 处
第 42 章 你不需要UML工具
绘图、反向工程、往返工程和模型驱动工具承担不同工作。C4 主要表达静态结构,运行交互可补序列或协作图,流程可用活动图,领域关系和模式可用类图,状态及部署也有相应表达。工具选择应跟着沟通问题走,不必全用,也不能以“不需要工具”否定这些图的用途。
原书依据 · 1 处
区分四类建模工具
建模工具可以只用来画图,也可以从代码反向提取结构;往返工程进一步尝试保持模型和代码对应;模型驱动方式则以模型生成实现。它们对模型的权威性、维护方式和投入要求不同。选择前先决定要辅助沟通、观察现状,还是让模型参与生成,不能仅因工具会画 UML 图就认为其用途相同。
原书依据 · 1 处
静态结构需补运行行为
C4 的分层结构图说明系统由什么组成,却不能单独讲清一次请求如何执行。重要流程可以补充时序图或活动图,状态变化可以补充状态图;这些图回答交互次序、分支或状态转移等不同问题。先找读者尚不理解的行为,再选择表达方式,不必给每个组件机械配齐所有图。
原书依据 · 1 处
第 43 章 有效的草图
有效草图需要标题、标签、可理解的形状与线条、职责、边界和必要图例。颜色与箭头若承担含义,就要说明。九点评审清单进一步检查多个抽象层次、大局、容器组件、可追踪性、业务领域及实现策略,目的在于验证读者能否理解方案。
原书依据 · 1 处
原书依据 · 1 处
第 44 章 C4的常见问题
常见问题包括层次能否混画、共享组件怎样表示、工具组件怎样减轻重复连线,以及多个系统怎样汇成企业语境。共享库仍按实际部署出现;所有组件都使用的工具能力可以用说明压缩重复。更高层企业系统地图在本书被称作 C5,是该书的扩展称呼。
原书依据 · 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
读者延伸与实践
保留两项真实任务计划:为当前工作台绘制语境与容器两层图;针对本批读书导入流程整理风险位置、评分理由和缓解措施。前者以当前文件和入口为依据,不沿用旧版路径假设;后者将单人先记录后复看明确作为改编,不能宣称已复现多人独立讨论的效果。两项交付均是计划,尚未绘图、执行风险演练或开展恢复实验。