Skip to content

PMForge 产品需求文档(PRD)— 总纲 ​

文档信息 ​

项目内容
文档编号PRD-00
文档名称产品概述(总纲)
产品名称PMForge 项目管理平台
所属模块product
文档版本v2.1
最后更新2026-11-17
文档状态已定稿
实施状态预留(代码在库,已通过编译验证,未接入运行时)
优先级P0

1. 执行摘要 ​

1.1 我们做什么 ​

PMForge 是一个面向项目管理方向的企业级平台。它不是一个单一工具,而是一套可以"按需拼装"的业务能力集合——就像乐高积木一样,每个模块是一块积木,你可以根据实际业务场景自由组合。

平台采用"一个后台 + 一个前台"的双端架构:

  • 后台管理端(Admin):给管理员、运营、客服、财务等内部人员使用,负责系统配置、业务管理、数据分析
  • 前台用户端(App):给最终消费者/员工使用,提供购物、审批、信息查询等面向用户的功能

1.2 为什么做 ​

痛点PMForge 的解法
企业数字化系统开发周期长、重复造轮子提供开箱即用的基础模块(用户、权限、组织、字典等),开发者只需关注业务逻辑
各业务系统之间数据孤岛、无法打通统一架构设计,模块间天然互通(用户体系、支付体系、消息体系全局共享)
项目管理领域的学习缺乏实战载体以真实企业级项目为蓝本,覆盖从CRUD到复杂工作流的全链路场景
SaaS多租户场景下数据隔离复杂内置多租户架构,开箱即用

1.3 成功指标 ​

指标目标值衡量方式
模块覆盖率9 大模块组、34 个子 PRD 全部完成文档完成度
开发可用性后端开发人员可依据PRD独立完成接口开发PRD评审通过率
前端可用性前端开发人员可依据PRD独立完成页面开发页面还原度
测试可用性QA可依据PRD中的验收标准编写测试用例用例覆盖率

2. 产品全景 ​

2.1 产品架构 ​

text
前台用户端(App / H5 / 小程序)      后台管理端(Admin)
            ↓                           ↓
         统一 API 网关(鉴权 / 限流 / 加密)
                        ↓
业务功能层:系统管理 | 基础设施 | 工作流 | 支付 | 会员 | 商城 | 企业应用 | IM | 报表
                        ↓
数据与中间件层:MySQL / Redis / MQ / 对象存储 / 搜索

2.2 模块清单与依赖关系 ​

PMForge 共包含 9 大模块组、34 个子 PRD。下表说明每个模块"做什么"以及"依赖谁":

模块组子模块数做什么(一句话)核心依赖优先级
系统管理8用户、权限、组织、字典——所有业务模块的"地基"无(最底层)P0
基础设施5代码生成、文件、任务、配置、监控——开发运维工具箱系统管理P0
工作流4审批流程的发起、流转、审批——让业务"跑起来"系统管理P1
支付2收钱、退钱、管钱包——所有涉及钱的模块的底层系统管理P1
会员2管会员、管积分——用户运营的核心系统管理P1
商城4卖东西——商品、交易、营销、统计支付 + 会员P2
企业应用5企业级业务——CRM/ERP/WMS/MES/IoT系统管理 + 工作流P2-P3
其他2IM聊天 + 数据报表系统管理P2-P3
微信生态1公众号账号、菜单、素材、草稿发布、自动回复、粉丝与模板消息系统管理 + 基础设施P1

模块依赖图(简化版):

text
系统管理(用户 / 权限 / 组织 / 租户)
   ├── 基础设施(代码生成 / 文件 / 任务 / 配置 / 日志)
   ├── 工作流(Flowable)← 支付 / 会员 / 企业应用
   ├── 支付 ← 会员 / 商城
   ├── 微信生态(公众号运营:账号 / 菜单 / 素材 / 发布 / 粉丝)
   └── IM / 报表(依赖系统管理)

给开发者的说明:开发顺序应遵循依赖关系。先完成系统管理 → 基础设施,再逐步向上扩展。每个模块的PRD中会标注它与其他模块的交互点。

2.3 技术选型概览 ​

以下用业务语言解释技术选型的原因,帮助非技术团队成员理解。

技术领域选型为什么选它(业务视角)
后端框架Spring Boot 2.7.18Java生态最主流的企业级框架,社区成熟、人才好招、稳定性高
数据库操作MyBatis Plus简化数据库操作,支持10种数据库,避免被单一数据库绑定
工作流引擎Flowable 6.8.0开源工作流引擎的行业标杆,支持可视化流程设计
前端框架Vue3 + Element Plus国内最主流的前端框架,组件丰富,学习成本低
移动端uni-app一套代码多端运行(H5/小程序/App),节省移动端开发成本
缓存Redis + Redisson高性能缓存,解决"频繁查数据库导致系统慢"的问题
消息队列RocketMQ / RabbitMQ / Kafka 三选一处理"高峰期请求排队"问题,按业务规模灵活选择
数据库支持10种(MySQL为首选)不同客户可能用不同数据库,兼容性强

2.4 实施现状(截至 2026-11) ​

模块组代码构建备注
系统管理pmforge-module-system✅24 个功能点后端完成
基础设施pmforge-module-infra✅16 个功能点后端完成
工作流、支付、会员、商城、企业应用、IM、报表、微信生态对应 pmforge-module-*(12 个已纳入构建)⏳代码在库,已编译,未接入运行时
PM 业务域(项目/任务/工时/风险)待新建🚧下一阶段核心增量

3. 用户角色定义 ​

3.1 后台管理端角色 ​

角色谁是这个角色能做什么不能做什么
超级管理员系统最高权限持有者,通常只有1人管理所有租户、分配全局权限、配置系统参数无限制
租户管理员一个租户(企业/组织)内的最高管理者管理本租户内的用户、角色、业务数据不能跨租户操作、不能修改系统级配置
部门管理员被授权管理某个部门的管理者查看/管理本部门的人员和数据不能管理其他部门
运营人员负责内容运营、用户运营的员工管理内容、查看数据报表、发送通知不能修改系统配置、不能管理用户权限
客服人员负责用户服务的员工处理工单、查看用户信息、处理售后不能删除数据、不能修改商品/订单核心信息
财务人员负责财务相关工作的员工查看订单、处理退款、导出财务报表不能修改业务数据、不能管理系统

名词解释 — RBAC:以上角色体系基于"RBAC(基于角色的访问控制)"模型。简单来说:先把"权限"打包成"角色",再把"角色"分配给"用户"。这样管理权限时不需要一个个给用户配权限,只需要给用户分配角色即可。

3.2 前台用户端角色 ​

角色状态说明能做什么升级条件
游客未登录状态浏览公开内容、搜索注册账号
注册用户已注册但未认证浏览、收藏、使用基础功能完成实名认证
认证用户已完成实名认证完整功能(购物、下单、支付等)购买会员 或 被企业邀请
会员用户付费会员享受会员专属权益、优惠—
企业用户通过企业认证企业采购、发票管理、企业专属功能—

4. 全局业务规则 ​

以下规则适用于所有模块,子PRD中不再重复说明。开发人员在实现任何模块时都需要遵守这些规则。

4.1 多租户规则 ​

规则说明举例
数据隔离每个租户的数据互相不可见租户A的用户看不到租户B的订单
租户标识每条业务数据都必须携带 tenant_id数据库表中统一包含 tenant_id 字段
超级管理员例外超级管理员可以查看所有租户的数据超管在后台可以切换租户视角
租户套餐控制不同租户可开通的功能模块不同基础版租户无法使用商城模块
独立配置每个租户可以有自己的配置(如支付渠道、邮件服务)租户A用微信支付,租户B用支付宝

4.2 数据权限规则 ​

权限级别含义适用场景
全部数据可以看到系统内所有数据超级管理员
本部门数据只能看到自己所在部门的数据部门管理员
本部门及下级可以看到本部门及所有子部门的数据高管
仅本人数据只能看到自己创建/负责的数据普通员工
自定义按自定义规则过滤数据特殊业务场景

4.3 通用数据规则 ​

规则说明
逻辑删除所有删除操作均为"逻辑删除"(标记 deleted=1),数据不会真正从数据库中移除
审计字段每条数据自动记录 creator(创建人)、create_time(创建时间)、updater(更新人)、update_time(更新时间)
软删除查询所有查询默认过滤已删除数据,用户无需关心
分页默认值页码从1开始,每页默认10条,最大100条
排序默认值默认按创建时间倒序排列(最新创建的排在前面)

4.4 通用交互规则 ​

规则说明
操作确认删除操作必须二次确认弹窗
批量操作列表页支持勾选多条进行批量操作(删除、导出等)
表单校验前端实时校验 + 后端二次校验,确保数据合法
加载状态所有异步操作需展示loading状态,防止重复提交
错误提示操作失败时展示明确的错误信息,而非笼统的"系统异常"
成功反馈增删改操作成功后展示toast提示
列表搜索支持"搜索+筛选+排序"组合使用
导出限制单次导出上限5000条,超出提示分批导出

5. 产品路线图 ​

阶段时间范围核心目标交付物验收标准
Phase 1 — 地基第1-4周完成系统管理 + 基础设施用户/角色/权限/组织/字典/日志/代码生成/文件存储管理员可以登录后台、管理用户和权限、使用代码生成器
Phase 2 — 流程第5-8周完成工作流 + 消息通知流程设计器、审批流程、邮件/短信/站内信可以发起一个请假审批流程并走完整个审批链
Phase 3 — 交易第9-14周完成支付 + 会员 + 商城支付对接、会员体系、商品管理、订单流程用户可以浏览商品→下单→支付→查看订单
Phase 4 — 企业应用第15-20周完成企业应用CRM、ERP、报表用户可以管理客户、查看数据报表

6. PRD文档索引 ​

共 9 大模块组、34 个子 PRD。状态说明:✅ 已实现并接入 server(第 01/02 组)| ⏳ 代码在库、已编译、未接入运行时 | 🚧 规划中

质量分级(每篇 PRD 顶部标注,由代码对齐度自动计算):A 级可直接作为需求基线与验收依据;B 级可读可用,接口以代码为准;C 级仅表达设计意图,不能作为实现说明。每篇文末的「代码对齐(自动生成)」章节给出接口命中率、真实控制器清单与未命中接口的对应建议。

6.1 系统管理模块(8个文件) ​

序号文档功能优先级状态
01-01认证授权登录、注册、Token管理、OAuth2、社交登录P0✅
01-02用户管理用户CRUD、个人中心、导入导出P0✅
01-03角色权限角色管理、菜单管理、数据权限P0✅
01-04组织架构部门管理、岗位管理P0✅
01-05租户管理租户管理、租户套餐P0✅
01-06数据字典字典类型、字典数据P0✅
01-07消息通知邮件、短信、站内信、系统公告P1✅
01-08日志审计登录日志、操作日志P1✅

6.2 基础设施模块(5个文件) ​

序号文档功能优先级状态
02-01代码生成数据库表→前后端代码一键生成P0✅
02-02文件存储文件上传/下载、多存储渠道P0✅
02-03定时任务定时任务管理、调度日志P1✅
02-04配置管理系统参数配置、数据源管理P1✅
02-05监控运维API访问日志、服务器监控、缓存监控P1✅

6.3 工作流模块(4个文件) ​

序号文档功能优先级状态
03-01流程设计BPMN可视化流程设计器P0⏳
03-02流程管理流程定义、部署、分类管理P0⏳
03-03我的流程发起流程、查看进度、撤回P0⏳
03-04待办管理待办列表、审批操作、已办查询P0⏳

6.4 支付模块(2个文件) ​

序号文档功能优先级状态
04-01应用管理支付应用、渠道配置、支付订单、退款P0⏳
04-02钱包管理用户钱包、余额管理、交易流水P1⏳

6.5 会员模块(2个文件) ​

序号文档功能优先级状态
05-01会员管理会员列表、等级体系、标签管理P0⏳
05-02会员积分积分规则、积分记录、签到P1⏳

6.6 商城模块(4个文件) ​

序号文档功能优先级状态
06-01商品管理分类、品牌、属性、商品SPU/SKU、评价P0⏳
06-02交易管理购物车、订单流程、售后退款P0⏳
06-03营销管理优惠券、满减、秒杀、拼团、砍价P1⏳
06-04统计分析交易统计、会员分析、商品分析P1⏳

6.7 企业应用模块(5个文件) ​

序号文档功能优先级状态
08-01CRM客户管理客户、联系人、商机、跟进记录P2⏳
08-02ERP企业资源采购、销售、库存、财务P3⏳
08-03WMS仓库管理仓库、入库、出库、盘点P3⏳
08-04MES制造执行生产计划、工单、质量、设备P3⏳
08-05IoT物联网设备接入、数据采集、规则引擎P3⏳

6.8 其他模块(2个文件) ​

序号文档功能优先级状态
09-01IM即时通讯单聊、群聊、消息推送、文件传输P3⏳
09-02数据报表数据报表、可视化分析、报表设计器P2⏳

6.9 微信生态模块(1个文件) ​

序号文档功能优先级状态
10-01公众号管理公众号账号、自定义菜单、素材、草稿与发布、自动回复、粉丝消息、模板消息、粉丝与标签、运营数据P1⏳

7. 子PRD编写规范 ​

所有子PRD遵循统一的7章结构,确保开发团队在任何模块中都能找到相同位置的信息。

章节内容要求面向读者
一、功能概述这个模块解决什么问题、为谁解决、业务价值是什么所有人
二、用户场景具体的使用场景、用户故事、验收标准(AC)产品、QA、前端
三、功能需求每个功能的详细规则:输入/输出、业务逻辑、状态流转、边界条件后端、前端、QA
四、非功能需求性能指标、安全要求、兼容性要求后端、QA
五、数据设计数据模型、数据字典、关键字段说明后端、QA
六、跨模块联动与其他模块的交互点、数据流向、事件通知后端、产品
七、附录名词解释、参考资料、变更记录所有人

编写要求:

  1. 业务语言优先:用"当用户XXX时,系统应该XXX"的句式描述逻辑,而非堆砌技术术语
  2. 验收标准可测量:每个AC必须是可验证的,如"登录接口响应时间 < 500ms"而非"登录要快"
  3. 覆盖异常场景:不仅描述正常流程,还要描述"如果XXX失败了怎么办"
  4. 名词首次出现时解释:确保非技术读者也能理解
  5. 接口标注真实路径:写 /admin-api/... 时必须来自代码;未实现的写成「规划」并单独成段
  6. 文末必须有「代码对齐」章节:由 npm run prd:align 生成,手工编辑会被覆盖;新增 PRD 后要重跑
  7. 状态与质量必须一致:实施状态 三态(已实现 / 预留-已编译 / 不构建)与质量分级(A/B/C)不得互相矛盾

8. 全局名词解释 ​

以下术语在多个子PRD中反复出现,在此统一解释。子PRD中遇到专有术语时会单独解释。

术语英文一句话解释
租户TenantSaaS模式下的"独立客户"。想象一栋写字楼,每个公司就是一个租户,各自独立但共享同一套系统
RBACRole-Based Access Control基于角色的权限管理。把权限打包成角色,再把角色分配给用户
Token—用户登录后的"通行证",后续每次请求都带着它来证明身份
JWTJSON Web TokenToken的一种格式,自带用户信息且不可篡改,无需每次查数据库验证
OAuth2Open Authorization 2.0第三方授权协议。比如"用微信登录"就是通过OAuth2实现的
SSOSingle Sign-On单点登录。登录一次,所有关联系统都不用再登录
BPMNBusiness Process Model and Notation业务流程建模标准。工作流设计器中画的那些流程图就遵循这个标准
SPUStandard Product Unit标准产品单位。比如"iPhone 15"就是一个SPU
SKUStock Keeping Unit库存单位。比如"iPhone 15 黑色 256G"就是一个SKU
CRMCustomer Relationship Management客户关系管理系统。管理客户信息、销售机会、跟进记录
ERPEnterprise Resource Planning企业资源计划。管理采购、销售、库存、财务的企业核心系统
WMSWarehouse Management System仓库管理系统。管理仓库的入库、出库、盘点
MESManufacturing Execution System制造执行系统。管理生产计划、工单、质量
IoTInternet of Things物联网。让设备(传感器、机器)联网并采集数据
IMInstant Messaging即时通讯。就是聊天功能
逻辑删除Soft Delete不真正删除数据,而是标记为"已删除"。数据还在,只是查不到

9. 版本记录 ​

版本日期修改内容修改人
v1.02026-09-11初始版本,完成整体规划PM Team
v2.02026-09-19全面重写:增强业务场景、验收标准、跨模块联动、名词解释PM Team
v2.12026-11-17更新实施现状、模块状态口径;移除示意图,改为文本架构图PM Team
v2.22026-11-18基准化:12 个模块的接口/权限/表与代码逐项对齐,新增「代码对齐」章节与质量分级 A/B/CPM Team
v2.32026-11-18新增微信生态模块(10-01 公众号管理),PRD 总数 38→39,补齐模块清单与编写规范第 5–7 条PM Team

本文档为PMForge产品总纲PRD,各功能模块详细需求请参见对应子文档。