主题
GIS引擎底座 需求分析文档
文档版本：1.14 ｜ 最近核对日期：2026-11-10
交开投影像接入：底图服务类型为
JKT_TILE，源坐标使用 EPSG:4490，地图视图使用 EPSG:3857。维护人员通过底图表单新增、启用，并在场景允许集合中选择。影像统一经平台后端代理取图，上游账号与 token 不下发浏览器；生产环境需开通后端到影像服务113.207.1.170:5005的出方向访问（2026-11-08 实测华为云 VPC 未放行，开通前生产该底图无法出图）。
GIS 为主系统与驾驶舱提供工程地图、CAD 入图、多专业图层、标绘编辑、进度着色和业务详情联动。本文件维护业务范围、规则和验收依据；实现方案见概要设计。
2026-10-26 线网地图场景化（当前有效）：原“监管中心”菜单更名为“线网地图”。线网地图本身作为系统默认地图场景（
SYSTEM_DEFAULT），可用底图、默认底图、业务图层组合（全部图层/自选图层）、底图注记和默认视角统一来自地图场景配置；全部图层模式自动纳入当前工程范围内全部已发布图层，不逐层写关系；默认视野按主体范围适配并剔除离群图层，另提供完整范围入口。场景配置不授予任何资源权限。实现与双库迁移见详细设计和测试与验收。本文历史记录中的“监管中心”均指现“线网地图”。2026-10-25 简化优化口径（历史）：数据管理主流程收敛为“上传 → 自动解析 → 待定位 → 人工高德定位 → 确认 → 发布到地图”。所有图纸统一人工高德配准，不做 CRS 自动识别和上一版继承；固定 3 点相似，不向用户暴露“相似/仿射”选择。全线图纸通过高德
AMap.LineSearch搜索整条线路并以站点为锚点；工点图纸使用自定义搜索。三点残差提示“可能不是等比缩放”时，系统建议改用四点仿射。主列表只显示五态（处理中/待定位/待发布/已发布/失败）和一个主按钮，配准、检查、版本等技术动作收进“处理详情/更多”；监管中心使用统一空态说明。详见详细设计。2026-10-23 实施口径（历史）：常规入口收敛为 4 个——监管中心、数据管理、底图服务配置、地图场景配置；上传 DWG/DXF 后只解析原始 CAD 平面，在版本工作台完成高德配准并派生平台坐标成果，检查/人工确认/生效后由监管地图直接展示。旧坐标定义/转换方案页面、图纸级配准、同步导入和后端高德候选查询已退出；本期 GIS 不做专题，后续由对应业务模块建设。标准坐标定义仅作为底图内部基础数据保留。此段为当时口径；当前需求以本页现行规则为准。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | GIS引擎底座 |
| 实现范围说明 | 已实现 4 个常规入口、天地图/OpenFreeMap 底图读库、DWG/DXF 原始平面解析、版本级高德配准（浏览器搜索、多候选、CAD 成对、预览/保存/确认/清除）、检查与生效、监管地图展示、图层管理与线路/工点联合权限、图纸台账/版本对比、任务台账与重试、底图服务协议/坐标系/能力检查、地图场景配置、要素台账（修订/绑定）。原始 CAD 整文件下载按功能权限＋工程范围执行（2026-10-24 起专业/文件整体授权已取消）；原始 CAD 的 kkFileView 在线预览已于 2026-10-24 整体退役（预览接口、回源、同源代理与专用配置全部删除），后续原始 CAD 预览由 BIM 引擎承担，本期未实现；原始/派生清单使用图层内有界分块（CHUNKED_V2）；换版影响哈希按当前修订计算。专业范围权限已于 2026-10-24 整体取消（授权矩阵、FILE_PROCESS、未归类拒绝全部退出）；要素几何编辑、进度联动、驾驶舱、三维和完整 CAD 对象覆盖仍未完成，不能据此认定可用；本期 GIS 不提供专题 |
| 编写日期 | 2026-10-20 |
| 业务确认依据 | 本次会话用户明确的范围与保留项，见第 2 节；尚未明确的事项统一见第 12 节 |
| 业务确认人 | 本次会话用户；正式交付签署人待确认 |
| 关联文档 | 概要设计、详细设计、数据库设计、工程基础需求、业务地图 |
1. 建设目标
- 在一张工程地图上浏览授权范围内的线路、工点及相关工程成果。
- 将 DWG/DXF 解析为可分层、可追溯的工程空间成果，并支持标绘与人工调整后保存。
- 由业务数据驱动工程图形的进度展示和详情联动，主系统与驾驶舱使用同一事实口径。
- 同时执行工程范围授权和专业隔离，保护地图、属性、文件及业务数据。
- 当前使用可获取的 WMTS，架构支持未来内网实景三维接入，保留既有工程数据与业务关系。
本模块承担空间表达与交互，不重复建设工程主数据、进度报审、质量安全台账、统一身份或文件存储平台。
2. 来源与适用顺序
2.1 需求来源
| 编号 | 来源 | 本模块采用内容及限制 |
|---|---|---|
| S-GIS-001 | 用户本次会话对交建老平台范围的确认 | 主系统与驾驶舱：地图、标绘编辑、图层、进度着色、业务详情；不据此引入 DMP 的所有三维功能 |
| S-GIS-002 | 用户本次会话对底图与开源选型的确认 | 高德不作为生产底图；目前以天地图 WMTS 和 OpenFreeMap 矢量样式为启用底图；高德 Web 服务仅用于图纸配准的站点候选参考。新选组件限免费开源，已购超图按 Q-GIS-009 保留验证选项 |
| S-GIS-003 | 用户明确补充“CAD 全解析、专业隔离权限要保留” | 两项仍保留为后续要求；当前已交付图层/工点权限和图纸级参考配准，专业隔离和完整解析不能据此认定完成 |
| S-GIS-004 | 用户同意二三维演进讨论 | 当前线网地图为纯查看，要素几何编辑未纳入本期；未来按实际服务增加 CesiumJS 或一张图专用三维 SDK；不是承诺拿到内网权限即可由任意客户端加载 |
| S-GIS-005 | 《一张图SDK详细技术需求会议记录》，2026-10-20 14:30 | 当前可公网提供 2.5D 底图；实景三维涉及专线、保密协议与解密限制，不能直接提供可用 3D Tiles；会议暂定超图业务开发。后续开源路线按 S-GIS-002、004 调整，不能声称已完成供应方兼容验证 |
| S-GIS-006 | reports/BIM与GIS/数智建管平台一张图SDK详细技术需求规格说明书_最终版.docx | 采用 CAD 图元、坐标分离、图层编辑、保存闭环、业务穿透和专业隔离场景；旧规格中空间叠加分析、BIM、高德及原 SDK 指标不自动进入本期 |
| S-GIS-007 | 系统架构、业务地图、公共约定、工程基础需求 | 采用当前 PBS/CBS/WBS、专业字典和工程授权；不采用旧资料的单棵工程树、部门角色数据范围或独立维度 OR 放行 |
| S-GIS-008 | 2026-10-23 仓库代码与开发库核对 | 当前为 4 页 GIS 菜单；上传只解析原始 CAD 平面，配准在版本工作台按高德候选与 CAD 点对求解，生效后派生 EPSG:4326 成果供三套 3857 底图显示；旧坐标/转换页面、图纸级配准、同步导入、后端高德候选和 GIS 专题均已退出。代码只证明实现现状，不证明业务规则或测量精度已经满足 |
| S-GIS-009 | 用户于 2026-10-21 要求补全 GIS 页面体系，直接维护详细设计和数据库设计；补充图层管理按线路/工点导航并就地上传 CAD，当时主入口命名“GIS监管中心”，现菜单名为“监管中心” | 将既有能力落实为完整页面、数据模型和就地入图链路；只写文档，不修改业务代码、菜单数据、服务配置或数据库 |
会议与历史 DOCX 是受控来源，不随本站公开其原始地址、凭据或完整附件。必要范围已经在本文件转述，实施不依赖临时聊天附件路径。
2.2 范围状态
| 范围 | 状态 | 处理 |
|---|---|---|
| 地图、图层、标绘、进度着色、业务详情 | 首期保留 | 形成可用闭环，不以演示页面替代 |
| CAD 全解析及专业隔离 | 首期保留 | 技术适配和规则细节待核对，不影响两项属于首期的结论 |
| 一张图 2.5D WMTS | 首期接入目标 | 供应方参数及真实接入尚待 Q-GIS-001 核实 |
| 天地图 | 可选补充 | 已接入矢量/影像底图；用户提供的浏览器端 Key 已在 WMTS 瓦片和 GetCapabilities 调用中验证，服务器端 Key 可取得瓦片但当前实现未使用。两类 Key 分开使用，不写入业务源码或本站 |
| CAD 入图（DWG/DXF） | 首期部分实现 | 已用 LibreDWG→DXF、ezdxf/pyproj 打通三份重庆独立坐标系样图；全格式/对象覆盖、字体、外参、换版差异仍待 Q-GIS-002/003/009 |
| 实景三维 | 后续条件满足后接入 | 首期设计保留扩展位置，不把三维 SDK 实装、三维编辑和三维底图验收混入当前二维交付 |
| 高德、BIM、真实三维剖切/地下浏览/视频融合 | 本期不包含 | 不新增依赖、菜单、接口或模型处理任务 |
| 征地求交、求并、缓冲区、占地报表及复杂空间分析 | 本期不包含 | 几何有效性校验和坐标转换仍保留 |
| 新进度填报、审批流、专业业务台账 | 本模块不建设 | 读取原业务事实，不在地图重复录入 |
首期是包含 CAD 生产流程的业务 GIS，不应误解为只加载底图和几个标记的演示。
“免费开源”是本轮新选组件的约束，不能改写为默认接受免费但闭源的转换器。已购超图 11i 是现有资产，保留其兼容性与 CAD 能力验证选项；只有开源链的真实缺口查明、使用范围和现有许可核实后，才讨论是否采用该备选。当前没有决定以超图为新 GIS 的强制运行依赖。
3. 用户能力与使用场景
下表是能力分工，不要求新建同名系统角色或按单位名称自动授权。
| 能力主体 | 使用场景 | 结果 |
|---|---|---|
| 地图查看人员 | 按工程范围查看图层、定位对象、查看进度及详情 | 获得可见专业的工程地图 |
| 授权编辑人员 | 在有维护权限的工程、专业内标绘、调整与保存 | 形成可追溯的编辑成果 |
| 图纸成果维护人员 | 上传图纸、检查解析、坐标及专业映射、处理换版 | 形成有效图纸成果版本 |
| GIS 授权维护人员 | 按平台既有身份配置专业读写等范围 | 形成受工程范围上限约束的授权 |
| 驾驶舱使用人员 | 总览、筛选、定位、点选及业务穿透 | 使用相同权限和业务口径的展示视图 |
典型闭环：选择工程 → 上传图纸 → 检查解析与坐标 → 对应专业图层 → 叠加地图 → 关联工程业务 → 编辑并保存 → 驾驶舱按业务进度着色 → 点选查看详情。
3.1 页面体系与职责
GIS 采用“地图查看＋数据管理＋地图配置”的页面体系，常规入口为 4 个：线网地图、数据管理、底图服务配置、地图场景配置。图纸、任务、图层、要素仍在数据管理内，配准统一在版本工作台完成。页面布局、子页面和交互规格见详细设计。
| 编号 | 菜单页面 | 核心职责 | 能力依据 |
|---|---|---|---|
| P-GIS-001 | 线网地图（原监管中心） | 纯查看：系统默认地图场景；不设工程目录；图层控制与底图切换合并，图元详情和定位；底图、图层组合、注记和默认视角来自地图场景配置 | R-GIS-001～006、036～037、069～075 |
| P-GIS-002 | 数据管理 | 线路工程导航、上传、版本/任务、版本级高德配准、图层样式、整层移动、检查与生效 | R-GIS-007～017、033～035、053～057 |
| P-GIS-006 | 底图服务配置 | 天地图 WMTS、OpenFreeMap 矢量样式、坐标系、初始镜头高度、能力检查和启停 | R-GIS-002、003、048、NFR-GIS-003、007 |
| P-GIS-009 | 地图场景配置 | 主系统和后续驾驶舱共用的底图、图层组合、样式覆盖和初始视图；不配置专题 | R-GIS-001、004、005、050 |
图纸详情、成果检查、版本对比和任务详情使用可定位的子页面，不在地图浮层中塞入整套管理表单。图层样式、图层移动、版本配准和坐标状态在数据管理内使用弹窗或抽屉。驾驶舱通过既有入口消费场景，不新增一套重复大屏；本期不增加独立三维门户。
3.2 配套管理需求
| 编号 | 规则 | 来源 |
|---|---|---|
| R-GIS-046 | 第 3.1 节的页面分别承担各自职责，具备合法的入口、直接访问和返回路径；不以一个地图页面或多个空菜单代替整套 GIS 能力。菜单按能力授权，不要求每名用户看见所有页面 | S-GIS-009 |
| R-GIS-047 | 图纸台账覆盖当前、候选、历史及失败处理中的授权记录，不能只列成功图纸；转换任务独立查询与恢复，离开页面不终止已接收的服务端任务。检查成功、坐标合格和成果成为当前有效版本分别表达 | S-GIS-003、006、009 |
| R-GIS-048 | 底图服务元数据与运行凭据分离，管理能力检查不等于真实用户网络下出图成功；停用或修改前显示被场景引用的影响。底图服务必须记录并展示切片/样式的坐标系，默认 Web Mercator；记录初始镜头高度（默认 13 级）供场景首次打开使用；服务器端 Key 不返回浏览器管理表单；天地图两类 Key 的维护位置见私有根 README.md“其他服务与外部集成”下的“国家地理信息公共服务平台（天地图）” | S-GIS-002、009 |
| R-GIS-049 | 标准坐标定义只作为系统内部基础数据：保留 3857/4326/4490 等必要定义及底图引用，不向普通用户提供新建、修改、启停、升版入口，也不作为上传前置条件。配准方法、参数、点对和残差随图纸版本管理，不另建全局方案库 | S-GIS-002、003、009 |
| R-GIS-050 | 地图场景保存公共展示组合，个人临时显隐/顺序与公共配置分开；场景配置不能赋予资源权限。失效底图、无权图层或超出授权的初始范围必须按真实可用条件处理，不通过场景把工程数据公开 | S-GIS-001、003、009 |
| R-GIS-051（本期取消） | 本期 GIS 不提供专题配置、专题数据源注册、场景允许/默认专题或专题统计。后续专题由对应业务模块定义数据口径和地图表达，不在 GIS 保留占位入口或空壳接口 | 2026-10-23 用户决定 |
| R-GIS-052 | 要素台账与地图共用稳定 ID、当前版本、权限和保存机制；列表能定位地图，地图能查看来源与绑定。业务关联由有效工程/专业和原业务权限共同约束，不另建几何编辑副本或复制业务台账 | S-GIS-001、006、009 |
| R-GIS-053 | 数据管理以“线路 → 物理工点”目录作为 CAD 主要上传入口，自动带入合法工程 ID；本期上传只选线路/工点，不再要求标段或专业。目录和带入归属不代替服务端授权、专业分类或整份混合 CAD 检查。图纸台账共用同一上传/版本/任务服务，不另建入图库 | S-GIS-009 |
| R-GIS-054 | 配准从图纸级改为版本级：在数据管理版本行打开工作台，左侧为未校正原始 CAD 平面，右侧固定高德地图；保存写入版本 GEOREF_CONFIG 并推进 GEOREF_REVISION，状态为参考定位；人工目视确认后为“已人工确认”，不代表测量精度。版本状态是唯一权威，图纸资产不保存第二份配准镜像。线网地图只消费当前有效版本的派生成果，不提供配准入口 | S-GIS-002、003、009 |
| R-GIS-055 | 图纸/图层台账在 1920×911 基准视口下平铺展示关键列，列内容单行完整显示；中间次要列空间不足时允许表格横向滚动，操作列固定右侧且不被遮挡 | S-GIS-009 |
| R-GIS-056 | 新版本以原始 CAD x/y 为权威输入：解析阶段不投影、不简化、不合并；原始清单写入内网对象存储并保存摘要。配准在 GCJ02_WEB_MERCATOR 专用平面求解，保存时派生 EPSG:4326 成果；地图只投影到 3857，不再二次套配准。GCJ 预览链路为 CAD→配准矩阵→GCJ 墨卡托→反投影 GCJ，不先转 WGS84 再由浏览器加偏移 | S-GIS-002、003、009 |
| R-GIS-057 | 生产后端无互联网，高德 JS SDK、PlaceSearch、瓦片由浏览器直连；生产办公终端必须实际验证 SDK、搜索、瓦片可达。Key 按用户决定保存在 application.yml，不得在文档、日志或截图回显；Web 服务 Key 不下发浏览器 | S-GIS-002、009、NFR-GIS-007 |
| R-GIS-058（2026-10-24 退役） | 原“数据管理版本行预览原 CAD”（kkFileView 短时票据＋同源代理）已按用户决定整体退役：预览按钮、POST /gis/drawings/{drawingId}/versions/{versionId}/preview、preview-source 回源、preview-view 代理、com.bokun.gis.preview 运行面、DXF 预览编码归一化及 gis.cad.preview.* 配置全部删除；旧地址不再返回文件。源文件受控下载（gis:drawing:download＋工程范围）保留。后续原始 CAD 预览通过 BIM 引擎建设，本期不实现，也不保留占位按钮、空页面或空接口 | 2026-10-24 用户决定 |
3.3 2026-10-25 简化优化规则
| 编号 | 规则 | 来源 |
|---|---|---|
| R-GIS-059 | 图纸资产只向业务用户暴露一个展示状态（处理中/待定位/待发布/已发布/失败）和一个主按钮；任务、就绪、坐标、当前版本等技术状态只在“处理详情/更多”中展示。已发布资产存在更新候选时保持“已发布”，候选状态只作为徽标，不改变当前地图成果 | 2026-10-25 用户决定 |
| R-GIS-060 | 所有图纸统一人工高德配准，不做 CRS 自动识别和上一版继承；固定 3 点相似，不向用户暴露“相似/仿射”选择。三点残差显示某点明显异常时提示重选该点；显示“可能不是等比缩放”时由系统建议改用四点仿射，用户不需要在开始时选择方法 | 2026-10-25 用户决定 |
| R-GIS-061 | 全线图纸使用高德 AMap.LineSearch 搜索整条线路，归并上下行和一期/二期，以站点作为锚点，默认选 3 个跨线站点；工点图纸使用站名/工点名/地址自定义搜索 3 个地物。线路检索在浏览器直连高德，不新增后端代理；线路参考线不宣称是轨道中心线或测量成果 | 2026-10-25 用户决定 |
| R-GIS-062 | 线网地图无图时只显示一个空态卡片，说明“无已发布图纸 / 有图纸待定位或待发布 / 处理失败 / 底图不可用 / 搜索无匹配”等原因并给出对应动作；统计只覆盖当前账号有权范围，不返回未授权图纸名称或数量 | 2026-10-25 用户决定 |
| R-GIS-063 | 失败提示必须包含可执行原因和下一步，提供重试或重新上传；原始异常、SQL 和内部类名不进入主列表。重试不新建图纸资产，重新上传带入原工程归属 | 2026-10-25 用户决定 |
| R-GIS-064 | 图纸台账状态保持单行，提供删除图纸操作，图纸删除后其全部图层从台账与地图中移除；删除需图纸维护权限和工程范围授权，存在业务绑定或排队/运行任务时拒绝。历史版本、不可变修订及源文件保留，不删除关联业务单据 | 2026-10-26 用户要求及引用保护约束 |
| R-GIS-065 | 图层台账在工程导航范围内增加可搜索的图纸导航，选择图纸筛选所属图层；目录覆盖该范围全部可读图纸，不受图纸台账当前分页限制。切换工程范围后清除旧图纸筛选 | 2026-10-26 用户要求 |
| R-GIS-066 | 线网地图打开时按场景配置的初始显隐展示图层：全部图层模式使用“打开时显示全部图层”开关，自选图层模式使用每层初始显隐；保留目录，允许逐层显示/隐藏，并按图纸卡片提供“全部显示/全部隐藏”，只作用于该图纸下的图层，不受搜索关键词限制；刷新保留用户选择，显式图层定位可显示目标图层，临时显隐不修改公共配置 | 2026-10-26 用户要求 |
| R-GIS-067 | 配准工作台上方原始 CAD 与高德地图左右各占一半，下方业务操作横向铺满；1920×911 视口下点对表全部列与操作可见，候选搜索结果在业务区内展示，不遮挡地图、点对或确认操作 | 2026-10-26 用户要求 |
| R-GIS-068 | 解析缺项必须定位到具体 CAD 实体：至少给出图层、源实体句柄、模型空间坐标或包围盒、原因及适用时的环/段号；任务详情展示“问题明细”，错误信息同步带出可定位摘要，设计方可在 CAD 中按句柄或坐标直接找到问题对象 | 2026-10-26 用户要求 |
| R-GIS-069 | 线网地图即系统默认地图场景（SYSTEM_DEFAULT），不另建第二套默认地图。其允许底图、默认底图、业务图层组合、底图注记和默认视角统一从地图场景配置读取；默认入口与显式场景入口走同一运行解析口径 | 2026-10-26 用户决定 |
| R-GIS-070 | 地图场景业务图层组合支持“全部图层”和“自选图层”。全部图层模式不写逐层关系，自动纳入场景工程范围内全部已发布且当前账号可读的图层，新发布图纸自动纳入；自选图层模式保留逐层顺序、初始显隐、透明度和可选性 | 2026-10-26 用户决定 |
| R-GIS-071 | 场景工程范围同时约束自选图层和全部图层的归属；保存、预览和运行均校验图层线路/工点范围。打开非 PUBLIC 场景须具备对应整线或工点范围，场景配置不能扩大资源授权 | 2026-10-26 实施约束 |
| R-GIS-072 | 默认视角支持“工程范围适配”和“固定中心/范围”。工程范围适配按场景可读图层的主体范围打开，剔除远离主体的离群图层并提示数量；完整范围单独保留，供“查看完整范围”使用。固定视角支持中心点、范围、初始缩放和最小/最大缩放 | 2026-10-26 用户决定 |
| R-GIS-073 | 线网地图目录由场景接口一次下发，包含当前场景可读图纸、图层、范围、样式和初始显隐；地图按视野与缩放级别加载图层，限制并发取图，不因“全部图层”一次性请求全部图纸全部图层 | 2026-10-26 性能约束 |
| R-GIS-074 | SYSTEM_DEFAULT 场景编码由系统保留，不允许新建、改编码、停用或删除；可修改名称、底图、图层组合、注记和默认视角。默认底图不可用时明确提示并切换到可用底图，不静默失效 | 2026-10-26 实施约束 |
| R-GIS-075 | 底图注记为场景级初始开关，仅对带独立注记层的 WMTS 底图生效；矢量样式底图注记随样式，界面明确提示，不把无效开关显示为可用 | 2026-10-26 实施约束 |
4. 地图与图层需求
| 编号 | 规则 | 来源 |
|---|---|---|
| R-GIS-001 | 支持地图缩放、平移、比例尺、工程定位和范围适配；初始位置由合法工程范围或受控配置确定，不固定某张示例图 | S-GIS-001 |
| R-GIS-002 | 一张图 WMTS 的覆盖范围、层级、分辨率、坐标及显示效果以服务元数据和样本核对；来自倾斜摄影的 WMTS 仍是图片，不能宣称能旋转查看真实建筑立面 | S-GIS-002、005 |
| R-GIS-003 | 切换可用底图不改变业务几何、工程归属、专业归属和业务关联；无可用备选时明确提示，不偷偷使用未授权公网底图 | S-GIS-002 |
| R-GIS-004 | 区分底图、CAD 来源图层、人工标绘；按业务专业组织图层，支持显隐、顺序、透明度和受控样式 | S-GIS-001、006 |
| R-GIS-005 | 底图不可作为业务图元编辑；图层的可见、可选与可编辑分别控制。查看人员临时调整显隐、透明度及顺序只作用当前视图，不写成公共配置；维护公共配置另检查权限。关闭图层不改变授权 | S-GIS-003、006 |
| R-GIS-006 | 图层、要素及统计仅返回有权访问的数据；不为显示一棵完整图层树而返回未授权图层名称、数量或范围 | S-GIS-003 |
地图内图层面板用于当前视图的显隐、选择、定位等快捷操作；独立“图层管理”页面用于公共定义、专业归属、源层映射与样式维护。两者引用同一图层事实，具体分工见第 3.1 节及详细设计，最终布局遵循界面规范。
5. CAD 全解析与坐标需求
5.1 文件与图元完整性
R-GIS-007：沿用旧规格的 AutoCAD 2004—2024 DWG/DXF 兼容目标。应用软件年份与文件格式版本不是同一概念，验收必须记录实际编码版本和对象类型。是否已覆盖以真实样本矩阵为准，不以解析器宣传或文件能打开为准。
R-GIS-008：至少覆盖旧规格指定的点、多段线（含 LWPolyline）、样条曲线、MText、Insert 和 Hatch，并处理实际图纸中的直线、圆、圆弧、文字及相关基础属性。处理要求如下。
| 内容 | 保留与转换要求 |
|---|---|
| 图层和属性 | 保留原始图层名、颜色/线型/线宽的来源与继承关系；地图样式覆盖不破坏来源信息 |
| 块与嵌套块 | 正确应用插入点、比例、旋转及坐标变换；保留块定义/引用和源图元关联，防止全部重叠到原点 |
| 曲线和多段线 | 正确处理弧段、闭合与曲线参数；显示离散化有明确误差口径并保留源语义，不随意直线代替 |
| 文字及中文 | 保留文本内容、位置、方向及必要样式；缺字体、乱码或格式损失明确列出；字体资源具备可用来源 |
| 填充 | 保留边界、孔洞及必要填充表达；不得将孔洞当实心，或把开放边界直接当合法面 |
| 源标识和坐标 | 保留文件版本、图元标识、源图层、源几何、单位与相关 Z 值；保留 Z 不表示本期提供三维 CAD 编辑 |
| 外部参照与特殊对象 | 识别依赖、代理/自定义对象、布局等样本内容，列出处理结果；其展示和提取要求按 Q-GIS-002 样本清单明确，不默认丢弃 |
R-GIS-009：全解析成果须能分层展示、检查属性和追溯来源；仅显示 PNG/PDF/SVG 整图或把图纸作为图片贴图，不满足可操作的 CAD 矢量成果要求。
R-GIS-010：检查结果至少区分源对象、转换成果、未支持对象及失败对象。块展开和曲线离散化导致数量变化时应说明对应关系，不能以转换后图形数量等于源图元数量作为唯一完整性标准。
R-GIS-011：未支持对象不得静默跳过。形成缺项清单；未满足验收范围的成果不得自动进入有效版本。允许查看受控预览进行排错，但预览不是解析验收通过。真实图纸提出的能力缺口不得由实施者自行降级为“不支持也算完成”。
R-GIS-012：原始文件保持不变。处理结果、转换规则及版本可追溯；新图纸不得直接覆盖上一有效成果。源几何与人工调整分离，换版后保留人工成果；无法确定对应关系的变更明确列为冲突，不能靠图元顺序、相同名称或默认最近距离静默合并。
全解析要求完整识别、提取、表达和追溯验收范围内的 CAD 内容；地图编辑针对其可编辑几何及属性，不等于提供 AutoCAD 的全部制图命令，也不隐含 DWG/DXF 原格式回写。文字、填充、块等内容不能因为暂不提供专业制图命令而在解析时丢弃。旧规格的换版差异对比与人工覆盖合并仍保留：明确展示新增、删除、变化和冲突，只有证据充分的对应关系可自动迁移。
5.2 坐标及精度
| 编号 | 规则 |
|---|---|
| R-GIS-013 | 分开记录源工程坐标、地图显示坐标、平台交换坐标、单位、轴序和必要高程说明；V2 版本源空间固定为 CAD_LOCAL_PLANE，目标为 GCJ-02，平台派生为 EPSG:4326，不混装 |
| R-GIS-014 | 新路线不要求识别重庆独立坐标，也不以获取涉密参数为前提；不能凭数值范围猜测源 CRS。人工目视确认只作为参考定位使用，不得宣称工程测量精度 |
| R-GIS-015 | 未知坐标可完成文件级解析与检查；可用性以人工目视确认为准，界面记为“已人工确认”，不得表述为测量精度合格；误差记录保留算法及参数版本 |
| R-GIS-015A | 允许无独立检查点保存参考配准；不设精度阈值门槛，不强制独立检查点或第三方复核；确认动作记录操作人、时间和版本 |
| R-GIS-015B | 版本级状态权威：保存 REFERENCE、确认 VERIFIED、清除 UNVERIFIED。图纸台账所需的状态、说明和修订从 CURRENT_VERSION_ID 对应版本读取，不再维护图纸级配准镜像列 |
| R-GIS-015C | GEOREF_REVISION 表示配置/状态修订，保存、确认、清除各递增一次；确认不重新派生几何，继续引用原派生对象。派生对象按修订保留，不覆盖旧对象 |
| R-GIS-016 | 保留源几何，避免重复重投影累计误差；二维显示的米制尺寸和面积不直接用经纬度平方计算 |
| R-GIS-017 | 旧规格 0.05 米相对误差、0.2 米绝对误差与 0.5 米否决阈值互有口径差异，均不直接宣称满足。按 Q-GIS-003、010 明确适用尺度、输入/底图精度、计算方法及验收阈值 |
坐标转换及合法性校验不属于本期排除的复杂空间分析。
5.3 旧入图实现（历史，2026-10-22）
以下为旧路线在开发环境打通的链路，保留作历史证据，不构成 R-GIS-007～017 的验收结论；新路线见 5.4：
- 文件：支持 DWG（LibreDWG 0.14
dwg2dxf转为 DXF）和 DXF；原始文件保留在受控本地目录，入库记录 SHA-256、格式、大小、源目标 CRS 和转换参数。 - 图元：LINE、LWPOLYLINE、POLYLINE、ARC、CIRCLE、SPLINE、ELLIPSE、HATCH 边界、POINT、TEXT/MTEXT；递归展开 INSERT（含嵌套，限制深度）并处理图层 0 的继承；文字单独拆为“注记”图层，默认隐藏、15 级后可见。
- 追溯：要素保存源图元 handle、源图层、源颜色、线型和源图层名；显示用短线段按端点合并为连续折线，合并记录源图元数量，源文件不改写。
- 坐标：27 号线 DWG 含 18 个绝对坐标标注（CGCS2000，中央子午线 106.5°、东坐标加常数 500000）。旧参考方案由这些标注反算 CAD 到 WGS84 的相似变换（Web Mercator 空间，scale≈1.14223、rotation≈-0.6014°，标注拟合残差约 36m RMS），15/24 号线沿用同一参数。2026-10-22 高德站点/线路几何对照显示该共用参数仍有明显偏差，且 CAD 站名表不能作为控制点；因此该方案只保留为参考定位，不再作为工程精度依据。当前新增的是版本级人工/高德辅助配准，参数保存在
GIS_DRAWING_VERSION.GEOREF_CONFIG，状态为REFERENCE；图纸级旧GEOREF_*已物理删除。标定方法和边界见详细设计。 - 未完成：AutoCAD 2004—2024 全格式与对象覆盖、外部参照/代理对象/布局、字体与样式保真、精确弧段/填充语义、换版差异与人工覆盖合并、官方坐标参数与精度验收、异步任务队列和容量治理。上述缺项不得以“已能打开图纸”替代。
2026-10-21 已实现异步接收链路：POST /gis/drawings/receive 创建图纸资产、版本、工程范围清单和处理尝试，提交受限线程池执行；任务状态按 QUEUED → RUNNING → SUCCEEDED / FAILED / NEEDS_INPUT 推进，服务重启后未完成任务标记 INTERRUPTED 并允许重试。候选版本经成果检查后由 POST /gis/drawings/{drawingId}/versions/{versionId}/activate 原子切换为当前有效版本，旧版本与源文件保留。旧的同步 /gis/drawings/import 写入口已退出（POST 返回 405），不再保留第二套发布实现。生产大图纸的容量、并发、租约和队列恢复仍待 Q-GIS-007 冻结。
15号线 文件的原始单位为米（$INSUNITS=6），24 号线文件头标记毫米但几何尺度为米，当前按米处理；该差异需在正式样本矩阵中核对。
5.4 2026-10-23 高德配准新路线实现
- 原始权威输入：新上传版本写
COORDINATE_PIPELINE=AMAP_V2，解析器只生成原始平面清单，不再生成旧显示成果，也不使用 pyproj 或任何默认粗转换参数。原始清单coordinateSpace=CAD_LOCAL_PLANE，不投影、不简化、不合并，保留源图层、稳定实体键、块实例路径和单位；采用CHUNKED_V2图层内有界分块，根清单记录块范围、引用、摘要和数量，读回 SHA-256 一致后才记录引用。 - 配准：版本工作台左侧原始 CAD 平面、右侧固定高德；支持线路名＋站名查询多个候选、选用候选后点一次 CAD 成对、地图手工取点、单侧重选、删除和至少 3/4 对预览。拟合在
GCJ02_WEB_MERCATOR专用平面进行，源点不按经纬度校验，不使用旧固定 0.2～5 比例限制。 - 派生与确认：保存时服务端重新拟合，完整几何
CAD x/y → 配准矩阵 → GCJ 墨卡托 → 反投影 GCJ → 本地近似逆算 WGS84，写EPSG:4326派生分块清单到oss:gis/versions/<versionId>/georef/<revision>/display-v2.json并回读摘要。保存REFERENCE，人工确认VERIFIED，清除UNVERIFIED；确认只推进修订，不重新派生。 - 生效：V2 版本生效读取派生清单并写入当前版本的图层/要素；同版重配准按源图层名和稳定实体键匹配，保留 layerId/featureId、样式、目录归属、属性和绑定，同时新增不可变修订并仅条件更新当前修订指针，不覆盖历史几何；手工属性按白名单合并，不用原始
propertiesJson覆盖人工值。当前版清除只撤销地图输出，保留版本、图层、要素和源文件。 - 原始 CAD 预览（2026-10-24 已退役，历史记录）：新路线初期曾实现“预览原 CAD”（后端短时凭据＋kkFileView 回源），预览与解析、配准、生效状态解耦；该能力已于 2026-10-24 按用户决定整体移除，后续由 BIM 引擎承担。kkFileView 的 CAD 转换建议使用 PDF 模式的经验仅作历史记录，不再构成当前部署要求。
- 页面入口：数据管理 → 图纸行“更多” → 版本 → “配准”/“预览原 CAD”。上传不再选择坐标方案，图纸级配准、坐标定义/转换方案菜单和后端高德候选接口均已退出。
- 已验证（2026-10-24 收尾整改后）：开发库用合成 DXF 和真实 DWG 完成上传 → 原始解析 → 高德多候选配准 → 保存/确认 → 检查/生效 → 三套底图展示；同版重配准保持图层/要素 ID、名称、颜色、线宽、归属、手工属性和绑定；大图 12,200 图元按 41 个分块读取，根清单约 13KB。权限探针、撤权、无专题场景、任务失败注入、激活影响哈希和原始 CAD 预览完成页面/接口验证。2026-10-24 修复预览代理任意资源转发越权（静态资源白名单＋文档成果与票据 nonce 精确绑定＋file 参数同约束＋路径规范化＋重定向逐跳重校验＋源摘要核对），修复后矩阵与单测验证拒绝均为真实 403/400 且无字节泄露；开发服务器安装 LibreDWG 0.14 并经
GIS_DWG2DXF_COMMAND注入后，用户提供的真实 DWG 从页面重试完成转换解析（1,191 图元/24 秒）→ 高德配准 3 对（RMS 114 m）→ 保存/人工确认 → 检查 0 错误 → 生效 → 监管中心 500 m 比例尺地图正确叠加展示。后端 GIS 186 项测试通过；前端构建、lint 和全工程类型检查通过。生产环境、生产数据库、生产办公终端网络未验证。 - 未完成：AutoCAD 2004—2024 全格式与对象覆盖、外部参照/代理对象/布局、字体与样式保真、生产办公终端网络、生产库发布；kkFileView 的未授权/不可达/转换失败只完成代码与接口边界验证，正式部署的 PDF 转换模式和源站信任仍需按环境配置并复验；Aspose.CAD 评估许可下水印与出图范围（源文件含远端离群实体）未解决，预览画面效果验收受阻；受限账号的 A/B 权限差异化越权矩阵以单测覆盖，未在页面复演。
6. 标绘编辑与保存需求（本期未实现）
线网地图本期为纯查看；以下编辑、要素绑定写回和协同冲突要求保留为后续能力，不作为当前页面或接口验收依据。
| 编号 | 规则 |
|---|---|
| R-GIS-018 | 支持选择、点线面绘制、顶点编辑、移动、旋转、缩放/拉伸和删除；面要素提供八个变形手柄，支持轴向拉伸与等比缩放；CAD 来源图形以可追溯覆盖成果承载修改，不回写损坏原文件 |
| R-GIS-019 | 保留旧规格的顶点、边线垂足、中点及授权参考红线捕捉，支持开关、撤销与重做；保留宽度/长度/角度数值输入、保持比例、固定锚点和拖拽伴随尺寸。适用几何、单位、角度基准、容差与精度按 Q-GIS-010 固定，不能把已明确功能退为可选或用插件演示代替验收 |
| R-GIS-020 | 支持名称、样式及工程业务关联的必要维护；不在 GIS 新建重复工程主数据或自由文本参建单位体系 |
| R-GIS-021 | 编辑存在未保存变更提示；取消或离开时明确处理未保存内容。保存失败、超时和并发冲突保留会话草稿，不假报成功 |
| R-GIS-022 | 保存由后端重新检查操作权、工程与专业归属、版本和几何合法性；前端校验不代替后端。未闭合、退化、自相交及非法坐标按几何类型给出具体错误 |
| R-GIS-023 | 保存成功后刷新页面仍能还原几何、样式及关联；一次变更集不允许部分成功后界面显示全部成功 |
| R-GIS-024 | 并发更新不能无提示覆盖；重试同一次保存不得重复新增图形。草稿与持久化成果明确区分，不承诺未经确认的跨设备草稿同步 |
| R-GIS-025 | 图形关联业务变更或删除前检查引用关系；不得级联删除进度、质量或安全业务单据。被引用成果的删除/替换策略在详细设计固定 |
编辑作用于实际授权的完整要素，不能对视口裁剪或简化后的片段直接覆盖原几何；锁定/只读图层可按授权作为捕捉参考，但不能被编辑。自相交的面不能保存为有效面；线的交叉、线的闭合或多图元之间相交不应一概判为非法。尺寸显示不代表工程配准精度已经合格。
7. 工程范围与专业隔离
本期只启用线路/工点数据范围与功能权限；专业权限、专业矩阵和专业隔离仍保留为后续能力，未在 GIS 页面启用。以下专业规则不得作为当前实现已完成的依据。
7.1 数据过滤定性
GIS 工程成果采用工程数据授权，并叠加 GIS 专业访问控制。平台通用身份和授权底线按业务地图与公共约定执行；不恢复部门角色数据范围。
页面增多不增加一种全局放行权限：图纸、任务、图层、要素及含工程信息的转换参数/控制点按各自真实工程和专业受控；纯公共底图元数据、公共 CRS 定义由对应配置功能权控制，不虚构工程专业归属。公共定义中不得夹带受控工程信息，管理端配置 DTO 与普通用户可用配置 DTO 分开。专业授权维护的候选范围仍受可授予上限约束。
| 编号 | 规则 |
|---|---|
| R-GIS-026 | 读取、编辑、导入、导出、下载分别检查适用的功能动作权限；不能用已有 gis:service:query 覆盖全部写入动作 |
| R-GIS-027 | 专属成果按有效标段工点组合判定，共享工点成果按共享资源判定，整线完整成果按整线授权判定；不得将线路、标段、工点三个独立条件 OR 放行 |
| R-GIS-028 | 普通用户须同时满足功能权、工程范围、资源专业与允许动作；专业授权不能扩大工程范围。系统管理员例外沿用平台真实规则，不从单位名称或前端身份字段推断 |
| R-GIS-029 | 专业支持只读参考与维护能力区别，允许明确授予多个专业；一个工程的某专业权限不能被组合成另一个工程的专业权限 |
| R-GIS-030 | 使用现有专业主数据；综合专业和细分专业的包含关系显式配置/确认，不按名称或编码前缀猜测。专业与“征地/参考”等图层用途分类分开，后者不自动生成行业专业 |
| R-GIS-031 | 未归类专业、未知资源范围、空授权或校验异常均默认拒绝相关数据访问。公共底图不因此成为工程成果默认公开的理由 |
| R-GIS-032 | 专业控制覆盖图层目录、要素几何/属性、详情、进度、统计、任务检查结果、导出、下载及缓存；未授权数据不下发，前端隐藏不是隔离 |
当前实现状态（2026-10-24 专业范围权限取消后有效）：已实现功能动作权限 gis:scene:query、gis:drawing:list/query/upload/edit/download、gis:layer:list/query/edit、gis:feature:list/query/edit/export、gis:task:list/query/submit 及配置类动作；图纸、图层、要素查询已通过 GisEngineeringAccessPort 叠加线路/整线/标段工点组合判定，未纳入授权范围的数据不下发。原始整文件下载按"功能权限＋工程范围"执行：普通用户具备 gis:drawing:download 且工程范围覆盖该图纸即可下载原始 DWG/DXF；专业代码、专业授权记录、FILE_PROCESS 授权与归类证据均不参与判定。超级管理员沿用平台例外。原 kkFileView 在线预览链路已于 2026-10-24 退役，不在当前能力范围。专业授权矩阵（R-GIS-026～032 的专业控制部分）与 Q-GIS-004 专业政策已按用户决定整体取消：专业授权存储、判定接口、维护页面和未归类拒绝逻辑已于 2026-10-24 从代码与页面退出，GIS_AUTH_SUBJECT/GIS_PROFESSION_GRANT 表已于 2026-11-02 从开发库删除，生产库原不存在；下文 R-GIS-026～035 中涉及"按专业限制访问"的要求随之作废，仅保留其中功能权限、工程范围与"未授权数据不下发"的通用原则。
7.2 文件与混合专业成果
R-GIS-033：混合专业 CAD 必须按实际成果分类后受控分发。只拥有一个专业的查看权，不代表可以获得含其他专业的原始 DWG、完整 GeoJSON、转换包、预览图或解析报告。
R-GIS-034：原始文件整体下载应具有该文件全部受控内容的访问权，并具备下载动作权限；无法安全拆分的成果不提供“部分授权整包下载”。通用附件接口、对象存储地址和预览入口不能绕过 GIS 资源鉴权。
R-GIS-035：图层包含多个专业时需进一步过滤要素，或拆分为具有明确授权边界的成果图层。专业映射、工程归属和授权变更后重新核对结果，旧缓存不能继续向无权人员分发；已被合法下载的数据不能承诺远程撤回。
未归类图纸进入隔离检查范围，不进入普通地图查询。检查人员必须具有明确的图纸检查/归类职责、覆盖文件工程范围的权限，以及经授权的文件整体处理范围；上传者身份或单专业维护权不自动产生整包读取权。该处理授权仅用于受控分类，不把未分类成果默认公开。具体授权主体在 Q-GIS-004 中一并确定。
7.3 代表性权限矩阵
| 功能权 | 工程范围 | 专业权限 | 预期 |
|---|---|---|---|
| 无读取权 | 任意 | 任意 | 拒绝地图工程数据接口 |
| 有读取权 | 不命中 | 命中 | 拒绝该工程成果 |
| 有读取权 | 命中 | 不命中/未归类 | 不返回该专业成果及数量、附件 |
| 有读取权 | 命中 | 只读参考 | 可看，不可改；导出/下载另校验 |
| 有编辑权 | 命中 | 允许维护 | 可编辑允许范围内的成果 |
| 有编辑权 | 命中 | 只读参考 | 拒绝写入，即使直接调用接口 |
| 有下载权 | 命中 | 仅命中混合图纸部分内容 | 拒绝整份源文件，不能用直链绕过 |
不同专业的具体授权角色与范围见 Q-GIS-004；上表不能替代该业务决策。
8. 业务详情与进度着色（本期暂缓）
真实进度源未接入，专题配置不作为本期菜单入口；保留后续驾驶舱阶段的业务口径。
| 编号 | 规则 |
|---|---|
| R-GIS-036 | 使用稳定业务 ID 绑定工程对象，不能用工点名称、图层名称或临时数组索引关联。一个工点可有不同标段/专业成果，不混为同一业务记录 |
| R-GIS-037 | 点选图形加载其有权查看的业务摘要，提供适用详情入口；原业务接口继续执行自身权限，地图授权不授予额外业务权 |
| R-GIS-038 | GIS 只消费业务进度，不重复计算价格/权重完成率或新建地图进度填报。进度来源、期次、对象粒度、状态及颜色按 Q-GIS-005 固定 |
| R-GIS-039 | 一图多业务的聚合、优先级及冲突处理必须明确；无数据、未关联、加载失败与真实业务状态分别表达，不能把空值当“正常/未开工” |
| R-GIS-040 | 显示进度图例和数据时间；刷新进度不丢编辑内容。手工样式与进度专题样式分开，取消专题后恢复原样式 |
| R-GIS-041 | 主系统与驾驶舱共用数据及鉴权口径；驾驶舱默认查看、定位和联动，不复制全套编辑工作台；隐藏编辑按钮之外仍需后端拒绝无权写入 |
进度监管需求存在平面完成图与 GIS 绘制方式待确认项 Q-PS-008；其旧版树结构和权限叙述不作为 GIS 当前基线。不能把 BIM 进度任务当作已确定的 GIS 进度来源，也不能把相对图片坐标直接当作地理坐标。
当前实现已提供要素台账、属性维护与业务绑定存储；本期 GIS 不提供专题配置、专题数据源或场景专题字段。地图尚未按业务进度着色，要素与业务详情的联动入口、驾驶舱场景消费和统计聚合仍待 Q-GIS-005 与业务接口明确。
9. 二三维演进需求
| 编号 | 规则 |
|---|---|
| R-GIS-042 | 本期二维浏览与编辑以 OpenLayers 路线设计；统一工程、专业、几何、版本及业务关系保持与渲染引擎分离 |
| R-GIS-043 | 未来取得标准可解码 3D Tiles 时可增加 CesiumJS；若只能使用一张图专用解密 SDK，则适配该 SDK。保密协议与内网连通不自动等于开放数据格式或解密能力 |
| R-GIS-044 | 后续三维定位、图层、进度及详情复用同一业务事实；需另验证高程基准、贴地/离地、遮挡、相机和样式，不能承诺二维编辑交互自动变为三维编辑 |
| R-GIS-045 | 受限三维资源仅在获准网络和客户端提供，不经公网应用或公共代理转发；无三维能力时保持二维可用，不伪造三维按钮可用状态 |
未来三维功能交付以 Q-GIS-008 的资源条件和另行明确的范围为前提。本期验收只验证扩展边界与业务数据独立性，不要求接入尚未开放的三维服务。
10. 非功能需求与异常
10.1 非功能规则
| 编号 | 要求 |
|---|---|
| NFR-GIS-001 | 原始图纸、业务矢量及属性保存在平台纳管环境；不得发送给在线第三方 CAD 转换服务。开源库依赖不等于授权引入新的外部业务服务 |
| NFR-GIS-002 | 新选运行组件采用免费开源方案；字体、插件和转换依赖分别核对许可证。已购超图仅按 Q-GIS-009 处理，不构成引入其他闭源依赖的授权。免费软件、开源软件和免费在线服务不可混同；不能以独立进程为理由直接判定许可证义务消失 |
| NFR-GIS-003 | 生产依赖固定版本，本地部署脚本、Worker、字体和符号；外部底图仍受其服务条件限制，本期不承诺外部数据完全离线 |
| NFR-GIS-004 | 源文件处理异步执行，隔离资源、时长、大小和并发，上传格式按内容检查；特殊文件失败不拖垮主业务 |
| NFR-GIS-005 | 日志与审计记录主体、资源、动作和结果；凭据、原始完整几何、敏感文件内容不进入普通日志或文档 |
| NFR-GIS-006 | 浏览器兼容性沿用平台支持范围；测试普通办公终端和大图纸。文件大小、图元/顶点数、终端、并发及响应目标按 Q-GIS-007 固定，不虚构已通过性能指标 |
| NFR-GIS-007 | 故障区分底图、业务接口、解析任务和权限错误；仅对可重试故障有限重试。用户数据不会因底图超时被清空 |
10.2 异常和恢复
| 异常 | 系统行为 | 恢复方式 |
|---|---|---|
| WMTS 超时、鉴权失败、跨域或层级不可用 | 明确底图状态，保留业务图层与编辑会话；不把错误响应当空地图成功 | 受控重试或切换已配置且获准的备选 |
| CAD 不支持、依赖缺失、字体异常或资源超限 | 保留源文件及具体检查结果，不激活不合格版本 | 修正依赖/配置或补足解析适配后创建可追溯重试 |
| 坐标未知或误差超标 | 不标记定位合格，不覆盖有效版本 | 补参数与控制点，重新转换验证 |
| 专业归属缺失/工程关系失效 | 拒绝普通分发或写入，明确原因 | 授权人员修正归属并重新校验 |
| 保存失败、版本冲突或请求结果未知 | 不假报成功，保留草稿，按保存请求标识确认结果 | 重新读取版本/请求结果后恢复，禁止盲目重复新增 |
| 业务数据源未接通或不可用 | 显示未接入/加载失败，不生成真实进度或正常状态 | 数据源恢复后重取，不用 Mock 冒充正式数据 |
| 访问权被撤销 | 后续请求拒绝，清理无权展示与缓存，不继续自动提交本地修改 | 重新核验权限后操作 |
11. 验收标准
当前均为验收要求，尚无完整功能运行通过结论。浏览器、接口、纳管数据回读和文件检查按各自证明范围取证。
开发环境已执行的阶段性验证仅覆盖以下范围，不等同于 AC-GIS-001～025：
| 范围 | 已观察结果 |
|---|---|
| 天地图 WMTS | 真实浏览器中矢量/影像底图出图，注记显隐、缩放、比例尺、图元坐标显示正常 |
| CAD 样图 | 15/24/27 号线三份 DWG 经 LibreDWG→DXF、ezdxf/pyproj 入图；15 号线 677 个图元/18 层，24 号线 754/11 层，27 号线 11,740/38 层；以 15/27 号线已知站点验证，最近距离 60–499m |
| 图层与要素 | 图层目录、显隐、按视野 bbox 查询、低缩放提示、图元弹窗和源 handle 显示正常；27 号线注记图层在 15 级后可见 |
| 权限 | 接口执行功能权限注解；工程范围与专业隔离未实现，未做权限矩阵验收 |
| 未验证 | CAD 全格式/全对象覆盖、坐标精度、要素编辑与保存、真实进度联动、驾驶舱、性能容量、三维 |
| 2026-10-21 第二轮（页面与生命周期） | 异步接收→解析成功→成果检查→设为当前有效版本在真实浏览器完成；图层管理 72 条图层、15 号线物理工点导航正常；图纸/任务/底图/坐标/方案/场景/专题/授权/要素页面从菜单或直接地址打开均可渲染；GIS 模块单元测试通过；发现并修复专题列表空关键字空指针、首版生效参数校验和隐藏子页面路由三类缺陷。专业授权执行、要素修订历史数据、场景真实出图与专题真实数据仍未验证 |
| 2026-10-21 第三轮（简化模型） | 菜单收敛为 5 页；物理工点树按 SITE_MASTER_ID 唯一，15 号线显示 82 个工点；数据管理合并四页并完成图层整层移动；坐标/底图读库、三条底图记录和 OpenFreeMap 矢量样式在真实浏览器验证；历史版本回填参考定位；GIS 模块测试、前端构建、lint、文档检查通过。专题、驾驶舱、业务覆盖和三维未做 |
| 2026-10-22 第四轮（可用性修正） | 监管中心移除工程目录，图层面板与底图选择合并；数据管理恢复左侧工程目录样式并调整台账列宽；开发库补齐 3 条坐标定义和 15/24/27 号线 3 条转换方案，修复转换方案页签首次加载被工程树阻塞、操作列因 checkPermi 未导入而不渲染的问题；底图服务协议可选择、Key 环境变量名可录入，矢量服务可编辑，操作区收为“查看/修改/更多”；地图场景新增后列宽保持不变，并修复无默认底图/专题时创建场景的空指针；5 个 GIS 菜单图标补齐。真实浏览器完成上述页面操作，GIS 定向单测 32 项、前端 lint/build 和文档检查通过。测试场景已删除，未改生产库 |
| 2026-10-22 第五轮（底图坐标系） | 底图服务配置新增 CRS_ID 并回填三条启用底图为 EPSG_3857；坐标系与转换方案新增 Web Mercator 坐标定义（公共、通过），底图列表和编辑表单可查看/选择坐标系。高德站点及线路几何对照确认现有 15/24/27 共用参考参数与 CAD 实际线路存在明显偏差，且 CAD 站名表位置不能直接作为控制点；未据此写入新转换方案，也未把旧方案标记为已验证。真实浏览器验证坐标系列与表单回显；GIS 全量 185 项单测、前端 lint/build 和文档检查通过。 |
| 2026-10-22 第六轮（图纸级配准） | 数据管理图纸行新增图纸级配准对话框：CAD/底图人工取点、相似/仿射拟合、实时预览、残差显示、保存/清除；监管中心保持纯查看并应用已保存校正。配准参数存 GIS_DRAWING.GEOREF_CONFIG，状态为 REFERENCE，显示和视口 bbox 按图纸校正，不改原始要素和旧转换方案。新增服务端高德站点候选（GCJ-02→WGS84，Key 走 GIS_AMAP_WEB_SERVICE_KEY）。真实浏览器完成取点、预览、保存、刷新回读、显示校正、高德候选和清除验证；测试配准已清理。GIS 全量 188 项单测、前端 lint/build 和文档检查通过。 |
| 2026-10-22 第七轮（导航与镜头） | 监管中心移除配准入口；数据管理改为线路工程导航（在建默认/规划/运营），移除导航内上传 CAD，图纸/图层台账按 1920×911 平铺并加宽关键列。底图服务配置新增初始镜头高度，三条底图设为 13 级，场景首次打开使用该值。真实浏览器验证状态分类、导航、表格列、底图表单和监管中心无配准入口；GIS 全量 189 项单测、前端 lint/build 和文档检查通过。 |
| 2026-10-22 第八轮（菜单路由清理） | 开发库 SYS_MENU 删除 9 条旧页面路由和 9 条废弃按钮权限，清理 32 条角色关联；迁移 19 条保留按钮到数据管理、坐标系与转换方案和 GIS 根目录，并补回“任务列表”“方案列表”两个列表权限。当前 5 个菜单按监管中心、数据管理、坐标系与转换方案、底图服务配置、地图场景配置排序；通用查看按钮只保留在根目录，旧路由直接访问返回 404。真实浏览器验证菜单、旧路由、图纸详情返回保留线路上下文、校准返回转换方案页签；前端 lint/build 和文档检查通过，权限检查无前端越界错误。 |
| 2026-10-23 第九轮（易用性与存储迁移，历史） | 配准改为双画布逐对取点并过滤辅助标记；监管中心增加检索、逐层状态、逐层重试和刷新保留；数据管理增加整线/工点徽标、范围标签、动作收敛和返回上下文；上传表单先文件后归属；任务页有限轮询并直达检查；检查页四状态与“换版将失效”清单；图层保存样式优先、条件更新和临时预览；校准页未知状态不再落到超限。底图检查分结构/元数据/出图三层；场景支持线路/工点选择器和显式 sceneId 运行；源文件写 MinIO（oss: 路径），启动时迁移历史文件；天地图 Key 存 GIS_BASEMAP_SERVICE.CREDENTIAL_VALUE，运行参数存 SYS_CONFIG。已验证：后端编译、前端生产构建、监管中心/数据管理/检查页/样式预览浏览器操作、对象存储下载 1,457,541 字节与历史三版本迁移回读。底图表单已改为结构化字段（WMTS 底图/注记分组、矢量样式地址/隐藏图层/隐藏 POI），坐标定义表单增加资料、单位轴序、适用范围分组；新增“确认定位”动作，记录人工确认并更新修订号。用户手册和测试报告的正式验收章节仍待补充；场景图层的透明度/可选性运行时生效待做 |
| 2026-10-23 第十轮（旧方案清理与新路线收敛） | 开发库物理删除 GIS_TRANSFORM、GIS_CONTROL_POINT、GIS_TOPIC、GIS_SCENE_TOPIC 及 29 个退役列，重置旧 GIS 试验数据；退出同步导入、图纸级配准、坐标/转换页面与后端高德候选；场景取消专题字段和校验。合成 DXF 在真实浏览器完成原始解析、多候选配准、保存/确认、检查/生效、三套底图展示、同版重配准 ID/样式保持和清除；受限账号对 1 号线图纸列表返回 0、详情返回 403、地图不显示。后端 130 项测试通过，前端构建/lint 通过；前端类型检查仍仅剩授权页/图层页未改动文件的既有错误。真实 DWG 全链、撤权缓存回归、生产终端和发布未验证 |
上述结果不能替代 AC-GIS-003～025 的正式验收，也不能证明正式环境可用。旧的“429 个工点”记录是单位工程数，不是物理工点数，已按 82 个物理工点更正。
| 编号 | 场景与操作 | 预期结果 | 对应需求 |
|---|---|---|---|
| AC-GIS-001 | 从实际入口加载供应方 WMTS，缩放至多个层级并定位工程 | 范围、层级和坐标符合元数据，无持续错位；记录服务条件 | R-001～003 |
| AC-GIS-002 | 切换图层顺序/透明度/显隐与可用底图 | 展示正确，业务几何和关联不变，底图不可编辑 | R-004～006 |
| AC-GIS-003 | 上传覆盖格式版本和专业的真实 DWG/DXF | 原始图层、图元、属性和对应关系可核对，无静默丢失 | R-007～011 |
| AC-GIS-004 | 核查嵌套块、弧段、样条、中文文字和带孔填充 | 位置与语义符合原图，不以整图图片替代矢量成果 | R-008～010 |
| AC-GIS-005 | 使用含外部参照、代理对象、缺字体或损坏内容的样本 | 缺项具体可见；未满足验收要求不自动生效 | R-010、011 |
| AC-GIS-006 | 用确认控制点核对工程坐标入图，并上传未知坐标图纸 | 合格成果满足冻结后的精度口径；未知坐标不假报正确定位 | R-013～017 |
| AC-GIS-007 | 绘制点线面，测试变形手柄、数值尺寸/角度、固定锚点、各类捕捉、伴随尺寸及撤销/重做，保存后刷新 | 几何、尺寸、样式、来源及关联一致；只读参考不被改写，非法面被拒绝；线的合法交叉不被误拒 | R-018～023 |
| AC-GIS-008 | 两名编辑者修改同一版本，并重试同一保存请求 | 明确冲突、无静默覆盖和重复新增，失败保留草稿 | R-021～024 |
| AC-GIS-009 | 上传新图纸版本，查看新增/删除/变化差异，处理人工覆盖及一对多/无法匹配冲突 | 原有效版和人工成果可追溯；确认对应的对象保留业务关联，未确认对象不自动错误重绑 | R-012、025、036 |
| AC-GIS-010 | 有专业权无工程权、有工程权无专业权及只读参考用户直接调用接口 | 分别拒绝相应访问/写入，授权外图层、几何、数量与属性不下发 | R-026～032 |
| AC-GIS-011 | A工程电气/B工程土建的组合授权访问 A工程土建 | 不因多个授权取错误笛卡尔积而放行 | R-029 |
| AC-GIS-012 | 部分专业用户访问混合 CAD 源文件、预览、转换包及通用附件入口；另由具备文件整体处理权的人员检查未分类图纸 | 普通用户不能获得其他专业或未分类内容；检查者可在隔离范围完成归类，归类后仍按实际专业分发 | R-031～035 |
| AC-GIS-013 | 权限撤销、专业重新分类后再次读取已缓存成果 | 后端按当前权限过滤，缓存不泄露原有数据 | R-035 |
| AC-GIS-014 | 关联工程对象，地图点选详情并从业务端定位地图 | ID 和对象对应正确，原业务鉴权继续生效 | R-036、037 |
| AC-GIS-015 | 使用真实进度记录切换专题，包含多对象和无数据样本 | 颜色、期次、聚合及图例正确；无数据不冒充状态 | R-038～040 |
| AC-GIS-016 | 使用相同账号及范围访问主系统和驾驶舱 | 可见数据一致；驾驶舱不能绕过写入权限 | R-041 |
| AC-GIS-017 | 模拟底图故障、保存超时、解析失败和数据源不可用 | 按第 10 节处理；原有效成果、草稿不被无提示清除 | 第 10 节 |
| AC-GIS-018 | 检查二维组件与预留三维边界的数据职责和坐标/高程模型；没有三维入口时检查设计契约 | 业务数据不保存为唯一引擎私有对象，不为本条验收强制开发三维页面；本期无真实三维通过结论 | R-042～045 |
| AC-GIS-019 | 在冻结后的真实负载、终端和并发条件下运行 | 分别测量平台、解析及外部瓦片耗时，满足 Q-GIS-007 确定的指标 | NFR-004、006 |
| AC-GIS-020 | 检查实际依赖、部署资源、文件处理网络请求及日志 | 依赖版本和许可明确，无未授权在线转换；业务文件受控，文档和普通日志无真实凭据 | NFR-001～005 |
| AC-GIS-021 | 按适用账号从菜单进入 4 个常规入口及检查/对比子页面；在数据管理选择线路/工点上传 CAD，直接访问并返回 | 工程 ID 正确，越权和全线混合图纸不能因入口而放行；返回恢复线路上下文，不出现空壳、404 或重复入图库；旧坐标/转换/专题入口不可执行 | R-046、047、052、053 |
| AC-GIS-022（已退役） | 旧坐标定义/转换方案维护与校准页面已退出；标准坐标定义只由系统内部读取 | 不向普通用户提供新建、修改、启停或升版入口，底图引用不受影响 | R-GIS-049 |
| AC-GIS-023 | 配置 WMTS/VECTOR_STYLE 与地图场景，选择底图坐标系，预览、修改及停用被引用服务 | 坐标系可回显并与服务类型匹配；元数据与真实出图区分；引用影响明确、无静默切换；服务端 Key 不下发，场景无权图层不泄露 | R-048、050 |
| AC-GIS-024（本期取消） | 本期 GIS 不配置专题；场景只配置底图、图层、样式覆盖和初始视图 | 无专题控件、请求、字段或启用校验；后续专题由业务模块建设 | R-GIS-050、051 |
| AC-GIS-025 | 在数据管理版本行打开配准，对目标版本取 3 个以上 CAD/高德点对，预览后保存并人工确认；刷新后核对显示；同版重配准后核对 ID/样式；再清除并刷新 | 预览、保存和刷新使用同一版本参数；监管中心无配准入口；残差可见，未达控制点不保存；同版重配准保持 ID、样式、归属与绑定；清除后地图不再显示该版几何，版本和源文件保留 | R-GIS-054、056 |
| AC-GIS-026 | 1920×911 下查看数据管理线路导航和图纸/图层台账；切换在建/规划/运营；修改底图初始镜头高度后打开监管中心 | 导航分类正确、无导航内上传；关键列平铺单行显示、操作列不被遮挡；初始缩放使用底图配置值 | R-GIS-055、R-GIS-048 |
| AC-GIS-027（2026-10-24 退役） | 原“预览原 CAD”验收随 R-GIS-058 退役：GIS 页面不再有原 CAD kkFileView 预览入口与请求，旧预览、回源和代理地址不执行原功能且不能读取源文件；源文件受控下载与越权拒绝继续按 R-GIS-058 之前的下载口径验证 | 2026-10-24 用户决定 |
表中 R-xxx、NFR-xxx 分别为本文件 R-GIS-xxx、NFR-GIS-xxx 的缩写。具体样本、权限账号类型、运行环境与结果在后续测试与验收文档记录，不能把本表当作测试已通过。
12. 待确认事项及实施影响
需求保留项与未决细节分开：未决项不得被实现者默认裁决，已明确的独立能力可以继续实施；技术常规选择遵循项目规范，无须逐文件请示。
2026-10-21 核对到的外部事实：Q-GIS-001 一张图 WMTS 仍未提供；Q-GIS-002 已收到 15/24/27 号线三份 DWG，但不足以覆盖全格式和全对象矩阵；Q-GIS-003 未提供官方坐标参数和控制点，当前使用图纸绝对坐标标注反算的相似变换，并以公开站点数据验证；Q-GIS-004、005、006、007、008、010 仍未提供。Q-GIS-009 开发环境采用 LibreDWG 0.14（GPL-3.0-or-later）、ezdxf 1.4.5（MIT）和 pyproj 3.8.0（开发机）/3.7.1（生产兼容验证），真实样本覆盖、分发合规和生产依赖仍需确认。2026-10-21 在 142（Kylin V10、x86_64、glibc 2.28、无外网）验证了随发布自带的 Python 3.12.15 + 离线 wheel 可运行，LibreDWG 0.14 可在该机源码编译，DWG→DXF→GeoJSON 链路通过；但生产服务尚未配置 GIS_PYTHON_COMMAND/GIS_DWG2DXF_COMMAND/GIS_STORAGE_ROOT，真实 27 号线样本未在该环境复验。上述缺项不阻塞底图与图层浏览的继续完善，但阻塞 CAD 全解析、定位精度、专业隔离、进度和正式验收。
先调查已有接口、资料、样本与配置，能够查证的事实不再转成用户选择题。外部参数缺失只阻塞真实联调；专业政策、进度业务口径及改变开源约束的取舍须由业务方确认。不得把下表当作“全部答完才能开始”的前置问卷，也不得用默认值假装条件已经满足。
| 编号 | 需要取得的事实或决定 | 影响 | 缺项期间的边界 |
|---|---|---|---|
| Q-GIS-001 | 一张图 WMTS 元数据/能力文档、矩阵、坐标、覆盖/层级、鉴权、跨域、网络和使用条件 | 底图接入及浏览器直连/代理方案 | 可实现服务适配和测试夹具；不写死参数、不声称已接通 |
| Q-GIS-002 | 真实 DWG/DXF 样本，格式版本、图元及布局/外参/自定义对象清单、字体、输入单位和业务用途 | 全解析覆盖、解析器及转换规则 | 不以少量 DXF 或图片预览宣称全解析完成；不擅自仅支持 DXF |
| Q-GIS-003（新路线取消） | 新路线不再要求重庆独立坐标参数或官方控制资料；仅在实际需要 4490 输出时记录操作与精度边界 | 测量级成果/正式 4490 交付 | 不伪造重庆坐标参数，不宣称测量精度 |
| Q-GIS-004 | 哪些主体在何工程范围可读/维护/导出/下载哪些专业，综合专业包含关系、参考数据规则及未分类图纸的整体检查/归类授权 | 专业授权政策和维护入口 | 已实现受控授权机制、原始整文件联合鉴权和默认拒绝测试；专业授权主体、综合专业包含关系、全面查询过滤和未分类图纸检查职责仍未确定，不默认全专业或让上传者读取整包 |
| Q-GIS-005 | 进度提供模块、API、对象粒度、期次、状态/颜色、聚合及刷新规则 | 业务着色闭环 | 适配接口可先实现；正式界面显示未接入，不虚构数据或使用 BIM 任务替代 |
| Q-GIS-006 | 现有工程轮廓/定位数据、业务对象及旧平台成果可用性 | 初始成果与迁移范围 | 不假设已有可直接迁移的数据库和坐标；不自动建设整套历史迁移工具 |
| Q-GIS-007 | 典型/最大文件大小、图元/顶点数、图层数、用户并发、办公终端和目标时延 | 性能容量及任务限制 | 先采集基准，不编造指标；旧 SDK 包体、请求数指标不直接沿用 |
| Q-GIS-008 | 协议后提供标准 3D Tiles、加密数据、专用 SDK 还是嵌入页面；网络、客户端授权和解密条件 | 后续三维适配及部署 | 保留边界，不购买服务或越网访问，不承诺 Cesium 必定兼容 |
| Q-GIS-009 | DWG/DXF 开源链在真实样本上的覆盖及依赖许可；失败时是否使用已购超图或其他方案 | 全解析技术落地 | 仍保留需求；不能私自加入非开源转换器、商业插件或把许可证义务当不存在 |
| Q-GIS-010 | 已保留精确编辑功能的几何适用规则、尺寸/角度基准、单位、容差与显示精度 | 精确编辑和成果质量验收 | 配准残差只作配准平面参考，不冒充地面误差；按 R-GIS-018、019 实施，不自行承诺 5 厘米精度或完整 CAD 制图能力 |
13. 相关文档
- 概要设计：架构、处理链路、状态、逻辑模型、权限策略、接口职责及实施顺序。
- 详细设计：完整菜单、路由目标、页面规格、子页面、权限、服务契约与交互验收。
- 数据库设计：实际三表基线、目标字段矩阵、版本/任务/配置/授权关系及迁移差异。
- 用户操作手册：当前菜单的日常操作与状态说明。
- 测试与验证报告：2026-10-23 开发环境构建、页面与对象存储验证记录。
- 工程基础需求：工程关系与专业事实。
- 系统架构、业务地图、公共开发约定：平台现行基线。
- 软件交付文档：资料阶段、设计与实现/验证状态区分。
前期业务空间接入需求
用户2026-11-10已确认前期四类空间对象为征地面、管线点、交通点和绿化点，由施工单位维护并经监理复核，平台提供对应图层显隐。业务规则唯一正文见前期空间规则，送审、发布及源目标鉴权见前期详细设计6.3。
GIS负责承接审核通过的真实点/面成果、前期对象绑定及受权图层展示；待审候选不覆盖正式地图，退回保留旧成果。现有图层显隐可复用，几何编辑和前期目标注册仍需实施，不能把当前PUT属性/绑定接口当可用几何写入口。人工业务空间对象须有明确来源及单位工程工程上下文，不伪造CAD图纸/版本，也不破坏已有CAD成果、场景组合、PROJECT/SITE/BID绑定和修订机制。
本增量由前期业务入口承载，不恢复GIS通用专题配置、专题数据源、指标统计或一套无业务来源的通用绘图审批系统。此前“常规GIS入口几何编辑未完成”的实现事实仍然成立；本次只补齐业务集成目标，没有代码、表结构、环境发布或页面验证成果。文档1.04→1.14按新增受控业务空间接入能力递增。