# SampLink Liberia 🏥
**Integrated sample transportation system for specimen referral and diagnostics in Liberia**
A comprehensive, mobile-first web application for tracking TB, Malaria, HIV, IDSR, and MCH samples from collection to diagnosis across all 15 counties of Liberia.
---
## 🌟 Project Overview
**Version**: 1.0.0 (Production Ready)
**Status**: 100% Complete (30/30 core features) 🎉 ALL PHASES COMPLETE!
**License**: Private
**Developed By**: Roseline Yah Trokpao & Joseph Jefferson Chesson
### Vision
Revolutionize healthcare delivery in Liberia through seamless sample tracking, ensuring every specimen is accounted for from collection site to laboratory with complete chain of custody.
---
## 🚀 Live Application
**Production**:
samplink-liberia.pages.dev
**Latest Deployment**:
aabc0846.samplink-liberia.p…
**GitHub Repository**:
github.com
**Test Accounts**:
- **Admin**: samplink.dev@gmail.com / Sagacious@20
- **Other Roles**: Any email with any password (demo mode)
---
## âś… Completed Features
### 1. Authentication & Authorization âś…
- Pre-login role selection (Admin, Courier, Facility Staff, TB Program Member)
- Admin access restricted to specific credentials
- Token-based authentication
- Secure session management
### 2. Multi-Program Support âś…
- **TB** - Tuberculosis Control Program
- **Malaria** - National Malaria Control Program
- **HIV** - HIV/AIDS Prevention Program
- **IDSR** - Integrated Disease Surveillance and Response
- **MCH** - Maternal and Child Health Program
### 3. Facility Network âś…
- **18 Health Facilities** across 10 counties
- **3 Facility Types**:
- **Spokes**: Sample collection sites
- **Hubs**: Testing and storage centers
- **Relay**: Intermediate transfer points
### 4. Comprehensive Database Schema âś…
- **12 Tables**: users, facilities, transporters, samples, sample_events, routes, route_samples, notifications, payroll, inventory, documents, sync_queue
- ** …