Tuz301/VaxTrace-Nigeria

Vaccine Supply Chain Analytics Platform for Nigeria # VaxTrace Nigeria > Vaccine Supply Chain Analytics Dashboard for OpenLMIS VaxTrace Nigeria is a high-level analytics dashboard designed to sit atop the existing OpenLMIS infrastructure. It transforms raw logistical data into actionable insights for decision-makers at the National, State, and LGA levels. ## 🎯 Core Value Proposition - **Eliminate Blind Spots**: Real-time visibility into stockouts before they happen - **Quality Assurance**: Digital tracking of VVM (Vaccine Vial Monitor) status and temperature excursions - **Operational Efficiency**: Automated calculation of replenishment needs based on actual consumption ## 🏗️ Architecture ``` ┌─────────────────────────────────────────────────────────────────┐ │ Frontend Layer │ │ Next.js 14 (App Router) + Mapbox GL JS + PWA (Offline-First) │ └────────────────────────────┬────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ API Gateway (NestJS) │ │ Middleware Orchestrator • Redis Cache • Protobuf Encoding │ └────────────────────────────┬────────────────────────────────────┘ │ ┌────────┴────────┐ ▼ ▼ ┌──────────────────┐ ┌─────────────────┐ │ PostgreSQL + │ │ OpenLMIS │ │ PostGIS (GEO) │ │ REST API │ └──────────────────┘ └─────────────────┘ ``` ## 🚀 Quick Start ### Prerequisites - Node.js 18+ and npm 9+ - Docker and Docker Compose - Git ### Installation 1. **Clone the repository** ```bash git clone github.com cd vaxtrace-nigeria ``` 2. **Copy environment file** ```bash cp .env.example .env ``` 3. **Edit `.env` with your configuration** - Set strong passwords for PostgreSQL and Redis - Configure OpenLMIS API credentials - Set encryption keys for AES-256 4. **Start infrastructure services** ```bash docker-compose up -d postgres redis ``` 5. **Install dependencies** ```bash …