ether-docs/02-DESIGN/domains/batch-operations/checklist.md

3.7 KiB
Raw Blame History

空间批量操作问题修复检查清单

文档版本: v1.0
创建日期: 2026-02-23


一、问题1生成类型隐藏

  • 确认 BatchGenerateModal.vue 第21行使用 v-show="false" 隐藏生成类型
  • 确认隐藏后不影响其他功能

结论: 已正确隐藏,无需修改


二、问题2批量生成房间保存失败

排查项

  • 启动后端服务,检查日志
  • 启动前端服务,打开批量生成弹窗
  • 选择楼栋,填写房间信息
  • 点击保存,观察网络请求和响应
  • 检查后端是否抛出异常

可能原因

  • 楼栋ID不存在项目隔离问题
  • 编码冲突
  • 数据库写入失败

三、问题3车位后缀为空

  • 确认前端 BatchGenerateModal.vue 第490行设置 suffix: ""
  • 确认后端 BatchGenerateParkingRequest.java 第28行默认值为 ""

结论: 已正确设置,无需修改


四、问题4车位序号位数问题

排查项

  • 启动服务测试
  • 设置3位数序号生成车位
  • 检查生成的车位编码是否为 001, 002, 003 格式
  • 检查生成的车位名称是否与编码一致

代码检查

  • 前端传递 digitCount 参数
  • 后端接收 digitCount 参数
  • 后端使用 String.format("%0" + digitCount + "d", number)

五、问题5批量操作限制

检查项

  • 确认 SpaceManagement.vue 中批量生成菜单是否正确显示
  • 确认是否有限制检查
  • 移除限制(如果存在)

修复方案

  • 修改 handleBatchGenerate 函数,移除限制检查
  • 允许用户直接从菜单选择批量生成类型

六、问题6车位列表分页

  • 确认 SpaceManagement.vue 第225-229行设置分页
  • 确认每页显示20条

结论: 已支持分页,无需修改


七、问题7楼栋地址生成

检查项

  • 确认 SpaceNodeServiceImpl.java 第902-911行地址生成逻辑
  • 当没有父节点时,地址只设置为 name

修复方案

  • 获取项目信息
  • 使用项目地址作为基础地址

八、问题8项目统计数据

检查项

  • 确认前端 ProjectStatistics 接口定义
  • 确认后端 ProjectStatistics 类定义
  • 确认前端显示逻辑

修复方案

  • 同步前端接口定义与后端一致
  • 修改前端显示逻辑,使用 totalRooms 作为户数
  • 添加面积显示

九、代码修改检查

前端修改

  • src/api/mdm/project.ts - 修复 ProjectStatistics 接口定义
  • src/views/mdm/project/detail.vue - 修复统计显示
  • src/views/mdm/project/components/SpaceManagement.vue - 移除批量操作限制

后端修改

  • SpaceNodeServiceImpl.java - 修复楼栋地址生成逻辑

十、测试验证检查

功能测试

  • 批量生成房间保存成功
  • 批量生成车位序号位数正确
  • 批量生成车位名称不带"车位"后缀
  • 批量操作不受限制
  • 批量生成楼栋地址正确
  • 项目统计数据正确显示

回归测试

  • 空间树正常显示
  • 空间节点CRUD正常
  • 其他功能不受影响

检查结果统计

检查项类别 总项数 已完成 待处理
问题排查 8 3 5
代码修改 4 0 4
测试验证 7 0 7
合计 19 3 16

下一步行动

  1. 确认规格文档 - 用户确认规格文档
  2. 启动服务 - 启动前后端服务
  3. 排查问题 - 实际测试排查问题
  4. 修复代码 - 根据排查结果修复代码
  5. 验证修复 - 验证所有问题已修复