# rebeccaguim/medilabo-solutions architecture

> Architecture diagram of the GitHub repository rebeccaguim/medilabo-solutions, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rebeccaguim/medilabo-solutions
- Repository: https://github.com/rebeccaguim/medilabo-solutions

## Overview

MediLabo is a clinician-facing application for maintaining patient records and notes and displaying diabetes-risk assessments. The main workflow is a doctor viewing a patient in the front end, which requests patient details, notes, and risk through the JWT-protected gateway; risk assessment fetches the patient and notes from their respective services before applying age-, gender-, and trigger-term thresholds. The README documents this service topology and storage split; excerpts confirm front-end and patient-service calls and risk calculation. Gateway routing and risk-service REST client details are not shown in source excerpts, so those documented links use the README as evidence.

Main entry points: [`gateway-service/src/main/java/com/medilabo/gateway_service/security/SecurityConfig.java`](https://github.com/rebeccaguim/medilabo-solutions/blob/main/gateway-service/src/main/java/com/medilabo/gateway_service/security/SecurityConfig.java) (JWT gateway), [`front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java`](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java) (Patient pages), [`front-service/src/main/java/com/medilabo/front_service/security/JwtService.java`](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/security/JwtService.java) (JWT generation), [`front-service/src/main/java/com/medilabo/front_service/service/PatientService.java`](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/PatientService.java) (Patient API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Clinician interface"]
  node_home["Patient pages"]
  node_front_auth["Login and JWT"]
  node_jwt["JWT generation<br/>[JwtService.java]"]
  node_front_patient["Patient API client"]
  node_front_note["Notes API client<br/>[NoteService.java]"]
  node_front_risk["Risk API client<br/>[RiskService.java]"]
end

subgraph group_edge["API access"]
  node_gateway["JWT gateway"]
end

subgraph group_records["Patient records"]
  node_patient_controller["Patient endpoints"]
  node_patient_service["Patient operations"]
  node_patient_repo["Patient repository"]
  node_mysql[("MySQL patient store")]
end

subgraph group_notes["Medical notes"]
  node_note_controller["Note endpoints"]
  node_note_service["Note operations<br/>[NoteService.java]"]
  node_note_repo["Note repository"]
  node_mongo[("MongoDB notes")]
end

subgraph group_assessment["Risk assessment"]
  node_risk_controller["Risk endpoint"]
  node_risk_service["Risk rules<br/>[RiskService.java]"]
  node_risk_patient_client["Patient REST client"]
  node_risk_note_client["Notes REST client<br/>[NoteService.java]"]
end

node_doctor(("Doctor"))

node_doctor -->|"uses"| node_home
node_doctor -->|"authenticates"| node_front_auth
node_front_auth -->|"creates token"| node_jwt
node_home -->|"requests records"| node_front_patient
node_home -->|"requests notes"| node_front_note
node_home -->|"requests assessment"| node_front_risk
node_front_patient -->|"generates bearer token"| node_jwt
node_front_note -->|"generates bearer token"| node_jwt
node_front_risk -->|"generates bearer token"| node_jwt
node_front_patient -->|"REST requests"| node_gateway
node_front_note -->|"REST requests"| node_gateway
node_front_risk -->|"REST requests"| node_gateway
node_gateway -->|"routes requests"| node_patient_controller
node_gateway -->|"routes requests"| node_note_controller
node_gateway -->|"routes requests"| node_risk_controller
node_patient_controller -->|"delegates"| node_patient_service
node_patient_service -->|"reads and writes"| node_patient_repo
node_patient_repo -->|"persists records"| node_mysql
node_note_controller -->|"delegates"| node_note_service
node_note_service -->|"reads and writes"| node_note_repo
node_note_repo -->|"persists notes"| node_mongo
node_risk_controller -->|"delegates"| node_risk_service
node_risk_service -->|"loads patient"| node_risk_patient_client
node_risk_service -->|"loads notes"| node_risk_note_client
node_risk_patient_client -->|"fetches patient REST"| node_patient_controller
node_risk_note_client -->|"fetches notes REST"| node_note_controller

click node_home "https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java"
click node_front_auth "https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/controller/AuthController.java"
click node_jwt "https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/security/JwtService.java"
click node_front_patient "https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/PatientService.java"
click node_front_note "https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/NoteService.java"
click node_front_risk "https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/RiskService.java"
click node_gateway "https://github.com/rebeccaguim/medilabo-solutions/blob/main/gateway-service/src/main/java/com/medilabo/gateway_service/security/SecurityConfig.java"
click node_patient_controller "https://github.com/rebeccaguim/medilabo-solutions/blob/main/patient-service/src/main/java/com/medilabo/patient_service/controller/PatientController.java"
click node_patient_service "https://github.com/rebeccaguim/medilabo-solutions/blob/main/patient-service/src/main/java/com/medilabo/patient_service/service/PatientService.java"
click node_patient_repo "https://github.com/rebeccaguim/medilabo-solutions/blob/main/patient-service/src/main/java/com/medilabo/patient_service/repository/PatientRepository.java"
click node_note_controller "https://github.com/rebeccaguim/medilabo-solutions/blob/main/notes-service/src/main/java/com/medilabo/notes_service/controller/NoteController.java"
click node_note_service "https://github.com/rebeccaguim/medilabo-solutions/blob/main/notes-service/src/main/java/com/medilabo/notes_service/service/NoteService.java"
click node_note_repo "https://github.com/rebeccaguim/medilabo-solutions/blob/main/notes-service/src/main/java/com/medilabo/notes_service/repository/NoteRepository.java"
click node_risk_controller "https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/controller/RiskController.java"
click node_risk_service "https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/service/RiskService.java"
click node_risk_patient_client "https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/service/PatientService.java"
click node_risk_note_client "https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/service/NoteService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_front_auth,node_jwt,node_front_patient,node_front_note,node_front_risk toneBlue
class node_gateway toneAmber
class node_patient_controller,node_patient_service,node_patient_repo,node_mysql toneMint
class node_note_controller,node_note_service,node_note_repo,node_mongo toneRose
class node_risk_controller,node_risk_service,node_risk_patient_client,node_risk_note_client,node_doctor toneIndigo
```

## Components

### Clinician interface

- [Patient pages](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java): `front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java`
- [Login and JWT](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/controller/AuthController.java): `front-service/src/main/java/com/medilabo/front_service/controller/AuthController.java`
- [JWT generation](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/security/JwtService.java): `front-service/src/main/java/com/medilabo/front_service/security/JwtService.java`
- [Patient API client](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/PatientService.java): `front-service/src/main/java/com/medilabo/front_service/service/PatientService.java`
- [Notes API client](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/NoteService.java): `front-service/src/main/java/com/medilabo/front_service/service/NoteService.java`
- [Risk API client](https://github.com/rebeccaguim/medilabo-solutions/blob/main/front-service/src/main/java/com/medilabo/front_service/service/RiskService.java): `front-service/src/main/java/com/medilabo/front_service/service/RiskService.java`

### API access

- [JWT gateway](https://github.com/rebeccaguim/medilabo-solutions/blob/main/gateway-service/src/main/java/com/medilabo/gateway_service/security/SecurityConfig.java): `gateway-service/src/main/java/com/medilabo/gateway_service/security/SecurityConfig.java`

### Patient records

- [Patient endpoints](https://github.com/rebeccaguim/medilabo-solutions/blob/main/patient-service/src/main/java/com/medilabo/patient_service/controller/PatientController.java): `patient-service/src/main/java/com/medilabo/patient_service/controller/PatientController.java`
- [Patient operations](https://github.com/rebeccaguim/medilabo-solutions/blob/main/patient-service/src/main/java/com/medilabo/patient_service/service/PatientService.java): `patient-service/src/main/java/com/medilabo/patient_service/service/PatientService.java`
- [Patient repository](https://github.com/rebeccaguim/medilabo-solutions/blob/main/patient-service/src/main/java/com/medilabo/patient_service/repository/PatientRepository.java): `patient-service/src/main/java/com/medilabo/patient_service/repository/PatientRepository.java`
- **MySQL patient store**

### Medical notes

- [Note endpoints](https://github.com/rebeccaguim/medilabo-solutions/blob/main/notes-service/src/main/java/com/medilabo/notes_service/controller/NoteController.java): `notes-service/src/main/java/com/medilabo/notes_service/controller/NoteController.java`
- [Note operations](https://github.com/rebeccaguim/medilabo-solutions/blob/main/notes-service/src/main/java/com/medilabo/notes_service/service/NoteService.java): `notes-service/src/main/java/com/medilabo/notes_service/service/NoteService.java`
- [Note repository](https://github.com/rebeccaguim/medilabo-solutions/blob/main/notes-service/src/main/java/com/medilabo/notes_service/repository/NoteRepository.java): `notes-service/src/main/java/com/medilabo/notes_service/repository/NoteRepository.java`
- **MongoDB notes**

### Risk assessment

- [Risk endpoint](https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/controller/RiskController.java): `risk-service/src/main/java/com/medilabo/risk_service/controller/RiskController.java`
- [Risk rules](https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/service/RiskService.java): `risk-service/src/main/java/com/medilabo/risk_service/service/RiskService.java`
- [Patient REST client](https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/service/PatientService.java): `risk-service/src/main/java/com/medilabo/risk_service/service/PatientService.java`
- [Notes REST client](https://github.com/rebeccaguim/medilabo-solutions/blob/main/risk-service/src/main/java/com/medilabo/risk_service/service/NoteService.java): `risk-service/src/main/java/com/medilabo/risk_service/service/NoteService.java`

### Other components

- **Doctor**

## Connections

- Doctor → Patient pages: uses (evidence: `README.md`)
- Doctor → Login and JWT: authenticates (evidence: `README.md`)
- Login and JWT → JWT generation: creates token (evidence: `front-service/src/main/java/com/medilabo/front_service/controller/AuthController.java`)
- Patient pages → Patient API client: requests records (evidence: `front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java`)
- Patient pages → Notes API client: requests notes (evidence: `front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java`)
- Patient pages → Risk API client: requests assessment (evidence: `front-service/src/main/java/com/medilabo/front_service/controller/HomeController.java`)
- Patient API client → JWT generation: generates bearer token (evidence: `front-service/src/main/java/com/medilabo/front_service/service/PatientService.java`)
- Notes API client → JWT generation: generates bearer token (evidence: `front-service/src/main/java/com/medilabo/front_service/service/NoteService.java`)
- Risk API client → JWT generation: generates bearer token (evidence: `front-service/src/main/java/com/medilabo/front_service/service/RiskService.java`)
- Patient API client → JWT gateway: REST requests (evidence: `front-service/src/main/java/com/medilabo/front_service/service/PatientService.java`)
- Notes API client → JWT gateway: REST requests (evidence: `front-service/src/main/java/com/medilabo/front_service/service/NoteService.java`)
- Risk API client → JWT gateway: REST requests (evidence: `front-service/src/main/java/com/medilabo/front_service/service/RiskService.java`)
- JWT gateway → Patient endpoints: routes requests (evidence: `README.md`)
- JWT gateway → Note endpoints: routes requests (evidence: `README.md`)
- JWT gateway → Risk endpoint: routes requests (evidence: `README.md`)
- Patient endpoints → Patient operations: delegates (evidence: `patient-service/src/main/java/com/medilabo/patient_service/controller/PatientController.java`)
- Patient operations → Patient repository: reads and writes (evidence: `patient-service/src/main/java/com/medilabo/patient_service/service/PatientService.java`)
- Patient repository → MySQL patient store: persists records (evidence: `README.md`)
- Note endpoints → Note operations: delegates (evidence: `notes-service/src/main/java/com/medilabo/notes_service/controller/NoteController.java`)
- Note operations → Note repository: reads and writes (evidence: `notes-service/src/main/java/com/medilabo/notes_service/service/NoteService.java`)
- Note repository → MongoDB notes: persists notes (evidence: `README.md`)
- Risk endpoint → Risk rules: delegates (evidence: `risk-service/src/main/java/com/medilabo/risk_service/controller/RiskController.java`)
- Risk rules → Patient REST client: loads patient (evidence: `risk-service/src/main/java/com/medilabo/risk_service/service/RiskService.java`)
- Risk rules → Notes REST client: loads notes (evidence: `risk-service/src/main/java/com/medilabo/risk_service/service/RiskService.java`)
- Patient REST client → Patient endpoints: fetches patient REST (evidence: `README.md`)
- Notes REST client → Note endpoints: fetches notes REST (evidence: `README.md`)
