# SETO – Module und Unterseiten ## 1. Startseite Die **Startseite** ist die zentrale Einstiegs- und Übersichtsseite von SETO. Von hier aus werden die Hauptmodule geöffnet. Nach der Anmeldung werden bereits wichtige Informationen aus Kalender, Profil und Abrechnung zusammengeführt. ### Funktionen der Startseite - Anmeldung mit Benutzername und Passwort - Demo-Zugang - DSGVO- und KR/AU-Einwilligung - Hinweis auf noch nicht abgeschlossene Einrichtung - Schnellzugriff auf Kalender - Schnellzugriff auf Abrechnung - Schnellzugriff auf Analyse und Simulation - Schnellzugriff auf Daten-Importer - Schnellzugriff auf das Profil - Hinweise zu Urlaub, AFZ und anderen Jahreswerten - Zusammenfassung wichtiger Profil- und Tarifdaten - Feedback senden - eigene Feedbacks und Rückmeldungen anzeigen ### Administration Für berechtigte Benutzer gibt es zusätzlich einen Administrationsbereich: - Feedback-Eingang - Rückmeldungen auf Feedback - anonymisierte Parser-Hilfen - Einladungen für neue Benutzer - Benutzerverwaltung --- # 2. Modul Kalender Das Modul **Kalender** verwaltet den persönlichen Schichtplan, Abwesenheiten, freie Tage sowie die daraus entstehenden Jahres- und Abrechnungswerte. ## 2.1 Kalender **Seite:** `schichtkalender/kalender.html` Die eigentliche Kalenderansicht. ### Funktionen - Monatsweise Darstellung des Schichtplans - automatische Anzeige von Tag- und Nachtschichten - Navigation zwischen Monaten - Sprung auf „Heute“ - Eintragen und Entfernen von Abwesenheiten Unterstützte Einträge: - **FS** – Freischicht - **U** – Urlaub - **SU** – Sonderurlaub - **KR** – Krankheit - **ZT** – Zusatzurlaub (Chemie-Zukunftsbetrag; GT wird kalenderseitig ebenfalls dieser Zusatzurlaubslogik zugeordnet) - **AFZ** – Arbeitsfreizeit - **ST** – manueller ST-Tag; zählt kalenderseitig wie die zugrunde liegende gearbeitete Sollschicht. Entgeltwirkungen werden nicht in die normale Monatsabrechnung eingerechnet, sondern nur als Rückrechnungs-/Prüfhinweis geführt. Zusätzlich: - NRW-Schulferien markieren - zusammenhängende freie Blöcke hervorheben - Verbindung zu den hinterlegten Schichtgruppen --- ## 2.2 Jahresübersicht **Seite:** `schichtkalender/jahresuebersicht.html` Fasst die Kalenderdaten eines kompletten Jahres zusammen. ### Unterbereiche **Übersicht** - Gesamtüberblick über das Kalenderjahr - Arbeits- und Abwesenheitstage **Zeitstrahl** - chronologische Darstellung des Jahres - besonders für freie Blöcke und längere Abwesenheiten geeignet **FSQ** - Freischichtquote - FS-Verbrauch und FS-Entwicklung - Jahreswerte zur FSQ **Abrechnung** - aus dem Kalender abgeleitete Abrechnungswerte - Übergabe der Kalenderdaten an die Abrechnung **Abwesenheiten** - Urlaub - Freischichten - Krankheit - Sonderurlaub - AFZ - weitere Abwesenheiten ### Weitere Funktionen - Abrechnungsbasis erzeugen - berechnete Abrechnungswerte speichern --- ## 2.3 Auswertung **Seite:** `schichtkalender/auswertung.html` Erstellt druckbare Auswertungen aus den Kalenderdaten. Wählbare Bereiche: - Jahresübersicht - Abwesenheiten - Abgleich - Schichtliste Die ausgewählten Daten können anschließend direkt gedruckt werden. --- ## 2.4 Jahresdruck **Seite:** `schichtkalender/druck.html` Spezielle Druckansicht für den Jahreskalender. ### Druckvarianten - 1-seitig kompakt - Jahreskalender - Schichtliste - 4-seitige Jahresdarstellung Zusätzlich auswählbar: - Tag- und Nachtschichten mitdrucken - Farben verwenden --- ## 2.5 Kalender-Export **Seite:** `schichtkalender/export.html` Exportiert den Schichtkalender als **ICS-Datei**. Damit können die Schichten beispielsweise in: - Google Kalender - Apple Kalender - Outlook - andere Kalenderprogramme übernommen werden. --- ## 2.6 Kalender-Menü **Seite:** `schichtkalender/menu.html` Zusätzliche Funktionen des Kalenders. Von hier erreichbar: - Kalender - Jahresübersicht - Abwesenheiten - Jahresdruck - Auswertung - Kalenderexport --- # 3. Modul Abrechnung Das Modul **Abrechnung** berechnet aus Profil-, Tarif- und Kalenderdaten eine monatliche Entgeltabrechnung und ermöglicht den Vergleich mit dem tatsächlichen Verdienstnachweis (VDN). --- ## 3.1 Monatsabrechnung **Seite:** `abrechnung/index.html` Zentrale Seite des Abrechnungsmoduls. ### Aufgabe Darstellung der berechneten monatlichen Abrechnung ähnlich einem Verdienstnachweis. Berücksichtigt unter anderem: - Tarifentgelt - Beschäftigungsgrad - Schichten - Zulagen - Abwesenheiten - Sonderzahlungen - Steuer - Sozialversicherung - Nettoentgelt - Auszahlung Monat und Jahr können gewechselt werden. --- ## 3.2 Schichten & Abwesenheiten **Seite:** `abrechnung/schichten.html` Zeigt detailliert, wie die einzelnen Kalender- und Schichtdaten auf die Abrechnung wirken. ### Unterbereiche **Tagesübersicht** - tageweise Aufstellung - Schicht oder Abwesenheitsart - abrechnungsrelevante Wirkung **FS & FS-Hätte** - einzelne Freischichten - FS-Hätte-Beträge - FSQ-Berechnung **FSQ / 39D1 Jahresverlauf** - Entwicklung der FSQ über das Jahr - Abgleich mit den VDN-Daten **VDN-Gegenüberstellung** - SETO-Berechnung gegen tatsächlich gebuchte Werte **Abrechnungswirkung der Schichten** - welche Schichten welche Entgeltbestandteile erzeugen **Zuschlagsrelevante Schichten** - Nacht - Sonntag - Feiertag - sonstige zuschlagsrelevante Zeiten ### Export - HR-CSV für FS/FSQ - Jahres-CSV - druckbarer FSQ-Bericht --- ## 3.3 Jahresabrechnung **Seite:** `abrechnung/jahr.html` Fasst sämtliche Abrechnungsmonate eines Jahres zusammen. ### Unterbereiche **Sonderzahlungen** - Urlaubsgeld - Jahresleistung - Erfolgsbeteiligung - weitere Sonderzahlungen **Monate** - Monatswerte des gesamten Jahres **SOLL-Daten für VDN-Abgleich** - aus SETO berechnete Sollwerte ### Export - SOLL-JSON - Daten für externe Prüfung oder VDN-Abgleich --- ## 3.4 VDN-Abgleich **Seite:** `abrechnung/vergleich.html` Vergleicht die SETO-Berechnung mit dem tatsächlichen Verdienstnachweis. ### Funktionen **VDN direkt aus PDF übernehmen** - PDF auswählen - gegebenenfalls PDF-Passwort eingeben - Werte automatisch auslesen **Schichtbezogener Abgleich** - tagegenaue Prüfspur - Vergleich Kalender ↔ VDN - Prüfstatus je Monat **VDN-Gesamtwerte** Erfassung bzw. Auslesen von: - Gesamtbrutto - Steuerbrutto laufend - Steuerbrutto Einmalzahlung - SV-Brutto - Lohnsteuer - Krankenversicherung - Pflegeversicherung - Rentenversicherung - Arbeitslosenversicherung - Nettoentgelt - Auszahlung **Lohnartenvergleich** - SETO-Lohnarten gegen VDN-Lohnarten - Abweichungen erkennen --- ## 3.5 Abrechnungsdetails **Seite:** `abrechnung/details.html` Technisch und fachlich detaillierte Ansicht der Monatsberechnung. ### Bereiche **Entgeltquelle** - Herkunft der Kalender- und Supabase-Daten **Profilwerte / Berechnungsgrundlagen** - Tarifentgelt - Leistungszulage - Erschwernis - Schichtzulage - Steuerdaten **SFN / §3b** - Steuerfreiheit von Sonn-, Feiertags- und Nachtzuschlägen - §3b-Grundlohn - steuerfreie Beträge - SV-Berechnung **Weitere Lohnarten** - zusätzliche manuelle oder automatisch erkannte Lohnarten **Sonstige Bezüge / Abzüge** - weitere Entgeltbestandteile **Ergebnisdetails** - Bewertungssätze - FSQ - Steuer - Sozialversicherung **Systemprüfung** - Selbsttest der Berechnung - technische Diagnose - Diagnose-JSON --- ## 3.6 Lohnartenkatalog **Seite:** `abrechnung/lohnarten.html` Zentraler Katalog aller bekannten und erkannten Lohnarten. ### Funktionen - Suche nach Lohnarten - Filter nach Kategorie - Filter nach Status - Beschreibung bekannter Lohnarten - Kennzeichnung noch ungeklärter Lohnarten Der Katalog dient sowohl der Abrechnung als auch dem VDN-Parser und der Dokumentation. --- ## 3.x ST-Zulage (nur Frank) **Seite:** `abrechnung/st-zulage.html` Privater Prüfanhang für den Benutzer `frank`. Andere Benutzer sehen weder Navigation noch Inhalt; direkter Aufruf wird zur Abrechnung zurückgeführt. Die Seite rekonstruiert ST-Blöcke aus dem Kalender, wendet die bestätigte Regel „mindestens 3 geleistete ST-Schichten in Folge, danach rückwirkend der gesamte Block“ an und berechnet 2201 mit 0101-Monatslohn × 7/10/14 % × anspruchsberechtigte ST / planmäßige Sollschichten. Historische 20-%-VDN bleiben ausdrücklich als Sonder-/Prüffall sichtbar. --- # 4. Modul Analyse & Simulation Das Analysemodul wertet sowohl tatsächliche VDN-Daten als auch von SETO berechnete Abrechnungsdaten über längere Zeiträume aus. --- ## 4.1 Analyse **Seite:** `analyse/index.html` Mehrjahres-Gehaltsanalyse aus VDN-Istwerten und – wo kein VDN vorliegt – optional aus SETO-Berechnungen. ### Kernprinzipien - alle vorhandenen Datenjahre statt eines festen 2025–2028-Fensters - Monatsdurchschnitt statt irreführender Teiljahressumme - direkter Jahresvergleich nur über identische vorhandene Monate - Beschäftigungsgrad und VZ-äquivalente Entwicklung von Tarifentgelt + Leistungszulage - Kaufkraftvergleich abgeschlossener Jahre in 2025-Euro auf Basis des Destatis-VPI - Rückrechnungen separat; keine automatische Vermischung mit der historischen Lohnkurve ### Auswertungen - Gehalts-Cockpit mit Brutto, Netto, Tarif + Leistung, SFN-Anteil und Datenabdeckung - automatische Hinweise zur Veränderung zwischen zwei gewählten Jahren - Jahresentwicklung und detaillierte Jahrestabelle - Kaufkraftentwicklung nominal / real - Like-for-like-Vorjahresvergleich derselben Monate - Lohntreiber-Brücke nach Basis, SFN, Sonderzahlungen und übrigen Effekten - Beschäftigungs-, Entgeltgruppen- und Zeitstufen-Historie - Zusammensetzung des durchschnittlichen Monatsbruttos - monatliche Gehaltsentwicklung - größte Lohnarten-Veränderungen zwischen zwei Jahren - Zulagen-Matrix für Nacht, Sonntag und Feiertag - Lohnartenvergleich und größte Lohnarten - bAV / Pensionskasse und Langzeitkonto - VDN ↔ SETO Soll/Ist-Abgleich - Rückrechnungsübersicht mit Abrechnungs- und Bezugsmonat - Verlinkung zum FSQ/VDN-HR-Abgleich - separater Tarifausblick 2027/2028 --- # 5. Modul Simulation Die Simulation ist bewusst von der normalen Abrechnung getrennt. Änderungen an Simulationswerten verändern die tatsächlichen Abrechnungsdaten nicht. --- ## 5.1 Simulationsabrechnung **Seite:** `analyse/simulation.html` Erstellt alternative Entgelt- und Arbeitszeit-Szenarien. ### Funktionen - Referenzdaten aus dem tatsächlichen Profil übernehmen - Simulationsjahr auswählen - Schichtgruppe verändern - Beschäftigungs- und Entgeltdaten verändern - Abwesenheiten simulieren - Sonderzahlungen simulieren ### Vergleich Es werden jeweils zwei Seiten gegenübergestellt: - **Referenz** - **Simulation** Ausgegeben werden unter anderem: - Monatsabrechnung - Brutto - Netto - Nettoverzicht - Arbeitszeit - Freischichten - Freizeitwirkung --- ## 5.2 Simulation – Jahresvergleich **Seite:** `analyse/simulation-jahr.html` Überträgt ein Simulationsszenario auf das gesamte Jahr. ### Auswertungen - Nettoverzicht im Jahr - Jahressummen Referenz ↔ Simulation - Annahmen des Szenarios - Freizeitwirkung - monatlicher Verlauf - Interpretation des Ergebnisses ### Export - CSV - Druck bzw. PDF --- # 6. Modul Daten-Importer Der **Daten-Importer** bündelt die Übernahme externer Daten nach SETO. Er ist für die Ersteinrichtung genauso vorgesehen wie für spätere Ergänzungen. --- ## 6.1 Daten-Importer Startseite **Seite:** `Daten-Importer/index.html` Zentrale Importseite. Enthält drei Hauptbereiche: - SETO einrichten - VDN hinzufügen - Urlaubsplan importieren --- ## 6.2 Einrichtungsassistent **Seite:** `Daten-Importer/setup.html` Geführte Ersteinrichtung eines SETO-Benutzers. ### Schritt 1 – Datenquelle Auswahl: - Einrichtung mit VDN - manuelle Einrichtung ohne VDN ### Schritt 2 – Speicherung Auswahl: - nur lokal auf diesem Gerät - Speicherung im persönlichen SETO-Profil ### Schritt 3 – Daten Übernahme bzw. Eingabe von: - Tarifgebiet - Entgeltgruppe - Zeitstufe - tariflicher Wochenarbeitszeit - Beschäftigungsgrad - persönlichen Wochenstunden - Schichtgruppe - Gültigkeitszeitraum Optional für die Netto-Berechnung: - Name - Geburtsdatum - Steuerklasse - Kinderfreibetrag - Kirchensteuer - Krankenkasse - KV-Zusatzbeitrag ### Schritt 4 – Prüfen Alle erkannten Werte werden vor dem Speichern angezeigt. Optional können inhaltlich anonymisierte Lerndaten für die Verbesserung des Parsers freigegeben werden. Nach sichtbarer Vorschau und ausdrücklicher Einwilligung speichert SETO diese direkt in Supabase; ein JSON-Download und späteres Hochladen ist nicht erforderlich. Der Inhalt enthält keine Namen, Dateinamen, Datums-/Monatsangaben, Euro-Beträge, exakten Basiswerte oder Datei-Hashes. Bei unbekannten Lohnarten können technische Feldstrukturen, lokal abgeleitete Berechnungsmuster und benachbarte Lohnartcodes/-bezeichnungen ohne Beträge enthalten sein. Der Datenbankeintrag bleibt technisch dem Benutzerkonto zugeordnet, damit RLS, Auskunft und Löschung funktionieren. ### Schritt 5 – Fertig Nach der Einrichtung direkter Wechsel zu: - Abrechnung - Kalender - weiterem VDN-Import --- ## 6.3 VDN-Schnellimport **Seite:** `Daten-Importer/vdn.html` Für bereits eingerichtete Benutzer, die weitere Verdienstnachweise importieren möchten. ### Funktionen - einzelne VDN-PDFs auswählen - mehrere PDFs auswählen - kompletten Ordner auswählen - Drag & Drop - PDF-Passwort verwenden - Rückrechnungen erkennen - Dubletten erkennen - vorhandenen VDN-Bestand prüfen - Bestand sichern - gespeicherte VDN-Daten löschen ### Ergebnis Erkannte Abrechnungen können: - zunächst nur lokal verarbeitet werden - als JSON gespeichert werden - dauerhaft in Supabase übernommen werden ### Parser-Hilfe Unbekannte Lohnarten können anonymisiert gesammelt und nach ausdrücklicher Freigabe an SETO übermittelt werden. --- ## 6.4 Urlaubsplan-Importer **Bereich innerhalb:** `Daten-Importer/index.html` Importiert Urlaubs- und Abwesenheitsdaten aus einer Excel-Tabelle. ### Ablauf 1. Benutzer auswählen 2. Schichtgruppe auswählen 3. Importjahr auswählen 4. kopierte Excel-Zellen einfügen 5. Vorschau erzeugen 6. bestehende Daten und Konflikte prüfen 7. geprüfte Daten übernehmen Die Daten werden erst nach ausdrücklicher Bestätigung in den Kalender geschrieben. --- # 7. Modul Profil **Seite:** `Profil/index.html` Das Profil ist die zentrale Datenbasis eines SETO-Benutzers. Kalender, Abrechnung, Analyse und Importer greifen auf diese Angaben zurück. --- ## 7.1 Übersicht Enthält die wichtigsten Stammdaten: - Benutzername - Anzeigename - Schichtgruppe - Bundesland - Geburtsdatum - Beschäftigungsgrad - Entgeltgruppe - Zeitstufe - Wochenstunden - tarifliche Vollzeit-Wochenzeit - Teilzeitbeginn - Teilzeitende - Einrichtungsstatus --- ## 7.2 Beschäftigung Verwaltet den zeitlichen Beschäftigungsverlauf. Damit können beispielsweise unterschiedliche Zeiträume hinterlegt werden für: - Teilzeit - Vollzeit - Beschäftigungsgradänderungen - Tarifänderungen --- ## 7.3 Jahreswerte & Zeitkonten Jahresbezogene Werte wie: - Zeitkonto am Jahresanfang - Urlaubsübertrag - AFZ-Jahresanfang - FSQ-Jahresanfang - Urlaubsbasis - FSQ-Jahressoll - manueller oder automatisch berechneter Jahresurlaub --- ## 7.4 Abrechnung & Vorsorge Umfangreiche Abrechnungsparameter. ### Steuer & Sozialversicherung - Steuerklasse - Kirchensteuer - Kinder - Kinderfreibetrag - Pflegeversicherung - Krankenversicherung - Zusatzbeitrag - PKV ### Entgelt - Leistungszulage - Erschwernis - Schichtzulage - weitere Profilbeträge ### Sonderzahlungen - Jahresleistung Y908 - Urlaubsgeld 5550 - Erfolgsbeteiligung Y912 ### FSQ - automatischer oder manueller Modus - FSQ-Ankerwerte ### Langzeitkonto - Monatsbeitrag - Anteil - Berechnungsquelle - aktueller Stand - Einmalzahlungen - SFN-Anteile ### bAV / Pensionskasse - Pensionskasse Degussa - RUK - Baustein 1 - Baustein 2 - Baustein 3 - Chemie-Beträge - Förderungen - RentePlus - CareFlex --- ## 7.5 Kalender & Anzeige Benutzerspezifische Kalenderoptionen: - NRW-Schulferien anzeigen - freie Blöcke markieren --- ## 7.6 Daten & Import Direkte Verbindungen zu: - VDN-Importer - Urlaubs-Importer --- ## 7.7 Sicherung & Wiederherstellung ### Backup - vollständige persönliche JSON-Sicherung herunterladen ### Restore - SETO-Backup auswählen - Daten prüfen - vorhandene Benutzerdaten auf Wunsch überschreiben ### Datenauskunft - gespeicherte Daten anzeigen - persönliche Datenauskunft herunterladen ### Kontolöschung - vollständige Löschung des SETO-Kontos beantragen - Löschantrag zurücknehmen --- # 8. Modul Hilfe & Dokumentation **Seite:** `Dokumentationen/index.html` Zentrale fachliche Dokumentation der App. Sie erklärt nicht nur die Bedienung, sondern auch die Berechnungsregeln. ### Kapitel - Übersicht - Erste Schritte - Kalender - Zeitkonto & FS - Abrechnung - Zuschläge - Sonderzahlungen - Langzeitkonto - bAV / Pensionskasse - VDN & Import - Sicherung & Synchronisation - Datenschutz & gespeicherte Daten - Analyse - Lohnarten - noch ungeklärte Regeln - technische Hinweise ### Enthaltene Fachthemen Unter anderem: - 12-Stunden-Schichtmodell - Freischichten - FSQ - Gutstunden - Feiertage - Sonntage - Nachtarbeit - SFN-Zuschläge - Hätte-Zuschläge - Urlaubsgeld - Jahresleistung - Erfolgsbeteiligung - LZK - Altersvorsorge - VDN-Erkennung --- # 9. Datenschutz & Rechtliches Unterhalb des Dokumentationsbereichs existieren separate Seiten. ## Datenschutzerklärung **Seite:** `Dokumentationen/datenschutz.html` Beschreibt: - verarbeitete Daten - Supabase-Nutzung - VDN-Verarbeitung - Konten und Einladungen - KR/AU-Daten - Feedback ## DSGVO-Einwilligung **Seite:** `Dokumentationen/dsgvo-einwilligung.html` Getrennte Einwilligungen für: - allgemeine Datenverarbeitung - Verarbeitung freiwilliger KR/AU-Daten ## Impressum **Seite:** `Dokumentationen/impressum.html` Rechtliche Betreiberinformationen. --- # 10. Registrierung **Seite:** `registrieren.html` Dient zum Erstellen eines neuen SETO-Benutzerkontos. Enthält außerdem Links zu: - Datenschutz - DSGVO-Einwilligung - Impressum --- # 11. Technische bzw. interne Seiten Diese Seiten sind vorhanden, stellen aber keine eigenständigen Hauptmodule für normale Benutzer dar. ### `schichtkalender/index.html` Technische Weiterleitung zum eigentlichen Kalender. ### `schichtkalender/profil.html` Alte bzw. kompatible Weiterleitung auf das inzwischen zentrale Profilmodul. ### `schichtkalender/registrieren.html` Weiterleitung auf die zentrale Registrierung. ### `schichtkalender/admin-ferien.html` Interne Adminseite zur Pflege bzw. zum Import von Feriendaten. --- # Empfohlene Hauptstruktur von SETO Aus Benutzersicht lässt sich SETO damit auf sieben Hauptmodule reduzieren: **1. Kalender** Schichten, Urlaub, FS, Abwesenheiten, Jahresübersicht und Druck. **2. Abrechnung** Monatsabrechnung, Schichtberechnung, Jahresabrechnung und VDN-Abgleich. **3. Analyse & Simulation** Langfristige Auswertung sowie Was-wäre-wenn-Berechnungen. **4. Daten-Importer** VDN, Urlaubsplanung und Ersteinrichtung. **5. Profil** Zentrale Stamm-, Beschäftigungs-, Abrechnungs- und Vorsorgedaten. **6. Hilfe & Dokumentation** Bedienung, Berechnungsregeln und bekannte/offene Fachfragen. **7. Startseite** Zentrales Dashboard und Zugang zu allen Modulen sowie Feedback und Administration.