主题索引
架构方案设计与评估
比较备选方案设计、评估选择、容量预估与详细设计等架构设计流程中的判断方法。
来源书籍
尚未完成类别清单核对。
_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 |
| 序号 | 实践标题 | 实践方式 | 状态(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 |
从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。
主题索引
比较备选方案设计、评估选择、容量预估与详细设计等架构设计流程中的判断方法。
主题索引
比较冗余容量、故障域、逻辑与物理资源解耦等容量规划与调度方法。
主题索引
比较变更速度、渐进发布、紧急发布与回滚边界的工程控制。
主题索引
比较团队边界、组织结构与技术架构如何对齐,以及组织惯性对架构变革的影响。
主题索引
比较建模语言作为草稿、蓝图或编程语言的不同用途,以及表示法规则、元模型与版本演化的边界。
主题索引
比较架构要解决的复杂度来源(性能、可用性、扩展、成本、安全、规模)以及合适、简单、演化等设计原则。
主题索引
比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。
主题索引
比较架构风格作为预制约束集的价值与代价、风格与模式的区别,以及大泥球、镜像、回调等具体风格。
主题索引
比较以用户目标组织需求的用例写法、粒度分层与特性粒度的取舍。
主题索引
比较以数据模型、扩展点与插件为核心的应用架构,如何在开放扩展与稳定性、安全性之间取舍。
主题索引
比较在不确定性下做架构决策的方法:以风险而非结果评价决策、期望值与决策树、认知偏差、根因追问与避免不必要的决策。
主题索引
比较架构师所需的判断力、执行力、创新力及其积累方式与成长阶段。
主题索引
DevOps 在组织中的适用边界与推进顺序:稳态与敏态系统的区分、工具与流程文化的关系、责任共担取代交接审批、分支模型与团队能力的匹配。
主题索引
比较把安全、可靠性等非功能需求前置到设计与评审阶段的方法与取舍。
主题索引
比较 REP、CCP、CRP 的组件聚合张力,以及无依赖环、稳定依赖、稳定抽象原则与 I/A 指标对组件耦合的度量。
主题索引
比较面向不同受众的技术写作、演示与架构图方法:循序渐进的讲解、文档与幻灯片的取舍,以及让图表达连接与语义。
主题索引
比较故障与失效、部分失效、网络与超时的不确定性、时钟漂移与进程暂停,以及系统模型如何界定这些假设。
主题索引
比较迭代与预测式开发、时间盒与过程裁剪在不同需求稳定性下的适用性。
主题索引
比较内部与外部质量、多准则权衡以及“先满足当前需求”在不同质量目标之间的取舍方法。
主题索引
比较认识系统的方式(感受、知得与识得、真相与事实)以及架构意图如何识别、取舍与避免臆断。
主题索引
比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。
主题索引
比较用多视图与视点组织架构描述:模块、组件与分配结构的划分依据,视图与质量问题的对应,跨视图映射、视图一致性与文档入口。
主题索引
比较如何借助语言声明(删除、重写标记、异常规格、常量性、作用域等)让编译器强制接口意图。
主题索引
从原理图、数据表、寄存器与引脚出发,怎样把一块板子抽象成软件可用的接口:板级头文件、硬件抽象层、门面与适配器、依赖注入,以及处理器选型、器件版本与文档阅读的判断依据。
主题索引
比较组成派与决策派等软件架构定义流派的关注点与局限,以及架构学科从软件危机和开发阶段演进中分化出来的动因。
主题索引
比较架构师通过提问、请求协助、会议选择和答疑时间与开发团队协作的做法及边界。
主题索引
比较参考架构与参考模型的抽象层次、参考架构的建立与评估,以及产品线架构中可变性管理、决策模型与产品衍生的方法。
主题索引
比较基于构件的开发、构件模型(模板、构件、参数)与服务的对应关系,以及按业务可组装含义切分构件、用构件定位需求的做法。
主题索引
比较组件与模块的区别、连接器承担的工作、端口与绑定、不变量,以及架构不匹配的隐含假设。
主题索引
比较前置条件、后置条件、不变式在划分调用方与实现方责任上的作用,以及检查开销和与测试的分工。
主题索引
比较从源代码等低层信息恢复实际架构、识别所用架构模式的技术路线及其精度与自动化局限。