Documentazione Schuly

Schuly è un'app mobile Flutter per accedere ai dati scolastici (voti, esami, agenda, assenze) dei sistemi basati su Schulnetz. Funziona in due modalità - una modalità account, basata su SchulyBackend tramite OIDC, e una modalità privata / sicura, che mantiene le credenziali sul dispositivo e comunica solo con endpoint proxy anonimi e senza stato. L'interfaccia è realizzata con Forui.

Indice

Documento	Contenuto
Architettura: modalità dell'app	Modalità account vs privata, dove risiedono i dati, il flusso di connessione
Configurazione per lo sviluppo	SDK Flutter, task runner bun, esecuzione dei flavor dev/prod, analyze/test/format
Build & release	APK di release, build iOS, installazione via adb, rigenerazione dell'icona dell'app
Client API	Come viene generato lib/api/ e come rigenerarlo
Contribuire	Il workflow obbligatorio issue → branch → PR e la tassonomia delle label

Avvio rapido

bun run clean   # flutter clean && flutter pub get
bun run dev     # esegue il flavor dev su un dispositivo/emulatore connesso

Per i prerequisiti vedi Configurazione per lo sviluppo.