# hctorres02/curso-php architecture

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

- Interactive diagram: https://gitdiagram.com/hctorres02/curso-php
- Repository: https://github.com/hctorres02/curso-php

## Overview

Este repositório implementa um CMS de agendamentos acadêmicos, transformando uma planilha em uma aplicação web para administrar agendamentos, disciplinas, atividades, períodos, usuários e anexos. O fluxo principal parte de uma requisição HTTP, passa pelo roteamento e controle de acesso, valida e processa operações nos controllers e models, e retorna uma resposta de interface. O README também destaca autenticação/autorização, auditoria, logs, notificações, jobs agendados e upload/streaming. Relações não visíveis nos trechos ou referências do índice foram omitidas; subsistemas não amostrados aparecem sem ligações especulativas.

Main entry points: [`src/Models/Usuario.php`](https://github.com/hctorres02/curso-php/blob/main/src/Models/Usuario.php) (Modelo de usuário), [`src/Models/Agendamento.php`](https://github.com/hctorres02/curso-php/blob/main/src/Models/Agendamento.php) (Modelo de agendamento), [`src/routes.php`](https://github.com/hctorres02/curso-php/blob/main/src/routes.php) (Rotas), [`src/Controllers/AgendamentoController.php`](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AgendamentoController.php) (Agendamentos)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Fluxo web"]
  node_entry["Entrada HTTP<br/>[index.php]"]
  node_routes["Rotas<br/>[routes.php]"]
  node_router["Roteador<br/>[Router.php]"]
  node_request["Requisição<br/>[Request.php]"]
  node_view["Renderização<br/>[View.php]"]
  node_middlewares["Middlewares"]
  node_http["Cliente HTTP<br/>[Http.php]"]
end

subgraph group_domain["Agendamento acadêmico"]
  node_schedule["Agendamentos"]
  node_schedule_model["Modelo de agendamento<br/>[Agendamento.php]"]
  node_attachments["Anexos<br/>[Anexo.php]"]
  node_activities["Atividades"]
  node_subjects["Disciplinas"]
  node_periods["Períodos"]
end

subgraph group_access["Acesso e identidade"]
  node_users["Usuários"]
  node_registration["Cadastro e senha"]
  node_auth["Autenticação<br/>[AuthController.php]"]
  node_auth_service["Sessão de acesso<br/>[Auth.php]"]
  node_roles["Papéis e permissões<br/>[Role.php]"]
  node_permission_enum["Permissões<br/>[Permission.php]"]
  node_user_model["Modelo de usuário<br/>[Usuario.php]"]
end

subgraph group_operations["Operações e alertas"]
  node_jobs["Jobs<br/>[JobController.php]"]
  node_job_model["Modelo de job<br/>[Job.php]"]
  node_logs["Logs<br/>[LogController.php]"]
  node_audit_trait["Auditoria<br/>[Auditable.php]"]
  node_audit_model["Registros de auditoria<br/>[Audit.php]"]
  node_notifications["Notificações"]
  node_notifiable["Envio de alertas<br/>[Notifiable.php]"]
  node_agenda_notice["Agenda diária<br/>[AgendaDiaria.php]"]
end

node_visitor(("Visitante"))
node_database[("Banco de dados")]

node_visitor -->|"envia requisição"| node_entry
node_entry -->|"carrega rotas"| node_routes
node_entry -->|"inicializa"| node_router
node_routes -->|"registra rotas"| node_router
node_routes -->|"despacha agendamentos"| node_schedule
node_routes -->|"despacha autenticação"| node_auth
node_routes -->|"despacha cadastro"| node_registration
node_routes -->|"despacha usuários"| node_users
node_router -->|"usa requisição"| node_request
node_middlewares -->|"valida acesso"| node_request
node_schedule -->|"consulta e altera"| node_schedule_model
node_schedule -->|"gerencia anexos"| node_attachments
node_schedule -->|"consulta opções"| node_activities
node_schedule -->|"consulta opções"| node_subjects
node_schedule_model -->|"relaciona anexos"| node_attachments
node_schedule_model -->|"relaciona atividade"| node_activities
node_schedule_model -->|"relaciona disciplina"| node_subjects
node_subjects -->|"usa períodos"| node_periods
node_auth -->|"usa sessão"| node_auth_service
node_auth -->|"consulta usuário"| node_user_model
node_registration -->|"valida e altera"| node_user_model
node_registration -->|"solicita alertas"| node_notifications
node_users -->|"consulta usuários"| node_user_model
node_user_model -->|"usa papéis"| node_roles
node_user_model -->|"usa permissões"| node_permission_enum
node_roles -->|"compone permisos"| node_permission_enum
node_schedule -->|"solicita alertas"| node_notifications
node_notifications -->|"usa agendamento"| node_schedule_model
node_notifications -->|"notifica usuário"| node_user_model
node_notifications -->|"usa envio"| node_notifiable
node_agenda_notice -.->|"envia alerta"| node_notifiable
node_audit_trait -->|"grava alterações"| node_audit_model
node_schedule_model -->|"registra auditoria"| node_audit_trait
node_subjects -->|"registra auditoria"| node_audit_trait
node_user_model -->|"registra auditoria"| node_audit_trait
node_jobs -->|"consulta jobs"| node_job_model
node_logs -.->|"lê registros"| node_database
node_schedule_model -.->|"persiste dados"| node_database
node_user_model -.->|"persiste dados"| node_database
node_router -.->|"retorna resposta"| node_view

click node_entry "https://github.com/hctorres02/curso-php/blob/main/public/index.php"
click node_routes "https://github.com/hctorres02/curso-php/blob/main/src/routes.php"
click node_router "https://github.com/hctorres02/curso-php/blob/main/src/Http/Router.php"
click node_request "https://github.com/hctorres02/curso-php/blob/main/src/Http/Request.php"
click node_view "https://github.com/hctorres02/curso-php/blob/main/src/Http/View.php"
click node_middlewares "https://github.com/hctorres02/curso-php/tree/main/src/Middlewares"
click node_http "https://github.com/hctorres02/curso-php/blob/main/src/Http/Http.php"
click node_schedule "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AgendamentoController.php"
click node_schedule_model "https://github.com/hctorres02/curso-php/blob/main/src/Models/Agendamento.php"
click node_attachments "https://github.com/hctorres02/curso-php/blob/main/src/Models/Anexo.php"
click node_activities "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AtividadeController.php"
click node_subjects "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/DisciplinaController.php"
click node_periods "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/PeriodoController.php"
click node_users "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/UsuarioController.php"
click node_registration "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/CadastroController.php"
click node_auth "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AuthController.php"
click node_auth_service "https://github.com/hctorres02/curso-php/blob/main/src/Http/Auth.php"
click node_roles "https://github.com/hctorres02/curso-php/blob/main/src/Enums/Role.php"
click node_permission_enum "https://github.com/hctorres02/curso-php/blob/main/src/Enums/Permission.php"
click node_user_model "https://github.com/hctorres02/curso-php/blob/main/src/Models/Usuario.php"
click node_jobs "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/JobController.php"
click node_job_model "https://github.com/hctorres02/curso-php/blob/main/src/Models/Job.php"
click node_logs "https://github.com/hctorres02/curso-php/blob/main/src/Controllers/LogController.php"
click node_audit_trait "https://github.com/hctorres02/curso-php/blob/main/src/Traits/Auditable.php"
click node_audit_model "https://github.com/hctorres02/curso-php/blob/main/src/Models/Audit.php"
click node_notifications "https://github.com/hctorres02/curso-php/tree/main/src/Notifications"
click node_notifiable "https://github.com/hctorres02/curso-php/blob/main/src/Traits/Notifiable.php"
click node_agenda_notice "https://github.com/hctorres02/curso-php/blob/main/src/Notifications/AgendaDiaria.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_entry,node_routes,node_router,node_request,node_view,node_middlewares,node_http toneBlue
class node_schedule,node_schedule_model,node_attachments,node_activities,node_subjects,node_periods,node_database toneAmber
class node_users,node_registration,node_auth,node_auth_service,node_roles,node_permission_enum,node_user_model toneMint
class node_jobs,node_job_model,node_logs,node_audit_trait,node_audit_model,node_notifications,node_notifiable,node_agenda_notice toneRose
class node_visitor toneIndigo
```

## Components

### Fluxo web

- [Entrada HTTP](https://github.com/hctorres02/curso-php/blob/main/public/index.php): `public/index.php`
- [Rotas](https://github.com/hctorres02/curso-php/blob/main/src/routes.php): `src/routes.php`
- [Roteador](https://github.com/hctorres02/curso-php/blob/main/src/Http/Router.php): `src/Http/Router.php`
- [Requisição](https://github.com/hctorres02/curso-php/blob/main/src/Http/Request.php): `src/Http/Request.php`
- [Renderização](https://github.com/hctorres02/curso-php/blob/main/src/Http/View.php): `src/Http/View.php`
- [Middlewares](https://github.com/hctorres02/curso-php/tree/main/src/Middlewares): `src/Middlewares`
- [Cliente HTTP](https://github.com/hctorres02/curso-php/blob/main/src/Http/Http.php): `src/Http/Http.php`

### Agendamento acadêmico

- [Agendamentos](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AgendamentoController.php): `src/Controllers/AgendamentoController.php`
- [Modelo de agendamento](https://github.com/hctorres02/curso-php/blob/main/src/Models/Agendamento.php): `src/Models/Agendamento.php`
- [Anexos](https://github.com/hctorres02/curso-php/blob/main/src/Models/Anexo.php): `src/Models/Anexo.php`
- [Atividades](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AtividadeController.php): `src/Controllers/AtividadeController.php`
- [Disciplinas](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/DisciplinaController.php): `src/Controllers/DisciplinaController.php`
- [Períodos](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/PeriodoController.php): `src/Controllers/PeriodoController.php`

### Acesso e identidade

- [Usuários](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/UsuarioController.php): `src/Controllers/UsuarioController.php`
- [Cadastro e senha](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/CadastroController.php): `src/Controllers/CadastroController.php`
- [Autenticação](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/AuthController.php): `src/Controllers/AuthController.php`
- [Sessão de acesso](https://github.com/hctorres02/curso-php/blob/main/src/Http/Auth.php): `src/Http/Auth.php`
- [Papéis e permissões](https://github.com/hctorres02/curso-php/blob/main/src/Enums/Role.php): `src/Enums/Role.php`
- [Permissões](https://github.com/hctorres02/curso-php/blob/main/src/Enums/Permission.php): `src/Enums/Permission.php`
- [Modelo de usuário](https://github.com/hctorres02/curso-php/blob/main/src/Models/Usuario.php): `src/Models/Usuario.php`

### Operações e alertas

- [Jobs](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/JobController.php): `src/Controllers/JobController.php`
- [Modelo de job](https://github.com/hctorres02/curso-php/blob/main/src/Models/Job.php): `src/Models/Job.php`
- [Logs](https://github.com/hctorres02/curso-php/blob/main/src/Controllers/LogController.php): `src/Controllers/LogController.php`
- [Auditoria](https://github.com/hctorres02/curso-php/blob/main/src/Traits/Auditable.php): `src/Traits/Auditable.php`
- [Registros de auditoria](https://github.com/hctorres02/curso-php/blob/main/src/Models/Audit.php): `src/Models/Audit.php`
- [Notificações](https://github.com/hctorres02/curso-php/tree/main/src/Notifications): `src/Notifications`
- [Envio de alertas](https://github.com/hctorres02/curso-php/blob/main/src/Traits/Notifiable.php): `src/Traits/Notifiable.php`
- [Agenda diária](https://github.com/hctorres02/curso-php/blob/main/src/Notifications/AgendaDiaria.php): `src/Notifications/AgendaDiaria.php`

### Other components

- **Visitante**
- **Banco de dados**

## Connections

- Visitante → Entrada HTTP: envia requisição
- Entrada HTTP → Rotas: carrega rotas (evidence: `public/index.php`)
- Entrada HTTP → Roteador: inicializa (evidence: `public/index.php`)
- Rotas → Roteador: registra rotas (evidence: `src/routes.php`)
- Rotas → Agendamentos: despacha agendamentos (evidence: `src/routes.php`)
- Rotas → Autenticação: despacha autenticação (evidence: `src/routes.php`)
- Rotas → Cadastro e senha: despacha cadastro (evidence: `src/routes.php`)
- Rotas → Usuários: despacha usuários (evidence: `src/routes.php`)
- Roteador → Requisição: usa requisição (evidence: `src/Http/Router.php`)
- Middlewares → Requisição: valida acesso (evidence: `src/Middlewares/ConfigureView.php`)
- Agendamentos → Modelo de agendamento: consulta e altera (evidence: `src/Controllers/AgendamentoController.php`)
- Agendamentos → Anexos: gerencia anexos (evidence: `src/Controllers/AgendamentoController.php`)
- Agendamentos → Atividades: consulta opções (evidence: `src/Controllers/AgendamentoController.php`)
- Agendamentos → Disciplinas: consulta opções (evidence: `src/Controllers/AgendamentoController.php`)
- Modelo de agendamento → Anexos: relaciona anexos (evidence: `src/Models/Agendamento.php`)
- Modelo de agendamento → Atividades: relaciona atividade (evidence: `src/Models/Agendamento.php`)
- Modelo de agendamento → Disciplinas: relaciona disciplina (evidence: `src/Models/Agendamento.php`)
- Disciplinas → Períodos: usa períodos
- Autenticação → Sessão de acesso: usa sessão (evidence: `src/Controllers/AuthController.php`)
- Autenticação → Modelo de usuário: consulta usuário (evidence: `src/Controllers/AuthController.php`)
- Cadastro e senha → Modelo de usuário: valida e altera (evidence: `src/Controllers/CadastroController.php`)
- Cadastro e senha → Notificações: solicita alertas (evidence: `src/Controllers/CadastroController.php`)
- Usuários → Modelo de usuário: consulta usuários (evidence: `src/Controllers/UsuarioController.php`)
- Modelo de usuário → Papéis e permissões: usa papéis (evidence: `src/Models/Usuario.php`)
- Modelo de usuário → Permissões: usa permissões (evidence: `src/Models/Usuario.php`)
- Papéis e permissões → Permissões: compone permisos (evidence: `src/Enums/Role.php`)
- Agendamentos → Notificações: solicita alertas (evidence: `src/Controllers/AgendamentoController.php`)
- Notificações → Modelo de agendamento: usa agendamento (evidence: `src/Notifications/AgendamentoCadastrado.php`)
- Notificações → Modelo de usuário: notifica usuário (evidence: `src/Notifications/AgendamentoCadastrado.php`)
- Notificações → Envio de alertas: usa envio (evidence: `src/Notifications/AgendamentoCadastrado.php`)
- Agenda diária → Envio de alertas: envia alerta
- Auditoria → Registros de auditoria: grava alterações (evidence: `src/Traits/Auditable.php`)
- Modelo de agendamento → Auditoria: registra auditoria (evidence: `src/Models/Agendamento.php`)
- Disciplinas → Auditoria: registra auditoria
- Modelo de usuário → Auditoria: registra auditoria (evidence: `src/Models/Usuario.php`)
- Jobs → Modelo de job: consulta jobs (evidence: `src/Controllers/JobController.php`)
- Logs → Banco de dados: lê registros
- Modelo de agendamento → Banco de dados: persiste dados
- Modelo de usuário → Banco de dados: persiste dados
- Roteador → Renderização: retorna resposta
