# ts-tiara/driveed-hub-capstone-project architecture

> Architecture diagram of the GitHub repository ts-tiara/driveed-hub-capstone-project, 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/ts-tiara/driveed-hub-capstone-project
- Repository: https://github.com/ts-tiara/driveed-hub-capstone-project

## Overview

This is a multi-school driving-school management and learning platform. Its main learner journey runs from course discovery and enrollment review through payment, lesson scheduling, session completion, and progress tracking; school staff and instructors manage those stages. The graph also includes administration, notifications, and reporting as distinct capabilities. Evidence is limited to the supplied source index and excerpts; unsampled controllers and views are represented only where the tree supports their existence, without assuming their call flow.

Main entry points: [`app/Models/Booking.php`](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Booking.php) (Lesson bookings), [`app/Http/Controllers/EnrollmentRequestController.php`](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/EnrollmentRequestController.php) (Enrollment review), [`app/Models/Course.php`](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Course.php) (Course catalog), [`app/Models/EnrollmentRequest.php`](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/EnrollmentRequest.php) (Enrollment requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_enroll["Enrollment and Payments"]
  node_enrollui["Enrollment interface"]
  node_enrollctl["Enrollment review"]
  node_enrollvalidate["Enrollment validation"]
  node_enrollrequest[("Enrollment requests")]
  node_payments["Payment processing"]
  node_paymentverify["Payment verification"]
  node_paymentstore[("Payments<br/>[Payment.php]")]
  node_receipt["Receipt storage"]
end

subgraph group_learning["Training and Scheduling"]
  node_courses[("Course catalog<br/>[Course.php]")]
  node_bookings[("Lesson bookings<br/>[Booking.php]")]
  node_scheduling["Schedule conflicts"]
  node_instructors[("Instructor records<br/>[Instructor.php]")]
  node_sessions[("Session completion")]
  node_progress[("Student progress<br/>[Progress.php]")]
  node_studentmodel[("Student records<br/>[Student.php]")]
end

subgraph group_admin["School Operations"]
  node_adminctl["School administration"]
  node_branches[("Branches<br/>[Branch.php]")]
end

subgraph group_platform["Tenant and Identity"]
  node_schools[("School tenants<br/>[School.php]")]
  node_onboarding["Account onboarding"]
end

subgraph group_notify["Notifications and Reports"]
  node_reminders["Session reminders"]
  node_notifications[("Notifications<br/>[Notification.php]")]
  node_reports["Reports and exports"]
end

node_guest(("Guest learner"))
node_student(("Student"))
node_schoolstaff(("School staff"))
node_instructor(("Instructor"))

node_guest -.->|"requests enrollment"| node_enrollui
node_enrollui -.->|"submits request"| node_enrollctl
node_enrollctl -.->|"validates"| node_enrollvalidate
node_enrollctl -->|"reviews"| node_enrollrequest
node_enrollctl -->|"uses payment"| node_paymentstore
node_enrollrequest -->|"belongs to"| node_courses
node_enrollrequest -->|"belongs to"| node_studentmodel
node_payments -.->|"records payment"| node_paymentstore
node_paymentverify -.->|"verifies payment"| node_paymentstore
node_payments -.->|"stores receipt"| node_receipt
node_student -.->|"chooses course"| node_courses
node_student -.->|"books lessons"| node_bookings
node_bookings -->|"belongs to"| node_courses
node_bookings -->|"assigned instructor"| node_instructors
node_scheduling -->|"checks conflicts"| node_sessions
node_instructor -.->|"records completion"| node_sessions
node_sessions -.->|"updates learning"| node_progress
node_progress -->|"tracks course"| node_courses
node_studentmodel -->|"has bookings"| node_bookings
node_schoolstaff -.->|"manages school"| node_adminctl
node_adminctl -->|"manages branches"| node_branches
node_branches -->|"belongs to"| node_schools
node_onboarding -->|"selects school"| node_schools
node_onboarding -->|"creates learner"| node_studentmodel
node_reminders -->|"loads bookings"| node_bookings
node_reminders -->|"creates reminders"| node_notifications
node_adminctl -.->|"offers reporting"| node_reports

click node_enrollui "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/resources/views/school/guest/enrollment-requests.blade.php"
click node_enrollctl "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/EnrollmentRequestController.php"
click node_enrollvalidate "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Support/EnrollmentValidator.php"
click node_enrollrequest "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/EnrollmentRequest.php"
click node_payments "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/PaymentSubmissionService.php"
click node_paymentverify "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/PaymentVerificationService.php"
click node_paymentstore "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Payment.php"
click node_receipt "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/ReceiptStorageService.php"
click node_courses "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Course.php"
click node_bookings "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Booking.php"
click node_scheduling "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/SchedulingConflictService.php"
click node_instructors "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Instructor.php"
click node_sessions "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/SessionCompletion.php"
click node_progress "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Progress.php"
click node_studentmodel "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Student.php"
click node_adminctl "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/AdminController.php"
click node_branches "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Branch.php"
click node_schools "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/School.php"
click node_onboarding "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/Auth/OnboardingController.php"
click node_reminders "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Console/Commands/SendSessionReminders.php"
click node_notifications "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Notification.php"
click node_reports "https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/ReportController.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_enrollui,node_enrollctl,node_enrollvalidate,node_enrollrequest,node_payments,node_paymentverify,node_paymentstore,node_receipt toneBlue
class node_courses,node_bookings,node_scheduling,node_instructors,node_sessions,node_progress,node_studentmodel toneAmber
class node_adminctl,node_branches toneMint
class node_schools,node_onboarding toneRose
class node_reminders,node_notifications,node_reports,node_guest,node_student,node_schoolstaff,node_instructor toneIndigo
```

## Components

### Enrollment and Payments

- [Enrollment interface](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/resources/views/school/guest/enrollment-requests.blade.php): `resources/views/school/guest/enrollment-requests.blade.php`
- [Enrollment review](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/EnrollmentRequestController.php): `app/Http/Controllers/EnrollmentRequestController.php`
- [Enrollment validation](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Support/EnrollmentValidator.php): `app/Support/EnrollmentValidator.php`
- [Enrollment requests](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/EnrollmentRequest.php): `app/Models/EnrollmentRequest.php`
- [Payment processing](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/PaymentSubmissionService.php): `app/Services/PaymentSubmissionService.php`
- [Payment verification](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/PaymentVerificationService.php): `app/Services/PaymentVerificationService.php`
- [Payments](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Payment.php): `app/Models/Payment.php`
- [Receipt storage](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/ReceiptStorageService.php): `app/Services/ReceiptStorageService.php`

### Training and Scheduling

- [Course catalog](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Course.php): `app/Models/Course.php`
- [Lesson bookings](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Booking.php): `app/Models/Booking.php`
- [Schedule conflicts](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Services/SchedulingConflictService.php): `app/Services/SchedulingConflictService.php`
- [Instructor records](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Instructor.php): `app/Models/Instructor.php`
- [Session completion](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/SessionCompletion.php): `app/Models/SessionCompletion.php`
- [Student progress](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Progress.php): `app/Models/Progress.php`
- [Student records](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Student.php): `app/Models/Student.php`

### School Operations

- [School administration](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/AdminController.php): `app/Http/Controllers/AdminController.php`
- [Branches](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Branch.php): `app/Models/Branch.php`

### Tenant and Identity

- [School tenants](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/School.php): `app/Models/School.php`
- [Account onboarding](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/Auth/OnboardingController.php): `app/Http/Controllers/Auth/OnboardingController.php`

### Notifications and Reports

- [Session reminders](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Console/Commands/SendSessionReminders.php): `app/Console/Commands/SendSessionReminders.php`
- [Notifications](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Models/Notification.php): `app/Models/Notification.php`
- [Reports and exports](https://github.com/ts-tiara/driveed-hub-capstone-project/blob/main/app/Http/Controllers/ReportController.php): `app/Http/Controllers/ReportController.php`

### Other components

- **Guest learner**
- **Student**
- **School staff**
- **Instructor**

## Connections

- Guest learner → Enrollment interface: requests enrollment
- Enrollment interface → Enrollment review: submits request
- Enrollment review → Enrollment validation: validates (evidence: `app/Http/Controllers/EnrollmentRequestController.php`)
- Enrollment review → Enrollment requests: reviews (evidence: `app/Http/Controllers/EnrollmentRequestController.php`)
- Enrollment review → Payments: uses payment (evidence: `app/Http/Controllers/EnrollmentRequestController.php`)
- Enrollment requests → Course catalog: belongs to (evidence: `app/Models/EnrollmentRequest.php`)
- Enrollment requests → Student records: belongs to (evidence: `app/Models/EnrollmentRequest.php`)
- Payment processing → Payments: records payment
- Payment verification → Payments: verifies payment
- Payment processing → Receipt storage: stores receipt
- Student → Course catalog: chooses course
- Student → Lesson bookings: books lessons
- Lesson bookings → Course catalog: belongs to (evidence: `app/Models/Booking.php`)
- Lesson bookings → Instructor records: assigned instructor (evidence: `app/Models/Booking.php`)
- Schedule conflicts → Session completion: checks conflicts (evidence: `app/Services/SchedulingConflictService.php`)
- Instructor → Session completion: records completion
- Session completion → Student progress: updates learning
- Student progress → Course catalog: tracks course (evidence: `app/Models/Progress.php`)
- Student records → Lesson bookings: has bookings (evidence: `app/Models/Student.php`)
- School staff → School administration: manages school
- School administration → Branches: manages branches (evidence: `app/Http/Controllers/AdminController.php`)
- Branches → School tenants: belongs to (evidence: `app/Models/Branch.php`)
- Account onboarding → School tenants: selects school (evidence: `app/Http/Controllers/Auth/OnboardingController.php`)
- Account onboarding → Student records: creates learner (evidence: `app/Http/Controllers/Auth/OnboardingController.php`)
- Session reminders → Lesson bookings: loads bookings (evidence: `app/Console/Commands/SendSessionReminders.php`)
- Session reminders → Notifications: creates reminders (evidence: `app/Console/Commands/SendSessionReminders.php`)
- School administration → Reports and exports: offers reporting (evidence: `app/Http/Controllers/AdminController.php`)
