Prova il guardiano delle ore → La pagina controlla un inserimento nel browser e disegna un grafico dal vivo. I moduli veri sono su mikweb.eu/form/zeitwaechter (ore) e /zeitwaechter-abwesenheit (assenze). Sono tutti dati demo e le persone sono inventate (Musterbüro GmbH).
Perché
Dalla sentenza del Tribunale federale del lavoro del 13.09.2022 (1 ABR 22/21) i datori di lavoro tedeschi devono registrare l'orario. Spesso basta un foglio di calcolo. Quello che non fa è dirti che ieri qualcuno ha lavorato 11 ore senza una pausa adeguata e oggi ricomincia alle 06:00. Di solito lo si scopre quando qualcuno legge l'elenco a fine mese. Volevo che la violazione facesse partire una scheda e un messaggio la sera stessa, senza niente di più esotico di n8n, Nextcloud e un CSV.
Stato legale: l'obbligo di registrazione vale dal 2022. Una riforma della legge sull'orario di lavoro (bozza del ministero federale del lavoro) a giugno 2026, per quanto ne sapevo, non era ancora approvata. Verifica lo stato di oggi. Questo è un esempio tecnico e non è consulenza legale.
Cosa fa il workflow
- Due moduli n8n: ore (persona, data, inizio, fine, pausa, progetto, attività) e assenza (persona, dal, al, tipo: ferie, malattia o recupero ore).
- Validazione dell'input (formato, orari, data) e salvataggio in
zeiten.csvsu Nextcloud via WebDAV. - Controllo ArbZG su tutte le righe, poi confronto con lo stato prima dell'inserimento: solo le violazioni nuove fanno scattare qualcosa.
- A ogni nuova violazione: una scheda in Nextcloud Deck e un messaggio in Talk.
- Le assenze diventano eventi CalDAV. Un secondo controllo trova le ore registrate in un giorno di assenza.
- Venerdì alle 15:00: report settimanale in Markdown e come dashboard SVG su Nextcloud, più Talk.
- Lunedì: reset dei dati demo.
Le regole
- § 3: al massimo 10 ore al giorno, in media 8.
- § 4: pausa di 30 minuti oltre 6 ore, di 45 minuti oltre 9.
- § 5: 11 ore di riposo ininterrotto tra due giornate di lavoro.
- § 9: lavoro domenicale.
- Avviso: più di 48 ore in una settimana. Un avviso, non una violazione: la legge ragiona su medie.
Tutto questo è codice deterministico (core.js, più di 100 controlli passano con node test_core.js). L'AI (IONOS gpt-oss-120b) scrive solo tre frasi del report settimanale e non vede nomi, solo numeri. Se qualcuno ha violato la legge non lo decide mai un modello linguistico.
Scritture concorrenti: ETag e If-Match
Due persone inviano insieme, entrambe leggono il CSV, entrambe lo riscrivono: un inserimento sparisce. Quindi locking ottimistico su WebDAV: il GET restituisce il file con l'ETag, il PUT manda If-Match: <ETag>. Se nel frattempo il file è cambiato, Nextcloud risponde 412 Precondition Failed. Il workflow rilegge e riprova, fino a tre volte. Al terzo fallimento lo dice, invece di sovrascrivere in silenzio.
Cosa ho imparato su n8n 2.46.6
- Non impostare «Respond When» su «Using Respond to Webhook». Con Form Trigger v2.5 e il nodo n8n Form compare «Respond to Webhook not supported in workflows initiated by Form Trigger» oppure «No Respond to Webhook node found». Lascia il default: la risposta la dà il nodo Form.
- Il nodo Form con operazione Completion e «Show Text» accetta HTML completo. La risposta può essere una pagina intera, anche con un grafico SVG inline. In pratica: il POST del modulo restituisce JSON con
formWaitingUrl, il browser va su/form-waiting/<id>e lì compare la pagina. - HTTP Request con risposta completa e testo: il contenuto è in
data, non inbody. Il miores.bodyeraundefinede il CSV è stato riscritto con una sola riga. Da allora c'è una guardia anti-perdita dati: se il parsing dà zero righe benché il file non sia vuoto, l'esecuzione si ferma invece di scrivere. - Quale dei cinque trigger è partito? Si controlla con
$('Nodo').isExecuted; così un solo workflow li serve tutti. - Nel nodo Code non esiste la classe
URL. Usa le espressioni regolari. - CSV injection. Le celle che iniziano con
=,+,-o@ricevono un'davanti. Altrimenti Excel esegue una formula nascosta in un nome di progetto. - WebDAV di Nextcloud:
If-Matchcon l'ETag del GET funziona, un ETag vecchio dà 412. È esattamente ciò che serve.
Timbrare con un QR code: niente più modulo
I moduli vanno bene in ufficio. Chi lavora in produzione, in magazzino o in giro vuole solo scansionare. Per questo c'è una seconda strada, sempre tutta in n8n e Nextcloud:
- Registrare il telefono una volta (/it/zeit/registra/): si sceglie la persona e il telefono riceve un token casuale. Nel workflow resta solo l'hash SHA-256, in
geraete.jsonsu Nextcloud. Nella demo sono le quattro persone fittizie; in uso reale l'amministrazione manderebbe un link d'invito. - QR del giorno all'ingresso (/it/zeit-qr/): quattro codici (inizio, pausa, ripresa, fine). Ognuno è un HMAC-SHA-256 di data e tipo, con la chiave solo sul server. Domani tutti i codici cambiano, una foto di ieri non serve.
- Scansione con la fotocamera: la pagina timbra da sola. L'ora la mette n8n (ora di Berlino del server), mai il telefono. Solo alla fine compare un campo per l'attività.
- Macchina a stati per persona e giorno: inizio, (pausa, ripresa) quante volte serve, fine. Inizio due volte dà
wrong_state. Ogni timbro finisce instempel.csv. - Alla fine diventa una registrazione e passa dagli stessi nodi del modulo: sovrapposizione, controllo ArbZG, Deck, Talk, calendario assenze.
Due note: SHA-256 e HMAC sono JavaScript puro nel nodo Code (niente crypto, niente require), verificati con i vettori di test RFC 4231. E onestamente: un QR si può fotografare e inoltrare. Token del dispositivo e codice del giorno lo rendono più difficile, non lo impediscono. Uno schermo con codice a rotazione o un controllo di posizione sarebbero il passo dopo. I dati orari legati a un telefono privato sono dati personali: in uso reale servono informativa e base giuridica (consiglio aziendale, privacy).
Prova e scarica
Scarica il JSON del workflow → Importalo, inserisci le tue credenziali Nextcloud e IONOS e adatta percorso Nextcloud, board Deck e stanza Talk. Nel JSON non ci sono segreti. Le frasi AI sono facoltative: senza credenziale il report resta ai numeri.
Limiti
È un allestimento demo, non un sistema di presenze per l'azienda. I dati sono inventati. Niente consiglio d'azienda, niente contratti collettivi, niente eccezioni ex § 7 o regole di settore (assistenza, ristorazione, trasporti), e per minori, gestanti e autisti valgono altre norme. Le soglie seguono il testo di legge ma non sostituiscono la verifica di chi conosce la tua azienda. Cosa cambia la riforma qui non c'è: leggi lo stato attuale.
Correlato: il test del timbro mostra perché «una persona ci dà un'occhiata» non basta da sola. Qui controlla il codice e la persona vede solo i casi che contano.