~/home / guardiano-delle-ore / nextcloud
Guida · Self-hosting
Attiva il Guardiano delle ore nella tua Nextcloud
Sei passi, uno script idempotente, nessun lock-in: calendario, Deck, Talk e file della tua Nextcloud, guidati da un workflow n8n.
Requisiti
- Nextcloud 28 o più recente con Calendar, Deck, Talk e Files.
- n8n 2.x raggiungibile da Nextcloud (e viceversa).
- HTTPS su entrambi (QR code e PWA richiedono un contesto sicuro).
- Accesso a occ (shell sul server o docker exec) come admin.
I passi
1. Prepara Nextcloud con setup.sh
Crea i gruppi zeit-team, zeit-chef, zeit-demo, l'account del bot zeitwaechter (500 MB) e, se vuoi, il tuo capo. Idempotente: puoi rilanciarlo quando vuoi. Variabili: OCC, DEMO, CHEF_UID, CHEF_NAME, CHEF_MAIL, SECRETS_DIR (dove viene scritto bot.pass, chmod 600).
# Docker AIO (Standard des Skripts) CHEF_UID=mario CHEF_NAME="Mario Rossi" CHEF_MAIL=mario@firma.example DEMO=0 ./setup.sh # Docker Compose (Dienst "app") OCC="docker compose exec -T -u www-data -e OC_PASS app php occ" DEMO=0 CHEF_UID=mario CHEF_MAIL=mario@firma.example ./setup.sh # Bare metal OCC="sudo -u www-data --preserve-env=OC_PASS php /var/www/nextcloud/occ" DEMO=0 SECRETS_DIR=/root/zeit-secrets ./setup.sh ./setup.sh --check # nur Status ./setup.sh --demo-off # Demo-Konten deaktivieren (--purge: löschen)2. Accesso per n8n
In n8n crea una credenziale Basic Auth: utente zeitwaechter, password da bot.pass. Meglio: accedi come zeitwaechter, Impostazioni, Sicurezza, crea una password per app e usa quella (revocabile da sola). Assegna la credenziale a ogni nodo HTTP Nextcloud.
3. Importa il workflow
Importa assets/n8n/zeitwaechter.json. Nel nodo «Demo-Bereich festlegen» inserisci host, utente, calendario, board Deck e token Talk. Crea prima, nell'account del bot, il calendario, la board Deck (con uno stack) e la stanza Talk.
const NC = 'https://cloud.example.com'; const USER = 'zeitwaechter'; const TALK = `${NC}/ocs/v2.php/apps/spreed/api/v1/chat/YOUR-TALK-TOKEN`; // + calendar slug (CAL), Deck board/stack ids (DECK)4. Cambia i segreti
Sostituisci i due percorsi dei webhook (…-CHANGE-ME) e il segreto HMAC CHANGE-ME-LONG-RANDOM-SECRET. Il segreto deve essere identico in tutti i nodi Code (usa la ricerca di n8n). Il percorso è il segreto: almeno 24 caratteri casuali. Un nuovo segreto invalida i QR del giorno e i telefoni registrati.
openssl rand -hex 32 # HMAC secret / webhook path5. Attiva e prova
Attiva il workflow e compila https://TUO-N8N/form/zeitwaechter: devono comparire un evento nel calendario, una scheda Deck e un messaggio Talk.
6. App sul telefono (PWA, facoltativa)
Le pagine /zeit/, /zeit/anmelden/, /zeit/s/, /zeit-qr/ sono statiche. zeit-punch.php è un proxy same-origin verso il webhook di timbratura (legge il percorso da private/zeit-punch-hook, n8n su 127.0.0.1:5678, variabili ZP_N8N/ZP_PRIV; adatta l'elenco ZP_PEOPLE). Senza PWA: usa solo i due moduli n8n e stampa i QR dal webhook qr.
location = /zeit-punch.php { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root/zeit-punch.php; fastcgi_pass unix:/run/php/php-fpm.sock; } location ^~ /private/ { deny all; } # better: private/ outside the web root # private/zeit-punch-hook = one line: the path of the n8n stamp webhook
Che cos'è il Login Flow v2?
È il modo in cui Nextcloud rilascia una password per app senza che la password dell'account sia mai digitata in software di terzi: il client chiama POST /index.php/login/v2, l'utente approva nel browser, il client riceve loginName e appPassword (revocabile in qualsiasi momento in Impostazioni, Sicurezza). Creare a mano la password per app del bot (passo 2) è equivalente.
Ruoli
zeit-teamDipendenti: vedono solo i propri dati.zeit-chefCapo: vede tutto il team.zeit-demoAccount demo fittizi: non possono condividere, 20 MB, nessun dato reale.
Quali dati finiscono dove
- Calendario del bot: un evento per giornata lavorata o assenza
- Deck: una scheda per avviso o violazione dell'orario
- Talk: avvisi e riepilogo del venerdì
- File del bot (Zeit/): zeiten.csv, stempel.csv, geraete.json, Berichte/
- Condivisione: per utente o gruppo, mai pubblica
Privacy
Rimozione completa
Lo script di rimozione chiede conferma a ogni passo, all'inizio solo disattiva, non cancella mai utenti veri e cancella bot e account demo con i dati solo con --delete-data e scrivendo LOESCHEN. Poi: disattiva il workflow n8n, elimina la credenziale, togli dal web server le pagine PWA e private/zeit-punch-hook.
./uninstall.sh --dry-run # show only
./uninstall.sh # asks at each step; disables accounts, removes groups
./uninstall.sh --delete-data # may DELETE bot + demo accounts with data (type LOESCHEN)