Medical supply chain management platform for healthcare organizations in Africa — inventory, transfers, alerts & live map
# VitalGrid
**Medical supply chain management platform for healthcare organizations in Africa.**
VitalGrid enables NGOs, governments, hospitals, and clinics to track medical inventory, coordinate inter-facility transfers, receive critical shortage and expiry alerts, and visualize facility locations on a live map — all from a single multi-tenant SaaS platform.
> 🌍 **Internationalization (i18n) — Coming Soon.** The UI is currently in French (fr-FR). Full multi-language support (English, Swahili, Arabic, Portuguese) is planned for an upcoming release.
---
## Screenshots
| Dashboard | Facilities Map | Transfer Management |
|---|---|---|
| Role-based dashboards | Live pin map with status colors | Inter-facility transfer coordination |
---
## Features
- **Multi-tenant architecture** — each organization has fully isolated data
- **Role-based access control** — 5 roles: `super_admin`, `facility_manager`, `field_agent`, `ngo_coordinator`, `auditor`
- **Inventory management** — resources, batches, movements, expiry tracking
- **Inter-facility transfers** — request, approve, track, deliver
- **Real-time alerts** — stock shortages, near-expiry batches, temperature anomalies
- **Live map** — SVG pin markers colored by facility status (Leaflet + OpenStreetMap)
- **Cold chain IoT** — DynamoDB events for temperature sensor data
- **Billing & subscriptions** — per-organization plan management (super_admin)
- **Audit log** — full activity trail
- **Demo request flow** — public landing page with access request form
---
## Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16.2.7 (App Router, Turbopack) |
| Language | TypeScript |
| Database | Aurora DSQL (PostgreSQL-compatible, serverless, ACID) |
| IoT Events | AWS DynamoDB |
| Auth | JWT httpOnly cookies (`jose` + `bcryptjs`) |
| Styling | CSS Modules + global design tokens |
| Maps | React-Leaflet + OpenStreetMap |
| Icons | Lucide React |
| Email | SendGrid |
---
## Architecture
```
src/
├── app/
│ …