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

## 版本历史
| 版本 | 日期 | 作者 | 说明 |
|------|------|------|------|
| v1.0 | 2024-01-20 | 产品经理 | 初版PRD |
| v1.1 | 2024-05-15 | 系统架构师 | 更新与系统架构和详细设计文档保持一致 |

## 1. 项目概述

### 1.1 项目背景
为解决活牛采购过程中信息不透明、流程不规范、风险控制难等问题，开发活牛采购智能数字化管理系统。

### 1.2 项目目标
- 实现采购流程标准化、数字化管理
- 提高采购效率，降低操作风险
- 确保牛只质量可追溯，交易安全可靠

### 1.3 成功标准
- 采购流程耗时减少30%
- 操作错误率降低至1%以下
- 客户满意度达到95%以上

## 2. 用户角色与用例

### 2.1 用户角色
| 角色 | 职责描述 | 系统权限 |
|------|----------|----------|
| 采购人 | 发起采购需求，验收确认，支付审批 | 订单创建、验收确认、支付审批 |
| 贸易商 | 订单转发，供应商管理，资金结算 | 订单管理、供应商管理、结算处理 |
| 供应商 | 牛只准备，装车管理，单据提供 | 牛只信息维护、装车管理、单据上传 |
| 司机 | 运输执行，状态上报，单据交接 | 运输跟踪、状态上报、单据确认 |

### 2.2 核心用例
1. **采购订单管理** - 采购人创建订单，贸易商转发订单
2. **牛只核验管理** - 供应商准备牛只，上传检疫证明
3. **运输跟踪管理** - 司机实时上报运输状态
4. **到货验收管理** - 采购人验收确认，处理异常
5. **结算支付管理** - 自动计算款项，在线支付

## 3. 功能需求

### 3.1 采购计划阶段
#### 用户故事：As a 采购人, I want to 创建采购订单, so that 明确采购需求
**验收标准：**
- Given 采购人登录系统
- When 填写《采购订货单》信息
- Then 系统生成待确认订单
- And 包含品种、重量、数量、单价等完整信息

#### 用户故事：As a 贸易商, I want to 审核供应商资质, so that 确保供应商合规
**验收标准：**
- Given 贸易商查看供应商信息
- When 核实营业执照和检疫证明开具能力
- Then 系统记录审核结果
- And 支持证件文件上传和查看

### 3.2 装车前准备
#### 用户故事：As a 司机, I want to 完成车辆备案, so that 确保运输车辆合规
**验收标准：**
- Given 司机准备装车
- When 上传空车过磅视频和消毒证明
- Then 系统验证视频完整性
- And 驻场兽医在线确认消毒证明

#### 用户故事：As a 供应商, I want to 准备牛只核验, so that 确保牛只符合要求
**验收标准：**
- Given 供应商准备装车
- When 提供《动物检疫合格证明》
- And 确保空水空槽时间≥8小时
- Then 系统记录核验信息
- And 支持不同品种的重量区间配置

### 3.3 运输交付
#### 用户故事：As a 司机, I want to 实时上报运输状态, so that 采购方掌握运输进度
**验收标准：**
- Given 司机在运输途中
- When 每10分钟自动上报位置和牛只状态
- Then 系统记录运输轨迹
- And 支持视频状态上报

#### 用户故事：As a 采购人, I want to 进行到货验收, so that 确保牛只质量
**验收标准：**
- Given 牛只到岸后2小时内
- When 采购人验收牛只
- Then 系统记录验收结果
- And 支持异常情况记录和处理

### 3.4 结算支付
#### 用户故事：As a 系统, I want to 自动计算结算金额, so that 减少人工错误
**验收标准：**
- Given 验收完成
- When 系统获取上车重量和单价
- Then 自动计算：上车重量×单价 - 预付款
- And 生成结算单

#### 用户故事：As a 采购人, I want to 在线支付尾款, so that 完成交易
**验收标准：**
- Given 验收后3小时内
- When 采购人确认结算单
- Then 系统支持在线支付
- And 生成支付凭证

### 3.5 异常处理
#### 用户故事：As a 系统, I want to 自动计算违约金, so that 规范违约处理
**验收标准：**
- Given 发生违约情况
- When 系统识别违约类型
- Then 按每日合同金额0.5%计算违约金
- And 生成违约处理单

## 4. 非功能需求

### 4.1 性能要求
- 系统响应时间：< 2秒
- 并发用户数：支持100+用户同时在线
- 数据存储：视频文件永久保存

### 4.2 安全要求
- 数据传输加密：HTTPS协议
- 身份认证：多因素认证
- 权限控制：基于角色的访问控制
- 数据备份：每日自动备份

### 4.3 可靠性要求
- 系统可用性：99.9%
- 故障恢复：< 30分钟
- 数据一致性：事务完整性保证

## 5. 原型说明

### 5.1 界面关键元素
- **驾驶舱视图**：采购流程状态可视化
- **订单管理**：订单创建、审核、跟踪一体化
- **地图视图**：实时运输轨迹展示
- **视频监控**：装车卸货过程视频查看
- **结算中心**：自动计算，在线支付

### 5.2 交互流程
1. 采购人创建订单 → 贸易商确认转发 → 供应商接单
2. 供应商准备牛只 → 上传证明文件 → 司机车辆备案
3. 装车监控 → 运输跟踪 → 到货验收
4. 系统自动结算 → 在线支付 → 文件归档

## 6. 范围界定

### 本版本包含：
- 活牛采购全流程数字化管理
- 四类用户角色完整功能
- 双订单流程（采购人→贸易商→供应商）
- 运输实时跟踪和状态上报
- 自动化结算和支付处理

### 本版本不包含：
- 牛只养殖管理功能
- 销售端功能
- 复杂的财务核算功能
- 多语言支持

## 7. 小程序端需求说明

### 7.1 小程序矩阵设计

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

#### 7.1.1 采购人小程序 (client-mp)
**核心功能需求：**
- 采购订单创建和查看
- 实时运输状态跟踪
- 到货验收和质量确认
- 在线支付和结算管理
- 供应商评价和选择

**用户界面要求：**
- 简洁直观的订单列表
- 地图式运输轨迹展示
- 扫码快速验收功能
- 支付流程简化设计

#### 7.1.2 供应商小程序 (supplier-mp)
**核心功能需求：**
- 订单接收和处理
- 牛只信息管理维护
- 检疫证明上传管理
- 装车过程视频记录
- 结算款项查看

**用户界面要求：**
- 订单状态可视化展示
- 证件上传便捷操作
- 视频录制和上传功能
- 财务数据清晰展示

#### 7.1.3 司机小程序 (driver-mp)
**核心功能需求：**
- 运输任务接收确认
- 实时位置自动上报
- 牛只状态视频记录
- 异常情况快速上报
- 到货确认和单据交接

**用户界面要求：**
- 简洁的任务列表
- 一键式状态上报
- 离线操作支持
- 紧急情况快速处理

#### 7.1.4 内部员工小程序 (staff-mp)
**核心功能需求：**
- 全流程订单监控
- 运输实时跟踪管理
- 数据统计和分析
- 系统设置和配置
- 用户管理和权限控制

**用户界面要求：**
- 数据驾驶舱式展示
- 多维度统计分析
- 实时监控预警
- 管理操作便捷

### 7.2 技术实现要求

#### 7.2.1 性能要求
- 页面加载时间：< 2秒
- 接口响应时间：< 1秒
- 离线操作支持：关键功能支持离线使用
- 数据同步：自动后台同步

#### 7.2.2 兼容性要求
- 微信小程序平台兼容
- iOS/Android系统兼容
- 主流手机型号适配
- 不同网络环境适配

#### 7.2.3 安全性要求
- 数据传输加密
- 用户身份验证
- 操作权限控制
- 数据本地加密存储

### 7.3 用户体验要求

#### 7.3.1 操作便捷性
- 关键操作一键完成
- 表单输入简化设计
- 扫码快速操作支持
- 语音输入辅助功能

#### 7.3.2 界面一致性
- 统一的设计语言
- 一致的交互模式
- 标准的图标和色彩
- 统一的提示和反馈

#### 7.3.3 可访问性
- 字体大小可调整
- 高对比度模式支持
- 语音提示功能
- 操作引导清晰

## 8. 优先级排序

### P0（最高优先级）
- 采购订单创建和管理
- 牛只核验和证件管理
- 运输状态实时跟踪
- 到货验收和异常处理
- 采购人小程序核心功能
- 供应商小程序核心功能

### P1（高优先级）
- 自动化结算计算
- 在线支付功能
- 文件归档和管理
- 数据统计和分析
- 司机小程序核心功能
- 内部员工小程序核心功能

### P2（中优先级）
- 移动端APP开发
- 系统集成接口
- 高级报表功能
- 消息通知系统
- 小程序高级功能扩展
- 多语言支持