主题
造价单位管理 · 概要设计文档
文档版本：0.10 ｜ 最近核对日期：2026-09-26
最近核对日期：2026-09-26。六个页面与两条 V3 流程已实现并完成开发环境端到端验证；业务验收待业务方。规则正文唯一维护于需求分析。
1. 模块定位和分层
以独立顶层「造价单位管理」维护造价咨询单位主数据、违规/考核事实、抽取申请和中标情况。单位主数据不强制绑定平台部门；抽取与中标两类单据不强关联。
后端按 Controller、BO/VO、Service、Mapper、Entity 分层，代码在 digital-construction-business 的 costunit 包。前端页面/API 位于 src/views/business/costUnit 和 src/api/business/costUnit。流程 JSON 位于 digital-construction-workflow/src/main/resources/flow/cost-unit，复用平台 Warm-Flow、Sa-Token、OSS、分页和事务。
2. 页面与路由
| 页面 | 路由 | 职责 |
|---|---|---|
| 基本信息 | /costUnit/unit | 单位库、导入、修改历史、暂停/启用、出库、删除 |
| 违规情况 | /costUnit/violation | 违规事实 CRUD |
| 季度考核 | /costUnit/quarterAssess | 季度结果 CRUD、附件预览 |
| 年度考核 | /costUnit/annualAssess | 年度结果 CRUD、附件预览 |
| 抽取申请 | /costUnit/drawApplication | 草稿、提交、申请台账 |
| 抽取办理 | /costUnit/drawApplication/flowForm | 审核、登记抽取结果、流程时间线 |
| 中标情况 | /costUnit/awardResult | 草稿、提交、中标台账 |
| 中标办理 | /costUnit/awardResult/flowForm | 当前审批任务、时间线 |
3. 数据与状态模型
开发库新建 9 张业务表、共 134 列：单位主表、修改事件/差异/附件三表、违规、季度、年度、抽取申请、中标结果。完整物理字段、空值/默认值、索引见数据库设计。
违规次数和最近考核结果为查询派生值；暂停状态按暂停窗口与当前时间派生。有效单位名称唯一且逻辑删除名称可复用；考核按同单位、同期间唯一。单位删除检查覆盖六类子表关联；并发写入通过活动单位行锁和数据库唯一索引约束。
流程编码为 draft、waiting、back、finish，展示为草稿、进行中、退回、已通过。抽取申请经办人审核并登记结果。中标常规审批为发起部门部长 → 监督审计法务部部长 → 建设管理部部长 → 发起部门分管领导 → 总经理 → 董事长；建设管理部发起时跳过部长节点。
当前开发环境运行版本为抽取申请 V3 和中标情况 V3。V3 只调整流程图节点、连线坐标和画布布局；节点、条件及业务流转语义与 V2 保持一致，旧版本记录保留。版本状态和 V3 实例验证见数据库设计与测试报告。
4. 权限和安全
有任一对应页面菜单权限即可查看全部模块记录；无部门/创建人过滤。每种写动作有独立三段式权限码，后端逐接口鉴权；流程办理还需当前有效 taskId 和办理人匹配。
开发库回读有 42 条本模块菜单/按钮权限行，包括六个台账、两条隐藏流程办理页和 33 个动作权限。集团造价管理岗已于 2026-09-27 经 MCP 回读确认绑定本模块完整菜单（42 行）；正式环境的实际人员映射待上线配置。本轮开发 E2E 使用超级管理员代办且没有修改组织资料。
5. 实现决策与限制
暂停到期按查询派生，不用定时任务。暂停/出库引用时提示不硬拦截：单位下拉选用时弹窗提示，确认后继续，取消清空选择。草稿和退回单据仅创建人可编辑；仅本人草稿可删除，规则按用户确认的建议实施。删除保护实现覆盖六类子表（含修改历史），严于需求基线的四类活动记录，待业务裁决。中标建管部跳过分支已实现，前后端统一按单据发起部门快照判断，但本轮浏览器没有以建管部身份走分支。详见测试报告。