主题
开投安质环监管 · 概要设计文档
文档版本：1.01 ｜ 最近核对日期：2026-11-09
1. 设计目标与边界
模块按组织单位归集安全、质量、环保的目标、计划、督察、整改、事故和考评资料。六类台账相互独立，唯一业务外键为“月度督察 → 整改回复”。业务单据保存审批状态和组织快照，流程实例由平台扩展关系维护。
业务台账负责新增、编辑和草稿；查看和待办办理进入固定表单流程工作台。Warm-Flow 负责任务、审批记录和通用办理动作，模块不复制平台任务能力。
月度督察的年度与月份独立维护。查询和固定表单均以 1月～12月 的纯月份选项录入，不把浏览器当前年份带入月份展示；业务接口和持久化仍使用独立的 year、month 字段。
2. 模块分解
| 能力 | 职责 | 主表 |
|---|---|---|
| 指标下发 | 目标登记、适用单位、目标审批 | BIZ_SQE_TARGET、BIZ_SQE_TARGET_UNIT |
| 计划上报 | 年度工作计划及组织快照 | BIZ_SQE_WORK_PLAN |
| 督查 | 月度督察和接收单位 | BIZ_SQE_MONTHLY_SUPERVISION |
| 整改闭环 | 来源督察、整改回复和独立审批 | BIZ_SQE_RECTIFICATION_REPLY |
| 事故管理 | 类型/等级、事故资料和审批 | BIZ_SQE_ACCIDENT |
| 考评管理 | 年度考核、被考核单位和审批 | BIZ_SQE_ASSESSMENT |
3. 核心运行流程
目标、计划、整改和事故走二级单位/集团审核；月度督察只生成二级单位接收任务；考评只生成二级单位审核任务。审批、委托、转办、加签、减签从平台任务入口执行。
4. 状态与事件
| 状态/事件 | 行为 |
|---|---|
draft | 可编辑、可保存；提交时执行业务必填校验 |
waiting | 流程办理中，业务单据不可编辑 |
back | 退回申请人，可编辑并完成原申请人节点后重新提交 |
finish | 流程完成；六类业务记录均允许删除，不允许修改 |
cancel / invalid / termination | 平台终止态，只读，不重复提交 |
| 督察完成事件 | needs_rectification=yes 且无有效回复时事务内创建一条整改草稿 |
5. 权限与数据边界
- 资源权限采用
sqe:<resource>:<action>，包括list/query/add/edit/remove/export/submit； - 页面权限是业务数据唯一可见条件，组织字段用于显示和流程归属，不参与查询过滤；
- 服务端执行状态、提交、按钮和任务办理人校验，不能用隐藏按钮替代；
- 发布/上报部门、人员、时间由系统生成并保存快照；整改回复首次人工保存时补齐缺失上报快照并冻结。
6. 外部依赖与兼容性
| 依赖 | 用途 | 失败处理 |
|---|---|---|
| Warm-Flow | 流程启动、任务和审批状态 | 事务失败回滚单据，台账显示可核对错误 |
| 组织/用户 | 选择发布、上报、接收和被考核单位 | 共享候选与保存校验接受业主集团、公司、分公司及合资公司（deptType=1，orgType=group/company/branch/joint_venture），不限体系字段继续支持参建真实公司（deptType=2，orgType=company）；排除部门、项目部和参建归集根；服务端验证 ID 有效，保存名称快照 |
| 文件服务 | 附件 JSON、预览和下载 | 附件失败返回错误，不以占位值通过 |
| DM8/目标数据库 | 持久化和唯一索引 | 逻辑类型跨库，厂商 DDL 集中适配 |
7. 代表性链路验证建议
月度督察与整改回复的联动可通过“发布月度督察 → 审核完成 → 自动生成整改回复草稿 → 整改单位补充并提交 → 两级审核”验证；同时覆盖固定表单工作台布局、页面查看范围、来源只读、重复事件幂等和数据库唯一性。此路径仅用于相应行为的验证，不作为其他独立能力的开工前置条件。
8. 历史依据
核心设计来自 b3c737714、629508b0c、c33c675b4、3718d3b4c 和 cb5ab5ceb；数据库实际字段来自 2026-08-28 DM8 结构参考。固定表单工作台遵循前端 UI 规范，待核对项以需求分析为准。