Files
smart_grid_iot/.trae/specs/rework-survey-equipment-tree/checklist.md
T
wk 7c915f8946 docs(specs): 新增现场勘察业务相关 spec 文档
- rework-survey-equipment-tree:勘察设备树明细模式重构
- fix-equipment-topology-display:设备拓扑图完整显示修复
- survey-detail-building-select:勘察明细所属建筑下拉
- generate-floor-options-from-building:按建筑楼层生成楼层下拉
- survey-progress-track-detail:进度跟踪跳转勘察明细页
- survey-complete-to-tech-review:勘察完成提交技术复核与复核按钮改名
2026-10-25 02:34:18 +08:00

2.2 KiB
Raw Blame History

Checklist

数据层变更

  • customer_equipment 迁移包含 parent_id(自引用)与索引,幂等可重跑
  • survey_detail 迁移包含 equip_id(关联 customer_equipment)与索引
  • equip_type 注释/文档/枚举包含「配电柜」
  • db_init.sql 与 系统设计/表结构新增及变更.md 已同步

后端能力

  • customer_equipment 实体含 parentId,survey_detail 实体含 equipId
  • GET /api/customer-equipments/tree 返回按 parent_id 组装的嵌套树,权限过滤与 list 一致
  • create/update 支持 parentId 且校验父设备同客户、非自身/子节点(防循环)
  • saveDetails 接收 equipId 并校验设备属于工单客户;DTO 校验对齐
  • 工单详情接口返回设备树数据(供拓扑图渲染)

前端:向导迁移与两步化

  • 新建向导路由迁移至 /customer/visit/survey/create,旧 /dispatch/survey/create 移除
  • 向导为 2 步(基本信息 / 指派电工与服务报酬),无「勘察明细」步骤,提交不含 details
  • 台账页头无「发起勘察派单」按钮,访问 /dispatch/survey?customerId=xx 不再自动跳转
  • 客户拜访「一键发起勘察派单」直跳新向导路由并预填客户
  • 台账行操作「更多」含「勘察明细」菜单项,跳 /dispatch/survey/:id/details

前端:勘察明细页面与拓扑图

  • /dispatch/survey/:id/details 页面:左侧设备树渲染正确(调 tree 接口)
  • 支持新增/编辑/删除设备,父节点可选,类型含「配电柜」
  • 设备节点照片/备注保存走 saveDetails(equipId + photos + remark)且成功后树/明细刷新
  • 台账详情弹窗按拓扑图展示勘察明细(节点带照片/备注),无数据时空态
  • 设备管理台账 equipTypeOptions 含「配电柜」,支持父设备选择

验证

  • server 编译通过、client 构建通过
  • 接口实测通过(tree、saveDetails、create 带 parentId)
  • 浏览器端到端验证通过(发起派单 → 两步向导;台账明细页 → 设备树维护;详情拓扑图)
  • 生产库迁移已应用(经确认后)