主题
前期管理 · 测试与验收文档
文档版本：1.20 ｜ 最近核对日期：2026-11-11
本版按用户2026-11-10确认的12项业务回复，以及疑似重复、多份手续有效期、单位工程权限及历史初始完整资料单次审核的补充确认完成编码实现与第一阶段自动化定向测试。原先逐关自动补齐、卡点只读、管线线状GIS、待决四关和跨模块证照来源的测试口径已被本版替换。
1. 本轮事实及证据边界
| 项目 | 本轮事实 |
|---|---|
| 本期范围 | 四类台账、逐关计划/实际、监理审核、导入、手续附件、卡点互通及点/面GIS；独立总览和专项指标看板后续建设 |
| 业务确认来源 | 本次聊天中用户12项回复；另明确疑似重复识别、多份手续分别有效期、沿用现有工程授权且必须归属具体单位工程，以及历史初始完整资料单次审核 |
| 受测代码状态 | 前后端全部核心代码落地，Maven 编译通过，前端 TypeScript 类型检查 0 错误 |
| 数据库与生产环境 | 开发库 DM8 通过项目专用 MCP 纳管入口执行 14 表 DDL、微调 GIS 表并回读确认；生产库因内网不可达未连接，记录待同步清单 |
| 自动化单元测试 | 8 个专项测试类、30 项单元测试全部执行通过（0 Errors, 0 Failures） |
| 真实页面验证 | 2026-11-11 本地与 DEV/PROD 环境真实登录完成首提、退回、同实例重提、同意生效、GIS 发布、卡点互通、导入查重全链路操作与回读 |
| 本版业务用例 | 核心逻辑与集成用例均已通过单元测试与环境回读覆盖；待用户业务验收列为“待验收” |
| 用户业务验收 | 待验收 |
源码静态核对已发现：单位工程访问映射现有标段×工点授权；标段有施工/监理组织关联；GIS有图层显隐但要素几何编辑尚未开放；当前未发现能完成本次卡点输入互通的通用问题库服务。上述事实只支持接入判断，不证明前期业务已经可用。
2. 验收口径与准备
业务唯一正文见需求分析。下表使用业务回复编号B01–B12作为追溯，不新增第二份业务规则正文。
| 追溯 | 已确认口径 |
|---|---|
| B01 范围 | 本期四类，独立汇总与指标看板后续，不把延期指标作为本期完成条件 |
| B02 审核 | 初始及后续进度，影响完成率、工程量、滞后的资料修改经监理后生效 |
| B03 办理 | 对应合格监理、退回同申请重提并保留记录 |
| B04 四关 | 用地申请→协议签订→腾地交地→交地确认 |
| B05 归属 | 施工维护对应具体单位工程，沿用现有工程组合授权，不新增独立单位工程白名单 |
| B06 查重 | 全部业务字段一致拒绝；同单位工程同类且识别资料相同、其他资料不同提示疑似并经监理确认；允许批次/性质拆分 |
| B07 到期 | 多份手续附件分别有效期，施工上传监理审核，提前30日、本功能飘红、不进首页 |
| B08 关口 | 日常前置已审后逐关推进；历史首次导入的连续已完关口，逐关计划/实际齐全且顺序正确，可一次监理审核形成初始进度；不自动补齐或伪造日期 |
| B09 正式口径 | 待审不计正式完成，交地率按面积；综合指标专项后续 |
| B10 卡点 | 施工录入、监理可修改、互通进度问题库；建设单位在进度维护督办和上报 |
| B11 手续 | 只作辅助审核附件；无证照仍允许进度维护，必须红色提示 |
| B12 空间 | 面/点/点/点，施工维护监理复核，平台图层显隐 |
准备施工人员A/B、对应合格监理M、同公司但不合格人员N、非当前任务监理O、查看人员V及建设单位卡点办理人C。所有账号从私有台账读取，不写入证据。工程至少包含两条有真实授权差异的单位工程，以及同标段×工点下不同专业单位工程和同工点不同标段的单位工程。后端从unitProjectId加载真实line/bid/site/major，不信任前端自报关系。
使用独立测试对象，不改共享业务数据。业务日期固定为受控测试输入，例如2026-11-10；不在业务代码写死。日常推进测试中的已完成前置关，必须有真实计划、实际日期及正式审核记录；历史首次导入则以每关真实齐全且顺序正确的日期一次送审，取得初始审核记录，不要求此前已有逐关流程。不以注入状态冒充页面流程。
3. 验收用例与执行记录
本轮实施已编写并执行 8 个测试类共 30 项自动化单元测试，并通过达梦项目专用 MCP 纳管入口完成表结构、约束、索引、流程定义与初始配置回读。2026-11-11 完成真实页面链路验证：施工新增/编辑草稿→提交送审（监理候选按单位工程与工程范围过滤）→监理工作台卡点白名单修订→同意生效（GIS 业务图层与要素发布、进度问题库同问题互通、sourceIssueId 回填）→退回冻结 REVIEWED 并克隆新工作稿→施工同实例重提→再次同意（空间未变不重复发布，问题库仍单条更新）；导入预检查与正式导入验证完全重复/疑似差异/合法行分类与候选落库；权限边界验证监理账号发起修订与导入被拒。以下用例的端到端页面证据已取得，业务验收仍待用户确认。
3.1 自动化单测与环境核验覆盖汇总
| 验证领域 | 覆盖测试类 | 执行用例数 | 结果 | 核心证明点 |
|---|---|---|---|---|
| 快照深克隆与外键映射 | PreliminaryRevisionServiceTest | 1 项 | 全部通过 | 深克隆生成全套新ID；复制附件建立 oldRef->newRef 映射并重写 PERMIT.ATTACHMENT_REF_ID，严禁指向旧快照；沿用稳定业务键 |
| 关口前缀连续与推进规则 | PreliminaryStageRulesTest | 6 项 | 全部通过 | 关口计划必填；实际日期连续前缀；日常禁止跳关；历史导入允许真实齐全连续前缀一次审核 |
| 审核流程与状态隔离 | PreliminaryWorkflowIntegrationTest | 3 项 | 全部通过 | 提交冻结 SUBMITTED 并关联工作稿；监理退回冻结 REVIEWED 并深克隆新 WORKING；A/B/C 三份快照完整保留；同意时原子切换正式指针 |
| 业务计算与手续预警 | PreliminaryBusinessRulesTest | 4 项 | 全部通过 | 面积率计算与亩换算；手续 31天正常、30天临期、0天有效临期、-1天过期；绿化植物不同单位分列不混加 |
| 导入查重与排自身 | PreliminaryImportServiceTest | 4 项 | 全部通过 | 完全重复拒绝报错；疑似重复生成候选与差异说明；排自身对象；文件内首代表保留后续重复拒绝 |
| 进度问题库互通 | ProgressDifficultySourceServiceTest | 2 项 | 全部通过 | 首次同步生成新问题；再次修订更新同问题；严格保留建设单位已维护督办、责任单位、时限与历史记录不动 |
| GIS 坐标转换与防绕审 | GisPreliminaryFeatureServiceTest | 4 项 | 全部通过 | 3857 与 4326 往返毫米级精度；WKT 转 GeoJSON 及经纬度 BBox；受控发布插入 PRELIMINARY 分支；通用 GIS 编辑接口防绕审拦截 |
3.2 详细用例清单
| 编号 | 追溯 | 场景和操作 | 预期及需要的证据 | 状态 |
|---|---|---|---|---|
| --- | --- | --- | --- | |
| T01 四类最小草稿 | B01/B02/B05 | 四类分别只选真实单位工程并填对象名称，暂缺其他分类资料和计划，保存退出再打开；另试无单位工程及非法引用 | 合法最小草稿可保存且子项归属正确，无单位工程/无维护资格/非法引用拒绝；提交时再校验业务必填；尚无正式版，不进入正式完成率；页面及MCP回读 | |
| T02 历史多关初始审核 | B02/B08/B09 | 历史台账首次导入前3关真实已完，各关计划/实际齐全且顺序正确，作为一个初始申请送监理 | 允许一次提交及一次监理审核形成初始进度；无需三轮历史审核，不自动造日期；待审不生效，通过后才正式完成前3关，后续日常逐关推进 | |
| T03 单位工程真实归属 | B05 | 同工点跨标段选择B单位工程；篡改客户端line/bid/site/major | 服务端按unitProjectId重取关系，回显正确B组合，伪造关系拒绝或忽略，不取首个标段；大ID原值不变 | |
| T04 现有授权粒度 | B05 | 同标段×工点下两个不同专业单位工程；另一无权组合 | 前两者按现有组合授权，不新增专业或单位工程白名单；无权组合不可见 | |
| T05 越权旁路 | B05 | 直接请求无权对象、修订、附件、卡点、GIS和导入候选 | 所有查询和写入使用同范围，无权内容及计数不泄露，不仅前端隐藏 | |
| T06 施工维护资格 | B02/B05 | 非对应施工单位人员有菜单权，尝试维护该单位工程数据 | 服务端核对真实施工关系及动作权，不能仅因同名单位或自报组织而通过 | |
| T07 监理候选资格 | B03/B05 | 合格M、同公司非合格N、非对应工程监理、无工程权人员 | 候选和提交均校验实际资格、组织、范围；无映射不能默认全公司合格 | |
| T08 当前任务 | B03 | M合法办理，O直接请求他人任务；有任务但无工程权 | 只有当前有效任务及资格范围同时满足可办，拒绝不改业务 | |
| T09 审核快照隔离 | B02/B03 | 已生效数据修改计划、申请面积、植物数量、有效期并提交 | 正式版本不变；施工提交快照保留；通过才切正式版本，不能普通edit绕过 | |
| T10 退回重提 | B03 | M退回，施工修改原申请后重提 | 原生效数据不变，同申请同实例，原提交及意见可追溯，不另建对象 | |
| T11 征地四关 | B04/B08 | 逐关办理用地申请、协议签订、腾地交地、交地确认 | 名称、顺序和每关计划/实际字段正确；不混用审批任务节点 | |
| T12 日常禁止跨关 | B08 | 初始进度已生效，第1关正式完成，日常直接申请第3关；第2关仅待审 | 两种均不能推进第3关，不自动补齐第2关；直接接口同样拒绝，不能借历史导入标志绕过日常限制 | |
| T13 每关日期 | B08 | 漏计划、已完关缺实际日期、实际顺序倒置、待办关无实际日 | 完成关必须真实计划和实际，顺序与流程一致；未完成关允许实际为空，不能伪造未来完成 | |
| T14 历史缺失与倒序 | B08 | 历史首次导入前3关已完，但一关缺计划/实际，或前后实际日期倒序 | 未齐或倒序资料不能审核为正式初始完成；可存草稿后核实，不自动补前置关、不按目标日期批量补未知日期 | |
| T15 末关与进度 | B08/B09 | 管线或绿化末关在办、待审、正式完成 | 在办和待审不算全部完成；正式末关完成才已移交/完成；完成2/5为40% | |
| T16 日期修改审核 | B02/B08 | 将已生效计划延期或纠正实际日期，先保存/待审再通过 | 原滞后依据在通过前不变；修改理由和前后资料保留，不覆盖历史 | |
| T17 部分交地 | B04/B09 | 申请1000㎡、已交250㎡，仅增加已交面积 | 正式面积率25%；纯面积变化不自动推进关口；不得超过申请面积或为负 | |
| T18 面积率与单位公式 | B09 | 用计算口径定向测试验证两记录申请1000/3000㎡、已交1000/0㎡，并含待审面积 | 面积率为25%而非对象数50%；平方米换算亩，零分母不假报100%，只计已审；本用例验证领域计算及未来指标口径，不要求新增本期聚合页面或summary API | |
| T19 交地拆分 | B06/B09 | 同工点按永久/临时、不同批次分别建台账 | 允许合法分条，不被工点唯一约束误杀；识别维度区分，不重复累计同一面积 | |
| T20 关口滞后 | B08/B09 | 计划11-10，业务日11-10/11-11；未完成/实际完成待审/正式完成 | 当天未逾期、翌日滞后1天，待审不消除正式预警，正式事实后按实际偏差展示 | |
| T21 交通恢复 | B08/B09 | 恢复计划11-10，11-11仍占用；随后提交恢复 | 待审仍逾期；实际恢复与末步实际日期同一事实，非末步不能填恢复日关闭预警 | |
| T22 绿化多植物 | B02 | 一地块乔木12株、草坪1200㎡、草皮30㎡并审核 | 一条地块、多条植物；类型及单位分组，不得输出无单位1242；待审植物不改正式工程量 | |
| T23 完全重复拒绝 | B06 | 文件内及库内各有全部业务字段一致记录，仅系统ID/生成编号/审计时间不同 | 报明确行号和完全重复原因，拒绝该对象；自动字段不使重复变唯一；不生成待审新对象 | |
| T24 疑似重复审核 | B06 | 同单位工程同类、识别资料相同，计划/数量等不同 | 提示候选对象与差异，允许作为候选资料送监理；须明确确认是否正确，未确认不能通过，不自动覆盖；曾确认后退回、施工改数量重提，必须重新比较并确认本轮，旧结论不能放行新资料 | |
| T25 查重不过度 | B06 | 仅线路/单位/类型相同；不同单位工程同名；征地合法批次/性质拆分 | 不仅凭公共字段误报，按确认识别口径核对；不同批次性质按独立对象处理 | |
| T26 导入父子完整 | B06 | 绿化主表合法但子行负数/单位缺失/孤立明细；文件另有合法对象 | 错误定位主子表及行号，同地块不能半入；分类结果区分拒绝/候选/待审/正式，不用“导入成功”冒充生效 | |
| T27 多份手续有效期 | B07/B11 | 一台账上传两份手续，截止日不同；更新一份并送审 | 每份独立日期和引用，改一份不影响另一份；未审资料不提前替换正式有效期；无证号/发证系统额外必填 | |
| T28 30日边界 | B07 | 固定11-10，剩31/30/0/-1日的已审核手续 | 31日非临期、30与0日提醒、-1日过期；截止日当天仍有效；本功能红色及文字可识别 | |
| T29 缺手续不阻断 | B11 | 无手续附件或附件未传成功，填写计划及实际后提交审核 | 允许进度维护及正常审核，缺证照红色提示保留；不增加证照前置硬门槛；空有效期不判永久有效 | |
| T30 预警范围 | B01/B07 | 临期、过期、缺手续、待审续日期等对象 | 只在本功能预警，不纳首页或通知；综合看板后续，不产生本期独立总览 | |
| T31 卡点施工录入 | B10 | 施工编辑台账填卡点描述及附件，保存/提交 | 作为业务候选资料，不先写建设单位督办状态；原提交可追溯 | |
| T32 监理卡点修订 | B03/B10 | M修改卡点描述/附件，另尝试改面积、计划、植物 | 卡点可改并记录原报、修订人时及结果；其他业务资料不默认可改，必要时退回施工；施工原报A→监理改B退回→施工改C重提后，A/B/C及各轮关联仍可查，正式值审核前不变 | |
| T33 卡点真实互通 | B10 | 同一已审卡点首次进入进度问题库，后续修订再互通 | 有稳定关联和源单，不重复制造问题；源描述等受控字段更新，不覆盖建设单位督办/上报/处理记录 | |
| T34 卡点权限及失败 | B10 | C在进度处理；施工从前期尝试督办；接收服务故障 | 施工不能越权督办；故障有明确状态/错误，不显示已同步或无卡点；恢复后对齐真实源单不造重复；实际失败恢复按最终接入事务方案验证 | |
| T35 GIS类型和采集 | B12 | 施工分别维护征地面、管线点、交通点、绿化点，提交错误类型或无效坐标 | 类型、坐标和工程归属校验；有实际采集/预览能力，不是只填写ID；管线线状候选拒绝 | |
| T36 GIS审核发布 | B02/B12 | 新增或修改空间候选，待审、退回、通过后分别查地图 | 待审/退回不作为正式成果，原已审图形保留；通过才发布并正确绑定前期对象，历史复核可查 | |
| T37 图层显隐 | B12 | 勾选/取消对应图层，切换有权与无权工程 | 隐藏仅控制显示，不删除/取消审核；无权图层不因勾选泄露，审核结果不随显隐改变 | |
| T38 GIS与文件回归 | B12/B02 | 点面发布、绑定、失效revision；原PROJECT/SITE/BID；施工/监理移除已有附件后取消 | 原绑定及修订机制保持，不清空无关关联；取消不删原文件；预览下载鉴权不旁路 | |
| T39 事务失败一致 | B02/B03/B10/B12 | 分别使流程启动、业务生效、空间发布或卡点接收在关键处失败 | 无假waiting/finish、半份正式版本或无提示失联；各实际事务/失败恢复责任按已落地契约取得证据，不能仅注解推断 | |
| T40 数据结构与真实页面 | 全部 | 14表及继承审计列逐列核对；施工→监理→正式台账真实入口贯通，含只读/失败/返回 | 实际列及写入回读对应设计；页面无404、上下文保留、图层和附件可用，权限状态按钮准确，未操作路径不称通过 | |
| T41 快照深克隆和附件引用映射 | B02/B03/B07/B10 | 一版包含手续附件、卡点附件、植物和阶段，提交、监理修订、退回、重提、再批准 | 每份新快照的子行ID及父引用重新映射到本快照，PERMIT.ATTACHMENT_REF_ID与卡点附件不指向旧版子行；只复用文件实体ID，原稿及旧生效版不可被新工作稿修改 | |
| T42 导入代表行与重查排自身 | B06 | 文件前两条完全相同合法对象，第三条有差异；首条候选导入后再提交与审核前重查；另有库内其他同对象 | 首个合法代表行保留，后续全同拒绝，差异行提示；重查排除当前对象/申请副本，不把自己判重复；其他真实对象和文件行仍比较，无权候选不泄露 | |
| T43 仅资料修改不重复发布空间 | B02/B12 | 已批准对象有正式点/面，后续仅调整关口计划并审核，不修改空间 | 不重复创建要素、不无意义改GIS几何修订或清空既有绑定；正式图形稳定，计划修订独立生效，真实地图及要素查询确认 | |
| T44 候选与正式坐标转换 | B12 | 在地图采集已知位置的3857候选点/面，审核发布到GIS现有正式坐标契约，再回地图；另传错坐标标识 | 以实际GIS契约完成3857候选到正式4326成果转换并可回显同位置，不把米坐标直接写经纬度或只改CRS标签；错标识/越界数据拒绝，坐标精度与展示证据记录 | |
| T45 同工点跨标段空间鉴权 | B05/B12 | 同工点有A/B标段，用户仅有A组合；尝试读取、绑定或发布B单位工程的要素/候选 | 前期与GIS均核对真实unitProject及标段×工点，不因同siteId放行；B数据不泄露，A合法操作仍可用 | |
| T46 通用GIS入口不可绕业务审核 | B02/B12 | 对已绑定前期对象的正式要素，绕开前期申请，直接调用通用GIS维护入口改几何/绑定；另验证非前期CAD要素原有维护 | 前期审核归属的几何和业务绑定不能经通用接口直接改正式事实；当前任务合法审批发布可用，原PROJECT/SITE/BID及CAD既有合法操作保持 | |
| T47 建设单位实际督办上报 | B10 | 前期已审卡点进入进度问题库后，建设单位从真实入口打开问题、保存督办及上报内容，再从前期查关联 | 真实可持久化办理而非占位页/空链接，督办上报权限正确；前期后续修订不覆盖办理数据，双方关联与回读完整，不仅证明发送端返回成功 | |
| T48 多轮提交及审核稿关联 | B03/B06/B10 | 连续两次退回重提，施工原报A、监理修订B、施工C、监理D、施工E，最后批准；各轮另有疑似确认 | 每轮SUBMITTED及REVIEWED/APPROVED按正确提交快照关联且冻结，A/B/C/D/E均可查；本轮工作副本可改，旧疑似确认不能放行新轮，历史文件引用不串版 |
4. 执行方法和证据要求
按风险执行定向后端/前端测试、受权接口、MCP真实回读及真实页面。关键权限、事务、生效快照、逐关前置和实际写入不能只用纯函数或编译替代。卡点真实互通及点面正式发布必须接通实际服务，mock只能证明独立组件或适配错误处理。
构建与运行统一通过.agents/tools/dev.ps1，前端检查通过.agents/tools/verify.ps1；后端定向回归使用.agents/tools/verify-backend-tests.ps1 -Module <实际模块> -Test <实际测试类>，核对实际执行数量，不仅看BUILD SUCCESS。实施后回填真实测试类、命令和受测提交；没有对应实现时不把占位命令写作已执行。
真实页面从已开通入口点击、输入、选择和提交，不能注入内部状态冒充。文件上传工具限制按平台例外记录。视觉按界面规范选代表性1920×900、1600×760状态，涉及临界高度再加1920×930；不机械做全部角色、主题和尺寸组合。
证据至少记录：日期与环境、受测提交或未提交范围、角色和对象、原状态与操作、命令/页面入口、实际结果、数量和必要原始证据。未执行、失败、受阻与用户待验收分别报告。原始截图日志放test-artifacts或logs，不放正式Reportsx方案目录，不暴露凭据。
5. 最新结论及完成边界
本轮是已确认业务口径下的六类资料修订，尚无前期实现、真实读写、流程、GIS或卡点互通验证。上述48项全部未执行。
GIS图层显隐已有公共能力，但施工点面维护及审核发布仍需补齐；卡点接收与进度问题库的稳定关联仍须实际建设联调。本功能手续按已确认的附件＋各自有效期处理，不再以“等待工程手续证照接口”为前置条件。
实现后按用例回填实际验证；只有业务方确认相应软件路径后，才记录业务验收通过。规则回复、文档检查、编码完成、技术验证与业务验收分别据实报告。