Modern healthcare referral management for Tigray Region Health Bureau
# Tigray Referral Management System (TRMS)
**Version:** 1.0.0-rc1 | **Sprint Cycle:** 0–7 Complete
An offline-first, referral-centric health information system for the Tigray region.
---
## Architecture Overview
```
d:/TRMS/
├── frontend/ # Next.js 16 (React, App Router, Vanilla CSS)
└── backend/ # NestJS + Prisma ORM + PostgreSQL
```
| Layer | Technology | Port |
|------------------|-----------------------------|-------|
| Frontend | Next.js 16 / React 19 | 3000 |
| Backend API | NestJS / Node.js | 3001 |
| Database | PostgreSQL (via Prisma ORM) | 5432 |
| Offline Store | PouchDB (IndexedDB) | — |
---
## Quick Start
### Prerequisites
- Node.js ≥ 18
- PostgreSQL running locally on port 5432
- npm
### 1. Backend Setup
```bash
cd backend
npm install
# Update .env with your DB credentials:
# DATABASE_URL="postgresql://USER:PASS@localhost:5432/trms?schema=public"
npx prisma migrate dev --name init
npm run start:dev
```
Backend available at: **
http://localhost:3001**
### 2. Frontend Setup
```bash
cd frontend
npm install
npm run dev
```
Frontend available at: **
http://localhost:3000**
---
## Implemented Sprints
| Sprint | Focus | Status |
|--------|-------------------------------|--------|
| 0 | Repository & Foundation | ✅ Done |
| 1 | Authentication Skeleton | ✅ Done |
| 2 | Referral Creation Form | ✅ Done |
| 3 | Offline Store & PouchDB Sync | ✅ Done |
| 4 | Directory & Triage Dashboard | ✅ Done |
| 5 | Notifications & Feedback Loop | ✅ Done |
| 6 | Analytics & Compliance | ✅ Done |
| 7 | FHIR Readiness & Stabilization| ✅ Done |
---
## Key Frontend Routes
| Route | Purpose |
|------------------|----------------------------------------------------|
| `/` | Login Page …