主题
05 巡检任务完成情况统计 — 指标体系、报表与智能体交付
对应需求：
IBMS功能模块-V1.md一.9 备注列「巡检任务完成情况统计（新图表）」。 交付设想：先定报告/报表样式，最终通过智能体 chatbox 触发或查看。 现有基础：NIMBUS 已有巡检工单（7 类工单同源：报修/巡检/保养/巡更/保洁/运送/投诉），已有工单统计能力。 项目背景：上海交通大学新院区，以 MBA 教学为主；巡检对象覆盖阶梯教室、案例讨论室、报告厅、面试间、公共区等资产/设备。
1. 现有基础与要做的事
| 已有 | 说明 |
|---|---|
| 巡检工单 | 已有，承载「谁、什么时候、巡检了什么、结果如何」 |
| 工单统计 | 可按类型 + 状态 + 时间统计，可算出巡检类工单的完成量/完成率/状态分布 |
| 工单状态机 | 7 类工单同源，派单、受理、完成、闭环直接复用 |
| 报表/BI | 报表引擎、BI 看板、ChatBI 可复用 |
| 要补 | 说明 |
|---|---|
| 巡检计划维度 | 计划、周期、范围、巡检项模板 |
| 巡检明细 | 资产/设备 + 巡检项 + 结果 + 证据 |
| 异常对象 | 异常类型、等级、处置状态、转工单关联 |
| 指标体系 | 完成率、按时率、漏检率、异常率、视觉抓拍成功率、人工复核率等口径 |
| 报表与智能体 | 图表、日报/周报/月报、chatbox 问答与推送 |
需求 4 和需求 5 是绑定的：规则/视觉巡检的明细与异常，最终要落到巡检工单和巡检明细上，统计才可信。 两块一起设计。
2. 先定义「完成情况」——口径比图表重要
| 指标 | 定义 | 口径陷阱 |
|---|---|---|
| 计划巡检任务数 | 周期内按计划应执行的任务数 | 计划变更/临时新增怎么算 |
| 应巡检项数 | 计划覆盖的资产/设备/巡检项总数 | 一台设备多个巡检项算 1 还是 N |
| 实际完成数 | 巡检工单状态为「已完成」的数量 | 「已提交」是否等于「已完成」 |
| 完成率 | 实际完成 / 应完成 | 分母用任务数还是巡检项数 |
| 按时完成率 | 在计划时间窗口内完成 / 应完成 | 提前完成算不算按时 |
| 漏检数/漏检率 | 计划内无巡检记录 / 应完成 | 设备停用/离线是否豁免 |
| 异常发现数 | 巡检明细结果为异常的数量 | 同一异常重复上报算 1 还是 N |
| 异常率 | 异常数 / 已完成巡检项 | 分母口径 |
| 有效异常数 | 转工单或人工确认的异常 | 谁来确认 |
| 误报率 | 标记误报 / 规则/视觉异常数 | 只对规则/视觉巡检有意义 |
| 转工单数 / 闭环率 | 异常转工单数 / 已闭环数 | 闭环以工单状态为准 |
| 平均处置时长 | 从异常发现到闭环 | 跨系统时间对齐 |
| 覆盖率 | 已巡检资产/设备 / 应巡检 | 按设备数还是空间数 |
| 规则/视觉巡检占比 | 规则/视觉完成任务 / 总任务 | 与人工分开统计 |
| 规则/视觉命中率 | 有效异常 / 规则/视觉报出异常 | 核心效果指标 |
| 重复异常率 | 同一资产/设备同类异常重复出现 / 异常总数 | 反映根因是否解决 |
建议：方案里附一张「指标口径表」，让甲方确认后再开发。
3. 分析维度
| 维度 | 取值 |
|---|---|
| 时间 | 日 / 周 / 月 / 学期 / 自定义 |
| 组织 | 学院 / 项目 / 物业班组 |
| 空间 | 校区 / 楼 / 楼层 / 区域 / 房间 |
| 资产/设备 | 资产类型 / 设备类型 / 重要等级 / 厂商 / 役龄 |
| 巡检计划 | 计划名称 / 周期 / 模板 |
| 执行方式 | 规则 / 视觉 / 人工 |
| 异常 | 类型 / 等级 / 处置状态 |
| 工单 | 类型 / 状态 / 处理人 |
4. 报表与图表设计
4.1 总览卡片（首屏）
| 卡片 | 内容 |
|---|---|
| 今日完成率 | 百分比 + 环比 + 目标线 |
| 待处理异常 | 数量 + 按等级分布 |
| 漏检 | 数量 + 涉及资产/设备/空间 |
| 规则/视觉命中率 | 百分比 + 有效/误报 |
| 平均处置时长 | 小时 + 环比 |
4.2 图表清单
| 图表 | 类型 | 说明 |
|---|---|---|
| 完成率趋势 | 折线 + 目标线 | 日/周/月，含按时完成率 |
| 巡检日历 | 日历热力图 | 每天完成率着色，一眼看漏检日 |
| 计划执行明细 | 表格 | 计划 / 应完成 / 已完成 / 漏检 / 异常 / 完成率 |
| 人员/班组排行 | 横向条形 | 完成率、异常发现数、平均时长 |
| 空间覆盖率 | 楼层平面热力图 | 按空间着色，红色=未覆盖/漏检 |
| 异常类型分布 | 柱状/饼图 | 按资产/设备类型、异常类型 |
| 异常处置漏斗 | 漏斗/桑基 | 发现 → 确认 → 转工单 → 闭环 |
| 规则/视觉 vs 人工 | 对比条形 | 完成量、异常率、误报率、抓拍成功率 |
| 时效分布 | 直方图 | 巡检开始/完成时间相对计划窗口 |
| 重复异常 TOP | 排行榜 | 资产/设备 + 异常类型 + 次数 |
4.3 报告模板
日报（每日 08:30 推送）
【昨日巡检日报】
计划 32 项 / 完成 30 项（93.8%）/ 漏检 2 项
新增异常 5 项：设备离线 3、温度越限 1、数据不动 1
已转工单 4 项，闭环 2 项，待处理 3 项
视觉巡检 18 项，抓拍成功 17 项，报出异常 4 项，有效率 75%
重点关注：3F AHU-02 连续 3 天温度越限周报（每周一推送）
- 完成率趋势 + 本周 vs 上周
- 漏检清单与原因
- 异常 TOP5 资产/设备
- 重复异常与根因建议
- 规则/视觉命中率与误报分析
- 下周关注建议
月报（每月 1 日）
- 覆盖率、完成率、按时率
- 工单闭环率、平均处置时长
- 规则/视觉 vs 人工效果
- 设备健康趋势（结合健康度）
- 改进建议（阈值调整、计划优化、知识库补充）
报告文字由 LLM 生成，数字必须来自指标引擎/数据库，不允许 LLM 自己算。
5. 交付形态：报表 + 看板 + 智能体
| 形态 | 用途 | 说明 |
|---|---|---|
| 报表中心 | 固定报表、导出 | 复用现有报表引擎 |
| BI 看板 | 大屏/中屏展示 | 复用 BI 看板 / ChatBI |
| 智能体 Chatbox | 按需问答 + 主动推送 | 核心增量 |
| 企微/短信 | 日报/周报/异常通知 | 复用现有通知 |
5.1 智能体工具设计
| 工具 | 输入 | 输出 |
|---|---|---|
查巡检统计 | 时间范围、维度、指标 | 指标值 + 环比 + 口径说明 |
查巡检计划执行 | 计划 ID/名称、时间 | 计划 vs 实际明细 |
查漏检清单 | 时间、空间/资产/设备 | 漏检列表 + 原因 |
查巡检异常 | 时间、等级、状态、资产/设备 | 异常列表 + 证据 |
查巡检效果 | 时间 | 命中率、误报率、规则/视觉 vs 人工 |
生成巡检报告 | 类型（日/周/月）、范围 | 报告（文字 + 图表数据） |
订阅巡检报告 | 频率、接收人 | 订阅关系 |
对话示例：
- 「上周巡检完成率多少？」→ 查指标 + 口径说明 + 环比
- 「哪些设备漏检了？」→ 清单 + 按空间分组
- 「3 楼最近老出问题的设备是哪些？」→ 重复异常 TOP + 证据
- 「给我出一份 10 月巡检月报」→ 生成报告 + 图表 + 导出
- 「视觉巡检误报是不是太多了？」→ 误报率 + 误报类型分布 + 阈值建议
5.2 主动推送
| 触发 | 内容 |
|---|---|
| 每日 08:30 | 昨日日报 |
| 每周一 09:00 | 上周周报 |
| 每月 1 日 | 上月月报 |
| 完成率低于阈值 | 预警 |
| 漏检 | 即时提醒责任人 |
| 异常转工单后超时未闭环 | 升级提醒 |
5.3 使用角色
| 角色 | 关注点 | 形态 |
|---|---|---|
| 物业/运维主管 | 完成率、漏检、异常闭环 | 看板 + 日报周报 |
| 学院/项目管理者 | 覆盖率、服务质量、成本 | 月报 + 空间维度 |
| 一线巡检人员 | 我的任务、漏检、异常 | 移动端推送 |
| 教师/学生 | 「我报的修好了吗」 | 智能体对话（工单状态） |
6. 数据模型与现有巡检工单的衔接
| 对象 | 现状 | 要做 |
|---|---|---|
| 巡检计划 | 无独立计划维度 | 计划表 + 周期 + 范围 + 模板 |
| 巡检任务 | 可由计划生成 | 任务表 + 计划关联 + 执行时间 |
| 巡检工单 | 已有 | 增加任务 ID、执行方式（规则/视觉/人工） |
| 巡检明细 | 巡检记录字段较薄 | 明细表：资产/设备 + 巡检项 + 结果 + 证据 |
| 异常 | 无独立对象 | 异常表 + 等级 + 处置状态 + 转工单关联 |
| 工单关联 | 有 | 异常 → 报修/维修工单外键 |
| 规则/视觉结果 | 巡检工单/明细 | 结果关联证据 + 置信度 |
原则：不另起一套巡检系统。复用现有巡检工单与状态机，补「计划/任务/明细/异常」四个维度；统计基于巡检工单 + 明细，避免两套数据打架。
7. 落地顺序
| 步骤 | 内容 |
|---|---|
| 1 | 基于现有巡检工单：完成量/完成率/状态分布统计 |
| 2 | 巡检计划/任务/明细/异常模型 + 计划执行明细 + 漏检 |
| 3 | 完整指标体系 + 图表 + 日报/周报 + 智能体问答 |
| 4 | 规则/视觉 vs 人工对比、命中率/误报率、抓拍成功率、重复异常分析 |
| 5 | 报告自动生成 + 主动推送 + 优化建议 |
8. 需要澄清
- 「巡检任务完成情况」是否按规则/视觉/人工分别统计？
- 「完成」的定义：提交即完成，还是必须审核通过？
- 漏检如何认定？设备停用/离线/无法进入是否豁免？
- 巡检计划由谁制定？周期、路线、点位、责任人怎么定？
- 统计报表给谁看？物业、学院、校方？频率和粒度？
- 是否要求与工单闭环率、设备健康度联动？
- 现有巡检工单中哪些字段可直接用于统计？还缺什么？
9. 一句话总结
巡检统计建立在已有的巡检工单之上：补计划、任务、明细、异常四个维度，定一套指标口径，再用「报表 + 看板 + 智能体问答/推送」交付。卖点是问一句就能拿到数、日报周报自动推，而不是又一块静态 BI 看板。