1. 课程导论
1.1 什么是契约驱动开发（CDD）？
契约驱动开发（Contract-Driven Development, CDD）是一种以API契约作为团队协作与系统集成核心锚点的软件开发方法论。在CDD中，契约并非事后文档，而是先于代码存在的、机器可读的正式规范，它精确描述了服务提供者与服务消费者之间的交互协议。
CDD的核心原则可归纳为以下三点：
- 契约优先（Contract-First）：在编写任何实现代码之前，先定义并发布API契约。
- 契约即真相（Contract as Source of Truth）：契约是团队间沟通、测试、模拟与文档生成的唯一权威来源。
- 自动化验证（Automated Verification）：通过持续集成流水线自动校验实现是否严格遵循契约。
关键区别：传统开发模式（Code-First）中，代码是真相，文档是事后产物；CDD中，契约是真相，代码是契约的实现。
1.2 为什么敏捷团队需要API契约治理？
敏捷团队追求快速迭代、频繁交付与跨职能协作。然而，在微服务架构与前后端分离的背景下，缺乏契约治理会导致以下典型问题：
| 问题场景 | 无契约治理的后果 | 契约治理带来的价值 |
|---|---|---|
| 前后端并行开发 | 前端等待后端API完成，或联调时发现接口字段不一致 | 前端可基于契约立即进行Mock开发与测试 |
| 微服务间集成 | 服务A升级接口导致服务B崩溃，回归测试成本高 | 契约变更触发自动兼容性检查，提前发现破坏性变更 |
| 多团队协作 | 接口文档散落在Wiki、邮件、聊天记录中，版本混乱 | 契约集中管理，版本化，成为团队间唯一的沟通语言 |
| 持续交付流水线 | 手动测试依赖真实环境，反馈周期长 | 契约驱动自动化测试与消费者驱动契约测试（CDC） |
在敏捷迭代中，API契约治理不是增加流程负担，而是消除等待、减少返工、提升并行度的关键基础设施。
敏捷实践对齐：CDD天然支持Scrum中的Sprint计划（契约作为Sprint Backlog的一部分）、持续集成（契约验证作为CI门禁）以及跨职能团队的自组织协作。
1.3 契约驱动开发的核心流程
下图展示了CDD在敏捷迭代中的典型工作流：
1.4 课程目标与学习路径
本课程旨在帮助敏捷团队系统性地落地API契约治理，从理论到实践，从工具到流程，构建可执行的CDD体系。
课程三大目标
- 掌握契约规范标准：深入理解OpenAPI 3.x、gRPC/Protobuf、AsyncAPI等主流契约格式，能够独立编写与评审高质量API契约。
- 建立契约治理流程：在敏捷迭代中设计契约创建、评审、版本管理、变更通知与废弃策略，形成团队共识。
- 落地自动化工具链：集成契约验证、Mock服务、消费者驱动契约测试（CDC）与CI/CD流水线，实现“契约即代码”。
学习路径概览
| 阶段 | 章节范围 | 核心交付物 |
|---|---|---|
| 基础篇 | 第1-5章 | 理解CDD理念，掌握OpenAPI与gRPC契约编写 |
| 进阶篇 | 第6-15章 | 契约版本管理、兼容性检查、Mock与CDC测试 |
| 治理篇 | 第16-22章 | 契约评审流程、变更治理、多团队协作模式 |
| 实践篇 | 第23-30章 | CI/CD集成、工具链搭建、真实项目演练 |
前置要求：建议学员具备基本的RESTful API概念、微服务架构认知以及至少一种编程语言（Java/Go/TypeScript）的开发经验。无需预先掌握契约规范。
1.5 契约治理在敏捷团队中的角色定位
契约治理不是独立的流程，而是嵌入敏捷实践中的赋能机制。下图展示了契约治理与Scrum框架的映射关系：
通过将契约治理活动嵌入Sprint事件，团队无需额外增加会议，即可实现API质量的持续提升。
1.6 本章小结
- CDD 是一种以机器可读契约为核心的开发方法论，强调“契约优先”。
- 在敏捷团队中，API契约治理 解决了并行开发、服务集成、多团队协作与持续交付中的核心痛点。
- 本课程将带领学员从基础规范到治理流程，再到自动化工具链，系统化落地CDD。
- 契约治理不是额外负担，而是敏捷实践的增强器，能够显著提升团队交付效率与质量。