mky-vent-base/docs/_agent_fire_dust.json

[
  {
    "module": "喷淋监控系统",
    "file": "src/views/vent/monitorManager/sprayMonitor/index.vue",
    "lines": "68-140",
    "title": "多路控制按钮共用同一 paramcode/value",
    "severity": "critical",
    "type": "wrong_control_payload",
    "symptom": "除急停外，补水阀/搅拌阀/组化泵/上料机/喷洒自动等按钮下发完全相同的指令，设备无法按按钮区分控制，存在误控风险",
    "root_cause": "operations 全部使用 key='run_auto_sign'，且多数 value='0'；BasicMonitoring.deviceControl 仅按 key/value 下发",
    "repro": "打开喷淋监控→输入密码点击“补水阀启停”与“喷洒自动”→抓包可见 paramcode/value 相同",
    "fix_hint": "为每个操作配置独立 paramcode，并按启停状态设置正确 value（参考业务点表）"
  },
  {
    "module": "喷淋监控系统",
    "file": "src/components/vent/BasicMonitoring.vue",
    "lines": "19,193-201",
    "title": "操作列表 :key 冲突 + 空场景崩溃",
    "severity": "high",
    "type": "vue_key_collision/null_crash",
    "symptom": "喷淋多个按钮共用 key 导致 DOM 复用异常；无场景数据时页面直接抛错白屏",
    "root_cause": "v-for 使用 item.key 作唯一键但喷淋键重复；getSysDataSource 无空数组守卫直接取 options[0].id",
    "repro": "1) 打开喷淋页观察按钮交互状态错乱；2) 后端返回空 records 时进入页面立即报错",
    "fix_hint": "key 使用 label 或唯一 id；取首项前判断 records.length"
  },
  {
    "module": "智能注氮系统",
    "file": "src/views/vent/monitorManager/compressor/index.vue",
    "lines": "93-126",
    "title": "空列表崩溃且 modalType 未随系统类型切换",
    "severity": "high",
    "type": "null_crash/stale_config",
    "symptom": "无注氮系统时白屏；依赖 modalType 的矿端组件始终按 nitrogenUnderground 建模",
    "root_cause": "options.value[0]['id'] 无空判断；changeModalType 中 modalType 赋值被注释，仅改了 moduleTypeName",
    "repro": "空数据进页崩溃；潞宁等使用 modalType 的矿切换空压机/制氮机后模型类型不变",
    "fix_hint": "空 records 提前 return；恢复按 strsystype 设置 modalType"
  },
  {
    "module": "智能注氮系统",
    "file": "src/views/vent/monitorManager/compressor/components/nitrogenHome_ln.vue",
    "lines": "341-349",
    "title": "监测数据忽略选中系统ID",
    "severity": "high",
    "type": "wrong_data_binding",
    "symptom": "切换注氮系统后仍展示 msgTxt[0] 数据，监控内容与下拉选择不一致",
    "root_cause": "getDataSource(systemID) 入参未用于请求，固定取 res.msgTxt[0].datalist",
    "repro": "配置≥2套注氮系统→切换下拉→数据不随 systemId 变化",
    "fix_hint": "按 systemID/deviceId 过滤或带参请求对应系统数据"
  },
  {
    "module": "智能注浆系统",
    "file": "src/views/vent/monitorManager/groutMonitor/index.vue",
    "lines": "110-119,67,86",
    "title": "空数据崩溃且 currentDeviceType 永不赋值",
    "severity": "high",
    "type": "null_crash/dead_state",
    "symptom": "无注浆系统时白屏；传给 groutHome 的 device-type 恒为空字符串",
    "root_cause": "options.value[0]['id'] 无守卫；deviceChange 只写 deviceType，从未写入 currentDeviceType",
    "repro": "空列表进页崩溃；有数据时检查 groutHome props.deviceType 为空",
    "fix_hint": "空 records 保护；deviceChange/getSelectRow 同步 currentDeviceType"
  },
  {
    "module": "密闭监测系统",
    "file": "src/views/vent/monitorManager/obfurageMonitor/index.vue",
    "lines": "89-138",
    "title": "空数据崩溃且切换系统不刷新关联设备",
    "severity": "high",
    "type": "null_crash/stale_state",
    "symptom": "无密闭系统/无关联设备时崩溃；切换密闭点后历史页设备 Tab 仍是旧设备",
    "root_cause": "直接访问 msgTxt[0]、deviceArr[0]；getSelectRow 只改 optionValue，未调用 getDeviceList",
    "repro": "空数据进页；有多套密闭→切换后打开历史监测看设备按钮未更新",
    "fix_hint": "空数组守卫；getSelectRow 内调用 getDeviceList()"
  },
  {
    "module": "防火门智能管控",
    "file": "src/views/vent/home/configurable/firedoor/fireDoorMonitor.vue",
    "lines": "76-99",
    "title": "场景列表为空仍继续后续逻辑且配置增强未启用",
    "severity": "medium",
    "type": "incomplete_init",
    "symptom": "无防火门场景时下拉为空、模块无有效数据；服务端配置未走 updateEnhancedConfigs",
    "root_cause": "records 为空时仍调用 loadFireGateData；updateEnhancedConfigs 被注释",
    "repro": "manageFireList 返回空→页面无场景可选且面板无数据",
    "fix_hint": "无 records 时提示并 return；恢复 updateEnhancedConfigs(configs)"
  },
  {
    "module": "机电硐室管控",
    "file": "src/views/vent/home/configurable/electroChamber.vue",
    "lines": "86-99,29-50",
    "title": "拉取配置后强制覆盖为本地测试配置且历史无设备ID",
    "severity": "high",
    "type": "hardcoded_override/missing_param",
    "symptom": "线上始终使用 testConfigElectro；切历史 Tab 时 deviceId 常为空导致查询无效",
    "root_cause": "fetchConfigs 成功后 configs.value=testConfigElectro；optionValue 仅来自路由 query，无设备选择赋值",
    "repro": "非 A02A02 环境打开页面看配置是否被测试数据覆盖；无 query.id 切历史记录",
    "fix_hint": "生产去掉测试覆盖；补充硐室/系统选择并写入 optionValue"
  },
  {
    "module": "报表数据映射",
    "file": "src/views/vent/reportManager/comment/reportMap.vue",
    "lines": "82-119,135-145",
    "title": "reactive 表单被整体重赋值 + 部门树空 children 崩溃",
    "severity": "high",
    "type": "reactivity_break/null_crash",
    "symptom": "新增/编辑后表单状态异常；部门节点无 children 时查询部门树直接报错",
    "root_cause": "formState= {...} 丢弃 reactive 代理；el.children.forEach 未判空",
    "repro": "编辑一条映射再点新增观察表单残留；部门树缺 children 的节点触发加载",
    "fix_hint": "用 Object.assign(formState, ...) 或重置字段；forEach 前守卫 children"
  },
  {
    "module": "报表数据映射",
    "file": "src/views/vent/reportManager/comment/report-modal.vue",
    "lines": "135-151",
    "title": "编辑时 JSON.parse(mineCells) 在非字符串时抛错",
    "severity": "high",
    "type": "type_error",
    "symptom": "编辑已有映射弹窗打开失败或控制台 TypeError",
    "root_cause": "watch 中无条件 JSON.parse(formStates.mineCells)；接口若已反序列化为数组则解析失败；且 Object.assign 不会清除旧 id",
    "repro": "打开编辑，当 record.mineCells 为数组或空时复现",
    "fix_hint": "typeof===string 再 parse，数组则直接使用；新增时显式清空 id"
  },
  {
    "module": "安全监控分站管理",
    "file": "src/views/vent/safetyList/index.vue",
    "lines": "234-257,408-417",
    "title": "卸载引用未定义 timer + children 空指针 + 分页 total 错误",
    "severity": "high",
    "type": "reference_error/null_crash",
    "symptom": "离开页面报 timer is not defined；devInfoList 为空时列表渲染崩溃；分页总数异常",
    "root_cause": "timer 声明被注释但 onUnmounted 仍引用；el.children=el.devInfoList 后直接 forEach；res.total 在数组结果上常为 undefined",
    "repro": "进入页再离开；返回含 null devInfoList 的分站；观察 pagination.total",
    "fix_hint": "删除或恢复 timer；`(el.devInfoList||[]).forEach`；按接口实际结构取 records/total"
  },
  {
    "module": "158分站监测",
    "file": "src/views/vent/safetyList/common/detail.vue",
    "lines": "977-1002,1013-1022",
    "title": "devInfoList 为空时 forEach 崩溃",
    "severity": "high",
    "type": "null_crash",
    "symptom": "部分分站无子设备时详细信息表加载失败",
    "root_cause": "el.children = el.devInfoList 后未判空直接 forEach（getStationList1/getStationListAll）",
    "repro": "选择无测点的分站查看详细信息",
    "fix_hint": "使用可选链或默认空数组后再遍历"
  },
  {
    "module": "130分站监测",
    "file": "src/views/vent/safetyList/common/detail-130.vue",
    "lines": "865-892",
    "title": "devInfoList 空指针（同 index/detail）",
    "severity": "high",
    "type": "null_crash",
    "symptom": "130 分站无子设备时列表处理抛错",
    "root_cause": "el.children.forEach 未处理 null/undefined devInfoList",
    "repro": "打开 130 详情页并选中无设备分站",
    "fix_hint": "遍历前 `el.children = el.devInfoList || []`"
  },
  {
    "module": "235分站监测",
    "file": "src/views/vent/safetyList/common/detail-235.vue",
    "lines": "352-369,608-768,888,958-1013",
    "title": "235 页面误用 130 协议 API",
    "severity": "critical",
    "type": "wrong_api",
    "symptom": "235 分站参数下发、改名、删除等操作打到 130 接口，控制/配置失败或污染错误协议设备",
    "root_cause": "从 detail-130 复制后未替换：set130StationData/update130DevName/remove130Device/remove130Substation；api 中亦无对应 235 写接口",
    "repro": "在 235 监测详情编辑并下发任意参数，观察请求 URL 含 130 路径",
    "fix_hint": "补齐并改用 235 专用读写/删除 API，移除 130 引用"
  },
  {
    "module": "用户日志管理",
    "file": "src/views/monitor/log/index.vue",
    "lines": "2,56-84",
    "title": "v-modal 拼写错误 + 登录统计破坏 searchInfo 响应式",
    "severity": "high",
    "type": "typo/reactivity_break",
    "symptom": "Tab 无法双向绑定；切到“登录统计”后查询条件失效、列表参数丢失 logType",
    "root_cause": "模板写 v-modal 而非 v-model；case '4' 执行 searchInfo={} 丢掉 reactive 代理",
    "repro": "打开日志页切换 Tab；切到登录统计后再查询",
    "fix_hint": "改为 v-model；用 Object.keys 清空或重置字段，禁止重赋 searchInfo"
  },
  {
    "module": "用户日志管理",
    "file": "src/views/monitor/log/index.vue",
    "lines": "34,61-66",
    "title": "初始 fieldMapToTime 格式与切换后不一致",
    "severity": "medium",
    "type": "config_mismatch",
    "symptom": "首次进入登录日志时时间范围映射可能无效，切 Tab 后才正常",
    "root_cause": "paramTime 初始为扁平数组，tabChange 才设为 [[field,[begin,end],fmt]] 结构",
    "repro": "首次进入不切 Tab，使用时间筛选对比切 Tab 后行为",
    "fix_hint": "初始化即使用与 case '1' 相同的 fieldMapToTime 结构"
  },
  {
    "module": "文件共享中心",
    "file": "src/views/vent/performance/fileDetail/index.vue",
    "lines": "292-314,367-377,387",
    "title": "空树上标崩溃 + 可空文件上传 + nodeParam 丢失响应式",
    "severity": "high",
    "type": "null_crash/invalid_upload",
    "symptom": "无目录时白屏；未选文件仍可点确定上传；树节点切换后表格参数可能异常",
    "root_cause": "listArr[0] 无守卫；handleOk 不校验 fileList；nodeParam=node 重赋放弃 reactive",
    "repro": "空目录数据进页；打开上传不选文件点确定；切换目录观察列表 parentId",
    "fix_hint": "空树提示；上传前校验 fileList.length；Object.assign(nodeParam, node)"
  },
  {
    "module": "文件共享中心",
    "file": "src/views/vent/performance/fileDetail/index.vue",
    "lines": "243-261",
    "title": "setInterval 用 clearTimeout 清理",
    "severity": "medium",
    "type": "resource_leak",
    "symptom": "汇总报表轮询可能无法可靠停止，关闭弹窗后仍请求",
    "root_cause": "timer=setInterval 但 handleCancelHz/onUnmounted 使用 clearTimeout",
    "repro": "打开汇总报表后关闭弹窗，观察是否仍持续请求 queryVentMonReportJd",
    "fix_hint": "统一使用 clearInterval(timer)"
  },
  {
    "module": "视频墙",
    "file": "src/views/vent/monitorManager/camera/index.vue",
    "lines": "100-128,172-178",
    "title": "设备树加载与分页 paramKind 计算脆弱",
    "severity": "high",
    "type": "null_crash/wrong_param",
    "symptom": "itemValue 无 '&' 或 msgTxt 结构异常时树展开/翻页失败或请求错误类型",
    "root_cause": "假定 msgTxt[0].datalist 存在；分页用 searchParam.devKind.indexOf('&') 对 nodeData.itemValue 做 substring，缺 '&' 得空串",
    "repro": "点击 itemValue 不含 '&' 的分类再翻页；或返回空 datalist 的节点",
    "fix_hint": "安全解析 itemValue；访问 datalist 前判空；分页直接用 nodeData.itemValue"
  },
  {
    "module": "需风量分析系统",
    "file": "src/components/vent/micro/createSubApp.vue",
    "lines": "15-37",
    "title": "非 micro-* 路径组件恒为 null",
    "severity": "high",
    "type": "shell_mount_failure",
    "symptom": "菜单若未挂在 micro-need-air/micro-vent-doc 前缀下则壳空白",
    "root_cause": "resetComponent 仅识别有限 appType",
    "repro": "用非 micro 路径打开需风量/核定",
    "fix_hint": "按实际菜单 path 扩展映射"
  },
  {
    "module": "喷雾降尘监控",
    "file": "src/router/helper/routeHelper.ts",
    "lines": "21-28,98-113,122-146",
    "title": "layouts/RouteView 组件文件缺失导致路由无法解析",
    "severity": "critical",
    "type": "missing_component",
    "symptom": "菜单 component 配为 layouts/RouteView 的父级打开空白/路由失败",
    "root_cause": "src/layouts 下无 RouteView.vue；LayoutMap 未注册；dynamicImport 只扫 views/components",
    "repro": "后端菜单配置 component=layouts/RouteView 后进入喷雾降尘父路由",
    "fix_hint": "新增 layouts/RouteView.vue 并加入 LayoutMap；菜单改为已存在布局"
  },
  {
    "module": "喷雾降尘监控",
    "file": "src/views/vent/home/configurable/dust.vue",
    "lines": "87-93",
    "title": "服务端配置被测试数据覆盖且只用 Mock",
    "severity": "high",
    "type": "hardcoded_override",
    "symptom": "粉尘首页始终展示 testConfigDust + BDDustMock，真实监测数据不刷新",
    "root_cause": "fetchConfigs('dust') 后强制 configs=testConfigDust，并用 Promise.resolve(BDDustMock) 代替 getHomeData",
    "repro": "任意环境打开粉尘可配置首页，对比接口与页面数据源",
    "fix_hint": "生产移除测试覆盖，恢复 getHomeData 轮询"
  },
  {
    "module": "喷雾降尘监控",
    "file": "src/views/vent/home/configurable/dustControl.vue",
    "lines": "53-54",
    "title": "错误 pageType 拉取后再覆盖测试配置",
    "severity": "high",
    "type": "wrong_param/hardcoded_override",
    "symptom": "降尘管控页配置与粉尘业务不匹配，最终仍被本地测试配置覆盖",
    "root_cause": "fetchConfigs('mine_fire') 后 configs.value=testConfigDustControl",
    "repro": "打开 dustControl 页检查 configuration 请求 pageType 与最终 configs",
    "fix_hint": "使用正确粉尘 pageType，并按环境决定是否使用测试配置"
  },
  {
    "module": "安全监控分站管理",
    "file": "src/views/vent/safetyList/index.vue",
    "lines": "144-146,71-76",
    "title": "调试风向取值与展示映射不一致",
    "severity": "medium",
    "type": "value_mismatch",
    "symptom": "调试选“反向”写入 '0'，列表展示逻辑把反风映射为 '2'，显示异常",
    "root_cause": "derictList 反向 value='0'，而 valueJc 渲染把 '2' 当作反风",
    "repro": "调试设备选反向并确认，查看列表风向展示",
    "fix_hint": "统一风向枚举（建议 1 正/2 反）并同步调试与展示"
  },
  {
    "module": "报表管理",
    "file": "src/views/vent/reportManager/index.vue",
    "lines": "89-106",
    "title": "三类根节点重复挂载同一套子树",
    "severity": "medium",
    "type": "wrong_tree_build",
    "symptom": "系统/手动/模板三类下出现完全相同的业务分类，筛选易混淆",
    "root_cause": "getTreeList 对 listArr 每个根节点都 push 完整 res 树，未按业务类型分流",
    "repro": "打开报表管理对比三个根节点的 children",
    "fix_hint": "按返回字段或接口分类型填充到对应根节点"
  },
  {
    "module": "智能注浆系统",
    "file": "src/views/vent/monitorManager/groutMonitor/index.vue",
    "lines": "1-35",
    "title": "2D 模型与 groutHome 同时渲染可能叠层",
    "severity": "medium",
    "type": "ui_logic",
    "symptom": "is2DModel 为 true 时流程图与监控壳同时存在，交互/遮罩异常",
    "root_cause": "v-if is2DModel 渲染 modelComponent，同时 activeKey==monitor 仍挂载 groutHome",
    "repro": "开启全局 is2DModel 进入注浆监控页",
    "fix_hint": "2D 时由单一容器负责模型，或让 groutHome 在 2D 模式跳过三维初始化"
  },
  {
    "module": "机电硐室管控",
    "file": "src/views/vent/home/configurable/configurable.data.ts",
    "lines": "6164,6217",
    "title": "electro-champer / electro-chamber pageType 拼写分裂",
    "severity": "medium",
    "type": "config_typo",
    "symptom": "部分配置按错误 pageType 入库后，fetchConfigs('electro-champer') 只能拿到半套模块",
    "root_cause": "同一业务存在 champer/chamber 两种 pageType 字面量",
    "repro": "在配置表按两种 pageType 各查一次 records 数量",
    "fix_hint": "统一为一种拼写并做数据迁移"
  },
  {
    "module": "密闭监测系统",
    "file": "src/views/vent/monitorManager/obfurageMonitor/index.vue",
    "lines": "107-113",
    "title": "forEach 内 data=Object.assign 未回写",
    "severity": "medium",
    "type": "dead_assignment",
    "symptom": "readData 字段未合并进列表项，监测展示缺字段",
    "root_cause": "dataSource.forEach 中 `data = Object.assign(data, readData)` 只改局部绑定，未写回数组元素",
    "repro": "对比接口 readData 与页面 options 字段是否缺失",
    "fix_hint": "改为 Object.assign(data, readData) 不重绑，或显式写回"
  }
]