Что такое OpenAPI и как организовать Swagger в продакшен-проекте?

OpenAPI 3.0 — стандарт описания REST API. springdoc-openapi автоматически генерирует из Spring MVC/WebFlux аннотаций. @Tag, @Operation, @ApiResponse, @Schema для обогащения документации. В продакшене: отключить Swagger UI (springdoc.swagger-ui.enabled=false) или ограничить доступ. Генерация client SDK из OpenAPI: openapi-generator-maven-plugin. Contract tests через Pact или Spring Cloud Contract — клиент и сервер проверяют совместимость по контракту автоматически.