Etusivu Tutki Apua
Rekisteröidy Kirjaudu sisään
177-template-163
/
mini-starter
haarautettu lähteestä 155-template-138/mini-starter
2
0
Haarauta 0
Tiedostot
Puu: 82f0639bd3
Haarat Tunnisteet
mini-starter
/
docs
/
prd.md

prd.md 11 KB
Historia Raaka

集团管理多公司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