3. 许可工作流核心概念：许可类型、状态机、审批链、有效期管理
在数字工地管理现场看板中，许可工作流是保障高风险作业（动火、受限空间、高处作业等）合规启动与闭环的核心机制。理解其四大核心概念——许可类型、状态机、审批链、有效期管理——是后续接口调试与看板图表配置的基础。
3.1 许可类型：按作业风险维度分类
许可类型决定了工作流的模板、审批节点与安全措施要求。常见分类如下：
| 许可类型 | 典型场景 | 审批层级 | 安全措施模板 |
|---|---|---|---|
| 动火作业许可 | 焊接、切割、打磨 | 安全员 → 项目经理 | 灭火器、防火毯、气体检测 |
| 受限空间许可 | 储罐、管道、地坑 | 安全员 → 监护人 → 项目经理 | 通风、气体检测、救援设备 |
| 高处作业许可 | 脚手架、屋面、塔吊 | 安全员 → 技术负责人 | 安全带、安、警示区 |
| 临时用电许可 | 配电箱、电缆敷设 | 电气工程师 → 安全员 | 漏电保护、接地、绝缘检测 |
| 吊装作业许可 | 大型设备吊装 | 安全员 → 技术负责人 → 项目经理 | 吊具检查、警戒区、风速监测 |
接口调试提示： 在
/api/permit/types 接口中，permitTypeCode 字段对应上述类型编码（如 HOT_WORK、CONFINED_SPACE）。看板图表需根据此字段做分类统计。
3.2 状态机：许可生命周期的状态流转
每个许可从创建到归档，经历一组严格定义的状态。状态机确保操作顺序不可逆，且每个状态触发特定的看板事件。
看板配置要点： 状态字段
permitStatus 的值必须与状态机严格对应。看板图表中的“待审批”“作业中”“超期未关闭”等指标，均基于此字段过滤。
3.3 审批链：多级审批与动态路由
审批链定义了许可从提交到批准的流转路径。根据许可类型和风险等级，审批链可动态配置。
3.3.1 审批链结构
- 固定审批链： 按许可类型预定义审批节点顺序（如安全员 → 项目经理）。
- 动态审批链： 根据作业风险等级、区域、金额等条件自动匹配审批人。
- 会签/或签： 同一节点可配置多人会签（全部同意）或或签（一人同意即可）。
3.3.2 审批链配置示例
| 审批节点 | 角色 | 审批方式 | 超时处理 |
|---|---|---|---|
| 节点1 | 安全员 | 或签（任一安全员） | 24h 自动转交上级 |
| 节点2 | 技术负责人 | 单人审批 | 48h 自动驳回 |
| 节点3 | 项目经理 | 单人审批 | 72h 自动升级 |
接口调试注意： 审批链配置存储在
/api/permit/approval-chain 接口。看板图表需展示“当前审批节点”“审批耗时”“超时预警”等字段，这些数据来自审批链的实时状态。
3.4 有效期管理：时间窗口与超期控制
每个许可都有明确的有效期窗口，超过有效期未完成作业或未关闭的许可，将触发预警或自动关闭。
3.4.1 有效期关键字段
| 字段 | 说明 | 看板应用 |
|---|---|---|
startTime |
许可生效时间（通常为批准时间） | 图表横轴起始点 |
endTime |
许可到期时间 | 超期判断基准 |
actualEndTime |
实际作业结束时间 | 实际工期计算 |
extensionCount |
延期次数 | 延期预警统计 |
3.4.2 超期处理策略
- 预警阈值： 到期前 1 小时、30 分钟、10 分钟分别触发看板预警。
- 自动关闭： 超过有效期 24 小时未关闭的许可，系统自动置为“已关闭”状态。
- 延期申请： 允许在有效期内提交延期申请，每次延期不超过原有效期的一半。
3.5 核心概念关系总结
| 概念 | 作用 | 看板图表关联字段 |
|---|---|---|
| 许可类型 | 分类统计、模板匹配 | permitTypeCode |
| 状态机 | 生命周期跟踪、流转控制 | permitStatus |
| 审批链 | 审批进度、耗时分析 | currentApprover、approvalDuration |
| 有效期管理 | 超期预警、自动关闭 | endTime、extensionCount |
接口调试建议： 在调试
/api/permit/list 接口时，务必验证上述四个核心字段的返回格式与枚举值。看板图表的过滤、聚合、预警逻辑均依赖这些字段的准确性。