Skip to content

工程安全管理 · 建渣管理 · 数据库设计文档 ​

字段中文含义参考 2026-11-02 开发库、生产库只读回读的字段注释及原有业务资料;历史物理结构、核验日期和设计差异仍以各表原记录为准。

文档版本:0.10 | 最近核对日期:2026-09-15

进展说明:全量字段矩阵已补齐;列数、实体映射与已知索引沿用 2026-09-14 项目 MCP dcp-dm8-dev 回读记录,默认值/约束/其余索引本轮未重新接入数据库复核;审查修正 CURRENT_PERIOD 生成口径(仅本期更新写入,提交只落计划子表期次)与 SITE_STATUS 生成口径(生效经 /status 切换);无结构变更。

证据边界:本文件区分“已按历史 MCP 记录核对”和“待本轮复核”,不把设计推断写成数据库现场事实。表名与字段来源为实体 CzwDisposalSite、CzwSlagLedger、CzwSlagLedgerPlan 的 @TableName/属性,以及上述数据库回读记录。

1. 表清单 ​

表用途实际列数设计/实际口径
BIZ_CZW_DISPOSAL_SITE消纳场(渣场主数据)18设计字段与历史 MCP user_tab_columns 回读一致;本轮未复读
BIZ_CZW_SLAG_LEDGER渣土台账37设计字段与历史 MCP user_tab_columns 回读一致;本轮未复读
BIZ_CZW_SLAG_LEDGER_PLAN处置计划(按期次快照)26设计字段与历史 MCP user_tab_columns 回读一致;本轮未复读

三表均继承公共审计字段 CREATE_DEPT/CREATE_BY/CREATE_TIME/UPDATE_BY/UPDATE_TIME,并含 DEL_FLAG 逻辑删除字段;实体主键为 ID,由平台雪花 ASSIGN_ID 生成。DEL_FLAG 的默认值和非空性、计划表索引 IDX_CZW_PLAN_LEDGER_PERIOD 沿用历史 DDL/MCP 记录;其余数据库约束与索引需要后续通过 dcp-dm8-dev 现场复核。

矩阵列说明:

  • “逻辑类型”描述实体/接口中的业务类型;“物理类型”和“长度/精度”描述数据库设计值。
  • “主键/外键/唯一性”记录业务逻辑关系与当前已知的物理约束,未被 MCP 回读确认的内容明确标为“待核对”。
  • “核验状态”中的“历史 MCP 记录”不是本轮现场复核结论;后续若结构变化,应先更新数据库证据再更新本表。

2. BIZ_CZW_DISPOSAL_SITE 字段矩阵 ​

字段名业务含义逻辑类型物理类型长度/精度可空性默认值主键/外键/唯一性索引来源/生成规则核验状态
ID消纳场主键LongBIGINT—N无PK;物理约束待复核PK 索引待复核平台 ASSIGN_ID 雪花 ID历史 MCP 记录确认列存在;本轮未复读
SITE_NAME渣场名称/消纳证名称StringVARCHAR200N无非空;唯一性待核对待核对表单录入;草稿也必须满足物理非空历史 MCP 记录确认列存在;非空依据既有 DDL 记录
SITE_TYPE场所类型StringVARCHAR32Y无字典 czw_site_type 逻辑引用;物理外键待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
MANAGE_UNIT管理单位StringVARCHAR200Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
DISTRICT所在辖区StringVARCHAR50Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
ADDRESS详细地址StringVARCHAR500Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
TOTAL_CAPACITY总容量(万方)BigDecimalNUMBER14,2Y无业务上应不小于 0;物理约束待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
REMAIN_CAPACITY剩余容量(万方)BigDecimalNUMBER14,2Y无业务上 0 ≤ remain ≤ total;物理约束待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
CERT_NO渣场证编号StringVARCHAR64Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
CERT_VALID_TO渣场证有效期至LocalDateDATE—Y无无;待核对待核对表单录入;证书状态由有效期派生历史 MCP 记录确认列存在;本轮未复读
SITE_STATUS启用/停用状态StringVARCHAR16Y无字典/状态值逻辑约束;待核对待核对草稿/退回经编辑表单,生效经 /status 切换接口;满容为派生展示,不落地覆盖历史 MCP 记录确认列存在;本轮未复读
APPROVAL_STATUS工作流业务状态StringVARCHAR32Y无wf_business_status 逻辑约束;物理约束待核对待核对流程事件监听器回写 draft/waiting/back/finish历史 MCP 记录确认列存在;取值待数据库复核
CREATE_DEPT创建部门LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
CREATE_BY创建人LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
CREATE_TIME创建时间LocalDateTimeTIMESTAMP—Y无无;待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
UPDATE_BY更新人LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
UPDATE_TIME更新时间LocalDateTimeTIMESTAMP—Y无无;待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
DEL_FLAG逻辑删除标记StringCHAR1N'0'逻辑删除字段;物理默认/非空沿用历史 DDL 记录待核对@TableLogic;0 未删历史 DDL/MCP 记录确认;本轮未复读

3. BIZ_CZW_SLAG_LEDGER 字段矩阵 ​

字段名业务含义逻辑类型物理类型长度/精度可空性默认值主键/外键/唯一性索引来源/生成规则核验状态
ID渣土台账主键LongBIGINT—N无PK;物理约束待复核PK 索引待复核平台 ASSIGN_ID 雪花 ID已核对(实库)
LINE_ID所属线路 IDLongBIGINT—Y无关联 BIZ_LINE.LINE_ID待核对线路外键已核对(实库)
BID_ID所属标段 IDLongBIGINT—Y无关联 BIZ_BID_SECTION.BID_ID待核对标段外键已核对(实库)
SITE_ID所属工点 IDLongBIGINT—Y无关联 BIZ_SITE_MASTER.SITE_MASTER_ID待核对工点外键已核对(实库)
LINE_NODE_NAME线路名称快照StringVARCHAR200Y无线路名称快照;待核对待核对节点名称快照已核对(实库)
LINE_NODE_PATH线路路径快照StringVARCHAR500Y无路径快照;待核对待核对路径扩展字段;当前页面不写入已核对(实库)
BID_NODE_NAME标段名称快照StringVARCHAR200Y无标段名称快照;待核对待核对节点名称快照已核对(实库)
BID_NODE_PATH标段路径快照StringVARCHAR500Y无路径快照;待核对待核对路径扩展字段;当前页面不写入已核对(实库)
CONSTRUCTION_SCOPE施工范围StringVARCHAR500Y无无;待核对待核对工程树/表单文本历史 MCP 记录确认列存在;本轮未复读
CONSTRUCTION_UNIT施工单位StringVARCHAR200Y无无;待核对待核对表单文本;提交时必填历史 MCP 记录确认列存在;本轮未复读
CONSTRUCTION_CONTACT施工联系人StringVARCHAR50Y无无;待核对待核对表单文本历史 MCP 记录确认列存在;本轮未复读
CONSTRUCTION_PHONE施工联系电话StringVARCHAR32Y无无;待核对待核对表单文本历史 MCP 记录确认列存在;本轮未复读
PRODUCE_CERT_NO渣土产生证号StringVARCHAR64Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
PRODUCE_CERT_VALID_TO产生证有效期至LocalDateDATE—Y无无;待核对待核对表单录入;状态按 30 天阈值派生历史 MCP 记录确认列存在;本轮未复读
PRODUCE_CERT_ATTACHMENT产生证附件JSON 字符串CLOB—Y无无;待核对待核对FileUpload 生成 {name,url,ossId} 列表历史 MCP 记录确认列存在;本轮未复读
TRANSPORT_UNIT运输单位StringVARCHAR200Y无无;待核对待核对表单文本;当前结构不含运输联系人/电话字段历史 MCP 记录确认列存在;本轮未复读
TRANSPORT_CERT_NO运渣证号StringVARCHAR64Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
TRANSPORT_CERT_VALID_TO运渣证有效期至LocalDateDATE—Y无无;待核对待核对表单录入;状态按 30 天阈值派生历史 MCP 记录确认列存在;本轮未复读
TRANSPORT_CERT_ATTACHMENT运渣证附件JSON 字符串CLOB—Y无无;待核对待核对FileUpload 生成 {name,url,ossId} 列表历史 MCP 记录确认列存在;本轮未复读
WASTE_CATEGORY渣土类别StringVARCHAR32Y无字典 czw_waste_category 逻辑引用;待核对待核对表单录入;提交时参与湿渣阶段校验历史 MCP 记录确认列存在;本轮未复读
EXPECT_FINISH_DATE预计完成时间LocalDateDATE—Y无无;待核对待核对表单录入;逾期统计来源历史 MCP 记录确认列存在;本轮未复读
DESIGN_TOTAL设计总量(万方)BigDecimalNUMBER14,2Y无与 REMAIN_TOTAL 业务校验;物理约束待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
REMAIN_TOTAL剩余总量(万方)BigDecimalNUMBER14,2Y无提交/本期更新要求 0 ≤ remain ≤ design;物理约束待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
SATISFY_STATUS是否满足施工生产需求StringVARCHAR32Y无字典 czw_satisfy_status 逻辑引用;待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
PROBLEM_DESC问题描述StringVARCHAR2000Y无无;待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
SUGGESTION建议意见StringVARCHAR2000Y无无;待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
OTHER_DESC其他说明StringVARCHAR2000Y无无;待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
APPROVAL_STATUS工作流业务状态StringVARCHAR32Y无wf_business_status 逻辑约束;待核对待核对流程事件监听器回写历史 MCP 记录确认列存在;取值待数据库复核
UPDATE_STATUS本期更新状态StringVARCHAR16Y无updated/unupdated 逻辑值;待核对待核对本期更新写 updated,跨月展示派生为 unupdated历史 MCP 记录确认列存在;本轮未复读
CURRENT_PERIOD最近本期更新期次StringVARCHAR7Y无YYYY-MM 逻辑格式;待核对待核对仅本期更新写入当月;正式提交不写台账本列,提交当月只落计划子表 PERIOD历史 MCP 记录确认列存在;本轮未复读
REPORTER_ID填报人快照 IDLongBIGINT—Y无逻辑用户关联;物理外键待核对待核对登录用户快照;审批/更新保护既有值历史 MCP 记录确认列存在;本轮未复读
REPORTER_NAME填报人快照名称StringVARCHAR100Y无与 REPORTER_ID 成对快照;待核对待核对登录用户昵称快照历史 MCP 记录确认列存在;本轮未复读
CREATE_DEPT创建部门LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
CREATE_BY创建人LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
CREATE_TIME创建时间LocalDateTimeTIMESTAMP—Y无无;待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
UPDATE_BY更新人LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
UPDATE_TIME更新时间LocalDateTimeTIMESTAMP—Y无无;待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
DEL_FLAG逻辑删除标记StringCHAR1N'0'逻辑删除字段;物理默认/非空沿用历史 DDL 记录待核对@TableLogic;0 未删历史 DDL/MCP 记录确认;本轮未复读

4. BIZ_CZW_SLAG_LEDGER_PLAN 字段矩阵 ​

字段名业务含义逻辑类型物理类型长度/精度可空性默认值主键/外键/唯一性索引来源/生成规则核验状态
ID处置计划主键LongBIGINT—N无PK;物理约束待复核PK 索引待核对平台 ASSIGN_ID 雪花 ID历史 MCP 记录确认列存在;本轮未复读
LEDGER_ID所属渣土台账 IDLongBIGINT—N无逻辑关联 BIZ_CZW_SLAG_LEDGER.ID;物理 FK 待核对IDX_CZW_PLAN_LEDGER_PERIOD 前导列保存计划时由台账 ID 写入历史 MCP 记录确认列存在;索引沿用历史回读
PERIOD计划期次StringVARCHAR7N无YYYY-MM 逻辑格式;待核对IDX_CZW_PLAN_LEDGER_PERIOD 联合列草稿沿用已有期次;正式提交写提交当月历史 MCP 记录确认列存在;索引沿用历史回读
ORDER_NUM处置顺序IntegerINT—Y无无;待核对待核对表单顺序;空值按序号兜底历史 MCP 记录确认列存在;本轮未复读
STAGE处置阶段StringVARCHAR32Y无字典 czw_disposal_stage 逻辑引用;待核对待核对表单录入;提交时阶段强校验历史 MCP 记录确认列存在;本轮未复读
SITE_ID引用消纳场 IDLongBIGINT—Y无逻辑关联 BIZ_CZW_DISPOSAL_SITE.ID;物理 FK 待核对待核对生效渣场下拉选择历史 MCP 记录确认列存在;本轮未复读
SITE_NAME消纳场名称快照StringVARCHAR200Y无与 SITE_ID 成对快照;待核对待核对保存计划时从消纳场回填历史 MCP 记录确认列存在;本轮未复读
DISPOSAL_METHOD处置方式StringVARCHAR100Y无无;待核对待核对表单录入历史 MCP 记录确认列存在;本轮未复读
PLAN_QUANTITY计划量(万方)BigDecimalNUMBER14,2Y无业务范围待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
TICKET_TYPE渣票类型StringVARCHAR32Y无字典 czw_ticket_type 逻辑引用;待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
ELECTRONIC_TICKET_RATE电子渣票率BigDecimalNUMBER5,2Y无百分比范围待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
TRADITIONAL_TRUCK_COUNT传统渣车辆数IntegerINT—Y无非负业务规则待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
ECO_TRUCK_COUNT新型环保渣车辆数IntegerINT—Y无非负业务规则待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
ELECTRONIC_TRUCK_RATE电子渣车率BigDecimalNUMBER5,2Y无百分比范围待核对待核对表单录入/本期更新历史 MCP 记录确认列存在;本轮未复读
SITE_REMAIN_CAPACITY渣场剩余容量快照BigDecimalNUMBER14,2Y无与渣场容量逻辑关联;物理约束待核对待核对计划保存/本期更新时快照历史 MCP 记录确认列存在;本轮未复读
PROBLEM_DESC行级问题描述StringVARCHAR1000Y无无;待核对待核对计划行录入/本期更新历史 MCP 记录确认列存在;本轮未复读
SUGGESTION行级建议意见StringVARCHAR1000Y无无;待核对待核对计划行录入/本期更新历史 MCP 记录确认列存在;本轮未复读
OTHER_DESC行级其他说明StringVARCHAR1000Y无无;待核对待核对计划行录入/本期更新历史 MCP 记录确认列存在;本轮未复读
REPORTER_ID该期填报人/更新人 IDLongBIGINT—Y无逻辑用户关联;物理 FK 待核对待核对正式提交/本期更新快照登录用户历史 MCP 记录确认列存在;本轮未复读
REPORTER_NAME该期填报人/更新人名称StringVARCHAR100Y无与 REPORTER_ID 成对快照;待核对待核对正式提交/本期更新快照昵称历史 MCP 记录确认列存在;本轮未复读
CREATE_DEPT创建部门LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
CREATE_BY创建人LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
CREATE_TIME创建时间LocalDateTimeTIMESTAMP—Y无无;待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
UPDATE_BY更新人LongBIGINT—Y无逻辑审计关联;物理外键待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
UPDATE_TIME更新时间LocalDateTimeTIMESTAMP—Y无无;待核对待核对BaseEntity/平台审计字段设计与实体来源;物理类型本轮待复核
DEL_FLAG逻辑删除标记StringCHAR1N'0'逻辑删除字段;物理默认/非空沿用历史 DDL 记录待核对@TableLogic;0 未删历史 DDL/MCP 记录确认;本轮未复读

5. 字典 ​

类型值
czw_site_typedisposal 消纳场 / center 处置中心
czw_waste_categorydry 干渣 / wet 湿渣 / shield 盾构渣
czw_ticket_typeelectronic 电子 / normal 普通
czw_satisfy_statussatisfied 满足 / basically 基本满足 / unsatisfied 不满足
czw_disposal_stagepretreatment 预处理处置 / final 最终消纳

字典类型及数据 ID 沿用历史 MCP 回读记录;本轮未接入数据库,因此实际字典行仍应以 dcp-dm8-dev 复核为准。

6. 菜单与权限 ​

MENU_ID名称类型PATH / PERMS
2110000000000000700工程安全管理Mczw
2110000000000000705建渣管理Mwaste
2110000000000000710消纳场管理CdisposalSite / czw:disposalSite:list
2110000000000000711消纳场管理办理C(隐藏)disposalSite/flowForm
2110000000000000720渣土管理CslagLedger / czw:slagLedger:list
2110000000000000721渣土管理办理C(隐藏)slagLedger/flowForm
2110000000000005711~5717消纳场按钮Fquery/add/edit/remove/export/submit/update
2110000000000005721~5727渣土台账按钮Fquery/add/edit/remove/export/submit/update

工程树线路读取是台账页面的跨模块前置依赖:角色还需具备 business:projectNode:query、business:projectNode:list 或 business:siteMaster:list 任一权限;处置计划渣场下拉需要 czw:disposalSite:list。上述权限实际授权关系仍需以角色菜单回读为准,不能只看页面按钮是否隐藏。

7. 流程注册 ​

  • FLOW_CATEGORY:2110000000000000900 工程安全监管(工作流分类根节点,独立于导航父菜单)→ 2110000000000000901 建渣管理。
  • FLOW_DEFINITION:czw_disposal_site、czw_slag_ledger,version 1,is_publish=1;流程实例、任务、审批历史与业务扩展数据不属于本文件三张业务表,清理或核对时应分别按工作流表回读。