从一次"发起工程"看调用链：工程管理模块的目录结构与关键方法

一份偏工程视角的源码导读：按一次真实操作串起前后端调用链，梳理模块目录分工、实例创建步骤、状态枚举约定与二次开发的常用落点。

阅读顺序建议

先不要按目录把 40 多个文件从头扫到尾。按这条调用链看，会快很多：

GL_PrjStart.ts
  → 工程管理接口.CreatePrj
    → 工程接口类.创建草稿实例
      → MyPrj.vue
        → TaskCenter / TaskGener / TaskFlow / TaskBill

记住两个 Handler：

前端封装在 Comm/PrjComm.ts：

PrjComm.GetHandler      // 工程管理接口
PrjComm.GetTaskHanlder  // 工程管理后台接口

业务不要写在 Vue 里拼 SQL，也不要写在 Handler 里堆逻辑。Handler 只接参数、转 JSON；真正干活的是 工程接口类。

一、目录地图

前端 前端模块源码目录

后端 引擎源码模块

实体写法与流程模块相同：XxxAttr + Entity + Entities + EnMap。改字段先改 EnMap，再改接口，不要只改前端。

二、入口：点一个模板，发生了什么

GL_PrjStart 继承 PageBaseGenerList，页面本身复用流程的 GenerList.vue。它只做三件事：列怎么显示、数据从哪来、点行去哪。

  async Init {
    this.PageSize = 0;
    this.LinkField = 'Name';
    this.GroupFields = 'SortName';
    this.HisGLShowModel = GenerListPageShowModel.Windows;
    // ...
    const handler = new HttpHandler('工程管理接口');
    const data = await handler.DoMethodReturnJson('TaskStart_Init');
    this.Data = data;
  }

  async LinkFieldClick(object: Record<string, any>) {
    const handler = new HttpHandler('工程管理接口');
    handler.AddPara('TemplateNo', object.No);
    const PrjID = await handler.DoMethodReturnString('CreatePrj');
    const url = `/src/该引擎/工程管理模块/MyPrj.vue?PrjNo=${PrjID}`;
    return new GPNReturnObj(GPNReturnType.OpenUrlByDrawer90, url, '项目处理');
  }

对应后端非常薄：

        public string CreatePrj
        {
            string templateNo = this.GetRequestVal("TemplateNo");
            Int64 oid = 工程接口类.创建草稿实例(templateNo);
            return oid.ToString;
        }

待办列表是同一模式。GL_PrjTodolist 调 PrjTodolist_Init，点行同样打开 MyPrj.vue?PrjNo=...。二次开发如果要加“我延期的工程”，优先抄这两个 GL 文件，不要新写一张列表页。

三、创建实例：模板复制到运行时

核心在 工程管理表。建议按注释里的步骤打断点：

1. 读 TemplatePrj
2. OID = DBAccess.GenerOID("PrjID")，不要用数据库自增
3. 状态先写 PrjSta.Draft
4. 用模板 BillNoFormat 调流程现成的 WorkFlowBuessRole.GenerBillNo
5. 复制 TemplateTaskGroup → GenerTaskGroup
6. 复制 TemplateTask → GenerTask
7. SyncTaskWorkers 写待办人
8. EnsurePrjForm 保证项目表单和物理表存在
9. PrjTrack.WriteLog 记一条“创建工程”

任务主键约定必须守住：

任务组 No = 工程OID + "_" + 模板任务组No
任务   No = 工程OID + "_" + 模板任务No

前端从实例号反推模板任务号时，用的就是这个规则，见 taskHandler.deriveTemplateTaskNo。乱改编号，流程任务/单据任务会找不到绑定关系。

复制任务时会带上 TaskType 和 RefTemplateNo。通用任务、流程任务、单据任务在实例里只是不同类型的 GenerTask，不是三张表。

草稿规则和流程对齐：

• Draft = 1（保存到待办）：给发起人在 Idx 最小的任务上插一条 GenerWorker
• Draft = 2（保存到草稿箱）：只建实例，不进待办
• Draft = 0：不走草稿策略

所以“为什么创建后有的人立刻看到待办，有的没有”，先查模板的 Draft 字段。

四、状态值不要靠猜

Template/PrjEnum.cs 里工程状态不是 0/1/2 递增那么直觉：

Draft    = 0;  // 草稿
Complete = 1;  // 已完成
Runing   = 2;  // 进行中
Pause    = 3;
Invalid  = 4;

任务状态：

None     = 0;  // 未开始
Complete = 1;
Delay    = 2;
Pause    = 3;

人员状态在 GenerWorker.cs：

UnRead   = 0;
Complete = 1;
Read     = 2;
Refuse   = 3;

前端 PrjComm.PrjStaText / NodeStaText / WorkerStaText 必须和这里一致。工具栏判断也是按这些数字，见 PrjToolBar.vue。

发起校验在 CheckPrjStartData：没任务、没名称、没负责人、日期范围缺日期，都会返回 err@...。前端只要原样提示，不要自己再写一套校验。

完成任务走 Node_SetOver：任务置完成 → 相关 Worker 置完成 → 若全部任务完成则 工程管理表。自动完成工程的开关就在这里，改产品规则优先改这一段。

五、项目处理器：MyPrj 怎么把数据摊开

MyPrj_Init 直接把甘特数据集吐给前端：

        public string MyPrj_Init
        {
            DataSet ds = 工程接口类.Prj_GetGanttData(this.PrjID);
            return BP.Tools.Json.ToJson(ds);
        }

MyPrj.vue 自己拼任务组和任务的树，三个 Tab：

• gantt：节点进度
• form：项目表单（Fool 表单，FrmID 默认 Prj + 模板编号）
• log：轨迹

按钮不写死在页面里，而由 PrjToolBar.vue 按 PrjSta + 角色计算。草稿出发起/删除，进行中出暂停/完成/移交/作废，已完成出回滚。表单 Tab 只出保存和打印。

权限字段在 GenerPrj 上：

• BtnSaveRole
• BtnCompleteRole
• BtnTransferRole
• BtnPrintRole

二次开发加按钮时：

1. PrjToolBar 加一个 action
2. MyPrj.vue 的 handleToolbarAction 接住
3. 平台配置实体 加一个薄方法
4. 工程接口类 写业务并打 Track

不要只改 Vue。

打开具体任务前会走 Node_CheckAuth / MyPrjFrm_CheckAuth。无权限就停，不要假定点得开就能改。

六、任务中心：按类型打开不同组件

TaskCenter.vue 三个 scope：todo / running / complete，数据来自：

• PrjTaskTodolist_Init
• PrjTaskParticipatingList_Init
• PrjTaskDoneList_Init

真正决定打开哪一页的是 Comm/taskHandler.ts：

export function getTaskTypeLabel(taskType: number) {
  switch (taskType) {
    case 1:
      return '流程任务';
    case 2:
      return '单据任务';
    default:
      return '通用任务';
  }
}

export function getTaskHandlerCompUrl(taskType: number) {
  if (taskType === 1) return '/@/该引擎/工程管理模块/TaskFlow.vue';
  if (taskType === 2) return '/@/该引擎/工程管理模块/TaskBill.vue';
  return '/@/该引擎/工程管理模块/TaskGener.vue';
}

如果要加第四种任务（例如“绑定报表”）：

1. TemplateTask.TaskType 枚举加值
2. 模板设计里能选
3. 创建实例时把类型复制到 GenerTask
4. getTaskHandlerCompUrl 增加映射
5. 新建一个 TaskXxx.vue，继续用 loadTaskRuntimeData 做鉴权和基本信息

不要为新类型新建一套待办表。待办始终是 工程管理表。

七、管理端：模板库和步骤设计

运行时看 平台配置实体，设计态看 平台配置实体：

前端模板实体 TemplatePrj.ts 上两个入口最常用：

• fStep：打开表单设计器，FrmID = Prj + 模板编号
• DoFileWorkspaceConfig：没有配置就先 Save 一份，再打开配置实体

步骤设计不是流程图，是 PG_TemplateTaskGroup2Task：左边任务组，右边任务，支持组内排序、拖动。RefKey = GroupNo。新增任务时会带上当前 TemplateNo。

模板主表关键字段：

• PTable / 表单编号
• BillNoFormat
• TitleRole
• Draft
• IsCanEditTemplate

改“发起后能不能改任务结构”，看的是 IsCanEditTemplate，不是前端按钮显隐。

八、文件工作区从哪接进去

配置实体：Admin/Template/TemplateFileWorkspaceConfig.ts 表：工程管理表

字段要点：

• ReviewFlowNo：文件送审流程
• BucketName / ObjectPrefix：对象存储
• ParticipantsNo：工作区参与人

运行时接口在 平台配置实体 后半段：Workspace_Init、File_StartReview、File_BindReviewWork。MyPrj 工具栏的「文件工作区」和任务页里的 TaskFilePanel 都走这套，不是另一套附件表。

改送审规则时，先看文件是如何绑定 WorkID 的，再改流程，不要在 Vue 里写死流程编号。

九、二次开发最常见的四个落点

1. 加一张用户列表

抄 GL_PrjTodolist.ts + 平台配置实体 一个 xxx_Init + 工程接口类.DB_xxx。列表 UI 继续用 GenerList.vue。

2. 加一个工程按钮

PrjToolBar.vue → MyPrj.vue → 工程管理接口.MyPrj_Xxx → 工程接口类.Prj_Xxx，最后 PrjTrack.WriteLog。

3. 加业务字段

不要改 GenerPrj 内核。去模板的表单设计器加字段，数据落在 PTable。EnsurePrjForm 已经会创建默认字段和物理表。

4. 改待办口径

待办不是按工程算，是按 Prj_GenerWorker + GenerTask 算。改“谁能看见这条待办”，改 DB_TaskList，不要改 MyPrj.vue 的过滤。

十、调试时一眼能定位的问题

Handler 约定沿用该引擎：成功返回数据或纯文本，失败返回 err@原因。前端看到 err@ 就提示，不要当 JSON 解析。

十一、一条最小阅读清单

如果只有半天，按这个顺序打开文件：

1. GenerList/GL_PrjStart.ts
2. 工程管理接口.CreatePrj / MyPrj_Init / MyPrj_Start
3. 工程接口类.创建草稿实例
4. 工程接口类.Prj_Start + CheckPrjStartData
5. GenerPrj.cs、GenerTask.cs、GenerWorker.cs
6. MyPrj.vue + PrjToolBar.vue
7. Comm/taskHandler.ts
8. TaskGener.vue（通用任务是默认路径）
9. Admin/Template/PG_TemplateTaskGroup2Task.ts

把这条链走通，再去看文件工作区和甘特配置，不会迷路。本文只解决一件事：代码从哪进、改完往哪写。