DE EN IT

~/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. 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. 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. 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. 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 path
  5. 5. 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. 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-team Dipendenti: vedono solo i propri dati.
  • zeit-chef Capo: vede tutto il team.
  • zeit-demo Account 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

Sono dati di lavoratori. Verifica la base giuridica (obbligo di registrare l'orario, art. 6 GDPR), coinvolgi sindacati o rappresentanze dove richiesto (art. 4 Statuto dei lavoratori; in Germania § 87 BetrVG) e dai ai dipendenti l'informativa dell'art. 13 GDPR (finalità, destinatari, tempi, diritti). Conservazione nei file di lavoro: 70 giorni; se la legge impone tempi più lunghi (in Germania § 16 ArbZG: 2 anni per le ore oltre 8), archivia a parte. Non è consulenza legale.

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)

Download