主题
造价单位管理 · 数据库设计文档
文档版本：0.10 ｜ 最近核对日期：—
字段中文含义参考 2026-11-02 开发库、生产库只读回读的字段注释及原有业务资料；历史物理结构、核验日期和设计差异仍以各表原记录为准。
1. 设计范围与核验状态
| 项目 | 内容 |
|---|---|
| 模块名称 | 造价单位管理 |
| 设计数据库 | 逻辑类型按平台可迁移设计；当前物理数据库为开发 DM8 |
| 数据库交付基线 | 当前工作区开发库变更，无正式发布基线 |
| 实体/Mapper 来源 | Java 包 digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit 及对应各资源 mapper |
| MCP 结构核验 | 2026-09-26；项目 MCP dcp-dm8-dev；只读回查 dm_describe_table、ALL_TAB_COLUMNS、ALL_IND_COLUMNS |
| 数据库核验状态 | 9 张业务表、134 列及业务索引已按开发库回读 |
下列 134 个字段逐项对应九张实际业务表。矩阵中的物理类型、长度/精度、可空及默认值来自 2026-09-26 dcp-dm8-dev MCP 结构回读；字段来源与含义按本模块实体及需求核对。
2. 实体关系
text
BIZ_COST_UNIT 1 ── N BIZ_COST_UNIT_CHANGE
BIZ_COST_UNIT_CHANGE 1 ── N BIZ_COST_UNIT_CHANGE_DETAIL
BIZ_COST_UNIT_CHANGE 1 ── N BIZ_COST_UNIT_CHANGE_ATTACHMENT
BIZ_COST_UNIT 1 ── N BIZ_COST_UNIT_VIOLATION
BIZ_COST_UNIT 1 ── N BIZ_COST_UNIT_QUARTER_ASSESS
BIZ_COST_UNIT 1 ── N BIZ_COST_UNIT_ANNUAL_ASSESS
BIZ_COST_UNIT 1 ── N BIZ_COST_UNIT_DRAW_APPLICATION
BIZ_COST_UNIT 1 ── N BIZ_COST_UNIT_AWARD_RESULT上述子表外键为逻辑关联；开发库未建物理 FK。服务端负责校验单位、修改事件与 OSS 引用。九张表均无租户列及流程实例列；流程实例与业务单据通过 Warm-Flow 业务主键关联。
3. 全量字段矩阵
以下矩阵每字段的核验状态均为「已按实际库核对」；核验证据为本文件 §1 的 MCP 字段查询，主键及普通索引证据见 §4。逻辑类型按平台常用类型表达；DM8 特有物理类型不得视为跨库 DDL 承诺。
3.1 BIZ_COST_UNIT（造价单位主表（单位字段、暂停窗口、出库状态及平台审计））
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/unit/domain/CostUnit.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556349 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | UNIT_NAME | 单位名称 | VARCHAR | VARCHAR(255) | 否 | — | 活动名称唯一索引 UK_BIZ_CU_ACTIVE_NAME | R-CU-002/造价单位字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | CONTACT_PHONE | 联系人电话 | VARCHAR | VARCHAR(64) | 是 | — | — | R-CU-002/造价单位字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | LANDLINE_PHONE | 座机 | VARCHAR | VARCHAR(64) | 是 | — | — | R-CU-002/造价单位字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | COMPANY_NATURE | 公司性质字典编码 | VARCHAR | VARCHAR(32) | 否 | — | — | 公司性质字典；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | UNIT_GRADE | 单位档次字典编码 | VARCHAR | VARCHAR(16) | 否 | — | — | 单位档次字典；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | PAUSE_START_TIME | 暂停开始时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | 暂停管理动作；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | PAUSE_END_TIME | 暂停截止时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | 暂停管理动作；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | IS_OUTBOUND | 是否出库标记 | CHAR | CHAR(1) | 否 | 'N' | — | 出库管理动作；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | OUTBOUND_REASON | 出库原因 | VARCHAR | VARCHAR(2000) | 是 | — | — | 出库管理动作；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | OUTBOUND_TIME | 出库时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | 出库管理动作；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 12 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 13 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 14 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 15 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 16 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 17 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.2 BIZ_COST_UNIT_CHANGE（基本信息修改事件主表）
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/unit/domain/CostUnitChange.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 事件主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556367 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | COST_UNIT_ID | 被修改的造价单位 ID | BIGINT | BIGINT | 否 | — | IDX_BIZ_COST_UNIT_CHANGE_UNIT 第1列 | R-CU-007/单位逻辑引用；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | OPERATOR_ID | 操作人 ID | BIGINT | BIGINT | 是 | — | — | 当前登录用户快照；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | OPERATOR_NAME | 操作人名称 | VARCHAR | VARCHAR(100) | 是 | — | — | 当前登录用户快照；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | OPERATED_AT | 操作时间 | TIMESTAMP | TIMESTAMP(6) | 否 | — | IDX_BIZ_COST_UNIT_CHANGE_UNIT 第2列 | 修改事件生成时间；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.3 BIZ_COST_UNIT_CHANGE_DETAIL（修改事件字段差异明细）
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/unit/domain/CostUnitChangeDetail.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 字段差异主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556369 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | CHANGE_ID | 修改事件 ID | BIGINT | BIGINT | 否 | — | IDX_BIZ_COST_UNIT_CHANGE_DETAIL_CHANGE | 事件逻辑引用；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | FIELD_NAME | 字段英文名 | VARCHAR | VARCHAR(100) | 否 | — | — | CostUnit 属性名；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | FIELD_LABEL | 字段显示名 | VARCHAR | VARCHAR(100) | 是 | — | — | 字段显示标签；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | OLD_VALUE | 变更前值 | VARCHAR | VARCHAR(2000) | 是 | — | — | 保存时从主表读取；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | NEW_VALUE | 变更后值 | VARCHAR | VARCHAR(2000) | 是 | — | — | 由修改请求生成；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 12 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.4 BIZ_COST_UNIT_CHANGE_ATTACHMENT（修改事件的平台附件引用子表）
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/unit/domain/CostUnitChangeAttachment.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 附件引用主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556353 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | CHANGE_ID | 修改事件 ID | BIGINT | BIGINT | 否 | — | IDX_BIZ_COST_UNIT_CHANGE_ATTACHMENT 第1列 | 事件逻辑引用；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | OSS_ID | 平台文件 ID | BIGINT | BIGINT | 否 | — | — | OssService 校验的 SYS_OSS 标识；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | FILE_NAME | 文件名称快照 | VARCHAR | VARCHAR(500) | 是 | — | — | SYS_OSS 元数据；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | FILE_SIZE | 文件大小快照 | BIGINT | BIGINT | 是 | — | — | SYS_OSS 元数据，字节；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | FILE_TYPE | 文件类型快照 | VARCHAR | VARCHAR(64) | 是 | — | — | SYS_OSS 元数据；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | SORT_NO | 附件顺序 | INT | INT | 是 | 0 | IDX_BIZ_COST_UNIT_CHANGE_ATTACHMENT 第2列 | 请求附件顺序；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 12 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 13 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.5 BIZ_COST_UNIT_VIOLATION（造价单位违规事实记录）
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/violation/domain/CostUnitViolation.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 违规记录主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556358 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | COST_UNIT_ID | 造价单位 ID | BIGINT | BIGINT | 否 | — | IDX_BIZ_COST_UNIT_VIOLATION_UNIT 第1列 | 单位逻辑引用；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | COST_UNIT_NAME | 造价单位名称快照 | VARCHAR | VARCHAR(255) | 否 | — | — | 登记时的单位名称快照；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | VIOLATION_TYPE | 违规类型字典编码 | VARCHAR | VARCHAR(32) | 否 | — | IDX_BIZ_COST_UNIT_VIOLATION_UNIT 第2列 | 废标/拒绝委托字典；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | VIOLATION_TIME | 违规时间 | TIMESTAMP | TIMESTAMP(6) | 否 | — | IDX_BIZ_COST_UNIT_VIOLATION_UNIT 第3列 | 原型违规登记字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.6 BIZ_COST_UNIT_QUARTER_ASSESS（造价单位季度考核记录）
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/quarterassess/domain/CostUnitQuarterAssess.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 考核记录主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556360 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | ASSESSMENT_YEAR | 考核年度 | INT | INT | 否 | — | IDX_BIZ_COST_UNIT_QUARTER_UNIT 第2列 | 原型季度考核字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | ASSESSMENT_QUARTER | 考核季度字典编码 | VARCHAR | VARCHAR(16) | 否 | — | IDX_BIZ_COST_UNIT_QUARTER_UNIT 第3列 | 季度字典；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | COST_UNIT_ID | 造价单位 ID | BIGINT | BIGINT | 否 | — | IDX_BIZ_COST_UNIT_QUARTER_UNIT 第1列 | 单位逻辑引用；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | COST_UNIT_NAME | 造价单位名称快照 | VARCHAR | VARCHAR(255) | 否 | — | — | 登记时的单位名称快照；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | CONSULTATION_PROJECT_NAME | 咨询项目名称 | VARCHAR | VARCHAR(255) | 否 | — | — | 原型季度考核字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | ENTRUSTING_UNIT_NAME | 委托单位名称 | VARCHAR | VARCHAR(255) | 否 | — | — | 原型季度考核字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | TOTAL_SCORE | 考评总分 | DECIMAL | DECIMAL(18,6) | 否 | — | — | 原型季度考核字段；精度范围见 Q-CU-013；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | SUGGESTION | 建议 | VARCHAR | VARCHAR(4000) | 是 | — | — | 原型季度考核字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | QUARTER_ATTACHMENT | 季度考核表附件值 | VARCHAR | VARCHAR(1000) | 是 | — | — | CostUnitQuarterAssess 字段；编码格式需结合平台附件约定复核；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 12 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 13 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 14 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 15 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 16 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.7 BIZ_COST_UNIT_ANNUAL_ASSESS（造价单位年度考核记录）
实体：digital-construction-modules/digital-construction-business/src/main/java/com/bokun/business/costunit/annualassess/domain/CostUnitAnnualAssess.java
| 序号 | 字段 | 中文含义 | 逻辑类型 | 实测物理类型 | 可空 | 默认值 | 主键/外键/索引 | 来源、核心性 | 核验状态/证据 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | ID | 考核记录主键 | BIGINT | BIGINT | 否 | — | PK；唯一索引 INDEX33556362 | 平台雪花 ID；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 2 | ASSESSMENT_YEAR | 考核年度 | INT | INT | 否 | — | IDX_BIZ_COST_UNIT_ANNUAL_UNIT 第2列 | 原型年度考核字段；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 3 | COST_UNIT_ID | 造价单位 ID | BIGINT | BIGINT | 否 | — | IDX_BIZ_COST_UNIT_ANNUAL_UNIT 第1列 | 单位逻辑引用；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 4 | COST_UNIT_NAME | 造价单位名称快照 | VARCHAR | VARCHAR(255) | 否 | — | — | 登记时的单位名称快照；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 5 | ANNUAL_SCORE | 年度考核得分 | DECIMAL | DECIMAL(18,6) | 否 | — | — | 原型年度考核字段；精度范围见 Q-CU-013；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 6 | ANNUAL_ATTACHMENT | 年度考核文件附件值 | VARCHAR | VARCHAR(1000) | 是 | — | — | CostUnitAnnualAssess 字段；编码格式需结合平台附件约定复核；核心字段 | 已按实际库核对（MCP 2026-09-26） |
| 7 | CREATE_DEPT | 创建部门 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 8 | CREATE_BY | 创建人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 9 | CREATE_TIME | 创建时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 10 | UPDATE_BY | 更新人 ID | BIGINT | BIGINT | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 11 | UPDATE_TIME | 更新时间 | TIMESTAMP | TIMESTAMP(6) | 是 | — | — | BaseEntity 平台审计；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
| 12 | DEL_FLAG | 逻辑删除标记 | CHAR | CHAR(1) | 否 | '0' | — | BaseEntity 平台逻辑删除；支撑字段 | 已按实际库核对（MCP 2026-09-26） |
3.8 BIZ_COST_UNIT_DRAW_APPLICATION（造价单位抽取申请主表）
实体：drawapplication/domain/CostUnitDrawApplication.java。以下 20 列按 MCP 实际结构回读。
| 序号 | 字段 | 中文含义 | 实测物理类型 | 可空 | 默认值 | 主键/索引 | 核验状态 |
|---|---|---|---|---|---|---|---|
| 1 | ID | 申请主键 | BIGINT | 否 | — | PK；INDEX33556396 | MCP 已核对 |
| 2 | COST_UNIT_ID | 造价单位 ID | BIGINT | 否 | — | IDX_CU_DRAW_UNIT 第 1 列 | MCP 已核对 |
| 3 | COST_UNIT_NAME | 单位名称快照 | VARCHAR(255) | 否 | — | — | MCP 已核对 |
| 4 | CONSULTATION_PROJECT_NAME | 咨询项目名称 | VARCHAR(255) | 否 | — | — | MCP 已核对 |
| 5 | CONSULTATION_CATEGORY | 咨询类别编码 | VARCHAR(100) | 否 | — | — | MCP 已核对 |
| 6 | PLAN_TIME | 计划抽取时间 | TIMESTAMP(6) | 否 | — | — | MCP 已核对 |
| 7 | APPLICANT_DEPT_ID | 申请部门 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 8 | APPLICANT_DEPT_NAME | 申请部门快照 | VARCHAR(255) | 否 | — | — | MCP 已核对 |
| 9 | APPLICATION_FORM_OSS_IDS | 申请表附件 ID | VARCHAR(1000) | 否 | — | — | MCP 已核对 |
| 10 | PROJECT_COMPARISON_OSS_IDS | 项目比选文件 ID | VARCHAR(1000) | 否 | — | — | MCP 已核对 |
| 11 | HANDLER_USER_ID | 抽取经办人 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 12 | EXTRACTION_RESULT_OSS_IDS | 抽取结果附件 ID | VARCHAR(1000) | 是 | — | — | MCP 已核对 |
| 13 | BUSINESS_STATUS | 流程业务状态 | VARCHAR(20) | 否 | 'draft' | IDX_CU_DRAW_STATUS 第 1 列 | MCP 已核对 |
| 14 | SUBMIT_TIME | 提交时间 | TIMESTAMP(6) | 是 | — | — | MCP 已核对 |
| 15 | CREATE_DEPT | 创建部门 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 16 | CREATE_BY | 创建人 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 17 | CREATE_TIME | 创建时间 | TIMESTAMP(6) | 是 | — | IDX_CU_DRAW_STATUS 第 2 列、IDX_CU_DRAW_UNIT 第 2 列 | MCP 已核对 |
| 18 | UPDATE_BY | 更新人 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 19 | UPDATE_TIME | 更新时间 | TIMESTAMP(6) | 是 | — | — | MCP 已核对 |
| 20 | DEL_FLAG | 逻辑删除标记 | CHAR(1) | 否 | '0' | — | MCP 已核对 |
3.9 BIZ_COST_UNIT_AWARD_RESULT（造价单位中标结果主表）
实体：awardresult/domain/CostUnitAwardResult.java。以下 22 列按 MCP 实际结构回读。
| 序号 | 字段 | 中文含义 | 实测物理类型 | 可空 | 默认值 | 主键/索引 | 核验状态 |
|---|---|---|---|---|---|---|---|
| 1 | ID | 中标记录主键 | BIGINT | 否 | — | PK；INDEX33556400 | MCP 已核对 |
| 2 | COST_UNIT_ID | 造价单位 ID | BIGINT | 否 | — | IDX_CU_AWARD_UNIT 第 1 列 | MCP 已核对 |
| 3 | COST_UNIT_NAME | 单位名称快照 | VARCHAR(255) | 否 | — | — | MCP 已核对 |
| 4 | AWARD_PROJECT_NAME | 中标项目名称 | VARCHAR(255) | 否 | — | — | MCP 已核对 |
| 5 | AWARD_TIME | 中标时间 | TIMESTAMP(6) | 否 | — | IDX_CU_AWARD_UNIT 第 2 列 | MCP 已核对 |
| 6 | RESULT_FILE_OSS_IDS | 中标结果文件 ID | VARCHAR(1000) | 否 | — | — | MCP 已核对 |
| 7 | ORIGIN_DEPT_ID | 发起部门 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 8 | ORIGIN_DEPT_NAME | 发起部门名称快照 | VARCHAR(255) | 否 | — | — | MCP 已核对 |
| 9 | DEPT_HEAD_USER_ID | 发起部门部长 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 10 | AUDIT_LEGAL_HEAD_USER_ID | 监督审计法务部部长 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 11 | CONSTRUCTION_HEAD_USER_ID | 建设管理部部长 ID | BIGINT | 是 | — | 条件分支可跳过 | MCP 已核对 |
| 12 | ORIGIN_DEPUTY_LEADER_USER_ID | 发起部门分管领导 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 13 | GENERAL_MANAGER_USER_ID | 总经理 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 14 | CHAIRMAN_USER_ID | 董事长 ID | BIGINT | 否 | — | — | MCP 已核对 |
| 15 | BUSINESS_STATUS | 流程业务状态 | VARCHAR(20) | 否 | 'draft' | IDX_CU_AWARD_STATUS 第 1 列 | MCP 已核对 |
| 16 | SUBMIT_TIME | 提交时间 | TIMESTAMP(6) | 是 | — | — | MCP 已核对 |
| 17 | CREATE_DEPT | 创建部门 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 18 | CREATE_BY | 创建人 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 19 | CREATE_TIME | 创建时间 | TIMESTAMP(6) | 是 | — | IDX_CU_AWARD_STATUS 第 2 列 | MCP 已核对 |
| 20 | UPDATE_BY | 更新人 ID | BIGINT | 是 | — | — | MCP 已核对 |
| 21 | UPDATE_TIME | 更新时间 | TIMESTAMP(6) | 是 | — | — | MCP 已核对 |
| 22 | DEL_FLAG | 逻辑删除标记 | CHAR(1) | 否 | '0' | — | MCP 已核对 |
4. 约束、索引与字典
4.1 主键、外键与索引
| 表 | 约束/索引 | 唯一性 | 字段顺序 | 作用/核验 |
|---|---|---|---|---|
| BIZ_COST_UNIT | ID 主键（唯一索引 INDEX33556349） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT | UK_BIZ_CU_ACTIVE_NAME | 唯一 | 活动记录 UNIT_NAME | 活动名称唯一；DEL_FLAG 为删除记录时可复用名称 |
| BIZ_COST_UNIT_CHANGE | ID 主键（唯一索引 INDEX33556367） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT_CHANGE | IDX_BIZ_COST_UNIT_CHANGE_UNIT | 非唯一 | COST_UNIT_ID, OPERATED_AT | 按单位倒序查修改历史 |
| BIZ_COST_UNIT_CHANGE_DETAIL | ID 主键（唯一索引 INDEX33556369） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT_CHANGE_DETAIL | IDX_BIZ_COST_UNIT_CHANGE_DETAIL_CHANGE | 非唯一 | CHANGE_ID | 查事件字段明细 |
| BIZ_COST_UNIT_CHANGE_ATTACHMENT | ID 主键（唯一索引 INDEX33556353） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT_CHANGE_ATTACHMENT | IDX_BIZ_COST_UNIT_CHANGE_ATTACHMENT | 非唯一 | CHANGE_ID, SORT_NO | 按事件与顺序读取附件 |
| BIZ_COST_UNIT_VIOLATION | ID 主键（唯一索引 INDEX33556358） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT_VIOLATION | IDX_BIZ_COST_UNIT_VIOLATION_UNIT | 非唯一 | COST_UNIT_ID, VIOLATION_TYPE, VIOLATION_TIME | 单位违规分类与次数聚合 |
| BIZ_COST_UNIT_QUARTER_ASSESS | ID 主键（唯一索引 INDEX33556360） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT_QUARTER_ASSESS | UK_BIZ_CU_QUARTER_PERIOD | 唯一 | COST_UNIT_ID, ASSESSMENT_YEAR, ASSESSMENT_QUARTER | 同单位同年同季度唯一；支持单位期次查找 |
| BIZ_COST_UNIT_ANNUAL_ASSESS | ID 主键（唯一索引 INDEX33556362） | 唯一 | ID | 主键 |
| BIZ_COST_UNIT_ANNUAL_ASSESS | UK_BIZ_CU_ANNUAL_PERIOD | 唯一 | COST_UNIT_ID, ASSESSMENT_YEAR | 同单位同年度唯一 |
| BIZ_COST_UNIT_DRAW_APPLICATION | PK INDEX33556396 | 唯一 | ID | 主键 | | BIZ_COST_UNIT_DRAW_APPLICATION | IDX_CU_DRAW_STATUS | 非唯一 | BUSINESS_STATUS, CREATE_TIME | 按状态及创建时间筛选 | | BIZ_COST_UNIT_DRAW_APPLICATION | IDX_CU_DRAW_UNIT | 非唯一 | COST_UNIT_ID, CREATE_TIME | 按单位及创建时间查询 | | BIZ_COST_UNIT_AWARD_RESULT | PK INDEX33556400 | 唯一 | ID | 主键 | | BIZ_COST_UNIT_AWARD_RESULT | IDX_CU_AWARD_STATUS | 非唯一 | BUSINESS_STATUS, CREATE_TIME | 按状态及创建时间筛选 | | BIZ_COST_UNIT_AWARD_RESULT | IDX_CU_AWARD_UNIT | 非唯一 | COST_UNIT_ID, AWARD_TIME | 按单位及中标时间查询 |
MCP 回读未发现九张表的物理外键。数据库不约束单位、修改事件和 SYS_OSS 间的逻辑引用；Service 校验是当前完整性保障。活动单位名称及考核期间均由数据库唯一索引保护。
4.2 字典
| 字典类型 | 稳定编码 → 标签 | 使用状态 |
|---|---|---|
| cost_unit_company_nature | private → 私有；state_owned → 国有 | 已用于基本信息 |
| cost_unit_unit_grade | a → A档；b → B档 | 已用于基本信息 |
| cost_unit_violation_type | bid_fail → 废标；refuse_entrust → 拒绝委托 | 已用于违规台账 |
| cost_unit_assess_quarter | q1 → 一季度；q2 → 二季度；q3 → 三季度；q4 → 四季度 | 已用于季度台账 |
| cost_unit_consultation_type | estimate_review → 概算编制（审核）；bill_of_quantities_review → 工程量清单编制（审核）；bid_control_price_review → 招标控制价编制（审核）；construction_stage_cost_consulting → 施工阶段工程全过程造价咨询服务；final_settlement_review → 工程竣工结算编制（审核） | 抽取申请使用 |
| cost_unit_business_status | draft → 草稿；waiting → 进行中；back → 退回；finish → 已通过 | 抽取申请、中标情况页面状态映射 |
本轮在开发库新增 6 个字典类型、19 个字典值并已 MCP 回读。暂不记录类型/字典行的全字段矩阵，因为它们是既有平台表的数据项，本模块只负责上述数据变更。
5. 设计字段与实际字段差异
| 表 | 差异字段/约束 | 设计基线 | 实际开发库 | 处理 |
|---|---|---|---|---|
| BIZ_COST_UNIT | UNIT_NAME 活动名称唯一 | 有效单位唯一；逻辑删除后可复用 | UK_BIZ_CU_ACTIVE_NAME 唯一索引 | 已实现并 MCP 回读 |
| BIZ_COST_UNIT_QUARTER_ASSESS | 单位年度季度唯一 | 同单位同期一条 | UK_BIZ_CU_QUARTER_PERIOD 唯一索引 | 已实现并回读 |
| BIZ_COST_UNIT_ANNUAL_ASSESS | 单位年度唯一 | 同单位同年度一条 | UK_BIZ_CU_ANNUAL_PERIOD 唯一索引 | 已实现并回读 |
| BIZ_COST_UNIT_AWARD_RESULT | CONSTRUCTION_HEAD_USER_ID 可空 | 建管部发起时跳过该节点 | DM8 列可空 | 条件节点按业务规则控制 |
九张表的实体字段与开发库实测字段、类型、精度、可空性及默认值一致；本轮没有未处理的表结构差异。
6. 迁移与兼容说明
- 9 张业务表由本模块通过项目 MCP 在开发库建立/核对；仓库不保存业务 SQL 文件。
- 逻辑类型到 DM8 物理类型为 BIGINT、VARCHAR(n)、DECIMAL(18,6)、TIMESTAMP(6)、INT、CHAR(1)。正式目标数据库仍需按交付环境核验。
- 分数物理精度为 DECIMAL(18,6)，业务校验限制为 0–100 且最多两位小数。
- 流程和附件 ID 在业务表以业务字段保存；流程实例由 Warm-Flow 管理，OSS ID 由平台文件服务校验。
- DEL_FLAG 默认 '0' 表示未删除；流程 BUSINESS_STATUS 默认 'draft'。暂停状态为按时间派生，未增加冗余状态列。
- 本模块业务表间为逻辑关联，开发库未建物理外键；删除保护、名称及考核期间唯一由数据库约束与 Service 共同维护。
7. 开发库变更回读摘要
| 对象 | 实际变更/状态 | 回读结果 |
|---|---|---|
| 业务表 | 九张模块表 | 9 张结构、134 列已 MCP 回读 |
| 索引 | 活动单位名称、考核期唯一和流程查询索引 | 约束与索引列已 MCP 回读 |
| 字典 | 6 类型、19 个值 | 已按类型及稳定编码回读；抽取类别、流程状态已接入页面 |
| 菜单 | 六个业务页面、两条隐藏办理页及动作权限 | 42 行（含结构菜单）；39 条 costUnit:% 权限分别映射到 superadmin 和 cost_unit_group_manager 两个角色，已按 MCP 回读 |
| 流程 | 抽取申请 V3（定义 ID 2103744514127572994）；中标情况 V3（定义 ID 2103745208763035649） | V3 均已发布启用；V3 实例均已完成。抽取申请 V2 行保留且未发布；中标情况 V2 行保留并失效 |
V3 只调整 Warm-Flow 定义的节点与连线坐标，未增加或修改业务表结构。开发库回读显示两条 V3 实例均使用对应 V3 定义，FLOW_STATUS=finish；抽取申请实例 ID 2103749226310676481，中标情况实例 ID 2103751061557751809。两实例与 V2 定义行均保留。中标 V3 六个审批节点及抽取 V3 结果登记的任务记录见测试报告。
2026-09-28 MCP 回读发现旧版 FLOW_DEFINITION 中存在重复的流程编码/版本组合：cost_unit_award_result V1 有 3 条 IS_PUBLISH=0 定义，cost_unit_draw_application V1 有 2 条定义（分别为 IS_PUBLISH=0 与 9）。其中一条抽取 V1 定义已有 1 个历史流程实例；旧定义均未作为当前运行版本，保留以供历史追溯，本轮未清理或改写。当前运行仍为上述 V3 版本。后续导入或发布流程前应先核对重复行并回读实例引用。
菜单回读显示 superadmin 与 cost_unit_group_manager 均映射了 39 条 costUnit:% 权限；两条隐藏办理页与相应台账使用同一父菜单。未修改角色、菜单或组织数据。菜单行详细权限以需求与 Controller 核对为准。
8. 关系与数据范围约束
所有有对应页面菜单权限的用户均可查看全量记录，列表没有部门范围条件；每种写操作仍由后端独立权限保护。单位、考核和流程表之间没有物理外键，Service 在新增、删除和状态变更时校验活动记录、业务唯一规则和流程任务。数据范围规则见需求分析。