# joaomanoel90/chamada architecture

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

## Overview

Chamada de Alunos is a municipal-school web application for attendance, student records, classroom administration and annual reporting. School staff use the dashboard to reach daily attendance; the wider workflow also covers student/class setup, diary grades, observations, transfers and progression. The README documents these capabilities and the SQL Server backend. Page-to-processor edges are supported where the source index names the processor; unsampled domain links are documented in the README rather than inferred from folder names.

Main entry points: [`chamada/processa/index_processa.php`](https://github.com/joaomanoel90/chamada/blob/main/chamada/processa/index_processa.php) (Daily attendance), [`alunos/processa/index_processa.php`](https://github.com/joaomanoel90/chamada/blob/main/alunos/processa/index_processa.php) (Student records), [`index.php`](https://github.com/joaomanoel90/chamada/blob/main/index.php) (Dashboard), [`substituicoes/processa/index_processa.php`](https://github.com/joaomanoel90/chamada/blob/main/substituicoes/processa/index_processa.php) (Substitutions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and overview"]
  node_dashboard["Dashboard<br/>[index.php]"]
  node_dashboard_data["Dashboard data"]
  node_login["CPF login<br/>[login.php]"]
end

subgraph group_school["School administration"]
  node_classrooms["Classrooms<br/>[index_processa.php]"]
  node_assignments["Teacher assignments<br/>[index_processa.php]"]
  node_staffing["Substitutions<br/>[index_processa.php]"]
  node_teacher_absences["Teacher absences<br/>[index_processa.php]"]
  node_units["School units<br/>[index_processa.php]"]
  node_users["Users and access<br/>[index_processa.php]"]
end

subgraph group_attendance["Attendance and learning"]
  node_attendance["Daily attendance<br/>[index_processa.php]"]
  node_attendance_history["Attendance history<br/>[historico.php]"]
  node_diary["Class diary<br/>[index_processa.php]"]
  node_holidays["Holidays<br/>[index_processa.php]"]
end

subgraph group_student["Student lifecycle"]
  node_students["Student records<br/>[index_processa.php]"]
  node_families["Families<br/>[index_processa.php]"]
  node_observations["Development notes<br/>[index_processa.php]"]
  node_annual_reports["Annual reports<br/>[index_processa.php]"]
  node_transfers["Transfers<br/>[index_processa.php]"]
  node_promotions["Progression<br/>[index_processa.php]"]
end

subgraph group_shared["Shared infrastructure"]
  node_database[("SQL Server<br/>[database.php]")]
  node_configuration["App configuration<br/>[config.php]"]
end

node_staff(("School staff"))

node_staff -->|"signs in"| node_login
node_staff -->|"opens"| node_dashboard
node_dashboard -->|"loads"| node_dashboard_data
node_dashboard -->|"opens"| node_attendance
node_dashboard -->|"opens"| node_students
node_dashboard -->|"opens"| node_transfers
node_students -->|"links families"| node_families
node_students -->|"records attendance"| node_attendance
node_attendance -->|"audits changes"| node_attendance_history
node_attendance -->|"applies closures"| node_holidays
node_attendance -->|"honors coverage"| node_staffing
node_diary -->|"integrates frequency"| node_attendance
node_students -->|"records development"| node_observations
node_annual_reports -->|"summarizes frequency"| node_attendance
node_annual_reports -->|"includes notes"| node_observations
node_transfers -->|"moves students"| node_students
node_promotions -->|"advances students"| node_students
node_assignments -->|"assigns teachers"| node_classrooms
node_staffing -->|"covers classes"| node_classrooms
node_teacher_absences -->|"reports coverage"| node_staffing
node_users -->|"scopes access"| node_units
node_configuration -->|"configures connection"| node_database

click node_dashboard "https://github.com/joaomanoel90/chamada/blob/main/index.php"
click node_dashboard_data "https://github.com/joaomanoel90/chamada/blob/main/processa/dashboard_processa.php"
click node_login "https://github.com/joaomanoel90/chamada/blob/main/login.php"
click node_classrooms "https://github.com/joaomanoel90/chamada/blob/main/turmas/processa/index_processa.php"
click node_assignments "https://github.com/joaomanoel90/chamada/blob/main/atribuicoes/processa/index_processa.php"
click node_staffing "https://github.com/joaomanoel90/chamada/blob/main/substituicoes/processa/index_processa.php"
click node_teacher_absences "https://github.com/joaomanoel90/chamada/blob/main/faltas/processa/index_processa.php"
click node_units "https://github.com/joaomanoel90/chamada/blob/main/unidades/processa/index_processa.php"
click node_users "https://github.com/joaomanoel90/chamada/blob/main/usuarios/processa/index_processa.php"
click node_attendance "https://github.com/joaomanoel90/chamada/blob/main/chamada/processa/index_processa.php"
click node_attendance_history "https://github.com/joaomanoel90/chamada/blob/main/chamada/historico.php"
click node_diary "https://github.com/joaomanoel90/chamada/blob/main/diario/processa/index_processa.php"
click node_students "https://github.com/joaomanoel90/chamada/blob/main/alunos/processa/index_processa.php"
click node_families "https://github.com/joaomanoel90/chamada/blob/main/familias/processa/index_processa.php"
click node_observations "https://github.com/joaomanoel90/chamada/blob/main/observacoes/processa/index_processa.php"
click node_annual_reports "https://github.com/joaomanoel90/chamada/blob/main/relatorios/processa/index_processa.php"
click node_transfers "https://github.com/joaomanoel90/chamada/blob/main/transferencias/processa/index_processa.php"
click node_promotions "https://github.com/joaomanoel90/chamada/blob/main/promocoes/processa/index_processa.php"
click node_holidays "https://github.com/joaomanoel90/chamada/blob/main/feriados/processa/index_processa.php"
click node_database "https://github.com/joaomanoel90/chamada/blob/main/inc/database.php"
click node_configuration "https://github.com/joaomanoel90/chamada/blob/main/config.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_dashboard,node_dashboard_data,node_login toneBlue
class node_classrooms,node_assignments,node_staffing,node_teacher_absences,node_units,node_users toneAmber
class node_attendance,node_attendance_history,node_diary,node_holidays toneMint
class node_students,node_families,node_observations,node_annual_reports,node_transfers,node_promotions toneRose
class node_database,node_configuration,node_staff toneIndigo
```

## Components

### Access and overview

- [Dashboard](https://github.com/joaomanoel90/chamada/blob/main/index.php): `index.php`
- [Dashboard data](https://github.com/joaomanoel90/chamada/blob/main/processa/dashboard_processa.php): `processa/dashboard_processa.php`
- [CPF login](https://github.com/joaomanoel90/chamada/blob/main/login.php): `login.php`

### School administration

- [Classrooms](https://github.com/joaomanoel90/chamada/blob/main/turmas/processa/index_processa.php): `turmas/processa/index_processa.php`
- [Teacher assignments](https://github.com/joaomanoel90/chamada/blob/main/atribuicoes/processa/index_processa.php): `atribuicoes/processa/index_processa.php`
- [Substitutions](https://github.com/joaomanoel90/chamada/blob/main/substituicoes/processa/index_processa.php): `substituicoes/processa/index_processa.php`
- [Teacher absences](https://github.com/joaomanoel90/chamada/blob/main/faltas/processa/index_processa.php): `faltas/processa/index_processa.php`
- [School units](https://github.com/joaomanoel90/chamada/blob/main/unidades/processa/index_processa.php): `unidades/processa/index_processa.php`
- [Users and access](https://github.com/joaomanoel90/chamada/blob/main/usuarios/processa/index_processa.php): `usuarios/processa/index_processa.php`

### Attendance and learning

- [Daily attendance](https://github.com/joaomanoel90/chamada/blob/main/chamada/processa/index_processa.php): `chamada/processa/index_processa.php`
- [Attendance history](https://github.com/joaomanoel90/chamada/blob/main/chamada/historico.php): `chamada/historico.php`
- [Class diary](https://github.com/joaomanoel90/chamada/blob/main/diario/processa/index_processa.php): `diario/processa/index_processa.php`
- [Holidays](https://github.com/joaomanoel90/chamada/blob/main/feriados/processa/index_processa.php): `feriados/processa/index_processa.php`

### Student lifecycle

- [Student records](https://github.com/joaomanoel90/chamada/blob/main/alunos/processa/index_processa.php): `alunos/processa/index_processa.php`
- [Families](https://github.com/joaomanoel90/chamada/blob/main/familias/processa/index_processa.php): `familias/processa/index_processa.php`
- [Development notes](https://github.com/joaomanoel90/chamada/blob/main/observacoes/processa/index_processa.php): `observacoes/processa/index_processa.php`
- [Annual reports](https://github.com/joaomanoel90/chamada/blob/main/relatorios/processa/index_processa.php): `relatorios/processa/index_processa.php`
- [Transfers](https://github.com/joaomanoel90/chamada/blob/main/transferencias/processa/index_processa.php): `transferencias/processa/index_processa.php`
- [Progression](https://github.com/joaomanoel90/chamada/blob/main/promocoes/processa/index_processa.php): `promocoes/processa/index_processa.php`

### Shared infrastructure

- [SQL Server](https://github.com/joaomanoel90/chamada/blob/main/inc/database.php): `inc/database.php`
- [App configuration](https://github.com/joaomanoel90/chamada/blob/main/config.php): `config.php`

### Other components

- **School staff**

## Connections

- School staff → CPF login: signs in (evidence: `README.md`)
- School staff → Dashboard: opens (evidence: `index.php`)
- Dashboard → Dashboard data: loads (evidence: `index.php`)
- Dashboard → Daily attendance: opens (evidence: `index.php`)
- Dashboard → Student records: opens (evidence: `index.php`)
- Dashboard → Transfers: opens (evidence: `index.php`)
- Student records → Families: links families (evidence: `README.md`)
- Student records → Daily attendance: records attendance (evidence: `README.md`)
- Daily attendance → Attendance history: audits changes (evidence: `README.md`)
- Daily attendance → Holidays: applies closures (evidence: `README.md`)
- Daily attendance → Substitutions: honors coverage (evidence: `README.md`)
- Class diary → Daily attendance: integrates frequency (evidence: `README.md`)
- Student records → Development notes: records development (evidence: `README.md`)
- Annual reports → Daily attendance: summarizes frequency (evidence: `README.md`)
- Annual reports → Development notes: includes notes (evidence: `README.md`)
- Transfers → Student records: moves students (evidence: `README.md`)
- Progression → Student records: advances students (evidence: `README.md`)
- Teacher assignments → Classrooms: assigns teachers (evidence: `README.md`)
- Substitutions → Classrooms: covers classes (evidence: `README.md`)
- Teacher absences → Substitutions: reports coverage (evidence: `README.md`)
- Users and access → School units: scopes access (evidence: `README.md`)
- App configuration → SQL Server: configures connection (evidence: `README.md`)
