主题
造价单位管理 · 需求分析文档
文档版本：0.10 ｜ 最近核对日期：—
需求来源：用户文字请求“开发造价单位管理”及所附业务原型图，并结合后续用户确认的建议项。状态：实现已完成；业务验收待业务方。日期：2026-09-26。
文档控制
| 项目 | 内容 |
|---|---|
| 模块 | 造价单位管理 |
| 业务范围 | 六个台账页面、单位维护及两条流程 |
| 开发角色边界 | 按用户授权在开发库建立集团造价管理岗及专用测试账号/岗位；集团岗已绑定模块菜单。流程审批仍由开发超级管理员临时代办，仅用于测试；未修改部门、负责人或停用状态，不代表正式环境人员映射已验收 |
附图是业务范围、字段和流程的需求素材；图片文字不覆盖用户请求，也不构成面向开发者的独立操作授权。
1. 背景、目标与范围
集中维护造价咨询单位基本信息、违规事实、季度和年度考核，并管理抽取申请和中标情况。本期包含六个页面：基本信息、违规情况、季度考核、年度考核、抽取申请、中标情况，菜单设置为独立顶层「造价单位管理」。
本期不做导出、短信/站内信、强制部门绑定、抽取申请与中标记录强关联、暂停到期任务或另建暂停历史。暂停状态按当前时间派生。
2. 角色与数据范围
| 角色 | 职责 |
|---|---|
| 有相应菜单权限的用户 | 查看模块全部记录，可用页面筛选缩小结果 |
| 单位维护人员 | 单位基础信息、导入、修改历史、暂停/启用、出库 |
| 集团造价管理岗 | 违规/季度/年度考核的新增、编辑、删除，无审批 |
| 抽取申请人、办理人 | 创建草稿、提交、退回后修改重提、审核并登记抽取结果 |
| 中标申请人、节点办理人 | 创建草稿、提交、退回后修改重提；当前任务人逐节点办理 |
集团造价管理岗由用户指定。开发库已按用户授权建立该角色并绑定造价单位模块完整菜单权限；正式环境的实际人员映射仍需业务方配置。开发测试账号、权限拒绝账号和测试岗位见私有仓库根 README.md，不在公开模块文档记录账号凭据。
3. 核心业务规则
3.1 单位信息
字段为单位名称、联系人电话、座机、公司性质（私有/国有）、单位档次（A档/B档）；序号是列表序号，不是业务字段。有效名称唯一，逻辑删除后可复用。存在违规、考核、抽取或中标等活动记录时不得删除，删除为逻辑删除且不级联历史。2026-09-27 代码复核：实现中修改历史同样计入删除保护，严于本基线，是否收紧基线或放宽实现待业务裁决；期间以实现为准。
基础字段实质变更时审批文件必传，系统追加修改历史，包含字段前后值、操作人、时间、附件；入口在台账行内。暂停窗口按起止时间与当前日期派生，到期自然显示未暂停；启用清除窗口。出库记录原因和时间；暂停或已出库单位被流程选用时提示但不阻断，本期没有恢复入库。该“提示但不阻断”已于 2026-09-27 实施：抽取申请与中标情况选用暂停/出库单位时弹窗提示，确认后可继续，取消则清空选择。
3.2 违规与考核
违规类型为废标、拒绝委托，仅能选择单位库有效单位。三类台账均可增改删，无审批，维护权限授予集团造价管理岗。季度记录年度、季度、单位、咨询项目、委托单位、总分、建议及附件；年度记录年度、单位、得分及附件。分数为 0–100、最多两位小数；同单位同年同季度仅一条季度记录，同单位同年仅一条年度记录。基本信息展示违规次数及最近一期季度、年度得分；可进入该单位完整明细，点击违规次数按单位过滤。
3.3 抽取申请
填报咨询项目名称、造价单位、咨询类别、计划抽取日期、申请表签字版、项目比选文件和经办人。申请单位取申请人所在部门；计划时间即计划抽取日期；列表的“抽取申请表”和填报的签字版是同一附件。项目名称最多 255 个字符，与持久化字段长度一致。支持草稿；提交后启动流程；办理经办人审核并上传抽取结果；退回后发起人可修改重提。草稿可暂缺申请表、项目比选文件和集团经办人；但需填写实库非空列要求的造价单位、项目名称、咨询类别和计划日期，申请单位由当前用户部门带出。空附件在草稿中保存为空字符串，提交时仍须上传两类附件并选择经办人。
3.4 中标情况
填报造价单位、项目名称、中标时间、中标结果文件和节点办理人；项目名称最多 255 个字符，与持久化字段长度一致；台账按中标记录分页展示、支持单位筛选、文件可查。草稿可暂不上传中标结果文件；但需填写实库非空列要求的造价单位、项目名称、中标时间、发起部门部长、监督审计法务部部长、发起部门分管领导、总经理和董事长，发起部门由当前用户部门带出。空附件在草稿中保存为空字符串，提交时仍须上传结果文件；建设管理部部长列可空，提交时按发起部门决定是否要求该节点。
常规审批顺序：发起部门部长 → 监督审计法务部部长 → 建设管理部部长 → 发起部门分管领导 → 总经理 → 董事长。建设管理部发起时跳过建设管理部部长。“审计法务部”对应“监督审计法务部”，“建管部”对应“建设管理部”。发起部门取当前用户部门。支持草稿和退回修改后重提；抽取与中标单据不强制关联。
流程状态采用平台编码 draft、waiting、back、finish，对应草稿、进行中、退回、已通过。退回须说明原因；后端校验有效当前办理人、单据和 taskId。草稿和退回单据仅创建人可编辑；仅创建人可删除本人草稿，其他状态不可删除。该维护规则按用户确认的建议执行。
4. 非功能与验收标准
权限使用模块:资源:动作三段式，服务端逐接口校验；全量查看不改变操作权限。导入整批事务写入；任一行错误需整批回滚并反馈真实行号。主键 Long 使用平台序列化，前端保留原始 string 或 number。名称、考核期间、流程任务与并发引用需要一致性保护。
| 编号 | 验收例子 | 预期 |
|---|---|---|
| AC-CU-01 | 导入正确/错误模板 | 正确整批新增；错误时整批不落库并报行号 |
| AC-CU-02 | 改单位但不附审批文件 | 拒绝；附文件后保存并追加字段级历史 |
| AC-CU-03 | 重名或删除有记录单位 | 有效重名及有关联删除拒绝；已删除名称可复用 |
| AC-CU-04 | 暂停、启用和出库 | 窗口派生准确，启用清窗，出库保存原因时间 |
| AC-CU-05 | 三类台账 CRUD、分数和重复考期 | 无审批；0–100 两位小数；重复期间拒绝 |
| AC-CU-06 | 点击违规次数 | 跳转违规台账并按单位过滤 |
| AC-CU-07 | 抽取草稿、提交、退回、重提及结果登记 | 草稿满足实库非空列但可不上传附件、不选经办人；提交后附件、经办人及审批历史正确 |
| AC-CU-08 | 中标草稿与常规审批 | 草稿满足实库非空列但可不上传结果文件、不填写可空的建管部部长；提交后六节点按序，终审已通过，意见时间可查 |
| AC-CU-09 | 建管部发起中标 | 跳过建管部部长，其余顺序不变 |
| AC-CU-10 | 其他部门用户查询和办理 | 菜单用户看全量；仅当前办理人可办 |
5. 决策与待验收
用户选择按此前逐项建议推进，已据此确定：独立顶层菜单、原型字段、行内历史、最近考核汇总、分页中标台账、暂停派生、暂停/出库只提示、违规单位限定库内、部门不强制绑定、两类单据不关联、不做导出通知、平台性能基线。有效名称唯一、关联单位禁止删除、考核精度、期间唯一、全量可见、考核角色和中标审批顺序由用户明确确认。
仍需业务验收：建管部发起跳过节点尚未完成浏览器 E2E（前端跳过判断已于 2026-09-27 改为与后端一致的单据发起部门快照基准）。开发库集团造价管理岗菜单映射已于 2026-09-27 经 MCP 回读核实存在（42 行）。详见测试报告。