黄金切片：新增一个模块

黄金切片指一个新模块的最小完整路径：表、实体、查询、接口、权限、菜单、测试，一个都不少。

七步

1. Liquibase 建表（db/changelog），列注释写准确。
2. 运行生成器产出 DO / Mapper / XML / Repository。
3. 需要动态查询时写 QueryXxxDTO，逐字段标 @QueryField。
4. 简单 CRUD 走 Controller → AppService → Repository → Convert。
5. 含流程 / 规则 / 多聚合的逻辑放进 domain/handler/<module>/XxxHandler，AppService 只负责调用。
6. 新错误码实现 ErrorCode 并补齐三语 i18n。
7. 跑一次 ./gradlew build。

一条命令替代前两步

验收判据

• 构建一次通过（含架构守护与契约一致性）。
• 权限码已登记，且代码中无字面量权限码。
• 菜单已登记，前端不写死路由。
• 新表列注释完整，逻辑删除列非空默认 0。