afr0cash/MOH-SD

Web-Based Solution for the Ministry of Health of Sudan # MOH Sudan Digital Services Platform Federal Ministry of Health — unified digital portal for healthcare professionals. ## Architecture ``` MOH-Sd/ ├── frontend/ Next.js 16 + React 19 + TypeScript + TailwindCSS + shadcn/ui ├── backend/ Django + DRF + PostgreSQL + Redis + Celery + JWT ├── docker/ Nginx configuration └── docker-compose.yml ``` ## Features - **Single Sign-On** — one account for all ministry services - **Arabic-first** with English support and full RTL - **Service portals**: Internship, Courses, Residents, Specialists, Examinations, Certificates - **Central document repository** — upload once, reuse everywhere - **Role-based access control** for admin and staff - **Admin dashboard** with statistics, reports, and management modules ## Quick Start (Development) ### Frontend ```bash cd frontend cp .env.example .env.local npm install npm run dev ``` Open localhost ### Backend ```bash cd backend cp .env.example .env python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -r requirements.txt USE_SQLITE=True python manage.py migrate USE_SQLITE=True python manage.py createsuperuser USE_SQLITE=True python manage.py runserver ``` API: localhost ### Docker (Production-like) ```bash docker compose up --build ``` ## Environment Variables ### Frontend (`frontend/.env.local`) ``` NEXT_PUBLIC_API_URL=localhost ``` ### Backend (`backend/.env`) See `backend/.env.example` for full list including PostgreSQL, Redis, JWT, and S3 settings. ## Tech Stack | Layer | Technologies | |-------|-------------| | Frontend | Next.js 16, React 19, TypeScript, TailwindCSS, shadcn/ui, Framer Motion, TanStack Query, Zod | | Backend | Django 5, DRF, SimpleJWT, Celery, PostgreSQL, Redis | | Deployment | Docker, Nginx, Gunicorn, HTTPS-ready | ## User Roles - Super Admin, HR Admin, Internship Officer, Courses Officer - Examination Officer, Reviewer, Applicant, Viewer # …