主题
开投安质环监管 · 测试与验收文档
文档版本：1.01 ｜ 最近核对日期：2026-11-09
当前进展：目标、工作计划、月度督察、需整改及整改回复代表性正式链路已复验；事故正式上报、考评正式流程、全角色和扩展分支仍待专项；覆盖性测试角色范围较宽的测试夹具风险按方案 B 接受；编辑/退回后下一办理人重新选择规则按方案 B 明确；月度督察月份控件已按方案 A 修复
本文基于实现提交和当前页面/API 整理。最终结论必须来自真实接口、数据库、流程定义、浏览器和等价角色。
1. 测试范围与环境
| 项目 | 内容 |
|---|---|
| 范围 | 六类台账、固定表单流程、流程工作台、权限全量查看、附件、状态、整改联动、并发幂等 |
| 前端 | digital-construction-ui/src/views/business/sqe/**、src/api/business/sqe/** |
| 后端 | digital-construction-modules/digital-construction-business/** |
| 数据库 | DM8 DIGITAL_CONSTRUCTION；目标数据库差异另行核对 |
| 角色 | 集团发布人、二级单位上报人、集团审核人、仅查看用户 |
| 模拟组织 | 开投集团/建设管理部；建设公司/工程管理部；资源公司/安全环保部 |
2. 需求追踪矩阵
| 需求编号 | 设计落点 | 测试用例组 | 状态 |
|---|---|---|---|
| R-SQE-001 六类台账与流程 | 概要设计 | TG-01～TG-06、WF-01～WF-09 | 代表性正式链路已核验，其他流程/角色待专项 |
| R-SQE-002 固定表单工作台 | 详细设计 | UI-01～UI-06 | 已形成用例，待全角色回归 |
| R-SQE-003 督察整改联动 | 概要设计 | MR-01～MR-07 | 需整改→自动回复→回复完成已核验，并发和删后重建待实测 |
| R-SQE-004 页面权限全量可见 | 需求分析 | PM-01～PM-05 | 测试单位覆盖性角色和最小只读角色已核验；按方案 B 接受覆盖性角色范围较宽的测试夹具风险，不以其作为全角色权限结论，等价业务角色不纳入本批次专项 |
| R-SQE-005 附件与组织快照 | 详细设计 | TIP-01～TIP-04、PM-04 | 持续验收 |
| R-SQE-010 流程图显示当前实际办理人 | 详细设计 | WF-14、TIP-05 | 自动化已核对，部署后页面待复验 |
3. 关键测试用例
3.1 目标、台账和状态
| 用例组 | 覆盖内容 | 预期结论 |
|---|---|---|
| TG-01～TG-06 | 草稿、提交必填、适用单位多选、流程完成、年度展示、已完成内容只读且可删除 | 服务端校验必填和审批状态 |
| WF-01～WF-08 | 六条流程、退回、原实例重提、终态只读 | 流程实例和状态一致，不重复创建 |
| WF-09～WF-13 | 平台通用任务动作、仅查看用户、退回中间节点 | 模块不复制任务能力，权限和节点状态正确 |
3.2 固定表单、整改联动与权限
| 用例组 | 覆盖内容 | 预期结论 |
|---|---|---|
| UI-01～UI-06 | 台账新增/编辑、查看/办理入口、两栏工作台、三栏头部信息卡、顶部动作区、流程图抽屉、流程监控跳转 | 新增编辑不创建实例，流程工作台路径可达 |
| MR-01～MR-07 | 不整改、需整改、重复完成事件、来源只读、无来源新增、删后重建 | 只生成一条有效整改回复，来源和组织快照正确 |
| PM-01～PM-05 | 页面权限、按钮权限、组织用户、附件、工程范围参数 | 页面权限决定可见，接口仍鉴权且不按组织过滤 |
| TIP-01～TIP-04 | 当前/历史提示、整改说明、来源详情、事故盖章版提示 | 提示清晰，附件仍非必填 |
3.3 流程图当前办理人
| 用例组 | 覆盖内容 | 预期结论 |
|---|---|---|
| WF-14 / TIP-05 | 流程实例当前节点尚无历史任务，但存在运行中任务及审批办理人关联；同时保留历史节点提示 | 当前节点显示“当前办理人：姓名（部门）”、用户账号、办理状态和接收时间；历史节点仍显示历史办理信息 |
4. 自动化与实测记录
| 验证项 | 命令/入口 | 最近结果 | 证据 |
|---|---|---|---|
| 前端单元测试 | pnpm exec vitest run | 本轮 24 个测试文件、140 项通过 | |
| 本批次前端全量回归 | pnpm --dir .\digital-construction-ui exec vitest run | 2026-09-14 复跑；36 个测试文件、191 项通过；新增草稿校验单元测试 3 项、月份选项回归 1 项 | 本批次输出 |
| 本批次前端质量闸门 | vue-tsc --noEmit、oxlint、生产构建 | 均通过；生产构建仅保留既有大包提示 | 本批次输出 |
| 后端模块测试 | .agents/tools/dev.ps1 maven '-Dmaven.test.skip=false' '-pl' 'digital-construction-modules/digital-construction-business' '-am' 'test' | 2026-09-14；业务模块 94 项、工作流模块 12 项通过，0 失败/0 错误；BIM 依赖模块 13 项通过但不纳入本模块结论 | 本批次 Maven 输出 |
| 流程图办理人自动化回归 | .agents/tools/dev.ps1 maven '-Dmaven.test.skip=false' -pl digital-construction-modules/digital-construction-workflow -am test | 2026-09-12；FlwChartExtServiceImplTest 1 项通过，工作流模块全量 12 项通过 | digital-construction-modules/digital-construction-workflow/target/surefire-reports/com.bokun.workflow.service.impl.FlwChartExtServiceImplTest.txt |
| API/流程实测 | /business/sqe/**、Warm-Flow | 目标、工作计划、正常/需整改月度督察及整改回复已完成正式提交、办理、完成态和待办归零回读；事故/考评正式流程及全角色仍待专项 | 本批次 API/流程记录 |
| DM8 结构与数据 | .agents/mcp/dm8-mcp | 结构已集中参考，联动数据待实测 | |
| 浏览器端到端 | 项目 Playwright MCP | 已验证超级管理员登录、目标页面、目标审批状态和删除入口、目标/目标说明字段及新增表单入口；本批次新增并保留代表性草稿、附件和需整改分支数据，未删除测试数据 | |
| 流程图页面验收 | Warm-Flow 实例流程图；悬停当前进行中节点 | 本次未启动浏览器；代码和自动化已通过，部署后需确认当前节点可见实际办理人 | 待用户/角色验收 |
5. 缺陷与遗留问题
| 编号 | 问题 | 影响 | 状态 |
|---|---|---|---|
| S-TEST-001 | 目标年度唯一性与历史展示规则存在旧设计/当前实现差异 | 台账结果口径 | 已按“一年一条、当前年度展示最新”统一 |
| S-TEST-002 | 草稿空值与实际名称 NOT NULL 冲突 | 草稿保存 | 已增加前后端名称校验 |
| S-TEST-003 | 退回记录保留、整改新增端点、下一办理人选择职责需统一 | 流程闭环 | 下一办理人编辑/退回后重新选择已按方案 B 确认；退回记录保留和整改新增端点仍待确认 |
| S-TEST-004 | 字典编码、完成撤销后的审批状态和并发监听需真实核对 | 状态/数据一致性 | 待核对 |
| S-TEST-005 | 流程图当前节点原先只显示任务名称，无法定位实际办理人 | 流程跟踪 | 已在平台工作流 ChartExtService 修复；自动化通过，页面待部署后复验 |
| S-TEST-006 | 工作计划、月度督察、考评管理的草稿分支原先跳过表单校验；空表请求可绕过页面直写 DM8 非空字段并显示未知异常 | 草稿保存被阻断，直接接口调用缺少同等保护 | 页面已抽取共享 validateSqeDraftFields，三个入口空值回归均显示字段级提示，考评有效草稿保存成功。2026-10-12 补充：三个 Controller 已加入校验分组（@Validated 分组），相关 BO 已补必填约束，Service 层亦有保存校验，静态代码层面已具备空值阻断；但本轮未运行接口/回归测试，该修复尚未验证通过，Service 层校验未覆盖所有分组字段，需另行确认完整契约 |
| S-TEST-007 | 事故管理前端规则曾将契约中非必填的附件标为必填 | 无附件的合法事故上报可能被前端阻断 | 去掉附件必填规则，保留盖章版报告提示；新增页面附件标签不再带必填标识，正式提交仍待动作确认 |
| S-TEST-008 | 目标、工作计划、月度督察、考评等编辑回填会把 nextHandlerIds 重置为空 | 草稿/退回再次提交前存在漏选接收人的操作风险 | 按方案 B 确认并保留既有实现： 下一办理人属于提交动作级路由参数，编辑草稿或退回重办后不自动回填；前端六类固定表单已增加“接收人不会自动保留，请在提交前重新选择”提示，提交前仍由前后端规则强制选择 |
| S-TEST-009 | 月度督察表单将业务年度与月份拆成两个字段，选择 2027 年后月份控件仍显示浏览器上下文的 2026-10 | 不影响列表按 2027/10 持久化，但可能让录入人员误判月份所属年度 | 按方案 A 修复并关闭： 查询和新增/编辑表单统一改为 1月～12月 纯月份选择，继续提交 year、month，不改接口、数据库和历史数据；测试员有效登录页面选择年度 2027、月份 12月 后显示仍为 12月，筛选 10月 返回 1 条，重置后恢复 2 条 |
| S-TEST-010 | 事故管理草稿分支与 S-TEST-006 同源问题未覆盖：前端暂存不校验，后端 add/update 也不校验，空表单暂存直写 ACCIDENT_TITLE 等非空列并返回 500 发生未知异常 [错误编号] | 事故草稿保存被阻断，用户看到与业务无关的系统异常 | 已修复并关闭： 后端 add/update 增加与提交同口径的 validateSave，前端对暂存做字段级校验；页面空表暂存改为显示「年度/事故类型/事故等级/事故标题不能为空」且不再发起请求；SqeAccidentServiceImplTest 5/5 通过（含 4 个新增用例），digital-construction-business 模块 BUILD SUCCESS |
本轮新增的下一办理人提示已覆盖六类固定表单，并由前端契约回归验证；由于内置浏览器登录会话过期，未新增有效登录态截图，不将该提示的视觉效果表述为已完成浏览器验收。
6. 验收结论
本批次代表性结论为“正式主链通过、扩展范围待专项”：安全目标、工作计划、正常月度督察、需整改月度督察和自动生成整改回复均已真实提交、推进并回读流程结束及待办归零；测试组织、办理人、流程实例、业务状态、整改关联和附件均有证据。页面草稿字段拦截已通过，但工作计划、月度督察、考评的后端草稿 add/update 直接调用仍待修复和接口回归；事故正式上报、考评正式流程、发布人/二级单位/集团审核/仅查看四类等价角色完整旅程、并发与删后重建仍不能据此声明整体通过。
本次流程图通用办理人提示的代码验证范围已完成：工作流模块全量 12 项测试通过，其中当前节点无历史但有运行中办理人的回归用例通过。正式 SQE 主链的接口和流程状态已回读；事故管理/工作计划实例的流程图悬停视觉仍未作为本批次已通过结论，不将代码测试结果替代页面验收。
历史依据包括 b3c737714、629508b0c、c33c675b4、3718d3b4c 和 cb5ab5ceb；未核对项必须保持待确认，不得以构建成功替代业务验收。
7. 2026-09-13～2026-09-14 全模块 E2E 批次同步
本批次在保留原有草稿和附件的基础上，补做了目标、工作计划、正常月度督察、需整改月度督察及自动生成整改回复的正式提交与流程办理。测试单位下的测试人员、岗位、菜单/按钮权限和工程数据范围均沿用本批次准备结果；测试数据、流程历史和测试附件全部保留。
| 验证项 | 结果 | 证据与边界 |
|---|---|---|
| 安全目标正式流程 | 通过 | E2E安全目标-20260913（2099056264522342401）提交生成流程实例 2099184588703768577；测试员完成单位审核，业务与流程均为完成态，currentTaskId=null、活动待办 0，流程版本 4 |
| 安全工作计划正式流程 | 通过 | E2E安全工作计划-20260913（2099056981337284610）提交生成实例 2099187720267603970；完成集团审核和动态生成的“开投建管部安全质量管理经办人接收”节点，业务/流程完成、活动待办 0，流程版本 2 |
| 正常月度督察 | 通过 | E2E安全月度督察-20260913（2099057627784388609）正式提交并完成；needsRectification=0，完成态列表可回读，未生成整改回复 |
| 月度督察需整改分支 | 通过 | E2E需整改月度督察-20260914（2099174109759512577）以业务年度 2027、月份 10、质量和 needsRectification=1 提交，测试员完成首个单位审核节点；随后由完成事件生成整改回复记录，来源关系可回读 |
| 整改回复正式流程 | 通过 | 自动生成回复记录 2099187882461339650 提交并完成单位审核、集团审核两个节点，流程实例 2099194264598192129 完成、活动待办 0；回复附件使用保留测试附件，整改回复台账显示完成 |
| 目标/工作计划/督察草稿空值阻断修复 | 已修复 | 工作计划、月度督察、考评原先会把空值请求送入 DM8 非空列；共享字段校验修复后页面级空值回归均显示字段级业务提示，未产生脏数据 |
| 事故管理附件契约 | 通过（修复后） | 新增页保留盖章版事故报告提示，附件不再显示必填标记；正式事故流程尚未纳入本批次完成态结论 |
| 考评管理 | 草稿通过，正式流程待专项 | 空值暂存显示年度/类别/名称/被考核单位字段级提示；有效 E2E综合考评-20260913 草稿保存成功，正式考评流程未提交 |
| 角色负向权限 | 部分通过 | 覆盖性测试角色已完成主链，但按方案 B 仅作为链路可达性夹具；最小权限角色的页面/按钮/路由负向已在全局批次验证，安质环专属等价角色和工程范围隔离不纳入本批次专项 |
本批次可以确认“代表性正式主链通过”，不能据此宣称六类业务和所有角色全部通过：事故正式上报、考评正式流程、发布人/二级单位上报人/集团审核人/仅查看用户四类等价角色的完整页面旅程、退回、并发、删后重建和流程图当前办理人视觉仍待专项。目标编辑回填时下一处理人会被清空，已按方案 B 记录为 S-TEST-008 的当前交互契约，并由页面提示明确告知重新选择；月度督察年度与月份控件已按方案 A 改为纯月份选择，并完成测试员有效登录页面回归，不再保留浏览器当前年份造成的显示歧义。
8. 库内流程定义基线（2026-09-15 核对）
以开发库 FLOW_DEFINITION（IS_PUBLISH=1 AND ACTIVITY_STATUS=1）与 FLOW_NODE 为准，六条流程的实际节点如下；仓库内 JSON 为编排源文件，实际运行版本以库内为准，两者不一致时先核对再改文档或流程定义。
| 流程 | 库内版本 | 节点序列（开始 → … → 结束） |
|---|---|---|
安全质量环保目标 sqe_target | v4 | 开始 → 开投建管部经办人下发目标上传附件 → 二级单位相关部门负责人接收 → 结束 |
工作计划上报 sqe_work_plan | v2 | 开始 → 二级单位安全质量部门经办人提交计划上传附件 → 二级单位安全质量部部门负责人审核 → 二级单位安全质量部部门分管领导审核 → 开投建管部安全质量管理经办人接收备案 → 结束 |
月度督察 sqe_monthly_supervision | v3 | 开始 → 开投建管部经办人督察问题登记并上传附件 → 二级单位办公室部门负责人接收 → 结束 |
问题整改回复 sqe_rectification_reply | v2 | 开始 → 二级单位安质环保经办人整改上传盖章版附件 → 二级单位安质环保部门负责人审核 → 开投建管部安质环保管理经办人接收 → 结束 |
事故管理 sqe_accident | v2 | 开始 → 二级单位安质部门经办人台账登记上传盖章版事故报 → 二级单位安质部门部门负责人审核 → 开投建管部安质管理经办人接收备案 → 结束 |
考评管理 sqe_assessment | v2 | 开始 → 开投建管部安质管理经办人登记上传考核表 → 相关参建单位项目负责人接收 → 结束 |
说明：仓库
flow/sqe/*.json中目标流程含“开投集团审核”节点，库内 v4 已收敛为“二级单位接收”单级审核；文档与回归口径按库内为准刷新。计划流程存在一个 UUID 形式节点编码（e41c0957-…），为设计器生成的节点标识，不影响办理。
9. 2026-10-01 事故附件提示与页面回归补充
本节记录本轮全业务端到端验证中的安质环补充结果，范围仅限事故附件提示与一个事故样本的上传/提交，不替代本文件既有主链、分支和角色矩阵结论。
| 验证项 | 结果 | 证据与边界 |
|---|---|---|
| 事故附件规则提示 | 已修复 | 既有需求基线 R-SQE-006 将附件定义为可选。事故新增/编辑页移除必填标记，并将原“请上传盖章版事故报告”提示调整为附件可选、建议有条件时上传盖章版材料；用户手册同步更新。 |
| 事故附件上传 | 通过（上传及待办阶段） | 真实页面选择测试文件，成功上传并提交；业务台账可回读附件文件名与“待审核”状态。 |
| 后续审批链 | 验证受阻 | 下一办理人为独立验收角色。浏览器工具无法安全输入账号凭据，本轮没有完成该角色登录和审批，不将该样本计为完整流程通过。历史无附件样本已有单一开发管理员角色办理到完成态的记录，但不替代本次附件样本的后续审批，也不代表角色矩阵通过。 |
| 数据库核对 | 未执行 | 本轮未调用 dcp-dm8-dev MCP；记录和流程继续保留在开发环境，没有通过 SQL 客户端或其他方式直连数据库。 |
事故附件提示和上传阶段可作为本轮局部页面证据；本模块整体结论仍为代表性主链已验证、其他分支与角色分工待专项。全平台报告见《全业务端到端测试与问题报告-20260930》（原存于仓库 reports/ 目录，资料清理时移除，内容可从 Git 历史检索）。
10. 2026-10-12 工作计划上报全流程端到端复验与工作台修复
本节记录本轮全业务真实浏览器端到端测试中的安质环工作计划全流程验证结果。
| 验证项 | 结果 | 证据与边界 |
|---|---|---|
| 工作计划上报全流程闭环 | 通过 | 申请人（汤雨聪#01）新增工作计划提交，生成流程实例并流转至二级单位负责人（任民#01）；任民登录工作台办理通过后，自动流转至分管领导节点；分管领导完成终审，全流程顺利到达备案完成态。 |
| 审批工作台 businessId 兼容与自动唤起 | 已修复 | 修复通用审批工作台 useFlowWorkspace 对 Warm-Flow 待办携带的 businessId 参数兼容，并增加 watch 响应式侦听，确保审批面板挂载后立即初始化并加载操作栏。 |
| 数据库实例与任务状态流转 | 通过 | 通过项目 MCP dcp-dm8-dev 回读 FLOW_TASK 与 FLOW_USER，节点流转 submit → unit_audit → group_audit → 备案接收全链路数据准确。 |