起重机械安全检查维保台账（详细设计草案）

1. 文档定位

本文档是在 02-起重机械安全检查维保台账-初始需求.md 的基础上继续深化，目标是把台账系统从“方向文档”推进到“可拆开发任务”的程度。

本文档严格按照以下顺序输出：

大模块
模块清单
页面清单
数据表草案
开发优先级

2. 系统定位

该系统是科杰企业级大系统中的核心业务子系统之一，也可以作为独立 Web 系统优先落地。

其核心作用：

围绕设备主档做日检、月检、维保、年度自检与定检准备；
形成可追溯、可导出、可整改、可预警的电子台账；
为一机一档、售后与合规协同提供稳定数据基础。

3. 大模块划分

建议台账系统分为 8 个一级模块。

3.1 设备与状态模块

负责台账前置的设备选择、设备状态识别、档案完整度查看。

3.2 检查维保任务模块

负责按频率生成待办任务，包括日检、月检、维保、年度自检、定检准备。

3.3 记录填报模块

负责结构化填写各类台账记录，并支持签字与附件。

3.4 整改闭环模块

负责问题项转整改、责任人分配、期限管理、复核关闭。

3.5 附件与归档模块

负责记录附件、证照、扫描件、签字页和归档分类。

3.6 提醒与预警模块

负责到期、逾期、资料缺失、状态异常等提醒和风险展示。

3.7 导出与检查应对模块

负责导出台账、年度报告、单设备资料包、检查资料包。

3.8 统计看板模块

负责按设备、单位、状态、完成率、逾期率、风险数做可视化分析。

4. 模块清单

A. 设备与状态模块

A1. 设备列表

查看台账范围内设备
按类型、状态、单位筛选
查看当前检验、登记、台账状态

A2. 设备详情

查看基础设备信息
查看最近日检、月检、维保、年检情况
查看档案完整度与风险状态

A3. 状态总览

建档状态
检验状态
使用登记状态
台账完整性状态
运行状态
整改状态

B. 检查维保任务模块

B1. 日检任务

按班次生成
待执行 / 已完成 / 逾期状态

B2. 月检任务

按月自动生成
支持安全员确认

B3. 维保任务

按月或计划生成
可关联维保单位

B4. 年度自检任务

按年生成
可关联年度报告

B5. 定检准备任务

按检验有效期提前生成
跟踪资料准备情况

C. 记录填报模块

C1. 日检填报

勾选检查项
问题描述
司机签字
安全确认

C2. 月检填报

检查项录入
问题与整改情况
安全员签字
负责人审批

C3. 维保填报

维保项目填写
遗留问题记录
安全员验收

C4. 年度自检填报

技术资料核查
结构与机构检查
安全保护装置检查
电气与管理检查
结论填写

C5. 补录填报

历史记录补录
补录原因必填
自动保留补录痕迹

D. 整改闭环模块

D1. 问题池

从检查/维保记录自动归集问题项

D2. 整改任务

指定责任人
设置整改期限
跟踪状态

D3. 复核关闭

复核结果
关闭说明
附件补充

E. 附件与归档模块

E1. 记录附件

图片、扫描件、签字页

E2. 核心资料

检验报告
使用登记证
合格证
年度自检报告

E3. 归档视图

按设备
按时间
按资料类型

F. 提醒与预警模块

F1. 到期提醒

月检到期
年检到期
检验到期
维保到期

F2. 逾期提醒

未执行任务
未关闭整改

F3. 风险预警

未登记运行
超期未检
资料缺失
补录占比异常

G. 导出与检查应对模块

G1. 单条记录导出

导出单次日检 / 月检 / 维保 / 年检记录

G2. 单设备资料包导出

导出台账 + 附件 + 报告

G3. 检查应对包导出

按检查需要打包设备资料

H. 统计看板模块

H1. 任务完成率

H2. 风险设备统计

H3. 逾期统计

H4. 维保执行统计

H5. 整改关闭率

5. 页面清单

5.1 后台管理端页面

设备与状态

设备列表页
设备详情页
设备状态总览页

任务中心

日检任务列表页
月检任务列表页
维保任务列表页
年度自检任务列表页
定检准备任务列表页

填报页面

日检填报页
月检填报页
维保填报页
年度自检填报页
补录说明页

记录与归档

日检记录列表页
月检记录列表页
维保记录列表页
年度自检记录列表页
附件中心页
单设备归档页

整改与预警

问题池列表页
整改任务列表页
整改详情页
到期预警页
风险设备页

导出与分析

导出中心页
检查资料包导出页
统计看板页

5.2 移动端页面

我的待办
日检快捷填报页
月检填报页
维保填报页
整改处理页
设备扫码详情页
签字确认页

6. 核心数据表草案

以下为第一版核心表，不追求一次性穷举全部字段。

6.1 设备主档相关

`equipment`

id
company_id
equipment_code
equipment_name
model
equipment_type
usage_registration_no
manufacturer_name
installation_company_name
use_location
status
archive_completeness
created_at
updated_at

`equipment_status_snapshot`

id
equipment_id
archive_status
inspection_status
registration_status
ledger_status
operation_status
rectification_status
risk_level
snapshot_time

6.2 任务相关

`inspection_task`

id
equipment_id
task_type（日检/月检/维保/年检/定检准备）
plan_date
due_date
assignee_id
status
source_rule
created_at

`reminder_task`

id
equipment_id
reminder_type
related_task_id
remind_at
status
channel

6.3 记录相关

`inspection_daily`

id
equipment_id
task_id
check_date
shift_type
operator_id
safety_confirm_user_id
problem_desc
result
is_backfill
backfill_reason
created_at

`inspection_daily_item`

id
daily_id
item_code
item_name
check_result
remark

`inspection_monthly`

id
equipment_id
task_id
check_date
checker_id
safety_user_id
approver_id
issue_desc
rectification_desc
result
is_backfill
backfill_reason
created_at

`inspection_monthly_item`

id
monthly_id
item_code
item_name
check_result
remark

`maintenance_record`

id
equipment_id
task_id
maintenance_company_id
maintenance_date
maintainer_id
accept_user_id
note
issue_desc
rectification_requirement
result
is_backfill
backfill_reason
created_at

`maintenance_item`

id
maintenance_id
item_code
item_name
finish_result
remark

`annual_self_check`

id
equipment_id
task_id
self_check_date
checker_id
safety_user_id
approver_id
conclusion
issue_desc
result
stamp_file_id
is_backfill
backfill_reason
created_at

6.4 整改相关

`rectification_task`

id
equipment_id
source_type
source_id
issue_desc
risk_level
owner_id
due_date
status
rectification_measure
review_user_id
review_result
closed_at

6.5 附件与签字相关

`attachment_file`

id
equipment_id
biz_type
biz_id
file_name
file_type
file_url
uploaded_by
uploaded_at

`signature_record`

id
biz_type
biz_id
signer_id
signer_role
sign_time
sign_file_id

6.6 导出相关

`export_package`

id
equipment_id
package_type
export_scope
generated_by
generated_at
file_url

7. 开发优先级规划

P0：MVP 必须先做

设备列表与设备详情
日检任务 / 日检填报
月检任务 / 月检填报
维保任务 / 维保填报
年度自检填报
附件上传
到期提醒
风险设备列表
整改任务
单设备资料导出

P1：形成闭环

定检准备任务
设备状态快照
检查应对包导出
看板分析
移动端填报
补录审计筛选

P2：增强与联动

设备扫码
与售后工单联动
与一机一档主档联动增强
与监管协同中心对接
与IoT告警联动生成检查/维保建议

8. 与企业级大系统的接口点

对接设备主档与一机一档中心

读取设备身份、登记、检验基础信息
回写台账完成情况与风险状态

对接售后与服务运营中心

台账问题项可转售后工单
售后故障可反向生成维保建议

对接合规与监管协同中心

输出定检前资料清单
输出未登记、超期未检、资料缺失风险清单

对接IoT与远程运维中心

后续接收工况异常、安全告警
触发预警或建议维保任务

9. 结论

台账系统应被定义为一个围绕设备主档、法定频率、整改闭环与资料导出构建的轻量但关键的业务系统。它既能独立落地，也能成为科杰企业级大系统中最容易率先见效、最容易形成合规和服务价值的核心子系统。

起重机械安全检查维保台账：详细设计草案