PANK4SS/VitAfrica

VitAfrica is a specialized SaaS Hospital Management System built to digitalize healthcare in African contexts. It provides a web portal for admin, doctors & staff, plus a patient mobile app replacing paper-based systems with a secure, scalable digital infrastructure. VitAfrica — Hospital Management System SaaS hospital & clinic management platform for African healthcare facilities Digitalizing Healthcare for a Reliable Future --- ## Table of Contents - Overview - Problem Statement - Architecture - Tech Stack - Components - Backend API - AccessCore - Web App - Mobile App - Getting Started - API Overview - Security - Deployment - License --- ## Overview VitAfrica is a specialized **Hospital/Clinic Management System** designed to digitalize medical processes in African contexts. The platform replaces manual, paper-based workflows with a reliable digital infrastructure serving administrators, doctors, staff, and patients across two interfaces: a **web portal** for clinical management and a **mobile application** for patient self-service. The system is organized as a **monorepo** containing four interconnected components. --- ## Problem Statement Healthcare facilities in target regions face critical operational challenges: - **Data Integrity** — Paper files are prone to loss, duplication, and deterioration - **Operational Efficiency** — Manual appointment scheduling and pharmacy tracking consume excessive time and resources - **Financial Transparency** — Billing processes lack centralization, leading to errors and revenue leakage VitAfrica addresses these issues through a unified digital platform with role-based access control, automated workflows, and real-time data synchronization. --- ## Architecture ``` vitafrica/ ├── backend/ # Spring Boot REST API (Java 17) ├── accesscore/ # Reusable authentication & RBAC library ├── web-app/ # Admin/Doctor/Staff web portal (React + TypeScript) ├── mobile-app/ # Patient mobile application (Flutter) ├── doc/ # Documentation (English & French) ├── docker-compose.yml ├── railway.json └── .env ``` The backend and accesscore are Java modules built with Maven. AccessCore is a reusable library installed to the local Maven repository and co …