ragner01/OSUTH

A production-ready hospital information system for Nigeria, featuring multi-facility support, FHIR interoperability, and enterprise-grade security. Built with Spring Boot, React, PostgreSQL, and deployed on AWS. # Osun State Teaching Hospital - Health Information System (HIS) ## 🏥 Production-Grade Hospital Information System A comprehensive, multi-module monorepo for managing clinical workflows, patient data, billing, staff scheduling, and operational analytics in a Nigerian healthcare setting. --- ## 📋 Features ### Clinical Workflows - ✅ Patient Master with PHI encryption - ✅ Appointment booking with smart queue - ✅ NEWS2-like triage scoring - ✅ Lab & Radiology order workflows - ✅ FEFO medication dispensing - ✅ Ward & Bed management ### Business Operations - ✅ Auto-invoice generation - ✅ Multi-payment method support - ✅ NHIA/HMO claim lifecycle - ✅ Rota auto-generation with conflict detection - ✅ Safe discharge handover checklists - ✅ Referral & transfer tracking ### Interoperability - ✅ FHIR R4-style read APIs - ✅ ETag caching support - ✅ Delta-based offline sync - ✅ Version vectors for consistency - ✅ Tombstone support for deletions ### Production Features - ✅ Rate limiting per role - ✅ IP allowlist for admin - ✅ WAF security headers - ✅ TLS enforcement - ✅ SLO monitoring (99.9% uptime) - ✅ Prometheus metrics & Grafana dashboards - ✅ OpenTelemetry distributed tracing - ✅ Immutable audit trail - ✅ Data retention policies - ✅ Consent management --- ## 🏗️ Architecture **Clean Architecture** with 12 modules: - `platform-lib` - Core utilities, security, audit - `identity` - Keycloak OIDC integration - `gateway` - API Gateway with routing - `core-emr` - Patient master and clinical data - `appointments` - Booking, triage, queue - `orders-lab-rad` - Lab & radiology orders - `pharmacy` - Medications and dispensing - `billing` - Invoices, payments, claims - `staff-rota` - Rota and handover management - `notifications` - SMS/WhatsApp integration - `ops-analytics` - Metrics and analytics - `interop` - FHIR APIs and sync --- ## 🚀 Quick Start ### Prerequisites - Java 11+ - Docker & Docker Compose - Maven 3.8+ ### Start Infrastructure ```bash make up ``` ### Build Proje …