在 Gateway + BFF + Domain Service 架构下，记录一种用 Spring Cloud Gateway MVC 和 SpringDoc 聚合 OpenAPI 文档的做法，方便前后端协作和接口自查。

API Gateway 是微服务的统一入口。这套仓库里它由 Spring Cloud Gateway Server MVC 加 Virtual Threads 承载，配 JWKS 校验的 JWT 过滤器链、Redis Lua 令牌桶限流和灰度路由，从 WebFlux 迁到 MVC 的取舍也在里面。