主题
工程安全管理 · 建渣管理 · 概要设计文档
文档版本：0.11 ｜ 最近核对日期：2026-11-09
进展说明：概要设计已实现；边界修复已实现，代表性端到端主链路已验证，流程详情专项已复验、导出专项待确认；补充停用渣场引用边界。
1. 设计目标与边界
模块按工程节点（线路/标段）归集渣土台账，消纳场为全市主数据。业务单据保存审批状态与工程节点快照，流程实例由平台扩展关系 flow_instance_biz_ext 维护。台账与消纳场均为"固定表单保存草稿/编辑 + 流程工作台查看/办理"分离模式，复用开投安质环监管（sqe）已验证的固定表单 + Warm-Flow 工作台模式。
2. 模块分解
| 能力 | 职责 | 主表 |
|---|---|---|
| 消纳场主数据 | 渣场登记、容量与证书时效、审批、本期更新 | BIZ_CZW_DISPOSAL_SITE |
| 渣土台账 | 台账登记、两证附件、审批、统计口径 | BIZ_CZW_SLAG_LEDGER |
| 处置计划 | 阶段/渣场引用/执行数据，按期次快照 | BIZ_CZW_SLAG_LEDGER_PLAN |
3. 核心运行流程
节点编码：submit → supervision_audit → owner_audit，办理人变量均为 ${nextHandlerId}；监理节点办理弹窗选人注入业主节点办理人（assigneeMap → pass:owner_audit 变量），与平台 CompletePrepareComponent 的弹窗选人机制一致。
4. 状态与事件
| 状态/事件 | 行为 |
|---|---|
draft | 可编辑、可删除、可保存；提交时执行业务必填与湿渣阶段校验 |
waiting | 流程办理中，业务单据不可编辑 |
back | 退回填报人，可编辑并完成申请人节点后重提 |
finish | 生效；业务字段只读，仅本期更新通道可写执行类字段；不可删除 |
| 本期更新 | 自然月期间覆盖当期处置计划快照，更新状态置 updated，跨月自动回 unupdated；剩余总量必须满足 0 ≤ remainTotal ≤ designTotal |
| 流程事件 | CzwProcessEventListener 按 czw 前缀回写 approvalStatus 并记操作日志 |
5. 派生口径
- 证书时效：有效期早于当日=过期；到期前 30 天内=临期；其余有效（产生证/运渣证/渣场证统一）。
- 容量利用率=(总容量-剩余容量)/总容量；≥90% 派生满容；停用为手工状态，展示优先级最高。
- 新处置计划只可引用已生效且未停用的消纳场；服务端与下拉接口双重约束，已存在台账中的停用渣场引用保留 ID/名称快照，编辑或本期更新不得因停用而丢失该历史引用。
- 剩余占比=剩余总量/设计总量。
- 统计卡：设计/剩余总量为全部未删台账求和；消纳场数量为未删消纳场数；电子渣票口径为含电子渣票处置计划的台账去重数；逾期=已生效且剩余>0 且预计完成时间早于当日。
6. 与既有机制的关系
- 工程节点：线路/标段来自工程基础工程树（
biz_project_node），项目不再作为台账线路的前置筛选或级联条件；单据保存节点 ID+名称快照。线路选项取工程树中的LINE节点，默认隐藏运营线路（biz_status='2'）并提供「显示运营」开关（默认关闭，仅切换显示层、不构成拒绝，2026-09-18 起）；标段选项递归收集所选线路下的BID节点，因此标段挂在包段（PACKAGE）等中间节点下时也不会漏项。 - 处置计划期次：草稿首次保存使用当前自然月，后续草稿编辑沿用已有最近期次；正式提交清理该台账旧计划行并写入提交当月正式快照，避免跨月编辑留下幽灵期次。
- 页面依赖：台账页读取工程树需要
business:projectNode:query、business:projectNode:list或business:siteMaster:list任一权限；处置计划渣场下拉需要czw:disposalSite:list。工程树失败不阻断列表与统计，渣场下拉失败给出可见错误并允许重试。 - 附件：复用
FileUpload+SYS_OSS，业务表 CLOB 存{name,url,ossId}列表。 - 字典：
czw_site_type、czw_waste_category、czw_ticket_type、czw_satisfy_status、czw_disposal_stage。 - 流程分类：
FLOW_CATEGORY新增“工程安全监管/建渣管理”（2110000000000000900/901）。
工程数据授权：渣土主台账是标段工点专属资源，服务端按同一条有效 (LINE_ID, BID_ID, SITE_ID) 授权组合或整线授权校验；独立标段/工点 ID 不能交叉拼接放行。消纳场档案属于公共主数据，不按工程范围过滤。共享授权模型与有效组合定义见工程基础概要设计 §4.1。