交开投数智建管平台

主题

工程安全管理 · 建渣管理 · 需求分析文档 ​

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

进展说明：需求已落实；边界修复已实现，代表性端到端主链路已验证，流程详情专项已复验、导出专项待确认；审查修正两级驳回路由表述，并补充停用渣场引用边界。

本文是建渣管理模块六类交付文档中的需求分析文件；概要设计、详细设计、数据库设计、测试与验收、操作手册见本目录其余文件。

1. 建设背景与目标 ​

建渣管理归集轨道交通工程渣土产生、运输、处置消纳全过程台账，以及全市消纳场（渣场）主数据，经"填报人提交 → 监理审核 → 业主审核"固定审批链生效后按月更新执行数据，支撑剩余渣量、消纳场容量与逾期告警统计。原型来源：桌面低保真原型图三张（渣土管理、消纳场管理、审批页面）。

建设目标：

  • 消纳场作为主数据先登记、后引用，台账处置计划从已登记渣场下拉选择，不重复手抄；
  • 渣土台账以"基础信息 + 处置计划 + 问题情况 + 审批"四页签单据维护，处置计划按期次留快照；
  • 审批链固定两级审核；监理驳回退回填报人重提，业主驳回退回监理审核重审（同 sqe 两级驳回路由，均原实例办理）；
  • 生效后业务字段冻结，仅"本期更新"通道变更执行类字段，保存即生效、不走审批；
  • 统计卡提供设计总量、剩余总量及占比、消纳场数量（含电子渣票口径）、逾期告警。

2. 建设范围 ​

2.1 本期包含 ​

  1. 消纳场管理：登记/编辑/审批/本期更新（剩余容量）/启停/导出；
  2. 渣土管理：台账新增/编辑/审批/本期更新/导出，列表展开行展示当期处置计划；
  3. 两张流程工作台（查看/办理），复用平台固定表单流程模式；
  4. 统计卡四项及涉及线路/标段副文案；
  5. 菜单（工程安全管理/建渣管理/两台账+两办理）、czw 前缀三段式权限、五个业务字典、流程分类与两条流程定义。

2.2 明确不做 ​

  • 监测管理、安全管控平台对接（功能清单 12 月批次）；
  • 电子渣票/渣车外部系统对接，比率字段手工填报；
  • 转办、委派、加签、减签、抄送等平台流程能力不复制到业务页面；
  • 渣土台账严格纳入统一工程数据授权：专属台账须命中当前用户同一线路下有效的标段×工点组合，或该线路整线授权；列表、详情与写操作按同一有效性校验。消纳场档案为全市公共主数据，不按工程数据范围过滤。

3. 角色与使用场景 ​

角色使用目的主要结果
填报人（标段/施工单位人员）登记消纳场、新增台账草稿、提交、驳回重提、本期更新单据进入审批或完成当期更新
监理审核人审核消纳场与台账，通过时选择业主审核人任务办理并流转
业主审核人终审通过后单据生效
查看人员查询、展开明细、导出只读

4. 核心业务场景与流程 ​

  • 填报顺序：先消纳场管理登记渣场（名称/类型/管理单位/容量/状态）→ 再新增台账，处置计划引用已登记渣场。
  • 审批链：填报人提交（选监理审核人）→ 监理审核（通过时选业主审核人）→ 业主审核 → 生效；监理驳回退回填报人、原实例重提，业主驳回退回监理审核重审（同 sqe，均原实例办理，不新起实例）。
  • 本期更新：自然月期间（YYYY-MM），覆盖当期处置计划快照与问题情况，保存即生效；同一期间重复更新覆盖当期；跨月后更新状态自动回到“未更新”。
  • 处置计划阶段顺序：① 预处理处置 → ② 最终消纳；湿渣（盾构渣）提交时强制校验必须先预处理，草稿不校验。
  • 消纳场引用：新处置计划只能引用已生效且未停用的消纳场；服务端同步拦截绕过下拉接口的停用渣场新引用。台账历史计划已经引用的停用渣场保留名称与 ID 快照，本期更新继续保留该既有引用，不因主数据停用破坏历史台账。
  • 草稿期次：草稿首次保存按当前自然月落期；后续跨月编辑沿用该台账已有的最近期次，不新建无业务含义的幽灵期次；正式提交时清理该台账历史草稿计划行，仅写入提交当月的正式快照。
  • 剩余总量：本期更新和正式提交均要求剩余总量不小于 0 且不大于设计总量，等于设计总量允许保存。
  • 删除规则：仅草稿可删；消纳场被处置计划引用后不可删除。

5. 用户确认口径（2026-09-14 逐条对焦；第 7 条页面验证口径已更新） ​

  1. 本期更新不走审批，保存即生效；
  2. 证书（产生证/运渣证/渣场证）临期阈值统一到期前 30 天；
  3. 消纳场满容由容量利用率 ≥90% 自动派生，启用/停用手工切换；
  4. 统计卡电子渣票口径＝含电子渣票处置计划的台账数；
  5. 逾期告警口径＝已生效且剩余总量>0 且已过预计完成时间的台账数；
  6. 权限码模块段 czw；
  7. 页面验证由 Agent 按改动范围自行在浏览器执行，用户要求亲自查看的部分保留待验收（2026-09-14 的“由用户验证并回传、未授权浏览器端到端”口径已废止）；
  8. 历史期次按处置计划子表期次快照行留痕；
  9. 删除规则仅草稿可删；
  10. 湿渣先预处理规则提交时强制校验；
  11. 本期更新期间＝自然月，同期间重复更新覆盖；
  12. 审核人来源：提交选监理、监理通过选业主（办理弹窗选人）；
  13. 台账线路以工程结构树为唯一来源，项目不作为线路的前置筛选或级联条件；标段从所选线路下递归取得。线路下拉（查询区与新增表单共用同一份选项）默认隐藏运营线路并提供「显示运营」开关（默认关闭，仅切换显示层、不构成拒绝，2026-09-18 起）。
  14. 剩余总量边界：本期更新及提交时 0 ≤ remainTotal ≤ designTotal，等于设计总量允许；超出上限或为负数时拒绝保存。
  15. 跨月草稿处理：草稿编辑沿用已有最近期次；正式提交清理该台账旧计划行并以提交当月写入最终处置计划快照，避免产生幽灵期次。
  16. 停用渣场处理：新计划引用停用渣场时前后端均拒绝；已有台账计划中的停用渣场作为历史快照继续展示和保存，编辑时不可将其作为新选项使用。

6. 剩余假设（未单独确认，依据原型/既有模式） ​

  1. "是否满足施工生产需求"取值：满足/基本满足/不满足；
  2. 渣土类别：干渣/湿渣/盾构渣；
  3. 施工单位为文本录入并保留联系人、电话；运输单位为文本录入，当前表结构仅保存运输单位及运渣证信息，不单独保存运输联系人/电话；均不挂组织主数据；
  4. 列表“施工单位/施工范围”筛选为文本模糊查询。

7. 验收标准 ​

  1. 消纳场登记→审批生效→台账处置计划可选，全链路真实数据贯通；
  2. 台账提交→监理通过→业主通过后生效，驳回可重提；
  3. 生效后本期更新写入当期快照，历史期次可切换查看，更新状态正确；
  4. 统计卡数值与列表口径一致；证书临期/过期、满容派生展示正确；
  5. 无权限角色接口 403；只读角色仅查询/导出；
  6. 湿渣未经预处理的处置计划提交被拦截。
  7. 本期更新和提交拒绝负数或超过设计总量的剩余总量，边界值 0 与设计总量可保存。
  8. 草稿跨月编辑不产生幽灵期次，正式提交后仅保留提交当月的计划快照。
  9. 工程树或生效渣场下拉接口失败时，页面提示具体依赖失败，列表/统计仍可独立加载。
  10. 停用渣场不出现在新处置计划下拉中；绕过前端直连接口新增停用渣场引用被服务端拒绝；已有引用的台账仍能保留其渣场快照。

接口、数据库、自动化回归和页面证据见 测试与验收；本轮主链路和流程详情已验证，导出下载仍按专项待确认项记录。

页面前置权限：渣土台账页除 czw:slagLedger:* 外，还需要工程树接口的 business:projectNode:query、business:projectNode:list 或 business:siteMaster:list 任一权限，以及处置计划渣场下拉的 czw:disposalSite:list；依赖缺失时页面应提示无权或加载失败，不应静默展示为空。