1. 课程导论：API设计治理的行业痛点、事务边界问题的由来、课程目标与学习路径

1.1 行业痛点：API治理的“三不管”地带

在微服务架构与中台战略大规模落地的今天，API 设计治理正面临前所未有的挑战。团队往往陷入“三不管”的困境：前端抱怨接口字段冗余、响应结构不统一；后端纠结于业务逻辑与数据一致性难以拆分；平台/架构组制定的规范文档被束之高阁，无法在代码层面强制落地。

以下表格总结了当前行业中最突出的三类痛点及其典型表现：

1.2 事务边界问题的由来

事务边界问题并非微服务独有，但在分布式架构下被急剧放大。单体应用中，数据库 ACID 事务天然提供了强一致性边界；而在微服务架构中，一次业务操作往往跨越多个服务、多个数据库实例，传统本地事务无法跨进程生效。

问题的根源可以归纳为以下三个层面：

• 业务层面： 领域模型拆分不合理，导致一个“业务事务”被强行拆散到多个服务中，缺乏明确的聚合根与边界上下文。
• 技术层面： 缺乏对分布式事务模式（如 TCC、Saga、事件驱动）的标准化治理，开发人员各自为政，引入不同的中间件和实现方式。
• 治理层面： API 设计时未将“事务边界”作为一等公民进行声明和约束，导致运行时无法通过网关或治理平台进行统一监控与熔断。

1.3 课程目标

本课程旨在从 Development（开发）视角出发，建立一套可落地、可度量的 API 设计治理体系，重点解决事务边界在 API 层面的定义、实现与治理问题。具体目标如下：

• 目标一： 掌握基于领域驱动设计（DDD）的 API 事务边界识别方法，能够从业务事件中推导出正确的服务粒度与聚合边界。
• 目标二： 学会在 OpenAPI 3.x / gRPC Proto 等契约文件中显式声明事务边界语义（如幂等性、补偿接口、超时策略）。
• 目标三： 落地 API 治理平台（如网关 + 治理中心），实现事务边界的自动化校验、监控与熔断。
• 目标四： 通过真实案例与代码级实践，建立从“设计 → 编码 → 测试 → 运维”的全链路治理闭环。

1.4 学习路径与章节地图

课程共分为 6 大模块、30 个章节，按照“认知 → 设计 → 实现 → 治理 → 演进”的逻辑递进。以下表格展示了核心模块与对应章节范围：