city-life-line/memory/sessions/2026-10-16.md

2026-10-16：PC 预警发布、列表与详情优化

目标

• 优化预警发布、待办、处置和综合查询四个 PC 页面。
• 发布草稿时选择处置人和核验人，发布人默认草稿创建人。
• 关联设备按 equipment_warning_type 中当前预警类型对应的设备类型过滤。
• 统一预警详情的处置时间、时间轴和附件展示。

结论与变更

• LRelease.vue 的新增/编辑表单移除发布人、处置人、核验人，将关联设备和内容描述移动到类型/级别后；发布操作新增处置人、核验人选择弹窗，并同时提交两个账号。
• 新增 /warning/config/equipment-type-ids，通过 warning_type.warning_code 和 equipment_warning_type.warning_type_id 返回允许的设备类型；设备分页接口支持设备类型集合过滤，保存草稿时后端再次校验设备与预警类型的关系。
• 草稿创建时将发布人初始化为创建人，发布时仍以 create_by 为准，兼容历史数据时回退当前发布人。
• 四个主列表按要求移除序号/权属单位列并增加预警内容；待办查询移除预警专项、权属单位、发布人、处置人；综合查询表格使用内容列填充可用宽度。
• 新增共享 WarningDisposalTimeline.vue，参照工单详情按日期倒序分组，展示时分节点、人员、动作、内容、原因和附件；共享附件改为文件类型卡片样式，保留受控预览/下载接口。
• 无数据库结构变更，前后端需要同步部署。

验证

• node --test tests/warningAttachments.test.mjs tests/warningReviewAction.test.mjs：8 项通过。
• 6 个相关 Vue SFC 使用 @vue/compiler-sfc 完成脚本和模板编译检查。
• mvn -pl pipe-network-service/zksy-admin -am -DskipTests compile：成功。
• 前后端 git diff --check：通过。
• npm run build:prod：完成 1816 个模块转换后失败；既有 DisPlanEditing.vue 引用 xlsx，但当前依赖未安装（npm ls xlsx --depth=0 为空），与本次预警变更无关。

风险与后续

• 联调环境需确认各预警类型已在 equipment_warning_type 配置设备类型；未配置时设备选择器会明确提示且不能选择设备。
• 完整生产构建需先补齐项目既有 xlsx 依赖问题。

详情标题栏补充优化

• 四个预警详情抽屉将预警单号移入“预警详情”标题右侧，并将当前状态放到同一行右侧；详情字段区不再重复显示单号和状态。
• 清除 Element Plus 抽屉头部默认的大间距，头部与正文分别使用 10px、12px 的紧凑间距；有关联事项时同步去掉事项卡片顶部重复留白。
• 四个详情字段区将预警内容调整为第一行并跨两列展示。
• 相关列表的预警编号列统一加宽到 210px，避免常见长编号换行。
• 新增共享 WarningContentCell.vue，列表预警内容单行省略，点击后通过弹层查看可换行、可滚动的完整内容。

预警详情统一

• 新增公共 components/WarningDetailDrawer.vue 和 warningDetail.js，统一详情加载、字段兼容和布局；预警内容置顶，按基础信息、关联事项、关联报警、处置记录、督办记录、其他附件、电子存档分区展示。
• 发布、待办、处置、综合查询、关联管理、首页、今日预警、今日未处置、历史预警及管网预警共 10 个查看入口改用公共详情抽屉；待办通知已读等页面特有逻辑仍留在父页面。
• 报告上传和发布编辑继续使用详情数据，但统一改调 api/pipeNetwork/earlyWarning.js 的 getWarningFullDetailData；删除 yjfb.js 中重复的详情 API 封装和概览模块旧版详情抽屉。
• 后端删除未被仓内调用的简版 /warning/detail/{warningId} 及对应 Service 方法，以 /warning/detail/full/{warningId} 作为唯一详情接口；无数据库变更。
• 新增 tests/warningDetail.test.mjs，覆盖下划线/驼峰字段兼容、数值零和完整详情集合标准化。

统一详情验证

• 11 项预警详情、附件和核验相关 Node 测试通过。
• 12 个受影响 Vue SFC 的模板与脚本编译通过，前后端 git diff --check 通过。
• mvn -pl pipe-network-service/zksy-admin -am -DskipTests compile：成功。
• npm run build:prod：相关代码完成 1823 个模块转换，最终仍因既有 DisPlanEditing.vue 无法解析本地 xlsx 依赖而失败，与本次变更无关。
• Vite 开发服务 http://localhost:5173/ 返回 200，无热更新错误。

处置记录图片预览补充

• 统一预警详情的处置时间轴改为与工单详情一致的图片交互：图片附件显示 50×50 缩略图，点击后查看大图，同一条处置记录的多张图片可在预览器中切换。
• 缩略图继续通过受控附件预览接口读取，不暴露对象存储地址；非图片附件仍保留原文件卡片、预览和下载操作，“其他附件”区域维持原布局。
• 图片 Blob URL 在附件变化和组件销毁时主动释放；加载失败时在缩略图位置展示明确状态。
• 11 项预警附件、详情和核验测试通过，WarningAttachments.vue、WarningDisposalTimeline.vue 模板与脚本编译通过，前端 git diff --check 通过；Vite 热更新无组件编译错误，本地仅有后端 8301 未启动造成的既有 SSE 代理失败。

处置记录人员昵称补充

• 处置记录查询关联 app_user.sys_user，新增 disposal_user_name 返回昵称；昵称为空或历史账号已无法匹配时回退 warning_disposal.disposal_user。
• 公共预警详情时间轴优先展示昵称字段，数据库仍保存登录账号，流程人员校验、统计和历史审计语义不变。
• 管理后端 Maven 编译、公共时间轴 Vue 编译及前后端 git diff --check 均通过，Vite 热更新无新增错误。

详情入口文案统一

• 预警发布、待办、今日预警、今日未处置和历史预警列表中原“查看”或“查看详情”按钮统一改为“详情”，与预警处置、综合查询、首页和管网预警入口一致。
• 关联管理保留“查看预警”和“报警详情”，避免同一操作列中两个不同详情对象产生歧义。
• 5 个受影响 Vue SFC 编译通过，预警相关页面已无“查看详情”或单独“查看”的详情按钮，git diff --check 和 Vite 热更新检查通过。

新增预警设备类型来源调整

• 新增/编辑预警的关联设备选择器左栏直接使用 /equipmentType（equipment_type）接口返回的 id、typeName，不再由前端推导并展示设备根大类。
• 左栏接口类型与当前预警类型在 equipment_warning_type 中的关联 ID 取交集，只展示实际允许的具体设备类型；点击类型后通过 equipmentTypeId 精确筛选，选择“全部类型”时仍通过 equipmentTypeIds 限制在允许范围内。
• LRelease.vue 模板与脚本编译、11 项预警测试及 git diff --check 通过，Vite 热更新无错误。

两端发布人员与待办闭环

• 目标：PC/移动端统一按设备所属公司及角色权限筛选处置人、核验人；核验人仅在当前账户具备 audit 权限且属于合格候选集合时默认当前账户，仍可改选其他人。
• 后端 WarningParticipantService 按关联设备的直接父类型与部门自身/祖先公司匹配候选人员，处置 handle、核验 audit 分开；权限过滤在分页前执行，发布再次校验人员资格。新增 WarningAccessService/WarningAccessScope，统一管理、详情、归档、流程操作及移动端数据范围；公司范围不对管理员豁免。
• EarlyWarningMapper.xml 复用可见性/待办 SQL：公司范围内有 publish 权限可处理所有 DRAFT，不再要求系统自动创建；待办按权限、指定人员与状态计算，不依赖待办记录；发布时间为空时用创建时间过滤。发布人保持创建人。
• PC LRelease.vue 使用 warningId/role 查询候选部门和人员；新增 components/WarningPublishAction.vue，接入 WarningWorkflowActions.vue，支持草稿直接发布、远程搜索、合格当前账户默认及异步防覆盖。LwarningDisp.vue 保留服务端 availableActions。
• 移动端 WarningActionDrawer.vue、warning-detail.vue、services/warnings.ts 使用相同候选规则；选择器增加占位项，允许选第一个实际人员；操作成功增加版本标记，待办/管理列表返回时仅按预警变更定向刷新，普通 onShow 不重复请求。
• 验证：后端 MobileControllerMappingTest、WarningParticipantServiceTest、WarningScopeMapperTest 合计 15 项通过；PC node --test tests/warning*.test.mjs 15 项通过，npm run build:prod 成功（此前 xlsx 构建问题当前已不复现）；移动端类型检查、H5 构建及 2 项抽屉行为测试通过。三仓 git diff --check 通过。
• 风险/后续：尚未进行真实 Kingbase 与登录态端到端联调，需同步部署 PC、移动端及后端；候选权限依赖实际角色授权与部门/设备关联数据。无新增数据库结构迁移，保留此前已有修改。

工单与预警统一选人及共享设备例外

• 目标/结论：工单选人与预警对齐，设备直接父类型 1/2/3 对应部门自身或祖先 101/102/103；工单没有设备或两类业务父类型为 4 时不按候选部门过滤，仅要求用户启用、未删除且具备角色对应权限。公司外或无部门合格用户可选，关联损坏不作为无设备放宽。
• 后端 WorkOrderServiceImpl、SysUserMapper 新增业务候选查询，工单 handler/reviewer 分别要求 process/audit 权限；候选 API 携带 orderId/type，提交派单再次校验。WarningParticipantMapper 父类型 4 不限制部门。工单派单后按指定责任人/核验人与状态办理；EarlyWarningMapper 为共享设备指定人员增加可见性例外，保证公司外候选能够办理，不扩大其他预警和草稿范围。
• PC ops/workOrder/dispose.vue 与 api/pipeNetwork/ops/workOrder.js 携带工单及角色查询部门/人员，合格当前账户才默认核验人，异步结果不覆盖改选或新工单。移动端 services/workorders.ts、workorder-detail.vue 同步参数，ActionFormDrawer.vue 使用核验人统一文案；预警空候选提示兼容共享设备。
• 验证：后端五类回归合计 83 项通过（64 工单、8 Controller、6 预警人员、3 预警范围、2 Mapper SQL）；PC 工单/预警/状态行为测试 10 项、移动端预警抽屉 2 项通过。PC 生产构建、移动端类型检查及 H5 构建通过，三仓 diff 空白检查通过。新增回归覆盖无设备/父类 4、常规公司范围、角色权限、提交复核和公司外人员后续办理。
• 风险/后续：无结构迁移；工单候选接口新增必填业务参数，需要后端、PC、移动端同步部署。尚未进行真实 Kingbase 与登录态端到端联调，保留已有修改。

两端详情内容优先与处置人员分区

• 目标/结论：预警内容放进“预警信息”第一行，人员区域统一为“处置相关人员”。工单详情顺序改为故障信息、设备信息、处置相关人员，故障描述独占首行并保留换行，人员区单独展示处置人、核验人；工单产品文案将责任人统一称为处置人。
• PC 修改共享 WarningDetailDrawer.vue，拆出设备与人员分区，所有预警详情入口同步；warningDetail.js 兼容人员昵称的驼峰/下划线字段。工单 dispose.vue 重排详情、修改派单及提示，工单 index/list、供水旧工单页和报警关联工单同步改名。
• 移动端 warning-detail.vue、workorder-detail.vue 同步内容与分区顺序，ActionFormDrawer.vue 和报警关联工单同步改名，services/workorders.ts 增加 verifyUserName 类型。
• 后端 WorkOrderVO 新增 verifyUserName，WorkOrderServiceImpl 将处置人与核验人 ID 合并批量查询，昵称优先回填；派单及身份校验提示、新派单日志同步使用处置人。接口原有 ID 字段及选人权限不变，历史存储日志不改写。
• 验证：新增工单详情两人昵称单批回填回归，工单 Service 65 项通过；PC 相关行为 10 项、移动端 2 项通过；PC 生产构建、移动端类型检查/H5 构建通过，最后追加的关联工单文案变更通过 SFC 编译。三仓 diff 空白检查通过。
• 风险/后续：本次无数据库迁移；需部署后端新增字段以展示核验人姓名，真实登录页面与设备数据尚未端到端验收。保留三仓已有修改。

详情描述字体统一

• 按用户要求，PC 与移动端故障描述、预警内容改为普通字重；移动端去掉独立字号、颜色，PC 预警内容继承普通字段字号和颜色，保持首行位置及换行能力。
• 修改两端预警与工单详情四个组件；仅涉及 CSS，无接口或后端改动。
• 验证：四个 Vue 组件样式编译通过，两端 diff 空白检查通过；无需后端更新，真实页面待用户验收。