来源书籍

Mastering API Architecture

Skill 版本:v24 系统架构类。 180 张卡片

James Gough, Daniel Bryant, Matthew Auburn · O’Reilly Media, Inc. · 2022-10-24 · First Edition · ISBN 9781492090632

类别清单覆盖

尚未完成类别清单核对。

章节与卡片

00 The Architecture Journey

2 张卡片
  1. 演进式架构重视变更能力 理解等级:高级 普通读书笔记卡
  2. API优先围绕消费者设计 理解等级:中级 普通读书笔记卡

00 A Brief Introduction to APIs

2 张卡片
  1. API用规范隐藏实现 理解等级:中级 普通读书笔记卡
  2. 进程边界区分API调用 理解等级:中级 普通读书笔记卡

00 API Infrastructure and Traffic Patterns

1 张卡片
  1. 南北与东西流量区分入口 理解等级:中级 普通读书笔记卡

00 Using C4 Diagrams

1 张卡片
  1. C4按层次表达架构 理解等级:中级 普通读书笔记卡

00 Using Architecture Decision Records

2 张卡片
  1. ADR保留决策依据 理解等级:中级 普通读书笔记卡
  2. ADR四段结构 理解等级:中级 普通读书笔记卡

00 Mastering API: ADR Guidelines

1 张卡片
  1. ADR指南先列判断条件 理解等级:中级 普通读书笔记卡

01 Case Study: Designing the Attendee API

1 张卡片
  1. 消费者关系决定接口耦合 理解等级:高级 普通读书笔记卡

01 Introduction to REST

1 张卡片
  1. REST统一接口隔离实现 理解等级:中级 普通读书笔记卡

01 The Richardson Maturity Model

2 张卡片
  1. Richardson四级模型 理解等级:中级 结构图卡
  2. 超媒体导航需权衡交互成本 理解等级:高级 普通读书笔记卡

01 Introduction to Remote Procedure Call (RPC) APIs

2 张卡片
  1. RPC将远端方法包装成本地调用 理解等级:中级 普通读书笔记卡
  2. RPC状态与耦合取舍 理解等级:高级 普通读书笔记卡

01 A Brief Mention of GraphQL

1 张卡片
  1. GraphQL按需跨源取字段 理解等级:中级 普通读书笔记卡

01 REST API Standards and Structure

2 张卡片
  1. 接口标准应尽早统一 理解等级:高级 普通读书笔记卡
  2. 敏感信息不要进入URL 理解等级:中级 普通读书笔记卡

01 Collections and Pagination

1 张卡片
  1. 集合响应预留分页结构 理解等级:高级 普通读书笔记卡

01 Error Handling

2 张卡片
  1. 错误状态码表达处理结果 理解等级:高级 普通读书笔记卡
  2. 外部错误不泄露内部堆栈 理解等级:中级 普通读书笔记卡

01 Specifying REST APIs Using OpenAPI

1 张卡片
  1. OpenAPI描述接口形状 理解等级:中级 普通读书笔记卡

01 Code Generation

1 张卡片
  1. 接口规范不覆盖行为语义 理解等级:高级 普通读书笔记卡

01 OpenAPI Validation

1 张卡片
  1. 规范校验可设在流量边界 理解等级:中级 普通读书笔记卡

01 Examples and Mocking

1 张卡片
  1. 示例与模拟服务帮助试接口 理解等级:中级 普通读书笔记卡

01 API Versioning

1 张卡片
  1. API版本平衡双方升级成本 理解等级:高级 普通读书笔记卡

01 Semantic Versioning

1 张卡片
  1. 语义版本标示兼容性 理解等级:中级 普通读书笔记卡

01 OpenAPI Specification and Versioning

1 张卡片
  1. 规范差异识别破坏变更 理解等级:中级 普通读书笔记卡

01 Implementing RPC with gRPC

1 张卡片
  1. Protobuf字段号不可重排 理解等级:高级 普通读书笔记卡

01 Modeling Exchanges and Choosing an API Format

1 张卡片
  1. 通信格式取舍要实测 理解等级:高级 普通读书笔记卡

01 Large Exchange Payloads

1 张卡片
  1. 载荷成本包含解析时间 理解等级:中级 普通读书笔记卡

01 HTTP/2 Performance Benefits

1 张卡片
  1. HTTP2多路复用共享连接 理解等级:中级 普通读书笔记卡

01 Challenges of Combined Specifications

1 张卡片
  1. 双协议转换耦合演进 理解等级:高级 普通读书笔记卡

02 Test Quadrant

1 张卡片
  1. 测试四象限区分目的 理解等级:中级 普通读书笔记卡

02 Test Pyramid

1 张卡片
  1. 测试金字塔平衡范围和成本 理解等级:高级 普通读书笔记卡

02 Contract Testing

1 张卡片
  1. 契约测试验证双方交互 理解等级:中级 普通读书笔记卡

02 Why Contract Testing Is Often Preferable

1 张卡片
  1. 契约不等于模式符合 理解等级:高级 普通读书笔记卡

02 How a Contract Is Implemented

3 张卡片
  1. 模拟服务支持并行开发 理解等级:中级 普通读书笔记卡
  2. 契约主导权依消费者关系 理解等级:高级 普通读书笔记卡
  3. 契约存放要支持双方取得 理解等级:中级 普通读书笔记卡

02 API Component Testing

1 张卡片
  1. 组件测试验证服务行为 理解等级:中级 普通读书笔记卡

02 API Integration Testing

1 张卡片
  1. 集成测试跨外部依赖边界 理解等级:中级 普通读书笔记卡

02 Using Stub Servers: Why and How

1 张卡片
  1. 录制桩要防漂移与泄露 理解等级:高级 普通读书笔记卡

02 Containerizing Test Components: Testcontainers

1 张卡片
  1. 容器测试真实依赖边界 理解等级:中级 普通读书笔记卡

02 Case Study: Applying Testcontainers to Verify Integrations

1 张卡片
  1. 真实依赖不替代契约 理解等级:高级 普通读书笔记卡

02 End-to-End Testing

1 张卡片
  1. 端到端测试验证完整请求链 理解等级:中级 普通读书笔记卡

02 Automating End-to-End Validation

2 张卡片
  1. 端到端边界取决于目标 理解等级:高级 普通读书笔记卡
  2. 端到端载荷应代表真实使用 理解等级:中级 普通读书笔记卡

02 ADR Guideline: End-to-End Testing

1 张卡片
  1. 端到端场景优先核心旅程 理解等级:中级 普通读书笔记卡

02 Types of End-to-End Tests

1 张卡片
  1. 性能链路需匹配生产条件 理解等级:高级 普通读书笔记卡

03 Guideline: Proxy, Load Balancer, or API Gateway

1 张卡片
  1. 入口方案按需求选最简 理解等级:高级 普通读书笔记卡

03 What Is an API Gateway?

1 张卡片
  1. 网关控制面与数据面分工 理解等级:中级 普通读书笔记卡

03 How Does an API Gateway Integrate with Other Technologies at the Edge?

1 张卡片
  1. 入口栈按功能分层部署 理解等级:中级 普通读书笔记卡

03 Reduce Coupling: Adapter/Facade Between Frontends and Backends

1 张卡片
  1. 网关契约隔离后端变化 理解等级:高级 普通读书笔记卡

03 Simplify Consumption: Aggregating/Translating Backend Services

1 张卡片
  1. 网关聚合需守住业务边界 理解等级:高级 普通读书笔记卡

03 Protect APIs from Overuse and Abuse: Threat Detection and Mitigation

1 张卡片
  1. 网关防护需可观测支撑 理解等级:中级 普通读书笔记卡

03 Understand How APIs Are Being Consumed: Observability

1 张卡片
  1. 入口遥测连接跨服务请求 理解等级:中级 普通读书笔记卡

03 Manage APIs as Products: API Lifecycle Management

1 张卡片
  1. 接口管理覆盖完整生命周期 理解等级:中级 普通读书笔记卡

03 Mid-2000s: Application Delivery Controllers (ADCs)

1 张卡片
  1. 入口技术随需求扩展 理解等级:中级 普通读书笔记卡

03 Early 2010s: First-Generation API Gateways

1 张卡片
  1. 应用层路由支持接口治理 理解等级:中级 普通读书笔记卡

03 Service Mesh Gateways

2 张卡片
  1. 网关类型按主要职责区分 理解等级:高级 普通读书笔记卡
  2. 网格入口依赖网格决策 理解等级:高级 普通读书笔记卡

03 Case Study: Evolving the Conference System Using an API Gateway

1 张卡片
  1. 单体代路由扩大故障面 理解等级:高级 普通读书笔记卡

03 Avoid Routing on Request Payloads

1 张卡片
  1. 避免按请求体内容路由 理解等级:高级 普通读书笔记卡

03 API Gateway as a Single Point of Failure

1 张卡片
  1. 网关集中能力放大故障影响 理解等级:高级 普通读书笔记卡

03 Challenge Assumptions with Security Single Points of Failure

1 张卡片
  1. 安全组件故障语义须明确 理解等级:高级 普通读书笔记卡

03 Mitigating Risks

1 张卡片
  1. 入口切换需验证业务连续性 理解等级:高级 普通读书笔记卡

03 API Gateway Loopback

1 张卡片
  1. 内部调用避免绕行入口网关 理解等级:高级 普通读书笔记卡

03 API Gateway as an ESB

1 张卡片
  1. 网关插件避免承载业务逻辑 理解等级:高级 普通读书笔记卡

03 Turtles (API Gateways) All the Way Down

1 张卡片
  1. 多层网关增加变更协调成本 理解等级:高级 普通读书笔记卡

03 ADR Guideline: Selecting an API Gateway

1 张卡片
  1. 网关选型计算全生命周期成本 理解等级:高级 普通读书笔记卡

04 Guideline: Should You Adopt Service Mesh?

1 张卡片
  1. 服务间治理按需求选型 理解等级:高级 普通读书笔记卡

04 What Is Service Mesh?

1 张卡片
  1. 网格控制面配置数据面执行 理解等级:中级 普通读书笔记卡

04 What Functionality Does a Service Mesh Provide?

1 张卡片
  1. 全代理换来治理与链路开销 理解等级:高级 普通读书笔记卡

04 Fine-grained Control of Routing, Reliability, and Traffic Management

1 张卡片
  1. 网格统一动态服务发现 理解等级:中级 普通读书笔记卡

04 Provide Transparent Observability

1 张卡片
  1. 网格观测仍需业务埋点 理解等级:高级 普通读书笔记卡

04 Enforce Security: Transport Security, Authentication, and Authorization

1 张卡片
  1. 网格统一服务身份与加密 理解等级:中级 普通读书笔记卡

04 Supporting Cross-Functional Communication Across Languages

1 张卡片
  1. 多语言服务复用代理治理 理解等级:中级 普通读书笔记卡

04 Separating Ingress and Service-to-Service Traffic Management

1 张卡片
  1. 入口与内部流量策略分治 理解等级:高级 普通读书笔记卡

04 Fine-grained Control of Routing, Reliability, and Traffic Management

1 张卡片
  1. 网格统一通信韧性策略 理解等级:高级 普通读书笔记卡

04 Early History and Motivations

1 张卡片
  1. 分布式调用须承认网络限制 理解等级:中级 普通读书笔记卡

04 The Cost of Running Sidecars at Scale

1 张卡片
  1. 边车数量放大资源成本 理解等级:高级 普通读书笔记卡

04 Service Mesh Taxonomy

1 张卡片
  1. 网格数据面有多种实现位置 理解等级:高级 普通读书笔记卡

04 Routing with Istio

1 张卡片
  1. 网格路由与目标策略分离 理解等级:中级 普通读书笔记卡

04 Network Segmentation with Consul

1 张卡片
  1. 服务身份支撑默认拒绝 理解等级:高级 普通读书笔记卡

04 Summary

1 张卡片
  1. 网格控制面也需高可用 理解等级:高级 普通读书笔记卡

04 Service Mesh as ESB

1 张卡片
  1. 网格过滤器不应承载业务 理解等级:高级 普通读书笔记卡

04 Too Many Networking Layers

1 张卡片
  1. 网格叠加前核对网络层 理解等级:高级 普通读书笔记卡

04 Checklist: Selecting a Service Mesh

1 张卡片
  1. 网格选型计入现有治理成本 理解等级:高级 普通读书笔记卡

05 Separating Deployment and Release

1 张卡片
  1. 部署与发布是两个动作 理解等级:中级 普通读书笔记卡

05 Case Study: Feature Flagging

1 张卡片
  1. 功能开关需降级与清理 理解等级:高级 普通读书笔记卡

05 API Lifecycle

1 张卡片
  1. 接口生命周期约束消费者预期 理解等级:中级 普通读书笔记卡

05 Mapping Release Strategies to Lifecycle

1 张卡片
  1. 重大版本需并行供消费者迁移 理解等级:高级 普通读书笔记卡

05 Separating Deploy and Release: Canary All-the-Things

1 张卡片
  1. 金丝雀发布按指标渐进放量 理解等级:中级 普通读书笔记卡

05 Traffic Mirroring

1 张卡片
  1. 流量镜像只验证影子结果 理解等级:高级 普通读书笔记卡

05 Blue-Green

1 张卡片
  1. 蓝绿切换需要双环境成本 理解等级:高级 普通读书笔记卡

05 Reading the Signals

1 张卡片
  1. 接口指标必须结合错误语境 理解等级:高级 普通读书笔记卡

05 Response Caching

1 张卡片
  1. 缓存可能掩盖发布故障 理解等级:高级 普通读书笔记卡

05 Application-Level Header Propagation

1 张卡片
  1. 跨服务传播追踪与身份需分开 理解等级:高级 普通读书笔记卡

05 Logging to Assist Debugging

1 张卡片
  1. 日志区分事件与诊断 理解等级:中级 普通读书笔记卡

05 ADR Guideline: Opinionated Platforms

1 张卡片
  1. 内部平台要服务开发者 理解等级:高级 普通读书笔记卡

05 Three Pillars of Observability

1 张卡片
  1. 指标日志追踪相互补足 理解等级:中级 普通读书笔记卡

06 Threat Modeling 101

2 张卡片
  1. 威胁建模随系统演进迭代 理解等级:中级 普通读书笔记卡
  2. 数据流图显露信任边界 理解等级:中级 普通读书笔记卡

06 How to Threat Model

1 张卡片
  1. 威胁分析从目标走到验证 理解等级:中级 普通读书笔记卡

06 Step 4: Identify Threats—Taking This in Your STRIDE

5 张卡片
  1. 逐元素检查六类威胁 理解等级:中级 普通读书笔记卡
  2. 入口校验不能替代服务校验 理解等级:高级 普通读书笔记卡
  3. 防止请求字段越权绑定 理解等级:高级 普通读书笔记卡
  4. 敏感字段和旧端点都要盘点 理解等级:高级 普通读书笔记卡
  5. 限流与过载拒绝依据不同 理解等级:高级 普通读书笔记卡

06 Step 5: Evaluate Threat Risks

1 张卡片
  1. 风险评分需要统一口径 理解等级:高级 普通读书笔记卡

06 Step 4: Identify Threats—Taking This in Your STRIDE

1 张卡片
  1. 安全审计要能重建行为 理解等级:中级 普通读书笔记卡

06 Step 6: Validation

1 张卡片
  1. 威胁缓解后还要重新验证 理解等级:中级 普通读书笔记卡

06 Security directive hardening

1 张卡片
  1. 入口剥离外来身份头 理解等级:中级 普通读书笔记卡

07 Authentication

1 张卡片
  1. 认证身份与授权权限分开 理解等级:初级 普通读书笔记卡

07 Why You Shouldn’t Mix Keys and Users

1 张卡片
  1. 接口密钥只识别应用 理解等级:高级 普通读书笔记卡

07 Terminology and Mechanisms of OAuth2 Grants

1 张卡片
  1. 委托授权不交出用户密码 理解等级:中级 普通读书笔记卡

07 JSON Web Tokens (JWT)

2 张卡片
  1. 签名令牌内容仍可被读取 理解等级:中级 普通读书笔记卡
  2. 验签之外还需核对令牌声明 理解等级:高级 普通读书笔记卡

07 Terminology and Mechanisms of OAuth2 Grants

1 张卡片
  1. 资源服务校验访问令牌 理解等级:中级 普通读书笔记卡

07 Authorization Code Grant

1 张卡片
  1. 公开客户端用授权码加PKCE 理解等级:高级 普通读书笔记卡

07 Refresh Tokens

1 张卡片
  1. 刷新令牌延续授权但需保护 理解等级:高级 普通读书笔记卡

07 Client Credentials Grant

1 张卡片
  1. 客户端凭证代表应用自身 理解等级:中级 普通读书笔记卡

07 Authorization Enforcement

2 张卡片
  1. 权限范围只定义粗粒度边界 理解等级:高级 普通读书笔记卡
  2. 授权还需核对对象与功能 理解等级:高级 普通读书笔记卡

07 Introducing OIDC

1 张卡片
  1. 身份令牌不可代替访问令牌 理解等级:高级 普通读书笔记卡

08 Why Use APIs to Evolve a System?

1 张卡片
  1. 用API围出变更边界 理解等级:中级 普通读书笔记卡

08 Creating Useful Abstractions: Increasing Cohesion

1 张卡片
  1. 高内聚API隔离内部变化 理解等级:中级 普通读书笔记卡

08 Aim for APIs with High Cohesion

1 张卡片
  1. 通用工具接口会稀释内聚 理解等级:高级 普通读书笔记卡

08 Clarifying Domain Boundaries: Promoting Loose Coupling

1 张卡片
  1. 松耦合降低替换成本 理解等级:中级 普通读书笔记卡

08 Loose Coupling Enables Easier Mocking and Virtualizing When Testing!

1 张卡片
  1. 松耦合接口易于替身测试 理解等级:中级 普通读书笔记卡

08 Case Study: Establishing Attendee Domain Boundaries

1 张卡片
  1. 业务接口隐藏存储决定 理解等级:中级 普通读书笔记卡

08 Monolith

1 张卡片
  1. 单体适合早期快速探索 理解等级:高级 普通读书笔记卡

08 Service-Oriented Architecture (SOA)

1 张卡片
  1. 服务拆分要平衡归属与成本 理解等级:高级 普通读书笔记卡

08 Microservices

1 张卡片
  1. 微服务边界先于技术选型 理解等级:高级 普通读书笔记卡

08 Functions

1 张卡片
  1. 过细函数会提高编排耦合 理解等级:高级 普通读书笔记卡

08 Determine Your Goals

1 张卡片
  1. 演进目标分功能与质量 理解等级:中级 普通读书笔记卡

08 Using Fitness Functions

1 张卡片
  1. 适应度函数持续检验架构 理解等级:中级 普通读书笔记卡

08 Decomposing a System into Modules

2 张卡片
  1. 模块边界先于服务拆分 理解等级:高级 普通读书笔记卡
  2. 单向模块依赖利于独立演进 理解等级:中级 普通读书笔记卡

08 Creating APIs as “Seams” for Extension

1 张卡片
  1. 接缝是可替换的交互点 理解等级:中级 普通读书笔记卡

08 Identifying Change Leverage Points within a System

1 张卡片
  1. 用变更频率寻找改造杠杆 理解等级:中级 普通读书笔记卡

08 Strangler Fig

2 张卡片
  1. 绞杀模式逐步替换旧实现 理解等级:中级 普通读书笔记卡
  2. 迁移代理须控制故障与耦合 理解等级:高级 普通读书笔记卡

08 Facade and Adapter

1 张卡片
  1. 门面与适配器职责不同 理解等级:中级 普通读书笔记卡

08 API Layer Cake

1 张卡片
  1. 分层API可能放大跨层改动 理解等级:高级 普通读书笔记卡

08 Upgrade and Maintenance Issues

1 张卡片
  1. 维护痛点可提示API切入点 理解等级:中级 普通读书笔记卡

08 Performance Issues

1 张卡片
  1. 性能改造先量测再假设 理解等级:中级 普通读书笔记卡

08 Breaking Dependencies: Highly Coupled APIs

2 张卡片
  1. 同步发布暴露接口耦合 理解等级:中级 普通读书笔记卡
  2. 用萌芽与包裹改动遗留代码 理解等级:中级 普通读书笔记卡

09 Chapter 9. Using API Infrastructure to Evolve Toward Cloud Platforms

1 张卡片
  1. 网关可遮蔽服务迁移位置 理解等级:中级 普通读书笔记卡

09 Choosing a Cloud Migration Strategy

1 张卡片
  1. 云迁移选项覆盖六种处置 理解等级:初级 普通读书笔记卡

09 Retain or Revisit

1 张卡片
  1. 暂留系统也要记录理由 理解等级:中级 普通读书笔记卡

09 Communicating Change and Deprecations

2 张卡片
  1. 弃用通知要给消费者时限 理解等级:中级 普通读书笔记卡
  2. 跨云延迟可推翻迁移方案 理解等级:高级 普通读书笔记卡

09 Rehost

1 张卡片
  1. 原样迁移保留架构假设 理解等级:中级 普通读书笔记卡

09 Be Cautious with Specialist Systems and Bespoke Hardware

1 张卡片
  1. 专用硬件会阻碍原样迁移 理解等级:高级 普通读书笔记卡

09 Replatform

1 张卡片
  1. 平台迁移只改必要基础设施 理解等级:中级 普通读书笔记卡

09 Repurchase

1 张卡片
  1. 换购以现成服务替代自建 理解等级:初级 普通读书笔记卡

09 Refactor/Re-architect

1 张卡片
  1. 重构迁移改变内部实现 理解等级:高级 普通读书笔记卡

09 Retire

1 张卡片
  1. 退役先证实能力无人依赖 理解等级:中级 普通读书笔记卡

09 Case Study: Replatforming the Attendee Service to the Cloud

1 张卡片
  1. 案例先完成服务拆分再迁云 理解等级:高级 普通读书笔记卡

09 Role of API Management

1 张卡片
  1. API管理层提供发现与稳定入口 理解等级:中级 普通读书笔记卡

09 Start at the Edge and Work Inward

1 张卡片
  1. 先迁边缘再向内推进 理解等级:中级 普通读书笔记卡

09 Crossing Boundaries: Routing Across Networks

1 张卡片
  1. 跨网络路由随规模选机制 理解等级:高级 普通读书笔记卡

09 Getting in the Zone

1 张卡片
  1. 网络分区降低攻击波及面 理解等级:中级 普通读书笔记卡

09 Trust No One and Verify

1 张卡片
  1. 零信任逐次验证身份与状态 理解等级:中级 普通读书笔记卡

09 Role of Service Mesh in Zero Trust Architectures

3 张卡片
  1. 服务网格安全依赖平台底座 理解等级:高级 普通读书笔记卡
  2. 默认拒绝后逐项开放流量 理解等级:中级 普通读书笔记卡
  3. 多集群网格统一迁移期策略 理解等级:高级 普通读书笔记卡

10 Case Study: A Look Back on Your Journey

1 张卡片
  1. 演进灵活性伴随基础设施复杂度 理解等级:高级 普通读书笔记卡

10 APIs, Conway’s Law, and Your Organization

1 张卡片
  1. 组织沟通结构塑造API边界 理解等级:高级 普通读书笔记卡

10 Understanding Decision Types

1 张卡片
  1. 区分可逆与难逆架构决策 理解等级:高级 普通读书笔记卡

10 Async Communication

1 张卡片
  1. 异步接口也需要契约描述 理解等级:中级 普通读书笔记卡

10 HTTP/3

1 张卡片
  1. HTTP语义与传输映射分离 理解等级:中级 普通读书笔记卡

10 Continually Honing the Fundamentals

1 张卡片
  1. 新技术学习要回到架构基本概念 理解等级:中级 普通读书笔记卡

10 Radars, Quadrants, and Trend Reports

1 张卡片
  1. 技术榜单只适合初步筛选 理解等级:高级 普通读书笔记卡

10 Learning About Best Practices and Use Cases

1 张卡片
  1. 案例复盘需寻找失败样本 理解等级:高级 普通读书笔记卡

10 Learning by Doing

1 张卡片
  1. 架构师实践可暴露开发摩擦 理解等级:中级 普通读书笔记卡

10 Learning by Teaching

1 张卡片
  1. 教学能发现架构理解缺口 理解等级:中级 普通读书笔记卡

全书概览

Mastering API Architecture

Skill 版本:v10(本目录首次创建) 本次实际使用规则:book-notes v24;book-workflow v4(2026-11-14)。 执行模式:light 建档进度:done 2026-10-12 续跑规则:book-notes v11;仅补齐全书与章节大纲,首次记录的 Skill 版本 v10 保持不变。 书籍身份:James Gough、Daniel Bryant、Matthew Auburn;O’Reilly;2022 First Edition。 类别:系统架构类。 内容形态:概念解析型。 最近续跑状态:17项正文、302单元、504779归一正文字符完整回读并补齐内容脉络;100个缓存资源与原EPUB逐字节一致。复用180卡、66节整书讲解、180个主要位置及180条原书出处;修订2份实践计划,未执行完整实践。轻量模式未执行生成后笔记复核、独立审查及审查结果优化。

整体评级

信息浓度:高;稳定性:高;四象限:经典原理。 第1–2章解释接口契约与测试,第3–4章权衡网关和网格,第5–7章讨论发布、安全与授权,第8–9章用模块边界和渐进迁云案例讨论演进成本,整体重在设计理由与取舍。内聚/耦合、信息隐藏、边界、渐进迁移与威胁建模可迁移到后续技术;产品清单、HTTP/3 市场数据、旧 OWASP 榜单及若干安全建议有时效性,实际采用时须另行核对现行一手来源,评级不替代准确性审查。

章节筛选与进度

spine序号 来源项 章节/部分 阅读安排 状态 卡片数
5 foreword01 Foreword 全文核对 done 0
6 preface01 Preface 全文核对 done 0
7 introduction01 Introduction 精读 done 9
8 part01 Part I. Designing, Building, and Testing APIs 全文核对 done 0
9 ch01 Chapter 1. Design, Build, and Specify APIs 精读 done 24
10 ch02 Chapter 2. Testing APIs 精读 done 17
11 part02 Part II. API Traffic Management 全文阅读(复用已核验历史证据) done 0
12 ch03 Chapter 3. API Gateways: Ingress Traffic Management 精读 done 21
13 ch04 Chapter 4. Service Mesh: Service-to-Service Traffic Management 精读 done 18
14 part03 Part III. API Operations and Security 全文阅读(复用已核验历史证据) done 0
15 ch05 Chapter 5. Deploying and Releasing APIs 精读 done 13
16 ch06 Chapter 6. Operational Security: Threat Modeling for APIs 精读 done 12
17 ch07 Chapter 7. API Authentication and Authorization 精读 done 12
18 part04 Part IV. Evolutionary Architecture with APIs 全文阅读(复用已核验历史证据) done 0
19 ch08 Chapter 8. Redesigning Applications to API-Driven Architectures 精读 done 24
20 ch09 Chapter 9. Using API Infrastructure to Evolve Toward Cloud Platforms 精读 done 20
21 ch10 Chapter 10. Wrap-up 精读 done 10

非正文排除

spine序号 来源项 类型 具体理由
1 cover OEBPS/cover.xhtml 封面/书名页/版权/献辞 仅书目、检索或作者信息,无技术论证正文
2 titlepage01 OEBPS/titlepage01.xhtml 封面/书名页/版权/献辞 仅书目、检索或作者信息,无技术论证正文
3 copyright-page01 OEBPS/copyright-page01.xhtml 封面/书名页/版权/献辞 仅书目、检索或作者信息,无技术论证正文
4 dedication01 OEBPS/dedication01.xhtml 封面/书名页/版权/献辞 仅书目、检索或作者信息,无技术论证正文
22 ix01 OEBPS/ix01.xhtml 索引/作者信息 仅书目、检索或作者信息,无技术论证正文
23 colophon01 OEBPS/colophon01.xhtml 索引/作者信息 仅书目、检索或作者信息,无技术论证正文
24 colophon02 OEBPS/colophon02.xhtml 索引/作者信息 仅书目、检索或作者信息,无技术论证正文

生成记录

  • 知识卡:180(S1 基线为 0;导言 9 张,第1–10章 171 张;S4 新增第6章身份头卡并合并第8章重复 ADR 卡,净数不变)。
  • 实践点子卡:2(计划已写,现实行动未执行)。
  • 类别清单核对:系统架构类逐项见下表;一致性与事务权衡未系统展开,明确记未覆盖。

整书笔记

阅读正文、全书主线、17项正文讲解及跨章综合见 整书笔记。本次使用 book-notes v24 / book-workflow v4,light;历史大纲基线保存在本轮证据目录,阅读内容以整书笔记为准。

实践卡进度

序号 实践标题 实践方式 状态 关联章节 产出
1 为并发锁建立架构检查 真实任务 done 第8章 锁安全检查表与演练记录模板(计划)
2 绘制卡片导入与展示边界 真实任务 done 第8章 组件职责图与变更影响矩阵(计划)

实践候选筛选:done

候选筛选:网格零信任实验需要新环境与安全配置,暂不选择;HTTP/3 性能比较需可控网络样本,暂不选择。以上仅形成实践计划,尚未执行现实行动。

类别清单核对:系统架构类

必答项 结论与章节证据
服务拆分原则 已覆盖:第8章以高内聚、松耦合、信息隐藏和领域边界选择模块与服务。
通信机制 已覆盖:第1章接口形式和同步协议,第4章服务间流量,第10章异步接口描述;具体选择仍须看延迟、耦合和交换模式。
一致性与事务权衡 未系统覆盖:第8章绞杀迁移仅提醒双轨数据一致性,没有跨服务事务或一致性策略的成体系比较;不补造。
可观测性设计 已覆盖:第5章指标、日志、追踪以及跨服务上下文传播。
容错设计 已覆盖:第4章服务发现、重试、超时等通信韧性策略;第3章入口故障切换。
扩展性瓶颈与应对 已覆盖:第3章入口选择与聚合代价、第4章网格资源成本、第8章函数粒度与模块耦合。
部署与发布策略 已覆盖:第5章部署与发布分离、功能开关、金丝雀、流量镜像及蓝绿切换。

待关联术语

术语名 出现章节 一句话语境
USE、RED、黄金信号 第3章 仅作为网关可观测性延伸阅读名词提及,不在此补造详细机制。
网状网络 第4章 侧栏仅辨析网络层次,与服务网格并非同一概念。
Service Mesh Interface(SMI) 第10章 只作为平台网格趋势中值得关注的相关标准提名,未展开机制。

引用文献

标题 类型 出现章节 一句话语境
Site Reliability Engineering 书 第3章 作为理解黄金信号等观测方法的延伸阅读,未在此展开书内细节。
Building Evolutionary Architectures 书 第8章 只借用渐进变更的架构定义,未展开该书内容。
Monolith to Microservices 书 第8章 作为单体模块化与迁移的延伸阅读提及。
Working Effectively with Legacy Code 书 第8章 提及接缝及萌芽、包裹技巧,细节以本书可核对段落成卡。
Team Topologies 书 第10章 作为组织设计延伸阅读列出,未展开该书内容。

资金安全问题案例

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

本书未展开可独立成卡的具体资金并发事故;重试和双轨一致性提醒保留在相关机制卡,不补造案例。

主题索引维护

以下结论按当前 180 张稳定知识卡逐张复核;已复用的主题成员写入 notes/_topics/,无需加入的卡片附具体原因。

卡片标题 结论 主题文件或原因
演进式架构重视变更能力 已复用 notes/_topics/evolutionary-architecture-fitness.md
API优先围绕消费者设计 无需加入 现有主题未专门比较消费者优先的 API 设计流程
API用规范隐藏实现 已复用 notes/_topics/remote-interface-distribution.md
进程边界区分API调用 已复用 notes/_topics/remote-interface-distribution.md
南北与东西流量区分入口 已复用 notes/_topics/service-discovery-gateway.md
C4按层次表达架构 已复用 notes/_topics/c4-architecture-visualization.md
ADR保留决策依据 已复用 notes/_topics/architecture-decision-making.md
ADR四段结构 已复用 notes/_topics/architecture-decision-making.md
ADR指南先列判断条件 已复用 notes/_topics/architecture-decision-making.md
消费者关系决定接口耦合 已复用 notes/_topics/remote-interface-distribution.md
REST统一接口隔离实现 已复用 notes/_topics/rpc-rest-api.md
Richardson四级模型 已复用 notes/_topics/rpc-rest-api.md
超媒体导航需权衡交互成本 已复用 notes/_topics/rpc-rest-api.md
RPC将远端方法包装成本地调用 已复用 notes/_topics/rpc-rest-api.md
RPC状态与耦合取舍 已复用 notes/_topics/rpc-rest-api.md
GraphQL按需跨源取字段 无需加入 现有主题未覆盖 GraphQL 的按需跨源查询机制
接口标准应尽早统一 已复用 notes/_topics/service-governance.md
敏感信息不要进入URL 已复用 notes/_topics/trust-boundaries-tcb.md
集合响应预留分页结构 无需加入 分页响应结构是接口细节,现有主题均不以此为比较范围
错误状态码表达处理结果 无需加入 HTTP 错误状态表达是接口细节,现有主题均不以此为比较范围
外部错误不泄露内部堆栈 无需加入 对外错误隐藏堆栈是单点防泄露做法,现有主题范围较宽
OpenAPI描述接口形状 已复用 notes/_topics/service-governance.md
接口规范不覆盖行为语义 已复用 notes/_topics/service-governance.md
规范校验可设在流量边界 已复用 notes/_topics/service-governance.md
示例与模拟服务帮助试接口 已复用 notes/_topics/service-governance.md
API版本平衡双方升级成本 已复用 notes/_topics/service-adaptation-compatibility.md
语义版本标示兼容性 已复用 notes/_topics/service-adaptation-compatibility.md
规范差异识别破坏变更 已复用 notes/_topics/service-adaptation-compatibility.md
Protobuf字段号不可重排 已复用 notes/_topics/data-interchange-formats.md
通信格式取舍要实测 已复用 notes/_topics/data-interchange-formats.md
载荷成本包含解析时间 已复用 notes/_topics/data-interchange-formats.md
HTTP2多路复用共享连接 已复用 notes/_topics/web-transport-acceleration.md
双协议转换耦合演进 已复用 notes/_topics/service-adaptation-compatibility.md
测试四象限区分目的 已复用 notes/_topics/testing-effectiveness.md
测试金字塔平衡范围和成本 已复用 notes/_topics/testing-effectiveness.md
契约测试验证双方交互 已复用 notes/_topics/testing-effectiveness.md
契约不等于模式符合 已复用 notes/_topics/testing-effectiveness.md
模拟服务支持并行开发 已复用 notes/_topics/testing-effectiveness.md
契约主导权依消费者关系 已复用 notes/_topics/testing-effectiveness.md
契约存放要支持双方取得 已复用 notes/_topics/testing-effectiveness.md
组件测试验证服务行为 已复用 notes/_topics/testing-effectiveness.md
集成测试跨外部依赖边界 已复用 notes/_topics/testing-effectiveness.md
录制桩要防漂移与泄露 已复用 notes/_topics/testing-effectiveness.md
容器测试真实依赖边界 已复用 notes/_topics/testing-effectiveness.md
真实依赖不替代契约 已复用 notes/_topics/testing-effectiveness.md
端到端测试验证完整请求链 已复用 notes/_topics/testing-effectiveness.md
端到端边界取决于目标 已复用 notes/_topics/testing-effectiveness.md
端到端载荷应代表真实使用 已复用 notes/_topics/testing-effectiveness.md
端到端场景优先核心旅程 已复用 notes/_topics/testing-effectiveness.md
性能链路需匹配生产条件 已复用 notes/_topics/testing-effectiveness.md
入口方案按需求选最简 已复用 notes/_topics/service-discovery-gateway.md
网关控制面与数据面分工 已复用 notes/_topics/service-discovery-gateway.md
入口栈按功能分层部署 已复用 notes/_topics/service-discovery-gateway.md
网关契约隔离后端变化 已复用 notes/_topics/service-discovery-gateway.md
网关聚合需守住业务边界 已复用 notes/_topics/service-discovery-gateway.md
网关防护需可观测支撑 已复用 notes/_topics/defense-in-depth-blast-radius.md
入口遥测连接跨服务请求 已复用 notes/_topics/logging-observability.md
接口管理覆盖完整生命周期 已复用 notes/_topics/service-governance.md
入口技术随需求扩展 已复用 notes/_topics/service-discovery-gateway.md
应用层路由支持接口治理 已复用 notes/_topics/service-discovery-gateway.md
网关类型按主要职责区分 已复用 notes/_topics/service-discovery-gateway.md
网格入口依赖网格决策 已复用 notes/_topics/service-discovery-gateway.md
单体代路由扩大故障面 已复用 notes/_topics/service-discovery-gateway.md
避免按请求体内容路由 已复用 notes/_topics/service-discovery-gateway.md
网关集中能力放大故障影响 已复用 notes/_topics/defense-in-depth-blast-radius.md
安全组件故障语义须明确 已复用 notes/_topics/fail-safe-defaults.md
入口切换需验证业务连续性 已复用 notes/_topics/change-release-safety.md
内部调用避免绕行入口网关 已复用 notes/_topics/service-discovery-gateway.md
网关插件避免承载业务逻辑 已复用 notes/_topics/service-discovery-gateway.md
多层网关增加变更协调成本 已复用 notes/_topics/service-discovery-gateway.md
网关选型计算全生命周期成本 已复用 notes/_topics/architecture-design-process.md
服务间治理按需求选型 已复用 notes/_topics/service-mesh.md
网格控制面配置数据面执行 已复用 notes/_topics/service-mesh.md
全代理换来治理与链路开销 已复用 notes/_topics/service-mesh.md
网格统一动态服务发现 已复用 notes/_topics/service-mesh.md
网格观测仍需业务埋点 已复用 notes/_topics/logging-observability.md
网格统一服务身份与加密 已复用 notes/_topics/service-mesh.md
多语言服务复用代理治理 已复用 notes/_topics/service-mesh.md
入口与内部流量策略分治 已复用 notes/_topics/service-mesh.md
网格统一通信韧性策略 已复用 notes/_topics/service-mesh.md
分布式调用须承认网络限制 已复用 notes/_topics/service-mesh.md
边车数量放大资源成本 已复用 notes/_topics/service-mesh.md
网格数据面有多种实现位置 已复用 notes/_topics/service-mesh.md
网格路由与目标策略分离 已复用 notes/_topics/service-mesh.md
服务身份支撑默认拒绝 已复用 notes/_topics/service-mesh.md
网格控制面也需高可用 已复用 notes/_topics/service-mesh.md
网格过滤器不应承载业务 已复用 notes/_topics/service-mesh.md
网格叠加前核对网络层 已复用 notes/_topics/service-mesh.md
网格选型计入现有治理成本 已复用 notes/_topics/service-mesh.md
部署与发布是两个动作 已复用 notes/_topics/change-release-safety.md
功能开关需降级与清理 已复用 notes/_topics/change-release-safety.md
接口生命周期约束消费者预期 已复用 notes/_topics/service-governance.md
重大版本需并行供消费者迁移 已复用 notes/_topics/change-release-safety.md
金丝雀发布按指标渐进放量 已复用 notes/_topics/change-release-safety.md
流量镜像只验证影子结果 已复用 notes/_topics/change-release-safety.md
蓝绿切换需要双环境成本 已复用 notes/_topics/change-release-safety.md
接口指标必须结合错误语境 已复用 notes/_topics/logging-observability.md
缓存可能掩盖发布故障 已复用 notes/_topics/caching-strategies.md
跨服务传播追踪与身份需分开 已复用 notes/_topics/logging-observability.md
日志区分事件与诊断 已复用 notes/_topics/logging-observability.md
内部平台要服务开发者 已复用 notes/_topics/devops-adoption.md
指标日志追踪相互补足 已复用 notes/_topics/logging-observability.md
威胁建模随系统演进迭代 已复用 notes/_topics/threat-modeling.md
数据流图显露信任边界 已复用 notes/_topics/threat-modeling.md
威胁分析从目标走到验证 已复用 notes/_topics/threat-modeling.md
逐元素检查六类威胁 已复用 notes/_topics/threat-modeling.md
入口校验不能替代服务校验 已复用 notes/_topics/defense-in-depth-blast-radius.md
防止请求字段越权绑定 已复用 notes/_topics/defense-in-depth-blast-radius.md
敏感字段和旧端点都要盘点 已复用 notes/_topics/defense-in-depth-blast-radius.md
限流与过载拒绝依据不同 已复用 notes/_topics/overload-protection-degradation.md
风险评分需要统一口径 已复用 notes/_topics/information-security-risk-assessment.md
安全审计要能重建行为 已复用 notes/_topics/logging-observability.md
威胁缓解后还要重新验证 已复用 notes/_topics/threat-modeling.md
入口剥离外来身份头 已复用 notes/_topics/trust-boundaries-tcb.md
认证身份与授权权限分开 已复用 notes/_topics/auth-and-cryptography.md
接口密钥只识别应用 已复用 notes/_topics/auth-and-cryptography.md
委托授权不交出用户密码 已复用 notes/_topics/auth-and-cryptography.md
签名令牌内容仍可被读取 已复用 notes/_topics/auth-and-cryptography.md
验签之外还需核对令牌声明 已复用 notes/_topics/auth-and-cryptography.md
资源服务校验访问令牌 已复用 notes/_topics/auth-and-cryptography.md
公开客户端用授权码加PKCE 已复用 notes/_topics/auth-and-cryptography.md
刷新令牌延续授权但需保护 已复用 notes/_topics/auth-and-cryptography.md
客户端凭证代表应用自身 已复用 notes/_topics/auth-and-cryptography.md
权限范围只定义粗粒度边界 已复用 notes/_topics/least-privilege-access-control.md
授权还需核对对象与功能 已复用 notes/_topics/least-privilege-access-control.md
身份令牌不可代替访问令牌 已复用 notes/_topics/auth-and-cryptography.md
用API围出变更边界 已复用 notes/_topics/modularity-information-hiding.md
高内聚API隔离内部变化 已复用 notes/_topics/modularity-information-hiding.md
通用工具接口会稀释内聚 已复用 notes/_topics/modularity-information-hiding.md
松耦合降低替换成本 已复用 notes/_topics/modularity-information-hiding.md
松耦合接口易于替身测试 已复用 notes/_topics/testing-effectiveness.md
业务接口隐藏存储决定 已复用 notes/_topics/modularity-information-hiding.md
单体适合早期快速探索 已复用 notes/_topics/microservice-boundaries-evolution.md
服务拆分要平衡归属与成本 已复用 notes/_topics/microservice-boundaries-evolution.md
微服务边界先于技术选型 已复用 notes/_topics/microservice-boundaries-evolution.md
过细函数会提高编排耦合 已复用 notes/_topics/microservice-boundaries-evolution.md
演进目标分功能与质量 已复用 notes/_topics/evolutionary-architecture-fitness.md
适应度函数持续检验架构 已复用 notes/_topics/evolutionary-architecture-fitness.md
模块边界先于服务拆分 已复用 notes/_topics/modularity-information-hiding.md
单向模块依赖利于独立演进 已复用 notes/_topics/modularity-information-hiding.md
接缝是可替换的交互点 已复用 notes/_topics/modularity-information-hiding.md
用变更频率寻找改造杠杆 已复用 notes/_topics/architecture-refactoring.md
绞杀模式逐步替换旧实现 已复用 notes/_topics/microservice-boundaries-evolution.md
迁移代理须控制故障与耦合 已复用 notes/_topics/microservice-boundaries-evolution.md
门面与适配器职责不同 已复用 notes/_topics/service-adaptation-compatibility.md
分层API可能放大跨层改动 已复用 notes/_topics/layered-architecture-ports.md
维护痛点可提示API切入点 已复用 notes/_topics/architecture-refactoring.md
性能改造先量测再假设 已复用 notes/_topics/architecture-metrics-selection.md
同步发布暴露接口耦合 已复用 notes/_topics/change-release-safety.md
用萌芽与包裹改动遗留代码 已复用 notes/_topics/architecture-refactoring.md
网关可遮蔽服务迁移位置 已复用 notes/_topics/service-discovery-gateway.md
云迁移选项覆盖六种处置 已复用 notes/_topics/hybrid-multi-cloud.md
暂留系统也要记录理由 已复用 notes/_topics/architecture-decision-making.md
弃用通知要给消费者时限 已复用 notes/_topics/change-release-safety.md
跨云延迟可推翻迁移方案 已复用 notes/_topics/hybrid-multi-cloud.md
原样迁移保留架构假设 已复用 notes/_topics/hybrid-multi-cloud.md
专用硬件会阻碍原样迁移 已复用 notes/_topics/hybrid-multi-cloud.md
平台迁移只改必要基础设施 已复用 notes/_topics/hybrid-multi-cloud.md
换购以现成服务替代自建 已复用 notes/_topics/hybrid-multi-cloud.md
重构迁移改变内部实现 已复用 notes/_topics/hybrid-multi-cloud.md
退役先证实能力无人依赖 已复用 notes/_topics/service-governance.md
案例先完成服务拆分再迁云 已复用 notes/_topics/microservice-boundaries-evolution.md
API管理层提供发现与稳定入口 已复用 notes/_topics/service-governance.md
先迁边缘再向内推进 已复用 notes/_topics/hybrid-multi-cloud.md
跨网络路由随规模选机制 已复用 notes/_topics/hybrid-multi-cloud.md
网络分区降低攻击波及面 已复用 notes/_topics/defense-in-depth-blast-radius.md
零信任逐次验证身份与状态 已复用 notes/_topics/trust-boundaries-tcb.md
服务网格安全依赖平台底座 已复用 notes/_topics/service-mesh.md
默认拒绝后逐项开放流量 已复用 notes/_topics/service-mesh.md
多集群网格统一迁移期策略 已复用 notes/_topics/service-mesh.md
演进灵活性伴随基础设施复杂度 已复用 notes/_topics/evolutionary-architecture-fitness.md
组织沟通结构塑造API边界 已复用 notes/_topics/org-architecture-alignment.md
区分可逆与难逆架构决策 已复用 notes/_topics/architecture-decision-making.md
异步接口也需要契约描述 已复用 notes/_topics/enterprise-integration-patterns.md
HTTP语义与传输映射分离 已复用 notes/_topics/web-transport-acceleration.md
新技术学习要回到架构基本概念 已复用 notes/_topics/architect-growth.md
技术榜单只适合初步筛选 已复用 notes/_topics/architecture-design-process.md
案例复盘需寻找失败样本 已复用 notes/_topics/architecture-design-process.md
架构师实践可暴露开发摩擦 已复用 notes/_topics/architect-growth.md
教学能发现架构理解缺口 已复用 notes/_topics/architect-growth.md

本轮 V23 交接

  • 2026-10-25,book-workflow v4 / book-notes v23,light。首次 Skill 版本 v10 保留,V11大纲历史记录保留。
  • 原始EPUB与100个解包文件逐字节一致;24项spine,17正文/7非正文,302阅读单元的历史证据有效;本轮为缺笔记恢复,回读必要原文,未重读全书。
  • 180张知识卡(普通179、结构图1)原文件未改;2张真实任务实践计划已更新当前工作台路径,现实行动未执行。
  • 整书笔记schema 1,每卡唯一primary及至少一处原书出处。来源、基线与放行/导入/归档证据位于 .local/runs/maa-v23-20261025/,编排状态以 _workflow.md 为准。
  • 本轮复核、独立审查和审查结果优化未执行,历史审查仅保留为历史。

2026-11-14 v24 完整处理记录

  • 按P1顺序跳过用户已完成书及其他会话活动书,选第35本;目录沿用既有唯一身份 Mastering API Architecture,数据库628。
  • 首次Skill v10与v11/v23历史保留;本次book-workflow v4 / book-notes v24 –mode light。17项实质正文、302单元、504779正文字符全部回读,100资源ZIP缓存一致;候选去向及补记术语/文献均可定位。
  • 180知识卡与整书笔记保持原字节;schema1、66节、180引用含180唯一primary、180出处。
  • 实践筛选done;2份真实任务计划修订并核实连续原始摘录、现有工作台协议和README边界,现实行动未执行。
  • light未执行生成后复核、独立审查或审查结果优化;导入归档、总表更新和最终验收见_workflow.md。

相关主题

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

主题索引

微服务拆分与演进

比较微服务拆分的边界依据、粒度与非业务因素,以及从单体演进和持续重组的策略。

444 张卡片 · 71 本书

主题索引

过载保护与优雅降级

比较限流、减载、退避重试、分级依赖与防御成本的过载应对手段。

386 张卡片 · 68 本书

主题索引

指标与监控

时序模型与拉推采集、黄金指标与分位、探针与 APM、容量与负载、监控分层。

382 张卡片 · 58 本书

主题索引

测试有效性与验证手段

比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。

366 张卡片 · 63 本书

主题索引

服务治理闭环

比较服务资产、生命周期、依赖关系与运行策略如何形成可观测、可诊断、可执行的治理闭环。

361 张卡片 · 17 本书

主题索引

架构方案设计与评估

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

352 张卡片 · 40 本书

主题索引

缓存架构与失效问题

比较缓存穿透、雪崩、热点等问题的成因与应对方案。

345 张卡片 · 58 本书

主题索引

变更发布与回滚安全

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

312 张卡片 · 75 本书

主题索引

远程调用与REST设计

比较 RPC 要解决的基本问题与历代框架取舍,以及 REST 的资源抽象、统一接口、成熟度与局限。

303 张卡片 · 53 本书

主题索引

服务发现与网关

比较服务发现范式、注册中心的 CAP 取舍与实现路线、网关与 BFF,以及地域与区域的流量边界。

286 张卡片 · 70 本书

主题索引

演进式架构与适应度函数

比较以适应度函数守护架构特征、以增量变更与自动化治理支撑持续演进的方法,以及演进式数据、架构量子与常见反模式。

282 张卡片 · 15 本书

主题索引

服务网格

比较边车代理、通信可靠性演进、流量劫持、xDS 与控制平面产品,以及网格层的安全与标准化。

266 张卡片 · 23 本书

主题索引

组织与架构协同演进

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

255 张卡片 · 57 本书

主题索引

认证与密码学基础

比较 HTTP 认证方案、OAuth2 与 JWT、会话状态,以及摘要、加密、签名、证书与 TLS 的密码学基础。

253 张卡片 · 58 本书

主题索引

模块化与信息隐藏

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

209 张卡片 · 51 本书

主题索引

追踪与上下文

Trace/Span 模型、标识与上下文传播、采样取舍、OpenTelemetry 与采集器管道。

199 张卡片 · 44 本书

主题索引

分层、洋葱与六边形架构

比较分层、洋葱与六边形架构如何隔离核心业务逻辑与外部技术细节,以及各层职责与调用规则。

196 张卡片 · 43 本书

主题索引

最小特权与访问控制

比较最小权限、多方审批、紧急绕过与访问审计的设计取舍。

175 张卡片 · 72 本书

主题索引

架构决策方法

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

168 张卡片 · 45 本书

主题索引

日志、审计与取证

日志该记什么、怎么分级与结构化,采集管道与存储成本,以及审计证据与安全事件还原。

167 张卡片 · 46 本书

主题索引

架构师成长路径

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

157 张卡片 · 36 本书

主题索引

DevOps落地与组织协作

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

148 张卡片 · 32 本书

主题索引

数据交换格式设计

比较数据交换格式的简洁性、互通性与安全解析要求。

146 张卡片 · 38 本书

主题索引

服务适配与兼容性

比较服务组合中接口与协议失配的分类、适配器的生成与合成方式,以及兼容性分层与组合验证。

146 张卡片 · 38 本书

主题索引

架构重构

比较识别重构目标、沟通推动与分段实施等架构重构方法。

138 张卡片 · 29 本书

主题索引

企业集成模式

比较管道过滤器、各类消息通道、命令/文档/事件消息结构、路由(内容、动态、分离聚合、分散聚集、处理过程管理器)、转换(封装、丰富、过滤、存放证、标准化、规范模型)与端点模式的适用场景和取舍。

99 张卡片 · 24 本书

主题索引

分布边界与远程接口

何时才需要分布、远程接口为何要粗粒度,以及远程外观、数据传输对象与序列化格式的设计。

93 张卡片 · 29 本书

主题索引

Web 交付链路优化

从浏览器到源站的每一跳能省掉什么:强制缓存与协商缓存、DNS 解析与 HTTPDNS、HTTP/2 多路复用与 QUIC、分块传输与范围请求、静态化与动静分离、CDN 就近分发与回源,以及移动网络下减少往返的手段。

90 张卡片 · 24 本书

主题索引

架构度量与指标选择

比较交付指标、GQM、可维护性指标与趋势观察等架构度量方法,以及指标如何脱离上下文而误导决策。

81 张卡片 · 15 本书

主题索引

混合云与多云管理

比较混合云与多云的组合形态、异构云资源的统一适配、按敏感度与弹性需求放置负载,以及可移植性与供应商锁定的取舍。

71 张卡片 · 11 本书

主题索引

信息安全风险评估与处置

比较如何按业务和资产价值识别威胁、脆弱性及已有措施,评估事件可能性与损失,并按控制效果、成本和残余风险选择处置。

36 张卡片 · 7 本书

主题索引

C4模型与架构可视化

比较用语境、容器、组件、类四层抽象描述软件架构的方法:草图的常见缺陷、分层视图的边界、图与代码的映射、图例与评审清单。

30 张卡片 · 3 本书

主题索引

故障时的安全默认状态

比较组件失效时选择开放、关闭或停滞的依据与被利用风险。

30 张卡片 · 17 本书