ProfClick

Il piano di lavoro del docente, lezione per lezione.

Metti l'orario e il programma delle tue classi: ProfClick ricava tutte le lezioni dell'anno (festività e vacanze escluse), ti propone dove mettere spiegazioni e valutazioni per avere i voti che servono in ogni periodo e ogni settimana ti dice cosa fare. Spunti quello che hai fatto; se una lezione salta, il piano slitta da solo.

Pubblicato su profclick.federicodiluca.com, installabile come app (PWA). Le decisioni di progetto sono in docs/decisions.

Come funziona

• Anno scolastico già pronto: quadrimestri o trimestre + pentamestre, festività nazionali e Pasqua calcolate. Si adattano al calendario della propria regione.
• Classi: l'orario con i giorni, oppure solo le lezioni della settimana in ordine con le loro ore; le ore in laboratorio o con l'ITP. Regola dei voti: di default uno per ogni ora settimanale, con almeno uno scritto, un orale e un pratico; ore di educazione civica.
• Orario che cambia: il nuovo orario vale da una data; le lezioni prima restano nei loro giorni, il piano da lì passa sui nuovi giorni nello stesso ordine.
• Programma: si incolla da una nota di Keep o da un documento. Capisce un elenco di argomenti, l'elenco dei voti ("1️⃣ Reti (scritto)", "✳️ Flipped classroom (orale, 30%)") e la lista dei prossimi passi ("⚠️ Scritto", "⬅️" dove sei arrivato).
• Programma da un'altra classe: per le classi parallele o dagli anni precedenti, copiato con un tocco e poi ritoccato.
• Programma svolto e piano di lavoro come testo, con anteprima e "Copia": si incolla nel modello della scuola. Anche per le classi degli anni precedenti.
• Anno nuovo: a fine anno le classi con il loro programma vanno tra gli anni precedenti, da cui copiarlo nelle classi nuove; lezioni e riunioni si tolgono.
• Valutazioni previste per argomento, con il loro peso; la proposta le mette in calendario, le prove pratiche nelle ore con l'ITP. Argomenti e valutazioni già svolti si spuntano con un tocco, senza ricostruire le lezioni passate.
• Da fare: per ogni attività i suoi passi, prima (rivedere la lezione, esercizi, la prova con le sue versioni, e se servono slide e stampe) e dopo (correzione, riconsegna, voti sul registro), con il numero sul tab di quello che serve a breve. Quello da fare dopo resta finché non è fatto.
• Riunioni: consigli di classe, scrutini, GLO, collegi, dipartimenti e corsi, con le cose da preparare già proposte per tipo (e quelle in più per il coordinatore), e quelle da fare dopo, come il verbale per chi lo scrive, che restano finché non sono fatte. Compaiono nella settimana e nel Da fare; per consigli e scrutini c'è il riepilogo della classe ricavato dai dati (voti, argomenti svolti, educazione civica), da copiare nel verbale.
• Calendario: "Aggiungi a Google Calendar" per ogni verifica e riunione, o un file .ics con tutte.
• Per il registro: gli argomenti di una lezione, o di tutta la settimana fino a oggi, come testo da incollare nel registro elettronico, per giorno o per classe.
• Orario: la griglia con tutte le classi, da tenere sul telefono o stampare (anche in PDF).
• Proposta di piano a settimane: scegli gli argomenti e su quante settimane, e si distribuiscono con le loro valutazioni sulle lezioni vuote, da applicare con un tocco.
• Settimana: cosa fare in ogni classe, in ordine di ora, con la spunta di fatto.
• Note: una bacheca come quella di Keep, con titolo e testo libero; le righe con [ ] si spuntano, i link si aprono. Una nota collegata a una classe compare anche nei suoi Appunti.
• A colpo d'occhio: in Classi, per ogni classe, voti ed educazione civica del periodo, le lezioni rimaste e quanto resta da pianificare; in Anno, le settimane di scuola che restano. Le note per lo scrutinio stanno nei Voti della classe, periodo per periodo.
• Nessun server: i dati stanno sul dispositivo e, se colleghi Google, in un file sul tuo Drive. Le modifiche fatte da più dispositivi si uniscono da sole. Nessun dato degli studenti. Dettagli nell'informativa sulla privacy.
• Installabile: pulsante "Installa" che usa la finestra del browser dove c'è, e mostra le istruzioni passo passo su iPhone, iPad e Safari per Mac. Funziona offline e, quando esce una nuova versione, la propone.
• Consiglia ProfClick: in fondo alla pagina Anno, un'immagine pronta per le storie di Instagram passata al menu di condivisione del telefono (o scaricata).

Sviluppo

Node 22.

npm install
npm run dev     # landing su http://localhost:5173/, app su /app/
npm test        # logica pura in src/core e motore di sincronizzazione
npm run lint
npm run build
npm run icons:build     # rigenera le icone da scripts/icon-source.svg
npm run social:build    # rigenera l'immagine di anteprima public/social-share.png
npm run story:build     # rigenera l'immagine per le storie di Instagram public/story.png

Stack: Vite, React, TypeScript, Tailwind, shadcn/ui (Radix), Vitest, oxlint, vite-plugin-pwa; Google Identity Services e API REST di Drive chiamate dal browser, IndexedDB per i dati locali.

La sincronizzazione con Drive richiede un Client ID OAuth in .env.local:

VITE_GOOGLE_CLIENT_ID=xxxxxxxx.apps.googleusercontent.com

Senza Client ID l'app funziona solo sul dispositivo e il pulsante di Google non compare.

Da quando Settimana, Da fare e Orario passano alla settimana dopo (facoltativo):

VITE_NEXT_WEEK_TIME=19:00   # l'ora, l'ultimo giorno di scuola (default 19:00)
VITE_NEXT_WEEK_DAY=5        # il giorno, 1 lunedì … 7 domenica (default: dall'orario)

index.html      landing pubblica (statica, indicizzabile)
app/index.html  l'app (PWA, noindex)
src/
  core/        logica pura e testata: calendario, voti, proposta, unione dei dati
  google/      login e chiamate a Drive
  state/       stato React e motore di sincronizzazione
  features/    settimana · classi · classe (piano, programma, voti, appunti) · riunioni · anno
  components/  componenti condivisi e icone (ui/ = shadcn)
public/privacy/  informativa privacy (pagina statica)
docs/            decisioni (ADR) e logo per la schermata di consenso OAuth

Deploy

Ogni push su main esegue .github/workflows/deploy.yml: lint, test e build, poi pubblicazione su GitHub Pages con dominio profclick.federicodiluca.com (public/CNAME).

Autore

ProfClick è ideato e sviluppato da Federico Di Luca, sviluppatore software e docente. Altri progetti su federicodiluca.com/progetti.

Domande, segnalazioni o proposte: profclick@federicodiluca.com, oppure apri una issue.

Licenza

MIT © Federico Di Luca