来源书籍

架构实战软件架构设计的过程

Skill 版本:v23 软件架构方法论类 经典原理(高信息浓度 + 高稳定性) 127 张卡片

彼得·伊乐斯(Peter Eeles)、彼得·克里普斯(Peter Cripps) · 蔡黄辉 译 · 机械工业出版社 · 2010 · ISBN 9787111301158

类别清单覆盖

尚未完成类别清单核对。

全书导读

作者彼得·伊乐斯(Peter Eeles)和彼得·克里普斯(Peter Cripps)都是 IBM 的 IT 架构师,英文原名 *The Process of Software Architecting*,中文版由蔡黄辉翻译(译者序称第 6~10 章由马文涛翻译),机械工业出版社 2010 年出版。Grady Booch 作序。书的目标是讲清“成功的架构师按什么流程创建架构”:架构师在需求、逻辑架构、物理架构各阶段做哪些任务、产出哪些工作产品、与哪些角色协作。

全书三部分:第 1~5 章是核心概念——架构、架构师、架构设计、方法基本原理(角色、工作产品、任务、流程)、编写软件架构文档(视点、视图、模型)、可重用架构资源;第 6~9 章用 YourTour 旅游预定系统贯穿一个项目,依次讲定义需求、创建逻辑架构、创建物理架构;第 10 章补充架构师与测试、配置管理、项目管理等规范的关系,以及复杂系统的架构设计。附录给出元模型、视点目录(含检查列表)、方法概述和 FURPS+ 需求检查列表。

阅读时注意两点。第一,书中方法基于 IEEE 1471、SPEM、OpenUP、RUP 等标准,示例技术是 2010 年前后的 Java EE(EJB、Session Façade)和 UML 工具,具体技术已经过时,但任务划分、逻辑与物理分离、可追溯性、检验与确认、架构决策记录等原则仍可迁移。第二,这是一本“流程书”,每个任务都按目的、角色、输入、输出、步骤组织,书中强调要按项目规模剪裁,而不是全部照搬。本书原有 31 张旧卡(v8)保留不改,本次补充 96 张新卡。

全书主线

全书主线是:架构是一组用改变成本衡量重要性的战略设计决策,需要通过一个可迭代、可剪裁、以结果驱动的流程来产生。贯穿全书的几个判断:

  1. 需求与架构双向影响:非功能需求(质量和约束)最具挑战,要从收集要求时就让架构师参与;架构选择也会反过来约束和精炼需求;
  2. 先逻辑后物理,但不要混画:逻辑架构是技术无关的跳板,物理架构再映射到技术、产品、资源和定制元素,两者之间可能一对一、一对多或多对一;
  3. 用视点组织描述:视点是视图的模板,基础视点与交叉视点结合,文档少而充分、只引用事实;
  4. 可追溯、可检验、可确认:方案元素追溯到需求,检验工作产品一致,确认系统满足需求,用概念证明降低风险,复审前先定基线;
  5. 重用优先:参考架构、风格、模式、框架、封装应用、遗留系统都是资源,但封装应用会让技术驱动架构;
  6. 架构师是技术领导:像导演一样确保事情正确完成,要决策、沟通、谈判、懂领域、会编码,并且留到项目结束。

前置内容

推荐语、译者序、Booch 的序、前言、致谢和作者简介。前言说明本书总结成功架构师的流程、不指定特定开发方法,并介绍三部分结构和概念、检查清单、最佳实践、缺陷四类补充内容。无独立卡片。

第1章 导言

第 1 章先区分架构是战略性设计,再概述整个流程:架构师在定义需求时要按架构稳定性排定需求,随后创建逻辑架构、物理架构。

原书依据 · 2 处
原书依据 · 19 处
原书依据 · 7 处
原书依据 · 11 处
原书依据 · 11 处

第6章 案例介绍

方法元素都要剪裁;多数项目是棕色地带,要棕色地带先调查现有IT;YourTour 案例的愿景说明案例需求要可量化。

原书依据 · 3 处
原书依据 · 17 处
原书依据 · 26 处
原书依据 · 14 处
原书依据 · 15 处

附录A 软件架构元模型

汇总全书使用的元模型关系和术语定义,已在第 2、4 章卡片中展开。

附录B 视点目录

视点自带复审检查列表。

原书依据 · 1 处

附录C 方法概述

角色、工作产品、活动、任务和四个阶段的汇总,已在第 3、6~9 章卡片中覆盖。

附录D 架构需求检查列表

FURPS加上约束。

原书依据 · 1 处

术语表

术语简短定义,均已在对应章节卡片中展开。

生成进度与管理记录

架构实战:软件架构设计的过程

  • 本次实际使用规则:book-notes v23 / book-workflow v4(2026-10-24 轻量模式升级:全文重读、补建覆盖记录与整书笔记、新增 96 张知识卡);历史 v8 生成、复核与主题维护记录保留在下方历史记录与 _workflow.md。概览原无 Skill 版本字段,按规则不回填。

作者:彼得·伊乐斯(Peter Eeles)、彼得·克里普斯(Peter Cripps)著;蔡黄辉译(译者序称第 6~10 章由马文涛翻译);机械工业出版社,2010 年(版权页),ISBN 978-7-111-30115-8

执行模式:light

建档进度:done

整书笔记:_book_note.md(schema 1;SHA-256 25f9ee75f81909e7cb3d9045303001ffe8515c959196011e257546a8d2770d22)

整体评级

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

评级理由:

信息浓度高:全书把架构设计拆成定义需求、创建逻辑架构、创建物理架构三组活动,每个任务都给出目的、角色、输入输出、步骤和架构师角色,并穿插大量检查列表、最佳实践和缺陷——例如要求不是需求、购物车式需求收集、所有需求同为高优先级、过快宣告阶段完成、架构师兼任项目经理、配置管理忽略架构导致构建缺少改动;还给出逻辑到物理组件一对一、一对多、多对一的映射判据,质量属性场景六要素,Fagan 检查流程,ATAM 步骤,业务规则放置的六个问题,复审前先定基线以免反复复审的理由。

稳定性高:核心内容是架构师角色、视点与视图、逻辑与物理分离、可追溯性、检验与确认、架构决策记录、可重用资源分类和系统之系统,基于 IEEE 1471、SPEM、OpenUP 等标准,至今可迁移;时代痕迹集中在第 9 章的 Java EE(EJB、Session Façade)示例和 UML 工具,属于可替换的举例。整体定为经典原理。

类别:软件架构方法论类

版本说明:EPUB 只有 3 个超大正文 spine(text00000 含前置内容至 6.2 节,text00001 为 6.3 至 9.2 节,text00002 为 9.3 节至术语表并附目录),无单独的封面或版权 spine;章节归属按卡片编号映射,出处仍逐字对应所在 spine。书中图表大多以图片给出(组件图、时序图、表 6.3、7.x、8.x、9.x 等),笔记只采用正文有文字说明的内容。原有 31 张 v8 旧卡未修改,旧卡的“源文件:_chapter-text/chNN.txt”为历史抽取路径,整书笔记出处已按当前 EPUB 逐字重新定位。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
00 前置内容(对本书的赞誉、译者序、序、前言、致谢、作者简介) done 0
01 第1章 导言 done 2
02 第2章 架构、架构师和架构设计 done 19
03 第3章 方法基本原理 done 7
04 第4章 编写软件架构文档 done 11
05 第5章 可重用架构资源 done 11
06 第6章 案例介绍 done 3
07 第7章 定义需求 done 17
08 第8章 创建逻辑架构 done 26
09 第9章 创建物理架构 done 14
10 第10章 进阶 done 15
11 附录A 软件架构元模型 done 0
12 附录B 视点目录 done 1
13 附录C 方法概述 done 0
14 附录D 架构需求检查列表 done 1
15 术语表 done 0

非正文排除

spine项 类型 排除理由
0 / OEBPS/text00000.html 开头 版权信息与目录 书名、作者、译者、ISBN 与出版说明(元数据已提取)及章节目录,位于正文 spine 内,未单独成项
2 / OEBPS/text00002.html 末尾 重复目录(Table of Contents) 电子版附加的目录列表,无知识正文

待关联术语

术语名 出现章节 一句话语境
SAAM 08 作为 ATAM 的前身一笔带过,未展开
RACI 03 作为主要角色与次要角色分类的完整版本提及,本书只用简化版
软件生产线 10 战略性重用的场景之一,推荐 Bosch、Clements 的书,未展开
TOGAF 08、10 企业架构框架,用于规范属性和企业架构定义的引用,未展开

引用文献

标题 类型 出现章节 一句话语境
IEEE 1471-2000 标准 02、04 本书架构、视点、视图等定义的来源
Software Systems Architecture(Rozanski、Woods) 书 04、05、09 视角(交叉视点)与观点过载概念的来源
Software Architecture in Practice, 2nd ed.(Bass 等) 书 02、07、08 质量属性场景与架构策略的出处
Architecture Decisions: Demystifying Architecture(Tyree 2005) 论文 08 架构决策文档模板的参考
Object-Oriented Software Construction(Meyer) 书 08 按契约设计的出处
UML Components(Cheesman、Daniels) 书 08 组件说明图与接口职责图的出处
Eating the IT Elephant(Hopkins) 书 06 棕色地带与绿色地带概念的出处
Software Architecture Review and Assessment(SARA)Report 报告 08 架构复审的权威资料

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
1 cardbox逻辑物理架构分离审查 实现深读 done 08、09 ideas/idea-001-cardbox逻辑物理架构分离审查.md
2 已知反模式沉淀进归档技能文档 决策实践 done 05 ideas/idea-002-已知反模式沉淀进归档技能文档.md

实践候选筛选:done

本次升级复用 2 张旧实践卡,未新增。未采用候选:为批次脚本补完整的架构决策记录(批次脚本是一次性工具,已有工作流记录承载关键决策,正式 ADR 收益小);按质量属性场景六要素重写工作台性能需求(工作台为单人本地工具,没有明确的性能承诺需要验证);为 cardbox 引入配置管理基线流程(数据库已有导入对账与备份,工作产品已在 git 中管理)。

资金安全问题案例

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

历史记录(保留,不作为本次验收依据)

章节进度追踪
章节号 章节标题 精读/略读 状态 卡片数
1 导言 略读:主要说明全书目标、流程范围和章节路线,作为背景即可 done 0
2 架构、架构师和架构设计 精读:定义架构、架构师职责、折中、证据和架构价值,是全书概念地基 done 4
3 方法基本原理 精读:区分方法内容与流程,并纠正敏捷与架构文档的常见误解 done 2
4 编写软件架构文档 精读:视点、视图、模型、文档和一致性是架构沟通的核心工具 done 3
5 可重用架构资源 精读:讨论架构来源、资源类型和重用策略,能迁移到平台化与企业架构 done 3
6 案例介绍 略读:主要提供 YourTour 案例背景,后续章节会复用但独立知识点较少 done 0
7 定义需求 精读:把需求与架构连接起来,尤其强调质量属性、约束和可测试性 done 4
8 创建逻辑架构 精读:全书信息密度最高,讲清从需求到逻辑方案、追溯、验证、确认的闭环 done 6
9 创建物理架构 精读:把逻辑架构映射到技术、产品、部署和采购决策,工程迁移价值高 done 4
10 进阶 精读:扩展到团队协作、标准、复杂系统、质量驱动和系统之系统 done 4
附录A 软件架构元模型 略读:术语索引和概念元模型,适合查阅 done 0
附录B 视点目录 略读:视点清单和检查项,可作为第4章参考 done 0
附录C 方法概述 略读:方法元素汇总,内容多为第3章和第7-9章索引 done 0
附录D 架构需求检查列表 略读:FURPS+ 检查表,适合作为项目模板而非卡片知识 done 0
汇总
  • 精读章节:8
  • 略读章节/附录:6
  • 已生成卡片:31(原30张 + 本轮补充1张 ch05-004)
实践卡进度
序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
1 cardbox逻辑物理架构分离审查 实现深读 done 08、09 ideas/idea-001-cardbox逻辑物理架构分离审查.md
2 已知反模式沉淀进归档技能文档 决策实践 done 05 ideas/idea-002-已知反模式沉淀进归档技能文档.md

其余章节知识点已评估:第2、3、10章内容偏架构师角色/组织协作方法论,已有卡片(架构影响组织、 架构师管协作)覆盖核心论点,未发现可独立对接真实对象的额外知识点,故不生成第三张实践卡。

类别清单核对(软件架构方法论类)
维度 覆盖状态 关联卡片标题或未覆盖理由
架构的定义与本质 已覆盖 [[架构只管重要性]]、[[架构是折中]]
质量属性与权衡 已覆盖 [[质量需求可测]]、[[质量驱动架构]]、[[架构是折中]]
架构描述方法 已覆盖 [[视点服务关注]]、[[视图必须一致]]
架构评估与评审方法 已覆盖 [[复审是质量关]]、[[物理复审签收]]
架构决策记录与可追溯性 已覆盖 [[决策需要证据]]、[[追溯连接方案]]
架构演化与技术债 未覆盖 第6章(案例介绍/略读)仅在”方法剪裁”语境下一句带过”随着时间的推移,架构也随之演化”,未展开为独立框架(无版本管理、废弃策略、技术债讨论),如实标注未覆盖
常见架构反模式与失败教训 补充生成 原有卡片未覆盖第5章”5.3.6模式”一节的反模式定义,定向核实后补生成 [[反模式是错位的模式]](ch05-004)

本书类别覆盖画像与《架构启示录》形成对照:6/7已覆盖且均以工程实践视角命中,印证”软件架构 方法论类”清单对本书这类工程实践书籍适配度高。

主题索引维护

本书讲解软件架构设计的过程(需求、逻辑架构、物理架构、复审与协作),卡片全部并入已有的架构设计流程、架构原则、视图建模、需求与非功能需求、组织协同等主题,未新建主题。

卡片标题 结论 主题文件或原因
架构只管重要性 已复用 notes/_topics/architecture-principles-complexity.md
架构是折中 已复用 notes/_topics/architecture-principles-complexity.md
决策需要证据 已复用 notes/_topics/architecture-design-process.md
架构影响组织 已复用 notes/_topics/org-architecture-alignment.md
方法分两层 已复用 notes/_topics/architecture-design-process.md
敏捷也要架构 已复用 notes/_topics/architecture-design-process.md
视点服务关注 已复用 notes/_topics/modeling-purpose-notation.md
文档引用事实 已复用 notes/_topics/modeling-purpose-notation.md
视图必须一致 已复用 notes/_topics/modeling-purpose-notation.md
架构来源三元 已复用 notes/_topics/architecture-styles.md
重用先分资源 已复用 notes/_topics/architecture-styles.md
重用也有成本 已复用 notes/_topics/architecture-styles.md
反模式是错位的模式 已复用 notes/_topics/architecture-styles.md
需求驱动架构 已复用 notes/_topics/use-cases-requirements.md
质量需求可测 已复用 notes/_topics/nfr-in-design.md
约束也是需求 已复用 notes/_topics/nfr-in-design.md
否定也能消歧 已复用 notes/_topics/use-cases-requirements.md
逻辑先于物理 已复用 notes/_topics/architecture-design-process.md
逻辑架构要小 已复用 notes/_topics/architecture-design-process.md
追溯连接方案 已复用 notes/_topics/architecture-design-process.md
验证确认不同 已复用 notes/_topics/architecture-design-process.md
概念证明减风险 已复用 notes/_topics/architecture-design-process.md
复审是质量关 已复用 notes/_topics/architecture-design-process.md
物理架构落地 已复用 notes/_topics/architecture-design-process.md
现实击穿理想 已复用 notes/_topics/architecture-design-process.md
买建都要决策 已复用 notes/_topics/architecture-design-process.md
物理复审签收 已复用 notes/_topics/architecture-design-process.md
架构师管协作 已复用 notes/_topics/org-architecture-alignment.md
模块化管复杂 已复用 notes/_topics/architecture-principles-complexity.md
标准维护完整性 已复用 notes/_topics/architecture-principles-complexity.md
质量驱动架构 已复用 notes/_topics/nfr-in-design.md

相关主题

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

主题索引

架构方案设计与评估

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

352 张卡片 · 40 本书

主题索引

容量规划与资源调度

比较冗余容量、故障域、逻辑与物理资源解耦等容量规划与调度方法。

344 张卡片 · 74 本书

主题索引

变更发布与回滚安全

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

312 张卡片 · 75 本书

主题索引

组织与架构协同演进

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

255 张卡片 · 57 本书

主题索引

建模的用途与表示法边界

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

248 张卡片 · 29 本书

主题索引

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

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

228 张卡片 · 40 本书

主题索引

模块化与信息隐藏

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

209 张卡片 · 51 本书

主题索引

架构风格与模式

比较架构风格作为预制约束集的价值与代价、风格与模式的区别,以及大泥球、镜像、回调等具体风格。

182 张卡片 · 22 本书

主题索引

用例与需求表述

比较以用户目标组织需求的用例写法、粒度分层与特性粒度的取舍。

181 张卡片 · 25 本书

主题索引

可扩展应用与插件架构

比较以数据模型、扩展点与插件为核心的应用架构,如何在开放扩展与稳定性、安全性之间取舍。

173 张卡片 · 41 本书

主题索引

架构决策方法

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

168 张卡片 · 45 本书

主题索引

软硬件划分与融合

比较功能放在软件还是硬件的判断依据:灵活性与效率、迭代节奏、规模与成本、ASIC/FPGA 配比、接口设计与集成形态,以及软件定义硬件与软硬件融合的差异。

160 张卡片 · 6 本书

主题索引

架构师成长路径

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

157 张卡片 · 36 本书

主题索引

DevOps落地与组织协作

DevOps 在组织中的适用边界与推进顺序:稳态与敏态系统的区分、工具与流程文化的关系、责任共担取代交接审批、分支模型与团队能力的匹配。

148 张卡片 · 32 本书

主题索引

组件聚合与耦合原则

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

127 张卡片 · 31 本书

主题索引

技术沟通与架构表达

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

124 张卡片 · 27 本书

主题索引

故障、部分失效与分布式时钟

比较故障与失效、部分失效、网络与超时的不确定性、时钟漂移与进程暂停,以及系统模型如何界定这些假设。

112 张卡片 · 41 本书

主题索引

迭代开发与过程裁剪

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

93 张卡片 · 26 本书

主题索引

软件质量属性的取舍

比较内部与外部质量、多准则权衡以及“先满足当前需求”在不同质量目标之间的取舍方法。

84 张卡片 · 24 本书

主题索引

架构认知与架构意图

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

81 张卡片 · 14 本书

主题索引

简单性与复杂度控制

比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。

72 张卡片 · 25 本书

主题索引

架构视图与视点

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

66 张卡片 · 16 本书

主题索引

用声明表达接口契约

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

62 张卡片 · 22 本书

主题索引

嵌入式硬件认知与抽象

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

57 张卡片 · 5 本书

主题索引

软件架构的定义与流派

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

49 张卡片 · 18 本书

主题索引

架构师与团队协作

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

44 张卡片 · 13 本书

主题索引

参考架构与产品线

比较参考架构与参考模型的抽象层次、参考架构的建立与评估,以及产品线架构中可变性管理、决策模型与产品衍生的方法。

42 张卡片 · 11 本书

主题索引

构件化设计与组装

比较基于构件的开发、构件模型(模板、构件、参数)与服务的对应关系,以及按业务可组装含义切分构件、用构件定位需求的做法。

42 张卡片 · 8 本书

主题索引

组件、连接器与端口

比较组件与模块的区别、连接器承担的工作、端口与绑定、不变量,以及架构不匹配的隐含假设。

36 张卡片 · 13 本书

主题索引

契约式设计

比较前置条件、后置条件、不变式在划分调用方与实现方责任上的作用,以及检查开销和与测试的分工。

22 张卡片 · 9 本书

主题索引

架构恢复与模式识别

比较从源代码等低层信息恢复实际架构、识别所用架构模式的技术路线及其精度与自动化局限。

16 张卡片 · 7 本书