前期管理 · 数据库设计文档

文档版本：1.20 ｜ 最近核对日期：2026-11-11

本文依据用户对9项业务口径和3项配套条件的明确回复，以及疑似重复、多份手续分别有效期、沿现有单位工程授权和历史初始完整资料可单次审核的补充决定，定义前期管理数据设计。业务规则唯一正文见需求分析。本版十四张实体表已在开发库（DM8）通过项目专用 MCP 纳管入口执行 DDL 并回读核验完成。

初始进度、后续进度及影响完成率、工程量或滞后判断的资料都须经监理审核；因此不能只为“目标步数”留一张变更单。本版以稳定对象＋强类型送审快照保存申请前后资料，已生效快照不覆盖，施工原始提交与监理卡点修订可分别追溯。数据快照不是并发版本锁，不引入通用JSON表单或任意字段EAV。

1. 模型和事实归属

拟建表	职责	关系
BIZ_PRELIMINARY_OBJECT	稳定台账身份、单位工程归属、当前生效快照指针	一对象多次申请
BIZ_PRELIMINARY_REVISION	一份完整的工作、施工提交或已批准资料快照	属于对象及申请
BIZ_PRELIMINARY_CHANGE	初始/变更申请、送审指针及流程状态	关联基线、施工提交、工作快照
BIZ_PRELIMINARY_LAND	征地分类资料快照	每LAND快照一行
BIZ_PRELIMINARY_UTILITY	管线分类资料快照	每UTILITY快照一行
BIZ_PRELIMINARY_TRAFFIC	交通分类资料快照	每TRAFFIC快照一行
BIZ_PRELIMINARY_GREENING	绿化分类资料快照	每GREENING快照一行
BIZ_PRELIMINARY_STAGE_RECORD	各关计划及实际完成日期	每快照每关一行
BIZ_PRELIMINARY_PLANT_ITEM	地块内植物明细快照	绿化快照一对多
BIZ_PRELIMINARY_ATTACHMENT_REF	送审及生效资料的文件引用	按快照和用途组织
BIZ_PRELIMINARY_PERMIT	每份手续附件的说明及有效截止日	一份附件一个有效期记录
BIZ_PRELIMINARY_BLOCKER	施工录入、监理可修改的卡点源资料快照	稳定问题键关联进度问题库
BIZ_PRELIMINARY_GIS_DRAFT	施工空间采集/修改的送审快照	通过后发布至GIS并形成绑定
BIZ_PRELIMINARY_IMPORT_DUPLICATE	部分重复候选及监理确认	属于待审核申请

图中为逻辑关系。Service在同一责任边界验证快照、申请、对象及类别一致性，不能把逻辑外键理解为允许孤立数据；不跨模块直接建立物理外键。是否采用库内物理外键须结合项目实际对象核对，不猜测现库结构。

1.1 生效与审核快照

1. 新增对象先有稳定ID，CURRENT_REVISION_ID为空；草稿和待审资料可在有权台账中查看，但不进入正式完成率或已生效事实。
2. CHANGE.WORKING_REVISION_ID指向施工可维护的工作快照；首次提交时复制一份SUBMITTED快照冻结，保留施工提交原稿。
3. waiting期间施工不能修改已提交业务；监理只获准修改卡点字段及其附件，其他业务资料只读，不正确时退回施工修改。监理卡点修改发生在工作快照，原SUBMITTED不动，修改人及时间由平台审计和办理记录追溯。
4. back时先冻结本轮监理工作稿为REVIEWED，关联该轮SUBMITTED并记录监理人时；从REVIEWED复制新的WORKING供施工修改，同申请同实例重提。每次重提再冻结施工提交快照；既往SUBMITTED及REVIEWED均不覆盖，不能丢失施工A→监理B→施工C中的B。
5. 审核通过后工作快照转为APPROVED、冻结，OBJECT.CURRENT_REVISION_ID切换至它。新变更从该快照复制，保存BASE_REVISION_ID；原已批准资料不改写。
6. 关键资料、每关计划/实际时间、植物、手续、GIS和卡点都使用同一申请快照，避免一部分审核另一部分绕过。一般备注与普通附件可维护边界以需求正文为准，不得借普通维护修改关键资料。

首次保存最低为有效单位工程、合法施工身份及对象名称，分类扩展仍建立对应一行，资料未齐的业务列允许空；提交再执行分类必填和全部计划校验。Service先预分配OBJECT/CHANGE/REVISION三个ID，在同事务插对象、带非空工作ID的申请、工作快照及子项；不能先用空WORKING_REVISION_ID插入。当前关系为逻辑外键，若加入即时物理外键必须同步解决循环引用写序。

快照深复制生成全部新子行ID和新REVISION_ID，先复制附件行并建立旧新附件ID映射，再复制PERMIT并重写ATTACHMENT_REF_ID。FILE_ID及同对象稳定ISSUE_KEY/SPATIAL_KEY沿用，不复制文件实体，不让新手续继续指向旧快照附件。源SUBMITTED/REVIEWED/APPROVED及其子项不可修改；新工作稿重置审核人时和本轮提交关联。完整算法和API返回新附件ID的要求见详细设计。

1.2 单位工程与权限

四类对象必须归属具体UNIT_PROJECT_ID。服务端加载现有UnitProject，反取lineId/bidId/siteId/majorCode，保存必要快照并调用EngineeringDataAccessHelper.assertPairVisible；不得相信前端自报的上下文，也不能反查第一个标段。当前平台单位工程可见性映射有效标段×工点组合，同标段工点的不同专业不新增独立权限维度，不建立另一套unitID授权表。

施工和监理组织候选可从单位工程所对应BidSection.constructUnitId/superviseUnitId核对；人员资格还须核查实际有效组织/岗位关系，不能将同公司全部用户直接视为合格审核人。功能权限、单位工程范围、施工维护责任和有效监理任务分别检查。

2. 完整字段矩阵规则

下文14张表完整列集合为“本表矩阵＋2.1节全部五个审计列”。每行包含类型、长度精度、空值、默认、键约束、索引、来源及核验状态；所有物理类型均为DM8建议，设计待实体与MCP核对。BaseEntity五列仅已核实Java名称与逻辑类型，不代表本模块实际表已有这些列。

Long使用BIGINT，前端保持string或number原值，后端沿用BigNumberSerializer。业务日期按自然日DATE，审计/提交使用TIMESTAMP；若实际表单需要时分精度，应同步接口、全部阶段日期和矩阵，不混用字符串。面积/数量使用DECIMAL而非浮点。

2.1 全部14张表共有审计列

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
CREATE_DEPT	创建部门	Long	BIGINT	64位	是	—	逻辑引用部门	—	平台自动填充，不作为工程授权条件	基类已核名，库待核对
CREATE_BY	创建人	Long	BIGINT	64位	否	—	逻辑引用用户	—	平台插入填充	基类已核名，库待核对
CREATE_TIME	创建时间	LocalDateTime	TIMESTAMP	秒及小数精度待核对	否	—	—	—	平台插入填充	基类已核名，库待核对
UPDATE_BY	最近修改人	Long	BIGINT	64位	否	—	逻辑引用用户	—	平台插入/更新填充	基类已核名，库待核对
UPDATE_TIME	最近修改时间	LocalDateTime	TIMESTAMP	同上	否	—	—	—	平台插入/更新填充	基类已核名，库待核对

不自动加TENANT_ID、DEL_FLAG或VERSION；现BaseEntity不含这些列，本期也未要求删除、租户隔离或新增并发锁。SUBMITTED/REVIEWED/APPROVED是业务审计快照角色，不是乐观锁版本。

可空性区分“可存未齐草稿”和“正式提交必填”。OBJECT身份/真实单位工程上下文、REVISION.OBJECT_NAME、所有主键父子关联和已有附件行的真实FILE_ID仍非空；仅分类录入资料、阶段日期及可暂存的植物业务值按下表允许空。空行植物/空几何不自动生成占位；实际存在的附件、卡点或几何行仍须符合各自结构合法性。提交与批准边界统一校验业务规则，数据库可空不等于可审核空面积或空计划。

3. 各表完整业务字段

3.1 BIZ_PRELIMINARY_OBJECT

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	稳定台账标识	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
OBJECT_TYPE	台账类别	String	VARCHAR	20	否	—	LAND/UTILITY/TRAFFIC/GREENING	IX_OBJECT_UNIT	入口白名单	待核对
OBJECT_CODE	系统业务编号	String	VARCHAR	64	否	—	UK_OBJECT_CODE	唯一	系统生成，不用三位序号截断容量	待核对
UNIT_PROJECT_ID	所属具体单位工程	Long	BIGINT	64位	否	—	逻辑FK UnitProject	IX_OBJECT_UNIT	服务端验证真实单位工程	待核对
LINE_ID	线路上下文	Long	BIGINT	64位	否	—	逻辑引用线路	IX_OBJECT_SCOPE	从单位工程反取	待核对
BID_ID	标段上下文	Long	BIGINT	64位	否	—	与SITE_ID组合授权	IX_OBJECT_SCOPE	从单位工程反取	待核对
SITE_ID	物理工点上下文	Long	BIGINT	64位	否	—	与BID_ID组合授权	IX_OBJECT_SCOPE	从单位工程反取	待核对
MAJOR_CODE	专业快照编码	String	VARCHAR	32	是	—	非独立授权维度	—	单位工程主数据	待核对
UNIT_PROJECT_NAME	单位工程名称快照	String	VARCHAR	200	否	—	—	—	服务端主数据	待核对
LINE_NAME	线路名称快照	String	VARCHAR	200	否	—	—	—	服务端主数据	待核对
BID_NAME	标段名称快照	String	VARCHAR	200	否	—	—	—	服务端主数据	待核对
SITE_NAME	工点名称快照	String	VARCHAR	200	否	—	—	—	服务端主数据	待核对
CURRENT_REVISION_ID	当前已生效资料	Long	BIGINT	64位	是	—	逻辑FK REVISION.ID，须同对象APPROVED	—	仅审核成功切换；新增待审为空	待核对

身份和单位工程归属不得通过普通表单静默迁移。本期按同对象固定归属设计；实际出现跨单位工程纠错时先确认业务影响，不篡改已审批历史。正式列表可展示对象及申请状态，但正式完成率等计算仅取CURRENT_REVISION_ID对应数据。

3.2 BIZ_PRELIMINARY_REVISION

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	资料快照标识	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
OBJECT_ID	所属台账	Long	BIGINT	64位	否	—	逻辑FK OBJECT.ID	IX_REVISION_OBJECT	从申请关联	待核对
CHANGE_ID	所属申请	Long	BIGINT	64位	否	—	逻辑FK CHANGE.ID，同对象	IX_REVISION_CHANGE	服务端生成关联	待核对
SNAPSHOT_ROLE	快照角色	String	VARCHAR	20	否	WORKING	WORKING/SUBMITTED/REVIEWED/APPROVED	—	提交复制冻结，批准冻结工作稿	待核对
SOURCE_SUBMITTED_REVISION_ID	本轮对应施工提交快照	Long	BIGINT	64位	是	—	同申请SUBMITTED；REVIEWED/APPROVED必填	—	提交后工作稿关联，冻结留存监理版本时保留	待核对
REVIEWED_BY	冻结本轮审核稿的监理	Long	BIGINT	64位	是	—	有效任务办理人	—	同意/退回时服务端身份，不收客户端自报	待核对
REVIEWED_TIME	本轮审核稿冻结时间	LocalDateTime	TIMESTAMP	同审计列	是	—	REVIEWED/APPROVED必填	—	同意/退回真实时间	待核对
OBJECT_NAME	工点事项/迁改点/导改点/地块名称	String	VARCHAR	200	否	—	—	—	施工填写，监理审核；不是任意归属变更	待核对
SOURCE_BUSINESS_CODE	来源台账业务编号	String	VARCHAR	100	是	—	非系统生成编号，不设全局唯一	—	施工填原业务编号，随快照审核并用于分类查重	待核对
REMARK	业务备注	String	VARCHAR	1000	是	—	—	—	申请资料	待核对

每份快照必须恰有一个与OBJECT_TYPE匹配的分类扩展，不能一个快照同时写四类。总阶段数由类别确定，完成数及进度只从已批准阶段实际日期派生，不在根表另存可随意编辑的完成步数或百分比。

3.3 BIZ_PRELIMINARY_CHANGE

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	审核申请标识	Long	BIGINT	64位	否	—	PK，流程businessId	主键	服务端雪花ID	待核对
OBJECT_ID	所属台账	Long	BIGINT	64位	否	—	逻辑FK OBJECT.ID	IX_CHANGE_OBJECT_STATUS	服务端关联	待核对
CHANGE_KIND	申请性质	String	VARCHAR	20	否	—	INITIAL/UPDATE	—	首次资料或后续关键资料修改	待核对
BASE_REVISION_ID	申请前生效基线	Long	BIGINT	64位	是	—	INITIAL为空；UPDATE须同对象APPROVED	—	服务端读取CURRENT_REVISION_ID	待核对
WORKING_REVISION_ID	当前工作资料	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID，同申请	—	保存和审核卡点修订的目标	待核对
SUBMITTED_REVISION_ID	最近一次施工提交原稿	Long	BIGINT	64位	是	—	同申请SUBMITTED，冻结不可改	—	每次正式提交复制	待核对
FLOW_STATUS	平台流程状态	String	VARCHAR	20	否	draft	BusinessStatusEnum实际值	IX_CHANGE_OBJECT_STATUS	流程事件回写	枚举已核名，库待核对
FLOW_INSTANCE_ID	流程实例	Long	BIGINT	64位	是	—	逻辑引用引擎，实际类型复核	IX_CHANGE_INSTANCE	首提后关联，back同实例重提	待核对
CHANGE_REASON	申请说明	String	VARCHAR	1000	是	—	草稿可空，正式提交必填	—	初始资料说明或变更原因	待核对
IMPORT_SOURCE	是否来源导入	Boolean	SMALLINT	0/1	否	0	—	—	系统确定，非客户端自报	待核对
IMPORT_FILE_ID	导入源文件标识	Long	BIGINT	64位	是	—	导入申请必填，逻辑引用文件服务	—	保留审核可查的本次模板文件引用	待核对
IMPORT_ROW_NO	本对象导入主表行号	Integer	INT	整数	是	—	导入申请必填，大于0	—	与源文件一起定位，不单凭行号跨文件匹配	待核对
SUBMITTED_BY	最近提交施工人员	Long	BIGINT	64位	是	—	逻辑引用用户	—	登录身份且符合施工维护责任	待核对
SUBMITTED_TIME	最近提交时间	LocalDateTime	TIMESTAMP	同审计列	是	—	—	—	实际提交生成	待核对
APPLIED_TIME	资料生效时间	LocalDateTime	TIMESTAMP	同审计列	是	—	—	—	审核通过且业务/必要集成成功生成	待核对

平台实际状态为draft、waiting、back、finish、cancel、invalid、termination，不创建approved/rejected替代码。监理意见、每轮办理人及操作历史读平台流程，不能以业务表填finish代替真实任务办理。

审批通过应用整个强类型工作快照，不逐字段从任意Map覆盖实体。流程事件、疑似重复结论、卡点来源写入、GIS发布及对象生效必须保持所选事务/接入方案的一致结果；具体同步事务参与性在实施验证，失败不能伪报联动完成。不能仅凭文档承诺已具备跨服务原子性。

3.4 BIZ_PRELIMINARY_LAND

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
REVISION_ID	征地资料快照	Long	BIGINT	64位	否	—	PK，逻辑FK REVISION.ID，LAND	主键	同快照	待核对
SITE_TYPE	工点业务类型	String	VARCHAR	32	是	—	草稿可空，提交必填业务字典	—	施工选择	待核对
LAND_USE_TYPE	用地性质	String	VARCHAR	20	是	—	草稿可空，提交PERMANENT/TEMPORARY必填	—	不同性质可拆条	待核对
REQUESTED_AREA	应交面积平方米	BigDecimal	DECIMAL	18,4	是	—	草稿可空，提交必填且大于0	—	施工填报、监理审核	待核对
DELIVERED_AREA	已交面积平方米	BigDecimal	DECIMAL	18,4	否	0	0..REQUESTED_AREA	—	同快照审核	待核对
DELIVERY_BATCH	交地批次	String	VARCHAR	32	是	—	草稿可空，提交必填稳定业务字典	IX_LAND_BATCH	不同批次允许拆条	待核对
ADMIN_DISTRICT	行政区	String	VARCHAR	100	是	—	草稿可空，提交必填平台地区口径	IX_LAND_DISTRICT	施工选择	待核对
RESPONSIBLE_ORG_ID	责任单位标识	Long	BIGINT	64位	是	—	逻辑引用SYS_DEPT	—	已建档主体选择，不伪造外部ID	待核对
RESPONSIBLE_ORG	责任单位名称快照	String	VARCHAR	200	是	—	草稿可空，提交必填；有ID时从主数据取名	—	外部未建档主体按业务登记	待核对
LAND_CURRENT_USE	用地现状	String	VARCHAR	1000	是	—	—	—	施工填写	待核对
OWNERSHIP_DESCRIPTION	权属说明	String	VARCHAR	1000	是	—	—	—	施工填写	待核对

征地四关为用地申请→协议签订→腾地交地→交地确认，每关计划/实际日期在STAGE_RECORD。交地率=已批准已交面积/已批准应交面积，零分母显示“—”；平方米为存储基准，亩按平方米×0.0015派生，不存另一份可独立改的亩面积。

不同时持久化第二份计划交地/实际交地日期以免与关口记录矛盾：交地管理采用腾地交地关的计划及实际日期，交地确认关另保留确认日期。具体关口证据及部分交地明细要求沿需求正文实施，不由字段快照自动推定腾地交地已完成。不同批次/永久临时可各为对象，不得被“同工点”唯一约束误杀。

3.5 BIZ_PRELIMINARY_UTILITY

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
REVISION_ID	管线资料快照	Long	BIGINT	64位	否	—	PK，逻辑FK REVISION.ID，UTILITY	主键	同快照	待核对
LOCATION	迁改点位置	String	VARCHAR	300	是	—	草稿可空，提交必填	—	施工填写	待核对
UTILITY_TYPE	管线类型	String	VARCHAR	32	是	—	草稿可空，提交必填稳定类型	—	排水/通信/给水/电力/燃气/其他	待核对
OWNER_ORG_ID	产权单位标识	Long	BIGINT	64位	是	—	逻辑引用SYS_DEPT	—	已建档主体选择	待核对
OWNER_ORG	产权单位名称快照	String	VARCHAR	200	是	—	草稿可空，提交必填；有ID时服务端取名	—	业务责任主体，不授予权限	待核对
RELOCATION_METHOD	迁改方式	String	VARCHAR	32	是	—	草稿可空，提交必填一次性/临迁回迁/保护等	—	稳定字典	待核对
IMPLEMENT_ORG_ID	实施单位标识	Long	BIGINT	64位	是	—	草稿可空，提交必填逻辑引用SYS_DEPT	—	对应单位工程施工关系校验	待核对
IMPLEMENT_ORG	实施单位名称快照	String	VARCHAR	200	是	—	草稿可空，提交必填且与ID相符	—	服务端主数据	待核对

五关管线调查→迁改方案→合同签订→迁改施工→竣工移交。用户最新决定要求逐关完成，不能自动把目标关之前的实际日期或完成标记补齐。管线GIS按点，旧线状提案作废。

3.6 BIZ_PRELIMINARY_TRAFFIC

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
REVISION_ID	导改资料快照	Long	BIGINT	64位	否	—	PK，逻辑FK REVISION.ID，TRAFFIC	主键	同快照	待核对
LOCATION	导改点位置	String	VARCHAR	300	是	—	草稿可空，提交必填	—	施工填写	待核对
DIVERSION_SCOPE	导改范围	String	VARCHAR	1000	是	—	草稿可空，提交必填	—	施工填写	待核对
IMPLEMENT_ORG_ID	实施单位标识	Long	BIGINT	64位	是	—	草稿可空，提交必填逻辑引用SYS_DEPT	—	对应施工关系校验	待核对
IMPLEMENT_ORG	实施单位名称快照	String	VARCHAR	200	是	—	草稿可空，提交必填且与ID相符	—	服务端主数据	待核对

五步方案编制→审批→导改实施→占用期→恢复，计划及实际完成日期统一在STAGE_RECORD，恢复截止取恢复关计划日期，实际恢复取同关实际日期，不再另设targetActualDate/targetRestoreDate两份矛盾事实。“未恢复且今日晚于计划恢复日”派生滞后，待审恢复不改变正式状态。

3.7 BIZ_PRELIMINARY_GREENING

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
REVISION_ID	绿化资料快照	Long	BIGINT	64位	否	—	PK，逻辑FK REVISION.ID，GREENING	主键	同快照	待核对
LOCATION	地块位置	String	VARCHAR	300	是	—	草稿可空，提交必填	—	施工填写	待核对
RESPONSIBLE_ORG_ID	责任单位标识	Long	BIGINT	64位	是	—	逻辑引用SYS_DEPT	—	已建档主体选择	待核对
RESPONSIBLE_ORG	责任单位名称快照	String	VARCHAR	200	是	—	草稿可空，提交必填；有ID时与其相符	—	按主体来源登记	待核对
TRANSPLANT_LOCATION	移植地点	String	VARCHAR	300	是	—	业务阶段必填条件见需求	—	施工填写，关键变化审核	待核对

一地块一对象，明细快照一对多。五步调查→移植方案→审批→移植实施→养护移交，计划/实际日期统一在STAGE_RECORD；不保存植物类型逗号串或无单位totalQuantity。

3.8 BIZ_PRELIMINARY_STAGE_RECORD

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	阶段资料行标识	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
REVISION_ID	所属资料快照	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID	UK_STAGE_REVISION_CODE	同快照	待核对
STAGE_CODE	业务关口编码	String	VARCHAR	32	否	—	与REVISION_ID联合唯一	UK_STAGE_REVISION_CODE	类别固定阶段定义	待核对
STAGE_NO	关口顺序	Integer	INT	整数	否	—	1..4或1..5	—	服务端类别映射，不由客户端重排	待核对
PLANNED_COMPLETION_DATE	本关计划完成日	LocalDate	DATE	日	是	—	草稿可空，正式提交每关必填	IX_STAGE_PLAN	施工排计划，变更经审核	待核对
ACTUAL_COMPLETION_DATE	本关实际完成日	LocalDate	DATE	日	是	—	未完成为空；完成时必须填真实日期	—	施工逐关填写，监理审核	待核对
REMARK	本关情况说明	String	VARCHAR	1000	是	—	—	—	施工填写，关键情况随申请审核	待核对

计划日在数据库允许为空以保存不完整草稿，正式提交和批准边界要求该类别全部关口计划齐全；实际完成日仅对已申报完成的关口必填。不能为满足提交条件写假日期。

正常后续推进严格逐关：写下一关完成事实前，前置关必须有已审核实际完成日；不能凭本次选中末关就把前关自动完成。用户已确认的INITIAL历史首次导入例外：前若干关在实际业务中已完成，且每关真实计划、实际日期齐全、顺序正确时，可以在同一初始申请中送监理一次审核形成初始进度，不必重走多轮日常推进。该例外不允许日期未知、阶段断档、实际顺序倒置或自动补齐；后续UPDATE仍要求前置已审、逐关办理。COMPLETION_TYPE=IMPLIED、目标完成步数等旧提案全部移除。完成比例由已生效非空实际日期数/该类总关数派生，未完成第一关不能直接推断工程从未开展。

3.9 BIZ_PRELIMINARY_PLANT_ITEM

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	植物行快照标识	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
REVISION_ID	所属绿化快照	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID，GREENING	IX_PLANT_REVISION	服务端核对类别	待核对
PLANT_TYPE	植物类型	String	VARCHAR	32	是	—	草稿可空，提交明细必填	—	乔木/灌木/草坪/草皮/其他稳定字典	待核对
SPECIES	品种	String	VARCHAR	200	是	—	—	—	施工填写	待核对
SPECIFICATION	规格	String	VARCHAR	200	是	—	—	—	施工填写	待核对
QUANTITY	数量	BigDecimal	DECIMAL	18,4	是	—	草稿可空，提交必填且大于0	—	施工填写、监理审核	待核对
UNIT	计量单位	String	VARCHAR	20	是	—	草稿可空，提交必填平台适用单位	—	明确登记，不随类型擅自换算	待核对
SORT_NO	行顺序	Integer	INT	整数	否	0	—	—	表单顺序	待核对

同地块不同植物、同类型不同规格均可保留明细，展示按类型＋单位分组，株和平方米不能相加。工程量变化进入完整变更快照，不能直接修改APPROVED子行。

3.10 BIZ_PRELIMINARY_ATTACHMENT_REF

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	附件引用行标识	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
REVISION_ID	所属资料快照	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID	IX_FILE_REVISION	同快照	待核对
FILE_ID	文件服务对象标识	Long	BIGINT	64位	否	—	逻辑引用OSS，实际ID类型复核	—	平台上传返回，不收任意URL	待核对
FILE_PURPOSE	附件用途	String	VARCHAR	32	否	—	GENERAL/PERMIT/BLOCKER	—	业务场景确定	待核对
BLOCKER_KEY	关联稳定卡点键	String	VARCHAR	64	是	—	BLOCKER用途必填，同快照卡点存在	IX_FILE_BLOCKER	从卡点行绑定，不写闭环资料	待核对
SORT_NO	显示顺序	Integer	INT	整数	否	0	—	—	表单顺序	待核对

PERMIT通过ATTACHMENT_REF_ID关联PERMIT用途行，不再另存同份FILE_ID。文件实体归平台服务，不存公开下载URL。快照复制只复制引用，不能复制实体；移除工作稿附件不立即删除原OSS文件，取消不丢已引用文件，SUBMITTED/APPROVED引用不覆盖。审批成功后的GIS发布ID、进度源问题ID属于集成结果元数据，只能由受控服务回填，不允许借回填修改已冻结业务内容。

3.11 BIZ_PRELIMINARY_PERMIT

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	手续附件资料行	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
REVISION_ID	所属资料快照	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID	IX_PERMIT_REVISION_EXPIRY	同快照	待核对
ATTACHMENT_REF_ID	手续证明附件引用	Long	BIGINT	64位	否	—	同快照PERMIT用途，单行唯一	UK_PERMIT_FILE	从本次手续附件选择	待核对
ATTACHMENT_LABEL	手续附件名称或说明	String	VARCHAR	200	是	—	仅用于识别资料	—	文件名或施工说明，不形成证照主数据	待核对
EXPIRY_DATE	本份手续有效截止日	LocalDate	DATE	日	是	—	已提供有效期则必须为真实日期	IX_PERMIT_REVISION_EXPIRY	每份分别填写、随附件审核	待核对

用户已确认可有多份手续、每份独立截止日，本功能只做辅助审核附件及有效期，不建设证号、发证单位、签发日期、续期台账或外部办件系统；旧PERMIT_NUMBER/ISSUING_ORG/ISSUE_DATE/VALIDITY_TYPE等扩张提案移除。

未上传手续仍允许进度维护与送审，但台账应飘红提示资料未齐；已上传而有效期未提供不能假判永久有效，应显示有效期待补。今日在截止日前30自然日内（含截止日）提示临期，截止日次日及以后过期；仅当前功能预警，不加入首页预警。提醒从已生效附件与期限计算，待审资料可提示尚未生效，不能用待审新日期消除正式过期。

3.12 BIZ_PRELIMINARY_BLOCKER

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	卡点资料快照行	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
REVISION_ID	所属资料快照	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID	UK_BLOCKER_REVISION_KEY	同快照	待核对
ISSUE_KEY	前期卡点稳定业务键	String	VARCHAR	64	否	—	与REVISION_ID联合唯一	UK_BLOCKER_REVISION_KEY	首次录入生成，后续快照沿用	待核对
DESCRIPTION	难点卡点描述	String	VARCHAR	2000	否	—	—	—	施工录入，当前监理可修订	待核对
SOURCE_ISSUE_ID	对应进度问题库标识	Long	BIGINT	64位	是	—	逻辑引用问题库，实际类型复核	IX_BLOCKER_SOURCE	通过受控接收接口返回；新问题未同步可空	待核对

没有卡点不写占位空行；同对象可多卡点。附件用ATTACHMENT_REF.BLOCKER_KEY关联。监理修订保留施工SUBMITTED描述和附件，修改后的工作稿经当前审核生效；这项权限不扩为可直接修改其他已提交关键资料。

进度问题库是督办、上报及闭环的权威，本表只保存前期源资料审核版本。审核通过后以“来源模块＋OBJECT_ID＋ISSUE_KEY”写入/更新同一问题库问题；更新只包含获准的源描述/附件及工程关联，不重置建设单位已维护的督办、上报和闭环字段。不能仅保存本地SOURCE_ISSUE_ID就声称互通成功。

现有代码未发现可直接使用的通用问题库服务，必要的进度侧接收、精确关联与反馈属于待实施集成，不得伪造源ID或成功结果。问题库实际表结构由进度模块维护；本矩阵不冒充其当前DDL，也不在前期扩建完整督办流程。集成失败须可见并满足审批一致性方案，实际联调前不得称整体开发完成。

3.13 BIZ_PRELIMINARY_GIS_DRAFT

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	空间送审资料行	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
REVISION_ID	所属资料快照	Long	BIGINT	64位	否	—	逻辑FK REVISION.ID	IX_GIS_REVISION	同快照	待核对
SPATIAL_KEY	跨快照空间对象稳定键	String	VARCHAR	64	否	—	与REVISION_ID联合唯一	UK_GIS_REVISION_KEY	新图形生成，变更沿用	待核对
GEOMETRY_TYPE	几何类型	String	VARCHAR	20	否	—	征地POLYGON，其余POINT	—	按用户最新决定校验	待核对
GEOMETRY_WKT	待审几何	GeometryValue	CLOB	受平台合法几何及大小校验	否	—	合法点/面，有限坐标、面闭合等	—	施工通过受控采集/编辑形成，不是任意业务JSON	待核对
CRS_CODE	几何坐标系	String	VARCHAR	32	否	—	沿平台稳定码EPSG_3857（坐标系EPSG:3857）	—	由采集转换服务确定，不把经纬度冒充平面坐标	待核对
LAYER_ID	目标业务图层	Long	BIGINT	64位	否	—	逻辑引用GIS图层，同范围且有权	—	施工选择可用图层，监理复核	待核对
EXISTING_FEATURE_ID	变更前已发布要素	Long	BIGINT	64位	是	—	逻辑引用当前有效GIS要素	IX_GIS_FEATURE	新采集为空，修改时服务端核实	待核对
EXPECTED_REVISION	GIS既有修订条件	Long	BIGINT	64位	是	—	修改既有要素时按GIS契约必填	—	现有要素接口读得，不新建前期并发锁	待核对
PUBLISHED_FEATURE_ID	审核发布后要素标识	Long	BIGINT	64位	是	—	逻辑引用GIS正式要素	IX_GIS_PUBLISHED	发布成功返回，待审不伪填	待核对

空间几何送审快照用于保留施工申请和监理复核依据，正式地图几何及业务绑定仍由GIS维护。等待审核时不得发布/覆盖正式地图；退回不改变旧要素；通过后受控发布并绑定PRELIMINARY_OBJECT，保留已有PROJECT/SITE/BID绑定与expectedRevision保护。

当前GIS只有要素查询、属性/绑定维护，几何编辑未开放；因此施工点/面维护需要补齐采集、校验、送审预览和审核发布接入，不能只加一个GIS ID字段。已有图层显隐能力优先复用，不新增第二套可见性配置事实。图层控制不能改变审核状态或把待审图形当正式成果。

候选WKT的CRS_CODE=EPSG_3857；GIS正式GEOMETRY_JSON沿既有地图契约保存EPSG:4326 GeoJSON，发布时转换且bbox为经纬度。不能把3857米坐标直接写正式JSON，也不重复高德偏移。SOURCE_TYPE=PRELIMINARY与绑定类型PRELIMINARY_OBJECT分开；业务图层补来源分类，其DRAWING_ID/DRAWING_VERSION_ID允许为空的必要实际变更由GIS矩阵和MCP核实，不伪造CAD来源。

新工作稿克隆空间时，以旧PUBLISHED_FEATURE_ID（或既有要素ID）解析本轮EXISTING_FEATURE_ID，并读取GIS当前EXPECTED_REVISION；仅几何/图层变化才发布，未改空间的普通计划修订沿用原要素。新提交/审核快照保留这份本轮基线；成功结果元数据回填不能变成修改冻结几何的后门。

GIS业务来源必须在图层/场景目录、bbox/数量、地图读取、要素分页/详情/导出、发布更新及绑定反查各处有明确分支，不能只加SOURCE_TYPE后仍强制内连接图纸当前版本。前期来源执行真实单位工程pair和业务权限，CAD保持现有图纸版本和工点共享策略；通用GIS编辑不能绕过前期审核修改业务要素。具体改动清单见详细设计。本十四表不代替GIS既有表的实际差异矩阵。

3.14 BIZ_PRELIMINARY_IMPORT_DUPLICATE

字段	中文含义	逻辑类型	物理类型	长度/精度	空	默认	键/约束	索引	来源/生成规则	核验状态
ID	疑似重复判断行	Long	BIGINT	64位	否	—	PK	主键	服务端雪花ID	待核对
CHANGE_ID	所属导入审核申请	Long	BIGINT	64位	否	—	逻辑FK CHANGE.ID	IX_DUP_CHANGE	合法候选导入后关联	待核对
SUBMITTED_REVISION_ID	本次判断对应施工提交快照	Long	BIGINT	64位	是	—	送审确认时必填，同申请SUBMITTED	IX_DUP_CHANGE	草稿预检查可空；每次提交绑定本轮快照	待核对
MATCHED_REVISION_ID	库内候选资料快照	Long	BIGINT	64位	是	—	MATCHED_OBJECT_ID所属可读快照	—	保存此次比较的真实候选，避免只凭对象ID重现错误差异	待核对
IMPORT_ROW_NO	导入主表行号	Integer	INT	整数	否	—	大于0	—	模板解析，用于提示	待核对
MATCHED_OBJECT_ID	疑似相同的已有对象	Long	BIGINT	64位	是	—	逻辑FK OBJECT.ID，同单位工程/类别	IX_DUP_MATCH	库内候选；文件内候选可空	待核对
MATCHED_ROW_NO	文件内疑似行号	Integer	INT	整数	是	—	与已有对象至少一项有值	—	文件内比较结果	待核对
MATCH_REASON	命中识别信息说明	String	VARCHAR	1000	否	—	—	—	同单位工程同类别名称/编号/位置等相同	待核对
DIFFERENCE_SUMMARY	差异摘要	String	VARCHAR	2000	否	—	—	—	从强类型资料比较生成，不作为任意字段事实源	待核对
REVIEW_RESULT	监理判断结果	String	VARCHAR	20	否	PENDING	PENDING/KEEP_NEW/REJECT	—	当前监理明确确认	待核对
REVIEW_COMMENT	监理判断说明	String	VARCHAR	1000	是	—	拒绝或需解释时填意见	—	当前监理输入	待核对
REVIEWED_BY	判断人	Long	BIGINT	64位	是	—	逻辑引用用户，须有效监理	—	服务端身份	待核对
REVIEWED_TIME	判断时间	LocalDateTime	TIMESTAMP	同审计列	是	—	—	—	判断动作生成	待核对

完全重复按业务字段一致性判定，排除系统生成ID、审计时间、流程状态等技术字段；比较包含单位工程、类别及该对象本次实际填报的分类资料、阶段、植物等业务内容。完全相同行拒绝导入并报告行号，不创建申请或疑似表行。精确比较集合及文件引用比较语义在实际模板/DTO定稿时记录，不凭单个名称判断“全部一致”。

部分重复采用用户已确认口径：同单位工程、同类别，且对象名称/编号/位置等识别信息相同，但其他资料不同，提示差异并送监理确认；仅线路、单位、类型相同不算。不同批次及永久/临时拆条是允许的，不得设同工点单条唯一约束。监理确认保留新记录或拒绝，不擅自覆盖/合并已有台账；存在未决定候选时不得审核通过。文件内、库内比较均执行同工程权限，候选不向无权用户泄露。文件内MATCHED_ROW_NO始终相对CHANGE.IMPORT_FILE_ID对应原文件，审核可回看实际候选及差异，不依赖已丢失的临时预检查结果。

退回重提属于正常业务链路：每次正式提交重新比较并为当前SUBMITTED_REVISION_ID形成判断行，REVIEW_RESULT从PENDING开始；旧轮次结论留存，不沿用或覆盖。审核通过只接受与当前提交快照及当前有效候选相对应的明确确认；修改计划/数量后不得拿上一轮KEEP_NEW放行。

重新比较显式排除当前OBJECT_ID及其全部快照，避免导入对象已落库后首提/重提命中自身。每个其他对象只比较当前生效版及有效未结束申请当前候选，不扫描全部历史版本。文件内按原主表行号保留首个合法候选，后续完全相同行拒绝；不把相同两行互判后全拒绝。跨快照业务行的主键及排序不参与语义相等，实际文件引用按受控文件身份比较，不能只用文件名认定相同内容。

4. 约束、索引和派生值

名称/约束	列	目的
各表主键	独立表ID；四扩展REVISION_ID	身份及分类一对一
UK_OBJECT_CODE	OBJECT(OBJECT_CODE)	系统编号唯一，不代替全字段查重
IX_OBJECT_UNIT	OBJECT(UNIT_PROJECT_ID,OBJECT_TYPE)	单位工程内四类台账查询
IX_OBJECT_SCOPE	OBJECT(LINE_ID,BID_ID,SITE_ID)	已核验工程组合过滤
IX_REVISION_OBJECT / IX_REVISION_CHANGE	REVISION(OBJECT_ID) / (CHANGE_ID)	生效及送审历史
IX_CHANGE_OBJECT_STATUS / IX_CHANGE_INSTANCE	CHANGE(OBJECT_ID,FLOW_STATUS) / (FLOW_INSTANCE_ID)	申请及流程回写定位
UK_STAGE_REVISION_CODE	STAGE_RECORD(REVISION_ID,STAGE_CODE)	每份资料每关一行
IX_STAGE_PLAN	STAGE_RECORD(STAGE_CODE,PLANNED_COMPLETION_DATE)	当前生效关口滞后查询，实际计划核对
IX_LAND_BATCH / IX_LAND_DISTRICT	LAND(DELIVERY_BATCH) / (ADMIN_DISTRICT)	分类查询，不新增独立指标看板
IX_PLANT_REVISION / IX_FILE_REVISION	PLANT_ITEM(REVISION_ID) / ATTACHMENT_REF(REVISION_ID)	明细与附件加载
IX_FILE_BLOCKER	ATTACHMENT_REF(REVISION_ID,BLOCKER_KEY)	卡点附件
UK_PERMIT_FILE	PERMIT(ATTACHMENT_REF_ID)	每份手续附件一份期限资料
IX_PERMIT_REVISION_EXPIRY	PERMIT(REVISION_ID,EXPIRY_DATE)	当前功能到期提示
UK_BLOCKER_REVISION_KEY / IX_BLOCKER_SOURCE	BLOCKER(REVISION_ID,ISSUE_KEY) / (SOURCE_ISSUE_ID)	稳定源问题关联
UK_GIS_REVISION_KEY / IX_GIS_REVISION	GIS_DRAFT(REVISION_ID,SPATIAL_KEY) / (REVISION_ID)	空间送审及发布定位
IX_GIS_FEATURE / IX_GIS_PUBLISHED	GIS_DRAFT(EXISTING_FEATURE_ID) / (PUBLISHED_FEATURE_ID)	已有/新发布要素追溯
IX_DUP_CHANGE / IX_DUP_MATCH	IMPORT_DUPLICATE(CHANGE_ID) / (MATCHED_OBJECT_ID)	监理疑似判断与源对象

不为“所有业务字段相同”创建包含CLOB/多子表的巨型唯一索引。按真实数据量在Service批量比较完整资料；确需摘要索引应有实际成本收益证据且仍复核业务字段，不先建立哈希查重平台。面积范围、日期先后、逐关顺序、申请快照归属及候选确认在服务端边界校验，适合且实际支持的CHECK可以表达同一规则。

阶段完成数、百分比、当前关口、亩面积、交地率、逾期天数和资料缺失标记均派生；待审核不进入正式完成率。跨模块指标分析和汇总看板本期不实现，后续在指标看板统一梳理；不以此为由删除本功能内的阶段展示、交地面积率及飘红提示。

5. 跨模块持久化责任

• 单位工程、施工/监理组织和人员为平台事实，前期只保存关联及必要快照，不新建授权表、组织或账号。
• 文件实体归文件服务；本表引用经审核资料，不复制公开URL或全量文件元数据。监理卡点修改必须保留施工原始提交附件。
• 卡点源描述/附件由施工录入、监理可修订，已审核版本互通进度问题库；督办、上报和闭环由建设单位在进度模块维护，前期不复制并覆盖这些办理字段。
• 手续仅本功能附件和每份有效期，不再依赖工程手续有效期接口作为本期前置条件；缺手续可推进但飘红，不能自动阻断。
• GIS发布及正式图层/要素归GIS；前期保存送审版本和发布关联。正式绑定不能由工作稿提前覆盖，图层显隐沿用平台机制。
• 流程实例、任务和审核历史归Warm-Flow；前期保留申请及资料快照，拒绝无任务人员直接改流程状态。

6. 结构核对与实施记录

对象	设计状态	实际状态	实施核验证据
14表全部业务列＋五审计列	本文定义	开发库已建立并回读通过	达梦 MCP 执行 DDL 并回读全部 14 表与索引，列类型与可空性完全匹配
UnitProject及标段单位关系	源码确认真实单位工程上下文与pair授权机制	已配置测试标段与回读核查	土建01标关联北京城建施工与大西南监理，02标关联道桥施工与智通监理
首次/变更审核快照	本文定义	已实现并通过单测	PreliminaryRevisionServiceTest、PreliminaryWorkflowIntegrationTest
逐关计划/实际及INITIAL历史例外	用户已决定	已实现并通过单测	PreliminaryStageRulesTest 6项用例全部通过
部分重复判断	用户已决定口径	已实现并通过单测	PreliminaryImportServiceTest 4项用例全部通过
进度卡点互通	必要接收及字段所有权设计	已实现并通过单测	ProgressDifficultySourceServiceTest 2项用例全部通过
GIS采集/审核发布	几何编辑补齐能力，来源分支明确	已实现并通过单测	GisPreliminaryFeatureServiceTest 4项用例全部通过
普通结构生产发布	本轮未执行→2026-11-11 已同步	生产库 17 张表（14 前期 + 3 进度卡点）经纳管入口建表并回读	2026-11-11 用户授权发布：PROD 建表 17 张；菜单 28 条与 DEV 结构一致（前期管理 5 个结构菜单与 20 个按钮权限挂普通管理员；工程进度监管→进度纠偏→难点卡点问题库按 DEV 层级建立，与 DEV 相同仅超管可见）；4 流程 NODE_RATIO 由 NULL 修正为 0（16 行）；两库菜单按名称/父级/类型/路径/组件/权限/排序/显隐/缓存归一化对比 0 差异后回读；前后端发布至 releases/20261111-0145-preliminary。首轮误将难点卡点挂到前期管理，已在生产库删除错挂行并按 DEV 原 ID 重建

所有数据库工作走dcp-dm8-dev或.agents/mcp/launch.ps1，写前核环境与对象、写后回读；DML报告实际影响行数，DDL核对对象。不新增业务.sql，不外部直连，不清空共享对象，不根据旧文档删除任何存量表。

DM8为当前运行建议，VARCHAR字节/字符长度、TIMESTAMP精度、CLOB读取和索引限制须以实际实例核验。面向人大金仓、openGauss等保持逻辑模型，厂商差异放适配边界，不把DM8专属DDL/函数写成业务规则，也不提前实现未使用厂商的多套适配。

7. 关联资料

需求分析 · 概要设计 · 详细设计 · 测试与验收 · 操作手册。字段矩阵与本轮明确业务回复同属首次1.00资料收敛，不表示任何运行路径已实现或验证通过。