|
|
@@ -1,322 +1,319 @@
|
|
|
-# D8D Starter 产品需求文档 (PRD)
|
|
|
+# 集团管理多公司AI智能进销存应用系统 Product Requirements Document (PRD)
|
|
|
|
|
|
## 版本信息
|
|
|
| 版本 | 日期 | 描述 | 作者 |
|
|
|
|------|------|------|------|
|
|
|
-| 1.0 | 2024-09-14 | 初始PRD版本 | John (PM) |
|
|
|
-| 1.1 | 2025-09-17 | 更新Epic结构和指标,与实际epic对齐 | Sarah (PO) |
|
|
|
-| 1.2 | 2025-09-19 | 在Epic 001中集成数据库备份功能 | Winston |
|
|
|
-
|
|
|
-## 1. 项目介绍和分析
|
|
|
-
|
|
|
-### 1.1 现有项目概览
|
|
|
-
|
|
|
-**分析来源**: 基于现有架构文档 `docs/brownfield-architecture.md`
|
|
|
-
|
|
|
-**当前项目状态**: D8D Starter 是一个现代化的全栈Web应用启动模板,提供:
|
|
|
-- 🚀 **快速开发基础**: Node.js + React 技术栈
|
|
|
-- 🔐 **身份认证系统**: JWT-based 用户认证
|
|
|
-- 👥 **用户管理**: 完整的用户和角色管理功能
|
|
|
-- 📊 **数据库集成**: TypeORM + PostgreSQL 数据持久化
|
|
|
-- 🎨 **现代化UI**: React 19 + Tailwind CSS 界面
|
|
|
-
|
|
|
-### 1.2 可用文档分析
|
|
|
-
|
|
|
-✅ **技术文档完整**:
|
|
|
-- 技术栈和版本信息
|
|
|
-- 源码结构和模块组织
|
|
|
-- 数据模型和API规范
|
|
|
-- 技术债务和已知问题
|
|
|
-- 开发和部署指南
|
|
|
-
|
|
|
-⚠️ **需要补充的业务文档**:
|
|
|
-- 产品愿景和目标
|
|
|
-- 用户需求和场景
|
|
|
-- 功能优先级
|
|
|
-- 业务指标
|
|
|
-
|
|
|
-### 1.3 增强范围定义
|
|
|
-
|
|
|
-**项目类型**: 现有项目功能完善和业务需求文档化
|
|
|
-
|
|
|
-**主要目标**:
|
|
|
-1. 将现有技术实现与业务需求对齐
|
|
|
-2. 定义清晰的产品方向和成功标准
|
|
|
-3. 为未来功能扩展建立需求基线
|
|
|
-
|
|
|
-### 1.4 目标和背景
|
|
|
-
|
|
|
-#### 业务目标
|
|
|
-- 📈 **确立产品市场定位**: 明确D8D Starter的目标用户和使用场景
|
|
|
-- 🎯 **定义成功指标**: 建立可衡量的产品成功标准
|
|
|
-- 🔄 **建立迭代流程**: 为持续改进提供需求框架
|
|
|
-- 🤝 **促进团队对齐**: 确保技术实现与业务目标一致
|
|
|
-
|
|
|
-#### 技术背景
|
|
|
-D8D Starter已经具备优秀的技术基础:
|
|
|
-- 现代化的全栈技术架构
|
|
|
-- 模块化的代码组织
|
|
|
-- 完整的认证和用户管理系统
|
|
|
-- 生产就绪的部署配置
|
|
|
-
|
|
|
-现在需要将技术能力转化为明确的业务价值主张。
|
|
|
-
|
|
|
-## 2. 需求定义
|
|
|
-
|
|
|
-### 2.1 功能需求
|
|
|
-
|
|
|
-基于现有技术实现,我定义了以下功能需求。请仔细审核这些需求是否准确反映了项目的业务目标:
|
|
|
-
|
|
|
-**FR1: 用户认证和管理系统**
|
|
|
-- 必须提供完整的用户注册、登录、密码重置功能
|
|
|
-- 支持基于JWT的安全认证机制
|
|
|
-- 用户信息需要持久化存储到PostgreSQL数据库
|
|
|
-- 提供用户角色和权限管理基础框架
|
|
|
-
|
|
|
-**FR2: 现代化前端界面**
|
|
|
-- 使用React 19构建响应式用户界面
|
|
|
-- 采用Tailwind CSS确保一致的视觉设计
|
|
|
-- 提供管理后台和用户主页两种界面模式
|
|
|
-- 支持组件化开发和代码复用
|
|
|
-
|
|
|
-**FR3: 类型安全的API架构**
|
|
|
-- 使用Hono RPC (hc) 提供前后端统一的类型安全
|
|
|
-- 集成@hono/zod-openapi自动生成OpenAPI文档
|
|
|
-- 使用@hono/swagger-ui提供交互式API文档界面
|
|
|
-- 实现通用的CRUD路由和服务,避免每个实体重复编写
|
|
|
-- **支持关联查询和复杂数据关系处理**
|
|
|
-- 前后端共享Zod schema,确保表单验证一致性
|
|
|
-
|
|
|
-**FR4: 数据库集成和ORM**
|
|
|
-- 使用TypeORM进行数据库操作抽象
|
|
|
-- 支持PostgreSQL数据库连接和连接池管理
|
|
|
-- 提供数据模型定义和迁移能力
|
|
|
-- 实现基础的数据验证和约束
|
|
|
-
|
|
|
-**FR5: 开发和生产环境支持**
|
|
|
-- 提供Vite开发服务器支持热重载
|
|
|
-- 支持生产环境构建和优化
|
|
|
-- 集成Docker Compose用于本地开发环境
|
|
|
-- 提供环境变量配置管理
|
|
|
-
|
|
|
-### 详细 rationale (决策依据):
|
|
|
-
|
|
|
-这些需求基于对现有代码的深入分析:
|
|
|
-- **技术选择权衡**: 选择了Hono而不是Express,主要因为Hono RPC提供前后端类型安全
|
|
|
-- **架构决策**: 采用shadcn管理后台模板,专注于提供高质量的管理界面组件
|
|
|
-- **API设计**: 使用@hono/zod-openapi实现自动API文档生成和类型安全
|
|
|
-- **开发效率**: 通用CRUD路由和服务大幅减少重复代码编写
|
|
|
-- **数据验证**: 前后端共享Zod schema确保验证逻辑一致性
|
|
|
-
|
|
|
-**关键假设**:
|
|
|
-- 目标用户是需要快速构建管理后台的全栈开发者
|
|
|
-- 主要使用场景是创建企业级管理界面和CRUD操作
|
|
|
-- 开发体验和类型安全是核心价值主张
|
|
|
-- 需要提供生产就绪的认证和权限管理
|
|
|
-
|
|
|
-**需要验证的领域**:
|
|
|
-- 这些功能需求是否覆盖了所有重要的业务场景?
|
|
|
-- 是否有遗漏的关键功能?
|
|
|
-- 优先级排序是否合理?
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-### 2.2 非功能性需求
|
|
|
-
|
|
|
-**NFR1: 类型安全和开发体验**
|
|
|
-- 必须提供端到端的类型安全,减少运行时错误
|
|
|
-- 开发环境需要支持热重载和快速迭代
|
|
|
-- 代码提示和自动完成需要完整支持
|
|
|
-- 构建过程应该快速且可靠
|
|
|
-
|
|
|
-**NFR2: 代码质量和可维护性**
|
|
|
-- 遵循一致的代码风格和架构模式
|
|
|
-- 提供清晰的模块边界和接口定义
|
|
|
-- 支持代码复用和组件化开发
|
|
|
-- 文档需要保持与代码同步
|
|
|
-- 通用CRUD路由和服务必须支持自定义路由和服务的扩展
|
|
|
-- **关联查询功能需要保持性能和可维护性**
|
|
|
-
|
|
|
-**NFR3: 安全性和认证**
|
|
|
-- 实现基于JWT的安全认证机制
|
|
|
-- 提供角色基础的权限控制(RBAC)
|
|
|
-- 输入验证必须使用Zod schema
|
|
|
-- 防止常见Web安全漏洞(XSS, CSRF等)
|
|
|
-
|
|
|
-**NFR4: 性能和可扩展性**
|
|
|
-- API响应时间应该在100ms以内
|
|
|
-- 支持数据库连接池和性能优化
|
|
|
-- 前端打包需要优化加载性能
|
|
|
-- 架构应该支持水平扩展
|
|
|
-
|
|
|
-**NFR5: 文档和开发者体验**
|
|
|
-- 自动生成完整的API文档
|
|
|
-- 提供清晰的使用示例和教程
|
|
|
-- 错误信息应该具有指导性
|
|
|
-- 配置过程应该简单直观
|
|
|
-
|
|
|
-### 详细 rationale (决策依据):
|
|
|
-
|
|
|
-这些非功能性需求反映了项目的核心价值主张:
|
|
|
-- **类型安全优先**: 选择Hono RPC和Zod是为了最大化开发效率和减少错误
|
|
|
-- **开发者体验**: shadcn模板和通用CRUD服务专注于提升开发速度
|
|
|
-- **扩展性设计**: 通用CRUD服务支持自定义路由和服务扩展,平衡便利性和灵活性
|
|
|
-- **生产就绪**: 包含认证、权限、安全等企业级功能
|
|
|
-- **文档自动化**: @hono/zod-openapi确保文档与代码同步
|
|
|
-
|
|
|
-**技术约束**:
|
|
|
-- 必须保持与现有shadcn设计系统的兼容性
|
|
|
-- 需要支持PostgreSQL关系型数据库
|
|
|
-- 前端构建基于Vite,后端基于Hono
|
|
|
-- 部署环境支持Docker容器化
|
|
|
-
|
|
|
-### 3.2 集成策略
|
|
|
-
|
|
|
-**数据库集成策略**:
|
|
|
-- 使用TypeORM实体定义数据模型
|
|
|
-- **支持复杂的关联查询和关系映射**
|
|
|
-- 支持数据库迁移和版本控制
|
|
|
-- 实现连接池管理优化性能
|
|
|
-- 提供事务支持和数据一致性保证
|
|
|
-
|
|
|
-**API集成策略**:
|
|
|
-- RESTful API设计遵循OpenAPI规范
|
|
|
-- Hono RPC确保前后端类型安全
|
|
|
-- 统一的错误处理和响应格式
|
|
|
-- 支持API版本管理(v1前缀)
|
|
|
-- **通用CRUD服务支持关联查询参数**
|
|
|
-
|
|
|
-**前端集成策略**:
|
|
|
-- shadcn UI组件库提供一致的设计语言
|
|
|
-- React Query管理服务端状态
|
|
|
-- 基于Zod的表单验证和类型安全
|
|
|
-- 响应式设计支持多种设备
|
|
|
-- **关联数据的高效渲染和处理**
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-## 5. Epic和故事结构
|
|
|
-
|
|
|
-### 5.1 Epic方法
|
|
|
-
|
|
|
-**Epic结构决策**: 多Epic并行结构 - 针对不同关注点分别优化
|
|
|
-
|
|
|
-**决策依据**:
|
|
|
-- 项目已经具备完整的技术基础架构
|
|
|
-- 不同功能领域有明确的优化目标和优先级
|
|
|
-- 独立Epic便于并行开发和专门团队负责
|
|
|
-- 每个Epic有明确的成功标准和验收指标
|
|
|
-
|
|
|
-### 5.2 Epic详情
|
|
|
-
|
|
|
-**Epic 001: 测试基础设施搭建**
|
|
|
-**Epic目标**: 为现有项目建立完整的测试基础设施,包括单元测试、集成测试和端到端测试,确保代码质量和可维护性。
|
|
|
-**成功标准**: 测试覆盖率达标(单元测试 > 70%, 集成测试 > 50%),CI/CD流水线集成测试执行正常,数据库备份恢复机制完善
|
|
|
-
|
|
|
-**Epic 002: 用户管理界面现代化增强**
|
|
|
-**Epic目标**: 优化现有用户管理界面的用户体验和功能完整性,使其更符合现代Web应用标准。
|
|
|
-**成功标准**: 用户管理操作效率提升30%,界面响应时间保持在200ms以内
|
|
|
-
|
|
|
-**Epic 003: Lint配置集成**
|
|
|
-**Epic目标**: 集成完整的ESLint代码质量检查配置,确保代码风格一致性和质量规范。
|
|
|
-**成功标准**: ESLint配置能够正确检查所有.ts和.tsx文件,修复现有代码中的lint错误
|
|
|
-
|
|
|
-**Epic 004: API实际请求测试增强**
|
|
|
-**Epic目标**: 为现有API系统添加实际HTTP请求测试,验证系统在真实数据库环境下的行为。
|
|
|
-**成功标准**: 所有核心API端点都有实际请求测试,测试通过率100%
|
|
|
-
|
|
|
-### 5.3 各Epic用户故事概览
|
|
|
-
|
|
|
-**Epic 001 - 测试基础设施**:
|
|
|
-- 基础单元测试框架搭建
|
|
|
-- 集成测试环境配置
|
|
|
-- 端到端测试流水线
|
|
|
-- 数据库备份和恢复工具集成
|
|
|
-
|
|
|
-**Epic 002 - 用户管理增强**:
|
|
|
-- 用户搜索和过滤功能
|
|
|
-- 批量操作支持
|
|
|
-- 用户详情页优化
|
|
|
-
|
|
|
-**Epic 003 - Lint配置**:
|
|
|
-- ESLint基础框架配置
|
|
|
-- Prettier和代码格式化集成
|
|
|
-- 开发工作流集成和问题修复
|
|
|
-
|
|
|
-**Epic 004 - API实际测试**:
|
|
|
-- 实际请求测试基础设施
|
|
|
-- 用户API实际请求测试实现
|
|
|
-- CI/CD流水线集成
|
|
|
-
|
|
|
-## 6. 成功指标和验收标准
|
|
|
-
|
|
|
-### 6.1 关键绩效指标(KPI)
|
|
|
-
|
|
|
-**Epic 001 - 测试基础设施指标**:
|
|
|
-- ✅ 单元测试覆盖率 > 70%
|
|
|
-- ✅ 集成测试覆盖率 > 50%
|
|
|
-- ✅ CI/CD测试流水线执行成功率 100%
|
|
|
-- ⏱️ 测试执行时间优化在可接受范围内
|
|
|
-- 💾 数据库备份恢复测试通过率 100%
|
|
|
-
|
|
|
-**Epic 002 - 用户管理增强指标**:
|
|
|
-- ⚡ 用户管理操作效率提升 30%
|
|
|
-- ⏱️ 界面响应时间 < 200ms (p95)
|
|
|
-- 📊 用户搜索和过滤功能使用率 > 80%
|
|
|
-- 👍 用户满意度评分 > 4/5
|
|
|
-
|
|
|
-**Epic 003 - Lint配置指标**:
|
|
|
-- ✅ ESLint错误修复率 100%
|
|
|
-- 🔧 代码风格一致性达到 95%
|
|
|
-- 📝 开发工作流集成完成度 100%
|
|
|
-- 🚀 开发效率提升(减少代码审查时间)
|
|
|
-
|
|
|
-**Epic 004 - API实际测试指标**:
|
|
|
-- ✅ 核心API端点测试覆盖率 100%
|
|
|
-- ✅ 实际请求测试通过率 100%
|
|
|
-- 🐛 生产环境缺陷减少 50%
|
|
|
-- 🔄 测试数据管理自动化程度 100%
|
|
|
-
|
|
|
-**总体项目指标**:
|
|
|
-- 📚 文档完整性:API文档覆盖率达到100%
|
|
|
-- 🚀 项目使用率:内部项目采用率>60%
|
|
|
-- 📈 功能完成度:PRD需求实现率100%
|
|
|
-
|
|
|
-### 6.2 验收标准
|
|
|
-
|
|
|
-**项目级验收**:
|
|
|
-- 所有功能需求和非功能需求实现
|
|
|
-- 文档完整且与代码同步
|
|
|
-- 测试覆盖率达到目标
|
|
|
-- 性能指标满足要求
|
|
|
-- 安全审计通过
|
|
|
-
|
|
|
-**阶段性验收**:
|
|
|
-- 每个用户故事完成后进行代码审查
|
|
|
-- 每周演示进度和获取反馈
|
|
|
-- 每月进行整体质量评估
|
|
|
-
|
|
|
-## 7. 附录
|
|
|
-
|
|
|
-### 7.1 参考资料
|
|
|
-- 现有架构文档: `docs/brownfield-architecture.md`
|
|
|
-- Hono框架文档: https://hono.dev
|
|
|
-- Zod验证库: https://zod.dev
|
|
|
-- shadcn/ui组件库: https://ui.shadcn.com
|
|
|
-
|
|
|
-### 7.2 相关文档
|
|
|
-- API文档: 通过 `/ui` 端点访问
|
|
|
-- 开发指南: `docs/development.md`
|
|
|
-- 部署指南: `docs/deployment.md`
|
|
|
-- 贡献指南: `docs/contributing.md`
|
|
|
-
|
|
|
-### 7.3 联系方式
|
|
|
-- 产品负责人: [待指定]
|
|
|
-- 技术负责人: [待指定]
|
|
|
-- 开发团队: [待指定]
|
|
|
+| 1.0 | 2025-10-20 | 基于项目简报创建集团AI智能进销存系统PRD | John (PM) |
|
|
|
+
|
|
|
+## 1. Goals and Background Context
|
|
|
+
|
|
|
+### 1.1 Goals
|
|
|
+- 基于D8D Starter快速构建集团统一的供应链管理平台
|
|
|
+- 通过AI技术实现智能化决策支持
|
|
|
+- 降低人工操作成本30%以上
|
|
|
+- 提升库存周转率15-20%
|
|
|
+- 验证D8D Starter在复杂业务系统中的适用性
|
|
|
+
|
|
|
+### 1.2 Background Context
|
|
|
+集团化企业在供应链管理方面面临数据孤岛、决策滞后、协同效率低下等挑战。基于D8D Starter成熟的全栈技术基础,我们可以快速构建一个支持母子公司架构的智能进销存系统,通过AI技术实现销售预测、库存优化、供应商匹配等智能决策功能,显著提升供应链管理效率。
|
|
|
+
|
|
|
+## 2. Requirements
|
|
|
+
|
|
|
+### 2.1 Functional
|
|
|
+1. **FR1: 组织架构管理**
|
|
|
+ - 基于现有用户系统的母子公司树形层级管理
|
|
|
+ - 数据访问权限隔离与穿透(扩展现有RBAC)
|
|
|
+ - 跨公司业务支持(调拨、内部交易)
|
|
|
+
|
|
|
+2. **FR2: 供应商管理**
|
|
|
+ - 基于通用CRUD的供应商全生命周期管理
|
|
|
+ - 证件管理和合作等级
|
|
|
+ - 供应商评价和备注系统
|
|
|
+
|
|
|
+3. **FR3: 销售管理**
|
|
|
+ - 基础销售流程(客户→订单→出货→库存)
|
|
|
+ - 多彩宝订单导入和校验
|
|
|
+ - 多维度订单统计(子公司/母公司视角)
|
|
|
+ - AI客户分析和信用评估
|
|
|
+
|
|
|
+4. **FR4: 库存管理**
|
|
|
+ - 总库存和分仓库库存管理
|
|
|
+ - AI辅助分仓库自动分配
|
|
|
+ - 实时库存监控和预警
|
|
|
+ - 库存盘点和库位管理
|
|
|
+
|
|
|
+5. **FR5: 采购管理**
|
|
|
+ - 采购计划和订单管理
|
|
|
+ - 进货单和合同管理
|
|
|
+ - AI供应商匹配和采购审批
|
|
|
+
|
|
|
+6. **FR6: 客户档案管理**
|
|
|
+ - 客户等级和关键信息管理
|
|
|
+ - 客户信息修改及保存
|
|
|
+ - 历史采购订单关联
|
|
|
+
|
|
|
+7. **FR7: 数据大屏展示**
|
|
|
+ - 母公司视角全集团数据展示
|
|
|
+ - 子公司视角单公司数据展示
|
|
|
+ - 多维度数据可视化
|
|
|
+
|
|
|
+### 2.2 Non Functional
|
|
|
+1. **NFR1: 性能要求**
|
|
|
+ - API响应时间 < 200ms
|
|
|
+ - 支持100+并发用户
|
|
|
+ - 复杂查询 < 1s
|
|
|
+
|
|
|
+2. **NFR2: 可扩展性**
|
|
|
+ - 基于D8D Starter多租户架构
|
|
|
+ - 支持水平扩展
|
|
|
+ - 模块化设计支持独立扩展
|
|
|
+
|
|
|
+3. **NFR3: 安全性**
|
|
|
+ - 扩展现有JWT认证和RBAC权限控制
|
|
|
+ - 跨公司数据隔离和权限管理
|
|
|
+ - 敏感数据加密存储
|
|
|
+
|
|
|
+4. **NFR4: 可用性**
|
|
|
+ - 系统可用性99.5%
|
|
|
+ - 支持移动端H5访问
|
|
|
+ - 响应式设计适配多种设备
|
|
|
+
|
|
|
+5. **NFR5: 开发效率**
|
|
|
+ - 基于D8D Starter开发效率提升50%
|
|
|
+ - 复用现有通用CRUD服务
|
|
|
+ - 完整的测试基础设施支持
|
|
|
+
|
|
|
+## 3. User Interface Design Goals
|
|
|
+
|
|
|
+### 3.1 Overall UX Vision
|
|
|
+构建一个直观易用的集团化进销存管理系统,为母公司提供全局管控能力,为子公司提供便捷的业务操作体验。界面设计遵循shadcn/ui设计规范,确保一致性和专业性。
|
|
|
+
|
|
|
+### 3.2 Key Interaction Paradigms
|
|
|
+- 基于角色的差异化界面展示
|
|
|
+- 数据驱动的智能决策提示
|
|
|
+- 批量操作和快速筛选功能
|
|
|
+- 实时数据更新和状态同步
|
|
|
+
|
|
|
+### 3.3 Core Screens and Views
|
|
|
+- 登录认证页面
|
|
|
+- 母公司管理仪表板
|
|
|
+- 子公司业务操作界面
|
|
|
+- 组织架构管理页面
|
|
|
+- 供应商管理列表和详情
|
|
|
+- 销售订单管理界面
|
|
|
+- 库存监控和分配界面
|
|
|
+- 采购计划和审批页面
|
|
|
+- 客户档案管理界面
|
|
|
+- 数据大屏展示页面
|
|
|
+
|
|
|
+### 3.4 Accessibility: WCAG AA
|
|
|
+遵循WCAG AA标准,确保系统对残障用户的可访问性,包括键盘导航、屏幕阅读器支持、颜色对比度等。
|
|
|
+
|
|
|
+### 3.5 Branding
|
|
|
+采用企业级管理系统的专业设计风格,保持与D8D Starter设计系统的一致性,使用shadcn/ui组件库确保视觉统一。
|
|
|
+
|
|
|
+### 3.6 Target Device and Platforms: Web Responsive
|
|
|
+支持Web响应式设计,适配桌面端、平板和移动端,确保在不同设备上都有良好的用户体验。
|
|
|
+
|
|
|
+## 4. Technical Assumptions
|
|
|
+
|
|
|
+### 4.1 Repository Structure: Monorepo
|
|
|
+采用单体仓库结构,前后端统一管理,便于代码共享和依赖管理。
|
|
|
+
|
|
|
+### 4.2 Service Architecture
|
|
|
+基于D8D Starter的模块化单体架构,支持多租户扩展。在现有架构基础上扩展业务模块,保持技术栈一致性。
|
|
|
+
|
|
|
+### 4.3 Testing Requirements
|
|
|
+完整的测试金字塔策略:
|
|
|
+- 单元测试:核心业务逻辑 > 80%
|
|
|
+- 集成测试:API端点和数据库操作
|
|
|
+- E2E测试:关键用户流程
|
|
|
+- 基于现有Vitest + Testing Library + Playwright测试基础设施
|
|
|
+
|
|
|
+### 4.4 Additional Technical Assumptions and Requests
|
|
|
+- 基于D8D Starter现有技术栈:Hono + React + TypeORM + PostgreSQL
|
|
|
+- 复用现有用户管理和认证授权系统
|
|
|
+- 利用通用CRUD服务快速开发业务模块
|
|
|
+- 集成第三方AI服务实现智能决策
|
|
|
+- 支持多八多云端容器环境部署
|
|
|
+
|
|
|
+## 5. Epic List
|
|
|
+
|
|
|
+1. **Epic 1: 基础架构和多租户扩展**
|
|
|
+ 建立多租户架构基础,扩展现有用户系统支持母子公司层级管理
|
|
|
+
|
|
|
+2. **Epic 2: 核心业务实体管理**
|
|
|
+ 实现供应商、客户、产品等核心业务实体的CRUD管理
|
|
|
+
|
|
|
+3. **Epic 3: 销售和库存管理**
|
|
|
+ 构建完整的销售流程和库存管理功能
|
|
|
+
|
|
|
+4. **Epic 4: 采购管理和AI决策**
|
|
|
+ 实现采购流程和AI驱动的智能决策功能
|
|
|
+
|
|
|
+5. **Epic 5: 数据可视化和移动端**
|
|
|
+ 提供数据大屏展示和移动端支持
|
|
|
+
|
|
|
+## 6. Epic Details
|
|
|
+
|
|
|
+### 6.1 Epic 1: 基础架构和多租户扩展
|
|
|
+建立多租户架构基础,在D8D Starter现有用户系统基础上扩展支持母子公司层级管理,实现数据隔离和权限穿透。
|
|
|
+
|
|
|
+#### 6.1.1 Story 1.1: 组织架构实体扩展
|
|
|
+**As a** 系统架构师,
|
|
|
+**I want** 扩展现有用户实体支持公司层级关系,
|
|
|
+**so that** 能够建立母子公司树形结构并实现数据隔离。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 在User实体基础上添加company_id字段
|
|
|
+2. 创建Company实体支持树形层级关系
|
|
|
+3. 实现数据访问权限的company_id过滤
|
|
|
+4. 确保现有用户数据向后兼容
|
|
|
+5. 添加组织架构管理的API端点
|
|
|
+
|
|
|
+#### 6.1.2 Story 1.2: 多租户权限管理
|
|
|
+**As a** 系统管理员,
|
|
|
+**I want** 扩展RBAC权限系统支持跨公司数据访问,
|
|
|
+**so that** 母公司可以穿透访问子公司数据而子公司只能访问本公司数据。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 扩展现有权限中间件支持company_id检查
|
|
|
+2. 实现母公司管理员的全数据访问权限
|
|
|
+3. 实现子公司用户的公司内数据隔离
|
|
|
+4. 添加跨公司数据访问的权限配置
|
|
|
+5. 确保权限系统的性能和安全性
|
|
|
+
|
|
|
+### 6.2 Epic 2: 核心业务实体管理
|
|
|
+基于通用CRUD服务快速实现供应商、客户、产品等核心业务实体的管理功能。
|
|
|
+
|
|
|
+#### 6.2.1 Story 2.1: 供应商管理
|
|
|
+**As a** 采购专员,
|
|
|
+**I want** 管理供应商信息和合作等级,
|
|
|
+**so that** 能够维护供应商档案并支持采购决策。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 基于通用CRUD创建供应商实体
|
|
|
+2. 支持供应商基本信息管理(名称、地址、联系方式)
|
|
|
+3. 实现供应商证件上传和管理
|
|
|
+4. 支持供应商合作等级和评价系统
|
|
|
+5. 提供供应商搜索和筛选功能
|
|
|
+
|
|
|
+#### 6.2.2 Story 2.2: 客户档案管理
|
|
|
+**As a** 销售人员,
|
|
|
+**I want** 管理客户信息和等级分类,
|
|
|
+**so that** 能够维护客户关系并支持销售决策。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 创建客户实体支持等级分类
|
|
|
+2. 实现客户基本信息管理
|
|
|
+3. 支持客户历史订单关联
|
|
|
+4. 提供客户搜索和筛选功能
|
|
|
+5. 确保客户数据的权限隔离
|
|
|
+
|
|
|
+### 6.3 Epic 3: 销售和库存管理
|
|
|
+构建完整的销售订单处理流程和库存管理功能,支持跨公司业务操作。
|
|
|
+
|
|
|
+#### 6.3.1 Story 3.1: 销售订单管理
|
|
|
+**As a** 销售人员,
|
|
|
+**I want** 创建和管理销售订单,
|
|
|
+**so that** 能够跟踪订单状态并自动更新库存。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 实现销售订单创建和状态管理
|
|
|
+2. 支持多彩宝订单导入和校验
|
|
|
+3. 自动扣减对应仓库库存
|
|
|
+4. 处理退货/换货流程
|
|
|
+5. 提供多维度订单统计
|
|
|
+
|
|
|
+#### 6.3.2 Story 3.2: 库存管理
|
|
|
+**As a** 库管员,
|
|
|
+**I want** 管理总库存和分仓库库存,
|
|
|
+**so that** 能够实时监控库存状况并进行合理分配。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 实现总库存和分仓库库存管理
|
|
|
+2. 支持实时库存监控
|
|
|
+3. 提供库位管理和库存盘点
|
|
|
+4. 实现库存预警功能
|
|
|
+5. 支持跨公司库存调拨
|
|
|
+
|
|
|
+### 6.4 Epic 4: 采购管理和AI决策
|
|
|
+实现采购流程管理和AI驱动的智能决策功能,提升采购效率和决策质量。
|
|
|
+
|
|
|
+#### 6.4.1 Story 4.1: 采购流程管理
|
|
|
+**As a** 采购专员,
|
|
|
+**I want** 创建采购计划和订单,
|
|
|
+**so that** 能够管理采购流程并跟踪供应商交付。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 实现采购计划创建和管理
|
|
|
+2. 支持采购订单生成和跟踪
|
|
|
+3. 管理进货单和合同文件
|
|
|
+4. 支持发票和物流信息上传
|
|
|
+5. 提供采购审批流程
|
|
|
+
|
|
|
+#### 6.4.2 Story 4.2: AI智能决策
|
|
|
+**As a** 决策者,
|
|
|
+**I want** 获得AI驱动的采购和库存决策建议,
|
|
|
+**so that** 能够基于数据做出更优的业务决策。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 集成第三方AI服务接口
|
|
|
+2. 实现AI供应商匹配功能
|
|
|
+3. 提供AI库存分配建议
|
|
|
+4. 实现销售预测和客户分析
|
|
|
+5. 支持人工调整和确认AI建议
|
|
|
+
|
|
|
+### 6.5 Epic 5: 数据可视化和移动端
|
|
|
+提供数据大屏展示和移动端支持,满足不同场景下的数据查看和管理需求。
|
|
|
+
|
|
|
+#### 6.5.1 Story 5.1: 数据大屏展示
|
|
|
+**As a** 管理者,
|
|
|
+**I want** 查看多维度数据可视化展示,
|
|
|
+**so that** 能够快速了解集团运营状况并做出决策。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 实现母公司视角全集团数据展示
|
|
|
+2. 提供子公司视角单公司数据展示
|
|
|
+3. 支持销售、库存、采购等关键指标可视化
|
|
|
+4. 实现实时数据更新
|
|
|
+5. 提供数据导出和分享功能
|
|
|
+
|
|
|
+#### 6.5.2 Story 5.2: 移动端支持
|
|
|
+**As a** 业务人员,
|
|
|
+**I want** 通过移动端访问系统核心功能,
|
|
|
+**so that** 能够随时随地处理业务和查看数据。
|
|
|
+
|
|
|
+**Acceptance Criteria**
|
|
|
+1. 实现响应式设计适配移动端
|
|
|
+2. 支持移动端库存查询和订单查看
|
|
|
+3. 提供移动端审批功能
|
|
|
+4. 实现AI预警消息推送
|
|
|
+5. 确保移动端用户体验流畅
|
|
|
+
|
|
|
+## 7. Checklist Results Report
|
|
|
+
|
|
|
+### 7.1 PM Checklist执行结果
|
|
|
+✅ **需求完整性检查**: 功能需求覆盖了项目简报中的所有MVP范围
|
|
|
+✅ **技术可行性验证**: 基于D8D Starter技术栈,技术方案可行
|
|
|
+✅ **用户价值确认**: 每个故事都明确了用户价值和业务目标
|
|
|
+✅ **优先级排序**: Epic按照依赖关系和价值交付顺序排列
|
|
|
+✅ **验收标准明确**: 每个故事都有清晰可测试的验收标准
|
|
|
+
|
|
|
+### 7.2 风险评估
|
|
|
+⚠️ **技术风险**: D8D Starter在多租户场景下的性能需要验证
|
|
|
+⚠️ **集成风险**: 第三方AI服务的稳定性和成本控制
|
|
|
+⚠️ **数据风险**: 跨公司数据隔离和权限管理的复杂性
|
|
|
+
|
|
|
+## 8. Next Steps
|
|
|
+
|
|
|
+### 8.1 UX Expert Prompt
|
|
|
+基于此PRD文档,开始UX设计工作,重点关注母公司和子公司的差异化界面设计、数据可视化展示、移动端用户体验优化。
|
|
|
+
|
|
|
+### 8.2 Architect Prompt
|
|
|
+基于此PRD文档,开始架构设计工作,重点关注多租户架构扩展、现有技术栈的适应性、性能优化策略、第三方AI服务集成方案。
|
|
|
|
|
|
---
|
|
|
|
|
|
-**文档状态**: 已更新
|
|
|
-**最后更新**: 2025-09-17
|
|
|
-**下次评审**: 2025-09-24
|
|
|
+**文档状态**: 正式版
|
|
|
+**下次评审**: 2025-10-27
|