OpenAPI 契约和 Mock

参考来源：OpenAPI 3.1 Specification、Stoplight Studio

适用场景

• API 设计的最后一步
• 输出机器可读的契约
• Mock 服务搭建
• 给前端/后端/QA/安全/文档的交接

核心原则

1. OpenAPI 是真理来源（Source of Truth）
   不是文档的附属，是契约本身
   代码、Mock、文档都从 OpenAPI 生成