# 集团管理多公司AI智能进销存应用系统 Product Requirements Document (PRD)

## 版本信息
| 版本 | 日期 | 描述 | 作者 |
|------|------|------|------|
| 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. 统一集成DeepSeek API服务接口
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-10-27