工作台与项目管理
这篇解决什么
工作台数字从哪来、立项单和台账为什么是两张表。读完能对上 GET /project/home/summary、project_info、project_ledger,以及审批通过后 id 怎么沿用。
默认端口 48080,管理端前缀 /admin-api。PC 开发页 http://127.0.0.1:5800。先开模块见 项目功能设计。
示意图:工作台只汇总。立项是申请单,通过后才有运营台账。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 工作台 | @RequestMapping("/project/home") | ruoyi-office/yudao-module-project/.../controller/admin/home/ProjectHomeController.java |
| 汇总 | GET /summary | 同上 |
| 立项接口 | @RequestMapping("/project/info") | ProjectInfoController |
| 立项表 | project_info | ProjectInfoDO |
| 保存 / 提交 | POST /save、/submit | 同上 |
| 按模板建草稿 | POST /create-from-template | 同上 |
| 台账接口 | @RequestMapping("/project/ledger") | ProjectLedgerController |
| 台账表 | project_ledger | ProjectLedgerDO |
| PC | 工作台 /project/project-home,立项 /project/project-apply-list,台账 /project/project-ledger-list | ruoyi-office-vben/apps/web-antd/src/views/project/ |
官方菜单:7611 项目工作台,7252 项目立项,5431 项目台账。按钮 project:apply:save / submit,台账 project:ledger:query。自定义表单路径 /project/project-apply-detail。

本系统截图:项目 → 项目工作台。KPI、我的项目、我的任务、预警都来自 /project/home/summary。

本系统截图:项目 → 项目台账。这里才是审批通过后的运营资产。
立项和台账怎么分
立项走 FlowBillService,单据码 601,流程 key project_create。通过后写入 project_ledger,台账 id 沿用立项单 id,子表 projectId 不用改。台账状态:2 进行中、3 暂停、4 已完成、5 已终止、6 已归档。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
billCode | 库列仍是 project_code | project_info |
processStatus | 申请单审批状态 | 同上 |
draftProjectId | 台账回指立项单 | project_ledger |
status | 台账生命周期 | 同上 |
managerUserId / deptId | 经理和部门 | 两张表都有 |
| 分类 / 项目集 | categoryId / groupId | project_category、project_group |
CREATE TABLE project_info (
id bigint NOT NULL AUTO_INCREMENT,
project_code varchar(64) DEFAULT NULL,
project_name varchar(255) DEFAULT NULL,
process_instance_id varchar(64) DEFAULT NULL,
process_status int DEFAULT NULL,
manager_user_id bigint DEFAULT NULL,
PRIMARY KEY (id)
);工作台汇总当前用户:我负责 / 我参与的项目数、进行中、逾期、待办任务、今日到期、待审工时、临近里程碑。不是一张 project_home 表。
示意图:没通过的申请不会进台账列表。工作台读的是台账和任务,不是草稿。
不要在立项表上改运营状态
暂停、完成、终止、归档走台账接口。立项单只负责申请和审批痕迹。模板实例化任务树也是先落草稿,再随立项走。
配置与操作
走 项目 → 项目立项(菜单 7252)的 list / info,填项目名称、managerUserId / deptId、分类 categoryId、项目集 groupId 后 POST /save 或 /submit。流程 key 是 project_create,单据码 601。未通过不会进台账。
审批通过后看 项目台账(5431),id 沿用立项单。暂停、完成、终止、归档改台账 status(2 进行中、3 暂停、4 已完成、5 已终止、6 已归档),不要在立项表改运营状态。工作台 7611 读当前用户负责 / 参与的台账和任务,不是草稿。
截图见上文。
