# Live Cattle Procurement Intelligent Digital System - Product Requirements Document

## Version History
| Version | Date | Author | Description |
|---------|------|--------|-------------|
| v1.0 | 2024-01-20 | Product Manager | Initial PRD |

## 1. Project Overview

### 1.1 Project Background
To address issues of information opacity, non-standard processes, and difficult risk control in live cattle procurement, develop a digital management system for live cattle procurement SOP.

### 1.2 Project Objectives
- Achieve standardized, digital management of procurement processes
- Improve procurement efficiency and reduce operational risks
- Ensure traceable cattle quality and secure transactions

### 1.3 Success Criteria
- 30% reduction in procurement process time
- Operational error rate reduced to below 1%
- Customer satisfaction rate reaches 95% or higher

## 2. User Roles and Use Cases

### 2.1 User Roles
| Role | Responsibilities | System Permissions |
|------|-----------------|-------------------|
| Purchaser | Initiate procurement needs, confirm acceptance, approve payments | Order creation, acceptance confirmation, payment approval |
| Trader | Forward orders, manage suppliers, handle fund settlement | Order management, supplier management, settlement processing |
| Supplier | Prepare cattle, manage loading, provide documents | Cattle information maintenance, loading management, document upload |
| Driver | Execute transportation, report status, handle document transfer | Transport tracking, status reporting, document confirmation |
| Internal Staff | Internal operations and management | Internal system access and management functions |

### 2.2 Core Use Cases
1. **Procurement Order Management** - Purchaser creates orders, trader forwards orders
2. **Cattle Verification Management** - Supplier prepares cattle, uploads quarantine certificates
3. **Transport Tracking Management** - Driver reports real-time transport status
4. **Arrival Acceptance Management** - Purchaser confirms acceptance, handles exceptions
5. **Settlement Payment Management** - Automatic calculation of payments, online payment

## 3. Functional Requirements

### 3.1 Procurement Planning Phase
#### User Story: As a Purchaser, I want to create procurement orders, so that procurement requirements are clear
**Acceptance Criteria:**
- Given the purchaser logs into the system
- When filling in "Procurement Order" information
- Then the system generates a pending confirmation order
- And includes complete information such as breed, weight, quantity, unit price

#### User Story: As a Trader, I want to review supplier qualifications, so that supplier compliance is ensured
**Acceptance Criteria:**
- Given the trader views supplier information
- When verifying business license and quarantine certificate issuance capability
- Then the system records review results
- And supports document file upload and viewing

### 3.2 Pre-loading Preparation
#### User Story: As a Driver, I want to complete vehicle registration, so that transport vehicles are compliant
**Acceptance Criteria:**
- Given the driver prepares for loading
- When uploading empty truck weighing video and disinfection certificate
- Then the system verifies video completeness
- And on-site veterinarian confirms disinfection certificate online

#### User Story: As a Supplier, I want to prepare cattle verification, so that cattle meet requirements
**Acceptance Criteria:**
- Given the supplier prepares for loading
- When providing "Animal Quarantine Qualification Certificate"
- And ensuring empty water and empty trough time ≥ 8 hours
- Then the system records verification information
- And supports weight range configuration for different breeds

### 3.3 Transport Delivery
#### User Story: As a Driver, I want to report real-time transport status, so that the purchasing party knows transport progress
**Acceptance Criteria:**
- Given the driver is during transport
- When automatically reporting location and cattle status every 10 minutes
- Then the system records transport trajectory
- And supports video status reporting

#### User Story: As a Purchaser, I want to perform arrival acceptance, so that cattle quality is ensured
**Acceptance Criteria:**
- Given within 2 hours after cattle arrival
- When the purchaser accepts the cattle
- Then the system records acceptance results
- And supports exception situation recording and handling

### 3.4 Settlement Payment
#### User Story: As a System, I want to automatically calculate settlement amount, so that manual errors are reduced
**Acceptance Criteria:**
- Given acceptance is completed
- When the system obtains loading weight and unit price
- Then automatically calculates: loading weight × unit price - advance payment
- And generates settlement statement

#### User Story: As a Purchaser, I want to make online payment of balance, so that transaction is completed
**Acceptance Criteria:**
- Given within 3 hours after acceptance
- When the purchaser confirms the settlement statement
- Then the system supports online payment
- And generates payment voucher

### 3.5 Exception Handling
#### User Story: As a System, I want to automatically calculate penalty fees, so that违约处理 is standardized
**Acceptance Criteria:**
- Given违约情况 occurs
- When the system identifies违约类型
- Then calculates penalty at 0.5% of daily contract amount
- And generates违约处理单

## 4. Non-Functional Requirements

### 4.1 Performance Requirements
- System response time: < 2 seconds
- Concurrent users: Support 100+ users online simultaneously
- Data storage: Video files permanently saved

### 4.2 Security Requirements
- Data transmission encryption: HTTPS protocol
- Identity authentication: Multi-factor authentication
- Permission control: Role-based access control
- Data backup: Automatic daily backup

### 4.3 Reliability Requirements
- System availability: 99.9%
- Fault recovery: < 30 minutes
- Data consistency: Transaction integrity guarantee

## 5. Technical Architecture

### 5.1 Mini-Program Matrix (uni-app Technology)
- **Client Mini-Program**: For purchasers to create orders and track progress
- **Supplier Mini-Program**: For suppliers to manage cattle preparation and documents
- **Driver Mini-Program**: For drivers to report transport status and locations
- **Internal Staff Mini-Program**: For internal operations and management

### 5.2 Unified System Architecture
- **Single Database**: All three systems (Website, Admin System, Mini-Programs) use the same database
- **Unified User Center**: Single sign-on across all platforms with consistent authentication
- **Consistent Interaction Design**: Unified UI/UX design standards across all interfaces
- **Real-time Data Sync**: WebSocket-based real-time data synchronization

### 5.3 System Integration
- **API Gateway**: Unified API management and authentication
- **Microservices Architecture**: Modular service design for scalability
- **Message Queue**: Asynchronous processing for better performance
- **Cloud Storage**: Secure file and video storage solution

## 6. Prototype Description

### 6.1 Interface Key Elements
- **Dashboard View**: Visualized procurement process status
- **Order Management**: Integrated order creation, review, and tracking
- **Map View**: Real-time transport trajectory display
- **Video Monitoring**: Loading and unloading process video viewing
- **Settlement Center**: Automatic calculation, online payment

### 6.2 Interaction Flow
1. Purchaser creates order → Trader confirms forwarding → Supplier accepts order
2. Supplier prepares cattle → Uploads certificate documents → Driver vehicle registration
3. Loading monitoring → Transport tracking → Arrival acceptance
4. System automatic settlement → Online payment → Document archiving

## 7. Scope Definition

### This Version Includes:
- Complete digital management of live cattle procurement process
- Full functionality for five user roles (including internal staff)
- Dual order process (Purchaser→Trader→Supplier)
- Real-time transport tracking and status reporting
- Automated settlement and payment processing
- Uni-app based mini-program matrix
- Unified database and user center
- Consistent interaction design across all platforms

### This Version Excludes:
- Cattle breeding management functionality
- Sales-side functionality
- Complex financial accounting functions
- Multi-language support

## 8. Priority Ranking

### P0 (Highest Priority)
- Procurement order creation and management
- Cattle verification and document management
- Real-time transport status tracking
- Arrival acceptance and exception handling
- Unified user authentication system
- Real-time data synchronization

### P1 (High Priority)
- Automated settlement calculation
- Online payment functionality
- Document archiving and management
- Data statistics and analysis
- Mini-program development (uni-app)
- API gateway implementation

### P2 (Medium Priority)
- Mobile APP development
- System integration interfaces
- Advanced reporting functionality
- Message notification system
- Performance optimization
- Security enhancement features