来源书籍

Microservice APIs

Skill 版本:v11 系统架构类 工程实践(高信息浓度 + 低稳定性)。 238 张卡片

尚未生成整书笔记。

类别清单覆盖

6/7

已覆盖 6 补充生成 0 未覆盖 1

全书大纲

图式:层级结构图 选择理由:阅读计划初选层级结构图,因为作者按微服务 API 的设计与交付生命周期分部展开;全文复核后,REST、OpenAPI、实现模式、GraphQL、安全、测试和部署构成先后依赖清楚的递进主线,层级结构图比并列主题图更能表达这一回答路径。 核心主旨:如何设计、实现、保护、验证并部署能支撑微服务协作的 API,同时控制服务边界与运行复杂度。 论述主线:先定义微服务 API 的价值、契约和架构代价;再依次讲服务拆分、REST 设计及 OpenAPI 描述,并用 Python 示例落地;随后建立 GraphQL 的模式、消费和实现方式;最后从认证授权推进到测试、容器化和 Kubernetes 部署,附录回看协议类型、API 生命周期及身份提供方流程。

flowchart TD
  A[微服务 API 的价值与约束] --> B[服务边界和契约基础]
  B --> C[REST 资源设计]
  C --> D[OpenAPI 契约]
  D --> E[Python REST 实现]
  E --> F[服务内部架构模式]
  F --> G[GraphQL 模式设计]
  G --> H[GraphQL 查询消费]
  H --> I[GraphQL 服务实现]
  I --> J[身份认证与资源授权]
  J --> K[契约与性质测试]
  K --> L[容器构建和发布]
  L --> M[Kubernetes 部署与运行]
  M --> N[协议、生命周期与身份流程的附录回顾]

章节与卡片

00 API 优先开发说明

3 张卡片
  1. 文档驱动开发 理解等级:中级 普通读书笔记卡
  2. 单项与集合端点 理解等级:初级 普通读书笔记卡
  3. HTTP方法与状态码分工 理解等级:初级 普通读书笔记卡

00 What are microservice APIs?

2 张卡片
  1. 微服务独立部署 理解等级:初级 普通读书笔记卡
  2. 微服务的运维代价 理解等级:高级 普通读书笔记卡

00 Designing and building GraphQL APIs

1 张卡片
  1. GraphQL按需查询字段 理解等级:初级 普通读书笔记卡

00 Securing, testing, and deploying microservice APIs

1 张卡片
  1. API经济以接口交付能力 理解等级:中级 普通读书笔记卡

00 前言与导读

0 张卡片

章节作用:交代写作目标、读者、CoffeeMesh 案例和章节路线;这是导航,不提前替代后文论证。

内容脉络:问题与目标 → 读者和案例 → 章节路线。

flowchart TD
  A[问题与目标]
  A --> B[读者和案例]
  B --> C[章节路线]

相关卡片:无(本章无合格知识卡)

01 1 What are microservice APIs?

20 张卡片

章节作用:回答微服务 API 的含义及其作用,再用集成、故障、事务和运维问题说明设计约束。

内容脉络:微服务与单体的边界 → API 与 Web API → 集成、故障和事务挑战 → 文档驱动开发与 CoffeeMesh。

flowchart TD
  A[微服务与单体的边界]
  A --> B[API 与 Web API]
  B --> C[集成、故障和事务挑战]
  C --> D[文档驱动开发与 CoffeeMesh]

相关卡片:单体应用整体部署、紧耦合依赖实现细节、单体增长放大发布范围、服务数据由接口封装、API是程序化接口、Web API以HTTP传输、API规范约束两端、智能端点与简单管道、稳定接口支撑替换实现、分布式单体的联动变更、集成测试分层验证、服务故障沿调用链传播、跨服务事务需要协调、支付成功后订单状态未更新、跨服务追踪定位故障、API设计纳入消费者、接口描述语言支撑工具链、付款失败后库存仍占用、付款失败回退库存、契约测试纳入持续集成

  1. 单体应用整体部署 理解等级:初级 普通读书笔记卡
  2. 紧耦合依赖实现细节 理解等级:初级 普通读书笔记卡
  3. 单体增长放大发布范围 理解等级:中级 普通读书笔记卡
  4. 服务数据由接口封装 理解等级:中级 普通读书笔记卡
  5. API是程序化接口 理解等级:初级 普通读书笔记卡
  6. Web API以HTTP传输 理解等级:初级 普通读书笔记卡
  7. API规范约束两端 理解等级:中级 普通读书笔记卡
  8. 智能端点与简单管道 理解等级:中级 普通读书笔记卡
  9. 稳定接口支撑替换实现 理解等级:中级 普通读书笔记卡
  10. 分布式单体的联动变更 理解等级:高级 普通读书笔记卡
  11. 集成测试分层验证 理解等级:中级 普通读书笔记卡
  12. 服务故障沿调用链传播 理解等级:中级 普通读书笔记卡
  13. 跨服务事务需要协调 理解等级:中级 普通读书笔记卡
  14. 支付成功后订单状态未更新 理解等级:中级 支付系统案例卡
  15. 跨服务追踪定位故障 理解等级:中级 普通读书笔记卡
  16. API设计纳入消费者 理解等级:中级 普通读书笔记卡
  17. 接口描述语言支撑工具链 理解等级:初级 普通读书笔记卡
  18. 付款失败后库存仍占用 理解等级:中级 支付系统案例卡
  19. 付款失败回退库存 理解等级:中级 支付系统案例卡
  20. 契约测试纳入持续集成 理解等级:中级 普通读书笔记卡

02 2 A basic API implementation

18 张卡片

章节作用:以订单 API 的契约和分层实现展示端点、请求校验、响应校验及内存替身。

内容脉络:API 规范与应用结构 → 端点实现 → 请求与响应模型校验 → 内存订单示例及其边界。

flowchart TD
  A[API 规范与应用结构]
  A --> B[端点实现]
  B --> C[请求与响应模型校验]
  C --> D[内存订单示例及其边界]

相关卡片:路径与方法共同定端点、Schema约束请求载荷、服务三层职责分离、FastAPI组合框架能力、锁文件固定依赖版本、装饰器绑定请求路由、路径参数可声明类型、Swagger UI交互试调、对象编组为可传输结构、Schema引用复用子模型、pydantic映射契约约束、类型注解接入载荷校验、错误路径定位缺失字段、未知字段可能掩盖拼写错误、可选字段不等于可为null、出站响应也要按模型验证、内存列表仅模拟订单状态、资源不存在返回404

  1. 路径与方法共同定端点 理解等级:初级 普通读书笔记卡
  2. Schema约束请求载荷 理解等级:初级 普通读书笔记卡
  3. 服务三层职责分离 理解等级:中级 结构图卡
  4. FastAPI组合框架能力 理解等级:初级 延伸参考卡
  5. 锁文件固定依赖版本 理解等级:中级 普通读书笔记卡
  6. 装饰器绑定请求路由 理解等级:中级 普通读书笔记卡
  7. 路径参数可声明类型 理解等级:中级 普通读书笔记卡
  8. Swagger UI交互试调 理解等级:初级 延伸参考卡
  9. 对象编组为可传输结构 理解等级:初级 普通读书笔记卡
  10. Schema引用复用子模型 理解等级:中级 普通读书笔记卡
  11. pydantic映射契约约束 理解等级:中级 普通读书笔记卡
  12. 类型注解接入载荷校验 理解等级:中级 普通读书笔记卡
  13. 错误路径定位缺失字段 理解等级:初级 普通读书笔记卡
  14. 未知字段可能掩盖拼写错误 理解等级:中级 普通读书笔记卡
  15. 可选字段不等于可为null 理解等级:中级 普通读书笔记卡
  16. 出站响应也要按模型验证 理解等级:中级 普通读书笔记卡
  17. 内存列表仅模拟订单状态 理解等级:中级 普通读书笔记卡
  18. 资源不存在返回404 理解等级:初级 普通读书笔记卡

03 3 Designing microservices

12 张卡片

章节作用:从服务原则出发,分别用业务能力和领域子域拆分,再交叉比较两种视角。

内容脉络:服务边界原则 → 按业务能力拆分 → 按子域进行战略设计 → 交叉校验拆分结果。

flowchart TD
  A[服务边界原则]
  A --> B[按业务能力拆分]
  B --> C[按子域进行战略设计]
  C --> D[交叉校验拆分结果]

相关卡片:服务拆分界定职责边界、数据归属不要求独立库、独立变化检验服务耦合、总依赖他人暗示边界错误、单一职责对应业务边界、业务能力映射组织团队、产品库存边界需要合并、领域语言消除概念歧义、核心领域指向价值活动、战略设计协调多个模型、沿业务流程识别子域、两种拆分视角互相校验

  1. 服务拆分界定职责边界 理解等级:中级 普通读书笔记卡
  2. 数据归属不要求独立库 理解等级:中级 普通读书笔记卡
  3. 独立变化检验服务耦合 理解等级:高级 普通读书笔记卡
  4. 总依赖他人暗示边界错误 理解等级:高级 普通读书笔记卡
  5. 单一职责对应业务边界 理解等级:中级 普通读书笔记卡
  6. 业务能力映射组织团队 理解等级:中级 普通读书笔记卡
  7. 产品库存边界需要合并 理解等级:高级 普通读书笔记卡
  8. 领域语言消除概念歧义 理解等级:中级 普通读书笔记卡
  9. 核心领域指向价值活动 理解等级:中级 普通读书笔记卡
  10. 战略设计协调多个模型 理解等级:中级 普通读书笔记卡
  11. 沿业务流程识别子域 理解等级:中级 普通读书笔记卡
  12. 两种拆分视角互相校验 理解等级:高级 普通读书笔记卡

04 4 Principles of REST API design

27 张卡片
  1. 资源URL区分单项与集合 理解等级:初级 普通读书笔记卡
  2. 嵌套端点避免传整份资源 理解等级:中级 普通读书笔记卡
  3. 动作可建模为嵌套资源 理解等级:中级 普通读书笔记卡
  4. 无状态请求便于横向扩展 理解等级:中级 普通读书笔记卡
  5. 可缓存响应减少重复计算 理解等级:中级 普通读书笔记卡
  6. 客户端与服务端分离演进 理解等级:中级 普通读书笔记卡
  7. 分层入口隐藏后端拓扑 理解等级:中级 普通读书笔记卡
  8. 按需代码是可选约束 理解等级:初级 普通读书笔记卡
  9. 统一接口保持资源标识稳定 理解等级:中级 普通读书笔记卡
  10. 超媒体链接引导后续操作 理解等级:中级 普通读书笔记卡
  11. 超媒体链接需权衡成本 理解等级:高级 普通读书笔记卡
  12. Richardson四级演进 理解等级:中级 普通读书笔记卡
  13. 成熟度模型不评接口质量 理解等级:高级 普通读书笔记卡
  14. HTTP方法表达资源操作 理解等级:初级 普通读书笔记卡
  15. 服务端选URI时用POST 理解等级:中级 普通读书笔记卡
  16. PUT全量替换PATCH局部改 理解等级:中级 普通读书笔记卡
  17. 状态码区分处理结果 理解等级:初级 普通读书笔记卡
  18. 成功码匹配实际结果 理解等级:中级 普通读书笔记卡
  19. 语法错误与语义错误分辨 理解等级:中级 普通读书笔记卡
  20. 认证失败与授权失败分开 理解等级:中级 普通读书笔记卡
  21. 服务端错误码按故障位置选 理解等级:中级 普通读书笔记卡
  22. 载荷与内容类型共同传数据 理解等级:初级 普通读书笔记卡
  23. GET请求体没有通用语义 理解等级:高级 普通读书笔记卡
  24. 错误响应需要可读原因 理解等级:中级 普通读书笔记卡
  25. 变更响应回显服务器状态 理解等级:中级 普通读书笔记卡
  26. 集合响应权衡完整与精简 理解等级:高级 普通读书笔记卡
  27. 查询参数过滤并分页 理解等级:中级 普通读书笔记卡

05 5 Documenting REST APIs with OpenAPI

13 张卡片

章节作用:由 JSON Schema 建立数据约束,再组合 OpenAPI 文档描述端点、参数、请求、响应和认证。

内容脉络:JSON Schema → OpenAPI 文档结构 → 端点与参数 → 请求和响应模型 → 复用定义与认证。

flowchart TD
  A[JSON Schema]
  A --> B[OpenAPI 文档结构]
  B --> C[端点与参数]
  C --> D[请求和响应模型]
  D --> E[复用定义与认证]

相关卡片:JSONSchema描述结构、数组items约束元素、属性格式细化基础类型、OpenAPI五部分分工、paths声明端点交互契约、operationId标识操作、参数声明标明位置与约束、请求体声明载荷结构、路径参数可供多方法共用、allOf组合兼容模型、按状态码描述响应、通用错误响应复用定义、认证方案写入OpenAPI

  1. JSONSchema描述结构 理解等级:初级 普通读书笔记卡
  2. 数组items约束元素 理解等级:中级 普通读书笔记卡
  3. 属性格式细化基础类型 理解等级:中级 普通读书笔记卡
  4. OpenAPI五部分分工 理解等级:中级 普通读书笔记卡
  5. paths声明端点交互契约 理解等级:中级 普通读书笔记卡
  6. operationId标识操作 理解等级:初级 普通读书笔记卡
  7. 参数声明标明位置与约束 理解等级:中级 普通读书笔记卡
  8. 请求体声明载荷结构 理解等级:中级 普通读书笔记卡
  9. 路径参数可供多方法共用 理解等级:中级 普通读书笔记卡
  10. allOf组合兼容模型 理解等级:高级 普通读书笔记卡
  11. 按状态码描述响应 理解等级:中级 普通读书笔记卡
  12. 通用错误响应复用定义 理解等级:中级 普通读书笔记卡
  13. 认证方案写入OpenAPI 理解等级:中级 普通读书笔记卡

06 6 Building REST APIs with Python

12 张卡片

章节作用:先以 FastAPI 实现订单 API,再用 Flask 生态构建厨房 API,比较契约生成、校验与序列化位置。

内容脉络:FastAPI 订单 API → 查询参数与未知字段 → 生成规范的设计修正 → Flask 与 flask-smorest → 请求校验、响应校验和内存示例。

flowchart TD
  A[FastAPI 订单 API]
  A --> B[查询参数与未知字段]
  B --> C[生成规范的设计修正]
  C --> D[Flask 与 flask-smorest]
  D --> E[请求校验、响应校验和内存示例]

相关卡片:类型标注接入查询参数、None区别未传与假值、宽容读取需权衡拼写风险、未知字段可配置拒绝、自动生成规范需对照设计、Flask框架组合能力、类视图封装同路径方法、蓝图集中注册路由、字段模型约束载荷、配置对象集中注入参数、查询参数按位置绑定模式、响应序列化前显式校验

  1. 类型标注接入查询参数 理解等级:中级 普通读书笔记卡
  2. None区别未传与假值 理解等级:中级 普通读书笔记卡
  3. 宽容读取需权衡拼写风险 理解等级:高级 普通读书笔记卡
  4. 未知字段可配置拒绝 理解等级:中级 普通读书笔记卡
  5. 自动生成规范需对照设计 理解等级:高级 普通读书笔记卡
  6. Flask框架组合能力 理解等级:中级 普通读书笔记卡
  7. 类视图封装同路径方法 理解等级:中级 普通读书笔记卡
  8. 蓝图集中注册路由 理解等级:中级 普通读书笔记卡
  9. 字段模型约束载荷 理解等级:中级 普通读书笔记卡
  10. 配置对象集中注入参数 理解等级:中级 普通读书笔记卡
  11. 查询参数按位置绑定模式 理解等级:中级 普通读书笔记卡
  12. 响应序列化前显式校验 理解等级:高级 普通读书笔记卡

07 7 Service implementation patterns for microservices

16 张卡片

章节作用:围绕六边形架构隔离业务核心,依次实现模型、仓储、业务层、工作单元并接通 API。

内容脉络:六边形架构和项目结构 → 数据库模型 → 仓储与数据访问 → 业务层和工作单元 → API 与服务层集成。

flowchart TD
  A[六边形架构和项目结构]
  A --> B[数据库模型]
  B --> C[仓储与数据访问]
  C --> D[业务层和工作单元]
  D --> E[API 与服务层集成]

相关卡片:六边形架构隔离核心、端口定义技术无关接口、依赖倒置让细节依赖抽象、ORM映射表与对象、迁移记录模式演进、一对多关系由外键连接、活动记录耦合业务与存储、仓储接口隔离存储细节、仓储不自行提交事务、仓储返回领域对象、控制反转由外部提供依赖、依赖注入让实现可替换、契约驱动模拟外部服务、异常类型区分失败来源、工作单元管理本地事务、上下文管理器包住资源生命周期

  1. 六边形架构隔离核心 理解等级:中级 普通读书笔记卡
  2. 端口定义技术无关接口 理解等级:中级 普通读书笔记卡
  3. 依赖倒置让细节依赖抽象 理解等级:高级 普通读书笔记卡
  4. ORM映射表与对象 理解等级:初级 普通读书笔记卡
  5. 迁移记录模式演进 理解等级:中级 普通读书笔记卡
  6. 一对多关系由外键连接 理解等级:初级 普通读书笔记卡
  7. 活动记录耦合业务与存储 理解等级:高级 普通读书笔记卡
  8. 仓储接口隔离存储细节 理解等级:中级 普通读书笔记卡
  9. 仓储不自行提交事务 理解等级:高级 普通读书笔记卡
  10. 仓储返回领域对象 理解等级:高级 普通读书笔记卡
  11. 控制反转由外部提供依赖 理解等级:中级 普通读书笔记卡
  12. 依赖注入让实现可替换 理解等级:中级 普通读书笔记卡
  13. 契约驱动模拟外部服务 理解等级:中级 普通读书笔记卡
  14. 异常类型区分失败来源 理解等级:中级 普通读书笔记卡
  15. 工作单元管理本地事务 理解等级:高级 普通读书笔记卡
  16. 上下文管理器包住资源生命周期 理解等级:中级 普通读书笔记卡

08 8 Designing GraphQL APIs

13 张卡片

章节作用:从产品 API 需求建立类型系统和对象关系,再定义查询与变更入口。

内容脉络:产品 API 与 GraphQL 模型 → 标量、对象与自定义类型 → 列表及对象关系 → 接口、联合和枚举 → Query 与 Mutation。

flowchart TD
  A[产品 API 与 GraphQL 模型]
  A --> B[标量、对象与自定义类型]
  B --> C[列表及对象关系]
  C --> D[接口、联合和枚举]
  D --> E[Query 与 Mutation]

相关卡片:SDL声明查询模式、标量定义字段值类型、感叹号声明非空字段、对象类型组合资源字段、自定义标量需实现行为、列表与元素分别约束非空、边字段连接对象类型、关系对象保存连接属性、接口与联合表达不同复用、枚举限制字段取值、Query根类型组织读取、输入类型聚合操作参数、Mutation根类型组织变更

  1. SDL声明查询模式 理解等级:初级 普通读书笔记卡
  2. 标量定义字段值类型 理解等级:初级 普通读书笔记卡
  3. 感叹号声明非空字段 理解等级:中级 普通读书笔记卡
  4. 对象类型组合资源字段 理解等级:初级 普通读书笔记卡
  5. 自定义标量需实现行为 理解等级:中级 普通读书笔记卡
  6. 列表与元素分别约束非空 理解等级:中级 普通读书笔记卡
  7. 边字段连接对象类型 理解等级:中级 普通读书笔记卡
  8. 关系对象保存连接属性 理解等级:中级 普通读书笔记卡
  9. 接口与联合表达不同复用 理解等级:高级 普通读书笔记卡
  10. 枚举限制字段取值 理解等级:初级 普通读书笔记卡
  11. Query根类型组织读取 理解等级:中级 普通读书笔记卡
  12. 输入类型聚合操作参数 理解等级:中级 普通读书笔记卡
  13. Mutation根类型组织变更 理解等级:中级 普通读书笔记卡

09 9 Consuming GraphQL APIs

13 张卡片

章节作用:从模拟服务和基本查询开始,扩展到错误、片段、变量、图导航、别名、变更及 Python 调用。

内容脉络:运行模拟服务 → 查询、参数与错误 → 片段和输入对象 → 关系导航、多根字段与别名 → 变更、变量和 HTTP 调用。

flowchart TD
  A[运行模拟服务]
  A --> B[查询、参数与错误]
  B --> C[片段和输入对象]
  C --> D[关系导航、多根字段与别名]
  D --> E[变更、变量和 HTTP 调用]

相关卡片:模拟服务先验证契约、选择集明确返回字段、响应分别承载数据与错误、内联片段按实际类型选字段、命名片段复用字段选择、输入对象传递成组过滤条件、嵌套选择沿对象关系取值、同一操作可请求多个根字段、别名区分同字段不同参数、字段参数用括号传入、变更操作用mutation声明、变量把操作与参数值分开、HTTP请求承载查询文档

  1. 模拟服务先验证契约 理解等级:中级 普通读书笔记卡
  2. 选择集明确返回字段 理解等级:初级 普通读书笔记卡
  3. 响应分别承载数据与错误 理解等级:中级 普通读书笔记卡
  4. 内联片段按实际类型选字段 理解等级:中级 普通读书笔记卡
  5. 命名片段复用字段选择 理解等级:中级 普通读书笔记卡
  6. 输入对象传递成组过滤条件 理解等级:中级 普通读书笔记卡
  7. 嵌套选择沿对象关系取值 理解等级:中级 普通读书笔记卡
  8. 同一操作可请求多个根字段 理解等级:中级 普通读书笔记卡
  9. 别名区分同字段不同参数 理解等级:中级 普通读书笔记卡
  10. 字段参数用括号传入 理解等级:初级 普通读书笔记卡
  11. 变更操作用mutation声明 理解等级:中级 普通读书笔记卡
  12. 变量把操作与参数值分开 理解等级:中级 普通读书笔记卡
  13. HTTP请求承载查询文档 理解等级:中级 普通读书笔记卡

10 10 Building GraphQL APIs with Python

12 张卡片

章节作用:依据模式分析实现责任,再用 Ariadne 绑定查询、对象类型、输入、变更、自定义标量和字段解析器。

内容脉络:需求与技术栈 → 模式和项目入口 → 查询及类型解析器 → 参数与变更 → 自定义标量和字段解析。

flowchart TD
  A[需求与技术栈]
  A --> B[模式和项目入口]
  B --> C[查询及类型解析器]
  C --> D[参数与变更]
  D --> E[自定义标量和字段解析]

相关卡片:先由模式列出实现职责、解析器提供字段实际值、可执行模式绑定定义与解析器、解析器按责任拆分模块、返回值须满足模式形状、联合类型需判定具体成员、输入对象进入解析器参数、分页换算起点索引、变更解析器按契约写入、自定义标量需双向转换、字段解析映射内部引用、字段解析器复用有追踪代价

  1. 先由模式列出实现职责 理解等级:中级 普通读书笔记卡
  2. 解析器提供字段实际值 理解等级:初级 普通读书笔记卡
  3. 可执行模式绑定定义与解析器 理解等级:中级 普通读书笔记卡
  4. 解析器按责任拆分模块 理解等级:中级 普通读书笔记卡
  5. 返回值须满足模式形状 理解等级:中级 普通读书笔记卡
  6. 联合类型需判定具体成员 理解等级:中级 普通读书笔记卡
  7. 输入对象进入解析器参数 理解等级:中级 普通读书笔记卡
  8. 分页换算起点索引 理解等级:中级 普通读书笔记卡
  9. 变更解析器按契约写入 理解等级:中级 普通读书笔记卡
  10. 自定义标量需双向转换 理解等级:中级 普通读书笔记卡
  11. 字段解析映射内部引用 理解等级:中级 普通读书笔记卡
  12. 字段解析器复用有追踪代价 理解等级:高级 普通读书笔记卡

11 11 API authorization and authentication

21 张卡片

章节作用:先区分认证和授权及协议角色,再验证令牌并通过中间件、CORS 和资源所有权控制访问。

内容脉络:OAuth 与 OIDC → JWT 结构、声明和验证 → 授权中间件与 CORS → 用户关联与资源级授权。

flowchart TD
  A[OAuth 与 OIDC]
  A --> B[JWT 结构、声明和验证]
  B --> C[授权中间件与 CORS]
  C --> D[用户关联与资源级授权]

相关卡片:认证与授权回答不同问题、OAuth委托访问无需交密码、OAuth四种角色各司其职、PKCE用校验值绑定授权码、客户端凭证适合服务身份、刷新令牌换取新访问令牌、OIDC承载身份认证、身份令牌不能充当访问令牌、JWT三段承载元数据与声明、验证令牌声明需看受众与期限、OIDC发现文档公布端点、解码令牌不等于验证令牌、验签与声明校验缺一不可、鉴权中间件统一拦截请求、CORS预检不携带身份凭据、Bearer令牌置于授权头、CORS允许来源应收窄、登录成功仍需资源级授权、跨服务用不透明用户ID关联、资源查询同时限定所有者、隐藏资源存在性可返回404

  1. 认证与授权回答不同问题 理解等级:初级 普通读书笔记卡
  2. OAuth委托访问无需交密码 理解等级:初级 普通读书笔记卡
  3. OAuth四种角色各司其职 理解等级:初级 普通读书笔记卡
  4. PKCE用校验值绑定授权码 理解等级:中级 普通读书笔记卡
  5. 客户端凭证适合服务身份 理解等级:中级 普通读书笔记卡
  6. 刷新令牌换取新访问令牌 理解等级:中级 普通读书笔记卡
  7. OIDC承载身份认证 理解等级:初级 普通读书笔记卡
  8. 身份令牌不能充当访问令牌 理解等级:中级 普通读书笔记卡
  9. JWT三段承载元数据与声明 理解等级:初级 普通读书笔记卡
  10. 验证令牌声明需看受众与期限 理解等级:中级 普通读书笔记卡
  11. OIDC发现文档公布端点 理解等级:中级 普通读书笔记卡
  12. 解码令牌不等于验证令牌 理解等级:中级 普通读书笔记卡
  13. 验签与声明校验缺一不可 理解等级:中级 普通读书笔记卡
  14. 鉴权中间件统一拦截请求 理解等级:中级 普通读书笔记卡
  15. CORS预检不携带身份凭据 理解等级:中级 普通读书笔记卡
  16. Bearer令牌置于授权头 理解等级:初级 普通读书笔记卡
  17. CORS允许来源应收窄 理解等级:中级 普通读书笔记卡
  18. 登录成功仍需资源级授权 理解等级:中级 普通读书笔记卡
  19. 跨服务用不透明用户ID关联 理解等级:中级 普通读书笔记卡
  20. 资源查询同时限定所有者 理解等级:中级 普通读书笔记卡
  21. 隐藏资源存在性可返回404 理解等级:高级 普通读书笔记卡

12 12 Testing and validating APIs

13 张卡片

章节作用:从规范驱动的 Dredd 测试扩展到性质测试和状态化接口测试,最后讨论测试策略的覆盖边界。

内容脉络:Dredd 契约测试与钩子 → 性质测试和 Hypothesis → Schemathesis 与 OpenAPI links → GraphQL 测试 → 测试策略与断言边界。

flowchart TD
  A[Dredd 契约测试与钩子]
  A --> B[性质测试和 Hypothesis]
  B --> C[Schemathesis 与 OpenAPI links]
  C --> D[GraphQL 测试]
  D --> E[测试策略与断言边界]

相关卡片:规范驱动测试检查接口契约、Dredd遍历规范中的端点、测试夹具定义可重复前提、测试钩子串联资源生命周期、负向用例需构造无效输入、契约工具默认用例有边界、性质测试由规则生成输入、策略组合构造复杂载荷、规范可作输入有效性判据、OpenAPI链接描述后续操作、状态化测试验证资源链路、通过测试须核对检查范围、GraphQL模式驱动查询测试

  1. 规范驱动测试检查接口契约 理解等级:中级 普通读书笔记卡
  2. Dredd遍历规范中的端点 理解等级:初级 普通读书笔记卡
  3. 测试夹具定义可重复前提 理解等级:初级 普通读书笔记卡
  4. 测试钩子串联资源生命周期 理解等级:中级 普通读书笔记卡
  5. 负向用例需构造无效输入 理解等级:中级 普通读书笔记卡
  6. 契约工具默认用例有边界 理解等级:高级 普通读书笔记卡
  7. 性质测试由规则生成输入 理解等级:初级 普通读书笔记卡
  8. 策略组合构造复杂载荷 理解等级:中级 普通读书笔记卡
  9. 规范可作输入有效性判据 理解等级:中级 普通读书笔记卡
  10. OpenAPI链接描述后续操作 理解等级:中级 普通读书笔记卡
  11. 状态化测试验证资源链路 理解等级:中级 普通读书笔记卡
  12. 通过测试须核对检查范围 理解等级:高级 普通读书笔记卡
  13. GraphQL模式驱动查询测试 理解等级:中级 普通读书笔记卡

13 13 Dockerizing microservice APIs

9 张卡片

章节作用:从镜像构建和容器运行推进到 Compose 协作,再发布镜像;同时暴露配置和秘密管理边界。

内容脉络:构建微服务镜像 → 容器运行和配置 → Compose 连接服务与持久化 → 发布到镜像仓库。

flowchart TD
  A[构建微服务镜像]
  A --> B[容器运行和配置]
  B --> C[Compose 连接服务与持久化]
  C --> D[发布到镜像仓库]

相关卡片:镜像与容器分开构建运行、环境变量注入数据库连接、依赖先于源码构建镜像、私钥不得随应用镜像分发、端口映射让主机访问容器、Compose用服务名连数据库、命名卷保存数据库状态、迁移是服务可用前置步骤、镜像标签指向目标仓库

  1. 镜像与容器分开构建运行 理解等级:初级 普通读书笔记卡
  2. 环境变量注入数据库连接 理解等级:中级 普通读书笔记卡
  3. 依赖先于源码构建镜像 理解等级:中级 普通读书笔记卡
  4. 私钥不得随应用镜像分发 理解等级:高级 普通读书笔记卡
  5. 端口映射让主机访问容器 理解等级:中级 普通读书笔记卡
  6. Compose用服务名连数据库 理解等级:中级 普通读书笔记卡
  7. 命名卷保存数据库状态 理解等级:中级 普通读书笔记卡
  8. 迁移是服务可用前置步骤 理解等级:高级 普通读书笔记卡
  9. 镜像标签指向目标仓库 理解等级:中级 普通读书笔记卡

14 14 Deploying microservice APIs with Kubernetes

20 张卡片

章节作用:由集群和云身份配置推进到工作负载、服务路由、数据库与秘密,再完成迁移、入口更新和清理。

内容脉络:Kubernetes 与 EKS 基础 → 云身份和负载均衡 → Deployment、Service 与 Ingress → 数据库、Secret 和迁移 → API 地址更新与资源清理。

flowchart TD
  A[Kubernetes 与 EKS 基础]
  A --> B[云身份和负载均衡]
  B --> C[Deployment、Service 与 Ingress]
  C --> D[数据库、Secret 和迁移]
  D --> E[API 地址更新与资源清理]

相关卡片:容器编排维护应用运行、控制平面协调集群状态、Pod封装协同容器、工作负载类型匹配运行方式、副本集维持期望Pod数、命名空间划定资源名称范围、基础设施模板记录期望资源、服务账号关联云端权限、入口控制器落实路由规则、部署清单声明Pod期望态、标签选择器须匹配模板、服务与入口分层路由、数据库置于私有子网、数据库入站权限应收窄、信封加密分离数据与主密钥、Secret编码不等于加密、工作负载按需引用Secret、Job执行一次性数据库迁移、OpenAPI地址随环境配置、清理云资源按依赖逆序

  1. 容器编排维护应用运行 理解等级:中级 普通读书笔记卡
  2. 控制平面协调集群状态 理解等级:初级 普通读书笔记卡
  3. Pod封装协同容器 理解等级:初级 普通读书笔记卡
  4. 工作负载类型匹配运行方式 理解等级:中级 普通读书笔记卡
  5. 副本集维持期望Pod数 理解等级:中级 普通读书笔记卡
  6. 命名空间划定资源名称范围 理解等级:中级 普通读书笔记卡
  7. 基础设施模板记录期望资源 理解等级:中级 普通读书笔记卡
  8. 服务账号关联云端权限 理解等级:高级 普通读书笔记卡
  9. 入口控制器落实路由规则 理解等级:中级 普通读书笔记卡
  10. 部署清单声明Pod期望态 理解等级:中级 普通读书笔记卡
  11. 标签选择器须匹配模板 理解等级:中级 普通读书笔记卡
  12. 服务与入口分层路由 理解等级:中级 普通读书笔记卡
  13. 数据库置于私有子网 理解等级:中级 普通读书笔记卡
  14. 数据库入站权限应收窄 理解等级:高级 普通读书笔记卡
  15. 信封加密分离数据与主密钥 理解等级:中级 普通读书笔记卡
  16. Secret编码不等于加密 理解等级:高级 普通读书笔记卡
  17. 工作负载按需引用Secret 理解等级:中级 普通读书笔记卡
  18. Job执行一次性数据库迁移 理解等级:中级 普通读书笔记卡
  19. OpenAPI地址随环境配置 理解等级:中级 普通读书笔记卡
  20. 清理云资源按依赖逆序 理解等级:高级 普通读书笔记卡

A Types of web APIs and protocols

5 张卡片
  1. RPC按过程调用远端能力 理解等级:初级 普通读书笔记卡
  2. JSON-RPC方法与ID关联 理解等级:中级 普通读书笔记卡
  3. SOAP信封包裹消息内容 理解等级:初级 普通读书笔记卡
  4. gRPC由模式生成通信桩 理解等级:中级 普通读书笔记卡
  5. API协议按消费者约束选 理解等级:高级 普通读书笔记卡

B Managing an API’s life cycle

5 张卡片
  1. 破坏性改动须管理版本 理解等级:高级 普通读书笔记卡
  2. 日历版本体现发布时点 理解等级:初级 普通读书笔记卡
  3. URL与媒体类型可承载版本 理解等级:高级 普通读书笔记卡
  4. 弃用与下线是两个时点 理解等级:中级 普通读书笔记卡
  5. 退役端点按去向选状态码 理解等级:中级 普通读书笔记卡

C API authorization using an identity provider

2 张卡片
  1. 身份服务托管账户与发令牌 理解等级:中级 普通读书笔记卡
  2. 令牌kid选择对应验签公钥 理解等级:中级 普通读书笔记卡

第IFC章 封二 API 优先开发说明

0 张卡片

章节作用:以 API 契约先行作为全书实践入口,说明文档、实现与验证三者如何衔接。

内容脉络:先定义契约 → 分别实现两端 → 按契约验证。

flowchart TD
  A[先定义契约]
  A --> B[分别实现两端]
  B --> C[按契约验证]

相关卡片:文档驱动开发、单项与集合端点、HTTP方法与状态码分工

第P1章 Part 1. Introducing Microservice APIs

0 张卡片

章节作用:建立微服务 API 的问题背景,并引出分布式协作收益与运维代价。

内容脉络:微服务与 API → 分布式协作难题 → 文档驱动开发。

flowchart TD
  A[微服务与 API]
  A --> B[分布式协作难题]
  B --> C[文档驱动开发]

相关卡片:微服务独立部署、微服务的运维代价

第P2章 Part 2. Designing and building REST APIs

0 张卡片

章节作用:从 REST 约束逐步走到 OpenAPI 契约、Python 实现和服务内部架构。

内容脉络:REST 设计原则 → 契约描述与工具支持 → Python 实现 → 服务内部模式。

flowchart TD
  A[REST 设计原则]
  A --> B[契约描述与工具支持]
  B --> C[Python 实现]
  C --> D[服务内部模式]

相关卡片:无(本章无合格知识卡)

第P3章 Part 3. Designing and building GraphQL APIs

0 张卡片

章节作用:由 GraphQL 模式设计推进到查询消费和 Python 服务实现。

内容脉络:GraphQL 类型与操作 → 客户端查询和变更 → 解析器实现。

flowchart TD
  A[GraphQL 类型与操作]
  A --> B[客户端查询和变更]
  B --> C[解析器实现]

相关卡片:GraphQL按需查询字段

第P4章 Part 4. Securing, testing, and deploying microservice APIs

0 张卡片

章节作用:把 API 生命周期的运行保障串成身份与资源授权、契约测试、容器交付和集群部署。

内容脉络:身份与访问控制 → 接口验证 → 容器交付 → 集群运行。

flowchart TD
  A[身份与访问控制]
  A --> B[接口验证]
  B --> C[容器交付]
  C --> D[集群运行]

相关卡片:API经济以接口交付能力

第A章 Appendix A. Types of web APIs and protocols

0 张卡片

章节作用:沿 API 演化脉络比较 RPC 家族、SOAP、gRPC、REST 与 GraphQL 的交互和取舍。

内容脉络:RPC 与消息格式 → SOAP 标准 → gRPC → REST → GraphQL。

flowchart TD
  A[RPC 与消息格式]
  A --> B[SOAP 标准]
  B --> C[gRPC]
  C --> D[REST]
  D --> E[GraphQL]

相关卡片:RPC按过程调用远端能力、JSON-RPC方法与ID关联、SOAP信封包裹消息内容、gRPC由模式生成通信桩、API协议按消费者约束选

第B章 Appendix B. Managing an API’s life cycle

0 张卡片

章节作用:说明 API 演进中的版本策略,以及弃用到退役的生命周期管理。

内容脉络:破坏性变更与版本策略 → 弃用、迁移和下线。

flowchart TD
  A[破坏性变更与版本策略]
  A --> B[弃用、迁移和下线]

相关卡片:破坏性改动须管理版本、日历版本体现发布时点、URL与媒体类型可承载版本、弃用与下线是两个时点、退役端点按去向选状态码

第C章 Appendix C. API authorization using an identity provider

0 张卡片

章节作用:以托管身份服务为基础,依次展示 PKCE、客户端凭证和 Swagger UI 授权接入。

内容脉络:身份服务与密钥发现 → PKCE 授权码流程 → 客户端凭证流程 → 交互式 API 授权。

flowchart TD
  A[身份服务与密钥发现]
  A --> B[PKCE 授权码流程]
  B --> C[客户端凭证流程]
  C --> D[交互式 API 授权]

相关卡片:身份服务托管账户与发令牌、令牌kid选择对应验签公钥

第IBC章 封三六边形架构说明

0 张卡片

章节作用:以封底短文回扣六边形架构将领域逻辑与外部技术适配器隔离的主张;没有独立知识卡。

内容脉络:领域核心 → 端口与适配器 → 技术细节隔离。

flowchart TD
  A[领域核心]
  A --> B[端口与适配器]
  B --> C[技术细节隔离]

相关卡片:无(本章无合格知识卡)

全书概览

Microservice APIs

Skill 版本:v10 作者/版次:José Haro Peralta;Manning,版权页 ©2023;ISBN 9781617298417 类别:系统架构类(S2 完成时复核)

整体评级

四象限结论:工程实践(高信息浓度 + 低稳定性)。 评级依据:第 1、3、4 章讨论微服务边界与 REST 设计约束,第 8、11 章讨论 GraphQL 与授权,具有可迁移的设计理由;第 6、10、12–14 章大量使用 Python 框架、测试工具、Docker、Kubernetes 和 AWS EKS 的当时实现,具体行为依赖版本。此评级已结合全书正文逐单元阅读核对;版本敏感的实现细节按原书年代解释,不视为当前部署建议。

来源与阅读计划

  • 原书:books/20260910/Microservice APIs Using Python, Flask, FastAPI, OpenAPI and more.epub;SHA-256 6c6347bcb6e17e1df5f3dcd38efe8ff2793262aad937d343e15d0bbba4af1428。
  • 解包:_epub-src/;与原 EPUB 成员逐字节匹配;清单见 _source-manifest.json;聚合 SHA-256 445201a9bcd1a06d401bacf903bf6901f74bd6b9a19054013c45083d76b6f217。
  • 30 个 spine 项中 24 项含正文或技术论述,均列入阅读计划;203 个阅读单元已逐一记录去向。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
IFC 封二 API 优先开发说明 done 3
00 前言与导读 done 0
P1 Part 1. Introducing Microservice APIs done 2
01 1 What are microservice APIs? done 20
02 2 A basic API implementation done 18
03 3 Designing microservices done 12
P2 Part 2. Designing and building REST APIs done 0
04 4 Principles of REST API design done 27
05 5 Documenting REST APIs with OpenAPI done 13
06 6 Building REST APIs with Python done 12
07 7 Service implementation patterns for microservices done 16
P3 Part 3. Designing and building GraphQL APIs done 1
08 8 Designing GraphQL APIs done 13
09 9 Consuming GraphQL APIs done 13
10 10 Building GraphQL APIs with Python done 12
P4 Part 4. Securing, testing, and deploying microservice APIs done 1
11 11 API authorization and authentication done 21
12 12 Testing and validating APIs done 13
13 13 Dockerizing microservice APIs done 9
14 14 Deploying microservice APIs with Kubernetes done 20
A Appendix A. Types of web APIs and protocols done 5
B Appendix B. Managing an API’s life cycle done 5
C Appendix C. API authorization using an identity provider done 2
IBC 封三六边形架构说明 done 0

非正文排除

spine项 类型 排除理由
1 / titlepage.xhtml 非正文 封面题名页
3 / OEBPS/Text/title.htm 非正文 题名页
4 / OEBPS/Text/copyright.htm 非正文 版权页
5 / OEBPS/Text/dedication.htm 非正文 献辞,无技术论述
6 / OEBPS/Text/toc.htm 非正文 目录导航
29 / OEBPS/Text/index.htm 非正文 字母索引,无连续论述

待关联术语

术语名 出现章节 一句话语境
通用子域(generic subdomain) 3 与核心领域、支撑子域一并被列出,但本章没有解释其判别标准。
门面模式(facade pattern) 7 被提为封装外部 API 调用的候选适配方式,此处未展开构造与取舍。

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境
Building Microservices 书 1 用 Newman 的简短定义引入微服务;脚注供进一步阅读,未在此独立介绍全书。
Microservices Patterns 书 1 引用“分布式单体”及服务通信讨论,未展开此书具体模式。
Strategic Monoliths and Microservices 书 1 脚注推荐作为单体与微服务战略取舍的延伸阅读。
Microservices: Yesterday, Today, and Tomorrow 论文 1 脚注推荐作为微服务历史及前身的延伸阅读。
Design Patterns 书 2、7 脚注引用设计模式及门面模式的延伸资料,本书未独立介绍该书内容。
Fluent Python 书 2、7 脚注引用 Python 编程与上下文管理器的延伸资料,本书未独立介绍该书内容。
Domain-Driven Design 书 3 Eric Evans 的著作被作为 DDD 方法来源提及,本章只概述其方法而未复述该书。
Architectural Styles and the Design of Network-based Software Architectures 论文 4 Fielding 的博士论文被作为 REST 术语来源,未在此独立阅读全文。
REST APIs Must Be Hypertext-Driven 文章 4 引为 HATEOAS 观点来源;本章只转述其关联链接主张,未复述全文。
HTTP/1.1 Semantics and Content(RFC 7231) 规范 4 书中引用 PUT 与 POST 的语义依据;只按书中版本保留,不推断当前规范状态。
JavaScript Object Notation (JSON) Patch(RFC 6902) 规范 4 书中引用 JSON Patch 格式来源,未独立阅读全文。
2022 State of the API Report 报告 4、5 脚注用于描述当时 REST 与 OpenAPI 使用情况;时效性数字未作为当前事实使用。
REST API Design—Resource Modeling 文章 4 脚注推荐作资源建模的延伸阅读,未在本书中复述全文。
Justice Will Take Us Millions of Intricate Moves 演讲 4 脚注注明 Richardson 模型的演讲来源,未独立阅读。
Managing the Data-Base Environment 书 4 脚注引为 CRUD 缩写的历史来源,未在正文展开。
How Bad Models Ruin an API (or Why Design-First is the Way to Go) 文章 4 脚注推荐 API 反模式延伸阅读,未在本章展开。
JSON Schema: A Media Type for Describing JSON Documents 规范草案 5 脚注列为 JSON Schema 的进一步资料;本章只用其模式概念。
Migrating from OpenAPI 3.0 to 3.1 指南 5 脚注推荐版本迁移说明;未将书中版本选择当成当前生态事实。
Swagger Components Documentation 官方文档 5 脚注给出可复用 components 的完整列表;正文只示范模式和响应。
OpenAPI 3.1 Data Types 规范 5 脚注用于扩展查看数据类型与格式,未独立复述。
A Universally Unique Identifier (UUID) URN Namespace(RFC 4122) 规范 5 脚注用于解释 UUID 标识,未展开该规范。
Swagger Authentication Documentation 官方文档 5 脚注用于进一步查看认证方案,正文仅展示示例声明。
Hexagonal Architecture 文章 7 Cockburn 原文被引为六边形架构来源;本章解释架构概念,但未复述文章全文。
Agile Software Development, Principles, Patterns, and Practices 书 7 脚注引用依赖倒置原则的延伸资料,未独立介绍该书。
Head First Design Patterns 书 7 脚注推荐依赖倒置的入门阅读,未在正文展开该书内容。
Patterns of Enterprise Architecture 书 7 脚注引用数据映射、活动记录、工作单元等模式出处;正文解释模式,未复述该书。
Inversion of Control Containers and the Dependency Injection pattern 文章 7 Fowler 文章被列为控制反转与依赖注入的延伸资料,未复述其内容。
Learning GraphQL, Declarative Data Fetching for Modern Web Apps 书 8 脚注引用 GraphQL 与 SQL 的类比及图关系背景;本章未独立介绍该书。
Uniform Resource Identifier (URI): Generic Syntax(RFC 3986) 规范 9 脚注引用百分号编码的规范来源;本章只应用 URL 编码概念。
OAuth 2.0 Security Best Current Practice 规范 11 引为 OAuth 流程安全建议,正文未系统展开完整规范。
The OAuth 2.1 Authorization Framework 规范草案 11 书中将其称为当时最新 OAuth 版本;版本状态须另行核验。
Proof Key for Code Exchange by OAuth Public Clients(RFC 7636) 规范 11 PKCE 流程来源;本轮已对照官方 RFC 校正书中请求顺序错误。
OpenID Connect in Action 书 11 脚注推荐继续阅读 OIDC,正文未介绍该书内容。
Real-World Cryptography 书 11 脚注推荐 HMAC 与 RSA 延伸阅读,未介绍该书。
JSON Web Token(RFC 7519) 规范 11 JWT 格式及声明的来源;本轮按官方 RFC 排除“签名即加密”的误述。
Pattern: API Gateway/Backends for Frontends 文章 11 脚注列为 API 网关的延伸材料,未复述全文。
USPS Site Exposed Data on 60 Million Users 文章 11 引为开篇安全案例;数字未在本轮独立核验,不作为当前统计。
API Attack Traffic Grew 300+% In the Last Six Months 文章 11 引为当时攻击趋势案例;未将其当作当前趋势。
60 Percent of Small Businesses Fold Within 6 Months of a Cyber Attack 文章 11 引为当时风险统计;未独立核验或作为当前事实。
Testing Web APIs 书 12 脚注推荐安全测试章节,本章未展开该书。
Hacking APIs 书 12 脚注推荐 API 安全测试延伸资料,本章未展开该书。
What is Property Based Testing? 文章 12 脚注推荐性质测试概念延伸阅读,未复述全文。
OpenAPI Links Documentation 官方文档 12 脚注推荐查看 links 语法,本章只示范订单链路。
API Development Workflows for Successful Integrations 演讲 12 推荐将 API 测试接入 CI 的延伸案例,未展开演讲内容。
Microservices Security in Action 书 13 引用其 Docker Fundamentals 章节供进一步阅读,未复述全书。
Docker in Practice 书 13 作为进一步了解容器技术的延伸书目,未在本章展开。
Docker in Action 书 13 作为进一步了解容器技术的延伸书目,未在本章展开。
Core Kubernetes 书 14 用于延伸学习控制平面,未在本章介绍全书。
Networking and Kubernetes: A Layered Approach 书 14 用于延伸学习集群网络,未在本章介绍全书。
Kubernetes in Action (2nd ed.) 书 14 章末推荐延伸阅读,未在本章介绍全书。
2022 State of the Cloud Report 报告 14 用于当时托管 Kubernetes 采用率,未作为当前市场数据。
Securing Kubernetes Secrets 书 14 推荐进一步阅读 Secret 安全,未在本书独立展开。
How to use AWS Secrets & Configuration Provider with Your Kubernetes Secrets Store CSI driver 文章 14 EKS 秘密管理延伸资料,未在本书展开。
Implementing Remote Procedure Calls 论文 附录 A 脚注列作 RPC 实现要求的延伸阅读,未在本书阅读全文。
The Deprecation HTTP Header Field(草案) 规范草案 附录 B 原书引用当时草案;当前语法需按 RFC 9745 核验。
The Sunset HTTP Header Field(RFC 8594) 规范 附录 B 原书引用 Sunset 响应头来源,未阅读全文。

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明
已付款订单状态未更新 支付成功后订单状态未更新 — 1 支付与订单状态跨服务执行,支付成功不保证后续状态同步;原文此处无具体解法。
付款失败后库存仍占用 付款失败后库存仍占用 付款失败回退库存 1 库存先变更而支付后失败,需撤回该次库存更新;原文未给出具体协议。

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 追踪接口契约与测试 实现深读 done 5 源码映射、请求链路及未映射清单
002 核查镜像中的签名私钥 证据验证 done 13 秘密流向表与替代部署检查清单

类别清单核对

维度 覆盖状态(已覆盖/补充生成/未覆盖) 关联卡片标题或未覆盖理由
服务拆分原则 已覆盖 [[服务拆分界定职责边界]]、[[独立变化检验服务耦合]];第 3 章按职责和变化边界判断拆分。
通信机制 未覆盖 [[Web API以HTTP传输]]、[[API协议按消费者约束选]]讲 HTTP 与 API 协议选择;原书没有实质比较跨服务同步请求与异步消息机制的取舍。第 7 章的同步/异步表述仅涉及本地工作单元操作顺序,不可移作跨服务通信结论。
一致性与事务权衡 已覆盖 [[跨服务事务需要协调]]、[[付款失败回退库存]]、[[工作单元管理本地事务]];书中提出跨服务协调及补偿需求,但未给出完整协议,卡片保留此边界。
可观测性设计 已覆盖 [[跨服务追踪定位故障]]、[[微服务的运维代价]];书中提出分布式日志、追踪和监控要求,未展开指标体系或埋点方案。
容错设计 已覆盖 [[服务故障沿调用链传播]]、[[服务端错误码按故障位置选]];原文提到超时后的重试或有意义回应,未系统讲熔断、降级实现。
扩展性瓶颈与应对 已覆盖 [[无状态请求便于横向扩展]]、[[副本集维持期望Pod数]]、[[微服务的运维代价]];覆盖无状态复制与独立扩容,未给容量建模。
部署与发布策略 已覆盖 [[容器编排维护应用运行]]、[[部署清单声明Pod期望态]]、[[契约测试纳入持续集成]];书中提滚动更新与回滚能力,但无灰度发布实作。

类别判定:第 1、3、4、8、13、14 章跨设计、通信接口与部署,主要讨论微服务 API 整体架构,不限单一框架;仍以书中实际覆盖边界作记录。

主题索引维护

已对当前 238 张稳定知识卡建立逐卡主题候选。用户已同意创建 GraphQL、OpenAPI 与 Python Web API 三个主题;下表记录全部 238 张卡片的最终主题结论。

卡片标题 结论 候选主题或原因
文档驱动开发 无需加入 现有主题范围不精确覆盖本卡聚焦的“文档驱动开发”
单项与集合端点 已复用 notes/_topics/rpc-rest-api.md
HTTP方法与状态码分工 已复用 notes/_topics/rpc-rest-api.md
微服务独立部署 已复用 notes/_topics/microservice-boundaries-evolution.md
微服务的运维代价 已复用 notes/_topics/microservice-boundaries-evolution.md
GraphQL按需查询字段 已创建 notes/_topics/graphql-schema-query-execution.md
API经济以接口交付能力 无需加入 API作为商业能力的交付与消费;现有REST主题聚焦协议设计,不覆盖经济机制。
单体应用整体部署 已复用 notes/_topics/microservice-boundaries-evolution.md
紧耦合依赖实现细节 已复用 notes/_topics/microservice-boundaries-evolution.md
单体增长放大发布范围 已复用 notes/_topics/microservice-boundaries-evolution.md
服务数据由接口封装 已复用 notes/_topics/remote-interface-distribution.md
API是程序化接口 已复用 notes/_topics/remote-interface-distribution.md
Web API以HTTP传输 已复用 notes/_topics/remote-interface-distribution.md
API规范约束两端 已复用 notes/_topics/remote-interface-distribution.md
智能端点与简单管道 已复用 notes/_topics/microservice-boundaries-evolution.md
稳定接口支撑替换实现 已复用 notes/_topics/remote-interface-distribution.md
分布式单体的联动变更 已复用 notes/_topics/microservice-boundaries-evolution.md
集成测试分层验证 已复用 notes/_topics/testing-effectiveness.md
服务故障沿调用链传播 无需加入 现有主题范围不精确覆盖本卡聚焦的“服务故障沿调用链传播”
跨服务事务需要协调 已复用 notes/_topics/distributed-transactions.md
支付成功后订单状态未更新 已复用 notes/_topics/distributed-transactions.md
跨服务追踪定位故障 已复用 notes/_topics/logging-observability.md
API设计纳入消费者 已复用 notes/_topics/remote-interface-distribution.md
接口描述语言支撑工具链 已复用 notes/_topics/remote-interface-distribution.md
付款失败后库存仍占用 已复用 notes/_topics/distributed-transactions.md
付款失败回退库存 已复用 notes/_topics/distributed-transactions.md
契约测试纳入持续集成 已复用 notes/_topics/testing-effectiveness.md
路径与方法共同定端点 已复用 notes/_topics/rpc-rest-api.md
Schema约束请求载荷 已创建 notes/_topics/openapi-contract-schema-validation.md
服务三层职责分离 已复用 notes/_topics/layered-architecture-ports.md
FastAPI组合框架能力 已创建 notes/_topics/python-web-api-framework-practice.md
锁文件固定依赖版本 无需加入 Python依赖复现的构建细节;现有接口与容器主题不覆盖锁文件机制。
装饰器绑定请求路由 已创建 notes/_topics/python-web-api-framework-practice.md
路径参数可声明类型 已创建 notes/_topics/python-web-api-framework-practice.md
Swagger UI交互试调 已创建 notes/_topics/openapi-contract-schema-validation.md
对象编组为可传输结构 已复用 notes/_topics/remote-interface-distribution.md
Schema引用复用子模型 已创建 notes/_topics/openapi-contract-schema-validation.md
pydantic映射契约约束 已创建 notes/_topics/python-web-api-framework-practice.md
类型注解接入载荷校验 已创建 notes/_topics/python-web-api-framework-practice.md
错误路径定位缺失字段 已创建 notes/_topics/python-web-api-framework-practice.md
未知字段可能掩盖拼写错误 已创建 notes/_topics/python-web-api-framework-practice.md
可选字段不等于可为null 已创建 notes/_topics/python-web-api-framework-practice.md
出站响应也要按模型验证 已创建 notes/_topics/python-web-api-framework-practice.md
内存列表仅模拟订单状态 无需加入 书中教学存储替身的局限;现有跨书主题不宜收录这条局部示例边界。
资源不存在返回404 已复用 notes/_topics/rpc-rest-api.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/microservice-boundaries-evolution.md
业务能力映射组织团队 已复用 notes/_topics/microservice-boundaries-evolution.md
产品库存边界需要合并 已复用 notes/_topics/microservice-boundaries-evolution.md
领域语言消除概念歧义 已复用 notes/_topics/ddd-strategic-design.md
核心领域指向价值活动 已复用 notes/_topics/ddd-strategic-design.md
战略设计协调多个模型 已复用 notes/_topics/microservice-boundaries-evolution.md
沿业务流程识别子域 已复用 notes/_topics/ddd-strategic-design.md
两种拆分视角互相校验 已复用 notes/_topics/microservice-boundaries-evolution.md
资源URL区分单项与集合 已复用 notes/_topics/rpc-rest-api.md
嵌套端点避免传整份资源 已复用 notes/_topics/rpc-rest-api.md
动作可建模为嵌套资源 已复用 notes/_topics/rpc-rest-api.md
无状态请求便于横向扩展 已复用 notes/_topics/rpc-rest-api.md
可缓存响应减少重复计算 已复用 notes/_topics/rpc-rest-api.md
客户端与服务端分离演进 已复用 notes/_topics/rpc-rest-api.md
分层入口隐藏后端拓扑 已复用 notes/_topics/rpc-rest-api.md
按需代码是可选约束 已复用 notes/_topics/rpc-rest-api.md
统一接口保持资源标识稳定 已复用 notes/_topics/rpc-rest-api.md
超媒体链接引导后续操作 已复用 notes/_topics/rpc-rest-api.md
超媒体链接需权衡成本 已复用 notes/_topics/rpc-rest-api.md
Richardson四级演进 已复用 notes/_topics/rpc-rest-api.md
成熟度模型不评接口质量 已复用 notes/_topics/rpc-rest-api.md
HTTP方法表达资源操作 已复用 notes/_topics/rpc-rest-api.md
服务端选URI时用POST 已复用 notes/_topics/rpc-rest-api.md
PUT全量替换PATCH局部改 已复用 notes/_topics/rpc-rest-api.md
状态码区分处理结果 已复用 notes/_topics/rpc-rest-api.md
成功码匹配实际结果 已复用 notes/_topics/rpc-rest-api.md
语法错误与语义错误分辨 已复用 notes/_topics/rpc-rest-api.md
认证失败与授权失败分开 已复用 notes/_topics/rpc-rest-api.md
服务端错误码按故障位置选 已复用 notes/_topics/rpc-rest-api.md
载荷与内容类型共同传数据 已复用 notes/_topics/rpc-rest-api.md
GET请求体没有通用语义 已复用 notes/_topics/rpc-rest-api.md
错误响应需要可读原因 已复用 notes/_topics/rpc-rest-api.md
变更响应回显服务器状态 已复用 notes/_topics/rpc-rest-api.md
集合响应权衡完整与精简 已复用 notes/_topics/rpc-rest-api.md
查询参数过滤并分页 已复用 notes/_topics/rpc-rest-api.md
JSONSchema描述结构 已创建 notes/_topics/openapi-contract-schema-validation.md
数组items约束元素 已创建 notes/_topics/openapi-contract-schema-validation.md
属性格式细化基础类型 已创建 notes/_topics/openapi-contract-schema-validation.md
OpenAPI五部分分工 已创建 notes/_topics/openapi-contract-schema-validation.md
paths声明端点交互契约 已创建 notes/_topics/openapi-contract-schema-validation.md
operationId标识操作 已创建 notes/_topics/openapi-contract-schema-validation.md
参数声明标明位置与约束 已创建 notes/_topics/openapi-contract-schema-validation.md
请求体声明载荷结构 已创建 notes/_topics/openapi-contract-schema-validation.md
路径参数可供多方法共用 已创建 notes/_topics/openapi-contract-schema-validation.md
allOf组合兼容模型 已创建 notes/_topics/openapi-contract-schema-validation.md
按状态码描述响应 已创建 notes/_topics/openapi-contract-schema-validation.md
通用错误响应复用定义 已创建 notes/_topics/openapi-contract-schema-validation.md
认证方案写入OpenAPI 已创建 notes/_topics/openapi-contract-schema-validation.md
类型标注接入查询参数 已创建 notes/_topics/python-web-api-framework-practice.md
None区别未传与假值 已创建 notes/_topics/python-web-api-framework-practice.md
宽容读取需权衡拼写风险 已创建 notes/_topics/python-web-api-framework-practice.md
未知字段可配置拒绝 已创建 notes/_topics/python-web-api-framework-practice.md
自动生成规范需对照设计 已创建 notes/_topics/python-web-api-framework-practice.md
Flask框架组合能力 已创建 notes/_topics/python-web-api-framework-practice.md
类视图封装同路径方法 已创建 notes/_topics/python-web-api-framework-practice.md
蓝图集中注册路由 已创建 notes/_topics/python-web-api-framework-practice.md
字段模型约束载荷 已创建 notes/_topics/python-web-api-framework-practice.md
配置对象集中注入参数 已创建 notes/_topics/python-web-api-framework-practice.md
查询参数按位置绑定模式 已创建 notes/_topics/python-web-api-framework-practice.md
响应序列化前显式校验 已创建 notes/_topics/python-web-api-framework-practice.md
六边形架构隔离核心 已复用 notes/_topics/layered-architecture-ports.md
端口定义技术无关接口 已复用 notes/_topics/layered-architecture-ports.md
依赖倒置让细节依赖抽象 已复用 notes/_topics/layered-architecture-ports.md
ORM映射表与对象 已复用 notes/_topics/object-relational-mapping.md
迁移记录模式演进 无需加入 现有主题范围不精确覆盖本卡聚焦的“迁移记录模式演进”
一对多关系由外键连接 已复用 notes/_topics/object-relational-mapping.md
活动记录耦合业务与存储 已复用 notes/_topics/object-relational-mapping.md
仓储接口隔离存储细节 已复用 notes/_topics/object-relational-mapping.md
仓储不自行提交事务 已复用 notes/_topics/object-relational-mapping.md
仓储返回领域对象 已复用 notes/_topics/object-relational-mapping.md
控制反转由外部提供依赖 已复用 notes/_topics/dependency-wiring-di.md
依赖注入让实现可替换 已复用 notes/_topics/dependency-wiring-di.md
契约驱动模拟外部服务 已复用 notes/_topics/service-adaptation-compatibility.md
异常类型区分失败来源 无需加入 现有主题范围不精确覆盖本卡聚焦的“异常类型区分失败来源”
工作单元管理本地事务 已复用 notes/_topics/object-relational-mapping.md
上下文管理器包住资源生命周期 无需加入 现有主题范围不精确覆盖本卡聚焦的“上下文管理器包住资源生命周期”
SDL声明查询模式 已创建 notes/_topics/graphql-schema-query-execution.md
标量定义字段值类型 已创建 notes/_topics/graphql-schema-query-execution.md
感叹号声明非空字段 已创建 notes/_topics/graphql-schema-query-execution.md
对象类型组合资源字段 已创建 notes/_topics/graphql-schema-query-execution.md
自定义标量需实现行为 已创建 notes/_topics/graphql-schema-query-execution.md
列表与元素分别约束非空 已创建 notes/_topics/graphql-schema-query-execution.md
边字段连接对象类型 已创建 notes/_topics/graphql-schema-query-execution.md
关系对象保存连接属性 已创建 notes/_topics/graphql-schema-query-execution.md
接口与联合表达不同复用 已创建 notes/_topics/graphql-schema-query-execution.md
枚举限制字段取值 已创建 notes/_topics/graphql-schema-query-execution.md
Query根类型组织读取 已创建 notes/_topics/graphql-schema-query-execution.md
输入类型聚合操作参数 已创建 notes/_topics/graphql-schema-query-execution.md
Mutation根类型组织变更 已创建 notes/_topics/graphql-schema-query-execution.md
模拟服务先验证契约 已创建 notes/_topics/graphql-schema-query-execution.md
选择集明确返回字段 已创建 notes/_topics/graphql-schema-query-execution.md
响应分别承载数据与错误 已创建 notes/_topics/graphql-schema-query-execution.md
内联片段按实际类型选字段 已创建 notes/_topics/graphql-schema-query-execution.md
命名片段复用字段选择 已创建 notes/_topics/graphql-schema-query-execution.md
输入对象传递成组过滤条件 已创建 notes/_topics/graphql-schema-query-execution.md
嵌套选择沿对象关系取值 已创建 notes/_topics/graphql-schema-query-execution.md
同一操作可请求多个根字段 已创建 notes/_topics/graphql-schema-query-execution.md
别名区分同字段不同参数 已创建 notes/_topics/graphql-schema-query-execution.md
字段参数用括号传入 已创建 notes/_topics/graphql-schema-query-execution.md
变更操作用mutation声明 已创建 notes/_topics/graphql-schema-query-execution.md
变量把操作与参数值分开 已创建 notes/_topics/graphql-schema-query-execution.md
HTTP请求承载查询文档 已创建 notes/_topics/graphql-schema-query-execution.md
先由模式列出实现职责 已创建 notes/_topics/graphql-schema-query-execution.md
解析器提供字段实际值 已创建 notes/_topics/graphql-schema-query-execution.md
可执行模式绑定定义与解析器 已创建 notes/_topics/graphql-schema-query-execution.md
解析器按责任拆分模块 已创建 notes/_topics/graphql-schema-query-execution.md
返回值须满足模式形状 已创建 notes/_topics/graphql-schema-query-execution.md
联合类型需判定具体成员 已创建 notes/_topics/graphql-schema-query-execution.md
输入对象进入解析器参数 已创建 notes/_topics/graphql-schema-query-execution.md
分页换算起点索引 已创建 notes/_topics/graphql-schema-query-execution.md
变更解析器按契约写入 已创建 notes/_topics/graphql-schema-query-execution.md
自定义标量需双向转换 已创建 notes/_topics/graphql-schema-query-execution.md
字段解析映射内部引用 已创建 notes/_topics/graphql-schema-query-execution.md
字段解析器复用有追踪代价 已创建 notes/_topics/graphql-schema-query-execution.md
认证与授权回答不同问题 已复用 notes/_topics/auth-and-cryptography.md
OAuth委托访问无需交密码 已复用 notes/_topics/auth-and-cryptography.md
OAuth四种角色各司其职 已复用 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
OIDC承载身份认证 已复用 notes/_topics/auth-and-cryptography.md
身份令牌不能充当访问令牌 已复用 notes/_topics/auth-and-cryptography.md
JWT三段承载元数据与声明 已复用 notes/_topics/auth-and-cryptography.md
验证令牌声明需看受众与期限 已复用 notes/_topics/auth-and-cryptography.md
OIDC发现文档公布端点 已复用 notes/_topics/auth-and-cryptography.md
解码令牌不等于验证令牌 已复用 notes/_topics/auth-and-cryptography.md
验签与声明校验缺一不可 已复用 notes/_topics/auth-and-cryptography.md
鉴权中间件统一拦截请求 已复用 notes/_topics/auth-and-cryptography.md
CORS预检不携带身份凭据 已复用 notes/_topics/auth-and-cryptography.md
Bearer令牌置于授权头 已复用 notes/_topics/auth-and-cryptography.md
CORS允许来源应收窄 已复用 notes/_topics/auth-and-cryptography.md
登录成功仍需资源级授权 已复用 notes/_topics/least-privilege-access-control.md
跨服务用不透明用户ID关联 已复用 notes/_topics/auth-and-cryptography.md
资源查询同时限定所有者 已复用 notes/_topics/least-privilege-access-control.md
隐藏资源存在性可返回404 已复用 notes/_topics/auth-and-cryptography.md
规范驱动测试检查接口契约 已复用 notes/_topics/testing-effectiveness.md
Dredd遍历规范中的端点 已复用 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
OpenAPI链接描述后续操作 已复用 notes/_topics/testing-effectiveness.md
状态化测试验证资源链路 已复用 notes/_topics/testing-effectiveness.md
通过测试须核对检查范围 已复用 notes/_topics/testing-effectiveness.md
GraphQL模式驱动查询测试 已复用 notes/_topics/testing-effectiveness.md
镜像与容器分开构建运行 已复用 notes/_topics/container-orchestration.md
环境变量注入数据库连接 已复用 notes/_topics/secrets-credential-management.md
依赖先于源码构建镜像 已复用 notes/_topics/container-orchestration.md
私钥不得随应用镜像分发 已复用 notes/_topics/secrets-credential-management.md
端口映射让主机访问容器 已复用 notes/_topics/container-orchestration.md
Compose用服务名连数据库 已复用 notes/_topics/container-orchestration.md
命名卷保存数据库状态 已复用 notes/_topics/container-orchestration.md
迁移是服务可用前置步骤 已复用 notes/_topics/change-release-safety.md
镜像标签指向目标仓库 已复用 notes/_topics/container-orchestration.md
容器编排维护应用运行 已复用 notes/_topics/container-orchestration.md
控制平面协调集群状态 已复用 notes/_topics/container-orchestration.md
Pod封装协同容器 已复用 notes/_topics/container-orchestration.md
工作负载类型匹配运行方式 已复用 notes/_topics/container-orchestration.md
副本集维持期望Pod数 已复用 notes/_topics/container-orchestration.md
命名空间划定资源名称范围 已复用 notes/_topics/container-orchestration.md
基础设施模板记录期望资源 已复用 notes/_topics/infrastructure-as-code.md
服务账号关联云端权限 已复用 notes/_topics/secrets-credential-management.md
入口控制器落实路由规则 无需加入 现有主题范围不精确覆盖本卡聚焦的“入口控制器落实路由规则”
部署清单声明Pod期望态 已复用 notes/_topics/infrastructure-as-code.md
标签选择器须匹配模板 已复用 notes/_topics/infrastructure-as-code.md
服务与入口分层路由 无需加入 现有主题范围不精确覆盖本卡聚焦的“服务与入口分层路由”
数据库置于私有子网 无需加入 现有主题范围不精确覆盖本卡聚焦的“数据库置于私有子网”
数据库入站权限应收窄 无需加入 现有主题范围不精确覆盖本卡聚焦的“数据库入站权限应收窄”
信封加密分离数据与主密钥 已复用 notes/_topics/secrets-credential-management.md
Secret编码不等于加密 已复用 notes/_topics/secrets-credential-management.md
工作负载按需引用Secret 已复用 notes/_topics/secrets-credential-management.md
Job执行一次性数据库迁移 已复用 notes/_topics/container-orchestration.md
OpenAPI地址随环境配置 无需加入 现有主题范围不精确覆盖本卡聚焦的“OpenAPI地址随环境配置”
清理云资源按依赖逆序 无需加入 现有主题范围不精确覆盖本卡聚焦的“清理云资源按依赖逆序”
RPC按过程调用远端能力 已复用 notes/_topics/rpc-rest-api.md
JSON-RPC方法与ID关联 已复用 notes/_topics/rpc-rest-api.md
SOAP信封包裹消息内容 已复用 notes/_topics/rpc-rest-api.md
gRPC由模式生成通信桩 已复用 notes/_topics/rpc-rest-api.md
API协议按消费者约束选 已复用 notes/_topics/rpc-rest-api.md
破坏性改动须管理版本 已复用 notes/_topics/service-adaptation-compatibility.md
日历版本体现发布时点 已复用 notes/_topics/service-adaptation-compatibility.md
URL与媒体类型可承载版本 已复用 notes/_topics/service-adaptation-compatibility.md
弃用与下线是两个时点 已复用 notes/_topics/service-adaptation-compatibility.md
退役端点按去向选状态码 已复用 notes/_topics/service-adaptation-compatibility.md
身份服务托管账户与发令牌 已复用 notes/_topics/auth-and-cryptography.md
令牌kid选择对应验签公钥 已复用 notes/_topics/auth-and-cryptography.md

相关主题

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

主题索引

微服务拆分与演进

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

444 张卡片 · 71 本书

主题索引

测试有效性与验证手段

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

366 张卡片 · 63 本书

主题索引

领域划分与限界上下文

比较子域划分、通用语言、限界上下文与事件风暴等战略设计方法如何确定业务边界。

330 张卡片 · 31 本书

主题索引

变更发布与回滚安全

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

312 张卡片 · 75 本书

主题索引

容器与编排

比较容器隔离与镜像理念、Kubernetes 的资源模型与控制器、应用封装方案,以及容器存储的抽象与扩展机制。

312 张卡片 · 47 本书

主题索引

分布式事务与一致性

比较内部与外部一致性、XA/2PC/3PC、CAP 与 BASE,以及可靠事件队列、TCC、SAGA、AT 等柔性事务方案。

308 张卡片 · 61 本书

主题索引

远程调用与REST设计

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

303 张卡片 · 53 本书

主题索引

认证与密码学基础

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

253 张卡片 · 58 本书

主题索引

追踪与上下文

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

199 张卡片 · 44 本书

主题索引

分层、洋葱与六边形架构

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

196 张卡片 · 43 本书

主题索引

最小特权与访问控制

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

175 张卡片 · 72 本书

主题索引

对象-关系映射模式

对象模型与关系数据库之间的映射:数据源架构、工作单元、标识映射、延迟加载、结构映射、元数据映射与查询。

155 张卡片 · 13 本书

主题索引

服务适配与兼容性

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

146 张卡片 · 38 本书

主题索引

分布边界与远程接口

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

93 张卡片 · 29 本书

主题索引

基础设施即代码与编排

用声明式模板描述资源及其依赖,由编排引擎按依赖图创建、更新与回滚,以及回滚受删除策略和外部副作用约束的边界。

93 张卡片 · 20 本书

主题索引

OpenAPI 契约与模式验证

比较 OpenAPI 文档结构、路径与操作、参数/请求/响应、JSON Schema 约束、复用和认证方案,以及规范交互验证的做法。

61 张卡片 · 14 本书

主题索引

依赖注入与模块连接

组件依赖由谁提供:硬编码依赖、依赖注入、服务定位器与 DI 容器的解耦程度、可测试性与可读性取舍,以及异步初始化依赖和插件获取宿主服务的方式。

60 张卡片 · 19 本书

主题索引

对象与关系的结构映射

对象与关系在粒度、继承、标识和关联上的阻抗不匹配:单表/类表/具体表三种继承映射的取舍,嵌入值与值集合怎样摊平或拆表,复合主键与关联表怎么写,命名与元数据怎样保持映射透明。

56 张卡片 · 7 本书

主题索引

数据入口与工作单元

表数据入口、行数据入口、活动记录与数据映射器各自的职责边界,工作单元怎样记录变化并在提交时统一写回,标识映射怎样保证同一行只有一个对象,以及持久化机制该怎样渐进选型。

45 张卡片 · 8 本书

主题索引

GraphQL 模式、查询与执行

比较 GraphQL SDL 的类型、字段、输入约束、Query 与 Mutation,及选择集、片段、变量、解析器、错误和 HTTP 承载的执行边界。

43 张卡片 · 3 本书

主题索引

密钥与凭证管理

比较密钥轮换、根密钥分发、紧急凭证与凭证泄露风险的管理方法。

42 张卡片 · 18 本书

主题索引

Python Web API 框架实践

比较 Flask、FastAPI、Pydantic 等框架中的路由、参数绑定、输入输出模型验证、错误提示和模块化组织。

21 张卡片 · 1 本书