同一时期多件事并行、每件事有负责人和工期、现场会临时加任务——这类业务用串行审批模型很难描述。本文梳理一套工程管理模块的分层设计:数据模型、状态机、三类任务入口与接口划分。
工程管理模块 不是把甘特图硬塞进流程引擎,而是参照流程引擎的分层方式,单独做了一套工程运行时:
用户侧体验对齐流程:发起、待办、在途、已完成。处理页不是节点审批表单,而是任务树 + 进度 + 项目表单 + 工作日志 + 文件工作区。
一句话概括:
流程管审批路径,工程管并行任务与工期落地。
流程引擎擅长串行/并行审批:谁发起、谁审批、谁会签、什么时候结束。装修、施工、IT 交付这类业务则是另一套问题:
典型诉求 | 流程引擎 | 工程管理 |
|---|---|---|
表现形态 | 流程图、审批轨迹 | 任务树、甘特进度 |
工作方式 | 节点顺序流转 | 多任务可并行推进 |
时间含义 | 到达时间、停留时长 | 计划开始/结束、工期、工时 |
人员角色 | 当前处理人 | 项目负责人 + 任务负责人 + 参与人 |
里程碑 | 通常用节点模拟 | 可作为独立任务类型 |
文件协作 | 表单附件为主 | 任务文件、工作区、送审 |
如果强行用流程“一个节点一项施工任务”,会出现三个问题:
所以 工程管理模块 的定位很明确:复用该引擎的组织、表单、菜单、HttpHandler 体系,但用独立的工程运行时承载项目执行。
流程类别 FlowSort → 流程模板 Flow → 流程实例 GenerWorkFlow工程管理模块 完全对称:
工程类别 TemplateSort → 工程模板 TemplatePrj → 工程实例 GenerPrj
↓ ↓
任务组 / 任务模板 任务组 / 任务实例对照关系:
维度 | 流程引擎 | 工程管理 工程管理模块 |
|---|---|---|
类别 | 平台配置实体 | 工程管理表 |
模板 | 平台配置实体 | 工程管理表 |
节点定义 | 平台配置实体 | 工程管理表 + 工程管理表 |
实例主键 | WorkID | OID(算法生成,不是库自增) |
业务编号 | BillNo | BillNo(按模板 BillNoFormat 生成) |
实例控制表 | 平台配置实体 | 工程管理表 |
待办人员 | 平台配置实体 | 工程管理表 |
轨迹 | 平台配置实体 | 工程管理表 |
用户入口 | 发起 / 待办 / 在途 / 已完成 | 同样四件套 + 任务中心 |
处理页 | MyFlow.vue | MyPrj.vue |
最关键的一条规则:
模板只负责“长什么样”,实例才负责“怎么执行”。创建后互不影响。
装修标准模板改了节点,已经开工的项目不会被带偏;某个项目现场加了“隐检验收”,也不会污染标准模板。这和流程“发起后按当时版本跑”是同一类思路。
前后端都独立成模块,不把工程逻辑塞进 Dev2Interface 流程大类里。
前端 前端模块源码目录该引擎/工程管理模块
├── Port.vue 工程模块入口
├── MyPrj.vue 项目处理器(进度 / 表单 / 日志)
├── PrjToolBar.vue 状态感知工具栏
├── SearchPrj.vue 按模板查询实例
├── TaskCenter.vue 任务中心(待办 / 参与中 / 已办)
├── TaskGener.vue 通用任务工作台
├── TaskFlow.vue 绑定流程的任务
├── TaskBill.vue 绑定单据的任务
├── FileWorkspace.vue 工程文件工作区
├── Admin/ 模板库、步骤设计、文件工作区配置
└── GenerList/ 发起 / 待办 / 在途 / 已完成列表
后端 工程管理模块
├── Template/* 模板实体:类别、模板、任务组、任务
├── GenerPrj / GenerTask* 运行时实体
├── GenerWorker 待办人员
├── PrjTrack / PrjWorkerLog 轨迹与工时日志
├── 工程接口类 工程接口工具类
├── 工程管理接口 运行时 HttpHandler
└── 工程管理后台接口 管理端 HttpHandler调用链也很“该引擎化”:
菜单
→ GenerList / TaskCenter / SearchPrj
→ HttpHandler(工程管理接口)
→ 工程接口类
→ 实体表
→ MyPrj / TaskGener / TaskFlow / TaskBill前端统一通过:
new HttpHandler('工程管理接口')管理端走 工程管理后台接口。实体仍是 BP 框架那套:Attr 常量 + Entity + Entities + EnMap。
一个工程模板不是“一张任务清单”,而是 任务组 + 任务:
室内装修标准模板
├─ 施工准备
│ ├─ 场地勘察
│ └─ 材料进场
├─ 顶面工程
│ ├─ 门头钢结构
│ ├─ 轻钢龙骨
│ └─ 隐检验收
└─ 墙面工程
├─ 抹灰
└─ 腻子对应表:
表 | 实体 | 作用 |
|---|---|---|
工程管理表 | TemplateSort | 工程类别树,对应流程类别 |
工程管理表 | TemplatePrj | 工程模板主表 |
工程管理表 | TemplateTaskGroup | 任务组(阶段) |
工程管理表 | TemplateTask | 任务定义 |
模板主表里,有几项是直接从流程“抄作业”的:
BillNoFormat:如 PRJ-{yyyy}-{MM}-{0000},创建实例时生成业务编号TitleRole:标题规则,如 @WebUser.Name的{Name}PTable:项目表单存储表,默认可落到 Prj + 模板编号Draft:草稿规则,与流程一致 0 不设草稿 1 保存到待办 2 保存到草稿箱IsCanEditTemplate:实例是否允许改任务结构任务模板上还有一个很关键的字段:TaskType
TaskType | 含义 | 运行时页面 |
|---|---|---|
0 | 通用任务 | TaskGener.vue:填日志、记工时、标记完成 |
1 | 绑定单流程 | TaskFlow.vue:进入已绑定的该引擎流程 |
2 | 绑定单表单/单据 | TaskBill.vue:在任务里填一张独立表单 |
也就是说,工程不是替代流程,而是可以内嵌流程和单据。一个项目里,隐检验收走审批流,材料进场填单据,日常施工记工时,三种活可以并存。
表 | 实体 | 作用 |
|---|---|---|
工程管理表 | GenerPrj | 工程实例控制表 |
工程管理表 | GenerTaskGroup | 任务组实例 |
工程管理表 | GenerTask | 任务实例 |
工程管理表 | GenerWorker | 任务待办/参与人 |
工程管理表 | PrjTrack | 工程操作轨迹 |
工程管理表 | PrjWorkerLog | 工作日志(含工时) |
实例主键 OID 用后端算法生成(DBAccess.GenerOID("PrjID")),编号风格对齐 WorkID。任务编号采用:
任务No = 工程OID + "_" + 模板任务No
任务组No = 工程OID + "_" + 模板任务组No例如工程 10001 下,模板任务 N007 的实例号是 10001_N007。这样查询、权限、文件挂接都有稳定主键,又不依赖数据库自增。
工程实例还带了一组按钮权限字段,避免所有人都能点“完成/移交”:
DataRight:数据只读 / 不可见BtnSaveRole:谁能保存BtnCompleteRole:谁能标记完成BtnTransferRole:是否允许移交BtnPrintRole:是否允许打印接口:工程接口类.创建草稿实例(templateNo)
大致步骤:
TemplatePrjGenerPrj,状态先是草稿BillNoFormat 生成 BillNoGenerTaskGroupGenerTask,带上负责人、参与人、任务类型、关联模板GenerWorkerMapData 存在,并写入一份业务数据创建工程: xxx之后模板怎么改,都不会再回头改这份实例。
如果模板草稿规则是“保存到待办”,创建后会给发起人在 Idx 最小的任务上写一条待办。这点和流程“发起节点产生待办”是对齐的。
这里要特别注意:工程状态枚举值和口语习惯不完全一样,开发时不要按“1=进行中”去猜。
PrjSta草稿(0) ──发起──> 进行中(2) ──完成──> 已完成(1)
│ │
├──暂停──> 暂停(3) └──回滚──> 进行中(2)
│
└──作废──> 作废(4)值 | 枚举 | 说明 |
|---|---|---|
0 | Draft | 草稿,可删、可发起 |
1 | Complete | 已完成 |
2 | Runing | 进行中 |
3 | Pause | 暂停 |
4 | Invalid | 作废 |
发起前会做完整性校验:至少有一个任务、任务有名称和负责人;如果时效是日期范围,开始/结束日期必须合法。
全部任务完成后,系统可以把工程自动置为已完成。管理端仍保留手动“设置完成 / 回滚 / 作废”。
TaskSta值 | 含义 |
|---|---|
0 | 未开始 |
1 | 已完成 |
2 | 延期 |
3 | 暂停 |
任务还有三种时效:无期限 / 按照工时 / 日期范围。日期范围任务会校验 DTFrom、DTTo;工时任务则和 PrjWorkerLog.Hours 配合做人力统计。
WorkerSta值 | 含义 |
|---|---|
0 | 未阅 |
1 | 已完成 |
2 | 已阅 |
3 | 拒绝(标记,不走审批流) |
待办列表看的就是:当前人在 工程管理表 上,且任务尚未完成。
TaskCenter.vue 是个人工作台,三个范围:
点开任务后,按 TaskType 打开不同工作台,而不是一股脑进同一个表单。
MyPrj.vue这是工程模块的“MyFlow”。三个 Tab:
FrmID 默认 Prj + 模板编号)工具栏按状态和角色动态出现:
按钮 | 草稿 | 进行中 | 已完成 | 暂停 | 作废 |
|---|---|---|---|---|---|
发起 | 有 | 有 | 有 | ||
删除 | 有 | 有 | 有 | ||
暂停 | 有 | ||||
设置完成 | 有 | 有 | |||
移交 | 可配置 | 可配置 | |||
作废 | 有 | 有 | |||
回滚 | 有 | ||||
文件工作区 | 有 | 有 | 有 | 有 | 有 |
权限不是“登录就能改”。保存、完成、移交分别看:
BtnSaveRole / BtnCompleteRole / BtnTransferRole通用任务适合施工、巡检、日常执行:
流程任务适合验收、变更、付款审批:任务上绑定一个可发起流程,处理时直接进 MyFlow。
单据任务适合材料申报、隐蔽验收记录:任务上绑定一张独立表单,保存的是单据数据,不是工程主表。
这是 工程管理模块 和“纯项目管理工具”最大的差别:它长在该引擎上,所以任务可以变成流程,也可以变成单据。
SearchPrj.vue对齐流程查询页:
工程不只是进度条,现场往往还有图纸、方案、送审文件。模板上可以配:
运行时 FileWorkspace.vue 提供目录树、任务过滤、打开/定位文件、送审。任务行上也能看到当前节点挂接的文件。
对装修、施工、设计类项目,这比“所有附件堆在一张表单底部”更接近真实协作。
管理入口是 项目模板库 TemplateList.vue:
步骤设计不是画流程图,而是维护:
模板 → 任务组 → 任务(类型 / 负责人 / 默认工期 / 关联流程或表单)模板设计完后,可以通过菜单“引入工程组件”,给某个模板挂上:
这和流程的 LinkFlow 是同一套路:低代码门户里,工程也可以被当成组件嵌进应用。
工程接口类 是工程版 Dev2Interface。命名习惯保持一致:DB_ 查列表,工程_ / 节点_ 做动作。
方法 | 用途 |
|---|---|
DB_Starter | 可发起的工程模板 |
DB_Todolist / DB_TaskTodolist | 我的任务待办 |
DB_TaskDoneList | 已办 |
DB_TaskParticipatingList | 我参与的 |
DB_TaskAllList | 全部(管理员) / 可感知任务 |
DB_Runing | 在途工程 |
DB_Complete | 已完成工程 |
DB_SearchPrj | 按模板查询实例 |
任务列表支持分页和关键字,返回结构给任务中心直接用:工程标题、任务名、类型、负责人、计划时间、状态。
方法 | 说明 |
|---|---|
创建草稿实例 | 按模板创建草稿实例,返回 OID |
工程管理表 | 草稿/暂停 → 进行中 |
工程管理表 | 完成 |
工程管理表 | 暂停 |
工程管理表 | 作废 |
工程管理表 | 已完成回滚为进行中 |
工程管理表 | 删除(草稿等允许删除的状态) |
工程管理表 | 保存标题、周期、表单数据 |
工程管理表 | 移交 |
工程管理表 | 退出参与 |
工程管理表 | 甘特/任务树数据 |
工程管理表 | 轨迹 |
方法 | 说明 |
|---|---|
Node_CheckAuth | 打开任务前鉴权 |
Node_SetOver | 完成任务;若全部完成则自动完成工程 |
SyncTaskWorkers | 同步负责人/参与人到待办表 |
Node_WorkerAdd / Remove | 加减人 |
HttpHandler 只做参数接收和 JSON 组装,业务都放接口类。前后端约定仍然是该引擎那套 err@ / info@ 消息协议。
创建工程时,不会要求管理员先手工建业务表。接口会:
PTable(或 Prj + 模板编号)作为 FrmIDMapData 就自动建 Fool 表单CheckPhysicsTable 保证物理表存在GenerPrj 同步进业务表MyPrj 的“项目表单”Tab 直接渲染这张表。业务字段可以继续用表单设计器加,不必改工程内核。
流程待办是“我有一个 WorkID 要批”。工程待办是“我在某个任务上有一条 Worker”。
所以一个工程里,张三可能待办“龙骨安装”,李四可能待办“隐检验收”,两人同时推进。这才是项目并行的本质。
甘特上看进度,日志里看“今天具体干了什么”。人力统计走 DurationDays / TimeLimitHours + 日志工时,第一版不引入金额成本。
需求里写得很清楚,避免做成“四不像项目管理”:
先把“模板复制成实例 + 并行任务 + 三类任务入口”跑稳,再谈依赖网络和成本。
以“室内装修标准模板”为例:
BillNo,状态为草稿。MyPrj 上看整棵任务树和文件。这和流程“发起 → 待办 → 归档”是同一用户心智,只是处理对象从“审批节点”换成了“项目任务”。
适合:
不适合硬套:
更务实的用法是组合:
工程管执行结构,流程管关键审批,单据管结构化填报。
工程管理模块 的需求可以收成五句话:
如果把该引擎理解成“组织 + 表单 + 流程”的底座,那么 工程管理模块 就是在这个底座上补了一块 项目执行引擎。它不是甘特图控件,而是一套可发起、可待办、可授权、可追溯的工程运行时。
后续如果继续增强,比较自然的方向是:任务前置依赖、甘特拖拽排期、移动端任务处理、以及基于工时的简单产能报表。这些都可以在现有 GenerTask / PrjWorkerLog 上长出来,不必推翻这套三层模型。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。