消防巡检、设备巡查：如何快速知道谁、哪里没做巡检
适用于消防巡检、设备巡查、资产盘点等需要按周期确认「谁没做、哪里没做」的场景。草料可通过周期任务、计划管理或二维码统计，帮助管理员从「已完成记录」反推出「未完成清单」。
这篇文档解决什么
固定周期的巡检计划下达后，管理员真正要盯的不是"谁做了"，而是"谁没做、哪里没做"。
难点在于：已完成的巡检会产生一条扫码记录，漏做的不会产生任何数据。翻记录只能看到做过的，反查不出漏的。要定位漏做，必须先有一份"应做清单"，再和实际记录比对。
草料提供三种方式。用哪一种，取决于你当前启用了哪个功能。
先确认你用的是哪个功能
| 你已启用的功能 | 看板查看 | 导出未完成明细 | 对应章节 |
|---|---|---|---|
| 周期任务（新版，推荐） | 手机端周期视图 | 支持，手机端工作台内导出 | 方式二 |
| 计划管理（旧版） | 手机端计划报表 | 看板不支持，需对接数据库 | 方式一 |
| 都未启用 | PC 后台表单的二维码统计 | 支持，PC 后台直接导出 | 方式三 |
官方对两个功能的定位是：周期任务是计划管理的升级版或精细化版本。计划管理体验较基础，扫码后感知不强，更多依靠管理员事后查报表；周期任务有倒计时、有状态标签，对一线员工的执行驱动力更强。两者不冲突，新用户推荐直接使用周期任务。
直白地说：计划报表和周期视图都只在手机端，PC 后台里找不到。要在电脑上看，只有方式三，或者走数据库对接。
方式一：已开启「计划管理」
1. 手机端查看计划报表
查看路径：微信搜索草料二维码小程序 → 工作台 → 计划报表。
管理人员在这里可以看到计划执行情况：按期完成、未完成、即将超期等；也会收到「即将超期提醒」，统计哪些设备的巡检任务还没完成。
两条提醒机制的边界要先知道：
- 提醒人只支持设置账号下的高级成员。成员收到的是整个计划下所有二维码的即将超期情况，不能拆分成某个码即将超期推送给指定某个人。
- 已经到期但未完成的计划，不支持推送消息提醒，只支持「即将超期提醒」。已到期的执行情况请通过手机端计划报表查看。
限制：计划报表的数据不支持导出。只能在小程序里看，落不成表格。要导出请走下面的数据库对接。
2. 对接官方数据库读取（需要导出、需要做表时用）
对接后读取 code_task_log 计划执行情况表。
该表在账号下创建计划并开始执行后才会推送。表中没有码名称信息，需要关联 base_codeinfo 或 template_XXX 扩充码的信息。
关键字段：
| 字段 | 说明 |
|---|---|
| 状态 | 可选值：完成 / 未完成 / 即将超期 / 超期完成 / 超期未完成 |
| code_id | 码的唯一标识，用来关联出码名称、位置 |
| 计划名称、开始时间、截止时间 | 定位是哪个周期 |
| 是否过滤 | 根据是否设置无需检查的条件进行过滤 |
筛选「未完成 / 超期未完成」，就是这一周期的漏检名单。
WPS 教程里有现成做法：用折线图，在数据筛选中选择状态为「未完成」「超期未完成」「超期完成」，即可查看每月漏检趋势。
历史数据边界见下方「官方数据库对接的共同前提」。
方式二：已开启「周期任务」
适用范围：无论是单独一个二维码，还是一批二维码（如 100 个灭火器），都可以使用。免费版即可使用。
1. 手机端查看与导出
先进入小程序：微信搜索草料二维码小程序 → 工作台。工作台内有两个入口，用途不同：
| 入口 | 路径 | 适合谁 |
|---|---|---|
| 当前周期任务 | 工作台 → 当前周期任务 | 一线员工看今天的待办；管理员在这里批量处理任务 |
| 周期视图 | 工作台 → 表单数据 → 目标表单 → 周期视图 | 管理员看整体完成率，揪出哪些任务没做、哪些超期完成 |
周期任务的执行情况数据支持导出，在手机端工作台内操作。
两条边界：
- 看板只有手机端，电脑端不支持。
- 「当前周期任务」的个人看板只展示与该员工相关的任务。只有该员工被设置为任务的「提醒对象」，或拥有「码管理员」权限，任务才会显示。员工反馈看板为空时，先检查是否已加入提醒对象。
2. 对接官方数据库读取
需要把未完成数据接进 BI、做长期趋势、或和其他系统打通时用。
周期任务相关的表有多张，按用途选：
| 表名 | 用途 |
|---|---|
cycle_task_entity_task | 保存具体到每个码的周期执行情况，适合做任务闭环明细分析。这是查"哪个点位没做"的主表 |
cycle_task_instance | 保存每轮周期任务的聚合统计结果，适合分析完成率、超时率、跳过率。这是查"整体完成率"的表 |
cycle_task | 周期计划下每一轮实际执行的周期任务，用于定位周期时间片 |
cycle_task_entity_task 关键字段：code_id 目标码 ID、execute_status 执行状态（完成 / 未完成 / 跳过）、execute_time 实际执行时间。筛选 execute_status = 未完成，再用 code_id 关联 base_codeinfo 取出码名称和位置，就是漏做点位清单。
注意：如果源数据不存在或状态为删除，会删除该条数据；状态为隐藏时不会删除，仍会同步。任务被删除或进入「暂停并删除」状态时，会级联删除该任务下的实例和实体任务数据。
方式三：计划和周期任务都未启用
用表单的「二维码统计」视图反查。
操作路径：PC 后台 → 左侧【表单】→ 打开对应表单 → 数据与统计 → 二维码统计。
这个视图统计该表单在每个关联二维码的周期性填写数，支持填写总数、每月、每周、每日进行查看，可根据时间范围、关联的批量模板、关联的二维码筛选。官方明确它适用于设备巡检、区域巡查、资产盘点等场景，可以查看每个二维码被检查或盘点的情况。
点击某个数值，可以直接筛查出该数值对应的明细数据，该筛选数据支持导出。
用法：按周期筛选后，看每个二维码的填写数。填写数为 0 的码，就是该周期没做的点位。
这个方式不依赖计划或周期任务，也是唯一能在电脑端直接完成的。代价是没有"应做清单"，系统不会主动标记未完成，需要你自己看哪些码是 0。
官方数据库对接的共同前提
方式一和方式二的数据库读取都依赖这一步，开通一次，两类表都能读。
开通入口：草料后台导航栏【数据管理】→【数据 API】→【官方数据库】，填写申请信息后自动开通并推送数据。首次推送需要 1~3 小时，具体看你后台已有的数据量。
基本性质：只读数据库，不可编辑；类型为 MySQL 5.7；实时同步码信息、表单记录、状态明细、计划完成明细等数据。
推送条件：数据会根据你在草料设置的功能来推送。后台添加了计划并执行后，才会推送 code_task_log；未设置相关功能或无数据产生时不会推送。只有产生了实际业务数据后，相关数据表才会创建并开始同步。只创建批量模板和表单、没有填写数据，是不会创建数据表的。
历史数据边界（重要）：计划和周期任务的数据表都只推送对接完成之后新产生的周期数据，此前的历史周期数据不会推送。如果需要历史数据，请联系草料官方单独处理。
读取工具：最简单的是 WPS 多维表格。WPS 多维表格现已支持连接数据库（限时免费），教程见 WPS 多维表格连接数据库。也可以用飞书，但飞书多维表格免费版只能推送三张数据表，数据同步上限 1000 行，超出需购买高级版或企业版，教程见 飞书多维表格连接数据库。完整的数据表字段说明见 官方数据库说明。
三种方式怎么选
- 用周期任务，只是想拿到本周期的未完成名单：手机端工作台内看周期视图并导出，不用开数据库。
- 用计划管理，需要导出名单：只能走数据库对接，读
code_task_log筛选未完成 / 超期未完成。 - 需要长期趋势、跨月漏检分析、或接入 BI：走数据库对接。注意历史数据不推送，越早开通越好。
- 两个功能都没开，也不打算开：用方式三的二维码统计，筛选周期后看填写数为 0 的码，可直接导出。
- 新账号从零开始搭：直接用周期任务，不必再用计划管理。
常见问题
为什么已完成的记录能查，没完成的查不到？
扫码提交才会生成记录。没做的点位不会产生任何数据。要定位漏做，必须靠计划或周期任务这类预设了应做清单的功能来反算，或者用点位清单去比对表单记录。
对接数据库后，为什么看不到以前的数据？
计划和周期任务的数据表都只推送对接之后新周期的数据，历史周期数据不在推送范围内。需要历史数据请联系草料官方单独处理。
计划报表能导出吗？
不能。计划管理的看板数据不支持导出，需要导出请走官方数据库对接，读 code_task_log。周期任务不受此限，执行情况数据可在手机端工作台内导出。
设备停机、点位裁撤，会不会算成漏检？
周期任务支持人工干预。管理员在手机端「工作台 → 当前周期任务 → 批量处理」，把一批任务设为「已完成」或「无需完成」，支持本周期生效、限时生效、长期生效三种模式。生产线检修一周可批量设为「一周内无需完成」，避免产生虚假逾期；点位裁撤可设为「长期无需完成」。
计划管理侧对应的是过滤规则。数据表中会保留所有计划任务数据，通过【是否过滤】字段判断该条计划是否被过滤。注意状态变更后要在下个周期过滤才生效。
员工说手机上看不到任务？
个人看板只展示与该员工相关的任务，需要他被设置为任务的「提醒对象」，或拥有「码管理员」权限。