# matiasmagliano/horarios-escolares architecture

> Architecture diagram of the GitHub repository matiasmagliano/horarios-escolares, 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/matiasmagliano/horarios-escolares
- Repository: https://github.com/matiasmagliano/horarios-escolares

## Overview

Horarios Escolares is a Laravel/Livewire system for managing school schedules across institutions. The principal workflow is: a user signs in, selects an active institution, administers courses, subjects, teachers and rooms, configures time blocks, then views schedule grids or manages schedule changes and generates PDFs. The README also documents permissions, space utilization and teacher-overlap alerts. Edges below are limited to relationships shown in the README or supplied excerpts and source index; unsampled Livewire and routing details are represented without inferred call chains.

Main entry points: [`app/Livewire`](https://github.com/matiasmagliano/horarios-escolares/tree/main/app/Livewire) (Administration panels), [`app/Http/Controllers/PdfController.php`](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/PdfController.php) (PDF generation), [`app/Http/Controllers/Auth/AuthenticatedSessionController.php`](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php) (Authentication), [`app/Models/CambioHorario.php`](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/CambioHorario.php) (Schedule changes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; institutions"]
  node_login["Authentication"]
  node_institution_select["Institution selection"]
  node_institution_context["Active institution context"]
  node_institution[("Institution and membership<br/>[Institucion.php]")]
  node_permissions["Roles and permissions"]
end

subgraph group_admin["School administration"]
  node_admin_ui["Administration panels"]
  node_courses[("Courses and subjects<br/>[Curso.php]")]
  node_teachers[("Teachers<br/>[Docente.php]")]
  node_spaces[("Physical spaces<br/>[EspacioFisico.php]")]
  node_institutional_scope["Institution-scoped records"]
end

subgraph group_scheduling["Scheduling"]
  node_block_config["Block templates"]
  node_block_data[("Schedule blocks<br/>[BloqueHorario.php]")]
  node_block_config_data[("Block configuration")]
  node_base_schedule[("Base schedules<br/>[HorarioBase.php]")]
  node_schedule_view["Course schedule view<br/>[HorarioCurso.php]"]
  node_course_grid["Course grid builder"]
  node_space_grid["Space utilization grid"]
end

subgraph group_changes["Schedule changes"]
  node_changes_ui["Schedule change workflow<br/>[CambioHorario.php]"]
  node_change_model[("Schedule changes<br/>[CambioHorario.php]")]
  node_change_details[("Change details")]
end

subgraph group_reporting["Reports &amp; alerts"]
  node_pdf["PDF generation<br/>[PdfController.php]"]
  node_overlap_alerts["Teacher overlap alerts"]
  node_assignment_alerts["Course assignment dashboard"]
  node_pending_alerts["Pending change dashboard"]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_login -->|"routes when needed"| node_institution_select
node_login -->|"loads memberships"| node_institution
node_institution_select -.->|"sets active institution"| node_institution_context
node_institution_context -->|"scopes records"| node_institutional_scope
node_institution -->|"owns configurations"| node_block_config_data
node_block_config -->|"writes configurations"| node_block_config_data
node_block_config -->|"creates blocks"| node_block_data
node_schedule_view -.->|"builds schedule"| node_course_grid
node_pdf -->|"builds course grid"| node_course_grid
node_pdf -->|"builds space grid"| node_space_grid
node_pdf -->|"loads and numbers"| node_change_model
node_changes_ui -->|"manages changes"| node_change_model
node_change_model -->|"queries details"| node_change_details
node_user -.->|"administers school data"| node_admin_ui
node_admin_ui -.->|"manages courses"| node_courses
node_admin_ui -.->|"manages teachers"| node_teachers
node_admin_ui -.->|"manages spaces"| node_spaces
node_user -.->|"access governed by"| node_permissions
node_user -.->|"reviews alerts"| node_overlap_alerts
node_user -.->|"reviews dashboard"| node_assignment_alerts
node_user -.->|"reviews dashboard"| node_pending_alerts

click node_login "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_institution_select "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/InstitucionSeleccionController.php"
click node_institution_context "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Instituciones/InstitucionContext.php"
click node_institution "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Institucion.php"
click node_permissions "https://github.com/matiasmagliano/horarios-escolares/tree/main/app/Support/Permissions"
click node_admin_ui "https://github.com/matiasmagliano/horarios-escolares/tree/main/app/Livewire"
click node_courses "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Curso.php"
click node_teachers "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Docente.php"
click node_spaces "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/EspacioFisico.php"
click node_institutional_scope "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Concerns/BelongsToInstitucion.php"
click node_block_config "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Horarios/BloqueHorarioTemplateManager.php"
click node_block_data "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/BloqueHorario.php"
click node_block_config_data "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/BloqueHorarioConfig.php"
click node_base_schedule "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/HorarioBase.php"
click node_schedule_view "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Livewire/HorarioCurso.php"
click node_course_grid "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Horarios/HorarioCursoGridBuilder.php"
click node_space_grid "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Horarios/UtilizacionEspaciosGridBuilder.php"
click node_changes_ui "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Livewire/CambioHorario.php"
click node_change_model "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/CambioHorario.php"
click node_change_details "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/CambioHorarioDetalle.php"
click node_pdf "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/PdfController.php"
click node_overlap_alerts "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Dashboard/DocenteSuperposicionDetector.php"
click node_assignment_alerts "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Dashboard/CursoAsignacionDetector.php"
click node_pending_alerts "https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Dashboard/CambioHorarioPendientesDetector.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_login,node_institution_select,node_institution_context,node_institution,node_permissions,node_user toneBlue
class node_admin_ui,node_courses,node_teachers,node_spaces,node_institutional_scope toneAmber
class node_block_config,node_block_data,node_block_config_data,node_base_schedule,node_schedule_view,node_course_grid,node_space_grid toneMint
class node_changes_ui,node_change_model,node_change_details toneRose
class node_pdf,node_overlap_alerts,node_assignment_alerts,node_pending_alerts toneIndigo
```

## Components

### Access & institutions

- [Authentication](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Institution selection](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/InstitucionSeleccionController.php): `app/Http/Controllers/InstitucionSeleccionController.php`
- [Active institution context](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Instituciones/InstitucionContext.php): `app/Support/Instituciones/InstitucionContext.php`
- [Institution and membership](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Institucion.php): `app/Models/Institucion.php`
- [Roles and permissions](https://github.com/matiasmagliano/horarios-escolares/tree/main/app/Support/Permissions): `app/Support/Permissions`

### School administration

- [Administration panels](https://github.com/matiasmagliano/horarios-escolares/tree/main/app/Livewire): `app/Livewire`
- [Courses and subjects](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Curso.php): `app/Models/Curso.php`
- [Teachers](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Docente.php): `app/Models/Docente.php`
- [Physical spaces](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/EspacioFisico.php): `app/Models/EspacioFisico.php`
- [Institution-scoped records](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/Concerns/BelongsToInstitucion.php): `app/Models/Concerns/BelongsToInstitucion.php`

### Scheduling

- [Block templates](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Horarios/BloqueHorarioTemplateManager.php): `app/Support/Horarios/BloqueHorarioTemplateManager.php`
- [Schedule blocks](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/BloqueHorario.php): `app/Models/BloqueHorario.php`
- [Block configuration](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/BloqueHorarioConfig.php): `app/Models/BloqueHorarioConfig.php`
- [Base schedules](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/HorarioBase.php): `app/Models/HorarioBase.php`
- [Course schedule view](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Livewire/HorarioCurso.php): `app/Livewire/HorarioCurso.php`
- [Course grid builder](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Horarios/HorarioCursoGridBuilder.php): `app/Support/Horarios/HorarioCursoGridBuilder.php`
- [Space utilization grid](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Horarios/UtilizacionEspaciosGridBuilder.php): `app/Support/Horarios/UtilizacionEspaciosGridBuilder.php`

### Schedule changes

- [Schedule change workflow](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Livewire/CambioHorario.php): `app/Livewire/CambioHorario.php`
- [Schedule changes](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/CambioHorario.php): `app/Models/CambioHorario.php`
- [Change details](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Models/CambioHorarioDetalle.php): `app/Models/CambioHorarioDetalle.php`

### Reports & alerts

- [PDF generation](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Http/Controllers/PdfController.php): `app/Http/Controllers/PdfController.php`
- [Teacher overlap alerts](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Dashboard/DocenteSuperposicionDetector.php): `app/Support/Dashboard/DocenteSuperposicionDetector.php`
- [Course assignment dashboard](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Dashboard/CursoAsignacionDetector.php): `app/Support/Dashboard/CursoAsignacionDetector.php`
- [Pending change dashboard](https://github.com/matiasmagliano/horarios-escolares/blob/main/app/Support/Dashboard/CambioHorarioPendientesDetector.php): `app/Support/Dashboard/CambioHorarioPendientesDetector.php`

### Other components

- **User**

## Connections

- User → Authentication: signs in
- Authentication → Institution selection: routes when needed (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Authentication → Institution and membership: loads memberships (evidence: `app/Http/Controllers/Auth/AuthenticatedSessionController.php`)
- Institution selection → Active institution context: sets active institution
- Active institution context → Institution-scoped records: scopes records (evidence: `app/Models/Concerns/BelongsToInstitucion.php`)
- Institution and membership → Block configuration: owns configurations (evidence: `app/Models/Institucion.php`)
- Block templates → Block configuration: writes configurations (evidence: `app/Support/Horarios/BloqueHorarioTemplateManager.php`)
- Block templates → Schedule blocks: creates blocks (evidence: `app/Support/Horarios/BloqueHorarioTemplateManager.php`)
- Course schedule view → Course grid builder: builds schedule
- PDF generation → Course grid builder: builds course grid (evidence: `app/Http/Controllers/PdfController.php`)
- PDF generation → Space utilization grid: builds space grid (evidence: `app/Http/Controllers/PdfController.php`)
- PDF generation → Schedule changes: loads and numbers (evidence: `app/Http/Controllers/PdfController.php`)
- Schedule change workflow → Schedule changes: manages changes (evidence: `app/Livewire/CambioHorario.php`)
- Schedule changes → Change details: queries details (evidence: `app/Models/CambioHorario.php`)
- User → Administration panels: administers school data
- Administration panels → Courses and subjects: manages courses (evidence: `app/Livewire/CambioHorario.php`)
- Administration panels → Teachers: manages teachers (evidence: `app/Livewire/CambioHorario.php`)
- Administration panels → Physical spaces: manages spaces
- User → Roles and permissions: access governed by
- User → Teacher overlap alerts: reviews alerts
- User → Course assignment dashboard: reviews dashboard
- User → Pending change dashboard: reviews dashboard
