# tishtito/educa_lara architecture

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

- Interactive diagram: https://gitdiagram.com/tishtito/educa_lara
- Repository: https://github.com/tishtito/educa_lara

## Overview

This is a Laravel school-management application: school staff manage people, academics, timetables, exams and billing through an API; exam marks are computed into results that can be analyzed and reported. Tenant context and role permissions provide useful cross-cutting layers. The supplied README describes Laravel generically rather than documenting product capabilities. The graph therefore reflects the file tree and shown source/index references; unsampled subsystems are included where their paths are clear, but their internal connections are not guessed.

Main entry points: [`app/Http/Controllers/Api/AnalysisController.php`](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/AnalysisController.php) (Result analysis), [`app/Domain/Tenancy/TenantManager.php`](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Tenancy/TenantManager.php) (Tenant context), [`app/Domain/Examination/Setup/ExamSetupService.php`](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Setup/ExamSetupService.php) (Exam setup), [`app/Http/Controllers/Api/People/StaffController.php`](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/People/StaffController.php) (Staff management API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_school["School foundation"]
  node_staff_api["Staff management API"]
  node_people["People and enrolment"]
  node_academics_data["Classes and calendar<br/>[SchoolClass.php]"]
  node_school[("School tenant<br/>[School.php]")]
  node_tenant["Tenant context<br/>[TenantManager.php]"]
end

subgraph group_academics["Academic operations"]
  node_curriculum["Curriculum setup<br/>[LevelSubject.php]"]
  node_timetable_api["Timetable API"]
  node_timetable["Timetable planning"]
  node_materials["Teaching materials"]
end

subgraph group_exams["Exams and reporting"]
  node_exam_setup["Exam setup"]
  node_marking["Mark entry"]
  node_compute["Result computation"]
  node_grading["Grade resolution<br/>[GradeResolver.php]"]
  node_analysis["Result analysis"]
  node_marklist["Marklist queries"]
  node_reports["Report cards"]
end

subgraph group_platform["Identity and platform"]
  node_user[("User accounts<br/>[User.php]")]
  node_access["Role permissions<br/>[Access.php]"]
  node_billing["Subscriptions and payments<br/>[Subscriptions.php]"]
  node_billing_api["Subscription API"]
  node_legacy["Legacy data import<br/>[LegacyImporter.php]"]
end

node_staff(("School staff"))
node_api(("School API"))

node_staff -->|"manages"| node_staff_api
node_api -->|"requests analysis"| node_analysis
node_staff_api -->|"uses staff services"| node_people
node_staff_api -->|"resolves school"| node_tenant
node_tenant -->|"holds tenant"| node_school
node_school -->|"starts trial"| node_billing
node_timetable_api -->|"generates timetable"| node_timetable
node_timetable_api -->|"resolves school"| node_tenant
node_exam_setup -->|"uses classes"| node_academics_data
node_exam_setup -->|"selects subjects"| node_curriculum
node_exam_setup -->|"checks report entries"| node_reports
node_marking -->|"queues computation"| node_compute
node_compute -->|"resolves grades"| node_grading
node_analysis -->|"gets current school"| node_tenant
node_analysis -->|"queries marklists"| node_marklist
node_analysis -->|"reads class data"| node_academics_data
node_analysis -->|"reads subjects"| node_curriculum
node_billing_api -->|"manages subscriptions"| node_billing
node_billing_api -->|"reads schools"| node_school
node_access -->|"resolves user roles"| node_user
node_access -->|"gets school context"| node_tenant
node_api -.->|"manages materials"| node_materials
node_api -.->|"imports legacy records"| node_legacy
node_api -.->|"sets up exams"| node_exam_setup
node_api -.->|"enters marks"| node_marking
node_api -.->|"plans timetable"| node_timetable_api
node_api -.->|"manages billing"| node_billing_api

click node_staff_api "https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/People/StaffController.php"
click node_people "https://github.com/tishtito/educa_lara/blob/main/app/Domain/People/Models/StudentEnrolment.php"
click node_academics_data "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Academics/Models/SchoolClass.php"
click node_curriculum "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Curriculum/Models/LevelSubject.php"
click node_timetable_api "https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/Timetabling/TimetableController.php"
click node_timetable "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Timetabling/Services/TimetableGenerator.php"
click node_exam_setup "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Setup/ExamSetupService.php"
click node_marking "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Marking/MarksheetService.php"
click node_compute "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Services/ExamComputationService.php"
click node_grading "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Grading/Services/GradeResolver.php"
click node_analysis "https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/AnalysisController.php"
click node_marklist "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Repositories/MarklistRepository.php"
click node_reports "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Reporting/Services/ReportCardBuilder.php"
click node_school "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Tenancy/Models/School.php"
click node_tenant "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Tenancy/TenantManager.php"
click node_user "https://github.com/tishtito/educa_lara/blob/main/app/Domain/People/Models/User.php"
click node_access "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Access/Access.php"
click node_billing "https://github.com/tishtito/educa_lara/blob/main/app/Domain/Billing/Subscriptions.php"
click node_billing_api "https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/Platform/SubscriptionController.php"
click node_materials "https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/Resources/TeachingMaterialController.php"
click node_legacy "https://github.com/tishtito/educa_lara/blob/main/app/Domain/LegacyImport/LegacyImporter.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_staff_api,node_people,node_academics_data,node_school,node_tenant toneBlue
class node_curriculum,node_timetable_api,node_timetable,node_materials toneAmber
class node_exam_setup,node_marking,node_compute,node_grading,node_analysis,node_marklist,node_reports,node_api toneMint
class node_user,node_access,node_billing,node_billing_api,node_legacy toneRose
class node_staff toneIndigo
```

## Components

### School foundation

- [Staff management API](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/People/StaffController.php): `app/Http/Controllers/Api/People/StaffController.php`
- [People and enrolment](https://github.com/tishtito/educa_lara/blob/main/app/Domain/People/Models/StudentEnrolment.php): `app/Domain/People/Models/StudentEnrolment.php`
- [Classes and calendar](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Academics/Models/SchoolClass.php): `app/Domain/Academics/Models/SchoolClass.php`
- [School tenant](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Tenancy/Models/School.php): `app/Domain/Tenancy/Models/School.php`
- [Tenant context](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Tenancy/TenantManager.php): `app/Domain/Tenancy/TenantManager.php`

### Academic operations

- [Curriculum setup](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Curriculum/Models/LevelSubject.php): `app/Domain/Curriculum/Models/LevelSubject.php`
- [Timetable API](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/Timetabling/TimetableController.php): `app/Http/Controllers/Api/Timetabling/TimetableController.php`
- [Timetable planning](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Timetabling/Services/TimetableGenerator.php): `app/Domain/Timetabling/Services/TimetableGenerator.php`
- [Teaching materials](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/Resources/TeachingMaterialController.php): `app/Http/Controllers/Api/Resources/TeachingMaterialController.php`

### Exams and reporting

- [Exam setup](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Setup/ExamSetupService.php): `app/Domain/Examination/Setup/ExamSetupService.php`
- [Mark entry](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Marking/MarksheetService.php): `app/Domain/Examination/Marking/MarksheetService.php`
- [Result computation](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Services/ExamComputationService.php): `app/Domain/Examination/Services/ExamComputationService.php`
- [Grade resolution](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Grading/Services/GradeResolver.php): `app/Domain/Grading/Services/GradeResolver.php`
- [Result analysis](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/AnalysisController.php): `app/Http/Controllers/Api/AnalysisController.php`
- [Marklist queries](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Examination/Repositories/MarklistRepository.php): `app/Domain/Examination/Repositories/MarklistRepository.php`
- [Report cards](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Reporting/Services/ReportCardBuilder.php): `app/Domain/Reporting/Services/ReportCardBuilder.php`

### Identity and platform

- [User accounts](https://github.com/tishtito/educa_lara/blob/main/app/Domain/People/Models/User.php): `app/Domain/People/Models/User.php`
- [Role permissions](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Access/Access.php): `app/Domain/Access/Access.php`
- [Subscriptions and payments](https://github.com/tishtito/educa_lara/blob/main/app/Domain/Billing/Subscriptions.php): `app/Domain/Billing/Subscriptions.php`
- [Subscription API](https://github.com/tishtito/educa_lara/blob/main/app/Http/Controllers/Api/Platform/SubscriptionController.php): `app/Http/Controllers/Api/Platform/SubscriptionController.php`
- [Legacy data import](https://github.com/tishtito/educa_lara/blob/main/app/Domain/LegacyImport/LegacyImporter.php): `app/Domain/LegacyImport/LegacyImporter.php`

### Other components

- **School staff**
- **School API**

## Connections

- School staff → Staff management API: manages (evidence: `app/Http/Controllers/Api/People/StaffController.php`)
- School API → Result analysis: requests analysis (evidence: `app/Http/Controllers/Api/AnalysisController.php`)
- Staff management API → People and enrolment: uses staff services (evidence: `app/Http/Controllers/Api/People/StaffController.php`)
- Staff management API → Tenant context: resolves school (evidence: `app/Http/Controllers/Api/People/StaffController.php`)
- Tenant context → School tenant: holds tenant (evidence: `app/Domain/Tenancy/TenantManager.php`)
- School tenant → Subscriptions and payments: starts trial (evidence: `app/Domain/Tenancy/Models/School.php`)
- Timetable API → Timetable planning: generates timetable (evidence: `app/Http/Controllers/Api/Timetabling/TimetableController.php`)
- Timetable API → Tenant context: resolves school (evidence: `app/Http/Controllers/Api/Timetabling/TimetableController.php`)
- Exam setup → Classes and calendar: uses classes (evidence: `app/Domain/Examination/Setup/ExamSetupService.php`)
- Exam setup → Curriculum setup: selects subjects (evidence: `app/Domain/Examination/Setup/ExamSetupService.php`)
- Exam setup → Report cards: checks report entries (evidence: `app/Domain/Examination/Setup/ExamSetupService.php`)
- Mark entry → Result computation: queues computation (evidence: `app/Domain/Examination/Marking/MarksheetService.php`)
- Result computation → Grade resolution: resolves grades (evidence: `app/Domain/Examination/Services/ExamComputationService.php`)
- Result analysis → Tenant context: gets current school (evidence: `app/Http/Controllers/Api/AnalysisController.php`)
- Result analysis → Marklist queries: queries marklists (evidence: `app/Http/Controllers/Api/AnalysisController.php`)
- Result analysis → Classes and calendar: reads class data (evidence: `app/Http/Controllers/Api/AnalysisController.php`)
- Result analysis → Curriculum setup: reads subjects (evidence: `app/Http/Controllers/Api/AnalysisController.php`)
- Subscription API → Subscriptions and payments: manages subscriptions (evidence: `app/Http/Controllers/Api/Platform/SubscriptionController.php`)
- Subscription API → School tenant: reads schools (evidence: `app/Http/Controllers/Api/Platform/SubscriptionController.php`)
- Role permissions → User accounts: resolves user roles (evidence: `app/Domain/Access/Access.php`)
- Role permissions → Tenant context: gets school context (evidence: `app/Domain/Access/Access.php`)
- School API → Teaching materials: manages materials
- School API → Legacy data import: imports legacy records
- School API → Exam setup: sets up exams
- School API → Mark entry: enters marks
- School API → Timetable API: plans timetable
- School API → Subscription API: manages billing
