主题
PMForge 产品需求文档（PRD）— 总纲
文档信息
| 项目 | 内容 |
|---|---|
| 产品名称 | PMForge 项目管理研学平台 |
| 文档版本 | v2.0 |
| 创建日期 | 2026-09-11 |
| 最后更新 | 2026-09-24 |
| 文档状态 | 重写中 |
| 产品负责人 | PM Team |
| 文档性质 | 产品总纲 — 所有子PRD的索引与全局规范 |
一、执行摘要
1.1 我们做什么
PMForge 是一个面向项目管理方向的全功能研学平台。它不是一个单一工具，而是一套可以"按需拼装"的业务能力集合——就像乐高积木一样，每个模块是一块积木，你可以根据实际业务场景自由组合。
平台采用"一个后台 + 一个前台"的双端架构：
- 后台管理端（Admin）：给管理员、运营、客服、财务等内部人员使用，负责系统配置、业务管理、数据分析
- 前台用户端（App）：给最终消费者/员工使用，提供购物、审批、信息查询等面向用户的功能
1.2 为什么做
| 痛点 | PMForge 的解法 |
|---|---|
| 企业数字化系统开发周期长、重复造轮子 | 提供开箱即用的基础模块（用户、权限、组织、字典等），开发者只需关注业务逻辑 |
| 各业务系统之间数据孤岛、无法打通 | 统一架构设计，模块间天然互通（用户体系、支付体系、消息体系全局共享） |
| 项目管理领域的学习缺乏实战载体 | 以真实企业级项目为蓝本，覆盖从CRUD到复杂工作流的全链路场景 |
| SaaS多租户场景下数据隔离复杂 | 内置多租户架构，开箱即用 |
1.3 成功指标
| 指标 | 目标值 | 衡量方式 |
|---|---|---|
| 模块覆盖率 | 9大模块组、38个子PRD全部完成 | 文档完成度 |
| 开发可用性 | 后端开发人员可依据PRD独立完成接口开发 | PRD评审通过率 |
| 前端可用性 | 前端开发人员可依据PRD独立完成页面开发 | 页面还原度 |
| 测试可用性 | QA可依据PRD中的验收标准编写测试用例 | 用例覆盖率 |
二、产品全景
2.1 产品架构图
2.2 模块清单与依赖关系
PMForge 共包含 9大模块组、38个功能子模块。下表说明每个模块"做什么"以及"依赖谁"：
| 模块组 | 子模块数 | 做什么（一句话） | 核心依赖 | 优先级 |
|---|---|---|---|---|
| 系统管理 | 8 | 用户、权限、组织、字典——所有业务模块的"地基" | 无（最底层） | P0 |
| 基础设施 | 5 | 代码生成、文件、任务、配置、监控——开发运维工具箱 | 系统管理 | P0 |
| 工作流 | 4 | 审批流程的发起、流转、审批——让业务"跑起来" | 系统管理 | P1 |
| 支付 | 2 | 收钱、退钱、管钱包——所有涉及钱的模块的底层 | 系统管理 | P1 |
| 会员 | 2 | 管会员、管积分——用户运营的核心 | 系统管理 | P1 |
| 商城 | 4 | 卖东西——商品、交易、营销、统计 | 支付 + 会员 | P2 |
| AI | 5 | 智能化——对话、写作、绘画、音乐、知识库 | 系统管理 | P2 |
| 企业应用 | 5 | 企业级业务——CRM/ERP/WMS/MES/IoT | 系统管理 + 工作流 | P2-P3 |
| 其他 | 2 | IM聊天 + 数据报表 | 系统管理 | P2-P3 |
模块依赖图（简化版）：
给开发者的说明：开发顺序应遵循依赖关系。先完成系统管理 → 基础设施，再逐步向上扩展。每个模块的PRD中会标注它与其他模块的交互点。
2.3 技术选型概览
以下用业务语言解释技术选型的原因，帮助非技术团队成员理解。
| 技术领域 | 选型 | 为什么选它（业务视角） |
|---|---|---|
| 后端框架 | Spring Boot 2.7.18 | Java生态最主流的企业级框架，社区成熟、人才好招、稳定性高 |
| 数据库操作 | MyBatis Plus | 简化数据库操作，支持10种数据库，避免被单一数据库绑定 |
| 工作流引擎 | Flowable 6.8.0 | 开源工作流引擎的行业标杆，支持可视化流程设计 |
| 前端框架 | Vue3 + Element Plus | 国内最主流的前端框架，组件丰富，学习成本低 |
| 移动端 | uni-app | 一套代码多端运行（H5/小程序/App），节省移动端开发成本 |
| 缓存 | Redis + Redisson | 高性能缓存，解决"频繁查数据库导致系统慢"的问题 |
| AI能力 | Spring AI | 统一对接10+家AI模型供应商（OpenAI/通义/文心等），不被单一供应商锁定 |
| 消息队列 | RocketMQ / RabbitMQ / Kafka 三选一 | 处理"高峰期请求排队"问题，按业务规模灵活选择 |
| 数据库 | 支持10种（MySQL为首选） | 不同客户可能用不同数据库，兼容性强 |
三、用户角色定义
3.1 后台管理端角色
| 角色 | 谁是这个角色 | 能做什么 | 不能做什么 |
|---|---|---|---|
| 超级管理员 | 系统最高权限持有者，通常只有1人 | 管理所有租户、分配全局权限、配置系统参数 | 无限制 |
| 租户管理员 | 一个租户（企业/组织）内的最高管理者 | 管理本租户内的用户、角色、业务数据 | 不能跨租户操作、不能修改系统级配置 |
| 部门管理员 | 被授权管理某个部门的管理者 | 查看/管理本部门的人员和数据 | 不能管理其他部门 |
| 运营人员 | 负责内容运营、用户运营的员工 | 管理内容、查看数据报表、发送通知 | 不能修改系统配置、不能管理用户权限 |
| 客服人员 | 负责用户服务的员工 | 处理工单、查看用户信息、处理售后 | 不能删除数据、不能修改商品/订单核心信息 |
| 财务人员 | 负责财务相关工作的员工 | 查看订单、处理退款、导出财务报表 | 不能修改业务数据、不能管理系统 |
名词解释 — RBAC：以上角色体系基于"RBAC（基于角色的访问控制）"模型。简单来说：先把"权限"打包成"角色"，再把"角色"分配给"用户"。这样管理权限时不需要一个个给用户配权限，只需要给用户分配角色即可。
3.2 前台用户端角色
| 角色 | 状态说明 | 能做什么 | 升级条件 |
|---|---|---|---|
| 游客 | 未登录状态 | 浏览公开内容、搜索 | 注册账号 |
| 注册用户 | 已注册但未认证 | 浏览、收藏、使用基础功能 | 完成实名认证 |
| 认证用户 | 已完成实名认证 | 完整功能（购物、下单、支付等） | 购买会员 或 被企业邀请 |
| 会员用户 | 付费会员 | 享受会员专属权益、优惠 | — |
| 企业用户 | 通过企业认证 | 企业采购、发票管理、企业专属功能 | — |
四、全局业务规则
以下规则适用于所有模块，子PRD中不再重复说明。开发人员在实现任何模块时都需要遵守这些规则。
4.1 多租户规则
| 规则 | 说明 | 举例 |
|---|---|---|
| 数据隔离 | 每个租户的数据互相不可见 | 租户A的用户看不到租户B的订单 |
| 租户标识 | 每条业务数据都必须携带 tenant_id | 数据库表中统一包含 tenant_id 字段 |
| 超级管理员例外 | 超级管理员可以查看所有租户的数据 | 超管在后台可以切换租户视角 |
| 租户套餐控制 | 不同租户可开通的功能模块不同 | 基础版租户无法使用AI模块 |
| 独立配置 | 每个租户可以有自己的配置（如支付渠道、邮件服务） | 租户A用微信支付，租户B用支付宝 |
4.2 数据权限规则
| 权限级别 | 含义 | 适用场景 |
|---|---|---|
| 全部数据 | 可以看到系统内所有数据 | 超级管理员 |
| 本部门数据 | 只能看到自己所在部门的数据 | 部门管理员 |
| 本部门及下级 | 可以看到本部门及所有子部门的数据 | 高管 |
| 仅本人数据 | 只能看到自己创建/负责的数据 | 普通员工 |
| 自定义 | 按自定义规则过滤数据 | 特殊业务场景 |
4.3 通用数据规则
| 规则 | 说明 |
|---|---|
| 逻辑删除 | 所有删除操作均为"逻辑删除"（标记 deleted=1），数据不会真正从数据库中移除 |
| 审计字段 | 每条数据自动记录 creator（创建人）、create_time（创建时间）、updater（更新人）、update_time（更新时间） |
| 软删除查询 | 所有查询默认过滤已删除数据，用户无需关心 |
| 分页默认值 | 页码从1开始，每页默认10条，最大100条 |
| 排序默认值 | 默认按创建时间倒序排列（最新创建的排在前面） |
4.4 通用交互规则
| 规则 | 说明 |
|---|---|
| 操作确认 | 删除操作必须二次确认弹窗 |
| 批量操作 | 列表页支持勾选多条进行批量操作（删除、导出等） |
| 表单校验 | 前端实时校验 + 后端二次校验，确保数据合法 |
| 加载状态 | 所有异步操作需展示loading状态，防止重复提交 |
| 错误提示 | 操作失败时展示明确的错误信息，而非笼统的"系统异常" |
| 成功反馈 | 增删改操作成功后展示toast提示 |
| 列表搜索 | 支持"搜索+筛选+排序"组合使用 |
| 导出限制 | 单次导出上限5000条，超出提示分批导出 |
五、产品路线图
| 阶段 | 时间范围 | 核心目标 | 交付物 | 验收标准 |
|---|---|---|---|---|
| Phase 1 — 地基 | 第1-4周 | 完成系统管理 + 基础设施 | 用户/角色/权限/组织/字典/日志/代码生成/文件存储 | 管理员可以登录后台、管理用户和权限、使用代码生成器 |
| Phase 2 — 流程 | 第5-8周 | 完成工作流 + 消息通知 | 流程设计器、审批流程、邮件/短信/站内信 | 可以发起一个请假审批流程并走完整个审批链 |
| Phase 3 — 交易 | 第9-14周 | 完成支付 + 会员 + 商城 | 支付对接、会员体系、商品管理、订单流程 | 用户可以浏览商品→下单→支付→查看订单 |
| Phase 4 — 智能 | 第15-20周 | 完成AI + 企业应用 | AI对话/写作/绘画、CRM、报表 | 用户可以与AI对话、管理客户、查看数据报表 |
六、PRD文档索引
共 9 大模块组、38 个子PRD文件。状态说明：✅ 已完成 | 🔄 重写中 | ⏳ 待重写
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 AI模块（5个文件）
| 序号 | 文档 | 功能 | 优先级 | 状态 |
|---|---|---|---|---|
| 07-01 | AI对话 | 多模型对话、会话管理、消息记录 | P0 | ⏳ |
| 07-02 | AI写作 | AI辅助写作、内容优化、模板 | P1 | ⏳ |
| 07-03 | AI绘画 | 文生图、图生图、图片管理 | P1 | ⏳ |
| 07-04 | AI音乐 | 音乐生成、风格控制 | P2 | ⏳ |
| 07-05 | 知识库 | 文档导入、向量检索、知识问答 | P1 | ⏳ |
6.8 企业应用模块（5个文件）
| 序号 | 文档 | 功能 | 优先级 | 状态 |
|---|---|---|---|---|
| 08-01 | CRM客户管理 | 客户、联系人、商机、跟进记录 | P2 | ⏳ |
| 08-02 | ERP企业资源 | 采购、销售、库存、财务 | P3 | ⏳ |
| 08-03 | WMS仓库管理 | 仓库、入库、出库、盘点 | P3 | ⏳ |
| 08-04 | MES制造执行 | 生产计划、工单、质量、设备 | P3 | ⏳ |
| 08-05 | IoT物联网 | 设备接入、数据采集、规则引擎 | P3 | ⏳ |
6.9 其他模块（2个文件）
| 序号 | 文档 | 功能 | 优先级 | 状态 |
|---|---|---|---|---|
| 09-01 | IM即时通讯 | 单聊、群聊、消息推送、文件传输 | P3 | ⏳ |
| 09-02 | 数据报表 | 数据报表、可视化分析、报表设计器 | P2 | ⏳ |
七、子PRD编写规范
所有子PRD遵循统一的7章结构，确保开发团队在任何模块中都能找到相同位置的信息。
| 章节 | 内容要求 | 面向读者 |
|---|---|---|
| 一、功能概述 | 这个模块解决什么问题、为谁解决、业务价值是什么 | 所有人 |
| 二、用户场景 | 具体的使用场景、用户故事、验收标准（AC） | 产品、QA、前端 |
| 三、功能需求 | 每个功能的详细规则：输入/输出、业务逻辑、状态流转、边界条件 | 后端、前端、QA |
| 四、非功能需求 | 性能指标、安全要求、兼容性要求 | 后端、QA |
| 五、数据设计 | 数据模型、数据字典、关键字段说明 | 后端、QA |
| 六、跨模块联动 | 与其他模块的交互点、数据流向、事件通知 | 后端、产品 |
| 七、附录 | 名词解释、参考资料、变更记录 | 所有人 |
编写要求：
- 业务语言优先：用"当用户XXX时，系统应该XXX"的句式描述逻辑，而非堆砌技术术语
- 验收标准可测量：每个AC必须是可验证的，如"登录接口响应时间 < 500ms"而非"登录要快"
- 覆盖异常场景：不仅描述正常流程，还要描述"如果XXX失败了怎么办"
- 名词首次出现时解释：确保非技术读者也能理解
八、全局名词解释
以下术语在多个子PRD中反复出现，在此统一解释。子PRD中遇到专有术语时会单独解释。
| 术语 | 英文 | 一句话解释 |
|---|---|---|
| 租户 | Tenant | SaaS模式下的"独立客户"。想象一栋写字楼，每个公司就是一个租户，各自独立但共享同一套系统 |
| RBAC | Role-Based Access Control | 基于角色的权限管理。把权限打包成角色，再把角色分配给用户 |
| Token | — | 用户登录后的"通行证"，后续每次请求都带着它来证明身份 |
| JWT | JSON Web Token | Token的一种格式，自带用户信息且不可篡改，无需每次查数据库验证 |
| OAuth2 | Open Authorization 2.0 | 第三方授权协议。比如"用微信登录"就是通过OAuth2实现的 |
| SSO | Single Sign-On | 单点登录。登录一次，所有关联系统都不用再登录 |
| BPMN | Business Process Model and Notation | 业务流程建模标准。工作流设计器中画的那些流程图就遵循这个标准 |
| SPU | Standard Product Unit | 标准产品单位。比如"iPhone 15"就是一个SPU |
| SKU | Stock Keeping Unit | 库存单位。比如"iPhone 15 黑色 256G"就是一个SKU |
| CRM | Customer Relationship Management | 客户关系管理系统。管理客户信息、销售机会、跟进记录 |
| ERP | Enterprise Resource Planning | 企业资源计划。管理采购、销售、库存、财务的企业核心系统 |
| WMS | Warehouse Management System | 仓库管理系统。管理仓库的入库、出库、盘点 |
| MES | Manufacturing Execution System | 制造执行系统。管理生产计划、工单、质量 |
| IoT | Internet of Things | 物联网。让设备（传感器、机器）联网并采集数据 |
| IM | Instant Messaging | 即时通讯。就是聊天功能 |
| 逻辑删除 | Soft Delete | 不真正删除数据，而是标记为"已删除"。数据还在，只是查不到 |
九、版本记录
| 版本 | 日期 | 修改内容 | 修改人 |
|---|---|---|---|
| v1.0 | 2026-09-11 | 初始版本，完成整体规划 | PM Team |
| v2.0 | 2026-09-19 | 全面重写：增强业务场景、验收标准、跨模块联动、名词解释 | PM Team |
本文档为PMForge产品总纲PRD，各功能模块详细需求请参见对应子文档。