ykt_server_hnswdx/.workbuddy/memory/2026-04-20.md

2026-04-20 工作日志

后端代码生成模板修正

问题

用户反馈代码生成模板文件不对，对照 ruoyi-backstage/basics/PtParameter 实际代码分析发现多处差异。

修正内容

模板文件修正（3个）：

1. ServiceImpl.java.template — 最大改动

   • ❌ 旧：baseMapper.selectVoList(bo) / baseMapper.selectVoPageList(bo, pageQuery) — 编译不通过的方法签名
   • ✅ 新：LambdaQueryWrapper + buildQueryWrapper 私有方法
   • 新增 validEntityBeforeSave 保存前校验方法
   • insertByBo 增加主键回填 + Objects.requireNonNull 校验
   • updateByBo 增加 null 检查 + validEntityBeforeSave
   • deleteWithValidByIds 增加 isValid 校验预留位置
   • 分页查询默认 orderByDesc(createTime)
   • 新增模板变量 ${queryWrapperConditions} 和 ${PkCapField}

2. Mapper.java.template — 删除多余的 Bo import（Mapper 不需要引入 Bo）

3. Service.java.template — 删除多余的 Domain import（Service 接口不引入实体类）

已生成代码修正（3个 ServiceImpl + 3个 Service 接口 + 3个 Mapper）：

• EcsTermServiceImpl — 完整 CRUD + buildQueryWrapper（termName like, termNumb like, termType eq, roomId eq）
• EcsAttendServiceImpl — 完整 CRUD + 保留手工考勤特殊逻辑 + buildQueryWrapper
• EcsSectionServiceImpl — 完整 CRUD + buildQueryWrapper（含日期范围查询）
• IEcsAttendService — 补充 updateByBo / deleteWithValidByIds 接口
• IEcsSectionService — 补充 insertByBo / updateByBo / deleteWithValidByIds 接口
• 3个 Mapper 文件删除多余 Bo import

SKILL.md 更新：

• 新增「模板变量说明」表格
• 新增「ServiceImpl 查询规范」章节，明确 LambdaQueryWrapper 模式

MEMORY.md 更新：

• 新增 ServiceImpl 查询规范和模板变量说明

前端代码生成 — ECS 课表管理（/dev ecs section --frontend-only）

需求特点

• 只读模式：无新增/编辑/删除，只有列表查询和导出
• lockRule：dataSource=1 时禁止编辑删除（当前接口无编辑删除，预留）
• 日期范围查询：courseDate 支持 between 查询
• 字典字段：ecs_time_slot（上课时段）

生成文件

文件	路径	说明
types.ts	src/api/ecs/section/types.ts	VO/Query 类型定义
index.ts	src/api/ecs/section/index.ts	仅 listSection + getSection
index.vue	src/views/ecs/section/index.vue	列表页（搜索+表格+导出，无增删改form）

设计要点

• 无 form.vue（只读模式不需要表单页）
• 学期字典前端本地定义（非系统字典），ecs_time_slot 使用 useDict
• 星期使用前端映射表 weekdayMap 转换显示
• 日期范围使用 el-date-picker type="daterange"，查询时拆分为 courseDateBegin/courseDateEnd
• 是否考勤使用 el-tag 标签展示
• 默认隐藏低频列（连课节次/占用节次/占用列表/开始时间/结束时间）

前端代码生成 — ECS 设备管理（/dev ecs term --frontend-only）

需求特点

• 完整 CRUD：新增/编辑/删除/导入/导出
• 字典字段：term_type（设备类型）、term_brand（设备品牌）
• 教室关联选择：通过弹窗选择教室，选择后回填 roomId 和 roomName
• 管理密码：不在列表显示，不在 Excel 导出，仅在表单中可编辑（show-password）
• 双列表单布局：el-row + el-col :span="12" 排列

生成文件

文件	路径	说明
types.ts	src/api/ecs/term/types.ts	VO/Form/Query 类型定义
index.ts	src/api/ecs/term/index.ts	完整 CRUD API
index.vue	src/views/ecs/term/index.vue	列表页（搜索+表格+增删改+导入导出）
form.vue	src/views/ecs/term/form.vue	表单页（双列布局+教室选择弹窗）

设计要点

• 列表页使用 min-width 替代 width（遵循前端表格列宽规范）
• 教室选择：点击输入框弹窗 → listClassroom 分页查询 → 单选高亮 → 确认回填 roomId/roomName
• 新增时字典字段（termType）默认选中第一个选项
• form.vue 使用双列布局提升空间利用率
• 操作列固定 width="120"（包含编辑+删除两个按钮）

修正记录

• ClassroomVO 主键是 roomId（非 ptRoomId），已修正 form.vue 中的教室选择确认逻辑
• ClassroomVO 无 floorName 字段，教室选择表格改为 roomCode 列

前端代码生成 — ECS 考勤管理（/dev ecs attend --frontend-only）

需求特点

• 只读模式 + 手工考勤补签：无编辑/删除/导入，仅新增（手工考勤）+导出
• 级联选择：教室（弹窗选择）→ 班级（下拉）→ 学员（下拉，依赖班级过滤）
• 字典字段：check_type（考勤方式）、push_status（推送状态）
• 冗余回填：选择学员后自动回填 realName/userNumb，选择班级后回填 className

生成文件

文件	路径	说明
types.ts	src/api/ecs/attend/types.ts	AttendVO / AttendForm / AttendQuery 类型定义
index.ts	src/api/ecs/attend/index.ts	listAttend / getAttend / addAttend（无 update/del）
index.vue	src/views/ecs/attend/index.vue	列表页（搜索+表格+手工考勤按钮+导出）
form.vue	src/views/ecs/attend/form.vue	手工考勤表单（级联选择+教室弹窗）

设计要点

• 列表页无 selection 列、无编辑/删除/导入按钮，仅「手工考勤」和「导出」
• form.vue 核心逻辑：教室（弹窗选择，同 term）→ 班级（getClassOptions 下拉）→ 学员（listTrainee 按 deptId 过滤，级联清空）
• 选班级后自动清空已选学员并重新加载学员列表
• 选学员后自动回填 realName 和 userNumb
• 考勤方式默认选中字典第一项，考勤时间默认当前时间
• 推送状态列使用 dict-tag 组件展示

字典字段类型规范 — 全局更新

规范内容

数据字典（dictType）对应的数据库表字段类型为 varchar(16)，Java 实体/Bo/Vo 中对应类型为 String（而非 Integer）。字典值虽然常为数字，但存储和传输统一使用字符串。

更新文件

文件	更新内容
MEMORY.md	技术规范新增「字典字段类型规范」条目
require/SKILL.md	字段解析规则：fieldType=Integer → fieldType=String（4处）；字段类型映射表新增 String（字典字段） 行 varchar(16)；DDL生成逻辑新增字典字段说明
ruoyi-backend/SKILL.md	A.5 映射表新增字典字段行 private String xxxType；注意事项新增第7条；buildQueryWrapper 规则拆分出字典字段的 StringUtils.isNotBlank 判断
ykt-web-dev/SKILL.md	A.4.1 类型定义注释中标注字典字段类型；注意事项新增第10条

主键不导出 Excel — 规范更新

规范内容

主键字段（Long 类型）不加 @ExcelProperty 注解，不参与 Excel 导出。Vo 中主键仅作为标识字段，需求文档中主键默认 excelExport: false。

更新文件

文件	更新内容
Vo.java.template	去掉主键字段的 @ExcelProperty(value = "${pkComment}") 注解
ruoyi-backend/SKILL.md	A.5 映射表主键行：@ExcelProperty("ID") → 不导出；注意事项新增第8条
require/references/requirements-template.md	主键字段模板增加 excelExport: false
require/SKILL.md	字段生成规则主键增加 excelExport=false；注意事项新增第9条
MEMORY.md	技术规范新增「主键不导出 Excel」条目

日期类型规范修正：LocalDateTime → Date

规范内容

日期和时间字段 Java 类型统一使用 java.util.Date（而非 LocalDateTime），与 BaseEntity 基类保持一致。ServiceImpl 中使用 new Date() 而非 LocalDateTime.now()。

更新文件

文件	更新内容
EcsAttend.java / Bo / Vo	LocalDateTime → Date（checkTime/uploadTime/pushTime）
EcsAttendServiceImpl.java	LocalDateTime.now() → new Date()，import 改为 java.util.Date
EcsSection.java / Bo / Vo	LocalDateTime → Date（courseDate/startTime/endTime + 范围字段）
EcsCourseVo.java	createTime 从 LocalDateTime → Date，删除多余 import
EcsCourseTeacherVo.java	createTime 从 LocalDateTime → Date，删除多余 import
EcsTermVo.java	删除多余的 import java.time.LocalDateTime
require/SKILL.md	日期映射 fieldType=LocalDateTime → Date；通用字段表 LocalDateTime → Date；字段类型映射表 LocalDateTime → Date
ruoyi-backend/SKILL.md	A.5 映射表新增 fieldType=Date 行
4个需求文档（term/attend/section/course）	所有 LocalDateTime → Date
MEMORY.md	新增「日期类型规范」条目