# Dto 类变更通知模版 **识别规则**:类名以 `Dto` 结尾。 **影响范围**:request + response + 类转换(无匹配时对应栏显示「无」)。 **嵌套标识**:被其他 Dto/Vo 嵌套时在「变更对象」行追加 `(嵌套对象)`;若同时直接作接口入参/返回值根类型,再追加 `(顶层对象)`。纯顶层不标注。 --- ## 完整示例(字段修改) ``` # 【类变更通知】 > **变更对象: ApplyAttendanceChangeDto流程表单 [出勤变更])** > **修改人: dongzi** > **时间: 2026-06-07 20:14:35** > **路径: jnpf-ftb/jnpf-ftb-entity/src/main/java/jnpf/model/workflow/dto/ApplyAttendanceChangeDto.java** ## 【对象变更细节】 > **共 4 项变更** > [修改] `taskId` 说明: 流程主键 类型: IntegerString > [修改] `changeUserId` 说明: 变更人员id 类型: StringInteger > [新增] `storeId` 说明: 门店ID 类型: String > [删除] `oldField` 说明: 已废弃字段 类型: Integer ## 【影响范围】 ### 影响 request 接口 > POST `/apply/clockIn` > PUT `/apply/clockIn/{id}` ### 类转换影响 > 未开启检测 ``` --- ## 示例(嵌套对象) ``` > **变更对象: UserSelfDto嵌套对象)** ``` 若该类同时直接出现在某接口 `@RequestBody` 或返回值类型中: ``` > **变更对象: SomeDto说明)(嵌套对象)(顶层对象)** ``` --- ## 示例(类删除) ``` ## 【对象变更细节】 > [已删除] 该类文件已被移除 ``` --- ## 示例(仅类名变更) ``` ## 【对象变更细节】 > [类名变更] ApplyAttendanceChangeDtoApplyAttendanceChangeNewDto > 字段无变化 ## 【影响范围】 ### 影响 request 接口 > POST `/apply/clockIn` > PUT `/apply/clockIn/{id}` ### 类转换影响 > 未开启检测 ``` --- ## 示例(类名 + 字段同时变更) ``` ## 【对象变更细节】 > [类名变更] ApplyAttendanceChangeDtoApplyAttendanceChangeNewDto > **共 1 项变更** > [修改] `changeMinute` 说明: 变更分钟数 类型: IntegerString ``` --- ## 占位符 | 占位符 | 来源 | |--------|------| | 路径 | Git 相对路径,`ClassChangeReport.sourceFile` | | 类说明 | `@Schema` / `@ApiModel` / 类 Javadoc | | 字段说明 | `@Schema` / `@ApiModelProperty` / 字段 Javadoc(见 [field-description.md](field-description.md)) |