危险作业许可 · 产品需求文档

1背景与目标

1.1 业务背景

施工项目现场存在动火、高处、移动钢模台车、爆破、临时用电、排除危石等危险作业，作业前需经许可审批确认安全条件后方可实施。目前许可审批多依赖线下纸质流程，存在过程不透明、记录难追溯、作业信息不规范等问题。

1.2 产品目标

在智慧工地平台「安全管理 > 作业面安全管控」下新增「危险作业许可」功能，实现：

• 线上化审批：危险作业申请、审批、撤回、驳回全流程线上流转；驳回即作废（终态，仅可查看），状态实时可查。
• 移动端便捷填报：工人通过扫码进入 H5 页面自主填报，解决工人无系统账号的问题。
• 过程留痕：保存申请单据、审批流程进度，支持事后追溯。

1.3 使用场景与角色

1.4 项目相关资料

• 在线原型：危险作业许可交互原型 ↗
• 操作指南：危险作业许可-移动填报操作指南.docx（点击下载）
• PRD 源文档：危险作业审批prd.md（md 源文件，点击下载）

2业务流程与状态机

2.1 状态定义（5 态）

2.2 状态流转

新增 ──保存草稿──→ 待提交
新增 ──提交审批──→ 审批中
待提交 ──提交审批─→ 审批中
审批中 ──通过────→ 已通过（终态，只读）
审批中 ──驳回────→ 已驳回（作废终态，仅可查看）
审批中 ──撤回────→ 已撤回
已撤回 ──编辑──→ 保存草稿 → 已撤回（状态保持不变）
已撤回 ──编辑──→ 提交审批 → 审批中（重新发起审批）

• 编辑入口：待提交、已撤回单据可「编辑」；已驳回（作废终态）、已通过、审批中仅可查看（审批中单据可在详情页撤回）。
• 保存草稿：保存草稿不改变单据状态——待提交保存后仍为「待提交」，已撤回保存后仍为「已撤回」，表单界面状态即时刷新。
• 删除：「待提交」「已撤回」单据可删除。
• 已驳回 = 作废：审批未通过的单据视为作废、进入终态，仅可查看详情，不允许编辑、删除、撤回或重新提交审批。

2.3 审批模式

• 单人审批：审批人为单选，每次提交仅指定一名审批人，由其处理通过/驳回

3PC 端功能需求

3.1 页面框架

• 左侧菜单：作业面安全管控分组下「作业面安全条件确认」「危险作业许可」（新增，放在分组最后）。
• 面包屑：安全管理 / 作业面安全管控 / 危险作业许可。
• 页头右侧按钮：+ 新增。
• 页面命名：PC 各页标题/菜单/面包屑统一为「危险作业许可」（新增/编辑/详情按表单场景区分）。

3.2 列表页

3.2.1 筛选区

默认展示一行（作业类别 / 作业地点 / 申请人），点「展开」后追加第二行（申请时间 / 状态 / 单据编号），再点「收起」恢复单行；所有条件支持单项清除（下拉选中后显示 X，日期选择器一键清空）。

3.2.2 列表字段（按顺序）

• 列表不展示「单据编号」列（详情/表单单据信息中可查看）；查看详情通过行操作「详情」进入。
• 排序：按创建日期（申请时间）倒序，最新的在最前；筛选、分页后保持倒序。
• 表格区域固定高度（约 8 行），行数超出区域内滚动，表头 sticky；列宽超容器时横向滚动，操作列固定右侧。
• 单据编号格式：作业类别码 + 日期 + 4 位流水号（如 DH202608280002），作业类别码映射如下：

3.2.3 行操作（按状态显隐）

各状态下列表行内按钮的显示/隐藏：

3.3 表单页（新增 / 编辑 / 查看）

• 场景说明：新增态 / 编辑态可录入字段，查看态（详情）全部字段只读展示，标题「危险作业许可详情」；提交审批后就地切换为查看态，查看态「审批中」单据可点「撤回」→ 确认后切换回编辑态继续修改。
• 流程进度（仅查看态）：时间轴展示——开始节点（管理员）：已提交 + 时间；审批节点：显示审批人、状态（等待处理/已通过/已驳回/已撤回）及图标（时钟/绿勾/红叉/撤回图标）。

3.3.1 字段清单

3.3.2 页头按钮

按钮功能点在本节统一描述一次（新增 / 编辑 / 查看三态共用，不再按页面重复）；各状态下的按钮显隐见本节末「控制点」表。

• 控制点——各单据状态下页头按钮的显示/隐藏（√ 显示 / × 隐藏）：

• 新增态（尚未生成单据状态）不显示导出、撤回，仅显示保存草稿、提交审批、返回；审批中单据撤回后单据状态变为「已撤回」并进入编辑态，按钮显隐同「已撤回」行。

3.4 提示与弹窗规范

• 成功类 toast：绿色胶囊样式（浅绿底 + 绿勾图标 + 绿字）。
• 确认类弹窗：标题「系统提示」+ 右上角关闭；横向布局（橙色警示图标 + 加粗标题 + 说明文案）；底部「取消」+ 蓝色「确认」。

3.5 二维码自主填报 + 操作指南下载（列表页按钮）

• 列表页「二维码自主填报」按钮：生成含入场二维码的 Word 操作指南文档供下载打印，工人扫码进入 H5 填报页。
• Word 文档采用用户自定义模板（危险作业许可-移动填报操作指南.docx），系统运行时仅替换模板内二维码图片与相关文字，保留模板排版。
• 文档内文案：顶部主标题「演示项目 - 危险作业许可填报指南」；右栏引导模块统一为「危险作业登记」（不再区分填报对象）。
• 下载文件名：危险作业许可-移动填报操作指南.docx。
• 列表页「查看H5界面功能」按钮：快速打开 H5 原型演示。

4H5 移动端功能需求（工人自主填报）

4.1 登录页

• 输入手机号 + 图形验证码后进入；登录不再采集姓名，手机号在后续表单中只读带入，姓名改在「新增申请」的人员信息中录入。

• H5 端顶栏标题、登录副标题、流程标题等统一为「危险作业许可」；「新增申请」等操作文案不变。

4.2 我的申请记录（列表）

• 顶部固定：搜索框（仅支持按单据编号搜索）、统计信息；底部固定「+ 新增申请」悬浮按钮（不随列表滚动）。
• 卡片：标题显示「单据编号：{编号}」，展示作业类别、申请单位、作业地点、作业时间等字段（grid 布局）。
• 右上角状态印章：双圈 + 中线 + 旋转的印章效果，五态配色见 2.1（印章仅用于列表卡片，详情/表单页不展示）。
• 排序：按创建时间倒序，最新在前。
• 点击行为：待提交、已撤回 → 打开编辑态；其余状态 → 打开只读详情。

4.3 新增 / 编辑表单

页面模块自上而下：

• 单据信息（仅编辑/详情态显示，新增不显示）：单据编号、状态（只读；状态值加粗并按当前状态着色，醒目展示，字段名显示「状态」）。
• 人员信息：
  • 身份证号：必填（仅新增态可录入）；输入框右侧纯相机图标按钮，点击模拟拍照识别（OCR）1.2s 后回填；除新增态外一律脱敏展示（前 4 位 + 星号 + 后 4 位），不允许明文；
  • 姓名：必填（仅新增态可录入）；手机号：只读（登录带入）。
  • 人员信息编辑权限：仅新增态允许录入/调整，编辑态与查看详情一律只读展示。
  • 人员信息自动匹配（新增态）：用登录手机号在系统账户、此前提交的危险作业许可中匹配用户信息（进入新增页即匹配一次），命中则把匹配到的身份证号、姓名默认赋值到表单（仅默认值，允许用户调整）；命中后人员信息区底部显示轻提示「已自动带入当前手机号对应的人员信息」。
• 基础信息：作业类别（下拉）、申请单位（下拉，未选时灰色「请选择」）、作业地点（树形节点选择：工程分区 → 作业面 → 网格区域，只允许选择末级节点，选中后展示完整路径）、作业开始/结束时间、作业内容及防范措施（多行文本，应包含作业内容、安全风险分析、安全及职业病危害防护措施、应急处置等内容）。
  • 新增态自动带出：进入新增页按登录用户（优先身份证号，无身份证号再按手机号）在劳务实名制工人台账中查找，命中则自动带出分包单位 → 申请单位（仅初始值，可下拉修改），不显示提示文案。
• 审批人：点击弹出选择弹窗。

审批人选择弹窗：

• 数据结构：默认「演示项目」，下设 5 个部门（每部门约 4 人），项目直属人员约 5 人直接平铺在部门列表下方（无单独分组间隔）。
• 支持：按姓名搜索筛选、单选（点击替换、再次点击取消）、底部已选人员实时展示、清空按钮、确认后回填表单。

详情页导出：H5 申请详情页顶栏「返回」按钮右侧提供「导出」按钮，点击按《危险作业审批表》模板格式导出 PDF，字段回填规则与 PC 端一致（见 3.3.2）。

底部按钮：

• 新增/编辑态：「提交」→ 状态置「审批中」→ 跳转提交成功页。

4.4 提交成功页

• 展示提交结果与关键字段，字段分行排版（非堆叠）。
• 重要提示（固定文案）：申请成功后系统不发送短信，请扫码查询审批结果。

5非功能需求

• 视觉规范：严格对齐「项目管理一体化平台（智慧工地平台）」现有后台视觉（参见 00-共享资产/设计规范/视觉规范.md 及视觉参考截图）。
• 数据权限：项目级功能；企业端/集团账号只读。
• 敏感信息：身份证号非新增态强制脱敏展示。
• 兼容性：PC 主流浏览器；H5 移动端（微信内扫码打开）。

6待确认事项

• 导出按钮的业务控制场景。
• 列表导出 Excel 模板。
• H5 主界面的高级筛选条件。

7变更记录

> 记录最近迭代的关键变更（倒序，最新在前），便于研发 / 测试核对。