月检需求分析2
月检需求分析
需求背景
规范小程序端消防器材月检全流程管理，包括扫码自检、标准化检查、记录留痕和政府上报。通过统一检查标准，避免漏检/错检问题，满足消防监管合规要求。
现有接口分析
小程序月检接口
- 路径：
wechat/scan/month_check - 关联表：
lpz_customer_check_month（企业月检详细表）
政府后台添加设备接口
- 路径：
gov/customer/equipment-add - 关联表：
lpz_equipment（消防设备表）
小程序月检上传接口
- 路径：
wechat/upload_info/month_check - 关联表：
lpz_red（灭火器表）
分页查询消防设备
- 路径：
gov/customer/equipment-page - 关联表：
lpz_equipment（企业消防安全设施表）
查看设备月检详细
/gov/month-check/device-detail
数据模型设计
器材月检字典表 (lpz_eq_inspect_dict)
| 字段名 | 类型 | 约束 | 说明 |
|---|---|---|---|
| id | bigint | PK | 主键 |
| eq_code | varchar(32) | UNIQUE | 器材唯一编码 |
| eq_name | varchar(64) | NOT NULL | 器材名称 |
| inspect_item_codes | varchar(512) | NOT NULL | 绑定月检项code（逗号分隔） |
| special_remark | varchar(255) | NULL | 备注（年检/季度检/每月除尘） |
| sort | int | DEFAULT 0 | 排序 |
| status | tinyint | DEFAULT 1 | 1=启用 0=禁用 |
| create_time, create_by, update_time, update_by | 系统字段 |
月检项表 (lpz_inspect_item)
| 字段名 | 类型 | 约束 | 说明 |
|---|---|---|---|
| id | bigint | PK | 主键 |
| item_code | varchar(32) | UNIQUE | 检查项唯一编码 |
| item_name | varchar(64) | NOT NULL | 检查项名称 |
| qualified_standard | varchar(255) | NOT NULL | 合格标准描述 |
| control_type | varchar(16) | DEFAULT 'radio' | 控件类型（radio=合格/不合格） |
| is_required | tinyint | DEFAULT 1 | 是否必填 |
| sort | int | DEFAULT 0 | 排序 |
| status | tinyint | DEFAULT 1 | 1=启用 0=禁用 |
| create_time, create_by, update_time, update_by | 系统字段 |
企业月检详细表 (lpz_customer_check_month_json)
| 字段名 | 类型 | 约束 | 说明 |
|---|---|---|---|
| id | bigint | PK | 主键（自增） |
| detail_json | json | NOT NULL | 检查明细JSON数据 |
| inspect_record_id | bigint | UNIQUE NOT NULL | 关联月检记录表ID |
| create_time, create_by, update_time, update_by | 系统字段 |
JSON数据格式说明：采用k:V键值对格式，存储"月检方法/检查项:合格/不合格"记录，示例：
{ "查看瓶体是否有变形、锈蚀、泄漏": "合格", "检查压力表指针是否在绿区": "合格" }新增字段
在lpz_equipment表中新增lpz_eq_inspect_dict_id字段，用于关联月检项。
接口设计
- 月检项表(lpz_inspect_item)的CRUD操作
- 器材月检字典表(lpz_eq_monthly_inspect_dict)的CRUD操作（需关联查询月检项表信息）
- 修改
gov/customer/equipment-add接口，增加lpz_eq_inspect_dict_id字段 - 优化
wechat/scan/month_check接口逻辑，根据设备ID查询对应检查标准并回显 - 完善
wechat/upload_info/month_check接口逻辑，将月检结果保存至lpz_customer_check_month_json表 查看设备月检详细/gov/month-check/device-detail 将具体的月检结果也要带出来。