今日日报

干了什么

Swagger 文档三层分组 给 8 个微服务分了三个文档组——前端接口、后台接口、内部微服务接口。加了 emoji 前缀区分，各服务不再相互干扰。所有内部接口统一加了 /v1/internal/ 路径前缀。

BFF 聚合 之前 BFF 层基本是透传，今天把管理后台的控制器补全了。系统管理、商品管理、订单管理、营销管理、基础数据都有了对应的 BFF 控制器和 Swagger 文档。小程序那边原本就做了首页和商品详情的聚合，今天补了用户中心。

前端接口映射 扫了两个前端项目（小程序和管理后台），列了 50 多个 API 调用，逐个去后端代码里 grep 确认接口路径。发现了 4 个前端写了但后端不存在的接口，也确认了一批属于另一个系统的接口。

DTO 注解补齐 一天下来给 103 个 DTO 和 Entity 加了 @Schema 注解，类级和字段级都有，Swagger 文档不再是黑盒了。

Nacos 扫描 拉到了全部 10 个服务的 Nacos 配置，更新了配置文档，补了 BFF 服务的 template 文件。

README 瘦身 把 README 里超长的内容拆到 docs 目录下，加了架构改进建议文档，整理了 28 项待改进问题。

明日计划

继续推进遗留任务。