Skip to content

About

A full-stack healthcare administration platform built with Angular 21 and a 12-node Spring Boot microservice architecture.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

VitalNexus: Healthcare Management Platform

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.

🚀 Tech Stack

Frontend

  • Angular 21 (Standalone Components)
  • TypeScript 5.9
  • Bootstrap 5 & SCSS
  • Lucide Icons
  • Vitest (Unit Testing)

Backend (Microservices)

  • 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)

🏗️ Architecture

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.

🛠️ Getting Started

Prerequisites

  • Docker & Docker Compose (for automated infrastructure)
  • Java 17 & Maven
  • Node.js (v18+) & Angular CLI
  • MySQL 8.0+ (if running locally without Docker)

Running with Docker Compose (Recommended)

  1. Clone the repository:
    git clone https://github.com/yourusername/vital-nexus.git
    cd vital-nexus
  2. Build and start the backend infrastructure:
    docker-compose up -d --build
    Note: Ensure port 3306 is free for MySQL. The API Gateway will be available at http://localhost:8083.

Running the Frontend

  1. Navigate to the frontend directory:
    cd VitalNexus-Frontend-dev
  2. Install dependencies and start the dev server:
    npm install
    npm start
  3. Open your browser and navigate to http://localhost:4200.

🔒 Security

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.

About

A full-stack healthcare administration platform built with Angular 21 and a 12-node Spring Boot microservice architecture.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages