使用NestJS和OpenAPI的契约优先API设计

契约优先迫使团队在自由实现之前就数据结构达成一致。在NestJS中，整洁的Swagger/OpenAPI成为API使用者的事实来源。

从一开始就记录状态码、错误结构和分页。这些小细节最常引发集成错误。

尽可能从规范生成前端类型。破坏性变更必须在代码审查时可见，而不是在深夜的生产环境中出现。

不要让文档腐烂。将更新OpenAPI作为每个新端点完成定义的一部分。