ToivoT/Livestock-health-tracking-system

The LHVTS is a web-based application designed to address challenges in Namibia's rural livestock sector, such as poor record-keeping, delayed disease reporting, and limited access to veterinary services. # Livestock Health and Vaccination Tracking System (LHVTS) A web-based animal health management system for rural Namibia that supports livestock registration, vaccination tracking, disease reporting, user role access, and offline-capable operation. ## Key Features - Role-based access for **farmers**, **veterinarians**, **extension officers**, and **administrators** - Livestock registration and profile management - Vaccination record entry and tracking - Disease reporting and outbreak tracking - Dashboard views tailored by user role - PWA/offline support via service worker - Secure database access using PDO and session-based authentication ## Technology Stack - PHP (backend) - MySQL / MariaDB (database) - HTML, Bootstrap 5, CSS, JavaScript (frontend) - XAMPP for local development - Service Worker for offline support ## Repository Structure - `index.php` — entry point and role-based routing - `config/db.php` — database connection settings - `api/` — backend endpoints for authentication, livestock, vaccination, disease reporting, dashboard, and profiles - `pages/` — user-facing pages for login, dashboards, livestock registration, vaccination recording, and disease reporting - `includes/` — shared header/footer templates - `assets/` — custom styles and JavaScript files - `service-worker.js` — offline caching and PWA support - `sql/livestock_db.sql` — database schema and sample data ## Setup 1. Install **XAMPP** and start **Apache** and **MySQL**. 2. Copy the project folder into `htdocs`. 3. Import `sql/livestock_db.sql` into MySQL using phpMyAdmin or the MySQL CLI. 4. Update database credentials in `config/db.php` if needed. 5. Open the project in your browser, for example: - `localhost HEALTH_SYSTEM/` ## Usage - Visit `login.php` to sign in. - `register.php` is available for new user registration. - After login, users are redirected to dashboards based on role: - `admin_d …