niumalll/docs/产品需求文档.md

# 活牛采购智能数字化系统 - 产品需求文档 (PRD)

## 版本历史
| 版本 | 日期 | 作者 | 变更说明 |
|------|------|------|----------|
| v1.0 | 2024-01-20 | 产品经理 | 初版PRD文档 |
| v1.1 | 2024-05-15 | 产品经理 | 更新小程序矩阵需求 |
| v2.0 | 2024-12-20 | 产品经理 | 重构文档结构，完善需求细节 |

## 1. 项目概述

### 1.1 项目背景

活牛采购行业长期存在以下核心痛点：
- **信息不透明**：采购流程中各环节信息孤岛，缺乏统一的信息管理平台
- **流程不规范**：缺乏标准化的操作流程，人为因素导致的错误率高
- **风险控制难**：质量检验、运输监控、资金结算等环节风险控制能力不足
- **效率低下**：大量手工操作，重复性工作多，整体效率有待提升

### 1.2 项目目标

**主要目标**：
- 建立标准化的活牛采购数字化管理平台
- 实现采购全流程的信息化、透明化管理
- 提升采购效率，降低操作风险
- 确保牛只质量可追溯，交易过程安全可靠

**具体目标**：
- 采购流程处理时间减少30%
- 操作错误率降低至1%以下
- 客户满意度提升至95%以上
- 系统可用性达到99.9%

### 1.3 成功标准

**业务指标**：
- 月活跃用户数 > 500人
- 订单处理成功率 > 99%
- 平均订单处理时间 < 2小时
- 用户满意度评分 > 4.5/5.0

**技术指标**：
- 系统响应时间 < 2秒
- 系统可用性 > 99.9%
- 数据准确性 > 99.9%
- 安全事故 = 0

## 2. 用户角色与用例

### 2.1 用户角色定义

| 角色名称 | 角色描述 | 主要职责 | 使用场景 |
|---------|---------|---------|---------|
| **采购人** | 活牛采购需求方 | 发起采购需求、验收确认、支付审批 | 创建订单、跟踪运输、验收支付 |
| **贸易商** | 中间贸易服务商 | 订单转发、供应商管理、资金结算 | 订单管理、供应商协调、结算处理 |
| **供应商** | 活牛供应方 | 牛只准备、装车管理、单据提供 | 接收订单、准备牛只、上传证件 |
| **司机** | 运输服务提供方 | 运输执行、状态上报、单据交接 | 运输跟踪、状态更新、异常上报 |
| **系统管理员** | 平台运营管理 | 用户管理、系统配置、数据监控 | 后台管理、系统维护、数据分析 |

### 2.2 用户权限矩阵

| 功能模块 | 采购人 | 贸易商 | 供应商 | 司机 | 管理员 |
|---------|-------|-------|-------|------|-------|
| 订单创建 | ✅ | ❌ | ❌ | ❌ | ✅ |
| 订单查看 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 订单转发 | ❌ | ✅ | ❌ | ❌ | ✅ |
| 牛只管理 | ❌ | ❌ | ✅ | ❌ | ✅ |
| 运输跟踪 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 验收确认 | ✅ | ❌ | ❌ | ❌ | ✅ |
| 支付处理 | ✅ | ✅ | ❌ | ❌ | ✅ |
| 用户管理 | ❌ | ❌ | ❌ | ❌ | ✅ |

### 2.3 核心用例场景

**用例1：采购订单创建**
- **参与者**：采购人、贸易商
- **前置条件**：采购人已登录系统
- **主要流程**：采购人创建订单 → 贸易商审核确认 → 订单生效
- **后置条件**：订单进入待处理状态

**用例2：运输全程跟踪**
- **参与者**：司机、采购人、贸易商
- **前置条件**：订单已确认，司机已接单
- **主要流程**：司机上报位置 → 系统记录轨迹 → 相关方实时查看
- **后置条件**：运输状态实时更新

**用例3：到货验收支付**
- **参与者**：采购人、系统
- **前置条件**：牛只已到达目的地
- **主要流程**：采购人验收 → 系统计算金额 → 在线支付
- **后置条件**：交易完成，订单结束

## 3. 功能需求

### 3.1 采购计划阶段

#### 3.1.1 订单创建功能
**用户故事**：As a 采购人, I want to 创建采购订单, so that 明确采购需求并启动采购流程

**验收标准**：
```gherkin
Given 采购人已登录系统
When 采购人填写采购订单信息
  And 包含牛只品种、重量范围、数量、单价、交货地点、交货时间
  And 上传相关采购文件
Then 系统生成唯一订单号
  And 订单状态设置为"待确认"
  And 发送通知给指定贸易商
```

**详细需求**：
- 支持多种牛只品种选择（西门塔尔、安格斯、夏洛莱等）
- 重量范围可配置（如：300-400kg、400-500kg等）
- 支持批量订单创建
- 订单模板功能，快速创建相似订单
- 订单草稿保存功能

#### 3.1.2 供应商资质审核
**用户故事**：As a 贸易商, I want to 审核供应商资质, so that 确保供应商具备合规供应能力

**验收标准**：
```gherkin
Given 贸易商查看供应商信息
When 核实营业执照、动物防疫条件合格证等证件
  And 检查检疫证明开具能力
  And 评估供应商历史表现
Then 系统记录审核结果
  And 更新供应商资质状态
  And 支持证件到期提醒功能
```

### 3.2 装车前准备阶段

#### 3.2.1 车辆备案管理
**用户故事**：As a 司机, I want to 完成车辆备案, so that 确保运输车辆符合运输要求

**验收标准**：
```gherkin
Given 司机准备装车
When 上传空车过磅视频（时长≥30秒）
  And 上传车辆消毒证明
  And 填写车辆基本信息（车牌号、载重等）
Then 系统验证视频完整性和清晰度
  And 驻场兽医在线确认消毒证明
  And 车辆状态更新为"已备案"
```

#### 3.2.2 牛只核验管理
**用户故事**：As a 供应商, I want to 准备牛只核验, so that 确保牛只符合采购要求

**验收标准**：
```gherkin
Given 供应商准备装车
When 提供《动物检疫合格证明》
  And 确保牛只空水空槽时间≥8小时
  And 上传牛只现场照片或视频
Then 系统记录核验信息
  And 支持不同品种的重量区间验证
  And 生成装车准备清单
```

### 3.3 运输交付阶段

#### 3.3.1 实时运输跟踪
**用户故事**：As a 司机, I want to 实时上报运输状态, so that 让采购方及时了解运输进度

**验收标准**：
```gherkin
Given 司机在运输途中
When 系统每10分钟自动获取GPS位置
  And 司机可手动上报牛只状态
  And 支持视频状态上报功能
Then 系统记录完整运输轨迹
  And 计算预计到达时间
  And 异常情况自动告警
```

#### 3.3.2 到货验收管理
**用户故事**：As a 采购人, I want to 进行到货验收, so that 确保收到的牛只符合订单要求

**验收标准**：
```gherkin
Given 牛只到达目的地
When 采购人在2小时内完成验收
  And 核对牛只数量、品种、重量
  And 检查牛只健康状况
Then 系统记录验收结果
  And 支持异常情况记录（死亡、受伤、重量不符等）
  And 生成验收报告
```

### 3.4 结算支付阶段

#### 3.4.1 自动结算计算
**用户故事**：As a 系统, I want to 自动计算结算金额, so that 减少人工计算错误

**验收标准**：
```gherkin
Given 验收完成
When 系统获取实际上车重量和约定单价
Then 自动计算：实际重量 × 单价 - 预付款 = 尾款
  And 生成详细结算清单
  And 支持多种计价方式（按头计价、按重量计价）
```

#### 3.4.2 在线支付处理
**用户故事**：As a 采购人, I want to 在线支付尾款, so that 快速完成交易

**验收标准**：
```gherkin
Given 结算单已生成
When 采购人确认结算金额
  And 选择支付方式（银行转账、支付宝、微信等）
Then 系统处理支付请求
  And 生成支付凭证
  And 更新订单状态为"已完成"
```

### 3.5 异常处理

#### 3.5.1 违约处理管理
**用户故事**：As a 系统, I want to 自动处理违约情况, so that 规范化违约处理流程

**验收标准**：
```gherkin
Given 发生违约情况（延期交货、质量不符等）
When 系统识别违约类型和责任方
Then 按合同约定计算违约金（每日合同金额0.5%）
  And 生成违约处理单
  And 发送通知给相关方
```

## 4. 非功能需求

### 4.1 性能要求

| 指标 | 要求 | 测试方法 |
|------|------|----------|
| 响应时间 | 页面加载 < 2秒，API响应 < 1秒 | 性能测试工具 |
| 并发用户 | 支持100+用户同时在线 | 压力测试 |
| 数据处理 | 支持10万+订单数据查询 | 数据库性能测试 |
| 文件上传 | 视频文件上传 < 30秒 | 文件上传测试 |

### 4.2 安全要求

| 安全项 | 要求 | 实现方式 |
|--------|------|----------|
| 数据传输 | HTTPS加密传输 | SSL证书配置 |
| 身份认证 | 多因素认证 | 手机验证码 + 密码 |
| 权限控制 | 基于角色的访问控制 | RBAC权限模型 |
| 数据备份 | 每日自动备份 | 数据库定时备份 |
| 操作日志 | 关键操作全记录 | 审计日志系统 |

### 4.3 可靠性要求

| 可靠性指标 | 要求 | 保障措施 |
|-----------|------|----------|
| 系统可用性 | 99.9% | 集群部署 + 负载均衡 |
| 故障恢复 | < 30分钟 | 自动故障切换 |
| 数据一致性 | 事务完整性保证 | 数据库事务控制 |
| 容灾备份 | 异地备份 | 云端数据备份 |

### 4.4 兼容性要求

| 兼容性类型 | 要求 | 支持范围 |
|-----------|------|----------|
| 浏览器兼容 | 主流浏览器支持 | Chrome、Firefox、Safari、Edge |
| 移动端兼容 | 响应式设计 | iOS、Android |
| 小程序兼容 | 微信小程序平台 | 微信小程序最新版本 |

## 5. 小程序矩阵需求

### 5.1 小程序架构设计

系统采用多小程序架构，为不同用户角色提供专属应用：

```
┌─────────────────────────────────────────────────┐
│                小程序矩阵                        │
├─────────────┬─────────────┬─────────────┬─────────────┤
│  采购人小程序  │  供应商小程序  │   司机小程序   │ 内部员工小程序 │
│ (client-mp) │(supplier-mp)│ (driver-mp) │ (staff-mp)  │
└─────────────┴─────────────┴─────────────┴─────────────┘
```

### 5.2 采购人小程序 (client-mp)

**核心功能需求**：
- **订单管理**：创建订单、查看订单列表、订单详情查看
- **运输跟踪**：实时查看运输位置、预计到达时间
- **验收管理**：扫码验收、异常记录、验收确认
- **支付管理**：查看结算单、在线支付、支付记录
- **供应商评价**：对供应商服务进行评价

**界面设计要求**：
- 简洁直观的订单列表，支持状态筛选
- 地图式运输轨迹展示，实时更新位置
- 扫码验收功能，快速录入验收信息
- 支付流程简化，支持多种支付方式

### 5.3 供应商小程序 (supplier-mp)

**核心功能需求**：
- **订单处理**：接收订单、确认订单、订单状态更新
- **牛只管理**：牛只信息录入、库存管理、质量记录
- **证件管理**：检疫证明上传、证件到期提醒
- **装车管理**：装车视频录制、装车清单确认
- **财务查看**：结算记录查看、收款确认

**界面设计要求**：
- 订单状态可视化展示，清晰的流程指引
- 证件上传便捷操作，支持拍照和相册选择
- 视频录制功能，支持实时录制和本地上传
- 财务数据清晰展示，支持历史记录查询

### 5.4 司机小程序 (driver-mp)

**核心功能需求**：
- **任务管理**：接收运输任务、任务状态更新
- **位置上报**：自动GPS定位、手动位置上报
- **状态记录**：牛只状态视频记录、异常情况上报
- **路线导航**：集成地图导航功能
- **单据管理**：运输单据拍照上传、电子签名

**界面设计要求**：
- 简洁的任务列表，突出当前任务
- 一键式状态上报，减少操作步骤
- 离线操作支持，网络恢复后自动同步
- 紧急情况快速处理，一键求助功能

### 5.5 内部员工小程序 (staff-mp)

**核心功能需求**：
- **全流程监控**：订单全生命周期监控
- **数据统计**：业务数据统计分析
- **用户管理**：用户信息管理、权限设置
- **系统配置**：业务参数配置、规则设置
- **异常处理**：异常订单处理、客服支持

**界面设计要求**：
- 数据驾驶舱式展示，关键指标一目了然
- 多维度统计分析，支持图表展示
- 实时监控预警，异常情况及时提醒
- 管理操作便捷，支持批量操作

## 6. 原型设计说明

### 6.1 界面设计原则

- **简洁性**：界面简洁明了，突出核心功能
- **一致性**：统一的设计语言和交互模式
- **易用性**：符合用户操作习惯，学习成本低
- **响应性**：适配不同屏幕尺寸和设备

### 6.2 关键界面元素

**管理后台界面**：
- **导航栏**：左侧菜单导航，支持收缩展开
- **数据驾驶舱**：关键业务指标可视化展示
- **列表页面**：统一的列表样式，支持搜索、筛选、分页
- **详情页面**：信息层次清晰，操作按钮明显
- **表单页面**：表单验证友好，支持自动保存

**小程序界面**：
- **底部导航**：主要功能模块快速切换
- **卡片式设计**：信息模块化展示
- **浮动按钮**：常用操作快速访问
- **状态指示**：清晰的状态标识和进度展示

### 6.3 交互流程设计

**订单创建流程**：
```
采购人登录 → 选择创建订单 → 填写订单信息 → 确认提交 → 
等待贸易商确认 → 订单生效 → 通知供应商
```

**运输跟踪流程**：
```
司机接单 → 车辆备案 → 开始运输 → 实时位置上报 → 
异常情况处理 → 到达目的地 → 验收确认
```

**支付结算流程**：
```
验收完成 → 系统自动计算 → 生成结算单 → 采购人确认 → 
选择支付方式 → 完成支付 → 生成凭证
```

## 7. 范围界定

### 7.1 本版本包含功能

**核心业务功能**：
- ✅ 活牛采购全流程数字化管理
- ✅ 四类用户角色完整功能支持
- ✅ 双订单流程（采购人→贸易商→供应商）
- ✅ 运输实时跟踪和状态上报
- ✅ 自动化结算和支付处理
- ✅ 小程序矩阵（4个专业小程序）
- ✅ 管理后台系统
- ✅ 企业官网展示

**技术功能**：
- ✅ 用户认证和权限管理
- ✅ 文件上传和存储
- ✅ 实时通信和消息推送
- ✅ 数据统计和报表
- ✅ 系统监控和日志

### 7.2 本版本不包含功能

**业务功能限制**：
- ❌ 牛只养殖管理功能
- ❌ 销售端功能模块
- ❌ 复杂的财务核算功能
- ❌ 多语言支持
- ❌ 第三方ERP系统集成
- ❌ 高级数据分析和AI功能

**技术功能限制**：
- ❌ 移动端原生APP
- ❌ 区块链技术应用
- ❌ 大数据分析平台
- ❌ 人工智能算法

## 8. 风险评估与应对

### 8.1 技术风险

| 风险项 | 风险等级 | 影响 | 应对措施 |
|--------|---------|------|----------|
| 数据库性能瓶颈 | 中 | 系统响应慢 | 数据库优化、读写分离 |
| 第三方服务依赖 | 中 | 功能不可用 | 备用方案、服务降级 |
| 安全漏洞 | 高 | 数据泄露 | 安全审计、渗透测试 |

### 8.2 业务风险

| 风险项 | 风险等级 | 影响 | 应对措施 |
|--------|---------|------|----------|
| 用户接受度低 | 中 | 推广困难 | 用户培训、功能优化 |
| 行业政策变化 | 高 | 合规问题 | 政策跟踪、快速调整 |
| 竞争对手压力 | 中 | 市场份额 | 差异化竞争、功能创新 |

## 9. 项目里程碑

### 9.1 开发计划

| 阶段 | 时间 | 主要交付物 | 负责人 |
|------|------|-----------|--------|
| 需求分析 | Week 1-2 | PRD文档、原型设计 | 产品经理 |
| 技术设计 | Week 3-4 | 技术方案、数据库设计 | 架构师 |
| 后端开发 | Week 5-8 | API接口、核心功能 | 后端团队 |
| 前端开发 | Week 6-10 | 管理后台、小程序 | 前端团队 |
| 测试验收 | Week 11-12 | 测试报告、Bug修复 | 测试团队 |
| 部署上线 | Week 13-14 | 生产环境部署 | 运维团队 |

### 9.2 版本发布计划

- **v1.0 MVP版本**：核心功能实现，支持基本业务流程
- **v1.1 优化版本**：性能优化，用户体验改进
- **v2.0 增强版本**：高级功能，数据分析能力
- **v3.0 智能版本**：AI功能，智能推荐

---

**文档维护**：本文档由产品团队负责维护，每月更新一次，重大变更及时更新。

**最后更新时间**：2024年12月20日