公司端配置检查保养模板 → 船舶端按年生成日历计划表 → 到期提醒 → 现场填写 → 双签 → 回传公司归档
本质是一条「配置 → 排期 → 提醒 → 执行 → 签字 → 回传」的合规闭环,核心不是表单,而是计划不丢项和记录可追溯。
| 角色 | 所在端 | 职责与权限边界 |
|---|---|---|
| 海务 / 体系主管 | 公司端 | 维护五个周期的检查保养项目模板;发布版本;查阅/打印/导出船舶回传记录 |
| 驾驶员 / 轮机员 | 船舶端 | 接收计划、按日历填写检查结果、上传照片、电子签名后提交 |
| 船长 | 船舶端 | 复核并签字确认;签字后单据锁定不可改,随即自动同步公司 |
| 系统 | 服务端 | 按规则生成年度计划、周期内每日提醒、同步校验 |
五种周期各一套项目清单,可增删改、排序、标记必检/需照片,按版本发布。船舶端「按需同步」,未发布不下发。
按年生成,日历面板呈现全年检查点。点某一天,看到当天需要做哪几个周期的项目,点进去填。
承载模板内容的实体单据:项目、结果、备注、照片、日期、执行人签字、船长签字,最后同步公司。
一年 65 个规则检查点(48 周 + 12 月 + 4 季 + 1 年);五年项按设备登记后插入,单独计数。
| 周期 | 生成日期规则 | 年生成数 | 2024 年 1 月示例 | 提醒区间 |
|---|---|---|---|---|
| 周 | 每月第 1~4 个周一 | 48 | 1/1、1/8、1/15、1/22 | 周一 08:00 → 周日 23:59;1/29 是第 5 个周一,不生成 |
| 月 | 每月 1 日 | 12 | 1/1 | 当月 1 日 → 当月最后一天 |
| 季 | 每季首月 1 日 | 4 | 1/1、4/1、7/1、10/1 | 季首月 1 日 → 季末最后一天 |
| 年 | 每年 1 月 1 日 | 1 | 1/1 | 1 月 1 日 → 12 月 31 日 |
| 五年 | 不按规则排期:由「上次检验日期 + 5 年」滚动推算;项目内容同样由公司端模板维护 | — | 上次 2019-01-01 → 下次 2024-01-01 | 到期前 30 天 → 到期后 30 天 |
五步闭环,其中「到期提醒」是把它从静态表格变成日程系统的关键一步。
因为没有考核,提醒逻辑只需要一条原则:在「本周期」范围内,没填就持续提醒;填了、或者本周期过了,立刻停。
| 周期 | 提醒区间 | 频率 | 示例 |
|---|---|---|---|
| 周 | 计划周一 08:00 → 本周日 23:59 | 每天 1 次 | 1/8 未填,1/9~1/14 每天提醒;1/10 填完当天即停 |
| 月 | 当月 1 日 → 当月最后一天 | 每天 1 次 | 2/1 未填,整个 2 月每天提醒 |
| 季 | 季首月 1 日 → 季末最后一天 | 每 3 天 1 次 | Q1 未填,1~3 月每 3 天提醒一次 |
| 年 | 1 月 1 日 → 12 月 31 日 | 每周 1 次 | 年检未填,全年每周一推 |
| 五年 | 到期前 30 天 → 到期后 30 天 | 每周 1 次 | 2024-01-01 到期,2023-12-02 开始提醒 |
草稿 或 已提交(即离开「未填写」),当天推送即刻停止;
跨过 remind_end 仍未填写,自动转「未按期」,也不再推送,只在日历上保留红字标记,方便事后补录。remind_start ≤ today ≤ remind_end AND status < 已提交 即命中。不需要「逾期天数」「催办次数」「公司异常看板」这些字段。
船舶端既然是 Web,就没有系统级推送可用,提醒只能落在三个位置,且都发生在「人已经打开系统」之后:
| 位置 | 表现 | 触发条件 |
|---|---|---|
| 登录后弹窗 | 「今日有 2 项待执行:周检、月检」,点击直接跳转对应单据 | 当日有命中提醒区间的单据,每天只弹一次 |
| 首页待办横幅 | 顶部常驻条:本周待办 1 项 · 未按期 0 项 | 有未完成单据时常显,全部完成自动消失 |
| 菜单角标 | 「消防设备管理」入口右上角的数字角标 | 未完成单据数,实时计算 |
单据状态是整套系统的骨架:统计、催办、能否修改、能否同步,全部由状态决定。
| 状态 | 触发条件 | 可执行操作 |
|---|---|---|
| 未到期 | 计划已生成,未进入提醒区间 | 查看项目预览;不可填写 |
| 待执行 | 进入 remind_start(周一 / 1 日 / 到期前 30 天) | 填写、暂存草稿、上传照片;此时开始每日提醒 |
| 待船长签字 | 船员点「提交」 | 船长签字 / 退回修改 / 作废;提醒停止 |
| 待同步 | 船长签字完成 | 系统自动排队上传;离线时保持此态并显示「待同步 N 条」 |
| 已归档 | 公司端接收并保存(无审核环节) | 只读、打印 PDF、导出 |
| 未按期 | 越过 remind_end 仍未提交,自动流转 | 仍可补填,但必须填「未按期原因」,单据标记为未按期执行;不再提醒 |
| 作废 | 误建 / 重复 / 换周期 | 只读留痕;作废后可重新生成同一日期的计划点,原单不删除 |
共 4 个核心页面:船舶端计划表、检查单填写、公司端模板维护、公司端执行监控。
左侧月度日历承载全年检查点,右侧是当日任务卡。下面用 2024 年 1 月 做示例——它是最极端的月份:1 月 1 日既是周一,又是月首、季首、年首,同一天堆了 4 张单据(某台设备的五年检若也落在这天就是 5 张);而 1 月 29 日是当月第 5 个周一,直接不生成。
✓ 表示已归档,无前缀为待执行(提醒中),红底 ! 为未按期;未到期的不显示标签。表单结构与纸质检查表一一对应:项目、要求、结果、备注、照片,最后两个签字位。这是船员在机舱、甲板上真正会用的界面,要大、要少滚动。
| 序号 | 检查项目 | 检查要求与标准 | 结果 | 照片 |
|---|---|---|---|---|
| 1 | 手提式灭火器 | 压力表指针在绿区,保险销完好,铅封未断,瓶体无锈蚀 | 合格不合格不适用 | 2 张 |
| 2 | 消防水带与水枪 | 水带无破损霉变,接口垫圈完好,水枪开关灵活 | 合格不合格不适用 | 上传 |
| 3 | 消防泵启动试验 | 手动、遥控启动正常,出水压力 ≥ 0.25 MPa | 合格不合格不适用 | 3 张 |
| 4 | 火灾报警按钮 | 外观完好,按钮玻璃无破损,标识清晰 | 合格不合格不适用 | 上传 |
| 5 | 应急照明 | 断电后自动切换,持续照明 ≥ 30 分钟 | 合格不合格不适用 | 上传 |
| 6 | 消防通道与标识 | 通道畅通无堆物,逃生标识可见 | 合格不合格不适用 | 上传 |
五个周期用 Tab 切换,每套模板独立版本。左侧 tab 上带项目数,发布后状态变为「已发布」,船舶端下次同步即可拉到。
| 序 | 检查项目 | 检查要求与标准 | 必检 | 需照片 | 操作 |
|---|---|---|---|---|---|
| 1 | 手提式灭火器 | 压力表指针在绿区,保险销完好,铅封未断 | 是 | 是 | 编辑 |
| 2 | 推车式灭火器 | 轮架灵活,喷射软管无老化开裂 | 是 | 是 | 编辑 |
| 3 | 消防栓与阀门 | 阀门开关灵活,无渗漏,阀箱内无积水 | 是 | 否 | 编辑 |
| 4 | 固定式灭火系统 | 压力表读数在允许范围,管路无泄漏 | 是 | 是 | 编辑 |
| 5 | 火灾探测报警 | 探测器指示灯正常,主机无故障报警 | 是 | 否 | 编辑 |
不做考核,但公司端总得能一眼看到「记录齐不齐」,尤其体系内审、PSC 检查前要自查。所以这里只做查阅:船舶 × 月份的归档矩阵,缺哪个月点进去能直接看到缺的是哪几张单、卡在谁那里,不排名、不通报、不推考核报表。
| 船舶 | 1月 | 2月 | 3月 | 4月 | 5月 | 6月 | 7月 | 8月 |
|---|---|---|---|---|---|---|---|---|
| 长江之光 | 5/5 | 5/5 | 5/5 | 4/5 | 5/5 | 5/5 | 5/5 | 4/5 |
| 长江之星 | 5/5 | 4/5 | 2/5 | 4/5 | 5/5 | 5/5 | 5/5 | 5/5 |
| 长江之春 | 5/5 | 5/5 | 5/5 | 5/5 | 5/5 | 4/5 | 5/5 | 5/5 |
6 张核心表。计划与记录分离,模板与模板明细分离,是这套模型的两个关键点。
| 表 | 关键字段 | 说明 |
|---|---|---|
| fire_template 模板主表 |
id, company_id, cycle_type, name, version, status, effective_date, publisher_id |
五个周期各一条、独立维护;cycle_type 枚举:WEEK / MONTH / QUARTER / YEAR / FIVE_YEAR;status:草稿 / 已发布 / 已停用 |
| fire_template_item 模板明细 |
id, template_id, seq, item_name, check_standard, require_photo, required, equipment_type |
seq 决定填写页顺序;required=false 的项目可不检 |
| 表 | 关键字段 | 说明 |
|---|---|---|
| fire_plan 年度计划 |
id, ship_id, year, status, generated_at, total_count, done_count |
一船一年一条;done_count 冗余用于日历页统计 |
| fire_plan_task 计划点(日历格子的来源) |
id, plan_id, ship_id, cycle_type, plan_date,
remind_start, remind_end, template_id, template_version,
status, record_id |
一年 65 条规则点;同一天多周期 = 多条;remind_start / remind_end 决定提醒窗口;template_version 是生成时的快照 |
fire_plan_task 与 fire_record,只在 record 上多两个字段
last_check_date / next_check_date;下一条计划点的 plan_date 由「本次 check_date + 5 年」自动生成,形成滚动闭环。
所以整套系统只有 6 张表,没有设备台账,也没有证书表。
| 表 | 关键字段 | 说明 |
|---|---|---|
| fire_record 检查保养单 |
id, task_id, ship_id, cycle_type, plan_date, check_date,
checker_id, checker_sign, checker_sign_time,
captain_id, captain_sign, captain_sign_time,
status, is_missed, miss_reason,
last_check_date, next_check_date,
sync_status, sync_time, archive_time, remark, fail_count |
双签字段成对存储;签字图存对象存储 URL;is_missed + miss_reason 标记未按期补录;sync_status:待同步 / 同步中 / 已同步 / 失败;无审核相关字段 |
| fire_record_item 填写结果 |
id, record_id, template_item_id, item_snapshot, result, remark, images, measure |
result:合格 / 不合格 / 不适用;item_snapshot 冗余项目名,防止模板改版后历史单据错位 |
template_item_id,
一旦公司端把「消防泵启动试验」改成「消防泵手动/遥控启动」,三年前的历史单据打印出来就会显示新文字,签字页与 PDF 对不上。
冗余项目名和标准文本,是这类体系记录最省事也最可靠的留痕方式。
计划点是「日程」,记录单是「证据」。分开后:归档齐备度 = 查计划点状态;今日待办 = 查提醒窗口;模板改版只影响未来计划点。若合成一张表,「未填写」的行既没有签字也没有内容,历史查询和统计都会别扭。
生成计划时把 template_version 钉在计划点上,填写时按该版本渲染项目。公司端改模板不回溯,只对下一年度或显式「同步到未执行计划」生效。
船上网络普遍不稳,若做成纯在线表单,船员填到一半断网就丢数据,实际使用一定失败。建议:
执行人签名后单据进入待签状态可退回;船长签字后整单只读,改内容只能作废重开,原单保留审计痕迹(谁、何时、为什么作废)。
2024/1/1 这种日子会同时生成 5 张单据(周、月、季、年、五年)。不合并,各自独立成单、独立双签、独立归档。日历格子内标签堆叠,侧栏按周期分组,提供「引用上一张结果」减少重复录入。
因为没有考核,提醒不设升级阶梯。一条 remind_start ≤ today ≤ remind_end AND 状态 < 已提交 的每日扫描就够了:填了就停、周期过了就停。系统里不需要「逾期天数」「催办次数」「公司异常看板」这些字段,实现成本低很多,也更贴近船上实际——催得太紧反而容易瞎填。
唯一需要处理好的是时区与离线:船上可能跨时区航行,提醒日期一律按船舶所在时区的本地日期算,不要用服务器时区,否则会出现「船员早上 8 点该收到提醒但没收到」的问题。
既然它的项目内容也由公司端模板维护,那它在模型上和另外四个周期完全同类——同一张 plan_task、同一张 record、同一套双签流程,只有两点不同:
直接好处:五年检不需要单独的登记模块,也不需要设备台账,日历上它就是一张普通卡片,1 月 1 日那天自然凑成第 5 张。无第三方证书、无设备维度。
需求阶段的口径已全部闭环,下表就是开发依据;末尾两条属于二期扩展,不影响本期。
| 类别 | 结论 | 落在哪 |
|---|---|---|
| 周检日期 | 每月第 1~4 个周一,第 5 个跳过 | 年 48 次;plan_task 生成规则 |
| 月/季/年 | 月 = 每月 1 日;季 = 季首月 1 日;年 = 1 月 1 日 | 12 / 4 / 1 次 |
| 同日多单 | 各周期独立成单,最多 5 张,不合并 | 1:N 计划点;日历折叠呈现 |
| 五年检 | 模板由公司端维护,与其它周期同类;日期 = 上次检验 + 5 年滚动 | 共用 plan_task / record |
| 模板 | 五个周期五套独立模板,互不影响 | fire_template.cycle_type |
| 提醒 | 周期内未填持续提醒,填了或周期结束即停;无考核 | remind_start / remind_end + 每日扫描 |
| 提醒渠道 | 船舶端为 Web,只做拉取式:登录弹窗 / 首页横幅 / 菜单角标 | 无系统级推送 |
| 未按期 | 允许补填,必填原因,标记「未按期执行」,不再提醒 | is_missed + miss_reason |
| 同步 | 船长签字后自动同步,公司端只存档、不审核 | 直达「已归档」 |
| 部门 | 不按甲板 / 轮机拆分,一张单一个执行人 | 无 dept 字段 |
| 本期不做打印表样,后期录入电子版时再对齐 | 暂缓 |
notify_channel 即可,不需要改现有表结构。