主题
工程进度监管 · 数据库设计文档
文档版本：0.10 ｜ 最近核对日期：2026-11-10
本版定义前期来源难点卡点接收和建设单位维护所需的三张目标表（BIZ_PROGRESS_DIFFICULTY、BIZ_PROGRESS_DIFFICULTY_RECORD、BIZ_PROGRESS_DIFFICULTY_FILE），已在开发库（DM8）通过项目专用 MCP 纳管入口执行 DDL 并回读核验完成。业务和接口见需求分析第9节、详细设计。
1. 关系与矩阵约定
BIZ_PROGRESS_DIFFICULTY是一条问题；BIZ_PROGRESS_DIFFICULTY_RECORD保存建设单位的督办进展或上报内容；BIZ_PROGRESS_DIFFICULTY_FILE关联来源或办理附件。前期十四表保存送审快照，这里保存进度问题库的来源及管理事实，不复制前期全部台账。
以下各表完整字段=本表业务列＋五个共同审计列。全部物理类型为DM8建议，核验状态均待实体及MCP核对；ID为Long、前端保持原值，关系为逻辑外键，由服务端核验同问题、同范围。不默认加租户、软删除或并发版本列。
| 审计列 | 含义/逻辑类型 | 物理类型及长度 | 可空/默认 | 键/索引 | 来源/核验 |
|---|---|---|---|---|---|
| CREATE_DEPT | 创建部门/Long | BIGINT/64位 | 是/无 | 逻辑引用部门/无 | 平台填充；基类已核名、库待核 |
| CREATE_BY | 创建人/Long | BIGINT/64位 | 否/无 | 逻辑引用用户/无 | 平台填充；基类已核名、库待核 |
| CREATE_TIME | 创建时间/LocalDateTime | TIMESTAMP/精度待核 | 否/无 | 无 | 平台填充；库待核 |
| UPDATE_BY | 修改人/Long | BIGINT/64位 | 否/无 | 逻辑引用用户/无 | 平台填充；库待核 |
| UPDATE_TIME | 修改时间/LocalDateTime | TIMESTAMP/精度待核 | 否/无 | 无 | 平台填充；库待核 |
2. BIZ_PROGRESS_DIFFICULTY
| 列 | 中文含义/逻辑类型 | 物理类型/长度精度 | 空/默认 | 主外键/唯一性/索引 | 来源或生成/核验状态 |
|---|---|---|---|---|---|
| ID | 问题ID/Long | BIGINT/64位 | 否/无 | PK | 雪花ID/待核 |
| SOURCE_TYPE | 来源类别/String | VARCHAR/32 | 否/无 | UK_DIFFICULTY_SOURCE组成 | 本增量PRELIMINARY_OBJECT/待核 |
| SOURCE_OBJECT_ID | 前期对象/Long | BIGINT/64位 | 否/无 | 逻辑FK；UK_DIFFICULTY_SOURCE组成 | 验证前期稳定对象/待核 |
| SOURCE_ISSUE_KEY | 来源卡点键/String | VARCHAR/64 | 否/无 | UK_DIFFICULTY_SOURCE组成 | 沿前期issueKey，不重新生成/待核 |
| SOURCE_REVISION_ID | 最近获审资料/Long | BIGINT/64位 | 否/无 | 逻辑引用前期APPROVED快照 | 内部审核同步/待核 |
| UNIT_PROJECT_ID | 具体单位工程/Long | BIGINT/64位 | 否/无 | 逻辑FK；IX_DIFFICULTY_UNIT | 从前期有效归属验证/待核 |
| LINE_ID | 线路/Long | BIGINT/64位 | 否/无 | IX_DIFFICULTY_SCOPE组成 | 服务端UnitProject反取/待核 |
| BID_ID | 标段/Long | BIGINT/64位 | 否/无 | IX_DIFFICULTY_SCOPE组成 | 服务端反取，组合授权/待核 |
| SITE_ID | 工点/Long | BIGINT/64位 | 否/无 | IX_DIFFICULTY_SCOPE组成 | 服务端反取/待核 |
| SOURCE_DESCRIPTION | 获审源描述/String | VARCHAR/2000 | 否/无 | 无 | 仅前期获审内容更新/待核 |
| SOURCE_REVIEWED_BY | 来源审核人/Long | BIGINT/64位 | 否/无 | 逻辑用户 | 真实流程，不收客户端自报/待核 |
| SOURCE_REVIEWED_TIME | 来源审核时间/LocalDateTime | TIMESTAMP/精度待核 | 否/无 | 无 | 真实流程事件/待核 |
| SUPERVISED | 是否督办/Boolean | SMALLINT/0或1 | 否/0 | 无 | 建设单位维护，源同步不改/待核 |
| RESPONSIBLE_ORG_ID | 管理指定责任单位/Long | BIGINT/64位 | 是/无 | 逻辑组织 | 建设单位选已有组织/待核 |
| RESPONSIBLE_ORG_NAME | 责任单位名称快照/String | VARCHAR/200 | 是/无 | 与ID一致 | 服务端组织快照/待核 |
| DUE_DATE | 管理完成时限/LocalDate | DATE/日 | 是/无 | 无 | 建设单位维护，不把前期关口计划硬拷贝/待核 |
UK_DIFFICULTY_SOURCE=(SOURCE_TYPE,SOURCE_OBJECT_ID,SOURCE_ISSUE_KEY)保证同来源问题身份；IX_DIFFICULTY_UNIT=(UNIT_PROJECT_ID)，IX_DIFFICULTY_SCOPE=(LINE_ID,BID_ID,SITE_ID)。现有问题库若已有更多处理状态/办结字段，沿其机制保留；本增量不凭来源更新重置状态，也不擅自新加一套关闭审批。对象外的名称与标题按源描述及工程展示，不重复造必填标题。
3. BIZ_PROGRESS_DIFFICULTY_RECORD
| 列 | 中文含义/逻辑类型 | 物理类型/长度精度 | 空/默认 | 主外键/唯一性/索引 | 来源或生成/核验状态 |
|---|---|---|---|---|---|
| ID | 管理记录ID/Long | BIGINT/64位 | 否/无 | PK | 雪花ID/待核 |
| DIFFICULTY_ID | 所属问题/Long | BIGINT/64位 | 否/无 | 逻辑FK；IX_DIFFICULTY_RECORD | 真实问题及权限/待核 |
| RECORD_KIND | 记录种类/String | VARCHAR/20 | 否/无 | SUPERVISION或REPORT | 建设单位选择，非外发状态/待核 |
| CONTENT | 督办进展或上报内容/String | VARCHAR/2000 | 否/无 | 无 | 建设单位填写/待核 |
IX_DIFFICULTY_RECORD=(DIFFICULTY_ID,CREATE_TIME)。办理人/时间使用实际CREATE_BY/CREATE_TIME，不重复建可客户端自报字段。记录追加，前期源同步不更新或删除这些行；REPORT表示登记上报内容，不冒充已有年度审批或外部发送成功。
4. BIZ_PROGRESS_DIFFICULTY_FILE
| 列 | 中文含义/逻辑类型 | 物理类型/长度精度 | 空/默认 | 主外键/唯一性/索引 | 来源或生成/核验状态 |
|---|---|---|---|---|---|
| ID | 引用行ID/Long | BIGINT/64位 | 否/无 | PK | 雪花ID/待核 |
| DIFFICULTY_ID | 所属问题/Long | BIGINT/64位 | 否/无 | 逻辑FK；IX_DIFFICULTY_FILE | 验证同问题/待核 |
| RECORD_ID | 所属管理记录/Long | BIGINT/64位 | 是/无 | 逻辑FK RECORD；须同问题 | 来源附件空，记录附件必填/待核 |
| FILE_PURPOSE | 用途/String | VARCHAR/20 | 否/无 | SOURCE或RECORD | 服务端按动作指定/待核 |
| FILE_ID | 文件服务ID/Long | BIGINT/64位 | 否/无 | 逻辑文件引用 | 受控文件ID，不存URL/待核 |
| SORT_NO | 顺序/Integer | INT/整数 | 否/0 | 无 | 列表顺序/待核 |
IX_DIFFICULTY_FILE=(DIFFICULTY_ID,FILE_PURPOSE,RECORD_ID)。源更新只替换当前SOURCE引用，旧来源证据仍在前期APPROVED历史；不能删RECORD附件或物理删除OSS。附件每次预览下载核问题权限，不能以知道FILE_ID就放行。
5. 实施核对和一致性
三表及共用审计列都未核实实际库。实施前纳管检查现有问题库，复用优先；新建或变更必须完整矩阵对照真实列及写入回读，DML报行数、DDL核对象，不保存业务.sql。
默认同应用业务Service同步调用参与前期审核同数据源事务；不HTTP自调用，不REQUIRES_NEW，不吞接收异常。验证源重复更新仍同ID，建设单位管理字段/记录不丢，源失败不能假审批通过。DM8类型、VARCHAR字符字节和索引长度待核，厂商差异限Mapper边界，面向人大金仓/openGauss不提前生成多套适配。