Zum Inhalt

Anmeldung, Rollen und Module

Betriebe

Eine Instanz von Soll trägt mehrere Betriebe. Ein Betrieb ist eine Organisation in Better Auth; wer ihn anlegt, ist sein Inhaber. Jede Tabelle von Soll trägt die Kennung des Betriebs, und jeder Aufruf der API gilt dem Betrieb, der in der Sitzung gewählt ist. Wer kein Mitglied eines Betriebs ist, kann ihn nicht wählen und sieht keine seiner Daten.

Rollen

Rolle Darf
Inhaber alles: den Betrieb einrichten, Module schalten, einladen, Rollen ändern, PINs setzen, Arbeitszeitmodelle zuordnen, Zeiten aller mit Grund korrigieren
Planer lesen, die Mitgliederliste, Mitarbeiter und Externe einladen, stempeln, Zeiten aller sehen und mit Grund korrigieren
Mitarbeiter die eigenen Daten: stempeln, die eigenen Zeiten sehen und mit Grund korrigieren
Lohnbüro lesen, die Mitgliederliste, die Arbeitszeitmodelle mit ihren Löhnen, stempeln, Zeiten aller sehen
Betriebsrat lesen, die Mitgliederliste (§ 80 Abs. 2 BetrVG), stempeln
Extern die eigenen Daten, ohne Pflicht zur Arbeitszeiterfassung; stempelt nicht, sieht aber die eigenen Zeiten aus der Zeit davor
Gerät nur PINs am Terminal prüfen

Die Löhne in den Arbeitszeitmodellen sehen nur Inhaber und Lohnbüro. Die Rechte prüft der Server bei jedem Aufruf, auch bei den Routen von Better Auth: Die Mitgliederliste mit Namen, E-Mail-Adressen und Rollen sehen nur Inhaber, Planer, Lohnbüro und Betriebsrat; Mitarbeiter, Externe und Geräte sehen ihre eigene Rolle, aber keine anderen Mitglieder. Hat eine Person mehrere Rollen, darf sie, was jede davon darf; andere als diese sieben Rollen nimmt der Server nicht an. Jede Änderung einer Mitgliedschaft oder Rolle steht in der Audit-Kette.

Konto und Anmeldung

Wer einen Betrieb einrichtet, legt ein Konto mit E-Mail-Adresse und einem Passwort von mindestens 10 Zeichen an und wird Inhaber des Betriebs, den er in der Einrichtung anlegt. Angemeldet wird mit E-Mail-Adresse oder Benutzernamen. Gehört ein Konto zu einem Betrieb, wählt die App ihn bei der Anmeldung; ohne Betrieb führt sie in die Einrichtung.

Einladung ohne E-Mail

Der Inhaber (oder für Mitarbeiter und Externe ein Planer) legt eine Einladung mit Name und Rolle an, in der Einrichtung auch für eine ganze Liste auf einmal, und bekommt einen Link, den er weitergibt. Wer ihn öffnet, wählt einen Benutzernamen und ein Passwort (mindestens 10 Zeichen) und meldet sich danach damit an; eine E-Mail-Adresse braucht es nicht. Ein Link gilt sieben Tage und nur einmal. Gespeichert wird nur der Hash des Links, nicht der Link selbst. Passkeys lassen sich danach zum Konto hinzufügen.

PIN

Für das Terminal setzt der Inhaber jeder Person eine PIN aus 4 bis 8 Ziffern; gespeichert wird sie als Hash (Argon2id). Nach fünf falschen Versuchen in Folge ist sie gesperrt, bis der Inhaber eine neue setzt; eine richtige PIN dazwischen setzt den Zähler zurück. Jeder Fehlversuch steht in der Audit-Kette. Wer den Betrieb verlassen hat, wird am Terminal mit seiner PIN nicht mehr erkannt.

Module

Modul Wofür Standard
Arbeitszeit Stempeln, Prüfung, Monatsabschluss, Abwesenheiten an
Dienstplan Schichten planen und veröffentlichen aus
Projektzeit Kunden, Aufträge, Stoppuhr aus
Terminal Tablet am Eingang aus

Der Inhaber schaltet die Module, zuerst über die vier Fragen der Einrichtung, später unter Einstellungen. Die Navigation zeigt nur die Bereiche der eingeschalteten Module. Ein ausgeschaltetes Modul lehnt der Server ab, nicht nur die Oberfläche; seine Daten bleiben erhalten und sind beim Einschalten wieder da. Arbeitszeit lässt sich nicht abschalten, solange der Betrieb Beschäftigte hat, denn dann gilt die Pflicht zur Erfassung (BAG, 13.09.2022, 1 ABR 22/21). Kommt eine beschäftigte Person hinzu, durch Einladung oder Rollenwechsel, schaltet Soll die Arbeitszeit wieder ein.

Start des Servers

Der Server braucht SOLL_SECRET_KEY: 32 zufällige Bytes in Base64, etwa aus openssl rand -base64 32. Ohne gültigen Schlüssel startet er nicht. Mit dem Schlüssel signiert Better Auth seine Sitzungen, später verschlüsselt Soll damit geheime Spalten. SOLL_URL ist die Adresse, unter der die Instanz erreichbar ist; sie steht in den Einladungslinks.