主题
前期管理 · 需求分析文档
文档版本：1.00 ｜ 最近核对日期：2026-11-10
前期管理由施工单位维护所属单位工程的征地拆迁、管线迁改、交通导改及绿化移植资料，经对应监理审核后生效。本版以定稿需求及用户2026-11-10对12项问题和4项补充问题的明确答复为业务基线；答复与原文、原型、旧建议冲突时，以本次答复为准。文档1.00表示第一版业务与设计资料，不代表软件已实现或验收。
1. 来源和范围
1.1 来源
| 来源 | 定位 | 采用方式 |
|---|---|---|
| 定稿《需求规格说明书-前期管理》，前期管理-001，封面2026-10-23 | 功能简表、四类页面正文及四张原型 | 作为初始业务来源，布局按平台设计体系 |
| 用户2026-11-10明确答复 | 9项业务口径、3项配套条件 | 本版优先业务决定，具体追溯见第8节 |
| 用户同轮补充确认 | 疑似重复识别、多份附件分别有效期、单位工程沿现有授权、历史初始完整资料一次审核 | 关闭相关歧义，不再列为待决定 |
| 当前平台源码及手册 | UnitProject、BidSection、工程授权、流程、GIS、文件 | 核实复用和实现缺口，不用代码现状推翻业务目标 |
本轮没有查库、执行业务API或操作实际页面；源码检索未发现前期专属实现。当前数据库对象须实施时纳管回读，不能引用旧回读宣称现库无表。
1.2 本期与后续
本期四类台账、逐关计划与实际、监理审核、导入查重、手续附件及本功能内预警、难点卡点录入及进度问题库互通、点面空间维护审核与图层显隐。
| 类别 | 业务对象 | 关口顺序 | 空间类型 |
|---|---|---|---|
| 征地拆迁 | 单位工程下的征地记录，允许多批及永久/临时分条 | 用地申请→协议签订→腾地交地→交地确认 | 面 |
| 管线迁改 | 单位工程下的迁改点 | 管线调查→迁改方案→合同签订→迁改施工→竣工移交 | 点 |
| 交通导改 | 单位工程下的导改点 | 方案编制→审批→导改实施→占用期→恢复 | 点 |
| 绿化移植 | 单位工程下的地块，一地块一台账、多植物明细 | 调查→移植方案→审批→移植实施→养护移交 | 点 |
本期不做涉军涉铁，不建独立总览和指标看板。统计分析、分类聚合图表、原型批次分布/行政区汇总/五关统计等统一留待平台功能完成后专项指标梳理；台账筛选、分页总数、单条关口进度及缺证/到期/滞后提示仍在本期，不据“统计后续”删掉基础业务反馈。交地率公式已确定，但指标入口后续建设。
不做计价支付结算、外部审批办件或证照全生命周期系统。不新建工程/账号/权限体系；前期侧不做卡点督办上报；不把缺证提示升级为阻断进度。手续预警只在本功能中飘红，不纳入首页预警，不默认扩通知渠道。
2. 角色与单位工程权限
| 角色 | 可执行内容 | 限制 |
|---|---|---|
| 施工单位经办人 | 所属单位工程四类台账、阶段计划/实际、植物、手续附件、卡点及空间数据维护、提交与重提 | 同时满足功能权、工程范围及对应施工单位归属 |
| 对应合格监理 | 本人任务审核、疑似重复明确确认、卡点修改、空间复核 | 真实对应监理单位及资格；不得据通用编辑按钮改全部已提交资料 |
| 建设单位管理人员 | 有权台账查阅；在进度管理问题库督办、上报 | 不把进度办理动作复制到前期 |
| 查看人员 | 授权范围只读查询 | 不因有页面获得全部数据或审核资格 |
数据过滤策略：工程数据授权。每条台账必须保存真实unitProjectId，沿用现有标段×工点组合授权。 用户已明确不新增同组合内各专业单位工程的独立授权。服务端从有效UnitProject取得lineId/bidId/siteId/majorCode，再执行EngineeringDataAccessHelper.assertPairVisible或同源查询谓词；不得相信前端自报归属或用独立维度OR放行。
施工/监理组织优先由单位工程→标段的constructUnitId/superviseUnitId取得，叠加用户有效组织归属、功能/角色资格及工程范围。现有字段是可核实来源，不代表实际环境配置已经齐全；配置缺失时明确提示并修正，不硬编码测试人员，不把整家公司所有用户当合格监理。负责人字段不自动等于唯一审核人。
列表、详情、申请、导入、附件、卡点、空间图层和流程表单采用同一工程范围。任务分配不扩大授权。企业引用平台组织ID及名称快照，外部政府/产权责任主体按实际主数据处理，不将名称当账号或授权。
3. 审核和逐关进度
3.1 初始与后续审核
- R01：新增/导入产生可见的草稿或待审资料；初始进度必须监理审核，未经审核不形成正式已完成事实。首次尚无生效版时明确标识，不能默认为已审核的零进度对象。
- R02：后续进度，以及会影响完成率、工程量或滞后判断的基础资料变更均须审核，包括申请/已交面积、阶段计划及实际日期、植物工程量等。手续附件由施工上传并经监理审核，空间数据亦复核；不得以普通编辑直写生效数据绕过审核。
- R03：施工原提交、监理卡点修订、最终生效版本均可追溯。待审/退回时旧正式版本保持不变；审核通过后统一生效。退回修改原申请、同一流程实例重提并保留全部办理历史。
- R04：监理只能选择/办理对应工程的合格任务。用户明确授权监理修改卡点，其他已提交资料默认只读，有问题退回施工修改；不推导监理可任意修改面积、计划或几何。
- R05：同一对象存在未结束申请时处理原申请；沿用平台有效保护，不为理论并发新增锁、版本机制或通用幂等系统。数据快照用于审核留痕，不是并发版本锁。
3.2 每关计划和实际
- R06：四类全部关口均有计划完成日期和实际完成日期；未完成的实际日期可空，已申报完成的必须有真实实际时间。计划用于滞后管控，不用创建时间代替实际完成时间。
- R07：逐关推进。前置关口必须已经完成并经审核生效，才允许推进下一关；例如第1关生效后只能申报第2关，不能直接选第3关自动补齐。原文管线累计目标及旧IMPLIED补齐建议已被本次明确回复取代。
- R08：草稿最低必填为真实单位工程和对象名称，其他分类资料、计划及实际可逐步补齐；保存草稿仍校验单位工程有效性、施工维护资格、已有引用归属及已填写值合法性。正式提交再校验本类应填资料、每关计划和已申报完成关口的实际日期及连续前置。用户补充确认的例外仅限历史台账首次导入：连续前若干关真实已完、每关计划和实际齐全且顺序正确时，允许一次监理审核形成初始进度；不得自动补关、免日期或伪造同日。未知日期先存草稿待补，生效后的日常修订不得借历史标记跳过前置审核。
- R09：业务“审批”关口与平台监理审核分开。单条完成比例由正式连续已完成关口数/总关数派生；进入第3关不等于完成第3关。未完成关口计划已过期时显示具体关口和滞后天数。
- R10：纠正已生效计划、日期或工程量，通过新修订申请审核并保留原版本；不得直接改历史或删阶段消除滞后。纠错不自动授权跳关，影响后续已完关口时明确提示并校验连贯性，不推导新的回退业务动作。
4. 分类资料与日期
4.1 征地拆迁
包含单位工程、工点及类型、用地性质、申请/已交面积、批次、行政区、责任单位、用地现状、权属和四关计划/实际。不同批次、永久/临时可拆多条，并非重复误杀依据。
- R11：0≤已交面积≤申请面积，平方米为存储基准；亩=平方米×0.0015，展示两位小数。部分交地允许，部分面积更新仍需审核，可不推进关口。最后交地确认申报须资料和交地事实自洽，不把部分交显示成全部交地。
- R12：交地率按正式已交面积合计/正式申请面积合计计算，不按已交工点数替代。零分母显示“—”，永久/临时区分。统计分析入口后续，不改变本次已确定公式。
- R13：以腾地交地关口计划完成日作为计划交地基准，其实际完成日代表全部交地事实，交地确认实际日另存为第四关确认时间，不合并两者。全部交地与相关实际时间应相符；具体关口仅要求已确认业务事实，不擅加文书必备清单。未全交且业务日期晚于计划交地日提示滞后，当天不逾期；每关另保留自己的计划/实际。
4.2 管线迁改
包含位置、管线类型、产权单位、迁改方式、实施单位、五关计划/实际。每次只申报下一关完成；竣工移交审核完成才已移交。关口统一展示未完成、待审完成或正式完成。正式完成数为0只表示尚无已审核完成关口，不推断工程尚未开展；正式完成4关不能又显示未完成前置关。空间类型按最新决定为点，不沿用原型线状要求。
4.3 交通导改
包含位置、导改范围、实施单位、五关计划/实际。计划恢复与实际恢复分别对应恢复关口的计划/实际完成日，不共用同一字段；实际恢复未审不停止正式逾期。其他关口如占用期同样排计划，不能只登记一组总周期。
4.4 绿化移植
一地块一台账，多行植物明细含类型、品种、规格、数量、单位，类型覆盖乔木/灌木/草坪/草皮/其他。按类型和单位分别显示，不混加12株与1200㎡，同类型不同单位亦分开。阶段计划/实际按地块推进，植物数量不作为阶段权重，养护移交完成才全部完成。
5. 导入、手续、卡点与空间
5.1 导入重复处理
- R14：每类提供模板；绿化用主表和植物明细明确关联，阶段计划/实际同样可结构化导入，不因一个对象多行而拆成多条台账。
- R15：文件内或已有库内业务资料完全一致的记录为完全重复，拒绝重复对象并给出行号、重复对象及原因。文件内以首个合法完整对象作为代表，后续完全相同行拒绝，不把代表行一起拒绝；首个非法对象不作为合法代表。比较排除系统生成ID、审计时间、流程号等技术字段，否则同资料永远不会相同；比较范围包含该对象的业务明细，不仅比较名称。
- R16：用户已确认疑似重复口径：同单位工程、同类别，名称/业务识别编号/位置等识别信息相同，但其他业务资料不同，提示差异并送监理核对。只有线路、单位或类型相同不构成疑似重复。
- R17：分类识别规则不得误杀合法分条：征地同时区分工点、用地性质和批次；管线/交通/绿化优先业务来源编号，无编号时用对象名称及位置。系统新生成编号不作为排除重复的捷径。植物顺序变化不能单独把相同业务变为新记录。
- R18：部分重复可形成待审候选，不自动覆盖、合并已有台账；监理逐项查看候选与差异并明确确认是否保留新记录，不确认不得审核通过。完全重复是错误，不能由监理勾选改成合法导入。拒绝该候选不影响已有对象。
- R19：正确对象与错误对象分开返回结果，完全重复和非法行拒绝，其余可进入待审候选；同一绿化地块的主子行是完整单元。正式导入及审核前再次服务端查重，预检查不作为免校验凭据；当前对象、当前申请及其工作/提交副本不作为自身重复候选，其他文件行和其他真实对象仍须比较。返回“进入待审”与“已生效”数量不能混称。
5.2 手续附件及本功能预警
- R20：仅做辅助审核的手续附件上传及有效截止日期，不扩建证号、发证单位、外部办件、续期流程或独立证照主数据。用户已确认每条台账可有多份附件，每份分别填有效截止日，可用简短说明识别。
- R21：施工上传、监理审核。缺手续附件但已开展工作仍允许维护、提交及审核进度，页面飘红显示“手续附件缺失”；附件无期限时提示有效期待补充，不猜作永久有效，也不新增未确认的长期有效制度。
- R22：距到期0至30自然日提醒临期，截止日当天仍有效，次日过期。仅本功能飘红并配文字，不纳入首页；到期或缺证不阻断进度。待审与正式附件明确区分，草稿上传不悄悄消除正式缺证提示。
- R23：复用平台上传/预览/下载，编辑取消不删原OSS，历史审核引用保留。附件上限及格式按平台策略，不将组件默认值改为业务制度。
5.3 难点卡点互通
- R24：台账编辑增加卡点字段，施工填写说明并上传依据，监理可在本人审核任务修改卡点内容。保留施工原报、监理修订、操作者和时间；监理修订不提前改正式台账。
- R25：已审卡点互通至进度管理难点卡点问题库，以稳定问题标识和前期对象ID关联；同一问题后续修订不能每次新建一单。前期负责已审来源内容，建设单位在进度模块维护督办、上报及其后续办理，不在前期复制这套动作或覆盖其办理结果。
- R26：问题库接收/查询必须真实实现，当前未发现可直接使用服务，工程手续is_key_blocker不替代问题库。同步失败明确反馈，不能假成功。已报问题不能靠前期清空字段删除其督办历史；原单保留，来源修订与问题办理状态分权。
5.4 空间维护、复核及图层
- R27：征地面，管线/交通/绿化点，施工负责对应空间数据维护，监理审核复核。送审候选可预览，只有审核生效后进入正式地图及绑定；退回/失败不覆盖旧有效空间数据。
- R28：平台支持对应业务图层显隐。显隐仅改变当前展示，不删除数据、不改变审批或工程授权；无权图层/要素不能因勾选显示获得访问权。优先四类业务图层分组并承载真实工程归属，不为每条记录造一个图层。
- R29：当前GIS有要素查询、属性/绑定修订和图层显隐，尚未开放点面几何编辑，也未注册前期业务目标。实施须补齐受控点/面采集、候选预览、审核发布及目标鉴权，不能只填GIS ID宣称空间维护完成；保留原PROJECT/SITE/BID和既有revision保护。
6. 页面、状态和非功能要求
四类页面以台账为入口，查询卡→列表卡，左标题右操作；详情含基础资料、关口计划/实际、植物、手续、卡点及空间。聚合分析页签不在本期。审批复用固定表单工作台，卡点区对当前监理开放已授权修改，其余只读；通用人员选择器限制真实候选。
生效事实、施工提交版本、审核工作版本分别展示，waiting/back不计正式完成率；首次未审用明确标识。平台申请状态沿用draft/waiting/back/finish等，不新造approved/rejected；用户未授权的删除、重启等动作不因组件支持而开放。
数据库分页、批量查询、统一R/PageQuery/PageResult、异常/审计和大整数ID原值遵循平台规则。审核及必要空间/卡点写入应有可验证的一致性；实际失败不得假成功，跨模块事务方式以源码和验证确定，不预造队列或补偿平台。新数据设计详见数据库设计，本轮没有执行DDL。
7. 验收标准
| 编号 | 覆盖 | 预期 |
|---|---|---|
| AC01 | 单位工程/角色 | 必须选择有效单位工程，沿现有组合授权；其他施工单位/无权对象不可读写，合格监理才可办 |
| AC02 | 首次及修改审核 | 初始、关键资料、手续及空间均待审不生效；原稿和监理卡点修订可追溯；退回同实例 |
| AC03 | 严格逐关 | 四关/五关计划齐全，逐关实际审核；日常从1关直接完成3关拒绝；历史初始完整真实资料可单次审核，不自动补历史 |
| AC04 | 日期及面积 | 每关滞后可追溯，部分交不误报全交；交地率按面积，待审不计正式率 |
| AC05 | 植物 | 一地块多植物，单位分组，主子完整 |
| AC06 | 查重 | 完全重复拒绝报错；部分重复差异明确、监理确认；合法多批/性质不误杀 |
| AC07 | 手续 | 多份分别期限；缺证可维护进度且飘红；30/0/-1日边界正确，不上首页 |
| AC08 | 卡点 | 施工录入、监理可修，进度库同问题互通且不覆盖督办上报；建设单位可在进度模块真实督办、上报，失败非假成功，不以空链接代替 |
| AC09 | GIS | 面/点/点/点施工维护、监理复核、审后发布，图层显隐及越权/旧绑定回归；同工点跨标段不能越权，通用GIS入口不能绕前期审核，坐标转换与真实地图位置一致 |
| AC10 | 范围/真实性 | 无独立汇总看板及涉军涉铁，无伪造数据/假接通；实际测试与文档版本分开 |
具体用例和未执行事实见测试与验收。
8. 业务答复追溯与已关闭问题
| 原问题 | 用户决定及本版落实 |
|---|---|
| D01/回复1 | 本期四类；看板和统计分析后续专项，详见1.2 |
| D02/回复2 | 初始及影响完成率/量/滞后的修改审核，详见3.1 |
| D03/回复3 | 对应合格监理、原单退回重提，详见2及3.1 |
| D04/回复4 | 征地四关用地申请/协议签订/腾地交地/交地确认，详见1.2 |
| D05/回复5及补充 | 施工维护具体单位工程，沿现有工程授权，不新增独立单位工程授权 |
| D06/回复6及补充 | 全同拒绝、部分同监理确认、多批/性质可拆；疑似口径已确认，详见5.1 |
| D07/回复7 | 有效期＋监理审核，30日、本功能飘红、不上首页 |
| D08/回复8 | 每关排计划和填实际，日常前置正式完成才推进；历史初始完整真实资料可一次审核，不自动累计补齐 |
| D09/回复9 | 指标后续，待审不计正式率，交地率按面积 |
| 回复10 | 改为前期录卡点、监理修订，互通进度问题库，建设单位在那里督办上报 |
| 回复11及补充 | 手续只作附件辅助审核，多份各有期限，缺证仍允许进度并红提示 |
| 回复12 | 面/点/点/点，施工维护、监理复核及图层显隐 |
上述问题已取得业务决定，不再原样列为用户待决。仍需实施者核验的事实：环境内单位工程及施工/监理组织岗位配置、目标问题库接收能力、GIS几何新增/修订接入与真实空间资料；它们是实现与验证任务，不能擅自回退为“卡点只读”“只绑定ID”或新业务阻塞清单。没有特别文书条件时按本版计划/实际进度管理，不自行添加关口证照门槛。
9. 资料与版本
概要设计 · 详细设计 · 数据库设计 · 测试与验收 · 操作手册。六类维持本轮首次建档1.00，明确答复在同轮收敛，不按每次问答重复升版；代码仍未获“开始实施”，本轮仅同步资料。