A role-based livestock procurement and compliance management system built for the Botswana Meat Commission. Manages cattle deliveries, automated payment calculation, payment dispute resolution, and farmer notifications — built with HTML, CSS, PHP, MySQL, and Vanilla JS.
# Integrated Livestock Procurement & Compliance Management System
### ILPCMS — Local Prototype v1.1
A web-based system for managing livestock procurement, delivery compliance,
payments, and payment dispute resolution for the Botswana Meat Commission.
---
## Tech Stack
| Layer | Technology |
|-------------|-------------------------|
| Frontend | HTML5, CSS3, Vanilla JS |
| Backend | PHP (no framework) |
| Database | MySQL |
| Auth | PHP Sessions |
| Local Server| XAMPP / WAMP |
---
## User Roles
Three roles, each with a dedicated portal and restricted access.
| Role | Portal | Responsibilities |
|---------------|----------------|-------------------------------------------------------------------------|
| Farmer | farmer.html | View deliveries, track payments, lodge disputes, receive notifications |
| Field Officer | officer.html | Record cattle deliveries, assign ear tags, log health and weight |
| Admin | admin.html | Approve/reject deliveries, process payments, resolve queries, view logs |
---
## Core Modules
### 1. Delivery Management
- Field Officers submit cattle deliveries with ear tag, weight, grade, and health status
- Grade is assigned automatically based on weight:
- Grade A: 400 kg and above
- Grade B: 250 kg to 399 kg
- Grade C: Below 250 kg
- Admin reviews each delivery and sets status to Approved or Rejected
- Delivery statuses: Submitted → Verified → Approved / Rejected → Paid
### 2. Payment Processing
- A payment record is created automatically when Admin approves a delivery
- Amount is calculated from grade and weight at the following rates:
- Grade A: P6.50 per kg
- Grade B: P5.00 per kg
- Grade C: P3.50 per kg
- Admin marks a delivery as Paid once the payment has been processed
- Payment statuses: Pending → Completed
### 3. Payment Query Module
- Farmers …