52 lines
2.7 KiB
Plaintext
52 lines
2.7 KiB
Plaintext
---
|
||
description: 按 safety-eval-service 既定分层与枚举约定生成/修改代码（触发词：按照 safety 代码格式生成）
|
||
alwaysApply: true
|
||
---
|
||
|
||
# 按照 safety 代码格式生成
|
||
|
||
当用户说「按照 safety 代码格式生成」或根据 SQL/原型生成相关代码时，按本仓库既定格式生成，**只改任务相关文件，不动不相关代码**。
|
||
|
||
## 触发词
|
||
- 「按照 safety 代码格式生成」
|
||
|
||
## 分层与参考
|
||
对齐 `AccountController` / 机构端现有全链路（Controller → Api → Executor → DomainService → Gateway → Mapper），不相干功能不要生成。
|
||
|
||
参考入口：`safety-eval-adapter/.../web/AccountController.java`
|
||
机构端示例：`.../web/institution/EvalCustomerController.java`、`EvalProjectController.java`
|
||
|
||
新建清单（以表名为 Xxx）：
|
||
- adapter/web/XxxController.java（或 institution 包下）
|
||
- client/api/XxxApi.java
|
||
- client/dto/XxxAddCmd、XxxModifyCmd、XxxPageQuery（按实际需要）
|
||
- client/co/XxxCO
|
||
- app/executor/XxxExecutor.java（实现 Api）
|
||
- app/convertor/XxxCmdConvertor.java（MapStruct，勿放 change/convertor，除非是备案变更）
|
||
- domain/entity/XxxEntity、domain/query/XxxQuery、domain/gateway/XxxGateway、domain/service/XxxDomainService
|
||
- infrastructure/dataobject/XxxDO、mapper/XxxMapper、gatewayimpl/XxxGatewayImpl
|
||
- infrastructure/convertor/XxxDoConvertor.java（MapStruct Entity↔DO）
|
||
|
||
## 转换
|
||
- 禁止手写 set() 填充 Cmd/CO/Entity/DO；统一 MapStruct（`componentModel = "spring"`）
|
||
- 字段名一致自动映射
|
||
|
||
## orgId 与填充
|
||
- 表有 org_id 时：全链路所有实体都加 orgId（DO/Entity/AddCmd/ModifyCmd/PageQuery/DomainQuery/CO 按需要）
|
||
- 新增：`InsertFieldDefaults.apply(dataObject)`（有 orgId 时不要用 applyIgnoreOrgId）
|
||
- 修改：`InsertFieldDefaults.applyForUpdate(dataObject)`
|
||
- 无 org 字段的表才用 `applyIgnoreOrgId`（如 Account）
|
||
|
||
## 枚举与只存 code（强约定）
|
||
- 下拉/状态类字段：**库表与 DO/Entity/Cmd 只存 code**，不落 `*_name`
|
||
- 名称在 Executor/CmdConvertor 用 `XxxEnum.ofCode(code).getValue()` 填到 CO（可展示）
|
||
- 能复用已有枚举则复用（如 `IndustryEnum`、`ChongqingDistrictEnum`）；不能复用则在 `domain/constant` 新建，写法对齐现有枚举（code + value + `ofCode`）
|
||
- 经纬度等坐标字段：Java 侧统一 `String`
|
||
- 每个带枚举的业务模块提供：`GET .../enums`，返回 `EnumOptionCO(code,name)` 列表集合（如 `EvalCustomerEnumsCO` / `EvalProjectEnumsCO`）
|
||
|
||
## 其它
|
||
- 最小 diff；不主动写 README/测试/注释除非要求
|
||
- 解释用中文；标识符英文
|
||
- 代码完成后回答精简：只说改了什么、怎么验
|
||
- 禁止猜测生成；字段/范围不清先问用户
|