> For the complete documentation index, see [llms.txt](https://sponta.gitbook.io/orario/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sponta.gitbook.io/orario/readme.md).

# Orario — Guida al progetto

Questa guida spiega come Orario rappresenta una scuola, costruisce una bozza di orario e la trasforma in una pubblicazione approvata. È rivolta a chi vuole comprendere le logiche del progetto e a chi deve orientarsi nel codice.

## Da dove iniziare

| Vuoi capire…                                              | Leggi                                                                         |
| --------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Quale problema affronta il progetto                       | [Il progetto in breve](/orario/comprendere-orario/progetto.md)                |
| Come si collegano classi, docenti, curricoli e vincoli    | [Il dominio scolastico](/orario/comprendere-orario/dominio.md)                |
| Quali componenti esistono e dove cercarli                 | [Mappa dell'architettura](/orario/comprendere-orario/architettura.md)         |
| Cosa accade dai dati alla pubblicazione                   | [Come nasce un orario](/orario/comprendere-orario/flusso-orario.md)           |
| Come distinguere incompatibilità, bozza vuota e conflitti | [Verifica dei dati e della bozza](/orario/comprendere-orario/verifica.md)     |
| Quali funzioni offre l'applicazione                       | [Funzioni dell'applicazione](/orario/funzioni-e-dettagli-tecnici/funzioni.md) |
| Come funzionano i servizi centrali                        | [Funzioni interne](/orario/funzioni-e-dettagli-tecnici/funzioni-interne.md)   |
| Come consultare e integrare le API                        | [API e integrazioni](/orario/funzioni-e-dettagli-tecnici/api.md)              |

Per una prima lettura, segui l'ordine della tabella. Ogni pagina introduce i concetti prima di indicare i moduli che li implementano.

## Il punto di partenza

Il curricolo stabilisce quali attività servono; le cattedre confermate indicano chi le insegna; calendari e vincoli delimitano le collocazioni. Il generatore cerca una soluzione e il livello applicativo ne gestisce l'adozione nella bozza. La consultazione mostra una fotografia approvata.

Queste distinzioni spiegano perché una generazione conclusa, una bozza completa e un orario pubblicato sono momenti diversi del lavoro.

## Stato della documentazione

La guida è aggiornata al commit `3bf5b58` dell'11 settembre 2026. Comprende una mappa delle funzioni, i contratti dei servizi centrali, il catalogo HTTP e una prima specifica OpenAPI della consultazione pubblica. Il dettaglio di tutti gli algoritmi e dei payload delle API di modifica resta da approfondire.

Consulta [Come leggere questa guida](/orario/riferimenti-della-guida/come-leggere.md) per il riferimento di versione e il rapporto con la documentazione storica.