6 天以前 3d07cf63a7e60e4642d76d1c10c2347c9fd68436
fix(stock): 修复出入库记录导出数据类型错误

- 在入库记录服务中添加StockInQualifiedRecordTypeEnum导入
- 修正入库记录导出时合格品记录类型枚举使用错误的问题
- 在出库记录服务中添加StockOutUnQualifiedRecordTypeEnum导入
- 修正出库记录导出时不合格品记录类型枚举使用错误的问题
已添加2个文件
176 ■■■■■ 文件已修改
doc/safety-operation-manual.md 176 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
doc/safety-operation-manual.pdf 补丁 | 查看 | 原始文档 | blame | 历史
doc/safety-operation-manual.md
¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,176 @@
# Safety æ¨¡å—操作手册
版本:V1.0
更新日期:2026-05-25
适用对象:安全管理、培训管理、巡检管理相关业务人员
## 1. æ¨¡å—概览
Safety æ¨¡å—包含以下业务功能:
1. åŸºç¡€æ¡£æ¡ˆï¼šäººå‘˜æ¡£æ¡ˆã€å²—位风险、作业区域、设备设施、应急资源
2. å·¡æ£€ç®¡ç†ï¼šå·¡æ£€è®°å½•、巡检统计报表、巡检数据同步
3. åŸ¹è®­å­¦ä¹ ï¼šåŸ¹è®­èµ„料、培训计划、培训完成记录、员工学习记录
4. æµ‹è¯„与报告:测评任务、考核报告
## 2. ç™»å½•与基础操作
1. è¿›å…¥ç³»ç»ŸåŽï¼Œä½¿ç”¨è´¦å·å¯†ç ç™»å½•。
2. è¿›å…¥å·¦ä¾§èœå•“安环管理”。
3. æ ¹æ®ä¸šåŠ¡è¿›å…¥å¯¹åº”é¡µé¢ï¼š
   - åŸºç¡€ä¿¡æ¯
   - åŸ¹è®­ç®¡ç†
   - å‘˜å·¥å­¦ä¹ 
   - å·¡æ£€æ•°æ®
## 3. åŸºç¡€æ¡£æ¡ˆæ“ä½œ
### 3.1 äººå‘˜æ¡£æ¡ˆ
用途:维护参与安全培训、测评、巡检的人员信息。
常用操作:
1. ç‚¹å‡»â€œæ–°å¢žâ€å½•入人员姓名、部门、岗位、手机号、入职日期、状态。
2. ä½¿ç”¨å§“名/部门/岗位/状态筛选查询。
3. é€‰æ‹©è®°å½•进行修改或删除。
### 3.2 å²—位风险
用途:维护岗位风险清单与管控措施。
常用操作:
1. æ–°å¢žé£Žé™©ç±»åž‹ã€é£Žé™©ç­‰çº§ã€é£Žé™©æè¿°ã€å²—位、管控措施。
2. æŒ‰é£Žé™©ç±»åž‹ã€ç­‰çº§ã€å²—位检索。
3. ç»´æŠ¤é£Žé™©è®°å½•的更新与删除。
### 3.3 ä½œä¸šåŒºåŸŸ
用途:维护巡检区域与负责人。
常用操作:
1. æ–°å¢žä½œä¸šåŒºåŸŸåç§°ã€ä½ç½®ã€è´Ÿè´£äººä¿¡æ¯ã€‚
2. åœ¨è®¾å¤‡è®¾æ–½ã€åº”急资源、巡检记录中引用作业区域。
3. ä½¿ç”¨â€œå…¨éƒ¨ä½œä¸šåŒºåŸŸâ€ä¸‹æ‹‰èƒ½åŠ›åšå‰ç«¯è”åŠ¨é€‰æ‹©ã€‚
### 3.4 è®¾å¤‡è®¾æ–½ä¸Žåº”急资源
用途:维护安全设施台账及应急资源储备。
常用操作:
1. æ–°å¢žè®¾å¤‡è®¾æ–½ï¼ˆåç§°ã€åž‹å·ã€åŒºåŸŸã€çŠ¶æ€ï¼‰ã€‚
2. æ–°å¢žåº”急资源(名称、类型、数量、位置、区域、负责人、状态)。
3. æŒ‰å…³é”®å­—段检索并进行修改、删除。
## 4. å·¡æ£€ç®¡ç†æ“ä½œ
### 4.1 å·¡æ£€è®°å½•维护
常用操作:
1. æ–°å¢žå·¡æ£€è®°å½•:巡检时间、巡检人员、巡检区域、巡检类型、状态、异常情况。
2. æŒ‰æ—¶é—´åŒºé—´ã€äººå‘˜ã€åŒºåŸŸã€ç±»åž‹ã€çŠ¶æ€ç­›é€‰è®°å½•ã€‚
3. å¯¹é”™è¯¯è®°å½•进行修改或删除。
状态建议:
1. `0`:已完成(正常)
2. `1`:已完成(异常)
3. `2`:已完成(漏检)
4. `3`:未执行
### 4.2 å·¡æ£€ç»Ÿè®¡æŸ¥çœ‹
可查看以下统计结果:
1. ä»Šæ—¥å·¡æ£€ç»Ÿè®¡ï¼ˆæ€»æ•°ã€å®Œæˆæ•°ã€å¼‚常数、漏检数、未执行数、完成率、巡检人数)
2. è¶‹åŠ¿ç»Ÿè®¡ï¼ˆæŒ‰æ—¥æœŸï¼‰
3. ç±»åž‹åˆ†å¸ƒ
4. å·¡æ£€äººå‘˜å±¥èŒç»Ÿè®¡
### 4.3 å·¡æ£€åŒæ­¥ï¼ˆé‡ç‚¹ï¼‰
按钮含义:从外部子系统同步巡检数据到当前系统。
对应接口:`POST /safety/inspection/record/sync`
注意事项:
1. è¯¥æŽ¥å£æ˜¯â€œå­ç³»ç»ŸåŒæ­¥â€æŽ¥å£ï¼Œä¸æ˜¯æ¨¡æ‹ŸæŽ¥å£ã€‚
2. åŒæ­¥æŽ¥å£å— Redis é™åˆ¶ï¼Œæ¯å¤©ä»…允许成功调用一次(按租户+日期控制)。
3. åŒä¸€å¤©é‡å¤ç‚¹å‡»ä¼šæç¤ºï¼š`今日已同步,明天再试`。
4. åŒæ­¥æˆåŠŸåŽå»ºè®®ç«‹å³åˆ·æ–°ï¼š
   - å·¡æ£€è®°å½•列表
   - ä»Šæ—¥ç»Ÿè®¡å¡ç‰‡
   - è¶‹åŠ¿å›¾ã€ç±»åž‹åˆ†å¸ƒå›¾ã€å±¥èŒç»Ÿè®¡å›¾
## 5. åŸ¹è®­å­¦ä¹ æ“ä½œ
### 5.1 åŸ¹è®­èµ„æ–™
流程:
1. å…ˆä¸Šä¼ æ–‡ä»¶ï¼ˆé€šç”¨ä¸Šä¼ ï¼‰ã€‚
2. å†ä¿å­˜åŸ¹è®­èµ„料元数据(资料名称、类型、文件地址、大小、状态)。
3. æ”¯æŒèµ„料查询、更新、删除。
### 5.2 åŸ¹è®­è®¡åˆ’
用途:按年度和岗位维护培训计划。
常用字段:年度、岗位、等级、内容、课时、资料关联、状态。
支持新增、查询、修改、删除、详情。
### 5.3 åŸ¹è®­å®Œæˆè®°å½•
已开放接口:查询、新增、修改、删除、详情、导出。
建议录入字段:
1. è®¡åˆ’ID
2. å‘˜å·¥ID/姓名
3. åŸ¹è®­å†…容
4. å®Œæˆæ—¶é—´
5. æ—¶é•¿ã€æ–¹å¼ã€ç»“果、得分、状态
### 5.4 å‘˜å·¥å­¦ä¹ è®°å½•
用途:记录员工学习行为并生成学习统计。
可查看总学习记录、已完成数、未完成数、总时长、完成率。
## 6. æµ‹è¯„与考核报告操作
### 6.1 æµ‹è¯„任务
1. æŸ¥çœ‹æµ‹è¯„任务列表(标题、截止日期、状态)。
2. å‘˜å·¥å‘起测评(start)。
3. å‘˜å·¥æäº¤æµ‹è¯„(submit),可带分数与备注。
### 6.2 è€ƒæ ¸æŠ¥å‘Š
1. æŒ‰å‘˜å·¥ã€æŠ¥å‘Šåç§°ã€æ˜¯å¦åˆæ ¼æŸ¥è¯¢ã€‚
2. æŸ¥çœ‹æŠ¥å‘Šè¯¦æƒ…(考核时间、成绩、等级、是否合格)。
## 7. å¸¸è§é—®é¢˜
### 7.1 å·¡æ£€åŒæ­¥ä¸ºä»€ä¹ˆå¤±è´¥ï¼Ÿ
请优先检查:
1. å½“天是否已经同步过(每天只能成功一次)。
2. æ˜¯å¦ç™»å½•状态失效。
3. å­ç³»ç»Ÿæ˜¯å¦å¯ç”¨ã€‚
### 7.2 åŸ¹è®­å®Œæˆè®°å½•无数据怎么办?
1. çŽ°åœ¨æ”¯æŒæ‰‹å·¥æ–°å¢žï¼Œå¯ç›´æŽ¥å½•å…¥ã€‚
2. ä¹Ÿå¯ä»¥é€šè¿‡å·²æœ‰è®°å½•导入或后续对接外部来源。
### 7.3 ç»Ÿè®¡å›¾ä¸æ›´æ–°æ€Žä¹ˆåŠžï¼Ÿ
1. å…ˆåˆ·æ–°å·¡æ£€è®°å½•列表确认数据已入库。
2. å†åˆ·æ–°ç»Ÿè®¡æŽ¥å£æ•°æ®ã€‚
3. æ£€æŸ¥ç­›é€‰æ—¥æœŸèŒƒå›´æ˜¯å¦è¦†ç›–新增数据时间。
## 8. æ“ä½œè§„范建议
1. ç»Ÿä¸€ç»´æŠ¤äººå‘˜ã€åŒºåŸŸã€è®¾å¤‡ã€èµ„源基础档案,避免脏数据。
2. å·¡æ£€å¼‚常描述尽量完整,便于追踪整改。
3. æ¯æ—¥å›ºå®šæ—¶é—´æ‰§è¡Œå·¡æ£€åŒæ­¥ï¼Œé¿å…é‡å¤æ“ä½œã€‚
4. åŸ¹è®­å®Œæˆè®°å½•尽量当日录入,确保统计准确。
doc/safety-operation-manual.pdf
Binary files differ