交开投数智建管平台

主题

GIS引擎底座 数据库设计文档 ​

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

2026-11-10 前期业务空间接入变更：开发库（DM8）通过项目专用 MCP 纳管入口调整 GIS_FEATURE.DRAWING_ID 与 GIS_LAYER.DRAWING_ID 为可空（前期人工业务空间分支无 CAD 图纸），在 GIS_LAYER 增加 LAYER_CATEGORY VARCHAR(32) 列组织业务分类图层；业务绑定类型注册 PRELIMINARY_OBJECT。

字段中文含义参考 2026-11-02 开发库、生产库只读回读的字段注释及原有业务资料；历史物理结构、核验日期和设计差异仍以各表原记录为准。 2026-11-02 双库结构核对：开发库已删除 GIS_AUTH_SUBJECT、GIS_FEATURE_SOURCE、GIS_PROFESSION_GRANT、GIS_SAVE_REQUEST，生产库原无这四张表；两库各有 14 张 GIS 表。生产库补齐 18 个已有开发库索引，字段属性和索引列组合经双库回读一致。

本文件维护 GIS 的实际结构基线、目标完整字段、关系、约束及迁移设计。页面与服务语义见详细设计，业务规则以需求分析为准，架构见概要设计。

2026-10-23 实施历史：开发库现有 18 张 GIS_ 表。旧全局转换方案、旧控制点和本期 GIS 专题已整套退出；图纸级配准镜像、旧源目标坐标、旧转换参数和场景默认专题等 29 个列已物理删除。配准事实只在 GIS_DRAWING_VERSION.GEOREF_CONFIG/GEOREF_REVISION；标准坐标定义收敛为内部目录；底图仍为三条启用记录并关联 EPSG_3857。2026-10-24 生产发布已同步 GIS 新路线 14 张表 DDL 与基础数据（来源：2026-10-24 发布记录；该轮未重新核验生产，下文历史章节中的“待核对/未建”仅代表当时状态）。该段为当时记录，当前物理基线以本页 2026-11-02 双库回读为准。

2026-10-23 其他事实：GIS_BASEMAP_SERVICE 的 CREDENTIAL_VALUE 保存天地图浏览器 Key 明文，管理接口不回显、运行接口按服务下发；GIS_DRAWING_VERSION.SOURCE_STORAGE_PATH 新记录保存 oss: 对象键；上传上限、解析超时、高德城市由平台 SYS_CONFIG 保存。

2026-10-25 简化优化：本期未新增、修改或删除表/列。台账五态、主按钮、状态说明和场景空态均为查询侧派生字段；全线站点锚点的线路名/站点名/顺序写入既有 GIS_DRAWING_VERSION.GEOREF_CONFIG 的控制点数组。旧 VERIFIED 数据不迁移，界面统一显示“已定位（参考）”。

1. 设计范围与核验状态 ​

项目内容
实现范围说明2026-11-02 双库各有 14 张 GIS 表：3 张既有扩展表、11 张其他表；GIS_LAYER_SOURCE_MAP、GIS_SOURCE_ENTITY 为目标设计。四张退役表已在开发库删除、生产库原不存在；此前退役表列变更见 §1.3。
数据库当前 DM8；保留结构按实际开发库记录，不依赖空间扩展或新增数据库
实际结构核验经项目纳管入口回读开发库、生产库表、字段和索引
核验范围双库 GIS 与质量模块的表、字段属性、字段注释及索引列组合；未检验业务文件或几何内容
实体与映射证据GisDrawing、GisLayer、GisDrawingVersion、GisCadTask、GisDrawingScope、配置/授权/要素实体及当前工作树映射
数据库核验状态2026-11-02 开发库、生产库结构已回读
交付数据库基线本轮未取得可恢复备份/导出包，未核对正式交付备份；实际库读取不冒充交付数据库验证
本轮交付开发库删除四张退役表，生产库补齐 18 个 GIS 索引；双库回读验证，未发布应用

1.1 物理事实 ​

表实际列数已核对索引/约束
GIS_DRAWING26DRAWING_ID 主键；IDX_GIS_DRAWING_LINE(LINE_ID)；IDX_GIS_DRAWING_CURRENT(CURRENT_VERSION_ID)
GIS_LAYER30LAYER_ID 主键；IDX_GIS_LAYER_DRAWING(DRAWING_ID)；IDX_GIS_LAYER_LINE(LINE_ID)；IDX_GIS_LAYER_VERSION(DRAWING_VERSION_ID)
GIS_FEATURE30FEATURE_ID 主键；图层/drawing 普通索引；bbbox 为普通组合索引
其他 11 表见 §3主键及实际索引已回读；§4.1 另含目标设计
GIS 表合计开发 14 / 生产 142026-11-02 双库回读；GIS_LAYER_SOURCE_MAP、GIS_SOURCE_ENTITY 仍为设计未建

三个主键的系统生成约束/索引名称不作为应用契约。实际未发现三表间的物理外键；现有 bbox 索引是普通组合索引，不能称为空间索引。

1.2 公共字段与类型约定 ​

  • 主键使用平台雪花 BIGINT；前端保持 string | number 原值。专业字典 ID 是 VARCHAR(64)，专业引用优先保存 MAJOR_CODE，不把专业 ID 转为 Long。
  • 表中可空和默认值为目标定义；现有列的核验栏同时给出真实库的可空/默认，差异须先迁移再收紧。“—”表示无数据库默认值，不代表字符串或自动填充。
  • 新表每张均完整列出 BaseEntity 的五个持久化审计字段；不可变记录建成时填完整审计，业务内容只追加。无租户/独立组织隔离/工作流需求，不新增 tenant_id、流程 ID 等无来源字段。
  • 逻辑删除仅用于适用的资产/配置/授权。版本、任务、源语义及修订记录不因普通删除物理级联移除；常规页面不提供物理清理功能。
  • VARCHAR 长度沿 DM8 字段定义记录；旧列回读值为 DATA_LENGTH。涉及中文长度和跨库字符/字节语义，实施前再核对 CHAR_LENGTH/CHAR_USED 与样本，不能以 UI 字数校验代替数据库长度校验。
  • CLOB 是目标大文本载体；JSON 字段必须有固定结构和大小/深度/数量限制，不能承载任意 SQL、脚本或无约束的业务关联。精度与规模上限按需求 Q-GIS-007 冻结。
  • LFK 表示逻辑外键：同模块服务事务校验，跨模块由真实 API 契约验证；本设计不假定已建立物理外键。禁止级联删除外部业务与文件。PK/UK 的目标约束需实际建库后回读。
  • I_SCOPE/I_QUEUE 等为下文的目标索引类别。UK1 表示本表内注明 UK1 的列构成一个联合唯一约束，不能按单列分别唯一。
  • 当前存量审计列允许空的事实保留在矩阵中；新写入必须填充，存量未核实前不臆造创建人或无条件批量改历史。

1.3 2026-10-23 结构变更与回读 ​

对象变更回读结果
GIS_BASEMAP_SERVICE新增 CREDENTIAL_VALUE VARCHAR(512)；两条天地图记录写入浏览器 Key列存在；两行长度 32（Key 值不入库文档）
GIS_SCENE新增 SYSTEM_DEFAULT 记录（PUBLIC、ENABLED，中心 106.5516,29.5630，zoom 13，1–18）记录与视图 JSON 回读一致
GIS_SCENE新增 LAYER_SCOPE、ALL_LAYER_VISIBLE_FLAG、ANNOTATION_VISIBLE_FLAG 及三个 CHECK；SYSTEM_DEFAULT 改为 线网地图、ALL、打开时全部显示、注记关闭、FIT_ENGINEERING；开发/生产均补齐三条允许底图关系2026-10-26 开发/生产逐列回读：列、默认值、约束、场景行、三条服务关系一致；生产原无 GIS_SCENE 行，按同一口径新建
GIS_DRAWING_VERSION.SOURCE_STORAGE_PATH新记录保存 oss:gis/versions/<versionId>.<ext>本轮重置前的三条历史版本已完成对象存储迁移并回读；重置后新上传继续写 oss: 路径
SYS_CONFIG新增 gis.cad.max-file-size-mb=100、gis.cad.worker-timeout-seconds=900、gis.georef.amap-city=重庆三条回读一致
GIS_DRAWING_VERSIONCOORDINATE_PIPELINE、GEOREF_CONFIG、GEOREF_REVISION；新版本固定 AMAP_V2列存在；退役后无旧版本数据；新上传回读原始清单引用、pipeline 和 revision 0
GIS_LAYERDRAWING_VERSION_ID BIGINT 可空 + IDX_GIS_LAYER_VERSION 普通索引列和索引回读存在；新写入绑定版本
对象存储原始清单 oss:gis/attempts/<attemptId>/cad-raw-v2.json；派生清单 oss:gis/versions/<versionId>/georef/<revision>/display-v2.json；均保存 SHA-2562026-10-23 清理后真实页面上传合成 DXF：原始清单 7 图元/3 层，派生清单 3 层/7 图元；保存 revision 1、确认 2、重配准 3、清除后的配置只保留原始清单引用
GIS_CAD_TASK新增唯一索引 UK_GIS_TASK_USER_REQUEST(CREATE_BY, REQUEST_ID)先查重（0 组重复）后创建；回读为 UNIQUE
GIS_DRAWING_VERSION新增唯一索引 UK_GIS_VER_DRAWING_NO(DRAWING_ID, VERSION_NO)先查重（0 组重复）后创建；回读为 UNIQUE
SYS_MENU / SYS_ROLE_MENU删除“坐标系与转换方案”“坐标方案校准”及 9 个专属按钮权限菜单 11 行、角色关联 22 行已删除；回读无残留
退役表/列删除 GIS_TRANSFORM、GIS_CONTROL_POINT、GIS_TOPIC、GIS_SCENE_TOPIC；删除 29 列系统目录回读：4 表不存在、29 列不存在；18 张保留表存在；多次重启未重建

GEOREF_CONFIG 保存原始清单引用、点对、方法、归一化、参数、残差、派生清单引用、保存/确认人及修订。GEOREF_REVISION 是配置/状态修订，不等于派生几何版本；确认只推进该修订并继续引用原派生对象。图纸资产不再保存配准镜像，列表摘要从 CURRENT_VERSION_ID 对应版本读取。

2. 对象关系与关键不变量 ​

  1. 源文件属于图纸版本，图纸资产只维护当前有效版本指针。唯一当前由 GIS_DRAWING.CURRENT_VERSION_ID 表达，不靠多行“当前=是”维持唯一。
  2. 版本的候选/当前/历史由就绪情况、当前指针和曾生效时间组合表达；READY_STATUS 只表达技术检查，不创建审批状态。
  3. 一个处理尝试固定源摘要、坐标方案、专业映射和解析器版本。重试新建尝试，旧尝试输出不可覆盖新的版本引用。
  4. 源图元在尝试内定位；handle 在不同版本间不保证稳定，块展开/合并通过派生键及关系表追溯。缺项与失败仍出现在受控报告中。
  5. GIS_LAYER 是目标业务层。当前每图纸一组源层的实现先保留 ID，再通过 GIS_LAYER_SOURCE_MAP 显式映射，不把“原层名=专业名”作为授权依据。
  6. GIS_FEATURE 保持稳定业务 ID；GIS_FEATURE_REVISION 保存不可变几何/人工覆盖/归属快照，原来源关系表 GIS_FEATURE_SOURCE 已退役并删除，后续来源设计须重新确定。绑定属于修订快照，换版确认同一业务对象后保留要素 ID。
  7. 图纸版本选择的要素修订由 GIS_DRAWING_VERSION_FEATURE 表达。有效版编辑时更新选用修订；版本成为历史后冻结集合。候选要素不得仅因写入表就被普通地图查询返回。
  8. 生效切换、要素当前修订、兼容缓存、来源/覆盖/绑定及版本集合在短事务中一致更新。源对象一对多/删除/冲突未处理时不能自动重绑或切换。
  9. 公共定义与工程内容分开。工程配置用显式 RESOURCE_TYPE/LINE_ID/BID_ID/SITE_ID/MAJOR_CODE 列，便于 SQL 中先鉴权再分页；JSON 元数据不能充当可绕过的授权条件。
  10. 授权以同一完整工程单元及专业判断。指定文件整体检查授权与普通专业许可分开，仍受文件所有工程范围上限约束，不能据此整包下载。
  11. 普通读取通过当前有效版本及当前授权；历史查看走明确历史 ID 与当前访问检查，不能用当前覆盖拼接历史图纸。
  12. 对任务、源文件、派生文件均建立业务资源绑定；原 kkFileView 预览链路已于 2026-10-24 退役，预览不再构成访问面。SYS_OSS 文件 ID 不能成为绕过 GIS 鉴权的访问入口。

普通地图的有效集合有明确条件：CAD 来源必须属于资产当前有效版本所选的要素修订，人工来源必须有已成功保存的当前修订；再排除删除修订、隔离状态和无权记录。不能仅以 GIS_FEATURE 存在或 DEL_FLAG=0 作为正式分发条件。候选阶段为新业务对象预留的稳定 ID 不对普通地图公开，已存在要素的候选修订也不提前替换其当前指针。

图层和文件的统计按当前用户可读有效集合计算；后台检查统计与普通地图数量分开，不能从候选/失败源对象数推断可公开数量。

2.1 已核对的上游标识 ​

来源本设计关联字段必须保持的契约
BIZ_LINE.LINE_IDLINE_ID BIGINT线路名称只作展示
BIZ_SITE_MASTER.SITE_MASTER_IDSITE_ID BIGINTGIS 的 SITE_ID 指向该物理主键，不猜作 SITE_ID 列
BIZ_BID_SECTION.BID_IDBID_ID BIGINT与工点构成有效组合，PROJECT_ID 不代替工程授权
BIZ_UNIT_PROJECT.UNIT_PROJECT_IDUNIT_PROJECT_ID BIGINT标段/工点/专业一致
BIZ_MAJOR_DICT.ID / MAJOR_CODEMAJOR_CODE VARCHAR(64)字典 ID 也是字符串；综合/子专业关系不自动继承权限
BIZ_USER_ENGINEERING_CONFIG/LINE/PAIRAPI 提供工程范围，不复制表GIS 不修改上游范围或复制弱化授权 SQL
SYS_OSS.OSS_ID*_OSS_ID BIGINT 逻辑引用实际 OSS_ID 为 NUMBER，使用平台 Long 契约；不公开存储地址

上游表不在本轮改表范围；用户主键按现有平台 SYS_USER.USER_ID 契约引用，实施前随用户选择器和约束再核对。未读取上游业务记录，不宣称授权配置或控制点已存在。

3. 目标完整字段矩阵 ​

下列 3 张既有表按实际库列示保留列和新增列；保留的 15 张新表以开发库实际结构为准，GIS_LAYER_SOURCE_MAP、GIS_SOURCE_ENTITY 仍为设计。2026-10-23 退役的 GIS_TRANSFORM、GIS_CONTROL_POINT、GIS_TOPIC、GIS_SCENE_TOPIC 不再属于目标结构。矩阵中的“待核对”表示生产未建或未逐列回读，不代表开发库缺失。

3.1 GIS_DRAWING（既有表扩展） ​

图纸资产不保存配准参数、状态或修订镜像；当前配准状态和摘要从 CURRENT_VERSION_ID 对应版本读取。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
DRAWING_ID图纸资产ID/兼容来源引用64位整数 → BIGINT8字节否—PK已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，非空，默认无
DRAWING_CODE图纸编码字符串 → VARCHAR(64)64否—目标 UK，当前无已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(64)，非空，默认无
DRAWING_NAME图纸名称字符串 → VARCHAR(200)200否——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(200)，非空，默认无
LINE_NAME旧线路名称快照，不能鉴权字符串 → VARCHAR(100)100是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(100)，可空，默认无
SITE_ID物理工点引用64位整数 → BIGINT8字节是——已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，可空，默认无
SOURCE_FILE_NAME源文件名兼容快照字符串 → VARCHAR(255)255是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(255)，可空，默认无
SOURCE_FORMAT格式兼容快照字符串 → VARCHAR(16)16是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(16)，可空，默认无
SOURCE_SHA256源摘要兼容快照摘要 → CHAR(64)64是——已有源快照/配置；真实关联按服务端校验已按实际库核对：CHAR(64)，可空，默认无
SOURCE_SIZE源大小兼容快照64位整数 → BIGINT8字节是——已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，可空，默认无
IMPORT_STATUS旧同步导入结果兼容字段字符串 → VARCHAR(24)24否——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(24)，非空，默认无
FEATURE_COUNT派生要素数32位整数 → INT4字节是0—来源/当前修订派生，缓存不作权限依据已按实际库核对：INT，可空，默认0
LAYER_COUNT派生图层数32位整数 → INT4字节是0—来源/当前修订派生，缓存不作权限依据已按实际库核对：INT，可空，默认0
BBOX_MIN_LON最小经度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MIN_LAT最小纬度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MAX_LON最大经度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MAX_LAT最大纬度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
ERROR_MESSAGE脱敏失败信息字符串 → VARCHAR(1000)1000是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(1000)，可空，默认无
REMARK备注字符串 → VARCHAR(500)500是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(500)，可空，默认无
CREATE_DEPT创建部门64位整数 → BIGINT8字节是——服务器审计填充已按实际库核对：BIGINT，可空，默认无
CREATE_BY创建主体64位整数 → BIGINT8字节是——服务器审计填充已按实际库核对：BIGINT，可空，默认无
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度是——服务器审计填充已按实际库核对：TIMESTAMP，可空，默认无
UPDATE_BY更新主体64位整数 → BIGINT8字节是——服务器审计填充已按实际库核对：BIGINT，可空，默认无
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度是——服务器审计填充已按实际库核对：TIMESTAMP，可空，默认无
DEL_FLAG逻辑删除标志 → CHAR(1)1否'0'CHECK已有源快照/配置；真实关联按服务端校验已按实际库核对：CHAR(1)，非空，默认'0'
LINE_ID线路主键64位整数 → BIGINT8字节是—I_SCOPE工程主数据待核对：新增目标列，实际库无此列
BID_ID专属标段主键64位整数 → BIGINT8字节是—I_SCOPE有效组合待核对：新增目标列，实际库无此列
RESOURCE_TYPE工程资源类别字符串 → VARCHAR(24)24否QUARANTINEDCHECK服务器归属判定待核对：新增目标列，实际库无此列
CURRENT_VERSION_ID当前有效图纸版本64位整数 → BIGINT8字节是—LFK GIS_DRAWING_VERSION原子切换待核对：新增目标列，实际库无此列
REVISION资产并发修订64位整数 → BIGINT8字节否0乐观锁服务器递增待核对：新增目标列，实际库无此列

3.2 GIS_LAYER（既有表扩展） ​

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
LAYER_ID业务图层主键/引用64位整数 → BIGINT8字节否—PK已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，非空，默认无
DRAWING_ID图纸资产ID/兼容来源引用64位整数 → BIGINT8字节是—LFK/索引已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，非空，默认无；存在差异：目标允许人工/多源层为空；来源改由映射表追溯
DRAWING_VERSION_IDV2 图层所属图纸版本64位整数 → BIGINT8字节是—IDX_GIS_LAYER_VERSIONV2 生效/派生成果写入；旧行为空只按遗留规则读取2026-10-23 新增并回读；V2 写入绑定版本，旧行空
SOURCE_LAYER_NAME源层兼容名称字符串 → VARCHAR(200)200是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(200)，非空，默认无；存在差异：目标允许人工/多源层为空；保留兼容快照
LAYER_NAME图层名字符串 → VARCHAR(200)200否——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(200)，非空，默认无
LAYER_TYPE几何类型字符串 → VARCHAR(24)24是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(24)，可空，默认无
FEATURE_COUNT派生要素数32位整数 → INT4字节是0—来源/当前修订派生，缓存不作权限依据已按实际库核对：INT，可空，默认0
SORT_NO排序32位整数 → INT4字节是0—已有源快照/配置；真实关联按服务端校验已按实际库核对：INT，可空，默认0
VISIBLE_FLAG默认显隐标志 → CHAR(1)1否'1'—已有源快照/配置；真实关联按服务端校验已按实际库核对：CHAR(1)，非空，默认'1'
STYLE_COLOR旧样式色兼容字段字符串 → VARCHAR(16)16是——已有源快照/配置；真实关联按服务端校验已按实际库核对：VARCHAR(16)，可空，默认无
STYLE_WIDTH旧线宽兼容字段定点数 → DECIMAL(6,2)6,2是1.5—已有源快照/配置；真实关联按服务端校验已按实际库核对：DECIMAL(6,2)，可空，默认1.5
MIN_ZOOM最低展示层级32位整数 → INT4字节是10—已有源快照/配置；真实关联按服务端校验已按实际库核对：INT，可空，默认10
MAX_ZOOM最高展示层级32位整数 → INT4字节是22—已有源快照/配置；真实关联按服务端校验已按实际库核对：INT，可空，默认22
BBOX_MIN_LON最小经度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MIN_LAT最小纬度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MAX_LON最大经度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MAX_LAT最大纬度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度是——服务器审计填充已按实际库核对：TIMESTAMP，可空，默认无
CREATE_DEPT创建部门64位整数 → BIGINT8字节是——服务器审计填充已按实际库核对：BIGINT，可空，默认无
CREATE_BY创建主体64位整数 → BIGINT8字节是——服务器审计填充已按实际库核对：BIGINT，可空，默认无
UPDATE_BY更新主体64位整数 → BIGINT8字节是——服务器审计填充已按实际库核对：BIGINT，可空，默认无
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度是——服务器审计填充已按实际库核对：TIMESTAMP，可空，默认无
LAYER_CODE业务图层编码字符串 → VARCHAR(64)64否—UK平台生成，迁移先补值待核对：新增目标列，实际库无此列
SOURCE_TYPECAD 或人工来源字符串 → VARCHAR(24)24否CADCHECK明确来源待核对：新增目标列，实际库无此列
LINE_ID所属线路64位整数 → BIGINT8字节是—I_SCOPE工程选择器待核对：新增目标列，实际库无此列
BID_ID专属标段64位整数 → BIGINT8字节是—I_SCOPE有效工程组合待核对：新增目标列，实际库无此列
SITE_ID物理工点64位整数 → BIGINT8字节是—I_SCOPEBIZ_SITE_MASTER.SITE_MASTER_ID待核对：新增目标列，实际库无此列
UNIT_PROJECT_ID适用单位工程64位整数 → BIGINT8字节是—LFKBIZ_UNIT_PROJECT待核对：新增目标列，实际库无此列
RESOURCE_TYPE资源类别/隔离状态字符串 → VARCHAR(24)24否QUARANTINEDCHECK服务器判定待核对：新增目标列，实际库无此列
MAJOR_CODE专业代码字符串 → VARCHAR(64)64是—I_SCOPEBIZ_MAJOR_DICT.MAJOR_CODE待核对：新增目标列，实际库无此列
PURPOSE_CODE图层用途分类字符串 → VARCHAR(32)32是——征地/参考等用途，不作专业授权待核对：新增目标列，实际库无此列
STYLE_JSON类型化公共样式类型化JSON文本 → CLOB大文本，应用限制是——白名单样式结构待核对：新增目标列，实际库无此列
OPACITY默认透明度比例 → DECIMAL(5,4)5,4否10≤值≤1公共配置待核对：新增目标列，实际库无此列
SELECTABLE_FLAG默认可选标志 → CHAR(1)1否1CHECK公共配置待核对：新增目标列，实际库无此列
LOCKED_FLAG默认交互锁定标志 → CHAR(1)1否0CHECK不代替授权待核对：新增目标列，实际库无此列
STATUS可用性字符串 → VARCHAR(16)16否ENABLEDCHECK维护动作待核对：新增目标列，实际库无此列
REVISION并发修订64位整数 → BIGINT8字节否0乐观锁服务器递增待核对：新增目标列，实际库无此列
DEL_FLAG逻辑删除标志 → CHAR(1)1否0CHECK只删除无引用空人工层待核对：新增目标列，实际库无此列

3.3 GIS_FEATURE（既有表扩展） ​

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
FEATURE_ID稳定要素ID64位整数 → BIGINT8字节否—PK已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，非空，默认无
LAYER_ID业务图层主键/引用64位整数 → BIGINT8字节否—LFK/索引已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，非空，默认无
DRAWING_ID图纸资产ID/兼容来源引用64位整数 → BIGINT8字节是—LFK/索引已有源快照/配置；真实关联按服务端校验已按实际库核对：BIGINT，非空，默认无；存在差异：目标人工要素可空
SOURCE_HANDLE稳定实体键中的源 handle/块实例路径快照字符串 → VARCHAR(512)512是——来源快照；块内实体使用“插入实例路径＋源 handle”，无 handle 时用图元类型＋序号，写库前校验唯一已按实际库核对：VARCHAR(512)，可空，默认无
GEOMETRY_TYPE当前几何类型缓存字符串 → VARCHAR(24)24否——来源/当前修订派生，缓存不作权限依据已按实际库核对：VARCHAR(24)，非空，默认无
GEOMETRY_JSON当前几何兼容缓存类型化JSON文本 → CLOB大文本，应用限制否——来源/当前修订派生，缓存不作权限依据已按实际库核对：CLOB，非空，默认无
PROPERTIES_JSON当前属性兼容缓存类型化JSON文本 → CLOB大文本，应用限制是——来源/当前修订派生，缓存不作权限依据已按实际库核对：CLOB，可空，默认无
SORT_NO排序32位整数 → INT4字节是0—已有源快照/配置；真实关联按服务端校验已按实际库核对：INT，可空，默认0
BBOX_MIN_LON最小经度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MIN_LAT最小纬度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MAX_LON最大经度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
BBOX_MAX_LAT最大纬度定点数 → DECIMAL(18,10)18,10是—BOX/现有普通索引适用列来源/当前修订派生，缓存不作权限依据已按实际库核对：DECIMAL(18,10)，可空，默认无
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度是——服务器审计填充已按实际库核对：TIMESTAMP，可空，默认无
FEATURE_NAME要素名称字符串 → VARCHAR(200)200是——业务维护待核对：新增目标列，实际库无此列
CURRENT_REVISION_ID当前成果修订64位整数 → BIGINT8字节是—LFK GIS_FEATURE_REVISION原子保存/版本切换待核对：新增目标列，实际库无此列
LINE_ID线路64位整数 → BIGINT8字节是—I_SCOPE真实工程归属待核对：新增目标列，实际库无此列
BID_ID标段64位整数 → BIGINT8字节是—I_SCOPE有效工程组合待核对：新增目标列，实际库无此列
SITE_ID工点64位整数 → BIGINT8字节是—I_SCOPE物理工点主键待核对：新增目标列，实际库无此列
UNIT_PROJECT_ID单位工程64位整数 → BIGINT8字节是—LFK工程主数据待核对：新增目标列，实际库无此列
RESOURCE_TYPE资源类别/隔离状态字符串 → VARCHAR(24)24否QUARANTINEDCHECK服务器判定待核对：新增目标列，实际库无此列
MAJOR_CODE专业代码字符串 → VARCHAR(64)64是—I_SCOPE专业字典代码待核对：新增目标列，实际库无此列
SOURCE_TYPECAD 或人工字符串 → VARCHAR(24)24否CADCHECK创建来源待核对：新增目标列，实际库无此列
REVISION并发修订64位整数 → BIGINT8字节否0乐观锁每次来源/覆盖/绑定变化递增待核对：新增目标列，实际库无此列
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计BaseEntity，存量先允许空待核对：新增目标列，实际库无此列
CREATE_BY创建主体64位整数 → BIGINT8字节是—审计服务器填充待核对：新增目标列，实际库无此列
UPDATE_BY更新主体64位整数 → BIGINT8字节是—审计服务器填充待核对：新增目标列，实际库无此列
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度是—审计服务器填充待核对：新增目标列，实际库无此列
DEL_FLAG当前要素逻辑删除标志 → CHAR(1)1否0CHECK历史查看按修订重建待核对：新增目标列，实际库无此列

3.4 GIS_DRAWING_VERSION ​

图纸源文件版本；一个版本绑定不可变文件，当前有效性由资产指针决定。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
VERSION_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
DRAWING_ID所属资产64位整数 → BIGINT8字节否—LFK GIS_DRAWING；UK1已有资产待核对：目标设计，未建库
VERSION_NO版本序号32位整数 → INT4字节否—UK1同资产递增待核对：目标设计，未建库
SOURCE_OSS_ID受控源文件64位整数 → BIGINT8字节是—LFK SYS_OSS正式版本必有；迁移未定位时隔离待核对：目标设计，未建库
SOURCE_FILE_NAME源文件名字符串 → VARCHAR(255)255否——上传待核对：目标设计，未建库
SOURCE_FORMAT实际编码格式字符串 → VARCHAR(32)32否——内容检测，不只看扩展名待核对：目标设计，未建库
SOURCE_SHA256文件摘要摘要 → CHAR(64)64否—非全库唯一文件内容待核对：目标设计，未建库
SOURCE_SIZE字节数64位整数 → BIGINT8字节否—≥0文件检测待核对：目标设计，未建库
INPUT_UNIT源单位字符串 → VARCHAR(16)16是——文件及人工核实待核对：目标设计，未建库
HEIGHT_NOTE高程说明字符串 → VARCHAR(500)500是——受控来源待核对：目标设计，未建库
READY_STATUS检查就绪状态字符串 → VARCHAR(24)24否NEEDS_INPUTCHECK检查判定，非审批待核对：目标设计，未建库
COORDINATE_STATUS定位状态字符串 → VARCHAR(24)24是UNVERIFIEDCHECKUNVERIFIED/REFERENCE/VERIFIED；参考定位可浏览，正式定位需控制点校核2026-10-21 已建并回填历史版本为 REFERENCE
COORDINATE_NOTE坐标状态说明字符串 → VARCHAR(500)500是——方案/校核说明，不复述几何2026-10-21 已建
COORDINATE_PIPELINE坐标处理链字符串 → VARCHAR(32)32是——新接收固定 AMAP_V2；其它值明确拒绝并重新解析列存在；退役数据已重置
GEOREF_CONFIG版本级配准 JSON大文本 → CLOB应用限制是——原始清单引用、点对、参数、残差、派生清单引用、保存/确认信息2026-10-23 新增并回读；V2 新版本写入
GEOREF_REVISION配准配置/状态修订64位整数 → BIGINT8字节是0条件更新保存/确认/清除各 +1；确认不重新派生列存在；新版本接收后为 0
LATEST_ATTEMPT_ID最新尝试64位整数 → BIGINT8字节是—LFK GIS_CAD_TASK提交任务待核对：目标设计，未建库
ACCEPTED_ATTEMPT_ID采用的合格尝试64位整数 → BIGINT8字节是—LFK GIS_CAD_TASK检查完成待核对：目标设计，未建库
ACTIVATED_TIME曾生效时间日期时间 → TIMESTAMP(6)微秒精度是——版本切换待核对：目标设计，未建库
REVISION版本记录并发修订64位整数 → BIGINT8字节否0乐观锁服务器待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库
SOURCE_STORAGE_PATH源文件存储路径，新记录使用对象存储键字符串 → VARCHAR500是——见模块相关设计2026-11-02 双库字段元数据回读

3.5 GIS_DRAWING_SCOPE ​

整份源版本的工程与专业范围清单；文件整体访问逐项覆盖。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
SCOPE_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
VERSION_ID源版本64位整数 → BIGINT8字节否—LFK；UK1图纸版本待核对：目标设计，未建库
ENTRY_KEY规范化范围摘要摘要 → CHAR(64)64否—UK1类别/线路/组合/专业的服务器摘要待核对：目标设计，未建库
RESOURCE_TYPE资源类型（原记录：PAIR/SITE_SHARED/FULL_LINE/QUARANTINED）字符串 → VARCHAR(24)24否QUARANTINEDCHECK真实内容核对待核对：目标设计，未建库
LINE_ID线路64位整数 → BIGINT8字节是—LFK未知即隔离待核对：目标设计，未建库
BID_ID专属标段64位整数 → BIGINT8字节是—LFKPAIR 必填待核对：目标设计，未建库
SITE_ID物理工点64位整数 → BIGINT8字节是—LFKPAIR/SITE_SHARED 必填待核对：目标设计，未建库
MAJOR_CODE受控专业字符串 → VARCHAR(64)64是—LFK未知不作通配待核对：目标设计，未建库
CONFIRMED_FLAG范围已核实标志 → CHAR(1)1否0CHECK获准检查者确认待核对：目标设计，未建库
REVISION范围并发修订64位整数 → BIGINT8字节否0乐观锁归类变化待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.6 GIS_CAD_TASK ​

一次不可混淆的处理尝试；重试新增记录。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
ATTEMPT_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
VERSION_ID源版本64位整数 → BIGINT8字节否—LFK；I_VERSION图纸版本待核对：目标设计，未建库
PREVIOUS_ATTEMPT_ID前次尝试64位整数 → BIGINT8字节是—LFK 自身受控重试待核对：目标设计，未建库
REQUEST_ID接收/重试请求标识字符串 → VARCHAR(64)64否—UK1 与 CREATE_BY幂等请求待核对：目标设计，未建库
INPUT_HASH全部输入摘要摘要 → CHAR(64)64否——源文件/映射/方案/解析器版本待核对：目标设计，未建库
INPUT_JSON不可变输入快照类型化JSON文本 → CLOB大文本，应用限制否—结构校验版本化参数待核对：目标设计，未建库
PARSER_VERSION解析器组合版本字符串 → VARCHAR(128)128否——运行部署信息待核对：目标设计，未建库
STATUS处理状态字符串 → VARCHAR(24)24否QUEUEDI_QUEUE；CHECKQUEUED/RUNNING/NEEDS_INPUT/SUCCEEDED/FAILED待核对：目标设计，未建库
STAGE当前处理阶段字符串 → VARCHAR(32)32是——真实阶段待核对：目标设计，未建库
CLAIM_TOKEN本次领取令牌字符串 → VARCHAR(64)64是—租约校验执行单元随机值待核对：目标设计，未建库
LEASE_UNTIL执行租约截止日期时间 → TIMESTAMP(6)微秒精度是—I_QUEUE服务端时间待核对：目标设计，未建库
START_TIME开始时间日期时间 → TIMESTAMP(6)微秒精度是——执行单元待核对：目标设计，未建库
END_TIME结束时间日期时间 → TIMESTAMP(6)微秒精度是——执行单元待核对：目标设计，未建库
SOURCE_COUNT源对象数64位整数 → BIGINT8字节是—≥0解析结果待核对：目标设计，未建库
OUTPUT_COUNT输出成果数64位整数 → BIGINT8字节是—≥0处理结果待核对：目标设计，未建库
ISSUE_COUNT缺项数64位整数 → BIGINT8字节是—≥0完整性检查待核对：目标设计，未建库
REPORT_OSS_ID受控检查报告64位整数 → BIGINT8字节是—LFK SYS_OSS类型化缺项明细文件待核对：目标设计，未建库
MANIFEST_OSS_ID受控输出清单64位整数 → BIGINT8字节是—LFK SYS_OSS本次尝试输出待核对：目标设计，未建库
ERROR_CODE失败分类字符串 → VARCHAR(64)64是——脱敏业务错误待核对：目标设计，未建库
ERROR_MESSAGE可公开给有权用户的错误字符串 → VARCHAR(1000)1000是——不含凭据或本机目录待核对：目标设计，未建库
REVISION并发修订64位整数 → BIGINT8字节否0乐观锁领取/状态变更待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库
MANIFEST_STORAGE_PATH本次解析输出的 JSON 文件相对路径，检查与版本对比据此读取字符串 → VARCHAR500是——见模块相关设计2026-11-02 双库字段元数据回读

3.7 GIS_SOURCE_ENTITY ​

完整 CAD 源语义与派生路径，按尝试隔离。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
SOURCE_ENTITY_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
ATTEMPT_ID所属解析尝试64位整数 → BIGINT8字节否—LFK；UK1解析任务待核对：目标设计，未建库
VERSION_ID源文件版本64位整数 → BIGINT8字节否—LFK必须与尝试一致待核对：目标设计，未建库
ENTITY_KEY版本内对象/派生键摘要摘要 → CHAR(64)64否—UK1源 handle＋块派生路径；无 handle 时采用报告中的局部标识待核对：目标设计，未建库
SOURCE_HANDLE原始图元标识/块实例路径字符串 → VARCHAR(512)512是——源文件；无 handle 时保留类型＋序号待核对：目标设计，未建库
DERIVED_PATH嵌套块/派生路径字符串 → VARCHAR(512)512是——解析树路径待核对：目标设计，未建库
SOURCE_LAYER_NAME原始源图层名字符串 → VARCHAR(200)200否—I_SOURCE_LAYER源文件待核对：目标设计，未建库
ENTITY_TYPE原对象类型字符串 → VARCHAR(32)32否——源文件待核对：目标设计，未建库
SOURCE_GEOMETRY_JSON源坐标几何类型化JSON文本 → CLOB大文本，应用限制是—结构校验保留单位及曲线表达待核对：目标设计，未建库
SEMANTIC_JSON块/文字/曲线/填充/样式语义类型化JSON文本 → CLOB大文本，应用限制否—结构校验源解析结果，不是扁平 GeoJSON待核对：目标设计，未建库
PARSE_STATUS识别/成功/缺项/失败字符串 → VARCHAR(24)24否RECOGNIZEDCHECK完整性检查待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.8 GIS_LAYER_SOURCE_MAP ​

源层/对象到业务层的显式映射，不改写源文件。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
MAP_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
VERSION_ID源图纸版本64位整数 → BIGINT8字节否—LFK图纸版本待核对：目标设计，未建库
ATTEMPT_ID已解析来源尝试64位整数 → BIGINT8字节是—LFK缺解析时仅为待核实映射待核对：目标设计，未建库
SOURCE_LAYER_NAME原始层名字符串 → VARCHAR(200)200否—I_SOURCE源层待核对：目标设计，未建库
TARGET_LAYER_ID目标业务层64位整数 → BIGINT8字节否—LFK GIS_LAYER受控选择待核对：目标设计，未建库
ENTITY_SELECTOR_JSON对象子集规则类型化JSON文本 → CLOB大文本，应用限制是—只允许类型化对象键/类别混合层拆分，空表示整源层且已核实待核对：目标设计，未建库
MAPPING_HASH映射输入摘要摘要 → CHAR(64)64否—UK1 与 VERSION_ID规范化来源/目标/子集摘要待核对：目标设计，未建库
REVISION并发修订64位整数 → BIGINT8字节否0乐观锁映射维护待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.9 GIS_FEATURE_REVISION ​

不可变成果修订：几何、人工覆盖、来源和绑定的一致快照。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
FEATURE_REVISION_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
FEATURE_ID稳定业务要素64位整数 → BIGINT8字节否—LFK GIS_FEATURE；UK1已有或新要素待核对：目标设计，未建库
REVISION_NO修订序号64位整数 → BIGINT8字节否—UK1同要素递增待核对：目标设计，未建库
BASE_REVISION_ID基于的修订64位整数 → BIGINT8字节是—LFK 自身编辑/换版待核对：目标设计，未建库
DRAWING_VERSION_ID适用 CAD 版本64位整数 → BIGINT8字节是—LFK人工新增可空待核对：目标设计，未建库
REVISION_KIND修订类型（原记录：IMPORT/EDIT/DELETE）字符串 → VARCHAR(16)16否—CHECK明确操作待核对：目标设计，未建库
FEATURE_NAME该版名称字符串 → VARCHAR(200)200是——快照待核对：目标设计，未建库
LAYER_ID该版业务层64位整数 → BIGINT8字节否—LFK当时真实归属待核对：目标设计，未建库
RESOURCE_TYPE该修订工程类别字符串 → VARCHAR(24)24否QUARANTINEDI_SCOPE；CHECK服务器快照待核对：目标设计，未建库
LINE_ID该修订线路64位整数 → BIGINT8字节是—I_SCOPE；LFK实际归属待核对：目标设计，未建库
BID_ID该修订标段64位整数 → BIGINT8字节是—I_SCOPE；LFK有效组合待核对：目标设计，未建库
SITE_ID该修订物理工点64位整数 → BIGINT8字节是—I_SCOPE；LFKBIZ_SITE_MASTER待核对：目标设计，未建库
UNIT_PROJECT_ID该修订单位工程64位整数 → BIGINT8字节是—LFK真实关系待核对：目标设计，未建库
MAJOR_CODE该修订专业字符串 → VARCHAR(64)64是—I_SCOPE；LFK归类快照待核对：目标设计，未建库
GEOMETRY_TYPE规范几何类型字符串 → VARCHAR(24)24否——GeoJSON 几何待核对：目标设计，未建库
GEOMETRY_JSONWGS84 展示/交换几何类型化JSON文本 → CLOB大文本，应用限制是—删除修订可空源转换或经校验编辑待核对：目标设计，未建库
PROPERTIES_JSON该版属性类型化JSON文本 → CLOB大文本，应用限制是—结构校验白名单字段待核对：目标设计，未建库
OVERRIDE_JSON人工变化/样式覆盖类型化JSON文本 → CLOB大文本，应用限制是—结构校验不修改源语义待核对：目标设计，未建库
BBOX_MIN_LON最小经度定点数 → DECIMAL(18,10)18,10是—BOX按几何派生待核对：目标设计，未建库
BBOX_MIN_LAT最小纬度定点数 → DECIMAL(18,10)18,10是—BOX按几何派生待核对：目标设计，未建库
BBOX_MAX_LON最大经度定点数 → DECIMAL(18,10)18,10是—BOX按几何派生待核对：目标设计，未建库
BBOX_MAX_LAT最大纬度定点数 → DECIMAL(18,10)18,10是—BOX按几何派生待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.10 GIS_FEATURE_SOURCE ​

2026-11-02 按退役结构清理：开发库已物理删除（删除前 0 行），生产库原不存在；双库回读均不存在。

3.11 GIS_DRAWING_VERSION_FEATURE ​

图纸版本采用的成果集合；历史版本冻结后不变。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
RELATION_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
VERSION_ID图纸版本64位整数 → BIGINT8字节否—LFK；UK1版本成果集待核对：目标设计，未建库
FEATURE_ID稳定要素64位整数 → BIGINT8字节否—LFK；UK1对应匹配待核对：目标设计，未建库
FEATURE_REVISION_ID该版本采用的修订64位整数 → BIGINT8字节否—LFK与 FEATURE_ID 一致待核对：目标设计，未建库
MIGRATION_STATUS对应关系/冲突情况字符串 → VARCHAR(24)24否CONFIRMEDCHECK候选比对，冲突阻止生效待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.12 GIS_FEATURE_BINDING ​

绑定属于成果修订快照，业务实体仍在原业务域。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
BINDING_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
FEATURE_REVISION_ID所属成果修订64位整数 → BIGINT8字节否—LFK；UK1修订原子保存待核对：目标设计，未建库
BUSINESS_TYPE已注册业务适配类型字符串 → VARCHAR(64)64否—UK1服务器白名单待核对：目标设计，未建库
BUSINESS_ID业务稳定标识的无损文本字符串 → VARCHAR(128)128否—UK1由对应业务适配器规范化，不经 JS 数字化待核对：目标设计，未建库
BUSINESS_VERSION可用时的业务版本字符串 → VARCHAR(64)64是——业务读取结果待核对：目标设计，未建库
RELATION_KIND对象关联用途字符串 → VARCHAR(32)32否DETAILCHECK已支持详情/进度用途待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.13 GIS_CRS ​

坐标定义版本；同编码的引用版本不可改义。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
CRS_ID版本主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
CRS_CODE稳定定义编码字符串 → VARCHAR(64)64否—UK1标准或平台自定义待核对：目标设计，未建库
CRS_NAME名称字符串 → VARCHAR(200)200否——配置待核对：目标设计，未建库
AUTHORITY权威机构字符串 → VARCHAR(32)32是——有依据才填待核对：目标设计，未建库
AUTHORITY_CODE权威编码字符串 → VARCHAR(64)64是——不伪造 EPSG待核对：目标设计，未建库
DEFINITION_FORMATWKT/PROJ 等支持格式字符串 → VARCHAR(16)16否—CHECK解析能力待核对：目标设计，未建库
DEFINITION_TEXT完整定义长文本 → CLOB大文本，应用限制否—文本内容校验，非任意脚本标准资料/受控参数待核对：目标设计，未建库
HORIZONTAL_UNIT水平单位字符串 → VARCHAR(16)16否—CHECK定义资料待核对：目标设计，未建库
AXIS_ORDER明确轴序字符串 → VARCHAR(32)32否—CHECK定义资料待核对：目标设计，未建库
HEIGHT_NOTE高程基准说明字符串 → VARCHAR(500)500是——资料待核对：目标设计，未建库
ORIGIN_NOTE定义来源和精度说明字符串 → VARCHAR(1000)1000否——可追溯依据待核对：目标设计，未建库
STATUS可用性字符串 → VARCHAR(16)16否DISABLEDCHECK验证后维护启用待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库
DEL_FLAG逻辑删除标志 → CHAR(1)1否0CHECK代码/授权键保留，不复用唯一键待核对：目标设计，未建库

3.14 GIS_TRANSFORM（已退役） ​

2026-10-23 物理删除。配准是版本内求解方法，不再有全局转换方案表。

3.15 GIS_CONTROL_POINT（已退役） ​

2026-10-23 物理删除。版本配准点对保存在 GIS_DRAWING_VERSION.GEOREF_CONFIG，不迁移旧控制点。

3.16 GIS_BASEMAP_SERVICE ​

一个可选底图组合，含基础层与必要注记定义；不保存 Key。

交开投影像临时直连期间，新增或编辑保存时使用现有 ACCESS_MODE=DIRECT、AUTH_TYPE=BROWSER，清空 CREDENTIAL_REF。既有记录可直接读取，按正常编辑保存更新这些配置值。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
SERVICE_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
SERVICE_CODE服务编码字符串 → VARCHAR(64)64否—UK配置待核对：目标设计，未建库
SERVICE_NAME名称字符串 → VARCHAR(200)200否——配置待核对：目标设计，未建库
PROVIDER提供方字符串 → VARCHAR(100)100否——来源待核对：目标设计，未建库
SERVICE_TYPE服务类型字符串 → VARCHAR(24)24否WMTS应用枚举校验WMTS、VECTOR_STYLE、JKT_TILE；后者保存固定网格方案与 BASE 图层名2026-10-30 开发库 ALL_CONSTRAINTS/USER_CONSTRAINTS 未返回本表约束；未执行结构变更
CRS_ID底图坐标系64位整数 → BIGINT8字节是—逻辑关联 GIS_CRS源切片实际坐标系，WMTS/VECTOR_STYLE 为 3857，JKT_TILE 为 4490；运行地图 View 保持 38572026-10-30 开发库复核启用的 3857、4490 定义均存在
INITIAL_ZOOM初始镜头高度32位整数 → INT4字节是13应用校验 1–22默认底图首次打开时的缩放级别；场景使用默认底图值2026-10-22 已建并回填 3 条底图为 13
ENDPOINT无凭据服务地址字符串 → VARCHAR(1000)1000否—受控目标配置待核对：目标设计，未建库
ACCESS_MODEDIRECT 浏览器直连，PROXY 受控服务端代理（原记录：DIRECT/PROXY）字符串 → VARCHAR(16)16否DIRECTCHECK已获准调用方式待核对：目标设计，未建库
AUTH_TYPENONE、BROWSER 或 SERVER（原记录：NONE/BROWSER/SERVER）字符串 → VARCHAR(16)16否NONECHECK实际应用类型待核对：目标设计，未建库
CREDENTIAL_REF环境凭据引用名字符串 → VARCHAR(128)128是—不得放真实值私有配置注入待核对：目标设计，未建库
LAYER_CONFIG_JSON基础/注记矩阵等参数类型化JSON文本 → CLOB大文本，应用限制否—严格结构/数量/层级校验元数据与人工核对待核对：目标设计，未建库
ATTRIBUTION来源署名字符串 → VARCHAR(500)500是——服务使用要求待核对：目标设计，未建库
RESOURCE_TYPE资源类型（原记录：PUBLIC/PAIR/SITE_SHARED/FULL_LINE）字符串 → VARCHAR(24)24否PUBLICI_SCOPE；CHECK真实公共/工程类别待核对：目标设计，未建库
LINE_ID工程线路64位整数 → BIGINT8字节是—I_SCOPE工程定义时必填待核对：目标设计，未建库
BID_ID专属标段64位整数 → BIGINT8字节是—I_SCOPEPAIR 必填待核对：目标设计，未建库
SITE_ID物理工点64位整数 → BIGINT8字节是—I_SCOPEPAIR/SITE_SHARED 必填待核对：目标设计，未建库
MAJOR_CODE受控专业字符串 → VARCHAR(64)64是—I_SCOPE工程专有定义必填，空不代表全部待核对：目标设计，未建库
VALIDATION_STATUS接入验证结果字符串 → VARCHAR(24)24否UNVERIFIEDCHECK元数据/服务端/浏览器结果分列于报告待核对：目标设计，未建库
VALIDATION_JSON检查证据摘要类型化JSON文本 → CLOB大文本，应用限制是—不含凭据有限检查待核对：目标设计，未建库
STATUS可用性字符串 → VARCHAR(16)16否DISABLEDCHECK引用校验后维护待核对：目标设计，未建库
REVISION配置修订64位整数 → BIGINT8字节否0乐观锁配置变更待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库
DEL_FLAG逻辑删除标志 → CHAR(1)1否0CHECK代码/授权键保留，不复用唯一键待核对：目标设计，未建库
CREDENTIAL_VALUE天地图浏览器 Key 明文字符串 → VARCHAR512是——见模块相关设计2026-11-02 双库字段元数据回读

3.17 GIS_SCENE ​

可被主系统/既有驾驶舱消费的展示配置。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
SCENE_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
SCENE_CODE场景编码字符串 → VARCHAR(64)64否—UK配置待核对：目标设计，未建库
SCENE_NAME名称字符串 → VARCHAR(200)200否——配置待核对：目标设计，未建库
USAGE_TYPEMAIN 主系统，COCKPIT 既有驾驶舱（原记录：MAIN/COCKPIT）字符串 → VARCHAR(16)16否MAINCHECK既有入口用途待核对：目标设计，未建库
RESOURCE_TYPE资源类型（原记录：PUBLIC/PAIR/SITE_SHARED/FULL_LINE）字符串 → VARCHAR(24)24否PUBLICI_SCOPE；CHECK真实公共/工程类别待核对：目标设计，未建库
LINE_ID工程线路64位整数 → BIGINT8字节是—I_SCOPE工程定义时必填待核对：目标设计，未建库
BID_ID专属标段64位整数 → BIGINT8字节是—I_SCOPEPAIR 必填待核对：目标设计，未建库
SITE_ID物理工点64位整数 → BIGINT8字节是—I_SCOPEPAIR/SITE_SHARED 必填待核对：目标设计，未建库
MAJOR_CODE受控专业字符串 → VARCHAR(64)64是—I_SCOPE工程专有定义必填，空不代表全部待核对：目标设计，未建库
DEFAULT_SERVICE_ID默认底图64位整数 → BIGINT8字节是—LFK GIS_BASEMAP_SERVICE必须在场景服务集合内待核对：目标设计，未建库
VIEW_CONFIG_JSON初始范围/坐标/缩放类型化JSON文本 → CLOB大文本，应用限制否—结构及合法范围校验mode、center、extent、zoom、minZoom、maxZoom；FIXED 至少中心或范围2026-10-26 已增加 zoom，开发/生产回读一致
LAYER_SCOPE业务图层组合字符串 → VARCHAR(16)16否SELECTEDCHECK ALL/SELECTEDALL 全部图层，SELECTED 自选图层2026-10-26 开发/生产已建并回读
ALL_LAYER_VISIBLE_FLAG全部图层初始显隐标志 → CHAR(1)1否0CHECK 0/1仅 ALL 模式使用；1 打开时显示全部图层2026-10-26 开发/生产已建并回读
ANNOTATION_VISIBLE_FLAG场景初始底图注记标志 → CHAR(1)1否0CHECK 0/11 默认显示底图独立注记；矢量样式不适用2026-10-26 开发/生产已建并回读
STATUS可用性字符串 → VARCHAR(16)16否DISABLEDCHECK引用完整后启用；SYSTEM_DEFAULT 不允许停用待核对：目标设计，未建库
REVISION配置修订64位整数 → BIGINT8字节否0乐观锁原子保存待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库
DEL_FLAG逻辑删除标志 → CHAR(1)1否0CHECK代码/授权键保留，不复用唯一键待核对：目标设计，未建库

3.18 GIS_SCENE_SERVICE ​

场景允许选择的底图集合。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
RELATION_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
SCENE_ID场景64位整数 → BIGINT8字节否—LFK；UK1场景配置待核对：目标设计，未建库
SERVICE_ID底图服务64位整数 → BIGINT8字节否—LFK；UK1受控选择待核对：目标设计，未建库
SORT_NO顺序32位整数 → INT4字节否0—场景编排待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.19 GIS_SCENE_LAYER ​

场景中的图层展示覆盖。

字段中文含义逻辑类型 → DM8 类型长度/精度可空默认值约束/索引来源/生成规则核验状态/实际差异
RELATION_ID主键64位整数 → BIGINT8字节否—PK雪花待核对：目标设计，未建库
SCENE_ID场景64位整数 → BIGINT8字节否—LFK；UK1场景配置待核对：目标设计，未建库
LAYER_ID业务图层64位整数 → BIGINT8字节否—LFK；UK1实际图层待核对：目标设计，未建库
SORT_NO场景内顺序32位整数 → INT4字节否0—场景编排待核对：目标设计，未建库
VISIBLE_FLAG场景初始显隐标志 → CHAR(1)1否1CHECK不授予读取权待核对：目标设计，未建库
OPACITY场景透明度比例 → DECIMAL(5,4)5,4是—0..1；空继承场景覆盖待核对：目标设计，未建库
SELECTABLE_FLAG场景可选标志 → CHAR(1)1是—空继承不能提升编辑权待核对：目标设计，未建库
STYLE_OVERRIDE_JSON场景样式覆盖类型化JSON文本 → CLOB大文本，应用限制是—白名单不修改源图待核对：目标设计，未建库
CREATE_DEPT创建部门64位整数 → BIGINT8字节是—审计服务器当前主体部门待核对：目标设计，未建库
CREATE_BY创建主体64位整数 → BIGINT8字节否—审计服务器用户/受控任务主体待核对：目标设计，未建库
CREATE_TIME创建时间日期时间 → TIMESTAMP(6)微秒精度否—审计应用服务器填充待核对：目标设计，未建库
UPDATE_BY更新主体64位整数 → BIGINT8字节否—审计新建同创建主体待核对：目标设计，未建库
UPDATE_TIME更新时间日期时间 → TIMESTAMP(6)微秒精度否—审计新建同创建时间待核对：目标设计，未建库

3.20 GIS_TOPIC（已退役） ​

2026-10-23 物理删除。后续专题由对应业务模块定义，不在 GIS 保留专题表或占位实现。

3.21 GIS_SCENE_TOPIC（已退役） ​

2026-10-23 物理删除。本期 GIS 不做专题，场景不再保存允许专题关系。

3.22 GIS_AUTH_SUBJECT ​

2026-11-02 按退役结构清理：开发库已物理删除（删除前 2 行），生产库原不存在；双库回读均不存在。

3.23 GIS_PROFESSION_GRANT ​

2026-11-02 按退役结构清理：开发库已物理删除（删除前 2 行），生产库原不存在；双库回读均不存在。

3.24 GIS_SAVE_REQUEST ​

2026-11-02 按退役结构清理：开发库已物理删除（删除前 0 行），生产库原不存在；双库回读均不存在。

4. 约束、索引及引用规则 ​

4.1 唯一约束与检索索引目标 ​

所有表的主键见字段矩阵。下列均为目标，除第 1.1 节列明的当前索引外尚未建库；索引名称在实施时按项目命名并实际回读。避免为每个页面重复建表或为每个字段单独建索引。

表联合唯一约束普通索引目标
GIS_DRAWINGDRAWING_CODE，全生命周期保留编码CURRENT_VERSION_ID；LINE_ID/BID_ID/SITE_ID；DEL_FLAG/UPDATE_TIME
GIS_LAYERLAYER_CODE，全生命周期保留编码保留 DRAWING_ID 索引；RESOURCE_TYPE/LINE_ID/BID_ID/SITE_ID/MAJOR_CODE；状态/更新时间
GIS_FEATUREFEATURE_ID 主键，不重发业务 IDLAYER_ID/DEL_FLAG；工程专业组合；CURRENT_REVISION_ID；现有 bbox 索引先保留并实测
GIS_DRAWING_VERSIONDRAWING_ID/VERSION_NODRAWING_ID/CREATE_TIME；LATEST_ATTEMPT_ID；ACCEPTED_ATTEMPT_ID
GIS_DRAWING_SCOPEVERSION_ID/ENTRY_KEYVERSION_ID；工程专业组合
GIS_CAD_TASKCREATE_BY/REQUEST_IDSTATUS/LEASE_UNTIL/CREATE_TIME；VERSION_ID/CREATE_TIME；PREVIOUS_ATTEMPT_ID
GIS_SOURCE_ENTITYATTEMPT_ID/ENTITY_KEYVERSION_ID；ATTEMPT_ID/SOURCE_LAYER_NAME；SOURCE_HANDLE
GIS_LAYER_SOURCE_MAPVERSION_ID/MAPPING_HASHTARGET_LAYER_ID；ATTEMPT_ID；VERSION_ID/SOURCE_LAYER_NAME
GIS_FEATURE_REVISIONFEATURE_ID/REVISION_NODRAWING_VERSION_ID；LAYER_ID；历史工程专业组合
GIS_DRAWING_VERSION_FEATUREVERSION_ID/FEATURE_IDFEATURE_REVISION_ID；FEATURE_ID
GIS_FEATURE_BINDINGFEATURE_REVISION_ID/BUSINESS_TYPE/BUSINESS_IDBUSINESS_TYPE/BUSINESS_ID
GIS_CRSCRS_CODE（唯一）STATUS；DEL_FLAG
GIS_BASEMAP_SERVICESERVICE_CODE工程专业组合；STATUS
GIS_SCENESCENE_CODEUSAGE_TYPE/STATUS；工程专业组合
GIS_SCENE_SERVICESCENE_ID/SERVICE_IDSERVICE_ID
GIS_SCENE_LAYERSCENE_ID/LAYER_IDLAYER_ID

说明：

  • 图纸/图层/场景等稳定编码删除后不重新分配；需重新使用时恢复原记录并核对引用，不能使用不可靠的“编码＋单一删除标志”允许反复占用同一唯一键。
  • GRANT_KEY/ENTRY_KEY/MAPPING_HASH 在服务器由固定格式输入计算；保留对应原始类型化列/映射，摘要碰撞时不能无条件当成同一授权或覆盖记录。
  • 现有 bbox 组合索引不能保证四个不等式同时高效命中。性能验收按真实负载评估执行计划，必要时增量调整索引/分块，不能在设计中宣称性能已达标。
  • 源语义、修订与候选集合可能体量大；SQL 先按工程/专业/有效版本及视口筛选，几何大字段延迟读取。目录、统计及导出复用同一授权谓词。
  • PUBLIC 仅用于确实不含工程信息的配置定义；工程资源不能填 PUBLIC 以绕过授权。QUARANTINED 只用于隔离处理，不能被普通地图接口返回。

4.2 外键、删除与归属校验 ​

关系一致性及删除策略
图纸 → 当前版本指针必须属于同一 DRAWING_ID、就绪且采用的尝试有效；切换条件检查资产 REVISION
版本 → 文件/范围/任务源文件不可变；范围清单覆盖整份源文件，缺失/未确认不得整体公开；不能删除有引用的版本
任务 → 源语义/报告所有输出属于同次尝试；失败仅回收本次孤立输出，不能回收历史或共享对象
来源映射 → 业务层源版本/尝试、对象子集与目标层实际工程/专业一致；不能用改分类绕过源/目标权限
要素 → 当前修订修订必须属于该 FEATURE_ID；当前几何/属性/范围缓存与指针同事务更新
版本集合 → 修订FEATURE_ID、源版本和修订对应；历史冻结，候选未确认不能被当作有效集合
修订 → 来源/绑定两类关系与修订在同一事务新增；已发布修订只读，不物理级联删原业务
转换方案 → CRS/控制点引用定义版本及点集固定；引用后创建新方案版本，旧版本含控制点结果保持可追溯
场景 → 服务/图层/专题默认 ID 必须在对应场景集合内；默认引用失效时先明确替换/解除再停用
授权主体 → 授权行保存完整变更集时条件更新主体 REVISION；行约束失败整体回滚，不删除未包含在变更集中的其他授权
文件 → SYS_OSS所有访问由 GIS 资源鉴权绑定后读取；通用下载也不能放行受限图纸，仅持有 OSS_ID 不构成许可

工程字段约束：

  • PAIR 必须有 LINE_ID、BID_ID、SITE_ID，且三者构成真实有效的同线组合；SITE_SHARED 必须有线路/工点并用现有共享规则；FULL_LINE 必须有线路并使用整线判定。
  • 图层/要素的专业使用 MAJOR_CODE；单位工程存在时其标段/工点/专业必须一致。专业用途不是专业代码。
  • 未分类/历史未绑定的候选记录可暂存空归属，但必须 QUARANTINED；正式生效前不得仍为空。缓存 bbox、LINE_NAME、PROJECT_ID 和前端导航节点均不能成为授权依据。
  • 修订记录的工程/专业列用于历史授权，不能只检查已迁移到另一工程的“当前要素归属”后泄露旧版内容。
  • 同模块逻辑外键在服务事务和定向完整性检查中维护；实施采用物理约束时先评估循环指针、分批导入和历史数据，不假定 DM8 支持未经验证的延迟约束。

4.3 专业授权的条件约束 ​

PROFESSION：USER_ID、RESOURCE_TYPE、LINE_ID、MAJOR_CODE 必填，按类别填标段/工点，DRAWING_VERSION_ID 必须空。READ/WRITE/EXPORT/DOWNLOAD 各列只表达专业范围许可；功能动作和现有工程授权仍为前置。

FILE_PROCESS：DRAWING_VERSION_ID 必填，普通工程/专业单元列为空，GRANT_KEY 绑定该版本；READ_FLAG 允许整体检查，WRITE_FLAG 允许受控归类，EXPORT_FLAG/DOWNLOAD_FLAG 固定为 0。服务器仍逐项覆盖 GIS_DRAWING_SCOPE 的真实工程范围，不把空专业列当成全专业通配。

同一用户多个 PROFESSION 行按完整授权单元并集，禁止分别取全部工程和全部专业再做笛卡尔积。WRITE/EXPORT/DOWNLOAD 需要可读基础；配置校验拒绝互相矛盾项，不默默扩大。FILE_PROCESS 不赋予普通地图查看或整包下载许可。

主体修订与授权行同事务写入，授权变化使相关缓存修订失效。上游工程范围撤销后即使 GIS 授权行仍在，也不能继续生效；恢复上游范围是否重启既有 GIS 许可需在 Q-GIS-004 固定并在界面明确，不能静默假定。

4.4 字典与枚举 ​

RESOURCE_TYPE、任务状态、可用性、修订类型等为明确技术枚举，按字段含义分别实现，不混用审批字典。现有 IMPORT_STATUS=SUCCESS 仅为同步导入状态，迁移后不能解释为“全解析/定位/专业检查已合格”。布尔标志只用 0/1，数据库和 DTO 保持一致。

业务专业复用既有字典；进度业务状态由原业务源提供。综合专业包含关系和角色继承尚未确定，不通过新增字典值“全部专业”绕过政策。

5. 大文本结构与几何持久化契约 ​

字段/对象必须固定的内容与边界
GIS_CAD_TASK.INPUT_JSON源摘要、源版本、CRS/方案版本、单位、映射摘要、解析器组合及选项；不含密钥或可执行脚本
报告/输出清单文件源对象/输出/不支持/失败统计、源定位、问题分类、输入摘要与输出引用；受控读取/分页明细，不能全包下发给部分专业人员
SOURCE_GEOMETRY_JSON源几何数据；源坐标、曲线参数等按实际提取结果记录，未提取项明确缺项
SEMANTIC_JSON源语义数据；块、文字、填充及样式继承信息按实际提取结果记录，未提取项明确缺项
当前/修订 GEOMETRY_JSONRFC 7946 WGS84 经度在前，合法几何；米制源坐标不混入。第三坐标仅在含义符合交换约定时输出，工程高程另存元数据
OVERRIDE_JSON修改几何/属性/样式的明确覆盖项、来源锚定和编辑坐标方案；不是把引擎 Feature 对象序列化入库
GEOMETRY/PROPERTIES 当前缓存GIS_FEATURE 旧列保留兼容，内容由 CURRENT_REVISION_ID 派生，禁止两套接口分别写成独立事实
CRS.DEFINITION_TEXT受支持 WKT/PROJ 定义文本；CRS 解析与转换误差验证是两件事
TRANSFORM.PARAMETERS_JSON方法白名单对应的数值键、单位、轴序和参数来源；数值有限、不允许任意命令
TRANSFORM.THRESHOLD_JSON / RESULT输入/算法摘要、点用途、各项阈值来源、逐点/汇总误差及单位；无阈值只计算不判合格
BASEMAP.LAYER_CONFIG_JSON基础层/注记的 role、layer、style、format、matrixSet、matrixIds/resolutions、范围/层级和署名；地址中不得拼真实 Key
SCENE.VIEW_CONFIG_JSON范围适配或明确 CRS 的中心/范围、缩放上下限；运行时不越权展示初始范围内工程内容
场景/图层样式只允许类型化点/线/面/文字样式字段；透明度 0..1，缩放有序，引用受控图标，不执行外部 HTML/JS
TOPIC 配置已支持适配器、对象粒度、期次、状态字段、确认聚合及刷新；状态映射有唯一状态键，空数据/未关联/失败分开
SAVE_REQUEST.RESULT_REF_JSON结果资源/版本/任务标识，不直接存一份绕过鉴权的完整 GeoJSON 响应

配置可持久化不是允许页面自由录入任意 JSON。详细设计中的表单决定允许字段，服务端按结构及当前版本校验。JSON 中引用的标识仍逐项验证；可检索/授权的核心 ID 使用关系表或显式列，不能塞入 CSV/JSON 后跳过约束。

非删除成果修订必须有合法 GEOMETRY_TYPE/GEOMETRY_JSON，删除修订允许几何为空并从 BASE_REVISION_ID 追溯。坐标/专业/文件范围等尚未确认时只允许隔离记录存在，不能凭可空列在正式成果中省略校验。目标 CHECK 表示需要服务端与可用数据库约束共同保证，实际厂商支持和存量兼容性在建库时回读核实。

6. 与当前实现的差异 ​

对象设计变化已核对实际值/行为处理
图纸工程归属LINE_ID/BID_ID/资源类别与版本范围清单仅 LINE_NAME、可空 PROJECT_ID/SITE_ID新写入使用真实 ID；历史人工核实前隔离，名称不自动授权
源文件与版本源文件由版本绑定 OSS_ID，资产指当前版本资产上混有文件/CRS/参数，源文件保存在配置目录保留旧快照；逐文件核对摘要并登记受控存储，不猜本机文件位置
状态/任务异步尝试、检查、有效版分离同步子进程，IMPORT_STATUS=SUCCESS新接口接收版本/任务；旧状态保留兼容，不回填假合格
源层与业务层显式业务层、专业、映射和可编辑属性GIS_LAYER 当前逐图纸源层，DRAWING_ID 与 SOURCE_LAYER_NAME 非空保留层 ID；两列在数据核实后允许人工/多源层为空；映射拆分受控
人工要素可以没有 CAD 资产来源GIS_FEATURE.DRAWING_ID 非空分阶段放宽该列，新增 SOURCE_TYPE 及来源/修订体系
CAD 语义完整源对象、派生路径、多源映射只有 handle/属性/合并数量及显示几何从原文件重新解析；旧扁平几何不能反推“全解析已完成”
编辑/换版稳定要素＋不可变修订＋版本集合＋绑定当前直接按层读取 GeoJSON，无修订/业务绑定保留存量 FEATURE_ID；无确认对应关系不自动迁移绑定
审计新表五个 BaseEntity 字段；要素新增缺失审计列GIS_FEATURE 仅 CREATE_TIME；另两表五列已存在且可空新增四个缺列；存量先允许空，新写入按受控主体填充
唯一与引用编码唯一、同版序号、幂等和关系唯一三表仅主键，少量普通索引，无外键先只读检查重复/孤儿，再建立目标约束，禁止覆盖历史记录
配置独立服务/CRS/方案/场景/专题定义主要来自运行配置与页面固定行为先形成可校验配置，再联动页面；运行密钥继续环境注入
权限显式工程/专业＋整体文件处理＋主体修订当前仅五个功能动作，尚无范围过滤新增授权并按范围先过滤；未绑定/未分类不默认公开
参数精度已确认源单位、CRS、控制点及误差验收当前近似坐标和部分文件单位差异保留证据和输入，不以样图对齐回填官方坐标或精度通过

字段矩阵里的新增 NOT NULL、默认值和 UK 都是目标；尚无实际建库证据。不能将本文件交给生成器后跳过现状差异，直接覆盖旧表。

7. 迁移、事务与跨库兼容 ​

7.1 后续迁移顺序 ​

  1. 实施前重新通过纳管入口回读开发库版本、列/约束/索引、行数、重复编码、空归属及孤儿关系；本轮结构证据只覆盖 2026-10-21。
  2. 核对可恢复备份和受控源文件清单；不要求在本次文档任务中生成备份或访问生产。
  3. 先增表/可空兼容列与必要索引，不删除旧列、不改变存量 ID；新写入口使用目标契约，旧读接口保留适配。
  4. 为存量图纸建立源版本与隔离状态，按源摘要匹配文件。已验证元数据可迁移，工程归属、专业和 CRS 合格结果不得猜测补齐。
  5. 保留 GIS_LAYER/GIS_FEATURE 原 ID；迁移初始修订及源引用时区分“旧显示成果”和“重新解析合格成果”，不能补造缺失源语义。人工标绘与 CAD 分开。
  6. 在获准范围完成图纸工程清单、专业映射及控制点核查；经真实检查后才选择合格尝试并切换有效指针。
  7. 加上联合过滤与文件受控访问后，验证部分专业、混合文件、历史版本、缓存及旧入口，不能只让新菜单安全而旧下载仍公开。
  8. 清理本任务可确认重复/无效记录前逐项确认，不无条件去重/删除他人数据；必要约束收紧前报告不合规记录并提供修复路径。
  9. 在新增/修改/删除/换版/重试/配置更新后回读引用、版本、审计和索引；实际 DDL/DML 记录执行对象/行数与验证结果。
  10. 本任务本轮只写文档，没有执行上述迁移；生产发布前另行回读实际差异并取得具体授权。

7.2 关键事务 ​

  • 保存变更集：创建幂等锚点/校验旧修订 → 按真实对象逐项联合鉴权 → 新建成果修订、来源/绑定和版本集合 → 更新要素指针及兼容缓存/并发号 → 确认幂等结果，整体提交。
  • 候选生效：再次核对任务输入与就绪状态、完整文件范围、人工覆盖/绑定冲突 → 条件更新资产当前版本 → 一并更新相关要素及版本关系。任何失败保持原有效版。
  • 几何编辑与来源切换都推进并发号，旧会话不能覆盖新版。历史版本集合冻结；删除要素形成删除修订，不删除源图和业务单。
  • 任务领取/续租/终态提交均携带 CLAIM_TOKEN 和当前状态；过期执行单元不能回写成功覆盖新尝试。租约超时先核对运行及提交结果，不盲目复制任务。
  • 外部解析与 OSS 写入在短数据库事务外完成；最终以尝试标识和输入摘要确认引用。只有本次孤立输出可补偿清理。
  • 专业范围授权已取消，相关表已删除；当前按功能权限与工程范围判定。
  • 幂等锚点与确定业务结果保持一致；同主体同请求不同内容拒绝。重放/查询结果仍按当前身份、工程及专业授权，不返回过去权限下的几何。

7.3 跨库与回退 ​

项目DM8 当前方案人大金仓/openGauss 迁移注意
主键/审计BIGINT、TIMESTAMP(6)，应用填充不依赖厂商自增/触发器；时区约定按平台
JSON/几何CLOB 文本＋显式归属/包围盒列目标可用 TEXT/同类大文本，JSON 结构和 API 语义不变
DECIMAL/CHAR/VARCHAR按矩阵长度/精度核对字符/字节长度、空串与 NULL、排序及大小写
唯一/逻辑删除稳定编码不复用，复合关系 UK不依赖 NULL 唯一性差异或仅某库支持的部分唯一索引
查询/分页MyBatis/公共分页，复杂差异集中 Mapper当前 FETCH FIRST 使用点实施时收敛；不散落厂商语法
空间性能普通索引＋受控分页/视口无 PostGIS 强制依赖，实际负载不足再评估增量
乐观锁条件更新及影响行数检查不依赖某厂商特有 RETURNING 语法实现唯一正确性

回退首先回退应用读取/写入路径和配置引用，保持已新增版本/修订及原文件。切换前保留旧当前指针快照；存在新业务写入时不能直接把旧库备份覆盖回去。旧代码不支持新权限/人工来源时，不能把“回退”处理为重新公开所有历史数据。新增表/列不在常规回退中 DROP/TRUNCATE。

8. 后续建库与页面联调核验 ​

核验通过依据
完整字段每张实际表逐列对照矩阵，核对类型/长度、可空/默认、PK/UK/索引和 BaseEntity 五列
工程归属选线路/工点上传后存真实 ID/组合，拒绝名称伪造、越权参数和错配单位工程
文件完整范围（历史，专业权限已取消）原按专业限制混合原图/报告/预览的完整范围；2026-10-24 起按功能权限＋工程范围执行
版本/来源原文件不变、源对象与转换输出可追溯，换版保留业务 ID，历史快照不套当前覆盖
保存与并发并发冲突、重复请求、超时结果确认、事务失败均无部分成功/重复新增
任务恢复进程退出/租约超时/重复回调不覆盖新尝试，候选不自动成为有效版本
坐标版本引用后不可原地改参数，独立控制点校核，变更方案不直接改旧经纬度
配置与凭据场景默认引用完整；数据库无真实 Key；服务器 Key 不从管理/运行 DTO 下发
历史/缓存权限撤销、归属变动、历史查询及幂等重放均按请求时点拒绝无权内容
迁移兼容旧 ID/接口保持，旧字段缓存与新指针一致，未核实历史成果不标成全解析/精度合格

上述为后续实施检查；2026-11-02 开发库和生产库各有 14 张 GIS_ 表并已回读，结构核验不代表业务验收通过。测试与操作资料在实际实施验证后按六类文档职责补齐，不在本轮补空报告。

前期业务来源字段及约束增量 ​

本节仅是前期点面接入所需差异设计，未执行本轮MCP回读或DDL，历史矩阵的实际值只证明其原核验时点。现有SOURCE_TYPE列、图纸字段非空性和索引必须先核对；存在则按实际映射，不再新建同义列。前期十四表送审快照归前期，GIS正式几何和修订仍使用本模块现有表。

目标对象/列中文含义/逻辑类型物理建议/长度可空/默认主外键/唯一及索引来源/核验状态
GIS_LAYER.SOURCE_TYPE图层来源/StringVARCHAR/24否/按既有CAD默认来源白名单，保留现有来源并新增PRELIMINARY；索引按现查询核对CAD沿原值，前期发布服务指定；目标列历史已有设计，当前实体未映射，库待核
GIS_LAYER.BUSINESS_CATEGORY前期业务类别/StringVARCHAR/20CAD可空，PRELIMINARY必填/无默认LAND/UTILITY/TRAFFIC/GREENING；不从名称解析新增目标差异，待实体/MCP核
GIS_LAYER.DRAWING_IDCAD图纸引用/LongBIGINT/64位前期可空，CAD必须真实/无原LFK/索引保留，不填0或任意图纸目标允许业务来源无图纸，历史曾非空，实际约束待核
GIS_LAYER.DRAWING_VERSION_IDCAD来源版本/LongBIGINT/64位前期可空，CAD沿现版本要求/无保留当前CAD版本读取约束现实体已有，库待本轮核
GIS_FEATURE.SOURCE_TYPE稳定要素来源/StringVARCHAR/24否/沿现CAD默认保留现有来源，前期为PRELIMINARY现实体已有，本次仅新增来源取值，库待核
GIS_FEATURE.DRAWING_ID要素CAD引用/LongBIGINT/64位前期可空，CAD真实/无原关系/索引不删目标差异，当前非空性待核
GIS_FEATURE.UNIT_PROJECT_ID业务单位工程/LongBIGINT/64位前期必填，CAD沿原规则/无逻辑FK，映射真实line/bid/site现实体已有，不新建专业授权；库待核
GIS_FEATURE_REVISION.DRAWING_VERSION_ID正式修订CAD版本/LongBIGINT/64位前期可空，CAD沿原要求/无不能使业务修订被CAD当前版本过滤现实体已有，实际约束待核
GIS_FEATURE及REVISION.GEOMETRY_JSON正式几何/StringCLOB/按现几何限制正式有几何，不填空串/无GeoJSON4326，几何规则与bbox一致前期候选3857发布时转换，非新增一份坐标模型；库待核
GIS_FEATURE及REVISION.BBOX_MIN_LON最小经度/BigDecimal沿各表当前矩阵精度有几何则必填/无正式4326经度边界沿现列，发布服务计算；库待核
GIS_FEATURE及REVISION.BBOX_MIN_LAT最小纬度/BigDecimal沿各表当前矩阵精度有几何则必填/无正式4326纬度边界沿现列，发布服务计算；库待核
GIS_FEATURE及REVISION.BBOX_MAX_LON最大经度/BigDecimal沿各表当前矩阵精度有几何则必填/无正式4326经度边界沿现列，发布服务计算；库待核
GIS_FEATURE及REVISION.BBOX_MAX_LAT最大纬度/BigDecimal沿各表当前矩阵精度有几何则必填/无正式4326纬度边界沿现列，发布服务计算；库待核

本差异矩阵与原表完整矩阵共同构成适用设计，未改的审计/主键/修订/绑定列沿原定义。若实际需要其他列或约束，在实施前补齐同要素矩阵，不凭本节猜测建库。逻辑图层键为来源＋line/bid/site＋业务类别，先用真实数据量和查询方式决定必要索引，不预造全源动态引擎。

业务读取使用PRELIMINARY当前修订＋真实单位工程pair双边授权；CAD仍当前图纸版本及工点共享。只放松无图纸来源的适用列，不能全局取消CAD归属校验。通用维护口必须识别受前期审核控制的来源，正式几何/绑定只由可信审批内部发布；权限不是数据库注释即可完成。

文档1.03→1.13按新增一类来源及适用约束设计递增。未访问生产、不推断当前对象有无、不清理任何历史几何。正式实现需MCP逐列回读、写入后查询、坐标/来源/授权/故障回滚证据。