VitalNexus is a modern, full-stack healthcare administration platform built on a scalable Spring Boot microservices architecture and an Angular 21 frontend. Designed for hospital networks, it streamlines patient portals, clinical schedules, automated notifications, and compliance auditing.
- Angular 21 (Standalone Components)
- TypeScript 5.9
- Bootstrap 5 & SCSS
- Lucide Icons
- Vitest (Unit Testing)
- Java 17 & Spring Boot 4.0.5
- Spring Cloud (Eureka Discovery, API Gateway)
- Spring Security & JWT (Stateless Auth)
- MySQL (Per-service isolated databases)
- OpenFeign (Inter-service communication)
The backend consists of 12 decoupled microservices:
| Service | Port | Description |
|---|---|---|
| Discovery Server | 8761 |
Eureka Server for service registration. |
| Config Server | 8888 |
Centralized configuration management. |
| API Gateway | 8083 |
WebFlux-based routing and global CORS handling. |
| Authentication | 8081 |
JWT issuance and credential verification. |
| User Service | 8084 |
Manages doctors, admins, and role hierarchies. |
| Patient Service | 9082 |
Patient profiles and document vault. |
| Appointment Service | 8089 |
Scheduling, slots, and availability. |
| Treatment Service | 9090 |
Medical records, diagnoses, and prescriptions. |
| Hospital Service | 8011 |
Hospital inventory and resource tracking. |
| Compliance Service | 8082 |
Automated audit logs and compliance oversight. |
| Reporting Service | 8086 |
Dashboard statistics and analytical aggregation. |
| Notification Service | N/A | Inter-service alert propagation via Feign. |
- Docker & Docker Compose (for automated infrastructure)
- Java 17 & Maven
- Node.js (v18+) & Angular CLI
- MySQL 8.0+ (if running locally without Docker)
- Clone the repository:
git clone https://github.com/yourusername/vital-nexus.git cd vital-nexus - Build and start the backend infrastructure:
Note: Ensure port 3306 is free for MySQL. The API Gateway will be available at
docker-compose up -d --build
http://localhost:8083.
- Navigate to the frontend directory:
cd VitalNexus-Frontend-dev - Install dependencies and start the dev server:
npm install npm start
- Open your browser and navigate to
http://localhost:4200.
All inter-service communication requiring authorization implements Token Propagation using custom Feign Interceptors, ensuring the initial JWT Bearer token is seamlessly passed downstream from the Gateway.