# gabriele-d-cambria/laureandosi-a-isw-project architecture

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

- Interactive diagram: https://gitdiagram.com/gabriele-d-cambria/laureandosi-a-isw-project
- Repository: https://github.com/gabriele-d-cambria/laureandosi-a-isw-project

## Overview

Laureandosi generates individual graduate reports and a commission PDF from student records, configured course rules, and exam data; staff can open the commission report or send individual reports by email. The sampled code shows generation and report construction, but not the frontend’s request wiring or the mail transport, so those relationships are omitted. The README also documents configurable exam rules and course-specific processing; unsampled configuration capabilities are retained without asserting unsupported calls.

Main entry points: [`src/class/CarrieraLaureandoInformatica.php`](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CarrieraLaureandoInformatica.php) (Informatics career), [`src/class/ProspettoLaureando.php`](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoLaureando.php) (Graduate report), [`src/class/CarrieraLaureando.php`](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CarrieraLaureando.php) (Graduate career), [`index.php`](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/index.php) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Staff interface"]
  node_web["Web interface<br/>[index.php]"]
  node_browser["Browser behavior<br/>[script.js]"]
  node_api["Request handler<br/>[requestHandler.php]"]
end

subgraph group_workflow["Report workflow"]
  node_generator["Report workflow"]
  node_definitions["Runtime paths<br/>[definitions.php]"]
end

subgraph group_academic["Academic data"]
  node_identity["Graduate identity"]
  node_career["Graduate career"]
  node_informatics["Informatics career"]
  node_exam["Exam model<br/>[Esame.php]"]
  node_informatics_exam["Informatics exams"]
  node_informatics_exam_model["Informatics exam"]
  node_student_system["Student record wrapper"]
  node_student_data[("Student records")]
end

subgraph group_rules["Rules and configuration"]
  node_report_rules["Course calculations"]
  node_exam_filter["Exam filters<br/>[FiltroEsami.php]"]
  node_config["Configuration files"]
end

subgraph group_delivery["Report delivery"]
  node_commission["Commission report"]
  node_studentreport["Graduate report"]
  node_pdf["PDF rendering<br/>[ProspettoPDF.php]"]
  node_mailer["Email sender<br/>[MailSender.php]"]
end

node_staff(("Teaching staff"))

node_staff -->|"uses"| node_web
node_web -->|"loads"| node_browser
node_web -->|"loads course options"| node_report_rules
node_api -->|"dispatches to"| node_generator
node_generator -->|"creates"| node_commission
node_generator -->|"sends through"| node_mailer
node_commission -->|"creates"| node_studentreport
node_commission -->|"renders"| node_pdf
node_studentreport -->|"loads"| node_identity
node_studentreport -->|"selects career"| node_career
node_studentreport -->|"selects for course"| node_informatics
node_studentreport -->|"renders"| node_pdf
node_career -->|"fetches career"| node_student_system
node_career -->|"filters exams"| node_exam_filter
node_career -->|"builds exams"| node_exam
node_informatics -->|"extends"| node_career
node_informatics -->|"fetches career"| node_student_system
node_informatics -->|"filters exams"| node_exam_filter
node_informatics -->|"checks membership"| node_informatics_exam
node_informatics -->|"creates exams"| node_informatics_exam_model
node_informatics_exam_model -->|"extends"| node_exam
node_identity -->|"fetches identity"| node_student_system
node_student_system -->|"reads records"| node_student_data
node_exam -->|"gets honors value"| node_report_rules
node_exam_filter -->|"loads exam filters"| node_config
node_report_rules -->|"loads course rules"| node_config
node_web -->|"loads paths"| node_definitions
node_generator -->|"uses output paths"| node_definitions

click node_web "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/index.php"
click node_browser "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/frontend/script.js"
click node_api "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/API/requestHandler.php"
click node_generator "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/GeneratoreProspettiLaurea.php"
click node_commission "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoCommissione.php"
click node_studentreport "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoLaureando.php"
click node_pdf "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoPDF.php"
click node_mailer "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/MailSender.php"
click node_identity "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/AnagraficaLaureando.php"
click node_career "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CarrieraLaureando.php"
click node_informatics "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CarrieraLaureandoInformatica.php"
click node_exam "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/Esame.php"
click node_informatics_exam "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/EsamiInformatica.php"
click node_informatics_exam_model "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/EsameInformatica.php"
click node_student_system "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/GestioneCarrieraStudente.php"
click node_student_data "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/tree/master/resources"
click node_report_rules "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CalcoloReportistica.php"
click node_exam_filter "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/FiltroEsami.php"
click node_config "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/tree/master/config"
click node_definitions "https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/includes/definitions.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_web,node_browser,node_api toneBlue
class node_generator,node_definitions toneAmber
class node_identity,node_career,node_informatics,node_exam,node_informatics_exam,node_informatics_exam_model,node_student_system,node_student_data toneMint
class node_report_rules,node_exam_filter,node_config toneRose
class node_commission,node_studentreport,node_pdf,node_mailer,node_staff toneIndigo
```

## Components

### Staff interface

- [Web interface](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/index.php): `index.php`
- [Browser behavior](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/frontend/script.js): `frontend/script.js`
- [Request handler](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/API/requestHandler.php): `src/API/requestHandler.php`

### Report workflow

- [Report workflow](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/GeneratoreProspettiLaurea.php): `src/class/GeneratoreProspettiLaurea.php`
- [Runtime paths](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/includes/definitions.php): `src/includes/definitions.php`

### Academic data

- [Graduate identity](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/AnagraficaLaureando.php): `src/class/AnagraficaLaureando.php`
- [Graduate career](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CarrieraLaureando.php): `src/class/CarrieraLaureando.php`
- [Informatics career](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CarrieraLaureandoInformatica.php): `src/class/CarrieraLaureandoInformatica.php`
- [Exam model](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/Esame.php): `src/class/Esame.php`
- [Informatics exams](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/EsamiInformatica.php): `src/class/EsamiInformatica.php`
- [Informatics exam](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/EsameInformatica.php): `src/class/EsameInformatica.php`
- [Student record wrapper](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/GestioneCarrieraStudente.php): `src/class/GestioneCarrieraStudente.php`
- [Student records](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/tree/master/resources): `resources`

### Rules and configuration

- [Course calculations](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/CalcoloReportistica.php): `src/class/CalcoloReportistica.php`
- [Exam filters](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/FiltroEsami.php): `src/class/FiltroEsami.php`
- [Configuration files](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/tree/master/config): `config`

### Report delivery

- [Commission report](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoCommissione.php): `src/class/ProspettoCommissione.php`
- [Graduate report](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoLaureando.php): `src/class/ProspettoLaureando.php`
- [PDF rendering](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/ProspettoPDF.php): `src/class/ProspettoPDF.php`
- [Email sender](https://github.com/gabriele-d-cambria/laureandosi-a-isw-project/blob/master/src/class/MailSender.php): `src/class/MailSender.php`

### Other components

- **Teaching staff**

## Connections

- Teaching staff → Web interface: uses (evidence: `README.md`)
- Web interface → Browser behavior: loads (evidence: `index.php`)
- Web interface → Course calculations: loads course options (evidence: `index.php`)
- Request handler → Report workflow: dispatches to (evidence: `src/API/requestHandler.php`)
- Report workflow → Commission report: creates (evidence: `src/class/GeneratoreProspettiLaurea.php`)
- Report workflow → Email sender: sends through (evidence: `src/class/GeneratoreProspettiLaurea.php`)
- Commission report → Graduate report: creates (evidence: `src/class/ProspettoCommissione.php`)
- Commission report → PDF rendering: renders (evidence: `src/class/ProspettoCommissione.php`)
- Graduate report → Graduate identity: loads (evidence: `src/class/ProspettoLaureando.php`)
- Graduate report → Graduate career: selects career (evidence: `src/class/ProspettoLaureando.php`)
- Graduate report → Informatics career: selects for course (evidence: `src/class/ProspettoLaureando.php`)
- Graduate report → PDF rendering: renders (evidence: `src/class/ProspettoLaureando.php`)
- Graduate career → Student record wrapper: fetches career (evidence: `src/class/CarrieraLaureando.php`)
- Graduate career → Exam filters: filters exams (evidence: `src/class/CarrieraLaureando.php`)
- Graduate career → Exam model: builds exams (evidence: `src/class/CarrieraLaureando.php`)
- Informatics career → Graduate career: extends (evidence: `src/class/CarrieraLaureandoInformatica.php`)
- Informatics career → Student record wrapper: fetches career (evidence: `src/class/CarrieraLaureandoInformatica.php`)
- Informatics career → Exam filters: filters exams (evidence: `src/class/CarrieraLaureandoInformatica.php`)
- Informatics career → Informatics exams: checks membership (evidence: `src/class/CarrieraLaureandoInformatica.php`)
- Informatics career → Informatics exam: creates exams (evidence: `src/class/CarrieraLaureandoInformatica.php`)
- Informatics exam → Exam model: extends (evidence: `src/class/CarrieraLaureandoInformatica.php`)
- Graduate identity → Student record wrapper: fetches identity (evidence: `src/class/AnagraficaLaureando.php`)
- Student record wrapper → Student records: reads records (evidence: `src/class/GestioneCarrieraStudente.php`)
- Exam model → Course calculations: gets honors value (evidence: `src/class/Esame.php`)
- Exam filters → Configuration files: loads exam filters (evidence: `src/class/FiltroEsami.php`)
- Course calculations → Configuration files: loads course rules (evidence: `src/class/CalcoloReportistica.php`)
- Web interface → Runtime paths: loads paths (evidence: `index.php`)
- Report workflow → Runtime paths: uses output paths (evidence: `src/class/GeneratoreProspettiLaurea.php`)
