# aiden-glamour/scholar-track architecture

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

- Interactive diagram: https://gitdiagram.com/aiden-glamour/scholar-track
- Repository: https://github.com/aiden-glamour/scholar-track

## Overview

This is a scholarship and student-services workflow application: students submit applications and endorsements, staff manage records and reports, directors review and transmit them, and administrators monitor exports. The React frontend routes users by role and calls a Laravel API; the backend exposes domain controllers backed by Eloquent models. Export logging and Drive-upload jobs form a separate operational branch. Several capabilities are evident from the file tree and API route index, but their internal behavior was not sampled, so those links are limited to documented routes and indexed references.

Main entry points: [`backend/routes/api.php`](https://github.com/aiden-glamour/scholar-track/blob/main/backend/routes/api.php) (API routes), [`backend/app/Http/Controllers/Api/StudentController.php`](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/StudentController.php) (Student services), [`backend/app/Http/Controllers/Api/EndorsedFormController.php`](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/EndorsedFormController.php) (Endorsed forms), [`backend/app/Http/Controllers/Api/ExportController.php`](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/ExportController.php) (Export operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role-based frontend"]
  node_webapp["Role-based routes<br/>[App.jsx]"]
  node_student_apps["Student applications<br/>[Applications.jsx]"]
  node_client["API client<br/>[axios.js]"]
end

subgraph group_api["Laravel API"]
  node_api_routes["API routes<br/>[api.php]"]
  node_student_api["Student services"]
  node_application_api["Application intake"]
  node_upload_api["Upload handling"]
  node_endorsement_api["Endorsements"]
  node_forms_api["Endorsed forms"]
  node_transmittal_api["Transmittals"]
  node_reports_api["Reports and reviews"]
end

subgraph group_records["Domain records"]
  node_application_record[("Application records<br/>[Application.php]")]
  node_student_record[("Student records<br/>[Student.php]")]
  node_upload_record[("Upload records<br/>[Upload.php]")]
  node_endorsement_record[("Endorsement records<br/>[Endorsement.php]")]
  node_form_record[("Endorsed form records<br/>[EndorsedForm.php]")]
  node_transmittal_record[("Transmittal records<br/>[Transmittal.php]")]
end

subgraph group_exports["Exports and audit"]
  node_exports_api["Export operations"]
  node_export_admin["Export log admin"]
  node_drive_job["Drive upload job<br/>[UploadToDrive.php]"]
  node_export_log[("Export audit records<br/>[ExportLog.php]")]
end

node_user(("Student or staff"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_student_apps
node_student_apps -->|"requests through"| node_client
node_client -.->|"calls API"| node_api_routes
node_api_routes -->|"routes to"| node_student_api
node_api_routes -->|"routes to"| node_application_api
node_api_routes -->|"routes to"| node_upload_api
node_api_routes -->|"routes to"| node_endorsement_api
node_api_routes -->|"routes to"| node_forms_api
node_api_routes -->|"routes to"| node_transmittal_api
node_api_routes -->|"routes to"| node_reports_api
node_api_routes -->|"routes to"| node_exports_api
node_student_api -->|"queries"| node_student_record
node_student_api -->|"queries"| node_upload_record
node_application_api -->|"uses"| node_application_record
node_endorsement_api -->|"uses"| node_endorsement_record
node_forms_api -->|"creates and updates"| node_form_record
node_forms_api -->|"creates"| node_transmittal_record
node_transmittal_api -->|"uses"| node_transmittal_record
node_reports_api -->|"uses"| node_export_log
node_exports_api -->|"uses"| node_export_log
node_exports_api -->|"dispatches"| node_drive_job
node_export_admin -->|"queries"| node_export_log
node_export_admin -->|"dispatches retry"| node_drive_job
node_application_record -->|"belongs to"| node_student_record

click node_webapp "https://github.com/aiden-glamour/scholar-track/blob/main/frontend/src/App.jsx"
click node_student_apps "https://github.com/aiden-glamour/scholar-track/blob/main/frontend/src/pages/student/Applications.jsx"
click node_client "https://github.com/aiden-glamour/scholar-track/blob/main/frontend/src/api/axios.js"
click node_api_routes "https://github.com/aiden-glamour/scholar-track/blob/main/backend/routes/api.php"
click node_student_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/StudentController.php"
click node_application_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/ApplicationController.php"
click node_upload_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/UploadController.php"
click node_endorsement_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/EndorsementController.php"
click node_forms_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/EndorsedFormController.php"
click node_transmittal_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/TransmittalController.php"
click node_reports_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/AdaReportController.php"
click node_exports_api "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/ExportController.php"
click node_export_admin "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/Admin/ExportLogController.php"
click node_drive_job "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Jobs/UploadToDrive.php"
click node_application_record "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Application.php"
click node_student_record "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Student.php"
click node_upload_record "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Upload.php"
click node_endorsement_record "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Endorsement.php"
click node_form_record "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/EndorsedForm.php"
click node_transmittal_record "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Transmittal.php"
click node_export_log "https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/ExportLog.php"

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_student_apps,node_client toneBlue
class node_api_routes,node_student_api,node_application_api,node_upload_api,node_endorsement_api,node_forms_api,node_transmittal_api,node_reports_api toneAmber
class node_application_record,node_student_record,node_upload_record,node_endorsement_record,node_form_record,node_transmittal_record toneMint
class node_exports_api,node_export_admin,node_drive_job,node_export_log toneRose
class node_user toneIndigo
```

## Components

### Role-based frontend

- [Role-based routes](https://github.com/aiden-glamour/scholar-track/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Student applications](https://github.com/aiden-glamour/scholar-track/blob/main/frontend/src/pages/student/Applications.jsx): `frontend/src/pages/student/Applications.jsx`
- [API client](https://github.com/aiden-glamour/scholar-track/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### Laravel API

- [API routes](https://github.com/aiden-glamour/scholar-track/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Student services](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/StudentController.php): `backend/app/Http/Controllers/Api/StudentController.php`
- [Application intake](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/ApplicationController.php): `backend/app/Http/Controllers/Api/ApplicationController.php`
- [Upload handling](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/UploadController.php): `backend/app/Http/Controllers/Api/UploadController.php`
- [Endorsements](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/EndorsementController.php): `backend/app/Http/Controllers/Api/EndorsementController.php`
- [Endorsed forms](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/EndorsedFormController.php): `backend/app/Http/Controllers/Api/EndorsedFormController.php`
- [Transmittals](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/TransmittalController.php): `backend/app/Http/Controllers/Api/TransmittalController.php`
- [Reports and reviews](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/AdaReportController.php): `backend/app/Http/Controllers/Api/AdaReportController.php`

### Domain records

- [Application records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Application.php): `backend/app/Models/Application.php`
- [Student records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Student.php): `backend/app/Models/Student.php`
- [Upload records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Upload.php): `backend/app/Models/Upload.php`
- [Endorsement records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Endorsement.php): `backend/app/Models/Endorsement.php`
- [Endorsed form records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/EndorsedForm.php): `backend/app/Models/EndorsedForm.php`
- [Transmittal records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/Transmittal.php): `backend/app/Models/Transmittal.php`

### Exports and audit

- [Export operations](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/ExportController.php): `backend/app/Http/Controllers/Api/ExportController.php`
- [Export log admin](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Http/Controllers/Api/Admin/ExportLogController.php): `backend/app/Http/Controllers/Api/Admin/ExportLogController.php`
- [Drive upload job](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Jobs/UploadToDrive.php): `backend/app/Jobs/UploadToDrive.php`
- [Export audit records](https://github.com/aiden-glamour/scholar-track/blob/main/backend/app/Models/ExportLog.php): `backend/app/Models/ExportLog.php`

### Other components

- **Student or staff**

## Connections

- Student or staff → Role-based routes: uses (evidence: `frontend/src/App.jsx`)
- Role-based routes → Student applications: routes to (evidence: `frontend/src/App.jsx`)
- Student applications → API client: requests through (evidence: `frontend/src/pages/student/Applications.jsx`)
- API client → API routes: calls API
- API routes → Student services: routes to (evidence: `backend/routes/api.php`)
- API routes → Application intake: routes to (evidence: `backend/routes/api.php`)
- API routes → Upload handling: routes to (evidence: `backend/routes/api.php`)
- API routes → Endorsements: routes to (evidence: `backend/routes/api.php`)
- API routes → Endorsed forms: routes to (evidence: `backend/routes/api.php`)
- API routes → Transmittals: routes to (evidence: `backend/routes/api.php`)
- API routes → Reports and reviews: routes to (evidence: `backend/routes/api.php`)
- API routes → Export operations: routes to (evidence: `backend/routes/api.php`)
- Student services → Student records: queries (evidence: `backend/app/Http/Controllers/Api/StudentController.php`)
- Student services → Upload records: queries (evidence: `backend/app/Http/Controllers/Api/StudentController.php`)
- Application intake → Application records: uses (evidence: `backend/app/Http/Controllers/Api/ApplicationController.php`)
- Endorsements → Endorsement records: uses (evidence: `backend/app/Http/Controllers/Api/EndorsementController.php`)
- Endorsed forms → Endorsed form records: creates and updates (evidence: `backend/app/Http/Controllers/Api/EndorsedFormController.php`)
- Endorsed forms → Transmittal records: creates (evidence: `backend/app/Http/Controllers/Api/EndorsedFormController.php`)
- Transmittals → Transmittal records: uses (evidence: `backend/app/Http/Controllers/Api/TransmittalController.php`)
- Reports and reviews → Export audit records: uses (evidence: `backend/app/Http/Controllers/Api/AdaReportController.php`)
- Export operations → Export audit records: uses (evidence: `backend/app/Http/Controllers/Api/ExportController.php`)
- Export operations → Drive upload job: dispatches (evidence: `backend/app/Http/Controllers/Api/ExportController.php`)
- Export log admin → Export audit records: queries (evidence: `backend/app/Http/Controllers/Api/Admin/ExportLogController.php`)
- Export log admin → Drive upload job: dispatches retry (evidence: `backend/app/Http/Controllers/Api/Admin/ExportLogController.php`)
- Application records → Student records: belongs to (evidence: `backend/app/Models/Application.php`)
