交开投数智建管平台

主题

工程安全管理 · 建渣管理 · 测试与验收文档 ​

文档版本：0.10 ｜ 最近核对日期：2026-09-15

进展说明：代码验证完成，代表性端到端主链路通过；边界修复定向回归已通过，测试账号已完成菜单、按钮、办理路由和工程树范围授权，新增台账两级审批完成且测试数据保留；二次审查补齐渣场引用生效校验与服务级回归、对齐两级驳回文档表述、新增消纳场启用/停用通道，并修复停用渣场直连引用与状态窄更新（详见 §8；停用/启用、下拉过滤、历史快照和流程详情页面专项复验通过）。

关联：需求分析、详细设计、数据库设计。完成表述仅覆盖下列已执行证据；导出专项仍单独记录，不扩大为未执行场景的验收结论。

1. 自动化回归 ​

项目命令/入口结果（2026-09-15）
后端 CZW 定向回归dev.ps1 -Command maven -ToolArgs @('-Dmaven.test.skip=false','-Dsurefire.failIfNoSpecifiedTests=false','-Dtest=CzwBusinessRulesTest,CzwSlagLedgerServiceImplTest,CzwDisposalSiteServiceImplTest,CzwControllerPermissionTest','-P','dev','-pl','digital-construction-modules/digital-construction-business','-am','test')2026-09-15 01:20，27/27 通过；覆盖规则、台账服务边界（含引用非生效/停用渣场拦截、已有停用渣场快照保留）、消纳场服务边界（草稿必填/引用完整性/仅草稿可删/本期更新容量校验/启用停用切换校验）、两个控制器权限契约
后端 business 全量回归dev.ps1 -Command maven -ToolArgs @('-Dmaven.test.skip=false','-Dsurefire.failIfNoSpecifiedTests=false','-P','dev','-pl','digital-construction-modules/digital-construction-business','-am','test')2026-09-15 01:21，121/121 通过；包含 CZW、sqe、工程手续、工程变更、招投标及既有业务测试
后端编译全量回归的 compile/testCompile 阶段通过；新增服务代码与测试源码编译通过
前端单测verify.ps1 -Check FrontendTest -TestPath 'src/views/business/czw/flowSteps.spec.ts'2026-09-15 01:27 页面修订后复核，1 个文件、5/5 通过
前端类型verify.ps1 -Check FrontendTypes2026-09-15 01:27 页面修订后复核通过（含 CZW 四个页面、API 类型与 termination 状态）
前端 Lintverify.ps1 -Check FrontendLint（oxlint src）2026-09-15 01:27 页面修订后复核通过，0 warning / 0 error
前端生产构建pnpm build（digital-construction-ui）2026-09-15 页面修订后构建成功，dist 产出并压缩，无错误
文档源码检查dev.ps1 pnpm --dir .\digital-construction-ui-docs docs:check2026-09-15 本轮最终检查，98 个文本文件、1349 个本地链接，0 问题
文档构建与产物扫描docs:build、docs:check:dist2026-09-15 本轮最终检查，VitePress 构建成功；320 个产物文本文件扫描，0 问题

回归覆盖点：证书 30 天临期边界、利用率 90% 满容阈值与停用优先级、跨月更新状态回落、剩余占比除零保护、湿渣阶段顺序拦截（缺预处理/顺序倒置）、仅草稿可删/可编辑含 back、剩余总量负数/超设计总量拦截、草稿期次复用、正式提交清理旧计划、消纳场草稿名称非空、处置计划引用非生效或新引用已停用渣场被拦截、已有停用渣场快照本期更新可保留、消纳场被计划引用不可删除、消纳场本期更新仅生效可改且容量边界校验、状态切换按旧状态条件窄更新、权限码三段式完整性。

2. 数据库与注册回读（dcp-dm8-dev） ​

本轮代码与文档修复未写入数据库，也未重新接入 dcp-dm8-dev；以下为既有回归证据，数据库设计文档已按交付规范把本轮未复核的默认值、约束和索引标为“待核对”。

  • 三表 DDL 执行后 user_tab_columns 回读列数 18/37/26 与设计一致；索引回读存在。
  • 字典 5 类型 12 值回读一致；811~842 段避让 sqe 已核对。
  • 菜单 20 行（2 目录+4 菜单+14 按钮）回读与权限码逐字一致。
  • 流程分类 2 行回读；流程定义导入后回读 czw_disposal_site/czw_slag_ledger version 1，发布后 is_publish=1。

3. 真实接口链路验收（开发库 + 运行中后端，2026-09-14） ​

超级管理员账号（凭据取自根 README，未回显）登录开发环境后端，32 项断言全部通过（CHAIN_ALL_PASS）：

  1. 流程定义查询/发布；
  2. 消纳场：新增草稿→提交（选监理）→待监理→监理通过（弹窗选业主）→待业主→业主通过→生效；证书有效派生；本期更新剩余容量后利用率 90% 满容派生；
  3. 渣土台账：湿渣仅最终消纳的提交被拦截（提示预处理）且草稿可删除；正常湿渣台账（预处理+最终消纳、电子渣票）新增→提交→两级审核→生效；当期处置计划 2 行回读；
  4. 本期更新：剩余总量/满足状态/问题三件套+计划覆盖当期快照，displayUpdateStatus=updated、currentPeriod=当月、期次计划接口回读 2 行；
  5. 统计卡：消纳场数量与电子渣票台账数含新增数据。

历史首轮失败残留数据（草稿/流程实例）已在本轮回归前处理；清理前页面验收阶段开发库曾回读 2 条渣土台账，该数字仅作为清理前快照。用户后续要求清理旧数据后，本轮新增的回归台账、流程实例和审批记录仍未删除，开发库当前保留 1 条本轮新增的已完成台账作为页面验收样例数据；后续页面和统计描述均以清理后的 1 条为准。

4. 页面验收（开发环境，2026-09-14；本轮专项复验 2026-09-15） ​

使用已有管理员账号登录开发环境，通过浏览器对以下场景进行了真实页面操作：

  1. 菜单"工程安全管理/建渣管理"下渣土管理页面打开，统计卡、列表、按钮和已有台账正常展示；
  2. 列表展开行显示当期 2 条处置计划；渣土类别、更新状态筛选及重置行为正常；
  3. 新增台账不再显示独立项目选择，线路直接来自工程结构树；选择“15号线一期”后，标段下拉展示 CQ15TJ01 等工程树节点，线路→标段级联恢复；
  4. 新增表单必填校验正常，处置计划、问题情况、审批等页签和流程图入口可打开；
  5. 已有台账详情可加载基础信息、处置计划和 3 个审批时间线节点；
  6. 已有生效台账本期更新可保存并刷新列表/统计，消纳场本期更新可触发 90%“满容”派生状态；测试期间临时修改的数值已恢复。
  7. 2026-09-15 02:00—02:04，重启并加载当前后端后完成页面专项复验：停用“接口验证消纳场”成功；新增台账处置计划的渣场下拉显示“无数据”；已有已完成台账的本期更新仍显示该历史渣场且选项置灰；启用恢复成功。随后重新打开该台账详情，基础信息、2026-09 期次处置计划、3 个审批时间线节点均正常，流程图弹窗显示“渣土管理 / 已完成”。

5. 代表性端到端主链路与授权回读 ​

  1. 已为业主测试账号分配开发环境回归角色，角色的可授权菜单、按钮权限全部勾选，数据范围为“全部数据权限”；人员快速授权页面再增加全部 10 个非公开线路根节点，公开线路按系统规则全员可见（2026-09-17 起取消运营公开，原“公开线路全员可见”不再适用，该入口改为「数据权限工作台 → 授权办理」，运营线路按授权可见）。重新登录后，测试账号可见完整业务菜单，能够进入“工程安全管理→建渣管理→渣土管理”，线路筛选可读到“15号线一期”等工程树线路。
  2. 已创建回归台账“15号线一期 / CQ15TJ01 / 工程树线路审批回归-20260914”，完成“工程树线路选择→新增保存→提交送监理审核→监理同意→选择业主办理人→业主同意”的真实页面链路。最终列表状态为“已完成”，业主“我的待办”为“暂无数据”，业主“我的已办”对应任务为“已完成 / 通过”；回归台账、流程实例和两级审批记录均保留在开发库。
  3. 清理旧数据前重新登录测试账号回读列表，统计为“渣土设计总量 90 万方 / 剩余渣土总量 14.0 万方”，共 2 条台账（清理前快照）；按用户要求清理后再次回读，当前统计为“渣土设计总量 2 万方 / 剩余渣土总量 1.5 万方”，共 1 条台账。本轮新增台账的线路、标段、施工范围、单位、数量和最终审批状态均可回读。

6. 页面专项待确认项 ​

  1. 早期页面验收时，某账号打开既有台账详情的“流程图”曾显示“暂无流程图”。本轮使用超级管理员在当前后端实例下重新打开保留台账，基础信息、处置计划、3 个审批时间线节点及流程图弹窗均正常；原账号历史现场仍未复现，因此不将其认定为代码缺陷，仍需由原账号结合 workflow:instance:query 权限和实例状态核对。
  2. 导出按钮已点击，但浏览器自动化未捕获可复核的下载事件，导出结果待页面下载核对，Agent 可按改动范围自行重试；不同角色权限和多历史期间切换未覆盖。
  3. 本轮仅在开发库为 E2E 测试账号授予全量回归权限，未建立或授权正式生产环境的监理、业主业务角色；上线前需由产品和权限管理员确定正式角色矩阵、最小权限及工程树数据范围，并另行完成真实角色验收。
  4. 二审新增的消纳场“启用/停用”切换按钮、停用渣场不再进入新处置计划下拉、已有台账历史快照保留且置灰的行为，已在 2026-09-15 02:00—02:04 通过超级管理员真实页面操作复验；复验后已恢复消纳场启用状态，未保存任何台账修改。

7. 开发库回归数据清理（2026-09-14） ​

  • 按用户要求清理此前旧建渣数据：旧台账 3 条、关联处置计划 12 条。
  • 清理旧流程实例 2099397127081357314 及其关联数据：当前任务 3 条、审批历史 4 条、办理人关联 3 条、业务扩展 1 条。
  • 本轮新增台账 2099414685952045058、有效处置计划 1 条、流程实例 2099414693958971393 及两级审批记录保留；清理后回读均为 DEL_FLAG=0、流程状态 finish。
  • 唯一消纳场因仍被本轮新增台账处置计划引用而保留，避免破坏新回归数据的引用完整性。
  • 清理后 MCP 回读：旧台账、旧处置计划、旧流程实例、旧任务、旧审批历史、旧办理人关联和旧业务扩展记录均为 0；渣土管理页面共 1 条台账。

8. 本轮审查修复记录 ​

审查项本轮处理证据/边界
P1-1 消纳场草稿名称服务端保存前显式校验 SITE_NAME，返回业务错误而不是数据库 500CzwDisposalSiteServiceImplTest；页面/数据库现场未在本轮重跑
P1-2 草稿新增与编辑口径草稿计划跳过阶段/渣场强校验，新增与编辑保持一致；消纳场名称仍满足物理非空CzwSlagLedgerServiceImplTest、CzwDisposalSiteServiceImplTest
P1-3 跨月幽灵期次草稿编辑复用已有最近期次；正式提交清理旧计划并写提交当月快照CzwBusinessRulesTest、台账服务提交回归；真实跨月页面场景待专项验证
P1-4 工程树失败阻断列表工程树、列表、统计并行隔离加载，工程树失败仅禁用线路/新增依赖并提示前端类型/Lint/构建通过；网络失败页面场景待专项验证（Agent 可按改动范围自行在浏览器执行）
P1-5 跨模块权限依赖在需求、概要、详细设计、数据库设计、操作手册中声明工程树与渣场下拉前置权限，页面补充可见错误提示正式监理/业主角色矩阵仍待产品与权限管理员确定
P1-6 渣场下拉永久缓存每次打开新增/编辑重新读取已生效渣场，失败清空并提示前端类型/Lint/构建通过；页面请求行为待专项验证（Agent 可按改动范围自行在浏览器执行）
P1-7 本期更新上限与确认台账/消纳场前后端均校验非负及不超过设计/总容量，边界允许；保存前二次确认后端规则、服务测试及前端构建通过；页面按钮交互待专项验证（Agent 可按改动范围自行在浏览器执行）
P1-8 期次切换竞态增加加载态、请求版本保护和失败提示，旧响应不得覆盖新期次前端类型/Lint/构建通过；快速切换页面行为待专项验证（Agent 可按改动范围自行在浏览器执行）
P1-9 自动化回归缺口增加 CZW 规则、服务边界、消纳场草稿和控制器权限契约测试本轮扩充后 CZW 定向 27/27、business 全量 121/121 通过（见 §1）
二审 P2-1 渣场引用生效校验服务端 fillSiteSnapshot 校验被引用消纳场 approvalStatus=finish，拦截绕过前端下拉直连挂草稿/未生效渣场；与前端 options() 仅返回生效渣场口径对齐CzwSlagLedgerServiceImplTest.submit_rejects_plan_referencing_non_finish_site；本轮定向 27/27 通过
二审 P2-2 两级驳回表述对齐修正 requirements/user-manual“任一环节驳回退回填报人”为“监理驳回退填报人、业主驳回退监理重审”，与流程 JSON（owner_audit REJECT→supervision_audit）、WorkflowGlobalListener 仅申请人节点驳回置 back、以及 sqe group_audit→unit_audit 路由一致已核对流程 JSON 与引擎驳回路由；纯文档表述修正，无代码改动
二审 P2-3 服务级回归扩充补齐消纳场引用完整性删除、仅草稿可删、本期更新（仅生效/容量边界）与台账非生效渣场拦截服务级用例CzwDisposalSiteServiceImplTest 10 例、CzwSlagLedgerServiceImplTest 7 例；本轮定向 27/27、全量 121/121 通过
二审 P3 文档口径修正修正 database-design CURRENT_PERIOD 生成口径（仅本期更新写入，提交只落计划子表期次）与 detailed-design 流程 JSON 路径前缀（补 digital-construction-modules/）纯文档修正，与代码一致
二审 P3 代码清理resolveSiteDisplayStatus 抽出原始值重载、消纳场 fillDerived 改调共享规则（消除死代码与重复逻辑）；前端 ApprovalStatus 补 termination；CzwBusinessRules 多余空格修正行为不变；CZW 定向 27/27、FrontendTypes 检查通过（2026-09-15）
二审 P2-1 消纳场停用通道与引用边界新增 PUT /business/czw/disposalSite/status（权限 czw:disposalSite:edit，仅 finish 可启用/停用）；options() 过滤停用渣场；服务端拒绝新引入的停用渣场，已有台账引用可保留名称/ID 快照；状态接口只更新 SITE_STATUS，并按旧状态做条件保护；前端列表增加启用/停用按钮，编辑/本期更新保留历史停用渣场但禁用为新选项（二次确认）CzwDisposalSiteServiceImplTest 10 例、CzwSlagLedgerServiceImplTest 7 例；定向 27/27、全量 121/121、FrontendTypes/Lint/构建通过；2026-09-15 页面专项复验：停用/启用成功、新建计划下拉过滤成功、历史快照显示并置灰

本轮结论：工程树线路来源问题已修复并通过真实页面验证；测试账号的菜单、按钮、办理路由和工程树范围授权已回读；新增台账已完成监理、业主两级审批，最终业务状态为“已完成”，待办已清空；旧建渣台账和旧流程实例已按要求清理，本轮新增测试数据继续保留。消纳场启用/停用、停用后新建计划下拉过滤、历史快照兼容、详情时间线和流程图已通过本轮页面专项复验；导出下载仍待页面下载核对，Agent 可按改动范围自行重试。

9. 2026-10-15 任民授权工点候选回归 ​

任民新增建渣台账页面的工程候选符合授权范围：选择27号线后可选测试工点“璧山站”，选择后自动显示“27号线授权回归测试标段”；切换15号线后显示授权的01/02标共11个工点，选择“九曲河东站”后对应标段为土建施工01标。新增表单已取消退出，台账行数未增加，未改工程授权。候选首载约等待8～9秒，候选加载完成后选点与标段回填正常。