Domů Procházet Nápověda
Registrovat se Přihlásit se
shaoy
/
city-life-line
1
0
Rozštěpit 0
Soubory Úkoly 0 Pull Requesty 0 Wiki
Strom: 7bf06ea3ae
Větve Značky
city-life-line
/
memory
/
sessions
/
2026-09-23.md

2026-09-23.md 10 KB
Historie Surový

2026-09-23：物联感知设备管理页三处调整

目标

用户要求调整 ../../src/views/subSystem/pipeNetwork/assetInfo/equipmentBase/index.vue（设备管理页）：

  1. 表单页把「规格参数」移到「生产日期」之后，输入框宽度同步调整。
  2. 表单页地图选点时，自动把解析出的地址回填到「安装位置」。
  3. 详情弹窗按表单编辑页的分区方式展示。

结论与改动

文件：../../src/views/subSystem/pipeNetwork/assetInfo/equipmentBase/index.vue

  • 基础信息区：新增「规格参数」el-col :span="12"，紧跟在生产日期之后（与生产日期同一行，宽度随半栏自适应）；从资产信息区移除原来的 span=24 整行版本。
  • 资产信息区：保留 资产状态 / 资产价值 / 使用年限 三项（span 12 不变），不再包含规格参数。
  • 地图选点回填地址：
    • 新增 reverseGeocode(lng, lat)（基于 window.BMapGL.Geocoder 的逆地理编码，BD-09 坐标）与 extractAddress(result)（兼容 address / content.address / addressComponents / address_detail 多种返回形态，失败返回空串）。
    • handleMapClick(point) 在写入经纬度（bd09 → wgs84）后调用 fillLocationByPoint(point.lng, point.lat)，解析成功即覆盖 form.equipmentLocation，失败保留原值。
    • 新增 locationTip 提示文案（解析中 / 已回填 / 解析失败），绑定在坐标输入下方的 .coordinate-tip，并在 reset() 与 openMapPicker() 中清空。
    • 地图选点弹窗底部新增「解析地址」一行，实时显示回填结果。
  • 详情弹窗：由单个 el-descriptions 拆成 基础信息 / 资产信息 / 部署运维 三段，分别用 .form-section-title.detail-section-title 分区标题，字段顺序与表单页一致；新增 .detail-section-title { margin-top: 18px; } 样式。

验证

  • read_lints 对该文件仅返回既有的 38 条警告（未知 element 标签、未解析变量等旧告警），无新增错误。
  • 未执行构建/运行时验证：逆地理编码依赖 index.html 全局加载的百度地图 WebGL SDK 与网络可达性，需前端实际点选地图确认。

风险与后续

  • 逆地理编码在地图 SDK 未加载或解析失败时静默降级，仅通过提示文案告知用户，不会阻断保存。
  • 回填会覆盖已手工填写的安装位置；若后续希望「仅在为空时回填」，需调整 fillLocationByPoint。

第二轮：列表区布局调整

  • 删除「设备台账」卡片副标题“一览管网监测设备台账与运行状态”。
  • 查询条件（筛选表单）从设备台账卡片中移出，单独成卡 .filter-card，放在 KPI「设备统计」框下方；「新增设备」按钮上移到页头右侧。
  • 「设备台账」改为分区标题（复用 .form-section-title + 新增 .section-block-title），放在设备列表卡片之上，参考「设备统计」页头的摆放方式。
  • 同步删除已无用的 .card-header-row / .card-title / .card-subtitle / .ledger-actions 样式。

第三轮：设备台账标题样式与位置

  • 「设备台账」标题改用与「设备统计」相同的 .page-title 字体（20px / 600 / #0a1628），不再使用分区蓝边小标题样式。
  • 将「设备台账」标题从设备列表卡片上方移到查询条件输入框上方（.filter-card 之前），并用 .section-block-title 保留上下间距。列表卡片不再带标题。

案件设备关联调整：case_info 改用 equipment_id

目标与结论

  • 用户要求 case_info.device_id 更名为 equipment_id、删除 device_code；案件设备关联统一按设备主键查询。
  • 后端两份 CaseInfo 实体、Mapper、保存 DTO、案件列表/详情及三处自动建案逻辑已同步。新增案件提交 equipmentId，设备 ID 必填且必须存在，不再接收旧 deviceId 作为关联字段。
  • 案件接口的 deviceCode 仅作为出参展示字段保留，按 equipmentId 从 equipment_base.equipment_code 读取，设备编码变更不影响案件关联。
  • 已检查 src/api/pipeNetwork/basic.js 和 src/views/subSystem/manholeCover/caseHandling/circulation.vue：前端只展示 deviceCode，没有使用旧 deviceId 或新建案件调用，因此本轮不改前端运行代码；保留设备管理页既有修改。

脚本与验证

  • 后端新增 pipe-network-service/sql/migration_case_info_equipment_id.sql，支持有效 ID 保留、旧编码唯一回填、幂等重跑、异常回滚；不强制历史无关联案件补设备，不对依赖对象使用 CASCADE。
  • 管理端与 zk-api-service 编译通过；案件 service/controller、工单、清警共 33 项测试通过。
  • pipe-network-service/sql/tests/case_info_equipment_id_migration.test.mjs 在内存 PGlite 中通过 11 个场景，覆盖重复执行、编码变更、重复编码、新旧 ID 冲突、孤立关联及依赖视图的失败回滚。
  • 未连接或修改实际数据库。PGlite 仅作 PostgreSQL 兼容性验证，最终仍需在 KingbaseES 验收；上线前备份并停止案件写入，完整执行脚本后部署管理端和 API 服务，避免旧版本继续访问已删除的列。

四子系统统一报警审核

目标与结果

  • 新建 src/views/subSystem/alarm/index.vue、AlarmSummary.vue、alarmReviewModel.js 及 src/api/alarmReview.js，按用户原型提供查询、分页、审核弹窗和处置时间线，样式使用系统 Element Plus 卡片/表格/分页。
  • 删除被替代的供水两个审核 wrapper、排水 bjsh、燃气 krqildjc、井盖 alarmList，以及独占的旧 API。供水 WaterAlarmPage 保留管理/GIS，移除旧审核实现并导航至 /monitorAlarm/alarmAudit。
  • 菜单 2118/2142/2097/2024 均复用已有行，path 统一 alarmAudit、component 为 subSystem/alarm/index，query 按设备根类型和燃气报警编码隔离；后端再校验实际授权菜单。
  • 报警等级使用 alarm_level，1～4 对应一级～四级（红/橙/蓝/绿）；审核结果由后端枚举提供。审核意见两种结果均必填，附件最多 5 个/每个 10MB，未保存退出需确认，失败保留输入。
  • 确认报警创建待派单工单，但不改变设备状态或报警处理状态。误报警仅记录审核结论；状态与工单处置独立。
  • 后端脚本 pipe-network-service/sql/migration_alarm_review.sql：Kingbase int8 主键 + 独立 alarm_log_id_seq + nextval；不做历史迁移、不增加 source_key。新报警初始化及处理/工单过程通过触发器写 alarm_log，审核意见附件由审核事务记录。

验证

  • 前端 npm run build:prod 通过，既有 Sass 弃用和包体积提示未扩大处理范围。
  • 报警 UI 模型、审核新契约、原有报警 GIS、统一叶子 path 路由唯一性共 14 项 Node 测试通过。
  • 后端管理端 clean test 共 55 项通过；SQL 内存 PGlite 7 项通过。未连接真实数据库，未完成 KingbaseES 实机或真实登录 E2E。
  • zk-api-service 仍被既有缺失 CollectionAlarmWriter 类阻塞编译；已核对 HEAD 引用与文件树，未重写无关采集逻辑。部署说明在后端 docs/alarm-review-2026-09-23.md。

后续

  • 补回采集 API 的缺失类后重新编译；Kingbase 执行脚本并同步部署、重新登录验证 4 个菜单的数据隔离、审核/建单/时间线及实际附件访问。
  • 既有同设备未办结工单冲突规则保留，确认审核遇到冲突会整体回滚并提示，不会半成功。

报警审核列表底部文案清理

  • 按用户要求删除 src/views/subSystem/alarm/index.vue 分页下方说明文案及其专用 .list-note 样式，查询、审核和建单逻辑不变。
  • 同步更新 tests/waterAlarmAuditWorkbench.test.mjs，4 项测试通过，git diff --check 通过；本轮仅为文案清理，未重跑完整构建。

报警审核查询区域上下留白

  • 按用户反馈调整查询卡片：上下内边距统一为 16px、左右 20px，移除表单及表单项额外外边距；换行间距改由 flex gap 统一控制（行 12px、列 24px）。只影响报警审核页面查询区域。
  • 相关前端回归 5 项通过，Vue 模板及 scoped CSS 编译通过，git diff --check 通过；未重跑全量构建或真实页面截图验收。

报警处置记录图片缩略图与预览

  • 根据运行截图，将处置记录里的图片文件名链接改为 96×72 缩略图；点击使用 Element Plus 图片查看器放大，支持同条记录多图切换，预览层传送到 body 防止被抽屉裁切。
  • 新增 AlarmAttachments.vue，图片加载中/失败有占位提示；alarmReviewModel.js 统一筛选安全图片 URL，支持绝对地址、站内路径、大小写后缀以及查询参数/片段，不为非图片文件渲染链接。
  • 用户追加明确不要 PDF：审核表单文案、accept、前端校验和后端上传白名单/文件头校验均只允许 JPG/JPEG/PNG；尺寸及数量限制不变。本条取代前面初版支持 PDF 的描述，不删除历史存储文件。
  • 前端图片模型及审核页 11 项测试通过，Vue 脚本/模板/scoped CSS 编译通过；后端上传/审核/controller 共 13 项测试通过（含真实 PDF 头和伪装 PNG 的拒绝用例）。两个仓库 git diff --check 通过。未进行真实登录、实际图片网络加载的浏览器验收。
  • 本轮 npm run build:prod 生产构建通过。

报警空值展示与工单故障描述

  • 新增 hasActualValue 判断，列表及复用的审核/处置记录摘要在实际值为 null/undefined/空字符串时隐藏整行“实际值；阈值”；数字 0 和字符串 0 保持展示。
  • 修正后端审核建单传参：不再将审核意见传作 orderDesc，改由工单服务根据原报警生成故障描述，写入 work_order.order_desc。审核意见仍单独写入审核日志，审核事务、设备状态逻辑不变。
  • 自动生成的工单描述同样忽略没有实际值时的数值/阈值占位。不改历史工单，不需要结构脚本。
  • 前端相关 13 项测试和两个 SFC 的脚本/模板/样式编译通过；后端审核/controller/工单共 27 项测试通过，新增检查实际写入的 WorkOrder.orderDesc，覆盖实际值为 0 和为空。两个仓库 git diff --check 通过；未连接真实数据库或执行浏览器 E2E。