# SHIFTDECK Beta-Kanal · Changelog

> Dieser Changelog dokumentiert **ausschließlich Beta-Iterationen**.
> Stable-Releases (Hauptversionen) findest du unter [`/download/CHANGELOG.md`](https://shiftdeck.de/download/CHANGELOG.md).

## v7.83 - 14. Juli 2026 · Professionelle Druckansichten in allen Branchenmodulen

- **Neues Dokument-Design überall:** Handwerk & Bau (v1.3), Gastronomie (v1.3, HACCP-Nachweis), Pflege & Soziales (v1.1, Leistungsnachweis), Hotel & Beherbergung (v1.1, Night-Audit), Einzelhandel & Retail (v2.1, Kassenbuch-Tagesbericht), Sicherheitsdienst (v1.1, Vorkommnisbericht) und KiTa (v1.1, Bildungsdokumentation + Speiseplan) drucken jetzt im professionellen SHIFTDECK-Dokument-Look — Briefkopf, Gold-Akzent, Status-Badges, Summenzeilen und Unterschrift-Felder.

## v7.82 - 14. Juli 2026 · Modul „Gebäudedienste & Reinigung" (v1.4)

- **Alle 7 Druckansichten neu:** professioneller Briefkopf mit Logo + Firmendaten, Dokument-Nummern, farbige Badges, moderne Tabellen mit Summenzeilen, Unterschrift-Felder und Fußzeile.

## v7.81 - 14. Juli 2026 · Modul „Einzelhandel & Retail" (v2.0) — komplett neu

- **Umsatz-Cockpit mit Tages-/Monatsziel, Kassenbuch mit Tagessaldo + Tagesbericht, MHD-Kontrolle mit Ampel + Schnellaktionen, Abschriften/Schwund, Warenannahme mit Lieferanten, Aktionsplanung mit Checklisten, Retouren-Management** — plus alle bewährten Funktionen (Kassenabschluss, Tagesaufgaben, Schichtplan, Inventur, Minijob, Unterweisungen).

## v7.80 - 14. Juli 2026 · Modul „Gebäudedienste & Reinigung" (v1.3)

- **Lieferanten-Verwaltung** (Kundennr., Shop-Link), Material mit **Artikelnummer + Produkt-Link + Preis**, **druckbare Einkaufsliste** (je Lieferant gruppiert, Mengen anpassbar) und **Einkaufs-Historie** mit automatischer Bestandsbuchung.

## v7.79 - 14. Juli 2026 · Einheitliche Modul-Ansicht

- Alle Branchenmodule nutzen jetzt die **volle Seitenbreite** (wie Kitas & Kindergärten / Handwerk & Bau) — mehr Platz auf großen Bildschirmen.

## v7.78 - 14. Juli 2026 · Modul „Gebäudedienste & Reinigung" (v1.2)

- **Wiederkehrende Touren** (Wochentage anklickbar), **Zeitvorgabe je Stopp** und **„Meine Tour" im Mitarbeiter-Panel** (nächster Stopp markiert, Google-Maps-Navigation, Abhaken mit Fortschritt, pro Tag gespeichert).

## v7.77 - 14. Juli 2026 · Modul „Gebäudedienste & Reinigung" (v1.1)

- **QR-Objekt-Scan (Kommen/Gehen)** mit Zeit-vor-Ort-Berechnung + druckbarem QR-Aushang je Objekt, **Leistungskatalog mit Preisen**, **druckbares Leistungsverzeichnis** je Objekt, **Angebote** (Druck + E-Mail-Versand mit Firmendaten/Logo) und **Kostenvoranschlags-Rechner** (m², Zeit, Lohn, Reinigungsmittel, Anfahrt, Sonntagszuschlag, Marge).

## v7.76 - 13. Juli 2026 · NEU: Modul „Gebäudedienste & Reinigung" (v1.0) — alle 9 Branchenmodule komplett!

- Neues Branchenmodul: **Objektverwaltung, Revierplanung/Leistungsverzeichnis, Touren, Leistungsnachweis mit Unterschrift, Qualitätskontrolle mit Ampel-Bewertung, Reklamationen, Material mit Mindestbestand, Schlüsselverwaltung, Unterweisungen & Zuschläge** + Dashboard.

## v7.75 - 13. Juli 2026 · NEU: Modul „Transport & Logistik" (v1.0)

- Neues Branchenmodul: **Fuhrpark (TÜV/SP/UVV), Touren-/Einsatzplanung, Lenk-/Ruhezeiten-Monitor, Abfahrtkontrolle mit Foto, Führerschein-/Qualifikationskontrolle (Modul 95, ADR), Schadensmeldungen, Tankbuch & Fahrzeugkosten, Spesen/VMA, Fahrzeug-Übergaben** + Dashboard.

## v7.74 - 13. Juli 2026 · NEU: Modul „Sicherheitsdienst" (v1.0)

- Neues Branchenmodul: **Objekt-/Auftraggeberverwaltung, Posten-/Objektdienstplan, Wächterkontrolle/Rundgänge (QR/NFC), Wachbuch/Vorkommnisse mit Foto, Alarm-/Interventionseinsätze, Schichtübergabe, §34a-/Qualifikationsnachweise, Zuschläge & Objektzulagen, Ausrüstungs-/Ausweisverwaltung** + Dashboard.

## v7.73 - 13. Juli 2026 · Modul „Gastronomie" (v1.2)

- Das Branchenmodul heißt jetzt einheitlich **Gastronomie** (Menü, Modul-Kopf, Berechtigungen, Checkout).

## v7.72 - 13. Juli 2026 · NEU: Modul „Einzelhandel & Retail" (v1.0)

- Neues Branchenmodul: **Filial-/Abteilungsplanung (mit Mindestbesetzung), Frequenz-/Bedarfsplanung, Kassenabschluss & Differenz, Öffnungszeiten, Tagesaufgaben/Warenverräumung, Inventur, Zuschläge, Minijob-Monitor, Unterweisungen** + Dashboard.

## v7.71 - 13. Juli 2026 · NEU: Modul „Hotel & Beherbergung" (v1.0)

- Neues Branchenmodul: **Abteilungsplanung, Housekeeping-/Zimmerplan, belegungsbasierte Bedarfsplanung, Rezeptions-Schichtübergabe, Night-Audit-Checkliste, Bankett-/Event-Planung, Tronc/Trinkgeld-Pool, Zuschläge & Saison, Qualifikations-/Nachweisverwaltung** + Dashboard.

## v7.70 - 13. Juli 2026 · NEU: Modul „Pflege & Soziales" (v1.0)

- Neues Branchenmodul: **Fachkraftquote-Dienstplan, Klienten-/Bewohnerverwaltung, Tourenplanung (ambulant), Leistungsnachweis mit Unterschrift, Pflege-Zuschläge, Qualifikations-/Nachweisverwaltung (inkl. Masernnachweis), Rufbereitschaft, digitale Schichtübergabe, Springer-Pool** + Dashboard.

## v7.69 - 13. Juli 2026 · Modul „GASTRONOMIE & HANDEL" (v1.1)

- Das Branchenmodul heißt jetzt einheitlich **GASTRONOMIE & HANDEL** (Menü, Modul-Kopf, Berechtigungen).

## v7.68 - 13. Juli 2026 · NEU: Modul „Gastronomie & Handel" (v1.0)

- Neues Branchenmodul: **Trinkgeld-Pool, Kassenabschluss (Differenz), HACCP/Hygiene, Bedarfsplanung, Bereiche/Filialen, Wareneinsatz & Lieferanten, Inventur, Minijob-Monitor, Zuschläge** + Dashboard.

## v7.67 - 13. Juli 2026 · Kunden ↔ Baustellen + 360°-Übersicht (Handwerk-Modul v1.2)

- Baustelle anlegen: **Kunde wählen** → Daten übernehmen; Firmen-**Standorte** auswählbar.
- Kunde: mehrere **Standorte/Objekte** hinterlegbar.
- **360°-Kundenübersicht**: alle Baustellen/Kosten/Aufmaße/Lieferungen + Lieferschein/Palettenschein drucken.

## v7.66 - 13. Juli 2026 · Detailfenster + Kundendatenbank (Handwerk-Modul v1.1)

- Material-Vollansicht bei der Baustelle (Lieferschein + Palettenschein).
- Geräte/Werkzeug: **Verlauf** (wer/wo zuletzt) + Werkstattrechnungen.
- Fahrtenbuch: Fahrzeug anklicken → alle Kostenbuchungen aufgegliedert.
- **Neu: Kundendatenbank** (Kunden/Firmen anlegen + schnell finden).

## v7.65 - 12. Juli 2026 · Fahrtenbuch: Kostenübersicht zuerst

- Fahrtenbuch: **Kostenübersicht nach Art** oben, dann **Kosten pro Fahrzeug & Monat**.

## v7.64 - 12. Juli 2026 · Modul-Versionsnummer für Branchenmodule

- Handwerk & Bau + KiTa: eigene **Modul-Version** (Header-Badge + Checkout-Branchenmodul).

## v7.63 - 12. Juli 2026 · Status-Workflow, Warenausgang-Detail & Dashboard-Ausbau

- Baustellen-Status: **Offen · Eingeplant · Baustelle Fertig · Baustelle abgerechnet**.
- Fertige/abgerechnete Aufträge verschwinden aus Kommissionierung & Warenausgang.
- Warenausgang + Aufmaß: Auftrag anklicken → Detailfenster.
- Baustellen-Auftrag: Material/Aufmaß-Detailfenster + **Fotogalerie**.
- Dashboard: offene Baustellen mit Name/geplant, Kommission-/Versand-Zähler, fällige Prüfungen.
- Berechtigungen: „Lager: Kommissionierung" + „Lager: Warenausgang".

## v7.62 - 12. Juli 2026 · Aufmaß mit Fotos

- Aufmaß: **Fotos** hinzufügen (Baustelle/Vor-Ort-Besichtigung), sichtbar in der Ansicht.

## v7.61 - 12. Juli 2026 · Warenausgang: Versand, Versandpapiere & Palettenscheine

- Neuer **Warenausgang**: versandbereite Kommissionierungen, Spedition/Sendungsnummer eintragen, **Versenden**.
- **Versandpapier** + **Palettenscheine** drucken; **„An Kommissionierer senden"** per E-Mail.
- Kommissionierung: Status per Klick (Offen · Gepackt · Versandbereit · Versendet).

## v7.60 - 12. Juli 2026 · Aufmaß-Ansicht & Auftragsnummer bei der Baustelle

- Aufmaß: Klick auf Auftrag → Ansicht mit allen Positionen.
- Baustelle: einmalige **Auftragsnummer** in Liste & Detail (auch aus verknüpftem Aufmaß).
- Baustelle: „Unterschrift Ansprechpartner" → „Unterschrift".

## v7.59 - 11. Juli 2026 · KiTa-Kiosk: kinderfreundlicher Hintergrund

- KiTa-**Kiosk/Terminal** hat jetzt einen freundlichen, farbenfrohen Hintergrund (verspielte Deko).

## v7.58 - 11. Juli 2026 · Baustelle: Material-/Versandinfos & Kommissionierliste drucken

- Baustelle: Material **untereinander** + Sendungsnummer/Versand-/Ankunftsdatum + Ansprechpartner vor Ort inkl. Telefon (aus Kommissionierung).
- **Kommissionierliste drucken** in Kommissionierung UND Baustelle.

## v7.57 - 11. Juli 2026 · Kommissionierung bündelt Material · Baustellen-Status

- Materialabruf jetzt in der **Kommissionierung** (aus „Zulagen" entfernt).
- Baustellen-Liste: Anzeige **Aufmaß genommen** + **Material bereitgestellt**.

## v7.56 - 11. Juli 2026 · Handwerk: Reihenfolge angepasst

- Reiter-Reihenfolge: **Baustellen → Aufmaß → Kommissionierung**.

## v7.55 - 10. Juli 2026 · Workflow Aufmaß → Kommissionierung → Baustelle

- Reihenfolge Aufmaß · Kommissionierung · Baustellen.
- Aufmaß: automatische einmalige Auftragsnummer.
- Kommissionierung: Auftragsnummer wählen → Daten (Adresse/Positionen) aus Aufmaß automatisch; beim „gepackt" Palettenart + Anzahl abfragen.
- Automatischer Baustellen-Auftrag mit allen Daten + Auftragsnummer.
- Monteur sieht kommissioniertes Material + Paletten auf „Meine Baustelle".

## v7.54 - 10. Juli 2026 · Baustellen: Statusfilter & größeres Fenster

- **Baustellen filtern**: Schnellfilter Offen · In Bearbeitung · Pausiert · Fertig (mit Anzahl).
- **Baustellen-Formular** breiter/übersichtlicher.

## v7.53 - 10. Juli 2026 · Modul-Bezeichnung vereinheitlicht

- Branchenmodul „Kita" heißt jetzt durchgängig **„Kitas & Kindergärten"**.

## v7.52 - 10. Juli 2026 · Handwerk & Bau: Material-Tracking, Auftragsnummern & Einsatzkalender

- **Materialabruf mit Versandverfolgung**: Material fest einer Baustelle zugeordnet; Status (Offen → Bereitgestellt → Versendet → Angekommen), Versandunternehmen, Sendungsnummer (Tracking-Link), Ankunftsdatum. Monteur sieht Status auf „Meine Baustelle". Versandkosten fließen in die Baustellen-Auswertung.
- **Aufmaß mit automatischer Auftragsnummer** + Baustellen-Zuordnung, im Cockpit abrufbar.
- **Einsatzkalender**: Baustellen im Zeitverlauf nach Kolonne oder Mitarbeiter – Zeitplan-Übersicht. Baustellen mit Start-/Enddatum + Kolonne.

## v7.51 - 10. Juli 2026 · Handwerk & Bau: Übersicht, GPS-Fahrtenbuch & Kataloge

- **Baustellen, Bautagebuch & Regieberichte**: nach Monat/Jahr gegliedert (Monate zugeklappt) + Suchfeld. Bautagebuch & Regiebericht direkt mit den Baustellen verknüpft.
- **Fahrtenbuch mit GPS**: Fahrt per Standort starten/beenden – km & gefahrene Route automatisch, als kleine Karte (Google Maps).
- **Fahrzeugkosten-Übersicht**: Versicherung, Benzin & Werkstatt pro Monat/Jahr.
- **Geräte/Werkzeug/Fahrzeuge**: Dokumente & UVV-/DGUV-Prüfberichte bei allen Geräten hinterlegbar.
- **Aufmaß mit Leistungskatalog**: Artikel/Preise/Beschreibung – Positionen per Auswahl oder Freitext.
- **Qualifikationen** nach Abteilung/Mitarbeiter gegliedert, inkl. Mitarbeiter-Foto und Nachweis-Dokument.
- **Nachunternehmer** als Firmen-Nachschlagewerk: Adresse, Kontakt, Website, Bewertung & Preisliste – editierbar.

## v7.50 - 10. Juli 2026 · Übersichtlicheres Menü am Handy

- **Verbessert:** Das mobile Menü ist jetzt in klare Abschnitte gegliedert (z. B. Arbeitszeit, Module, System) — aufgeräumter und schneller zu erfassen.
- **Behoben:** Der Eintrag „Handbuch" wurde im Handy-Menü doppelt angezeigt und erscheint nun nur noch einmal.

## v7.49 - 10. Juli 2026 · Fix: „Meine Baustelle" beim Mitarbeiter

- **Behoben:** Mitarbeiter mit den Rechten „Meine Baustellen" bzw. „Geräte scannen" sahen den Menüpunkt **„Meine Baustelle" nicht** – die Freischaltung berücksichtigte diese neuen Rechte noch nicht. Jetzt erscheint das Panel bei **jedem** freigeschalteten Handwerk-Recht.

## v7.48 - 10. Juli 2026 · Fix: Berechtigungen speichern

- **Behoben:** Beim Zuweisen von Berechtigungen wurden **neue Modul-Rechte** (KiTa, Handwerk ## v7.47 - 10. Juli 2026 · Handwerk: Ressourcen Bau u. a.) sowie einige weitere Rechte **nicht gespeichert** – der Server hat nur eine feste Liste akzeptiert. Jetzt werden **alle** Berechtigungen gespeichert und beim Mitarbeiter korrekt angezeigt.

## v7.47 - 10. Juli 2026 · Handwerk: Ressourcen, Geräte-QR ## v7.46 - 10. Juli 2026 · Handwerk: Baustellen-Cockpit Fahrzeug-Akte 🧰

- **Einsatzplanung je Baustelle**: Fahrzeuge (mit **Fahrer ## v7.46 - 10. Juli 2026 · Handwerk: Baustellen-Cockpit Mitfahrern**), Maschinen/Geräte und Material per Auswahlliste einplanen. Der Monteur sieht im Panel, **wen er mitnimmt und was mitzubringen ist**.
- **Geräte-/Fahrzeug-Akte**: Foto je Gerät/Fahrzeug; bei Fahrzeugen **Dokumente** (Fahrzeugschein, TÜV-Bericht, Werkstattrechnungen).
- **QR-Code je Gerät**: ausdrucken ## v7.46 - 10. Juli 2026 · Handwerk: Baustellen-Cockpit anbringen. Mitarbeiter **scannt** und ordnet das Gerät einer Baustelle/einem Fahrzeug zu (im Einsatz) oder bucht es ins Lager zurück (verfügbar) – so ist immer klar, **wo das Gerät ist und wer es zuletzt hatte**.
- **Fahrzeug-Detail**: Nummernschild, TÜV/UVV-Fälligkeit mit Erinnerung und **alle Maschinen auf dem Fahrzeug** – inkl. **druckbarer Übergabe-Liste** für die UVV.
- Baustellen: „Ansprechpartner" statt „Mieter/Bewohner".

## v7.46 - 10. Juli 2026 · Handwerk: Baustellen-Cockpit ## v7.45 - 10. Juli 2026 · Handwerk: Fahrtenbuch Dashboard 🏗️

- **Dashboard** mit Kennzahlen (offene/abgeschlossene Baustellen, offene Materialabrufe, fällige Prüfungen) und Grafiken (Baustellen nach Status, Kosten pro Monat).
- **Baustellen-Übersicht**: Baustellen anlegen, **Mitarbeiter zuweisen**, Adresse mit **Google-Maps-Navigation**, Status, Aufgabe.
- **Kosten-Auswertung je Baustelle** (Stunden + Kosten aus den Mitarbeiter-Einträgen), Foto-Nachweise und **Mieter-/Bewohner-Unterschrift** – plus **druckbarer Baustellen-Bericht**.
- **Mitarbeiter-Panel „Meine Baustellen"**: zugewiesene Baustellen mit Navigation, Aufgabe und Erfassung von Stunden, Material, **Entsorgung**, Kosten, Belegen ## v7.45 - 10. Juli 2026 · Handwerk: Fahrtenbuch Fotos direkt vor Ort.

## v7.45 - 10. Juli 2026 · Handwerk: Fahrtenbuch & Mitarbeiter-Panel 🚗

- **Fahrtenbuch pro Fahrzeug**: Fahrten (km, Zweck, von/nach) sowie **Tankbelege, Quittungen & Rechnungen** je Fahrzeug erfassen – mit Foto-Beleg.
- **Kostenstatistik je Fahrzeug & Monat**: auf einen Blick, was ein Fahrzeug kostet.
- **Mitarbeiter-Panel „Meine Baustelle"**: Einzelne Bau-Funktionen (Bautagebuch, Fahrtenbuch, Regiebericht, Aufmaß, Material, Zulagen) lassen sich **pro Mitarbeiter per Berechtigung freischalten** – der Mitarbeiter füllt sie im eigenen Panel aus, ohne das ganze Modul zu sehen.

## v7.44 - 9. Juli 2026 · Neues Modul: Handwerk & Bau 🔨

SHIFTDECK wird zur Baustellen-Software – separat buchbares Branchenmodul „Handwerk & Bau" (über die Lizenz freischaltbar).

- **Bautagebuch** – täglicher Bautagesbericht je Baustelle (Wetter, Mannschaft, Arbeiten, Vorkommnisse) mit Druck/PDF
- **Regieberichte** mit **digitaler Kundenunterschrift** auf dem Tablet, als PDF
- **Geräte-/Werkzeug-/Fahrzeugverwaltung** inkl. Wartungs-/Prüffristen (TÜV, DGUV V3) mit Warnung
- **Aufmaß & Leistungserfassung** mit Positionen und Summe
- **Qualifikationen & Unterweisungen** je Mitarbeiter mit Ablauf-Warnung
- **Nachunternehmer**-Verwaltung mit Nachweisen und Bewertung
- **Zulagen/Auslöse** & **mobiler Materialabruf** von der Baustelle
- Eigene Berechtigungen „Handwerk: Baustellen-App nutzen" und „Handwerk: Verwaltung"

## v7.43 - 9. Juli 2026 · Berechtigungen: KiTa-Modul freischalten

- **KiTa-Rechte in „Berechtigungen verwalten"**: Nutzer lassen sich gezielt fürs KiTa-Modul freischalten – „KiTa: Gruppen-App nutzen" (Erzieher/innen) und „KiTa: Verwaltung" (Leitung). Nur freigeschaltete Nutzer sehen und öffnen das Modul.
- Die Berechtigungen sind jetzt **nach Kategorien gruppiert** (übersichtlicher); der KiTa-Block erscheint nur, wenn das Zusatzmodul gebucht/aktiv ist.

## v7.42 - 8. Juli 2026 · KiTa Testmail: klare Meldung

- **Verbessert:** Die Testmail der Tagesübersicht sagt jetzt klar Bescheid, wenn **kein E-Mail-Versand (SMTP) eingerichtet** ist – statt „0 gesendet". Hinweis ergänzt: SMTP unter Einstellungen → E-Mail konfigurieren.

## v7.41 - 8. Juli 2026 · Fix: KiTa Testmail

- **Behoben:** „Testmail senden" bei der täglichen Tagesübersicht meldete „Keine Empfänger", wenn die E-Mail-Adresse noch nicht gespeichert war. Die Testmail nutzt jetzt direkt die im Feld eingegebene Adresse.

## v7.40 - 8. Juli 2026 · KiTa: Tagesübersicht „Wer ist heute da?"

📋 **Neuer Tab „Heute"** im KiTa-Modul.

- **Wer ist heute da?** – auf einen Blick: wie viele Kinder anwesend/abgeholt sind und wie viele mitessen, dazu je Gruppe die Liste der anwesenden Kinder mit Bring-/Abholzeit. Aktualisiert sich automatisch.
- **Tägliche E-Mail:** Optional lassen Sie sich diese Übersicht **jeden Tag zur festgelegten Uhrzeit** automatisch an beliebige Empfänger zusenden (z. B. Leitung/Büro). Mit „Testmail senden" sofort ausprobierbar.

## v7.39 - 8. Juli 2026 · Fix: KiTa Eltern-App-Tab

- **Behoben:** Der Tab „Eltern-App" im KiTa-Modul konnte nach dem 7.38-Update abstürzen (leere Seite). Ursache war ein Anzeige-Fehler bei der Gruppierung – jetzt behoben.

## v7.38 - 8. Juli 2026 · KiTa: Eltern-Zugang & Kinder nach Gruppen

- **Eltern-Zugang nach Gruppen**: Die Zugangs-Übersicht zeigt die Kinder jetzt nach Gruppe sortiert – mit Status je Kind: **Kein Zugang → Code erzeugt → Code gesendet → Registriert** (inkl. hinterlegter Eltern-E-Mail).
- **Kinder-Ansicht nach Gruppen**: Auch der Reiter „Kinder" gruppiert die Kinder jetzt übersichtlich je Gruppe (mit Farbe und Anzahl).
- **Handbuch erweitert**: Der Abschnitt „KiTa-Modul" beschreibt jetzt Speiseplan/Rezepte, Essensgeld, Eltern-App, Kiosk, Personal und das Eltern-Portal.
- **FAQ-Bot**: 12 neue Fragen & Antworten rund um das KiTa-Modul.

## v7.37 - 8. Juli 2026 · KiTa: Eltern-App mit eigenem Konto (E-Mail & Passwort)

👨‍👩‍👧 **Die Eltern-App bekommt echte Konten.**

- Eltern erhalten von der Einrichtung einen **Zugangscode per E-Mail** und **registrieren** damit einmalig ein Konto mit **E-Mail-Adresse und eigenem Passwort**.
- Danach melden sie sich **jederzeit mit E-Mail & Passwort** an – der Code wird nur zur Registrierung gebraucht.
- **Mehrere Kinder in einem Konto**: Über „Mein Konto → Weiteres Kind hinzufügen" lässt sich ein zweiter Code eintragen; im Kopf der App wechselt man dann bequem zwischen den Kindern.
- **Admin**: Im Tab „Eltern-App" gibt es pro Kind den Button **„Code per E-Mail"** – der Code geht direkt an die hinterlegte Eltern-Adresse (mit Anleitung). „Anzeigen" zeigt den Code weiterhin nur an.
- Bestehende Eltern, die sich schon per Code eingeloggt haben, bleiben angemeldet.

## v7.36 - 8. Juli 2026 · KiTa: Rezept-Kochbuch, Essens-An-/Abmeldung & Kiosk-Terminal

🍽️ **Rund ums Mittagessen – jetzt richtig komfortabel.**

### ✨ Neu – Rezept-Bibliothek im Speiseplan
- Speichern Sie **Gerichte mit Foto, Zutaten (mit Mengen), Zubereitung und Portionsangabe** – einmal angelegt, immer wiederverwendbar.
- Beim Wochenplan wählen Sie das Gericht bequem aus der Liste **oder** tragen wie gewohnt frei per Hand etwas ein – beides geht weiterhin.
- Der Speiseplan zeigt in der Eltern-App jetzt das **Bild des Gerichts**, damit Kinder ihr Essen wiedererkennen.

### ✨ Neu – Kochbuch in der Eltern-App
- Eigener Bereich **„Kochbuch"** mit **Suchleiste** zum Durchstöbern aller Rezepte der Einrichtung.
- Eltern können jedes Rezept ansehen und mit einem Klick **herunterladen bzw. ausdrucken** – ideal zum Nachkochen zu Hause.

### ✨ Neu – Essensgeld: zwei Abrechnungsmodelle
- Umschaltbar: **fester Monatsbetrag** oder **tägliches An-/Abmelden**.
- Beim Tagesmodell klicken Eltern pro Tag **„Ja / Nein"** – nur teilgenommene Tage werden vom Guthaben abgebucht, **Stornieren** schreibt den Betrag wieder gut.

### ✨ Neu – Kiosk-/Terminal-Modus für die Anwesenheit
- In „Anwesenheit" gibt es jetzt **„Kiosk"**: eine große, tablet-taugliche Vollbild-Ansicht zum Anmelden/Abholen der Kinder per Antippen – ideal als **Terminal am Eingang**.
- Die Ansicht ist **gesperrt**: Verlassen (auch Zurück-Taste oder Vollbild-Ausstieg) ist nur mit einer **PIN** möglich.
- Die PIN wird direkt im KiTa-Modul hinterlegt (Schlüssel-Symbol neben „Kiosk", nur für Verwaltung).

## v7.35 - 8. Juli 2026 · KiTa: Speiseplan zum Aushängen

- **Speiseplan drucken**: Im Speiseplan gibt es jetzt „Aushang drucken" – erzeugt ein großes, druckfertiges Wochen-Layout (mit Allergie-Hinweis) zum Aushängen in der Einrichtung.

## v7.34 - 8. Juli 2026 · KiTa: Links direkt im Modul

- **Eltern-App-Link** wird jetzt direkt im KiTa-Modul (Tab „Eltern-App") angezeigt – mit Kopier-Button. Der öffentliche Portal-Link steht wie gewohnt im Tab „Eltern-Portal". So findet man beide Zugänge sofort.

## v7.33 - 8. Juli 2026 · KiTa: Portal, Personal, Eltern-App & Mehr

🧸 **Der große KiTa-Ausbau** – gleich vier neue Bereiche auf einmal.

### ✨ Neu – Eltern-Portal (öffentlich)
- Verwaltbare **öffentliche Seite** mit Einrichtungs-Beschreibung, Bildern, Team-Vorstellung (mit Foto), Öffnungszeiten und Gruppen inkl. Platz-Ampel
- **Online-Anmeldung** durch Eltern über einen teilbaren Link – landet direkt in „Anmeldung & Plätze"

### ✨ Neu – Personalverwaltung
- **Personalschlüssel-Cockpit**: Soll-/Ist-Fachkraftstunden je Gruppe mit Ampel (U3/Ü3 automatisch), Verwendungsnachweis, einstellbarer Schlüssel

### ✨ Neu – Eltern-App
- Installierbare App für Eltern (Zugang per Code): **Start** mit Tagesinfo, **Aushänge** (Schwarzes Brett), **Postfach**, **Portfolio-Einblick**, **Krankmeldung** und **Essensgeld-Guthaben mit PayPal-Aufladung**

### ✨ Neu – Mehrwert-Funktionen
- **Tages-Info „Mein Tag"**: Essen, Schlaf, Stimmung je Kind – erscheint in der Eltern-App
- **KI-Formulierungshilfe**: aus Stichworten wird per Klick eine fertige pädagogische Beobachtung
- **Medikamentengabe- & Unfall-Protokoll** (revisionssicher)
- **Speiseplan** mit automatischer Allergie-Warnung

## v7.32 - 7. Juli 2026 · Offline-fähige App (PWA)

📱 **SHIFTDECK ist jetzt offline-fähig** – wichtig fürs Tablet in der Kita-Gruppe, wenn das WLAN schwankt.

### ✨ Neu
- **Progressive Web App (PWA)**: SHIFTDECK lässt sich als App auf Tablet, Handy und PC installieren (Icon auf dem Startbildschirm) und **startet auch ohne Internet**. Einmal geladene Ansichten und Bilder bleiben verfügbar; sobald wieder Verbindung besteht, aktualisiert sich alles automatisch.
- Updates bleiben zuverlässig: neue Programmversionen werden weiterhin sofort geladen (kein „Hängenbleiben" auf alten Ständen).

### ✅ Damit ist der KiTa-Gruppen-App-Ausbau (Etappe 2) abgeschlossen
Kind-Akte, Anwesenheit mit Abholberechtigten, Bildungsdoku, Elterngespräche, Textbausteine, Bildungsbericht-Druck, Wochen-Anwesenheitsraster – und jetzt Offline-Fähigkeit.

## v7.31 - 7. Juli 2026 · KiTa: Wochen-Anwesenheit (Beta)

🧸 **KiTa-Modul** – die Anwesenheit gibt es jetzt auch als Wochenüberblick.

### ✨ Neu
- **Wochenansicht der Anwesenheit**: Umschalter **Tag / Woche** in „Bring- & Abholzeiten". Die Wochenansicht zeigt alle Kinder in einem Raster (Mo–So) mit einer **Anwesenheits-Torte** je Tag – der grüne Anteil zeigt auf einen Blick, wie viel vom Betreuungsumfang das Kind da war – inklusive Bring- und Abholzeit.

### ℹ️ Hinweis
- Damit ist die Gruppen-App im Kern vollständig. Als abschließender Baustein von Etappe 2 folgt die Offline-Fähigkeit (PWA).

## v7.30 - 7. Juli 2026 · KiTa: Bildungsbericht drucken (Beta)

🧸 **KiTa-Modul** – weiter ausgebaut.

### ✨ Neu
- **Bildungsbericht erstellen & drucken**: In der Bildungsdokumentation lässt sich pro Kind ein **druckfertiger Bericht** erzeugen – wahlweise für ein **Kindergartenjahr** oder einen **frei gewählten Zeitraum**, optional gefiltert nach **Bildungsbereichen**. Der Bericht öffnet sich als sauber formatierte Druckansicht (SHIFTDECK-Design) und kann direkt gedruckt oder als PDF gespeichert werden.

### ℹ️ Hinweis
- Als Nächstes folgen: Wochen-Anwesenheitsraster und Offline-Fähigkeit (PWA).

## v7.29 - 7. Juli 2026 · KiTa: Kind-Akte & Bildungsdoku (Beta)

🧸 **Großer Ausbau des KiTa-Moduls** – die pädagogische Arbeit wird deutlich mächtiger.

### ✨ Neu – Kind-Akte mit Reitern
- Vollständige **Kind-Akte** je Kind: **Stammdaten** (Adresse, Familiensprache, Aufnahme/Entlassung), **Kontakte** (Eltern, **Abholberechtigte**, Notfallkontakte – beliebig viele), **Gesundheit** (Allergien, Medikamente, Diät, Arzt, Krankenkasse, Förderbedarf), **Einverständnisse** (Foto intern/Aushang/Presse, Ausflüge, Notfallmedikation u. a.) und **Notizen**
- **Datenschutz**: Gesundheits- & Einwilligungsdaten sind besonders geschützt (DSGVO Art. 9) und nur in der Akte selbst sichtbar

### ✨ Neu – Gruppen-App
- **Anwesenheit** mit Filter (Alle / Anwesend / Noch nicht da / Abgeholt) und Sortierung; beim Auschecken wird der **Abholberechtigte ausgewählt** – nachvollziehbar, wer das Kind abgeholt hat
- **Bildungsdokumentation je Kind**: Übersicht aller 8 Bildungsbereiche mit **Beobachtungs-Zähler** und Auswahl des **Kindergartenjahres**
- **Elterngespräche** dokumentieren (Teilnehmer, Notizen, Datum)
- **Textbausteine** für Beobachtungen – schneller formulieren per Klick

### ℹ️ Hinweis
- Weitere KiTa-Funktionen (Wochen-Tagebuch, PDF-Berichte, Eltern-Portal, Personalverwaltung, Eltern-App) folgen in den nächsten Beta-Versionen.

## v7.28 - 6. Juli 2026 · KiTa-Modul (Beta)

🧸 **Neues Zusatzmodul: KiTa.** SHIFTDECK wird zur vollwertigen Kita-Verwaltung – separat dazubuchbar. Von der pädagogischen Gruppen-App bis zur Platz- und Beitragsverwaltung, DSGVO-konform und mit durchdachtem Foto-Schutz.

### ✨ Neu – Gruppen-App (für pädagogische Fachkräfte)
- **Gruppentagebuch**: Tagesdokumentation pro Gruppe inkl. automatischer Anwesenheits-Übersicht (Kommen/Gehen)
- **Beobachtungen**: strukturierte Beobachtungen zu einem oder mehreren Kindern, den 8 Bildungsbereichen zugeordnet, optional mit Foto
- **Bildungsdokumentation**: Entwicklungseinschätzung je Bildungsbereich auf einer klaren 1–5-Skala
- **Portfolioarbeit**: Beobachtungen mit einem Klick ins Kind-Portfolio übernehmen – kein doppeltes Erfassen
- **Anwesenheit**: schnelles Ein-/Auschecken der Kinder direkt in der Gruppe

### ✨ Neu – Verwaltung
- **Kinder & Gruppen**: Stammdaten, Gruppenzuordnung, Archivierung (kein hartes Löschen)
- **Anmeldung & Plätze**: Warteliste mit Workflow Anfrage → Besichtigung → Zusage → Aufgenommen; bei Aufnahme wird das Kind automatisch angelegt
- **Platz-Ampel**: freie Plätze je Gruppe auf einen Blick (grün/gelb/rot)
- **Beiträge**: Elternbeiträge erzeugen, verwalten und als CSV exportieren
- **Statistik & Förderung**: Auswertungen inkl. CSV-Export für Förderanträge

### 🔒 Datenschutz serienmäßig
- **Foto-Einwilligung je Kind**: Fotos lassen sich nur speichern, wenn für **alle** abgebildeten Kinder eine Einwilligung vorliegt – automatisch geprüft
- Feingranulare Berechtigungen **„KiTa – Zugriff"** und **„KiTa – Verwalten"** unter „Berechtigungen verwalten"

### ℹ️ Hinweis
- Das KiTa-Modul ist ein **separat buchbares Zusatzmodul**. In der 14-tägigen Testphase ist es vollständig freigeschaltet.
- Eine bebilderte Anleitung findest du im **Handbuch → KiTa-Modul**.

## v7.25 - 3. Juli 2026 · Handy verbinden (Beta)

📱 **Die Mitarbeiter-App lässt sich jetzt mit dem eigenen Konto koppeln.** Jeder Mitarbeiter verbindet sein Handy selbst – per QR-Code aus dem eigenen Konto.

### ✨ Neu
- **Mein Konto → Handy verbinden**: QR-Code (mit Klartext-Code) zum Koppeln der SHIFTDECK-App
- **Dauerhafte Kopplung**: einmal verbinden, danach kein erneuter Login nötig
- **Geräte-Verwaltung**: gekoppelte Handys einsehen und entfernen – entfernte Geräte verlieren sofort den Zugriff

## v7.24 - 2. Juli 2026 · Terminal-App erweitert (Beta)

🎉 **Das SHIFTDECK Terminal kann jetzt mehr.** Aufbauend auf 7.23 zeigt das Terminal nun Profilbilder und Urlaub – und Mitarbeiter können Urlaub direkt am Gerät beantragen.

### ✨ Neu
- **Mitarbeiter-Profilbilder** werden am Terminal angezeigt (Auswahl, Anmeldung, Hauptschirm)
- **Meine Urlaubsübersicht** nach dem Anmelden: genehmigt / eingereicht / abgelehnt inkl. Restkontingent
- **Urlaub direkt am Terminal beantragen** (Von/Bis + Grund) – nutzt dieselbe Prüfung wie im Web
- **Statusfilter „Im Dienst / Alle"** im „Wer stempelt?"-Screen – zeigt standardmäßig nur anwesende und pausierende Mitarbeiter, „Alle" für die Anmeldung zum Einstempeln
- **Gruppierung nach Gruppe** in der Mitarbeiterliste – schnelleres Finden
- **Pausen-Status „In Pause"** wird direkt beim Mitarbeiter angezeigt
- **App-Version im Header** sichtbar (aktuell v1.5)

### 🔧 Verbessert
- Terminal-Kopplung robuster: Kopplungscode wird unabhängig von Bindestrich/Groß-Kleinschreibung erkannt
- App verbindet sich jetzt auch mit Installationen **ohne SSL** (interne IP-Server), nicht nur mit HTTPS

## v7.23 - 1. Juli 2026 · SHIFTDECK Terminal – Stempeluhr fürs Tablet (Beta)

🕒 **Neu: Terminal-Stempeluhr für geteilte Tablets/iPads.** Machen Sie aus einem Tablet eine zentrale Stempeluhr am Eingang, in der Küche oder Werkstatt. Mitarbeiter stempeln mit ihrem persönlichen 5-stelligen PIN ein, aus und starten Pausen – ohne eigenen Login.

### ✨ Neu
- **Verwaltung → Terminals**: Geräte anlegen, per **QR-Code koppeln**, neu koppeln oder entfernen
- Das Tablet wird **einmalig per QR-Code** verbunden und bleibt dauerhaft gekoppelt – bis das Gerät entfernt oder die App gelöscht wird
- Terminal zeigt pro Mitarbeiter die laufende Arbeitszeit sowie Heute, Diese Woche und den Saldo
- Stempeln am Terminal nutzt dieselbe Zeit- und Überstundenlogik wie die normale Erfassung
- Handbuch und Einführungs-Assistent um das Terminal erweitert

## v7.22 - 16. Juni 2026 · Dauerbetrieb-Stabilität (Folgekorrektur, Beta)

🩹 **Wichtiger Stabilitäts-Fix — Ergänzung zu 7.21.**

### 🐛 Behoben
- **Kein langsamer Ressourcen-Anstieg mehr über Tage:** Behoben wurde ein weiterer Fall, in dem Datenbank-Verbindungen über sehr lange Laufzeit nicht zuverlässig freigegeben wurden. In ungünstigen Situationen (z. B. wenn die Datenbank kurzzeitig nicht erreichbar war) konnte das zu langsam steigender CPU-/Arbeitsspeicher-Last bis hin zu „Too many open files" führen. Die Datenbank-Verbindungen werden jetzt sauber begrenzt, mit Zeitlimits versehen und automatisch wiederverwendet bzw. freigegeben — der Server bleibt dadurch auch im Wochen-Dauerbetrieb stabil.

## v7.21 - 15. Juni 2026 · Stabiler Dauerbetrieb (Beta)

🩹 **Wichtiger Stabilitäts-Fix für lange Laufzeiten.**

### 🐛 Behoben
- **Kein Ressourcen-Anstieg mehr im Dauerbetrieb:** Behoben wurde ein Problem, durch das die Hintergrund-Dienste über lange Laufzeit zunehmend Datenbank-Verbindungen offen ließen. In ungünstigen Fällen führte das zu steigender CPU-/Arbeitsspeicher-Last und „Too many open files". Die Hintergrund-Dienste nutzen jetzt eine **gemeinsame, wiederverwendete Datenbank-Verbindung** — der Server läuft dadurch auch über Tage durchgehend stabil.

## v7.20 - 14. Juni 2026 · Klarerer Update-Weg (Beta)

🔄 **Updates laufen jetzt eindeutig über das Server-Update.**

### ✨ Verbessert
- **Eindeutiger Update-Weg:** Der nicht mehr benötigte „Jetzt aktualisieren"-Button in der Software wurde entfernt. Updates werden zuverlässig direkt auf dem Server über das Update-Script eingespielt — die Update-Seite zeigt dafür jetzt direkt den passenden Befehl an (`curl -fsSLk https://shiftdeck.de/download/update.sh | bash`).

## v7.19 - 13. Juni 2026 · Login-Stabilität nach Updates (Beta)

🔌 **Folgekorrektur zu 7.18.**

### 🐛 Behoben
- **Anmeldung direkt nach einem Update zuverlässig erreichbar:** In seltenen Fällen war der Login kurz nach einem Update vorübergehend nicht verfügbar. Das ist behoben — nach jedem Update kann man sich sofort wieder anmelden.

## v7.18 - 13. Juni 2026 · Stabiler Dauerbetrieb (Beta)

🩹 **Wichtiger Stabilitäts-Fix.**

### 🐛 Behoben
- **Durchgehend stabiler Dauerbetrieb:** Behoben wurde ein Problem, durch das die Software bei sehr langer Laufzeit zunehmend Arbeitsspeicher belegte und der Server dadurch träge werden oder hängen bleiben konnte. SHIFTDECK läuft jetzt auch im Dauerbetrieb durchgehend stabil.

## v7.17 - 10. Juni 2026 · Projekt-Auswertung, Schichttausch & Stabilität (Beta)

🧰 **Menü-für-Menü-QA der gesamten Software** — gefundene Fehler behoben.

### 🐛 Behoben
- **Schichttausch funktioniert wieder:** Eine Tauschanfrage konnte zuletzt nicht abgeschickt werden (technischer Schema-Konflikt, „422"). Anlegen, Anzeigen und Genehmigen laufen jetzt durchgängig über denselben Weg.
- **Projekt-Auswertung & Projekt-PDF** zeigen jetzt die echten Arbeitsstunden je Mitarbeiter (aus den Stempeldaten, inkl. automatischem Pausenabzug und Nachtschicht) — vorher blieben Stunden/Lohnkosten leer. Auch die Stundensumme in der Projektliste stimmt nun.
- **Urlaub/Abwesenheit:** Doppelte Anträge für denselben Zeitraum werden abgelehnt; Enddatum vor Startdatum wird abgefangen.
- **Arbeitszeitkorrektur-Antrag:** Plausibilitätsprüfung (gültige Uhrzeiten, Pausenende nicht vor Pausenbeginn, identische Kommen/Gehen-Zeit) verhindert fehlerhafte Anträge.
- **Mitarbeiter löschen:** Der Eigentümer (Super-Admin) und das eigene Konto sind geschützt; beim Löschen werden jetzt alle zugehörigen Daten (Nachrichten, Anträge, Korrekturen, Dokumente, Tausch-Anfragen) mit entfernt — keine „Karteileichen" mehr.
- **Geburtstags-Widget:** Der 29. Februar wird in Nicht-Schaltjahren korrekt auf den 28. Februar gelegt (vorher fehlten solche Geburtstage).
- **Team-Kalender** fängt leere/ungültige Datumsangaben sauber ab (kein Serverfehler mehr).
- **Gruppen-Liste** ist robuster gegen fehlende Farb-/Namensangaben.

## v7.16 - 10. Juni 2026 · Lohn-relevante Korrekturen & Robustheit (Beta)

🛡️ **Weitere Korrekturen aus der QA-Prüfung** — Schwerpunkt Lohn-Genauigkeit und Stabilität.

### 🐛 Behoben
- **Überstunden-Genehmigung (lohn-kritisch):** Beim Genehmigen eines Überstundenantrags wird der Tagessaldo jetzt **addiert** statt überschrieben — der automatisch berechnete Anteil (Pausen, Schicht-Soll) bleibt erhalten. Vorher konnten genehmigte Stunden den errechneten Saldo verfälschen.
- **Widget „Top-Überstunden":** Zeigt den Saldo jetzt korrekt in Stunden (vorher fälschlich nochmals durch 60 geteilt).
- **Schicht-Anlage:** Neue Schichten werden auf **Überschneidungen** mit bestehenden Schichten desselben Mitarbeiters geprüft (nachtschicht-bewusst) und doppelte/kollidierende Einträge verhindert.
- **Schichttausch:** Schutz gegen **doppelte Genehmigung** — ein bereits bearbeiteter Tausch-Antrag kann nicht erneut genehmigt werden.
- **Dashboard-Widgets** (Urlaubsanträge u. a.) fangen fehlerhafte/leere Datumswerte ab und stürzen nicht mehr ab.
- **Projekt-Material-Eingabe** verarbeitet Mengen/Preise jetzt tolerant (Komma/leere Felder) ohne Fehler.

## v7.15 - 10. Juni 2026 · Lohn-Export & Auswertungen korrigiert (Beta)

📊 **Korrekturen bei Lohn-Export und Statistiken** (Fortsetzung der QA-Prüfung).

### 🐛 Behoben
- **DATEV-/Lohn-Export** rechnet jetzt aus den echten Stempeldaten (vorher leere Werte) — inkl. automatischem Pausenabzug, Schicht-Soll und Nachtschicht-Korrektur.
- **Dashboard-Wochentrend** zeigt jetzt die tatsächlich gearbeiteten Stunden statt einer 8-Stunden-Pauschale pro Ausstempeln.
- **Monatstrend** verwendet echte Kalendermonate (vorher konnten Monate doppelt erscheinen oder fehlen).
- **Automatische Schichtzuweisung**: Endzeiten passen jetzt zur Sollstunden-Vorgabe (Minuten gehen nicht mehr verloren).
- **Urlaub**: Offene (noch nicht genehmigte) Anträge reservieren jetzt Kontingent — verhindert Überbuchung.
- Arbeitszeit wird auf die Minute gerundet statt abgeschnitten (kein schleichender Minus-Bias mehr); Antragszeiten ohne festen Sommerzeit-Versatz.

## v7.14 - 10. Juni 2026 · Zeitberechnungs-Korrekturen (Beta)

🕒 **Korrekturen rund um Arbeitszeit, Überstunden und Schichten** (aus QA-Prüfung).

### 🐛 Behoben
- **Nachtschichten über Mitternacht** (z. B. 22:00–06:00) ergeben jetzt korrekt die Soll-/Arbeitszeit (8 h) statt negativer Werte — an allen Stellen (Stempeln, Stundenzettel, Status, Exports, Auto-Stundenzettel).
- **Einheitliche Überstunden-Berechnung:** Die Admin-Neuberechnung („Überstunden neu berechnen") liefert jetzt **denselben** Saldo wie das normale Aus­stempeln — inkl. automatischem Pausenabzug, Schicht-Soll (mit Nachtschicht) und genehmigten Abwesenheitstagen.
- **Automatisches Ausstempeln:** Vergessene offene Stempelungen werden nach der eingestellten Stundenzahl automatisch geschlossen — **Ausnahme: im Dienstplan eingetragene Nachtschichten** (über Mitternacht) werden NICHT automatisch ausgeloggt.
- **Urlaub bearbeiten:** Wird der Zeitraum eines genehmigten Urlaubs geändert, wird das verbrauchte Urlaubskontingent jetzt korrekt um die Differenz angepasst (vorher gingen Tage verloren bzw. wurden doppelt gezählt).

## v7.12 - 10. Juni 2026 · Lizenz-Krypto (RSA) + Module + Superadmin (Beta)

🔐 **Lizenz-Schutz auf asymmetrische Signatur (RSA) vorbereitet** und Modul-Lesen ergänzt.

### 🔐 Sicherheit
- **RSA-Signatur-Prüfung der Lizenz-Antwort** (Public Key in der Software). Damit ist eine gefälschte Lizenz-Antwort nicht mehr möglich, ohne den privaten Schlüssel des Lizenzservers zu besitzen. Übergangsweise wird die alte HMAC-Signatur weiter akzeptiert, bis alle Installationen aktualisiert sind.
- **Superadmin-Passwort stabil aus der `.env`**: `install.sh`/`update.sh` erzeugen ein zufälliges `SUPERADMIN_PASSWORD` und sichern es in der `.env`; `docker-compose.prod.yml` reicht es (und den optionalen strengen Lizenz-Modus `SHIFTDECK_STRICT_LICENSE`) an das Backend durch. Kein wechselndes Passwort mehr bei jedem Rebuild.

### 🧩 Module
- Das Backend liest jetzt die per Lizenz freigeschalteten **Module** (signiert) aus und stellt sie unter dem Lizenz-Status bereit. Grundlage für künftige, über die Lizenz freischaltbare Zusatzmodule.

## v7.11 - 10. Juni 2026 · Sicherheits-Härtung (Beta)

🔒 **Umfassende Sicherheits-Überarbeitung des Backends.** Mehrere kritische und hohe Schwachstellen wurden geschlossen — ohne Änderung an Bedienung oder Design.

### 🛡️ Kritisch behoben
- **Registrierung kann keine Admin-Rolle mehr selbst vergeben.** Die Rolle wird nicht mehr aus der Anfrage übernommen — nur der allererste Account einer leeren Instanz wird Admin, alle weiteren sind „Mitarbeiter". Zusätzlich kann über die Benutzerverwaltung keine „Superadmin"-Rolle mehr vergeben werden.
- **Keine hartcodierten Geheimnisse mehr.** JWT-Secret, Superadmin-Passwort und Org-Admin-Passwort kommen jetzt aus der Umgebung bzw. werden zufällig erzeugt (kein bekanntes Standard-Secret mehr). Pro-Mandant ein eigenes zufälliges JWT-Secret.
- **`/api/seed` abgesichert.** Läuft nur noch auf einer komplett leeren Instanz und gibt keine Klartext-Passwörter mehr zurück.
- **Update-System gehärtet.** Versionsangaben werden streng geprüft (Schutz vor Befehls-Einschleusung), Update-Archive werden gegen „Zip-Slip"/Pfad-Ausbruch abgesichert, optionale SHA-256-Integritätsprüfung, FTP-Zugangsdaten aus dem Code entfernt (jetzt verschlüsselt/aus der Umgebung).

### 🔐 Weiter abgesichert
- **Brute-Force-Schutz** für alle Anmelde-Wege (Login, Superadmin, Passwort-Reset, 5-stelliger PIN, QR-/Telefon-Anmeldung) mit temporärer Sperre nach zu vielen Fehlversuchen.
- **System-Aktionen** (Update/Neustart/Rollback) erfordern jetzt zwingend eine gültige Admin-Anmeldung.
- **SSRF-Schutz** beim Laden des Firmen-Logos (nur öffentliche Adressen).
- **Datei-Uploads** werden anhand des echten Dateiinhalts geprüft (SVG/Skript-Dateien werden abgelehnt).
- **Passwort-Reset** verrät nicht mehr, ob eine E-Mail existiert; E-Mail-Versand gegen Header-Einschleusung abgesichert; Sitzungs-Tokens laufen jetzt korrekt 24 Stunden.

### ℹ️ Hinweise für Betreiber
- Optionaler strenger Lizenz-Modus über `SHIFTDECK_STRICT_LICENSE=1` (erzwingt signierte Lizenz-Antworten). Standardmäßig aus — bestehende Installationen laufen unverändert weiter.
- Ist kein `SUPERADMIN_PASSWORD` gesetzt, wird beim Start einmalig ein zufälliges erzeugt und ins Log geschrieben.

## v7.10 - 8. Juni 2026 · Überstunden-Korrekturen: Urlaub & Krankheit (Beta)

🛠️ **Wichtige Korrekturen rund um Überstunden, Urlaub und Krankheit** — auf Basis mehrerer Support-Tickets.

### 🐛 Behoben
- **Urlaub & Krankheit erzeugen keine Minusstunden mehr.** An genehmigten Abwesenheitstagen gilt die Sollzeit automatisch als erfüllt (0 Überstunden statt fälschlicher Unterstunden). Greift sowohl bei der automatischen Neuberechnung einzelner Tage als auch über das Archiv (ältere Krankmeldungen).
- **Manuell gesetzter Überstunden-Anfangssaldo bleibt erhalten.** Die Funktion „Überstunden neu berechnen" überschreibt den manuellen Stand nicht mehr, sondern addiert ihn als Anfangssaldo zu den berechneten Tageswerten.
- **Neuberechnung bricht nicht mehr mit Fehler ab,** wenn ein Mitarbeiter keine vollständige Stundenverteilung hinterlegt hat (robuste Typprüfung + Fehlerbehandlung).

### 🔎 Nachvollziehbarkeit
- **Zeitkorrekturen** sichern jetzt die tatsächlichen Original-Einträge vor dem Überschreiben (neue Audit-Spur `time_entry_audit`).
- **Gelöschte Abwesenheiten** (z. B. Krankmeldungen) werden protokolliert (`absence_audit`) — verschwundene Einträge sind nun nachvollziehbar (wer/wann).

### 📖 Doku
- Mitarbeiter-Handbuch um „Wie Überstunden berechnet werden" (Netto vs. Brutto) und „Urlaub & Krankheit im Stundenzettel" ergänzt.
- FAQ-Bot um vier neue Einträge erweitert (Pausenlogik, Urlaub/Krankheit, Anfangssaldo, Neuberechnung).

## v7.09 - 6. Juni 2026 · Hugo Power-Boost + Offizielles Logo (Beta)

⚡ **Hugo nutzt jetzt die volle Server-Hardware** — vorher liefen nur ~50 % CPU, Antworten kamen langsam oder gar nicht.

### ⚡ Performance
- **`num_thread: 8`** — alle 8 CPUs des Hugo-Servers (Xeon E5-2680 v2) werden genutzt
- **`num_batch: 512`** — mehr Tokens parallel verarbeitet
- **`num_ctx: 16384`** — doppelter Context (vorher 8192) für lange Konversationen + Knowledge
- **`num_keep: 24`** — System-Prompt bleibt im Cache (kein Re-Embedding)
- **`keep_alive: 30m`** — Modell bleibt 30 Min im RAM nach letzter Anfrage (kein Cold-Reload)
- **`num_predict: 600`** — längere Antworten möglich

### 🎨 UI
- **Offizielles SHIFTDECK-Brand-Icon** in chat.html (Login, Sidebar, Empty-State) — `shiftdeckicon256x256.png` statt eigenes SVG. Konsistent mit Webseite.

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?v=$(date +%s)" | bash
```

---

## v7.08 - 6. Juni 2026 · Hugo Context-Fix + Logo-Refresh (Beta)

🐛 **Bug-Fix:** Hugo antwortete oft nur mit „1 Token" und brach dann ab. Ursache: der Ollama-Default-Context (2048 Tokens) reichte nicht für die 14-KB-Knowledge-Base plus User-Nachricht — das Modell hatte keinen Platz mehr für eine Antwort.

### 🐛 Behoben
- **`num_ctx: 8192`** in allen Ollama-Calls (Software-Backend + drei Webseiten-Endpoints) — 4× mehr Kontext
- **Knowledge-Base auf 6 KB begrenzt** (vorher 14 KB) — passt jetzt in den 8K-Context mit Platz für Antwort
- **Fußzeilen-Hinweis** bei abgeschnittener Knowledge: „weitere Themen siehe /faq.html"

### 🎨 Frontend (Webseite)
- **Eulen-Avatar entfernt** auf `/chat.html` (Login, Sidebar, Empty-State, Chat-Bubbles)
- **Professionelles SHIFTDECK-Mark** als Karten-Stack-Symbol — passt zur „Schicht-Deck"-Idee
- Chat-Bubble-Avatar von 🦅 auf ✦ (Funkeln-Symbol)
- Provider-Select: „✦ Hugo (lokal)" statt „🦅 Hugo (lokal)"

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?v=$(date +%s)" | bash
```

---

## v7.07 - 5. Juni 2026 · Hugo-KI mit Streaming (Beta)

🦉 **Hugo zieht in die Software ein.** Der bisherige Claude-API-Bot wird durch unseren **eigenen, kostenlosen Ollama-KI-Server** ersetzt. Vorteil: keine API-Kosten pro Anfrage, eigener Server in Deutschland, DSGVO-konform, antwortet jetzt **Token für Token wie ChatGPT** statt komplett am Ende.

### ✨ Neu
- **Hugo Streaming-Chat** im Admin-Panel (Floating Bot rechts unten)
- Antworten werden in Echtzeit angezeigt — kein Warten auf die komplette Antwort
- **Eigener KI-Server** (`185.249.199.238:8080`, llama3.2:3b) statt Claude-API
- **`shiftdeck-knowledge.md`** wird automatisch als Wissensbasis mitgeschickt — Hugo kennt alle Module
- Hugo grüßt jetzt mit Eulen-Emoji 🦉 und stellt sich als „Hugo" vor

### 🔧 Backend
- Neuer Endpoint `POST /api/hugo/stream` (NDJSON-Streaming, Auth via Bearer-Token)
- Knowledge-File `backend/shiftdeck-knowledge.md` (13 KB) wird beim Start gelesen
- Cold-Start ca. 12 Sek, danach ~3-4 Sek pro Antwort
- Fehler-Tolerant: bei Timeout kommt eine freundliche „Modell wärmt sich auf"-Meldung

### 🎨 Frontend
- `AiAssistant.js` komplett auf Streaming umgestellt
- Token-für-Token Anzeige mit Live-Update der Bot-Bubble
- Begrüßungstext modernisiert

### 📌 Hinweis
- Die alte Claude-API-Konfiguration (`ANTHROPIC_API_KEY`) wird NICHT mehr verwendet
- Wer Claude weiter nutzen möchte, kann den `/api/ai/chat`-Endpoint nutzen — der ist unverändert

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?v=$(date +%s)" | bash
```

---

## v7.06 - 5. Juni 2026 · Echte Umlaute + Avatar-Cleanup (Beta)

📝 **Texte überarbeitet:** Alle Einführungs-Texte verwenden jetzt korrekte deutsche Umlaute (ÄÖÜ ß) statt ae/oe/ue/ss. Der nicht mehr genutzte SHIFTI-SVG-Avatar wurde komplett entfernt (Dead Code).

### ✏️ Sprache
- Alle 21 Schritte mit echten Umlauten: „über", „für", „nächste", „Anträge", „Stundenzettel", „Lückenlos", „Überstunden", „Vergessenwerden", „dürfen", „können", „Pflichtpause", „Wirtschaftsprüfer" usw.
- Anführungszeichen auf deutsche Gänsefüßchen umgestellt („…")
- Bindestriche durch Halbgeviertstriche (—) ersetzt für besseren Lesefluss

### 🧹 Cleanup
- `ShiftiAvatar`-Komponente komplett gelöscht (~120 Zeilen SVG-Code) — wurde seit dem Premium-Redesign in v7.05 nicht mehr genutzt
- Bundle-Größe leicht reduziert

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?v=$(date +%s)" | bash
```

---

## v7.05 - 5. Juni 2026 · Premium-Redesign Einführungs-Tour (Beta)

🎨 **Komplett neu gestaltet — Vercel/Linear-Stil.** Die Tour sieht jetzt wie ein Enterprise-Produkt aus, nicht mehr wie ein Hobby-Projekt. Cartoon-Avatar raus, professionelle Icon-Tiles rein.

### 🎨 Design-Änderungen
- **SHIFTI-Avatar entfernt** — ersetzt durch farbiges Icon-Tile (Lucide-Icon im Indigo-Gradient) — wirkt sofort wie aus einem modernen SaaS-Tool
- **Header in Weiß/Off-White** statt knalligem Gradient pro Schritt — konsistenter, ruhiger Look
- **Eine Akzent-Farbe**: Indigo-500 für alles (statt 20 verschiedene Gradient-Farben durcheinander)
- **Typografie verbessert**: feine Letter-Spacing, kräftigere Hierarchie, mehr Whitespace
- **NEU/WICHTIG-Badges** schlicht in Lavendel/Amber-Boxen, statt verspielter Confetti-Animation
- **Brand-Row oben**: „SHIFTDECK Einführung · 17 von 21" — wie bei Stripe/Vercel-Onboarding
- **Slim Progress-Bar** (2px) statt dicker Balken mit %-Bubble
- **Icon-Tiles für Tipps**: kleine Lavendel-Quadrate mit Emoji, statt nackter Emojis
- **Premium-Buttons**: Indigo-Gradient mit Hover-Lift (+1px transform), subtilere Shadows
- **Letzter Step**: Grüner „Einrichtung starten" Button (vorher: pulsierender „Los geht's!" mit Confetti)
- **Wegfall**: Float-Animation, Confetti, Shine-Effekt, Sparkles-Drall — wirkten verspielt
- **Dezenter Overlay**: 55% Opacity statt 75% — weniger erdrückend

### 📐 Layout
- Side-by-Side jetzt mit Verhältnis 1.05:1 (Bild leicht größer)
- Subtilere Border-Radius (12px statt 28px)
- Modal max-width 960px (vorher 920px) — mehr Platz für Screenshots

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?v=$(date +%s)" | bash
```

---

## v7.04 - 5. Juni 2026 · Docker Race-Condition Fix (Beta)

🐳 **Fix für `update.sh`:** Bei manchen Update-Läufen lief `docker compose up --force-recreate` parallel zur Container-Removal vom vorhergehenden `down` — Docker meldete „removal of container X is already in progress" und die neuen Container starteten nicht.

### 🐛 Behoben
- **Synchrones Stoppen**: `down` mit `--remove-orphans -t 60` (60-Sekunden-Timeout)
- **Warte-Schleife**: Skript wartet bis zu 30s bis alle shiftdeck/admin-ser-Container restlos entfernt sind; falls nicht → `docker rm -f` als Notbremse
- **`--force-recreate` entfernt**: Da `down` bereits alles bereinigt, erzeugt `up -d` ohnehin frische Container mit aktuellem Image. Verhindert die Race-Condition

### 🩹 Falls Du gerade festhängst
```bash
cd /opt/shiftdeck
docker compose -f docker-compose.prod.yml down --remove-orphans -t 60
sleep 10
docker container prune -f
docker compose -f docker-compose.prod.yml up -d
```

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?v=$(date +%s)" | bash
```

---

## v7.03 - 5. Juni 2026 · Tutorial-Modal Transparenz-Fix (Beta)

🔧 **Hotfix:** Auf manchen Demo-Servern wurde das Einführungs-Tutorial halbtransparent gerendert — Header verblasst, Texte unsichtbar, nur der Weiter-Button war klickbar.

### 🐛 Behoben
- **Modal-Stacking-Context-Bug**: Der `backdrop-filter`-Layer hat das Modal verschluckt, wenn ein Parent (z.B. das `animate-fade-in` des Dashboards) `transform` oder `filter` benutzte — dann brach `position:fixed` und das Modal landete hinter dem Blur.
- **Fix**: 
  - Modal wird jetzt via `ReactDOM.createPortal` direkt unter `document.body` gerendert — umgeht jeden Parent-Stacking-Context
  - Overlay + Modal in einen gemeinsamen Wrapper mit `isolation: isolate` gepackt
  - `backdrop-filter: blur` entfernt (war die Ursache der Transparenz)
  - Solides `background: #ffffff` auf Modal-Container, unabhängig von Tailwind-Klassen
  - Z-Index auf `2147483646` (maximal-möglich) hochgezogen — kein Modal kann mehr „darüberliegen"
- **install.sh** Version auf 7.03 nachgezogen

### Update
```bash
curl -fsSLk "https://shiftdeck.de/download/Beta-Tester/update.sh?bust=$(date +%s)" | bash
```

---

## v7.02 - 5. Juni 2026 · Einführung erneut anzeigen (Beta)

🔄 **Die Admin-Einführungs-Tour lässt sich jetzt jederzeit neu starten.** Unter **Einstellungen → Einführung** finden Admins zwei Bereiche: eigene Tour neu starten und Tour für andere Mitarbeiter zurücksetzen.

### ✨ Neu
- **Neuer Tab „Einführung"** in den Admin-Einstellungen
  - **Eigene Tour neu starten** mit goldenem Status-Banner (zeigt aktuellen Status)
  - **Mitarbeiter-Liste** mit Filter „Nur Admins/Leiter" oder „Alle Mitarbeiter"
  - Pro Mitarbeiter ein „Zurücksetzen"-Button + Status-Badge (✓ Abgeschlossen / Offen)
- **Backend-Endpoints**:
  - `POST /api/auth/restart-onboarding` — eigener Reset
  - `POST /api/admin/users/{id}/reset-onboarding` — fremder Reset (nur für Admins/Super-Admin)
- Nach „Einführung neu starten" wird automatisch zum Dashboard navigiert, wo SHIFTI direkt erscheint

### 🎨 UX-Details
- Avatar-Emoji 👋 im Status-Banner
- Mitarbeiter mit Initialen-Avatar
- Reset-Button ist disabled wenn Tour noch nicht abgeschlossen ist (kein doppelter Reset nötig)
- Toast-Notification nach erfolgreichem Reset
- Live-Status-Update in der Mitarbeiter-Liste ohne Page-Reload

### Update
```bash
curl -fsSLk https://shiftdeck.de/download/Beta-Tester/update.sh | bash
```

---

## v7.01 - 5. Juni 2026 · Admin-Einführungs-Assistent (Beta)

🎓 **Neue Admins werden jetzt persönlich begrüßt!** Beim allerersten Login öffnet sich automatisch eine interaktive 21-Schritte-Tour mit echten Screenshots — durch alle Module von Dashboard über Dienstplan, Mitarbeiter, Berechtigungen, GPS, Statistiken bis DSGVO. Unser kleiner Avatar **SHIFTI** führt Schritt für Schritt durch das Admin-Panel.

### ✨ Neu
- **Admin-Einführungs-Assistent** (`modules/admin/onboarding`)
  - Triggert automatisch beim ersten Admin-Login (auch bei neu angelegten Admins)
  - 21 Schritte mit echten Screenshots aus dem Live-System
  - Animierter Avatar SHIFTI mit drei Posen (winken / zeigen / jubeln)
  - Progress-Bar mit Prozent-Anzeige, Dot-Navigation, Keyboard-Steuerung (← → ESC)
  - Highlights für **NEU** und **WICHTIG** markierte Module
  - Tour kann jederzeit übersprungen werden — Status wird im Backend gespeichert
  - Auch für Gruppen-Leiter (`role=group_leader`) verfügbar
- **30 hochauflösende Admin-Screenshots** im Frontend (`/public/onboarding-admin/`)

### 🎨 Design-Details
- Glassmorphism-Modal mit Gradient-Header pro Modul
- Side-by-side: Screenshot links + Erklärung rechts (Desktop), gestackt (Mobile)
- Smooth-Animationen (slide-in/-out, fade-up, pulse-ring beim Final-Button)
- Vollständig responsiv

### 📌 Hinweis
- Bestehende Admins, die das Onboarding bereits abgeschlossen haben (`has_completed_onboarding = true`), sehen die neue Tour **nicht** mehr — gewollt, damit erfahrene Admins nicht erneut belästigt werden
- Wer die Tour erneut sehen möchte: im Backend `UPDATE users SET has_completed_onboarding = 0 WHERE id = ?`

### Update
```bash
curl -fsSLk https://shiftdeck.de/download/Beta-Tester/update.sh | bash
```

---

## v7.00 - 5. Juni 2026 · update.sh-Bugfix (Beta)

🔧 **Hotfix für die Update-Routine:** Sowohl Demo 1 als auch Demo 2 sind nach `update.sh` auf der alten v6.96 hängengeblieben. Wurzelursache: drei Bugs im `update.sh` selbst.

### 🐛 Behoben
- **Frontend-Build hängt bei `--no-cache`** auf knappen 2-GB-Servern (Webpack OOM-stalled) — `--no-cache` entfernt, normaler Cache-Build geht 4× schneller und liefert dasselbe Ergebnis, da `src/` ohnehin per `COPY` kopiert wird
- **`backend/VERSION` wurde überschrieben** mit veralteter Top-Level-`VERSION` — Reihenfolge umgekehrt: jetzt ist `backend/VERSION` autoritativ und wird in die Top-Level-`VERSION` gespiegelt
- **Container blieb am alten Image** trotz neuem Build — `docker compose up -d` hat den frischen Image-Tag nicht übernommen. Fix: `--force-recreate` zwingt Container immer aufs aktuellste Image

### ⚡ Verbessert
- Update-Zeit auf 2-GB-Servern: vorher 15–25 Min, jetzt 5–8 Min
- Build-Status-Diagnose bleibt erhalten (DONE/ERROR-Filter unverändert)

### 📌 Hinweis
- Wer aktuell auf v6.99 hängt und v7.00 testen will: einmal manuell mit `--force-recreate` durchziehen, dann läuft jeder weitere `update.sh` sauber durch.

### Update
```bash
curl -fsSLk https://shiftdeck.de/download/Beta-Tester/update.sh | bash
```

---

## v6.99 - 4. Juni 2026 · Hotfix

🔥 **Hotfix für v6.98:** `/admin/users` lieferte HTTP 500 nach dem Update, weil das neue `permissions`-Feld der `UserResponse` als `Dict[str, bool]` getypt war — der Schlüssel `allowed_groups` ist aber eine Liste. Typ auf `Dict[str, Any]` korrigiert.

- **Symptom:** Nach Berechtigungs-Änderung verschwand die Mitarbeiter-Liste komplett
- **Fix:** UserResponse-Schema-Korrektur, kein Daten-Migrationsbedarf
- **Update:** `curl -fsSLk https://shiftdeck.de/download/Beta-Tester/update.sh | bash`

---

## v6.98 - 4. Juni 2026

Mitarbeiter mit Admin-Berechtigungen sehen die zugehörigen Bereiche jetzt direkt im User-Panel. Beispiel: Wer im Admin-Panel unter „Berechtigungen verwalten" die Berechtigung **„Dienstplan bearbeiten"** bekommt, findet im User-Panel eine neue Sidebar-Gruppe **„Planung"** mit dem Eintrag **„Dienstplan bearbeiten"** — und kann den vollwertigen Dienstplan-Editor wie ein Admin nutzen.

### 🔐 Permission-basierte User-Sidebar
- Neue Sidebar-Gruppen für Mitarbeiter, abhängig von vergebenen Berechtigungen:
  - **Planung** → erscheint bei `can_edit_schedule` (Dienstplan bearbeiten + Wochenrhythmus)
  - **Team** → erscheint bei `can_manage_users` (Mitarbeiter) oder `can_edit_time_entries` (Zeitkorrektur)
  - **Auswertung** → erscheint bei `can_view_statistics` (Statistiken) oder `can_edit_time_entries` (Stundenzettel-Freigabe)
- Items werden nur sichtbar, wenn die jeweilige Berechtigung gesetzt ist — Sidebar bleibt sauber
- Keine separate User-Variante der Editor-Komponenten — der Mitarbeiter nutzt **dieselbe UI** wie der Admin

### 🛡 Backend-Schutz erweitert
- Neuer Helper `require_permission(perm)` im Backend ersetzt `require_admin_or_group_leader` an permissions-relevanten Endpoints
- Shift-Endpoints (POST/PUT/DELETE `/shifts`, `/schedule/release`, `/schedule/unrelease`) akzeptieren jetzt auch Employee mit `can_edit_schedule`
- `/auth/me` und `LoginResponse` liefern die `permissions` mit, damit das Frontend ohne separaten API-Call entscheiden kann

### 🧭 Frontend-Routing
- `ProtectedRoute` bekommt neuen Prop `requiredPermission` — Employees mit der Permission dürfen auf die Admin-Route
- Aktualisierte Routes: `/admin/schedule`, `/admin/employees`, `/admin/time-correction`, `/admin/statistics`, `/admin/weekly-rotations`, `/admin/timesheets`

### 📌 Hinweis
- Bestehende Stable-Installationen sind nicht betroffen — Auswirkungen erst nach Berechtigungs-Vergabe sichtbar
- Wer keine Edit-Berechtigung hat, sieht das User-Panel exakt wie vorher

### Update
```bash
curl -fsSLk https://shiftdeck.de/download/Beta-Tester/update.sh | bash
```

---

## v6.97 - 2. Juni 2026

Lizenz-Check-Intervall ist jetzt konfigurierbar und wurde auf 60 Sekunden gesenkt (vorher 5 Minuten).

### ⚙️ Lizenz-Check via ENV-Variable steuerbar
- **Neue Variable:** `LICENSE_CHECK_INTERVAL_SEC` in der `.env` der Software
- **Default:** 60 Sekunden (vorher fest 300 Sekunden = 5 Min)
- **Vorteile:**
  - Sperrungen, Add-on-Käufe und User-Count-Änderungen wirken nahezu in Echtzeit
  - Bei knapper Bandbreite oder langsamer Anbindung kann der Wert hochgesetzt werden, z. B. `LICENSE_CHECK_INTERVAL_SEC=600`
- **Backend-Side (shiftdeck.de) bereits angepasst:** Wenn ein Software-Server **keinen** Lizenz-Key sendet, aber eine **bekannte Hardware-ID**, wird automatisch die an diese Hardware gebundene Lizenz zurückgegeben statt einer Trial-Antwort. So fallen Installationen nach einem Reset nicht mehr versehentlich in den 14-Tage-Trial-Modus.

### 🔧 Update-Hinweis
- Nach dem Update auf v6.97 ist der Check standardmäßig auf 60 Sekunden gesetzt — keine Aktion nötig
- Wer einen anderen Wert möchte: in `/opt/shiftdeck/.env` ergänzen: `LICENSE_CHECK_INTERVAL_SEC=60`, danach `docker compose restart admin-server-backend`

---

## v6.96 - 17. Mai 2026

Bugfix-Release: Stundenzettel-Berechnung komplett überarbeitet — alle entdeckten Rechenfehler im Monatsbericht und im laufenden Überstundenkonto wurden behoben.

### 🐛 Stundenzettel-PDF · Überstunden aus NETTO statt BRUTTO
- **Problem:** Überstunden wurden bisher aus der Brutto-Arbeitszeit (vor Pausenabzug) berechnet, dadurch waren die Werte systematisch zu hoch — z. B. zeigte ein Tag mit 10:53 Brutto / 9:55 Netto / 7:48 Soll +3:05 Überstunden statt der korrekten +2:07.
- **Fix:** Überstunden werden jetzt überall aus der **Netto-Arbeitszeit** (nach Auto-Pause und expliziten Pausen) berechnet — gemäß Arbeitszeitgesetz.
- Betroffen waren: Stundenzettel-PDF (Monatsbericht), Zeitbericht-PDF, Zeitbericht-Excel-Export, generierte Monatsberichte und die Live-Überstunden-Bilanz bei jedem Stempelvorgang.

### 🐛 Stundenzettel-PDF · Urlaub/Krank ergibt keine Minus-Stunden mehr
- **Problem:** Genehmigte Abwesenheiten (Urlaub, Krankheit, Kind-krank, Freizeitausgleich, unbezahlter Urlaub) erzeugten -7:48 Überstunden pro Tag, obwohl der Tag als „erfüllt" gelten muss.
- **Fix:** Abwesenheitstage zählen jetzt als erfüllte Sollzeit → 0 Überstunden, keine Minus-Stunden mehr im Monatssaldo.

### 🐛 Stundenzettel-Footer · Korrekte Anzeige negativer Monatssumme
- **Problem:** Der Footer zeigte „Monat: -5:25h" während die Tabellensumme korrekt -4:25 anzeigte (1-Stunden-Differenz durch Python-Floor-Division bei negativen Werten).
- **Fix:** Footer- und Tabellen-Anzeige verwenden jetzt überall die gleiche Formel mit `abs()`-Klammer — Werte stimmen exakt überein.

### 🔧 Excel/PDF-Zeitbericht · Konsistente Vorzeichen-Darstellung
- Tages- und Gesamtsumme im Excel- und PDF-Zeitbericht enthalten jetzt explizit `+`/`-` Vorzeichen und identische Berechnung wie im Stundenzettel.

---

## v6.94 - 11. Mai 2026

Erste offizielle Beta-Version mit umfassenden Kern-Verbesserungen.

### 🐛 Kritischer Bugfix · 3-User-Fallback bei deaktivierter Lizenz
- **Problem behoben:** Bei deaktivierter Lizenz waren auch die 3 erlaubten Free-User komplett gesperrt — niemand konnte einstempeln, Schichten erfassen oder arbeiten.
- **Ursache:** Der Lizenz-Checker setzte bei `SUSPENDED`/`CANCELLED` `max_users = 0` statt `3`.
- **Fix:** Bei deaktivierter Lizenz wird jetzt konsistent der Free-Modus mit 3 Usern aktiviert — identisch zum „abgelaufen"-Verhalten.
- Webhook-Sofort-Sperre (`/api/admin/license/notify`) wurde entsprechend angepasst.

### 🔓 License-Middleware · Eingeschränkter Modus für Free-User
- Im eingeschränkten Modus (`max_users > 0`) sind jetzt die Arbeits-Endpoints explizit freigeschaltet: Time-Tracking, Schichten, Abwesenheiten, Nachrichten, Berichte, Dashboard, Benachrichtigungen, eigene Einstellungen.
- Die Login-Filter sorgen dafür, dass nur die ersten 3 Mitarbeiter überhaupt einen Token erhalten.
- Admin bleibt voll funktionsfähig (Lizenz-Reaktivierung, User-Verwaltung).

### 🔄 Update-Bereich · Komplett überarbeitet
- **Kein Auto-Update mehr** — das automatische Update aus der Web-UI scheiterte reproduzierbar bei 98%.
- **Neuer Ablauf:** SHIFTDECK-Updates erfolgen ausschließlich manuell per Konsole — mit Schritt-für-Schritt-Anleitung im Admin-UI.
- **Server-OS-Updates** bleiben automatisch (`apt update && apt upgrade` läuft auf Host via `nsenter`).
- Status-Endpoint `/api/admin/system/server-os-status` listet verfügbare Pakete (Standard + Security).

### 🧪 Beta-Kanal-System (NEU)
- Software-Versionen werden ab v6.94 **zuerst nur** in `/download/Beta-Tester/` veröffentlicht.
- Lizenz-Flag `update_channel`: `stable` / `beta` / `both` (VIP) steuert Zugriff.
- Beta-Tester erhalten Vorab-Versionen, dafür Berichts-Pflicht (Bugs, Wünsche, Verbesserungen).
- Wechsel jederzeit über Admin-Lizenz-Bearbeitung möglich.

### 🐞 Bug- und Fehler-Reports (NEU)
- Neuer Bereich im Kundenkonto: **„🐞 Bug & Fehler melden"** — nur für Beta-Tester sichtbar.
- Jederzeit Bugs, Feature-Wünsche oder Feedback einreichen — zusätzlich zum monatlichen Bericht.
- Schweregrade (Niedrig / Mittel / Hoch / Kritisch) und Typ (Bug / Feature / Feedback).
- Admin sieht alle Reports unter `/admin-bug-reports.html` — mit Status-Workflow (Neu → In Bearbeitung → Gelöst).
- Automatische E-Mail-Benachrichtigung an Admin bei neuem Report.

### 📋 PDF-Renderer · Unterschriftslinie
- AVV-Verträge: Unterschriftslinie bleibt jetzt unter dem Bild durchgezogen (mix-blend-mode).
- Mehrseitige PDFs: Layout-Sprünge bei „AVV"-Headline behoben.

### 🎨 Admin-UI · Lizenz-Verwaltung
- **Status-Badges** auf Deutsch: „Aktiv", „Deaktiviert", „Gekündigt", „Abgelaufen" statt englischer Begriffe.
- **Kanal-Auswahl** beim Lizenz-Anlegen und Bearbeiten: Hauptversion / Beta-Tester / VIP (beides).
- Sofortiges Speichern beim Channel-Wechsel — kein extra Klick auf „Speichern" nötig.
- Channel-Badge in der Lizenz-Liste: 🧪 BETA-TESTER · ⭐ VIP.

### 🔐 Sicherheit · Lizenz-Validierung
- Live-Recheck beim Login (60-s-Frische-Garantie) — Deaktivierungen greifen in Sekunden statt Stunden.
- Background-Check alle 5 Min (vorher 60 Min).
- HMAC-signierte API-Antworten unverändert robust.

### Hinweis
- Update-Befehl (Beta-Kanal): `curl -fsSLk https://shiftdeck.de/download/Beta-Tester/update.sh | bash`
- Bug melden: Im Kundenkonto unter „🚀 Beta-Programm" → „🐞 Bug & Fehler melden"
- Monatlicher Bericht: Pflicht für aktiven Beta-Status (Rabatt 1,50 €/Nutzer/Monat)

---

## v6.94-seed - 10. Mai 2026

Erste Befüllung des Beta-Kanals mit dem aktuellen Stable-Stand. Inhaltsgleich zur Hauptversion v6.94 — ab der nächsten Version werden neue Releases zuerst hier veröffentlicht und erst nach Bestätigung in den Hauptkanal übernommen.

### Kanal-Übersicht

| Kanal | Lizenz-Flag | Update-URL |
|---|---|---|
| Hauptversion (Stable) | `update_channel = stable` (Standard) | `https://shiftdeck.de/download/update.sh` |
| Beta-Tester | `update_channel = beta` | `https://shiftdeck.de/download/Beta-Tester/update.sh` |
| VIP (beides) | `update_channel = both` | beide URLs erlaubt |
