# ella-lind/fullstack architecture

> Architecture diagram of the GitHub repository ella-lind/fullstack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ella-lind/fullstack
- Repository: https://github.com/ella-lind/fullstack

## Overview

This is a healthcare journal application: patients and practitioners access patient information and clinical journals, while users can also exchange messages. The clearest end-to-end path is the routed patient view assembling journal information from backend services; practitioner encounter, condition, and observation workflows are distinct journal stages. Messaging and JWT-based authentication are additional capabilities. Relationships are limited to those shown in excerpts or the source index; frontend-to-backend wiring and unsampled persistence details are not verified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/ella-lind/fullstack/blob/main/frontend/src/App.jsx) (Route and role views), [`backend/src/main/java/com/journalApp/service/PatientService.java`](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/PatientService.java) (Journal assembly and access), [`backend/src/main/java/com/journalApp/repository`](https://github.com/ella-lind/fullstack/tree/main/backend/src/main/java/com/journalApp/repository) (Clinical repositories), [`frontend/src/pages/PatientPage.tsx`](https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/PatientPage.tsx) (Patient journal view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_webapp["Route and role views<br/>[App.jsx]"]
  node_patientview["Patient journal view<br/>[PatientPage.tsx]"]
  node_messageview["Message workspace<br/>[MessagePage.tsx]"]
  node_authview["Login and registration<br/>[LoginPage.tsx]"]
end

subgraph group_access["Identity and access"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
end

subgraph group_journal["Clinical journal"]
  node_patientcontroller["Patient endpoints"]
  node_patientservice["Journal assembly and access"]
  node_encounterservice["Encounter management"]
  node_conditionservice["Condition management"]
  node_observationservice["Observation management"]
  node_clinicalrepos["Clinical repositories"]
  node_patientdata[("Patient and practitioner records<br/>[Patients.java]")]
end

subgraph group_messaging["Messaging"]
  node_messagecontroller["Message endpoints"]
  node_messageservice["Message and thread service"]
  node_messagerepos["Message repositories"]
  node_messagedata[("Message and thread records<br/>[MessageThread.java]")]
end

node_user(("Patient or staff"))

node_user -->|"opens views"| node_webapp
node_webapp -->|"routes to"| node_patientview
node_webapp -->|"routes to"| node_messageview
node_webapp -->|"routes to"| node_authview
node_patientview -.->|"requests journal"| node_patientcontroller
node_patientcontroller -->|"delegates to"| node_patientservice
node_patientservice -->|"loads encounters"| node_encounterservice
node_patientservice -->|"loads conditions"| node_conditionservice
node_patientservice -->|"loads observations"| node_observationservice
node_encounterservice -->|"queries and saves"| node_clinicalrepos
node_conditionservice -->|"queries and saves"| node_clinicalrepos
node_observationservice -->|"queries and saves"| node_clinicalrepos
node_clinicalrepos -->|"maps records"| node_patientdata
node_messageview -.->|"calls API"| node_messagecontroller
node_messagecontroller -->|"delegates to"| node_messageservice
node_messageservice -.->|"queries and saves"| node_messagerepos
node_messagerepos -->|"maps records"| node_messagedata
node_authview -.->|"authenticates"| node_authservice
node_authservice -->|"issues token"| node_jwt

click node_webapp "https://github.com/ella-lind/fullstack/blob/main/frontend/src/App.jsx"
click node_patientview "https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/PatientPage.tsx"
click node_messageview "https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/MessagePage.tsx"
click node_authview "https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/LoginPage.tsx"
click node_authservice "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/AuthService.java"
click node_jwt "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/security/JwtService.java"
click node_patientcontroller "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/controller/PatientController.java"
click node_patientservice "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/PatientService.java"
click node_encounterservice "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/EncounterService.java"
click node_conditionservice "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/ConditionService.java"
click node_observationservice "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/ObservationService.java"
click node_clinicalrepos "https://github.com/ella-lind/fullstack/tree/main/backend/src/main/java/com/journalApp/repository"
click node_patientdata "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/entity/Patients.java"
click node_messagecontroller "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/controller/MessageController.java"
click node_messageservice "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/MessageService.java"
click node_messagerepos "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/repository/MessageRepository.java"
click node_messagedata "https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/entity/MessageThread.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_webapp,node_patientview,node_messageview,node_authview toneBlue
class node_authservice,node_jwt toneAmber
class node_patientcontroller,node_patientservice,node_encounterservice,node_conditionservice,node_observationservice,node_clinicalrepos,node_patientdata toneMint
class node_messagecontroller,node_messageservice,node_messagerepos,node_messagedata toneRose
class node_user toneIndigo
```

## Components

### Web experience

- [Route and role views](https://github.com/ella-lind/fullstack/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Patient journal view](https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/PatientPage.tsx): `frontend/src/pages/PatientPage.tsx`
- [Message workspace](https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/MessagePage.tsx): `frontend/src/pages/MessagePage.tsx`
- [Login and registration](https://github.com/ella-lind/fullstack/blob/main/frontend/src/pages/LoginPage.tsx): `frontend/src/pages/LoginPage.tsx`

### Identity and access

- [Authentication service](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/AuthService.java): `backend/src/main/java/com/journalApp/service/AuthService.java`
- [JWT service](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/security/JwtService.java): `backend/src/main/java/com/journalApp/security/JwtService.java`

### Clinical journal

- [Patient endpoints](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/controller/PatientController.java): `backend/src/main/java/com/journalApp/controller/PatientController.java`
- [Journal assembly and access](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/PatientService.java): `backend/src/main/java/com/journalApp/service/PatientService.java`
- [Encounter management](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/EncounterService.java): `backend/src/main/java/com/journalApp/service/EncounterService.java`
- [Condition management](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/ConditionService.java): `backend/src/main/java/com/journalApp/service/ConditionService.java`
- [Observation management](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/ObservationService.java): `backend/src/main/java/com/journalApp/service/ObservationService.java`
- [Clinical repositories](https://github.com/ella-lind/fullstack/tree/main/backend/src/main/java/com/journalApp/repository): `backend/src/main/java/com/journalApp/repository`
- [Patient and practitioner records](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/entity/Patients.java): `backend/src/main/java/com/journalApp/entity/Patients.java`

### Messaging

- [Message endpoints](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/controller/MessageController.java): `backend/src/main/java/com/journalApp/controller/MessageController.java`
- [Message and thread service](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/service/MessageService.java): `backend/src/main/java/com/journalApp/service/MessageService.java`
- [Message repositories](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/repository/MessageRepository.java): `backend/src/main/java/com/journalApp/repository/MessageRepository.java`
- [Message and thread records](https://github.com/ella-lind/fullstack/blob/main/backend/src/main/java/com/journalApp/entity/MessageThread.java): `backend/src/main/java/com/journalApp/entity/MessageThread.java`

### Other components

- **Patient or staff**

## Connections

- Patient or staff → Route and role views: opens views (evidence: `frontend/src/App.jsx`)
- Route and role views → Patient journal view: routes to (evidence: `frontend/src/App.jsx`)
- Route and role views → Message workspace: routes to (evidence: `frontend/src/App.jsx`)
- Route and role views → Login and registration: routes to (evidence: `frontend/src/App.jsx`)
- Patient journal view → Patient endpoints: requests journal
- Patient endpoints → Journal assembly and access: delegates to (evidence: `backend/src/main/java/com/journalApp/controller/PatientController.java`)
- Journal assembly and access → Encounter management: loads encounters (evidence: `backend/src/main/java/com/journalApp/service/PatientService.java`)
- Journal assembly and access → Condition management: loads conditions (evidence: `backend/src/main/java/com/journalApp/service/PatientService.java`)
- Journal assembly and access → Observation management: loads observations (evidence: `backend/src/main/java/com/journalApp/service/PatientService.java`)
- Encounter management → Clinical repositories: queries and saves (evidence: `backend/src/main/java/com/journalApp/service/EncounterService.java`)
- Condition management → Clinical repositories: queries and saves (evidence: `backend/src/main/java/com/journalApp/service/ConditionService.java`)
- Observation management → Clinical repositories: queries and saves (evidence: `backend/src/main/java/com/journalApp/service/ObservationService.java`)
- Clinical repositories → Patient and practitioner records: maps records (evidence: `backend/src/main/java/com/journalApp/repository/EncounterRepository.java`)
- Message workspace → Message endpoints: calls API
- Message endpoints → Message and thread service: delegates to (evidence: `backend/src/main/java/com/journalApp/controller/MessageController.java`)
- Message and thread service → Message repositories: queries and saves (evidence: `backend/src/main/java/com/journalApp/service/MessageService.java`)
- Message repositories → Message and thread records: maps records
- Login and registration → Authentication service: authenticates
- Authentication service → JWT service: issues token (evidence: `backend/src/main/java/com/journalApp/service/AuthService.java`)
