主题
开投安质环监管 · 需求分析文档
文档版本：1.01 ｜ 最近核对日期：2026-11-09
本文是开投安质环监管模块六类交付文档中的需求分析文件；概要设计、详细设计、数据库设计、测试与验收、操作手册见本目录其余文件。
1. 建设背景与目标
开投安质环监管用于归集安全、质量、环保相关目标、计划、监督、整改、事故和考评资料，并通过 Warm-Flow 让需要审核的事项可追溯。模块以组织单位管理为业务主线，不按工程项目做数据过滤。
建设目标：
- 统一维护六类业务台账及其组织快照、附件和审批状态；
- 通过固定表单流程将新增/编辑与查看/办理入口分离；
- 让月度督察通过后按条件自动、幂等地产生整改回复草稿；
- 在页面权限范围内查看全部业务数据，通过按钮/接口权限控制写操作；
- 以真实角色、流程实例、数据库和页面证据完成验收。
2. 建设范围
2.1 本期包含
- 安全质量环保目标；
- 工作计划上报；
- 月度督察；
- 问题整改回复；
- 事故管理；
- 考评管理；
- 固定表单流程工作台、附件、组织快照和平台任务入口。
2.2 明确不做
- 不在业务页面复制“我的任务”、委托、转办、加签、减签等平台能力；
- 不以工程节点、项目或组织单位对列表、详情、导出结果做额外数据过滤；
- 不使用动态表单配置改变六类业务字段含义；
- 附件不是提交前置条件；事故页面提示不等于强制上传；
- 不为同一督察重复生成有效整改回复。
3. 角色与使用场景
| 角色 | 使用目的 | 主要结果 |
|---|---|---|
| 发布部门人员 | 制定目标、发起月度督察和考评 | 保存组织/人员/时间快照并发起对应流程 |
| 二级单位人员 | 上报计划、接收督察、提交整改和事故 | 在固定表单中补充资料并提交审核 |
| 集团审核人 | 审核目标、计划、整改、事故 | 在 Warm-Flow 任务中办理 |
| 具备页面权限的查看人员 | 查询全部台账及流程状态 | 不受创建人、单位或工程范围限制 |
| 平台事件处理 | 生成整改草稿、回写审批状态 | 事务内幂等处理，保存来源关系 |
4. 核心业务场景与流程
4.1 目标管理
发布部门按年度、管理类别制定目标，填写指标名称、目标和目标说明，通过选人弹窗选择二级单位接收人（可多选），适用单位按所选接收人所在部门自动带出且不可手工修改，并上传说明资料。记录只保留审批状态，按平台流程状态完整展示草稿、审批中、退回、已完成、撤销、作废、终止等状态；同一年度业务上维护一条目标，台账默认展示当前年度最新记录，审批完成后允许删除。转办、委派、加签、减签、抄送等属于流程动作，不另设业务发布状态。
4.2 工作计划上报
上报单位提交年度目标分解和工作计划，通过选人弹窗选择二级单位接收人（可多选）后进入“二级单位审核 → 开投集团审核”。当前年度按上报单位卡片展示，历史年度通过“历史数据”入口查看。
4.3 月度督察与整改
发布部门按年度、月份和督察类型指定接收单位，进入“二级单位接收”。年度与月份是两个独立业务字段，查询区和新增/编辑表单的月份统一从 1月～12月 选择，不显示浏览器当前年份；接口和数据库仍分别使用 year、month。选择需要整改且流程通过后，系统事务内创建一条来源只读的整改回复草稿；不需要整改、未通过、终止或重复事件均不创建第二条。
4.4 事故与考评
事故按年度、类型和等级登记，进入“二级单位审核 → 开投集团审核”；考评按年度、考核类别和被考核单位登记，进入“二级单位审核”。
5. 业务规则与验收口径
| 编号 | 规则 | 来源/状态 |
|---|---|---|
| R-SQE-001 | 六类业务独立，唯一业务外键为月度督察到整改回复 | 已确认 |
| R-SQE-002 | 新增/编辑在业务台账固定表单完成，查看/办理才进入流程工作台 | 已确认 |
| R-SQE-003 | 草稿或退回申请人可编辑并沿原实例重提；办理中、通过、终止、撤销、作废只读；编辑草稿或退回重提时下一办理人不自动回填，提交前需重新选择 | 已确认，下一办理人规则按方案 B 明确，仍需真实流程回归 |
| R-SQE-004 | 页面权限决定可见范围，组织字段不参与数据过滤 | 已确认 |
| R-SQE-005 | 目标适用单位由所选二级单位接收人的部门自动带出（只读）；督察接收单位、被考核单位仍单选 | 已确认 |
| R-SQE-006 | 附件非必填；事故页面显示盖章版报告提示 | 已确认 |
| R-SQE-007 | 整改回复只能由已通过且需要整改的督察生成，来源字段只读且幂等 | 已确认，需并发实测 |
| R-SQE-008 | 六类业务记录统一按状态处理：草稿、退回、已完成均可删除；审批中、撤销、作废、终止不可删除 | 已确认 |
| R-SQE-009 | 六类流程的二级单位接收人通过选人弹窗多选；下一节点任务多人共享，任一人办理即通过（或签），提交时至少选择一人 | 已确认 |
| R-SQE-010 | 六类业务实例查看流程图时，当前办理节点必须显示引擎实际办理人；历史节点继续显示历史办理记录 | 已确认，需部署后页面回归 |
| R-SQE-011 | 月度督察年度与月份独立维护；查询、新增和编辑的月份控件只显示 1月～12月，不使用浏览器当前年份；接口和数据库继续使用 year、month | 已按方案 A 实现并完成前端与有效登录页面回归 |
| R-SQE-012 | 月度督察与考评管理属于上级单位下发下级单位业务，操作按钮统一定义为「提交」（去审批化口径）；月度督察新增时「是否需整改」默认选中「是」；流程办理弹窗中附件标签统一校准为「本次任务处理附件」 | 已实现并完成页面回归 |
6. 非功能要求
- 使用平台固定表单、统一附件服务、统一流程任务和统一权限机制；
- 组织/人员/时间保存名称快照，不允许用户手工篡改系统生成值；
- 后端必须校验提交必填、状态、权限、重复事件和数据一致性；
- 数据库逻辑类型可迁移，当前 DM8 物理实现需标注人大金仓/openGauss 差异；
- 办理页采用左侧只读业务表单、右侧审批时间线的两栏布局；顶部信息卡按“业务标题 / 流程信息 / 单据编号”三栏展示，操作区保持“流程图在左、返回在最右”；审批操作以弹窗打开，流程图打开 80% 高度底部抽屉。业务表单和审批时间线附件统一使用
FileUpload。
7. 待核对事项
- 草稿空值与实际
NOT NULL字段冲突的迁移方案； - 类别字典是否统一使用独立字典；
- 完成监听并发与重复事件的真实数据库行为。
8. 历史依据与变更
| 来源 | 用途 |
|---|---|
b3c737714 | 初始设计/开发交接资料 |
629508b0c | 模块和六类业务首次实现 |
c33c675b4、3718d3b4c | 流程节点、布局和监管流程修复 |
cb5ab5ceb | 实现层转换问题修复 |
| 数据库设计 | 本模块字段矩阵、原核验日期与结构差异 |
2026-10-14 合资公司业主单位候选兼容
发布、上报、接收及被考核单位的共享候选与保存校验统一接受有效业主单位（deptType=1 且 orgType=group/company/branch/joint_venture）；不限体系的单位字段同时沿用参建真实 company 的既有范围。部门、项目部、参建归集根不能作为单位，原有审批和数据可见范围不变。验收例子：启用业主合资公司可被选择并以原 ID 保存；有效参建公司继续可选；部门、参建归集根及共享校验不支持的参建类型仍被拒绝，不为合资公司另建同名组织。