# ddan9690/jamajointv2 architecture

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

- Interactive diagram: https://gitdiagram.com/ddan9690/jamajointv2
- Repository: https://github.com/ddan9690/jamajointv2

## Overview

This Laravel/Inertia application manages schools, students, exams, exam participation and grading systems. Users enter through web routes, where controllers authorize and process requests, access Eloquent-backed records, and render Inertia pages; student spreadsheet imports provide a separate bulk-enrollment workflow. The tree also shows exam administration, paper setup, profile management and stream/subject features. Relationships below are limited to controller calls visible in excerpts or routes listed in the source index; unsampled implementation details are not inferred.

Main entry points: [`routes/web.php`](https://github.com/ddan9690/jamajointv2/blob/main/routes/web.php) (Web Routes), [`app/Http/Controllers/ExamController.php`](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamController.php) (Exam Management), [`app/Http/Controllers/GradingSystemController.php`](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/GradingSystemController.php) (Grading Systems), [`app/Imports/SchoolStudentsImport.php`](https://github.com/ddan9690/jamajointv2/blob/main/app/Imports/SchoolStudentsImport.php) (Spreadsheet Import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and UI"]
  node_routes["Web Routes<br/>[web.php]"]
  node_auth["Authentication"]
  node_exam_ui["Exam Pages"]
  node_school_ui["School Pages"]
  node_grading_ui["Grading Pages"]
end

subgraph group_academics["Exam and Grading"]
  node_exam_ctl["Exam Management<br/>[ExamController.php]"]
  node_exam_admin["Exam Administrators"]
  node_exam_papers["Exam Papers"]
  node_exam_schools["Exam Enrollment"]
  node_grading_ctl["Grading Systems"]
end

subgraph group_schools["School Operations"]
  node_school_ctl["School Management"]
  node_student_ctl["Student Management"]
  node_streams["Stream Management"]
  node_import_ctl["Import Workflow"]
  node_import_job["Import Job"]
  node_importer["Spreadsheet Import"]
end

subgraph group_domain["Domain Records"]
  node_exam_model["Exam Records<br/>[Exam.php]"]
  node_school_model["School Records<br/>[School.php]"]
  node_student_model["Student Records<br/>[Student.php]"]
  node_stream_model["Stream Records<br/>[Stream.php]"]
  node_grading_model["Grading Records<br/>[GradingSystem.php]"]
end

node_user(("User"))
node_database[("Application Database")]

node_user -->|"requests"| node_routes
node_routes -->|"routes auth"| node_auth
node_routes -->|"routes exams"| node_exam_ctl
node_routes -->|"routes admins"| node_exam_admin
node_routes -->|"routes papers"| node_exam_papers
node_routes -->|"routes enrollment"| node_exam_schools
node_routes -->|"routes grading"| node_grading_ctl
node_routes -->|"routes schools"| node_school_ctl
node_routes -->|"routes students"| node_student_ctl
node_routes -->|"routes streams"| node_streams
node_routes -->|"routes imports"| node_import_ctl
node_exam_ctl -->|"renders pages"| node_exam_ui
node_grading_ctl -->|"renders pages"| node_grading_ui
node_school_ctl -.->|"renders pages"| node_school_ui
node_exam_ctl -->|"queries and updates"| node_exam_model
node_exam_ctl -->|"persists records"| node_database
node_grading_ctl -->|"creates grading bands"| node_grading_model
node_grading_ctl -->|"persists records"| node_database
node_school_ctl -->|"queries schools"| node_school_model
node_student_ctl -->|"manages students"| node_student_model
node_import_ctl -->|"dispatches import"| node_import_job
node_import_job -->|"runs import"| node_importer
node_importer -->|"inserts students"| node_student_model
node_importer -->|"resolves streams"| node_stream_model
node_importer -->|"reads and writes"| node_database

click node_routes "https://github.com/ddan9690/jamajointv2/blob/main/routes/web.php"
click node_auth "https://github.com/ddan9690/jamajointv2/tree/main/app/Http/Controllers/Auth"
click node_exam_ui "https://github.com/ddan9690/jamajointv2/tree/main/resources/js/Pages/Exams"
click node_school_ui "https://github.com/ddan9690/jamajointv2/tree/main/resources/js/Pages/Schools"
click node_grading_ui "https://github.com/ddan9690/jamajointv2/tree/main/resources/js/Pages/GradingSystems"
click node_exam_ctl "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamController.php"
click node_exam_admin "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamAdminController.php"
click node_exam_papers "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamPaperController.php"
click node_exam_schools "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamSchoolController.php"
click node_grading_ctl "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/GradingSystemController.php"
click node_school_ctl "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/SchoolController.php"
click node_student_ctl "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/StudentController.php"
click node_streams "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/StreamController.php"
click node_import_ctl "https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/SchoolStudentsImportController.php"
click node_import_job "https://github.com/ddan9690/jamajointv2/blob/main/app/Jobs/ImportSchoolStudents.php"
click node_importer "https://github.com/ddan9690/jamajointv2/blob/main/app/Imports/SchoolStudentsImport.php"
click node_exam_model "https://github.com/ddan9690/jamajointv2/blob/main/app/Models/Exam.php"
click node_school_model "https://github.com/ddan9690/jamajointv2/blob/main/app/Models/School.php"
click node_student_model "https://github.com/ddan9690/jamajointv2/blob/main/app/Models/Student.php"
click node_stream_model "https://github.com/ddan9690/jamajointv2/blob/main/app/Models/Stream.php"
click node_grading_model "https://github.com/ddan9690/jamajointv2/blob/main/app/Models/GradingSystem.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_routes,node_auth,node_exam_ui,node_school_ui,node_grading_ui,node_user toneBlue
class node_exam_ctl,node_exam_admin,node_exam_papers,node_exam_schools,node_grading_ctl,node_database toneAmber
class node_school_ctl,node_student_ctl,node_streams,node_import_ctl,node_import_job,node_importer toneMint
class node_exam_model,node_school_model,node_student_model,node_stream_model,node_grading_model toneRose
```

## Components

### Access and UI

- [Web Routes](https://github.com/ddan9690/jamajointv2/blob/main/routes/web.php): `routes/web.php`
- [Authentication](https://github.com/ddan9690/jamajointv2/tree/main/app/Http/Controllers/Auth): `app/Http/Controllers/Auth`
- [Exam Pages](https://github.com/ddan9690/jamajointv2/tree/main/resources/js/Pages/Exams): `resources/js/Pages/Exams`
- [School Pages](https://github.com/ddan9690/jamajointv2/tree/main/resources/js/Pages/Schools): `resources/js/Pages/Schools`
- [Grading Pages](https://github.com/ddan9690/jamajointv2/tree/main/resources/js/Pages/GradingSystems): `resources/js/Pages/GradingSystems`

### Exam and Grading

- [Exam Management](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamController.php): `app/Http/Controllers/ExamController.php`
- [Exam Administrators](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamAdminController.php): `app/Http/Controllers/ExamAdminController.php`
- [Exam Papers](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamPaperController.php): `app/Http/Controllers/ExamPaperController.php`
- [Exam Enrollment](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/ExamSchoolController.php): `app/Http/Controllers/ExamSchoolController.php`
- [Grading Systems](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/GradingSystemController.php): `app/Http/Controllers/GradingSystemController.php`

### School Operations

- [School Management](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/SchoolController.php): `app/Http/Controllers/SchoolController.php`
- [Student Management](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/StudentController.php): `app/Http/Controllers/StudentController.php`
- [Stream Management](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/StreamController.php): `app/Http/Controllers/StreamController.php`
- [Import Workflow](https://github.com/ddan9690/jamajointv2/blob/main/app/Http/Controllers/SchoolStudentsImportController.php): `app/Http/Controllers/SchoolStudentsImportController.php`
- [Import Job](https://github.com/ddan9690/jamajointv2/blob/main/app/Jobs/ImportSchoolStudents.php): `app/Jobs/ImportSchoolStudents.php`
- [Spreadsheet Import](https://github.com/ddan9690/jamajointv2/blob/main/app/Imports/SchoolStudentsImport.php): `app/Imports/SchoolStudentsImport.php`

### Domain Records

- [Exam Records](https://github.com/ddan9690/jamajointv2/blob/main/app/Models/Exam.php): `app/Models/Exam.php`
- [School Records](https://github.com/ddan9690/jamajointv2/blob/main/app/Models/School.php): `app/Models/School.php`
- [Student Records](https://github.com/ddan9690/jamajointv2/blob/main/app/Models/Student.php): `app/Models/Student.php`
- [Stream Records](https://github.com/ddan9690/jamajointv2/blob/main/app/Models/Stream.php): `app/Models/Stream.php`
- [Grading Records](https://github.com/ddan9690/jamajointv2/blob/main/app/Models/GradingSystem.php): `app/Models/GradingSystem.php`

### Other components

- **User**
- **Application Database**

## Connections

- User → Web Routes: requests (evidence: `routes/web.php`)
- Web Routes → Authentication: routes auth (evidence: `routes/web.php`)
- Web Routes → Exam Management: routes exams (evidence: `routes/web.php`)
- Web Routes → Exam Administrators: routes admins (evidence: `routes/web.php`)
- Web Routes → Exam Papers: routes papers (evidence: `routes/web.php`)
- Web Routes → Exam Enrollment: routes enrollment (evidence: `routes/web.php`)
- Web Routes → Grading Systems: routes grading (evidence: `routes/web.php`)
- Web Routes → School Management: routes schools (evidence: `routes/web.php`)
- Web Routes → Student Management: routes students (evidence: `routes/web.php`)
- Web Routes → Stream Management: routes streams (evidence: `routes/web.php`)
- Web Routes → Import Workflow: routes imports (evidence: `routes/web.php`)
- Exam Management → Exam Pages: renders pages (evidence: `app/Http/Controllers/ExamController.php`)
- Grading Systems → Grading Pages: renders pages (evidence: `app/Http/Controllers/GradingSystemController.php`)
- School Management → School Pages: renders pages
- Exam Management → Exam Records: queries and updates (evidence: `app/Http/Controllers/ExamController.php`)
- Exam Management → Application Database: persists records (evidence: `app/Http/Controllers/ExamController.php`)
- Grading Systems → Grading Records: creates grading bands (evidence: `app/Http/Controllers/GradingSystemController.php`)
- Grading Systems → Application Database: persists records (evidence: `app/Http/Controllers/GradingSystemController.php`)
- School Management → School Records: queries schools (evidence: `app/Http/Controllers/SchoolController.php`)
- Student Management → Student Records: manages students (evidence: `app/Http/Controllers/StudentController.php`)
- Import Workflow → Import Job: dispatches import (evidence: `app/Http/Controllers/SchoolStudentsImportController.php`)
- Import Job → Spreadsheet Import: runs import (evidence: `app/Jobs/ImportSchoolStudents.php`)
- Spreadsheet Import → Student Records: inserts students (evidence: `app/Imports/SchoolStudentsImport.php`)
- Spreadsheet Import → Stream Records: resolves streams (evidence: `app/Imports/SchoolStudentsImport.php`)
- Spreadsheet Import → Application Database: reads and writes (evidence: `app/Imports/SchoolStudentsImport.php`)
