Skip to content

MariaBrodowska/MediPath

 
 

Repository files navigation

MediPath

MediPath is a system designed to support the work of a small healthcare facility by streamlining appointment management and providing patient‑friendly tools such as reminders and reviews. The project consists of a web application, a mobile application and a backend REST API with a shared database.

The work includes market research, system design, implementation and testing. The design phase covers functional and non‑functional requirements, BPMN/use‑case/activity diagrams, database design and UI mockups. The implementation delivers a full stack system with role‑based access and multiple modules supporting daily operations.

The solution targets two primary user groups: medical staff who manage institutions and schedules and patients who browse specialists, book appointments, track health‑related tasks. The mobile app provides quick access for daily workflows, while the web app offers broader administration capabilities.

Key Features

  • Role‑based access (patient, doctor, staff, administrator)
  • Appointment booking and visit management
  • Institution and doctor management (admin/staff)
  • Schedules and availability management
  • Reminders and notifications (mobile)
  • Reviews and ratings after visits
  • Password reset workflow

User Roles

  • Patient: browse doctors/institutions, book visits, manage reminders, submit reviews
  • Doctor: manage visits, view schedules, complete appointments
  • Staff: manage schedules and operational data for institutions
  • Administrator: full management of institutions, doctors, and system data

Architecture

The system is composed of:

  • Web client for administrators, staff, doctors, and patients
  • Mobile client focused on patient/doctor workflows
  • Backend REST API handling authentication, business logic and data access
  • MongoDB

The backend exposes a REST API consumed by both the web and mobile clients. Authentication and authorization are enforced on the server, while the clients implement role‑based routing and guarded modules.

Modules Overview

  • Authentication & Authorization: login, session handling, role checks
  • Appointments & Visits: booking, visit lifecycle, status updates
  • Scheduling: time slot creation and availability management
  • Institutions & Doctors: CRUD management for admin/staff roles
  • Medical History: storing visit notes and patient history
  • Notifications: reminder creation and delivery
  • Reviews: post‑visit feedback for doctors and institutions

Technology Stack

  • Frontend (Web): Angular, TypeScript
  • Mobile: Kotlin, Jetpack Compose, MVVM
  • Backend: Java, Spring Boot
  • Database: MongoDB (document‑oriented)
  • Communication: REST API (mobile uses Retrofit)
  • Infrastructure: Docker / Docker Compose

Core Modules

  • Authentication and authorization
  • Password reset workflow
  • Notifications and reminders
  • Visit management and scheduling
  • Reviews and ratings
  • Medical history management
  • Institution and doctor management

Testing

  • Manual test scenarios for web and mobile flows
  • Automated tests including unit, integration and UI tests

The test suite validates typical user journeys such as registration, scheduling, reminder creation, visit completion and verifies backend data consistency through integration tests.

Web Application Highlights

  • Admin/staff panels for managing institutions, doctors and schedules
  • Patient‑facing browsing and appointment booking
  • Role‑based access control across modules

Mobile Application Highlights

  • Patient and doctor focused flows
  • Reminders and notification channel integration
  • Visit details, completion and review workflows

Repository Structure

  • backend/ — Spring Boot backend
  • frontend/ — Angular web client
  • mobile/ — Android mobile client

Web App Screens (selected)

Mobile App Screens (selected)

Authors

About

Engineering thesis project delivering a multi‑platform healthcare facility management system focused on appointments, reminders and reviews.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Kotlin 39.7%
  • TypeScript 26.6%
  • Java 13.3%
  • SCSS 9.9%
  • HTML 9.2%
  • JavaScript 1.3%