🫘 pediNephro

A comprehensive Pediatric Nephrology Information System built with a microservices architecture

pediNephro is a specialized healthcare information system designed to support pediatric nephrology departments in managing the full care continuum — from patient registration and diagnostic assessments to post-transplant follow-up and inter-departmental coordination.

The platform centralizes clinical workflows, streamlines communication between care teams, and provides real-time dashboards to support data-driven decision-making in pediatric kidney care.

The system is organized into 10 functional modules:

• Angular — Single-page application framework for building the user interface
• Angular Router — Client-side navigation and routing between modules
• Angular HttpClient — REST API communication with backend microservices
• Bootstrap / Angular Material — UI component library and responsive design

• Spring Boot — Core framework for each microservice
• Spring Security + JWT — Authentication and role-based access control
• Spring Data JPA + Hibernate — ORM for database interactions
• Spring Cloud Netflix Eureka — Service discovery and registration
• Spring Cloud Gateway — API Gateway for routing, load balancing, and cross-cutting concerns
• MySQL / PostgreSQL — Relational database per microservice
• Maven — Dependency management and build tool

pediNephro follows a microservices architecture where each functional module is deployed as an independent service.

 ┌─────────────────────┐
 │ Angular Frontend │
 └────────┬────────────┘
 │ HTTP / REST
 ┌────────▼────────────┐
 │ API Gateway │
 │ (Spring Cloud GW) │
 └────────┬────────────┘
 │
 ┌──────────────────┼──────────────────┐
 │ │ │
 ┌──────────▼──────┐ ┌───────▼──────┐ ┌───────▼──────┐
 │ Auth Service │ │ Patient Svc │ │ Lab Service │
 │ (Module 1) │ │ (Module 2) │ │ (Module 3) │
 └─────────────────┘ └─────────────┘ └──────────────┘
 │ │ │
 ┌──────────▼──────┐ ┌───────▼──────┐ ┌───────▼──────┐
 │ Treatment Svc │ │Hospital Svc │ │ Imaging Svc │
 │ (Module 4) │ │ (Module 5) │ │ (Module 6) │
 └─────────────────┘ └─────────────┘ └──────────────┘
 │ │ │
 ┌──────────▼──────┐ ┌───────▼──────┐ ┌───────▼──────┐
 │ Vitals Svc │ │Transplant Svc│ │ Coord. Svc │
 │ (Module 7) │ │ (Module 8) │ │ (Module 9) │
 └─────────────────┘ └─────────────┘ └──────────────┘
 │
 ┌────────▼────────────┐
 │ Analytics Svc │
 │ (Module 10) │
 └─────────────────────┘
 │
 ┌────────▼────────────┐
 │ Eureka Server │
 │ (Service Discovery) │
 └─────────────────────┘

Each microservice:

• Runs independently on its own port
• Registers with the Eureka Discovery Server
• Is exposed to the frontend exclusively through the API Gateway
• Manages its own database schema

📝 Contributors: please update this table with your full names and GitHub profiles.

This project was developed as part of the Software Engineering curriculum at:

🎓 ESPRIT — École Supérieure Privée d'Ingénierie et de Technologies Ariana, Tunisia

It was realized as an end-of-semester engineering project, applying enterprise-grade software architecture patterns in a real-world healthcare domain. The project demonstrates proficiency in distributed systems design, RESTful API development, and modern frontend engineering.

Make sure the following are installed on your machine:

• Java 17+
• Node.js 18+ & npm
• Angular CLI (npm install -g @angular/cli)
• Maven 3.8+
• MySQL or PostgreSQL
• Git

git clone https://github.com/pediNephro/[repoName].git
cd [repoName]

cd eureka-server
mvn spring-boot:run

Eureka dashboard available at: http://localhost:8761

cd api-gateway
mvn spring-boot:run

Gateway runs on: http://localhost:8080

Each module is a standalone Spring Boot application. Navigate to each service directory and run:

mvn spring-boot:run

Ensure each service has its database configured in application.properties or application.yml.

cd frontend
npm install
ng serve

Frontend available at: http://localhost:4200

• ESPRIT School of Engineering for providing the academic framework and resources
• The Spring Cloud and Angular open-source communities
• Our supervising professors and project coordinators for their guidance throughout the development cycle

Made with ❤️ by the pediNephro team · ESPRIT · 2024–2025