# yorduam/rehab-monitor-system architecture

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

- Interactive diagram: https://gitdiagram.com/yorduam/rehab-monitor-system
- Repository: https://github.com/yorduam/rehab-monitor-system

## Overview

Rehab Monitor is a web application for managing rehabilitation recipients and their care: users authenticate, navigate operational views, and work with recipients, groups, diagnostics, programs, timelines, documents, and progress. The Vue client calls a versioned Express API backed by Sequelize/MySQL. The main entry points, auth flow, recipient data model, server route mounts, and several model/service relationships are evidenced in the excerpts or SOURCE INDEX. Client-to-server HTTP calls and service-to-route dispatch are not directly shown, so those links are omitted or marked unverified.

Main entry points: [`src/App.vue`](https://github.com/yorduam/rehab-monitor-system/blob/main/src/App.vue) (App shell), [`server.js`](https://github.com/yorduam/rehab-monitor-system/blob/main/server.js) (HTTP server), [`src/api.js`](https://github.com/yorduam/rehab-monitor-system/blob/main/src/api.js) (API client), [`models/Recipient.js`](https://github.com/yorduam/rehab-monitor-system/blob/main/models/Recipient.js) (Recipient records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App shell<br/>[App.vue]"]
  node_authstore["Auth state<br/>[auth.js]"]
  node_pagestore["Page state<br/>[page.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_recipient_ui["Recipient management<br/>[Recipients.vue]"]
  node_recipient_wizard["Recipient wizard"]
  node_recipient_detail["Recipient details"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.vue]"]
  node_diagnostics_ui["Diagnostics<br/>[Diagnostics.vue]"]
  node_groups_ui["Groups<br/>[Groups.vue]"]
  node_programs_ui["Programs<br/>[Programs.vue]"]
  node_timeline_ui["Timeline<br/>[Timeline.vue]"]
  node_documents_ui["Documents<br/>[Documents.vue]"]
  node_progress_ui["Progress<br/>[Progress.vue]"]
end

subgraph group_api["API and access"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth["Authentication<br/>[auth.js]"]
end

subgraph group_care["Care workflows"]
  node_recipients["Recipient API<br/>[recipients.js]"]
  node_groups["Group API<br/>[groups.js]"]
  node_diagnostics["Diagnostic API<br/>[diagnostics.js]"]
  node_programs["Program API<br/>[programs.js]"]
  node_timeline["Timeline API<br/>[timeline.js]"]
  node_documents["Document API<br/>[documents.js]"]
  node_dashboard["Dashboard API<br/>[dashboard.js]"]
  node_recipient_service["Recipient service"]
  node_diagnostic_service["Diagnostic service"]
end

subgraph group_data["Persistence"]
  node_recipient_model[("Recipient records<br/>[Recipient.js]")]
  node_user_model[("User records<br/>[User.js]")]
  node_group_model[("Group records<br/>[Group.js]")]
  node_diagnostic_model[("Diagnostic records<br/>[Diagnostic.js]")]
  node_timeline_model[("Timeline records<br/>[TimelineEvent.js]")]
  node_database[("MySQL connection<br/>[database.js]")]
end

node_user(("Staff or recipient"))

node_user -->|"uses"| node_app
node_app -->|"checks auth"| node_authstore
node_app -->|"selects page"| node_pagestore
node_app -->|"renders"| node_recipient_ui
node_app -->|"renders"| node_dashboard_ui
node_app -->|"renders"| node_diagnostics_ui
node_app -->|"renders"| node_groups_ui
node_app -->|"renders"| node_programs_ui
node_app -->|"renders"| node_timeline_ui
node_app -->|"renders"| node_documents_ui
node_app -->|"renders"| node_progress_ui
node_app -->|"renders"| node_recipient_detail
node_authstore -->|"sends requests"| node_api_client
node_recipient_ui -->|"uses"| node_api_client
node_recipient_ui -->|"uses"| node_recipient_wizard
node_recipient_detail -->|"uses"| node_api_client
node_dashboard_ui -->|"uses"| node_api_client
node_diagnostics_ui -->|"uses"| node_api_client
node_timeline_ui -->|"uses"| node_api_client
node_api_client -.->|"HTTP requests"| node_server
node_server -->|"mounts"| node_auth
node_server -->|"mounts"| node_recipients
node_server -->|"mounts"| node_groups
node_server -->|"mounts"| node_diagnostics
node_server -->|"mounts"| node_programs
node_server -->|"mounts"| node_timeline
node_server -->|"mounts"| node_documents
node_server -->|"mounts"| node_dashboard
node_auth -->|"queries user"| node_user_model
node_recipients -->|"uses records"| node_recipient_model
node_groups -->|"uses records"| node_group_model
node_diagnostics -->|"uses records"| node_diagnostic_model
node_diagnostics -->|"uses records"| node_timeline_model
node_dashboard -->|"queries records"| node_recipient_model
node_dashboard -->|"queries records"| node_group_model
node_dashboard -->|"queries records"| node_diagnostic_model
node_recipient_service -->|"uses records"| node_recipient_model
node_diagnostic_service -->|"uses records"| node_diagnostic_model
node_diagnostic_service -->|"uses records"| node_timeline_model
node_recipient_model -->|"defines table"| node_database
node_user_model -->|"defines table"| node_database
node_group_model -->|"defines table"| node_database
node_diagnostic_model -->|"defines table"| node_database
node_timeline_model -->|"defines table"| node_database
node_recipient_model -->|"belongs to"| node_group_model
node_timeline_model -->|"belongs to"| node_recipient_model
node_timeline_model -->|"belongs to"| node_group_model

click node_app "https://github.com/yorduam/rehab-monitor-system/blob/main/src/App.vue"
click node_authstore "https://github.com/yorduam/rehab-monitor-system/blob/main/src/stores/auth.js"
click node_pagestore "https://github.com/yorduam/rehab-monitor-system/blob/main/src/stores/page.js"
click node_api_client "https://github.com/yorduam/rehab-monitor-system/blob/main/src/api.js"
click node_recipient_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Recipients.vue"
click node_recipient_wizard "https://github.com/yorduam/rehab-monitor-system/blob/main/src/components/AddRecipientWizard.vue"
click node_recipient_detail "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/RecipientDetails.vue"
click node_dashboard_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Dashboard.vue"
click node_diagnostics_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Diagnostics.vue"
click node_groups_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Groups.vue"
click node_programs_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Programs.vue"
click node_timeline_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Timeline.vue"
click node_documents_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Documents.vue"
click node_progress_ui "https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Progress.vue"
click node_server "https://github.com/yorduam/rehab-monitor-system/blob/main/server.js"
click node_auth "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/auth.js"
click node_recipients "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/recipients.js"
click node_groups "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/groups.js"
click node_diagnostics "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/diagnostics.js"
click node_programs "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/programs.js"
click node_timeline "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/timeline.js"
click node_documents "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/documents.js"
click node_dashboard "https://github.com/yorduam/rehab-monitor-system/blob/main/routes/dashboard.js"
click node_recipient_service "https://github.com/yorduam/rehab-monitor-system/blob/main/services/recipientService.js"
click node_diagnostic_service "https://github.com/yorduam/rehab-monitor-system/blob/main/services/diagnosticService.js"
click node_recipient_model "https://github.com/yorduam/rehab-monitor-system/blob/main/models/Recipient.js"
click node_user_model "https://github.com/yorduam/rehab-monitor-system/blob/main/models/User.js"
click node_group_model "https://github.com/yorduam/rehab-monitor-system/blob/main/models/Group.js"
click node_diagnostic_model "https://github.com/yorduam/rehab-monitor-system/blob/main/models/Diagnostic.js"
click node_timeline_model "https://github.com/yorduam/rehab-monitor-system/blob/main/models/TimelineEvent.js"
click node_database "https://github.com/yorduam/rehab-monitor-system/blob/main/config/database.js"

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_app,node_authstore,node_pagestore,node_api_client,node_recipient_ui,node_recipient_wizard,node_recipient_detail,node_dashboard_ui,node_diagnostics_ui,node_groups_ui,node_programs_ui,node_timeline_ui,node_documents_ui,node_progress_ui toneBlue
class node_server,node_auth toneAmber
class node_recipients,node_groups,node_diagnostics,node_programs,node_timeline,node_documents,node_dashboard,node_recipient_service,node_diagnostic_service toneMint
class node_recipient_model,node_user_model,node_group_model,node_diagnostic_model,node_timeline_model,node_database toneRose
class node_user toneIndigo
```

## Components

### Web client

- [App shell](https://github.com/yorduam/rehab-monitor-system/blob/main/src/App.vue): `src/App.vue`
- [Auth state](https://github.com/yorduam/rehab-monitor-system/blob/main/src/stores/auth.js): `src/stores/auth.js`
- [Page state](https://github.com/yorduam/rehab-monitor-system/blob/main/src/stores/page.js): `src/stores/page.js`
- [API client](https://github.com/yorduam/rehab-monitor-system/blob/main/src/api.js): `src/api.js`
- [Recipient management](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Recipients.vue): `src/views/Recipients.vue`
- [Recipient wizard](https://github.com/yorduam/rehab-monitor-system/blob/main/src/components/AddRecipientWizard.vue): `src/components/AddRecipientWizard.vue`
- [Recipient details](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/RecipientDetails.vue): `src/views/RecipientDetails.vue`
- [Dashboard](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Dashboard.vue): `src/views/Dashboard.vue`
- [Diagnostics](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Diagnostics.vue): `src/views/Diagnostics.vue`
- [Groups](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Groups.vue): `src/views/Groups.vue`
- [Programs](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Programs.vue): `src/views/Programs.vue`
- [Timeline](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Timeline.vue): `src/views/Timeline.vue`
- [Documents](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Documents.vue): `src/views/Documents.vue`
- [Progress](https://github.com/yorduam/rehab-monitor-system/blob/main/src/views/Progress.vue): `src/views/Progress.vue`

### API and access

- [HTTP server](https://github.com/yorduam/rehab-monitor-system/blob/main/server.js): `server.js`
- [Authentication](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/auth.js): `routes/auth.js`

### Care workflows

- [Recipient API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/recipients.js): `routes/recipients.js`
- [Group API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/groups.js): `routes/groups.js`
- [Diagnostic API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/diagnostics.js): `routes/diagnostics.js`
- [Program API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/programs.js): `routes/programs.js`
- [Timeline API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/timeline.js): `routes/timeline.js`
- [Document API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/documents.js): `routes/documents.js`
- [Dashboard API](https://github.com/yorduam/rehab-monitor-system/blob/main/routes/dashboard.js): `routes/dashboard.js`
- [Recipient service](https://github.com/yorduam/rehab-monitor-system/blob/main/services/recipientService.js): `services/recipientService.js`
- [Diagnostic service](https://github.com/yorduam/rehab-monitor-system/blob/main/services/diagnosticService.js): `services/diagnosticService.js`

### Persistence

- [Recipient records](https://github.com/yorduam/rehab-monitor-system/blob/main/models/Recipient.js): `models/Recipient.js`
- [User records](https://github.com/yorduam/rehab-monitor-system/blob/main/models/User.js): `models/User.js`
- [Group records](https://github.com/yorduam/rehab-monitor-system/blob/main/models/Group.js): `models/Group.js`
- [Diagnostic records](https://github.com/yorduam/rehab-monitor-system/blob/main/models/Diagnostic.js): `models/Diagnostic.js`
- [Timeline records](https://github.com/yorduam/rehab-monitor-system/blob/main/models/TimelineEvent.js): `models/TimelineEvent.js`
- [MySQL connection](https://github.com/yorduam/rehab-monitor-system/blob/main/config/database.js): `config/database.js`

### Other components

- **Staff or recipient**

## Connections

- Staff or recipient → App shell: uses
- App shell → Auth state: checks auth (evidence: `src/App.vue`)
- App shell → Page state: selects page (evidence: `src/App.vue`)
- App shell → Recipient management: renders (evidence: `src/App.vue`)
- App shell → Dashboard: renders (evidence: `src/App.vue`)
- App shell → Diagnostics: renders (evidence: `src/App.vue`)
- App shell → Groups: renders (evidence: `src/App.vue`)
- App shell → Programs: renders (evidence: `src/App.vue`)
- App shell → Timeline: renders (evidence: `src/App.vue`)
- App shell → Documents: renders (evidence: `src/App.vue`)
- App shell → Progress: renders (evidence: `src/App.vue`)
- App shell → Recipient details: renders (evidence: `src/App.vue`)
- Auth state → API client: sends requests (evidence: `src/stores/auth.js`)
- Recipient management → API client: uses (evidence: `src/views/Recipients.vue`)
- Recipient management → Recipient wizard: uses (evidence: `src/views/Recipients.vue`)
- Recipient details → API client: uses (evidence: `src/views/RecipientDetails.vue`)
- Dashboard → API client: uses (evidence: `src/views/Dashboard.vue`)
- Diagnostics → API client: uses (evidence: `src/views/Diagnostics.vue`)
- Timeline → API client: uses (evidence: `src/views/Timeline.vue`)
- API client → HTTP server: HTTP requests
- HTTP server → Authentication: mounts (evidence: `server.js`)
- HTTP server → Recipient API: mounts (evidence: `server.js`)
- HTTP server → Group API: mounts (evidence: `server.js`)
- HTTP server → Diagnostic API: mounts (evidence: `server.js`)
- HTTP server → Program API: mounts (evidence: `server.js`)
- HTTP server → Timeline API: mounts (evidence: `server.js`)
- HTTP server → Document API: mounts (evidence: `server.js`)
- HTTP server → Dashboard API: mounts (evidence: `server.js`)
- Authentication → User records: queries user (evidence: `routes/auth.js`)
- Recipient API → Recipient records: uses records (evidence: `routes/recipients.js`)
- Group API → Group records: uses records (evidence: `routes/groups.js`)
- Diagnostic API → Diagnostic records: uses records (evidence: `routes/diagnostics.js`)
- Diagnostic API → Timeline records: uses records (evidence: `routes/diagnostics.js`)
- Dashboard API → Recipient records: queries records (evidence: `routes/dashboard.js`)
- Dashboard API → Group records: queries records (evidence: `routes/dashboard.js`)
- Dashboard API → Diagnostic records: queries records (evidence: `routes/dashboard.js`)
- Recipient service → Recipient records: uses records (evidence: `services/recipientService.js`)
- Diagnostic service → Diagnostic records: uses records (evidence: `services/diagnosticService.js`)
- Diagnostic service → Timeline records: uses records (evidence: `services/diagnosticService.js`)
- Recipient records → MySQL connection: defines table (evidence: `models/Recipient.js`)
- User records → MySQL connection: defines table (evidence: `models/User.js`)
- Group records → MySQL connection: defines table (evidence: `models/Group.js`)
- Diagnostic records → MySQL connection: defines table (evidence: `models/Diagnostic.js`)
- Timeline records → MySQL connection: defines table (evidence: `models/TimelineEvent.js`)
- Recipient records → Group records: belongs to (evidence: `models/Recipient.js`)
- Timeline records → Recipient records: belongs to (evidence: `models/TimelineEvent.js`)
- Timeline records → Group records: belongs to (evidence: `models/TimelineEvent.js`)
