主题
产品定位
一句话:PMForge 是一套可以直接跑起来的企业级后端底座,加上一层正在建设的项目管理业务域,以及一套把两者讲清楚的知识库。它回答的不是「怎么再做一个 SaaS」,而是「一个 PM 从业者或学习者,如何在一套真实的多租户系统上,把项目管理方法论落到代码与数据里」。
1. 三层价值
| 层 | 是什么 | 可验证的落点 | 状态 |
|---|---|---|---|
| 平台底座 | 多租户、权限、组织、字典、消息、文件、代码生成、定时任务 | 41 个 Reactor 项目(17 个一级模块,含 15 个 Starter 子模块)、单体 jar 146.5 MB、已实现模块 328 个接口与 48 张表 | ✅ |
| 项目管理业务域 | 项目、迭代与里程碑、任务、工时、风险与问题、项目报表共 6 个功能点 | 只在产品概述与能力地图里有定义,尚无代码 | 🚧 |
| 实践属性 | 53 张功能卡(40 已实现 + 13 预留模块)、37 篇子 PRD、代码索引,「为什么这样设计」被写下来 | /cards/、/code/api/system、/reference/ | ✅ |
1.1 底座:先做对「企业系统的公共部分」
决定一个企业系统能不能落地的,很少是业务页面,而是这些公共件:租户怎么隔离、菜单与权限点怎么对上、组织架构怎么挂人、字典怎么改文案、消息怎么触达、文件怎么存、重复的 CRUD 怎么少写。PMForge 把这些问题集中在 pmforge-module-system(32 张表)与 pmforge-module-infra(16 张表,含 5 张演示表)两个模块里,并通过 40 张功能卡逐条写清;13 个预留模块另各有 1 张模块卡。
- 一次构建产出
146.5 MB的可执行 jar,pmforge-server是唯一入口,聚合 system + infra 两个业务模块。 - 328 个后端接口全部有索引:/code/api/system 212 个、/code/api/infra 116 个。
- 多租户不是「加个字段」:租户上下文进入 SQL、缓存与定时任务,详见 关键流程 与 /modules/system。
1.2 业务域:项目管理是「产品」,不是「演示」
平台本身不含项目管理语义。真正的产品目标是 6 个功能点:项目主数据、迭代与里程碑、任务、工时、风险与问题、项目报表。它们当前状态是 🚧(规划未编码),但边界、优先级(P0/P1/P2)以及要挂在平台哪些能力上已经确定,见 能力地图 与 领域模型。
1.3 实践:把「能跑」变成「能讲、能学、能改」
相同的一套代码,可以只当脚手架,也可以当教材。差别在于有没有把决策与约束写下来。本知识库的做法是:
- 一个功能点一个 ID(如
SYS-TENANT-01),PRD、功能卡、代码索引、目录标题都引用它,避免三套编号对不上。 - 双层结构:产品层讲「为什么」,代码层讲「在哪里」;一个人可以从任意一层进入,再用 ID 跳到另一层。
- 生成物不手改:接口索引、数据表、枚举、错误码由脚本扫描生成并在 CI 校验,所以「文档过期」是可检测的,而不是靠自觉。
2. 目标用户与他们的关键任务
| 用户 | 他们用 PMForge 做什么 | 入口 |
|---|---|---|
| 平台管理员 | 开租户、配套餐、维护全局菜单与字典、看全平台日志 | SYS-TENANT-01、SYS-PERM-01 |
| 租户管理员 | 建本租户的部门、岗位、用户、角色,配本租户消息模板 | SYS-ROLE-01、SYS-DEPT-01 |
| 项目经理 | 组织项目组、拆任务、追工时、发通知、归档交付物 | SYS-NOTIFY-01、INF-FILE-01,任务与工时 🚧 |
| 项目成员 | 登录、看板与待办、填工时、收消息、传文件 | SYS-AUTH-01、SYS-USER-02 |
| 访客/客户 | App 端登录、查看与自己相关的进度与公告 | SYS-APP-01,会员体系 ⏸ |
| 开发者 | 用代码生成器产骨架、查接口与错误码、按需启用预留模块 | INF-CODEGEN-01、/reference/错误码段 |
3. 与通用低代码平台的区别
这是定位里最容易被误解的一点:PMForge 不是低代码平台,虽然它有一个代码生成器。
| 维度 | 通用低代码平台 | PMForge | 为什么重要 |
|---|---|---|---|
| 产出物 | 运行时解释的表单、流程配置,导出能力有限 | 一次性生成可读的 Java 源码 + SQL + 前端模板,之后归开发者 | 业务复杂到一定程度,一定要能改源码 |
| 多租户 | 常是「字段隔离 + 应用开关」 | 租户 ID 进入 SQL 拦截器、缓存 key、任务上下文,套餐控制可见菜单 | 隔离做不彻底,越晚越难补 |
| 权限 | 页面/按钮级 | 菜单 + 权限点(system:xxx:yyy)+ 数据权限五档 + 超管跨租户 | 同一张表,不同角色能看的行不同 |
| 业务域 | 通用表单引擎,业务靠配置堆 | 不是通用引擎;13 个业务模块可插拔,PM 域在此基础上建模 | 通用能力无法替代领域语义 |
| 可读性 | 平台黑盒,出问题只能提工单 | 模块化 + 15 个 Starter,源码与文档一一对应 | 团队要能接手、能排查 |
| 交付形态 | 多为 SaaS,多服务编排 | 单体 jar(当前),按需拆模块 | 小团队先要跑得起来 |
4. 明确不做什么
- 不做低代码可视化编排器:代码生成是「生成一次、人工接管」,不会在运行时解释页面配置。
- 不做前端:仓库内没有前端代码,只提供接口契约与前端模板;「无前端」是当前最大的缺口,见 路线图。
- 不做订阅计费:支付模块 ⏸ 未参与构建,没有套餐计费闭环;租户套餐目前只控制菜单可见范围。
- 不做通用企业全家桶:CRM/ERP/WMS/MES/IoT/IM/MP/报表 等模块只是预留骨架,不在当前产品承诺内。
- 不承诺开箱即用的 PM 功能:项目管理 6 项仍是 🚧,现阶段需用平台能力「拼」出最小闭环。
5. 成功标准
| 维度 | 目标 | 现状 |
|---|---|---|
| 可构建 | 干净环境一条命令构建通过 | ✅ 21 个模块构建通过 |
| 可运行 | 单 jar 启动,能登录、能开租户 | ✅ 本地 local profile 可启动 |
| 可理解 | 每个已实现功能点有卡、有接口、有表;预留模块有模块卡 | ✅ 40/40 张功能卡 + 13/13 张模块卡、328/328 个接口 |
| 可扩展 | 新增一个业务模块有据可依 | ✅ 代码生成器 + 预留模块说明 |
| PM 域 | 6 个功能点端到端可用 | 🚧 0/6 |
| 前端 | 至少一个可用的管理端 | 🚧 0 |