Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/pflichtenheft/blocks/block1.md
T

44 KiB
Raw Blame History

Block 1: Plattform-Fundament

Diese fünf Module bilden die Basis, auf der alle anderen Module aufsetzen: Anmeldung, Mandanten-Trennung, Rollen, Mehrsprachigkeit, Branding, Feature-Schalter und der Plattform-Admin-Bereich für den HiveGrid-Betreiber selbst.


Modul 27: Anmeldung, Mandanten und Rollen

Was es tut: Stellt sicher, dass jede Handwerksfirma ihren eigenen, abgeschotteten Arbeitsbereich (Mandant) hat, dass sich nur berechtigte Personen anmelden können und dass jeder Mitarbeiter genau die Funktionen sieht, die zu seiner Rolle passen. Löst ab: Login-Logik in HubSpot, Quiply, Zapier-Workspaces, Supabase-Eigenbau-Auth. Warum es wichtig ist: Ohne saubere Mandanten-Trennung ist die Plattform DSGVO-untauglich und nicht verkaufbar. Ohne klare Rollen sieht jeder Monteur Vertriebsdaten und jeder Vertriebler die Personalakten.

27.1 Mandanten-Anlage (= eine Handwerksfirma legt einen Workspace an)

27.1.1 Es gibt zwei Wege, einen Mandanten anzulegen: Selbstbedienung (Firma registriert sich selbst auf der Webseite) oder durch HiveGrid manuell (nach einem Verkaufsgespräch). 27.1.2 Bei der Selbstbedienung muss das Anmelde-Formular folgende Angaben verlangen: Email, Passwort, Firmenname, Vor- und Nachname, Branche, Firmengröße (Mitarbeiter-Spanne als Auswahl), Zustimmung zu AGB, Datenschutz und Auftragsverarbeitungsvertrag. 27.1.3 Optionale Angaben sind: Telefonnummer für Support und Umsatzsteuer-Identifikationsnummer für Rechnungen. 27.1.4 Aus dem Firmennamen wird automatisch ein eindeutiger Web-Adressbestandteil (z. B. „geerkens-gmbh") erzeugt. Dieser Adressbestandteil muss vom Nutzer noch im Anmelde-Formular geändert werden können. 27.1.5 Der Adressbestandteil wird live auf Eindeutigkeit geprüft. Bei Konflikt wird ein Vorschlag mit Nummer angeboten. 27.1.6 Nach Anlage ist der Adressbestandteil nicht mehr änderbar (sonst werden Lesezeichen ungültig). Eine spätere Migration ist nur durch HiveGrid-Support möglich. 27.1.7 In Phase 1 ist nur SHK als Branche aktiv wählbar; andere Branchen erscheinen als „Demnächst verfügbar".

27.2 Strikte Mandanten-Trennung (= keine Firma sieht Daten einer anderen)

27.2.1 Das System muss durchgehend verhindern, dass ein Mitarbeiter einer Firma jemals Daten einer anderen Firma sehen, ändern oder löschen kann, auch nicht durch URL-Manipulation, fehlerhafte Suchanfragen oder Fehler in einzelnen Funktionen. 27.2.2 Die Trennung gilt auch für hochgeladene Dateien (Fotos, Dokumente) und für zwischengespeicherte Daten, niemals werden Inhalte zweier Firmen vermischt abgelegt. 27.2.3 Auch automatisch laufende Hintergrund-Prozesse (z. B. nächtliche Auswertungen, Email-Versand) müssen den Mandanten-Bezug explizit setzen, damit keine Vermischung passiert. 27.2.4 Eine Person kann Mitglied in mehreren Mandanten sein (z. B. der Geschäftsführer hat einen Test-Mandant und einen Echt-Mandant). Beim Wechsel zwischen Mandanten gibt es eine sichtbare Umschalt-Funktion, die in der gesamten App erreichbar ist. 27.2.5 Bei der Anmeldung landet der Nutzer im zuletzt genutzten Mandanten. Wer zwei oder mehr Mandanten hat, sieht beim ersten Login eine Auswahl-Seite.

27.3 Anmeldung am System

27.3.1 Standardweg ist Email + Passwort. 27.3.2 Passwörter müssen mindestens 12 Zeichen lang sein. Es werden keine Sonderzeichen-Zwangsregeln verlangt, stattdessen wird das Passwort gegen eine Liste bekannt geleakter Passwörter geprüft. Bei Treffer Klartext-Hinweis: „Dieses Passwort wurde in einem bekannten Datenleck gefunden, bitte ein anderes wählen." 27.3.3 Alternativ kann sich ein Nutzer per „Magischem Anmelde-Link" einloggen: System schickt ihm eine Email mit einem Link, der 15 Minuten gültig ist und einmal genutzt werden kann. 27.3.4 Microsoft-Anmeldung („mit Microsoft anmelden") ist Phase 2. 27.3.5 Bei zu vielen Fehlversuchen (5 in 15 Minuten) wird das Konto für 15 Minuten gesperrt. Ab dem dritten Fehlversuch wird zusätzlich ein Bilderrätsel zur Bot-Abwehr eingeblendet. 27.3.6 Beim Setzen eines neuen Passworts werden alle laufenden Anmeldungen auf allen Geräten beendet.

27.4 Zwei-Faktor-Authentifizierung (= zweiter Sicherheitsfaktor)

27.4.1 Als zweiter Faktor wird ausschließlich eine Authenticator-App (Google Authenticator, Authy, 1Password etc.) unterstützt. Keine SMS, SMS gilt als unsicher. 27.4.2 Bei der Einrichtung werden 10 einmalig nutzbare Notfall-Codes erzeugt, die der Nutzer ausdrucken oder im Passwort-Manager speichern soll. 27.4.3 Für Mandanten-Administratoren ist der zweite Faktor verpflichtend; für andere Mitarbeiter ist er optional. Der Mandanten-Administrator kann jedoch im Mandanten einstellen: „Zweiter Faktor für alle Mitarbeiter Pflicht", Mitarbeiter ohne werden bei der nächsten Anmeldung dazu gezwungen. 27.4.4 Es gibt eine Funktion „Auf diesem Gerät 30 Tage merken", damit der zweite Faktor nicht jedes Mal abgefragt wird. Vertrauenswürdige Geräte sind in den persönlichen Einstellungen einzeln widerrufbar. 27.4.5 Verliert ein Mitarbeiter seine Notfall-Codes, kann der Mandanten-Administrator den zweiten Faktor zurücksetzen (mit Eintrag im Protokoll). Verliert ein Mandanten-Administrator als einziger seine Zugänge, kann der HiveGrid-Support helfen.

27.5 Sitzungs-Verwaltung (= aktive Anmeldungen)

27.5.1 Eine Anmeldung bleibt standardmäßig 30 Tage aktiv (gleitendes Fenster); der Mandanten-Administrator kann diese Dauer für seinen Mandanten kürzer einstellen. 27.5.2 Nach 4 Stunden Inaktivität muss erneut bestätigt werden (sanfter Refresh, ggf. zweiter Faktor). 27.5.3 Jeder Nutzer sieht in seinen Sicherheits-Einstellungen alle aktiven Anmeldungen mit Gerät, Browser, ungefährem Standort und letzter Aktivität, mit der Möglichkeit, einzelne oder alle Anmeldungen zu beenden. 27.5.4 Bei einer Passwort-Änderung, einer Email-Änderung, einer 2FA-Änderung oder einer Deaktivierung des Nutzers werden alle aktiven Anmeldungen automatisch beendet.

27.6 Wer darf was: Rollen und Berechtigungen

27.6.1 Jeder Mitarbeiter hat eine oder mehrere Rollen. Die Rolle bestimmt, welche Funktionen er in der App sieht und nutzen darf. 27.6.2 Berechtigungen werden in Stufen pro Funktionsbereich vergeben (z. B. „im Bereich CRM: kein Zugriff / nur eigene sehen / alle sehen / eigene anlegen und bearbeiten / alles dürfen inkl. Einstellungen"). Eine erweiterte Ansicht erlaubt feinere Einstellungen pro Einzel-Berechtigung. 27.6.3 Beim Anlegen eines neuen SHK-Mandanten werden 7 Standard-Rollen automatisch eingerichtet: Geschäftsführer, Vertriebsleiter, Vertriebler, Projektleiter / Bauleiter, Büro / Backoffice, Marketing, Monteur. 27.6.4 Diese 7 Rollen sind nur Vorlagen, der Mandanten-Administrator kann sie umbenennen, ändern, löschen oder neue eigene Rollen anlegen. 27.6.5 Eine Person kann mehrere Rollen gleichzeitig haben; die Rechte addieren sich. 27.6.6 Pro Rolle ist hinterlegt, ob sie standardmäßig die „Büro-Oberfläche" (Desktop-orientiert) oder die „Baustellen-Oberfläche" (mobil-vereinfacht) sieht. Der einzelne Mitarbeiter kann das auf seinem Gerät überschreiben. 27.6.7 Der Mandanten-Administrator kann sich nicht selbst die Administrator-Rechte entziehen, wenn er der Einzige mit dieser Rolle ist.

27.7 Standard-Rollen-Übersicht (Phase 1, SHK) [N1, 09.05.2026]

Rolle Was diese Person darf
Geschäftsführer Alles, ist Mandanten-Administrator
Vertriebsleiter Volle Kontrolle über Vertrieb, Marketing-Emails, Lead-Eingang. Liest alle Projekte mit.
Vertriebler Sieht alle Kontakte und Vertriebsfälle, bearbeitet seine eigenen.
Projektleiter / Bauleiter Volle Kontrolle über die Projekte, die er führt; Aufgaben verteilen, Dateien sehen, HR-Anträge seiner Monteure freigeben.
Büro / Backoffice Liest alles im Vertrieb mit, bearbeitet Projekte, verwaltet Personal-Hub und Termin-Buchung.
Buchhaltung Sieht alle abrechnungs-relevanten Daten (Aufträge, Rechnungs-Status aus KWP, Subscription), exportiert Listen für Steuerberater, hat keinen Vertriebs- oder Projekt-Edit.
Personal Voller Zugriff auf das HR-Hub (Mitarbeiter-Stammdaten, Verträge, Lohn-Dokumente, Urlaubsanträge, Krankmeldungen), sieht keine Vertriebs- oder Projekt-Daten.
Lagerist Sieht Material-Listen aus Projekten, dokumentiert Material-Ausgang, sieht zugeordnete Lieferungen. Kein Vertrieb, kein HR, kein Projekt-Edit.
Marketing Sieht Kontakte und Segmente, erstellt Email-Kampagnen, Formulare und Booking-Seiten. Kein HR oder Projekt-Edit.
Monteur Sieht nur seine aktiven Projekte und Aufgaben, dokumentiert Fotos, kommuniziert in Projekt-Chats, sieht seine eigenen HR-Daten. Kein Vertrieb, kein Marketing.

27.7.1 Diese 10 Rollen sind die SHK-Standard-Vorlage. Der Mandanten-Administrator kann sie umbenennen, anpassen, löschen oder eigene Rollen anlegen (siehe 27.6.4).

27.8 Gruppen (= organisatorische Einteilung ohne Berechtigungs-Wirkung)

27.8.1 Zusätzlich zu Rollen kann der Mandanten-Administrator Gruppen anlegen (z. B. „Team Süd", „Außendienst", „Festangestellte"). 27.8.2 Gruppen vergeben in Phase 1 keine Rechte. Sie werden für Filter, Massen-Zuweisungen, Benachrichtigungen und Automatisierungs-Bedingungen genutzt. 27.8.3 Eine Person kann in mehreren Gruppen sein. Beim Löschen einer Gruppe mit Mitgliedern erscheint ein Hinweis.

27.9 Mitarbeiter einladen, deaktivieren, entfernen

27.9.1 Der Mandanten-Administrator lädt neue Mitarbeiter per Email ein. Er wählt Email, Rolle (Pflicht) und optional Gruppen, Name und persönliche Nachricht. 27.9.2 Der Eingeladene erhält eine Email mit einem Einladungs-Link, der 7 Tage gültig ist. 27.9.3 Wenn die Email noch nicht im System bekannt ist, legt der Eingeladene ein neues Konto an. Wenn er schon einen Account hat (z. B. von einem anderen Mandanten), wird er beim Klick automatisch Mitglied dieses Mandanten. 27.9.4 Ein Mitarbeiter kann vorübergehend deaktiviert werden (kommt nicht mehr rein, kann aber jederzeit wieder aktiviert werden) oder dauerhaft entfernt werden (Beziehung gelöscht, Wieder-Aufnahme nur per neuer Einladung). 27.9.5 Vor jeder Deaktivierung oder Entfernung muss das System prüfen, ob dem Mitarbeiter noch Aufgaben, Vertriebsfälle, Projekte oder Termine zugeordnet sind. Es muss eine Massen-Umverteilungs-Funktion und eine Einzel-Umverteilungs-Funktion geben. Daten ohne neue Zuweisung zu lassen ist nur mit ausdrücklicher Bestätigung möglich. 27.9.6 Der letzte Mandanten-Administrator kann nicht entfernt werden. Sich selbst entfernen ist nicht möglich.

27.10 Konto-Löschung (Datenschutz- und Apple-Pflicht) [N2, 09.05.2026]

27.10.1 Jeder Nutzer kann sein Konto in den persönlichen Einstellungen löschen. 27.10.2 Der Lösch-Vorgang ist mehrstufig: Erklärungs-Schritt (was wird gelöscht, was bleibt anonymisiert, was bleibt aus rechtlichen Gründen), Identitäts-Bestätigung (Passwort + zweiter Faktor), Sonderfall-Prüfung (ist der Nutzer einziger Mandanten-Administrator?, dann blockieren mit Hinweis) und finaler Bestätigungs-Klick mit 3-Sekunden-Zwangs-Wartezeit. 27.10.3 Nach Löschung werden persönliche Daten (Name, Email, Avatar) entfernt; Verknüpfungen in alten Aufträgen bleiben mit dem Hinweis „ehemaliger Mitarbeiter". 27.10.4 Innerhalb von 24 Stunden nach Lösch-Bestätigung kann der HiveGrid-Support die Löschung rückgängig machen, falls jemand das Konto nicht freiwillig gelöscht hat. 27.10.5 Wenn ein Nutzer sein Konto löscht, bekommt der Mandanten-Administrator eine Benachrichtigung (Push, Email, In-App) mit Name, Datum, Zeitpunkt und Hinweis auf bereits umverteilte oder noch offene Daten. So bleibt der Mandant immer informiert. 27.10.6 Der Mandanten-Administrator kann jeden Nutzer seines Mandanten auch selbst löschen, ohne dass dieser einwilligen muss. Der Vorgang läuft über dieselben Stufen (Erklärung, Daten-Umverteilung, Bestätigung) und wird im Audit-Log mit „durch Admin gelöscht" vermerkt. Der gelöschte Nutzer erhält eine Email-Mitteilung über die Löschung.

27.11 Mandanten-Lebenszyklus (= was passiert mit dem Mandanten über die Zeit)

27.11.1 Mögliche Zustände eines Mandanten: Test-Phase, Bezahlend, Zahlung gescheitert, Pausiert, Vom Betreiber gesperrt, Kündigung läuft, Gelöscht. 27.11.2 Bei gescheiterter Zahlung wird der Mandant zunächst nur lesend (kein Schreiben, kein Email-Versand, keine Automatisierung) und nach 30 Tagen ohne Zahlung in den Kündigungs-Lauf gestellt. 27.11.3 Der Mandanten-Administrator kann seinen Mandanten freiwillig pausieren (reduzierte Gebühr, Workspace nur lesend, jederzeit reaktivierbar), z. B. saisonale Betriebsruhe. 27.11.4 Bei Kündigung gibt es eine 30-Tage-Karenzphase, in der die Kündigung zurückgezogen werden kann. Nach 30 Tagen erfolgt die endgültige Löschung. 27.11.5 Pro Zustand muss ein Klartext-Banner im Mandanten sichtbar sein, das den Status erklärt und die nächste Handlung anbietet.

27.12 Schnittstellen-Schlüssel (= API-Keys für externe Verbindungen)

27.12.1 Im Mandanten können Schnittstellen-Schlüssel erstellt werden, mit denen externe Systeme (z. B. Make, n8n, Zapier-Reste, eigene Tools) Daten an HiveGrid liefern oder abfragen. 27.12.2 Pro Schlüssel werden Name, erlaubter Umfang (nur lesen / nur eingehende Webhooks / volles Lesen / Automatisierungen auslösen), Erstellungs-Datum, letzte Nutzung und Status angezeigt. 27.12.3 Ein Schlüssel ist nach Erstellung nur einmal sichtbar (Sicherheits-Standard). Der Nutzer wird in Klartext gewarnt, ihn zu kopieren. 27.12.4 Schlüssel laufen nach 365 Tagen ab (Zwangs-Rotation). Sie gehören dem Mandanten, nicht dem einzelnen Nutzer (überdauern Mitarbeiter-Wechsel). 27.12.5 Standardmäßig sind 1.000 Anfragen pro Stunde erlaubt. Der Mandanten-Administrator kann das erhöhen. 27.12.6 Pro Schlüssel werden die letzten 100 Anfragen mit Endpunkt, Status und Zeit angezeigt, zur Fehlersuche.

27.13 Funktions-Freischaltung pro Tarif (= Feature-Gates)

27.13.1 Jeder Mandant hat ein Abo (siehe Modul 28), das bestimmt, welche Module verfügbar sind. 27.13.2 Wenn ein Nutzer auf eine Funktion klickt, die im aktuellen Tarif nicht enthalten ist, erscheint ein Klartext-Hinweis: „Die Funktion ‚X‘ ist im Tarif ‚Y‘ verfügbar. Mehr erfahren auf hivegrid.de/pricing." Der Link führt aus der App heraus auf die Marketing-Seite (Apple-Vorgabe). 27.13.3 Konkrete Tarife und Preise werden in Modul 28 definiert. Modul 27 stellt nur die technische Möglichkeit, Funktionen pro Mandant zu sperren oder freizugeben.

27.14 Bewusst NICHT in Phase 1

27.14.1 Microsoft-Anmeldung („Login mit Microsoft"), verschoben auf Phase 2. 27.14.2 Eigene Domain pro Mandant (z. B. „crm.geerkens.de"), nur für Enterprise-Tarif in Phase 2. 27.14.3 Massen-Einladung per CSV-Datei, Phase 2. 27.14.4 Hardware-Sicherheits-Schlüssel (FIDO2/WebAuthn) als zweiter Faktor, Phase 2. 27.14.5 Mandanten-Eigenservice-Schalter für Beta-Funktionen (siehe Modul 32), Phase 2.

27.15 Klartext-Fehlertexte (Beispiele)

27.15.1 Falsches Passwort: „Email oder Passwort stimmt nicht. Noch X Versuche, dann wird das Konto kurz gesperrt." 27.15.2 Konto gesperrt: „Konto temporär gesperrt, Support kontaktieren." 27.15.3 Magic-Link abgelaufen: „Dieser Anmelde-Link ist abgelaufen oder wurde bereits genutzt. Bitte einen neuen anfordern." 27.15.4 2FA-Code falsch: „Code stimmt nicht. Achte darauf, dass die Uhr deines Geräts genau geht." 27.15.5 Berechtigung fehlt: „Diese Aktion ist mit deiner Rolle nicht möglich. Bitte deinen Mandanten-Administrator ansprechen." 27.15.6 Kontingent-Konflikt beim Löschen: „Diese Person hat noch 12 offene Aufgaben und 3 laufende Projekte. Bitte vorher umverteilen." 27.15.7 Konto-Löschung blockiert: „Du bist einziger Administrator in 1 Mandant. Bitte vorher einen anderen Administrator bestimmen."


Modul 30: Mehrsprachigkeit

Was es tut: Sorgt dafür, dass die gesamte Plattform sprachlich austauschbar ist, Phase 1 läuft alles auf Deutsch, in Phase 2 sollen weitere Sprachen ohne Neu-Programmierung dazukommen können. Löst ab: Manuelle Übersetzungs-Bastelei in alten Tools. Warum es wichtig ist: Geerkens hat polnische Monteure und türkische Kunden. Mehrsprachigkeit ist ein Verkaufsargument, das bei Konkurrenz-Tools oft fehlt. Wenn man es von Anfang an sauber baut, kostet eine neue Sprache später fast nichts.

30.1 Grundprinzip

30.1.1 Es darf an keiner Stelle der App Text geben, der direkt im Programmcode festgeschrieben ist. Jeder sichtbare Satz, jeder Knopf-Text, jede Fehlermeldung wird aus zentralen Sprach-Dateien geladen. 30.1.2 Ganze Sätze werden als Ganzes übersetzt, nicht aus Bruchstücken zusammengebaut. Sonst lassen sie sich in anderen Sprachen nicht sinnvoll formulieren (z. B. ist die Wortstellung im Polnischen anders). 30.1.3 Mehrzahl-Formen (1 Aufgabe / 5 Aufgaben) werden über ein Standard-Format gelöst, das auch Sprachen mit komplexeren Mehrzahl-Regeln unterstützt (Polnisch hat drei Mehrzahl-Formen). 30.1.4 Datums-, Uhrzeit- und Zahlen-Formate folgen automatisch der Sprache des Nutzers; Standard ist deutsche Schreibweise. 30.1.5 Eine Bau-Prüfung verhindert, dass versehentlich harte Texte in den Code rutschen, der Build schlägt fehl, wenn ein nicht erlaubter harter Text gefunden wird. 30.1.6 In Phase 1 wird ausschließlich Deutsch gepflegt; Englisch, Türkisch, Polnisch sind als Ziel-Sprachen vorgesehen, aber noch nicht befüllt.

30.2 Sprache des Nutzers und des Mandanten

30.2.1 Jeder Nutzer hat eine persönliche Sprach-Einstellung in seinem Profil. 30.2.2 Jeder Mandant hat eine Standard-Sprache (z. B. Deutsch), die der Mandanten-Administrator setzt. 30.2.3 Jeder Kontakt im CRM hat eine Sprach-Angabe, diese wird für ausgehende Emails an den Kontakt verwendet. 30.2.4 Welche Sprache wirklich angezeigt wird, entscheidet sich in dieser Reihenfolge: persönliche Einstellung des angemeldeten Nutzers, sonst Mandanten-Standard, sonst Browser-Sprache (für nicht angemeldete Besucher), sonst Deutsch. 30.2.5 Bei ausgehenden Mitteilungen entscheidet die Sprache des Empfängers: Mitarbeiter-Sprache, sonst Kontakt-Sprache, sonst Mandanten-Standard, sonst Deutsch.

30.3 Was ist Plattform-Text und was ist Mandanten-Text

30.3.1 Plattform-Texte (Knöpfe, Menü-Punkte, Hinweise, Email-Vorlagen von HiveGrid) werden vom System übersetzt. 30.3.2 Mandanten-Inhalte (eigene Pipeline-Stufen-Namen, Kennzeichnungen, Zusatzfeld-Beschriftungen, Formular-Texte, Marketing-Email-Inhalte) gibt der Mandant in seiner Arbeitssprache ein und werden auch genau so angezeigt, eine automatische Übersetzung der Mandanten-Inhalte ist nicht Phase 1. 30.3.3 Der Mandant kann seine Mandanten-Inhalte in Phase 1 also nur in einer Sprache pflegen. Zwei-Sprach-Pipelines, Zwei-Sprach-Formulare etc. sind Phase 2.

30.4 Sprachwechsel

30.4.1 Der Nutzer kann seine Sprache jederzeit in seinen Einstellungen wechseln; die Änderung wirkt sofort ohne Neuladen. 30.4.2 Auf öffentlichen Seiten (Hilfe-Center, Buchungsseiten, Formulare für Endkunden) gibt es einen Sprach-Wähler, dessen Auswahl in einem Cookie gemerkt wird.

30.5 Bewusst NICHT in Phase 1

30.5.1 Aktive Übersetzung weiterer Sprachen (Englisch, Türkisch, Polnisch), kommt in Phase 2 über DeepL-Pipeline mit Glossar für Fach-Begriffe. 30.5.2 Automatische Chat-Übersetzung („polnischer Monteur schreibt Polnisch, Büro liest Deutsch"), Phase 2, ist aber bereits eingeplant als KI-Killer-Funktion. 30.5.3 Mehrsprachige Mandanten-Inhalte (Pipeline-Stufen in zwei Sprachen, Formular-Felder mehrsprachig), Phase 2. 30.5.4 Mehrsprachiges Hilfe-Center, Phase 2.

30.6 Klartext-Hinweise

30.6.1 Wenn ein Nutzer eine Sprache wählt, die noch nicht vollständig befüllt ist, wird automatisch auf Deutsch zurückgefallen. Im Mandanten-Admin gibt es dazu den Hinweis: „Die Sprache [X] ist noch nicht vollständig verfügbar. Bestehende Texte fallen auf Deutsch zurück." 30.6.2 Sprache erfolgreich gewechselt: „Sprache geändert."


Modul 31: Branding und Design (Hell/Dunkel-Modus)

Was es tut: Stellt sicher, dass jeder Nutzer wählen kann, ob er die App im hellen oder dunklen Design sehen will, und schafft die technische Grundlage dafür, dass in Phase 2 Mandanten ihr eigenes Logo, ihre eigenen Farben und (bei Enterprise) ihre eigene Domain bekommen können. Warum es wichtig ist: Ein dunkles Design ist heute Standard-Erwartung. Eigenes Branding ist ein Verkaufsargument für Enterprise-Kunden und stärkt die Marken-Wahrnehmung beim Endkunden im Kunden-Portal.

31.1 Hell/Dunkel-Modus pro Nutzer (Phase 1)

31.1.1 Jeder Nutzer kann in seinen Einstellungen zwischen drei Optionen wählen: „System" (folgt der Einstellung des Geräts), „Hell", „Dunkel". 31.1.2 Standard für neue Nutzer ist „System". 31.1.3 Die Auswahl wirkt sofort, ohne Neuladen der Seite. 31.1.4 Wenn der Nutzer „System" gewählt hat und die Geräte-Einstellung wechselt während die App offen ist (z. B. der Mac wechselt abends automatisch in den Dunkel-Modus), soll die App live mit umschalten. 31.1.5 Beim ersten Laden darf kurzzeitig nicht das falsche Design erscheinen (kein „Aufblitzen" der weißen Seite, wenn der Nutzer Dunkel-Modus eingestellt hat). Die Vorauswahl wird per Cookie gemerkt. 31.1.6 In der mobilen App (Capacitor) müssen auch Status-Leiste und Splash-Screen das gewählte Design respektieren.

31.2 Phase 1 enthält bewusst NICHT

31.2.1 Logo-Upload pro Mandant, Phase 2. 31.2.2 Eigene Farben pro Mandant (Primärfarbe, Akzentfarben), Phase 2. 31.2.3 Mandanten-Name-Überschreibung in der Anzeige (eigener Anzeige-Name statt „HiveGrid"), Phase 2. 31.2.4 Tenant-Verwaltungsseite für Branding (/admin/branding/), Phase 2.

31.3 Phase-2-Vorhaben (Standard-Branding für alle Tarife)

31.3.1 Mandanten-Administrator kann Logo hochladen (PNG oder SVG, maximale Größe definiert). 31.3.2 Farb-Picker für Primärfarbe und 1-2 Akzentfarben mit Live-Vorschau. 31.3.3 Mandanten-Anzeige-Name kann den System-Standard überschreiben. 31.3.4 Branding wird angewendet auf: Seiten-Logo, Email-Kopfzeilen an Endkunden, Kunden-Portal, Anmelde-Seite des Mandanten, mobile App-Splash-Screen. 31.3.5 Marketing-Emails (Modul 10) übernehmen das Branding standardmäßig, jeweils einzeln überschreibbar. 31.3.6 Vor dem Live-Schalten kann der Mandanten-Administrator eine Vorschau sehen. 31.3.7 Reset-Funktion auf Standard.

31.4 Phase-2-Vorhaben (Vollständiges White-Label, nur Enterprise-Tarif)

31.4.1 Eigene Domain (z. B. „crm.geerkens.de") statt der HiveGrid-Standard-Adresse. 31.4.2 Eigene Schriftarten (Webfonts oder Google-Fonts). 31.4.3 Vollständig anpassbares Farb-Schema (alle Farb-Variablen, nicht nur Primär- und Akzentfarbe). 31.4.4 Eigene Email-Vorlagen (HTML, vom Mandanten gestaltet). 31.4.5 HiveGrid-Branding (Footer, „Powered by"-Hinweise) komplett entfernbar. 31.4.6 Domain-Verifizierung und automatische Zertifikats-Verwaltung im Hintergrund.

31.5 Berechtigungen

31.5.1 Hell/Dunkel-Modus ist persönliche Einstellung, keine Berechtigung nötig. 31.5.2 Phase 2: Mandanten-Branding nur für Mandanten-Administrator (gesonderte Berechtigung „Branding verwalten"). 31.5.3 Phase 2: White-Label-Funktionen sind nur im Enterprise-Tarif aktiv (über Tarif-Freischaltung, Modul 28).


Modul 32: Funktions-Schalter (Feature-Flags)

Was es tut: Gibt HiveGrid (= dem Software-Betreiber) ein internes Werkzeug, um neue Funktionen für einzelne Mandanten oder Mandanten-Gruppen gezielt ein- oder auszuschalten, zum Testen, schrittweisen Ausrollen oder Abschalten alter Funktionen. Warum es wichtig ist: Verhindert, dass eine fehlerhafte neue Funktion sofort allen Kunden Probleme macht. Erlaubt Pilot-Tests bei einzelnen Kunden (z. B. Geerkens als Erstkunde sieht eine Beta zuerst). Ist die technische Voraussetzung für „Feature wird im Hintergrund gebaut, aber niemand sieht es bis es fertig ist".

32.1 Was ist ein Funktions-Schalter

32.1.1 Ein Funktions-Schalter ist ein zentraler An/Aus-Schalter im Code, der zur Laufzeit entscheidet, ob ein bestimmtes Stück Software für einen bestimmten Mandanten sichtbar/aktiv ist. 32.1.2 Mandanten sehen in Phase 1 keine eigene Bedien-Oberfläche für Schalter, sie merken nur, dass Funktionen sichtbar sind oder nicht. Die Schalter werden ausschließlich von HiveGrid im internen Plattform-Admin verwaltet.

32.2 Pflicht-Angaben pro Schalter

32.2.1 Pro Schalter wird gespeichert: technischer Name (eindeutig), Klartext-Bezeichnung, Beschreibung (was tut der Schalter, welcher Code-Bereich, welches Modul), Standard-Wert (an oder aus, falls keine Sonderregel greift), Lebenszyklus-Stufe, Verantwortlicher Plattform-Admin, Modul-Tag. 32.2.2 Lebenszyklus-Stufen: „Beta" (für einzelne Test-Mandanten), „Roll-out" (breit ausgerollt, in Beobachtung), „Allgemein verfügbar" (immer an, Code-Aufräumung steht an), „Abgekündigt" (wird entfernt).

32.3 Drei Wege, einen Schalter zu setzen

32.3.1 Standard-Wert: gilt für alle Mandanten, solange keine speziellere Regel greift. 32.3.2 Filter-Regel: trifft Mandanten nach Eigenschaften, z. B. „alle Mandanten mit über 50 Mitarbeitern", „alle SHK-Mandanten", „Mandanten erstellt nach 1. März 2026", „diese 5 Test-Mandanten namentlich". 32.3.3 Direkte Mandanten-Ausnahme: für einen einzelnen Mandanten den Schalter auf An oder Aus setzen, überstimmt Filter und Standard-Wert. Optional mit Notiz („Manuell aktiviert für Geerkens-Pilot") und optionalem Ablauf-Datum.

32.4 Auswertungs-Reihenfolge (was gewinnt)

32.4.1 Existiert eine direkte Ausnahme für einen Mandanten, gewinnt diese. 32.4.2 Sonst werden alle aktiven Filter geprüft (sortiert nach Priorität); der erste passende Filter setzt den Wert. 32.4.3 Sonst gilt der Standard-Wert des Schalters.

32.5 Verwaltungs-Oberfläche (nur HiveGrid-intern)

32.5.1 Liste aller Schalter mit technischem Namen, Klartext-Bezeichnung, Lebenszyklus-Stufe, Standard-Wert, Anzahl aktiver Filter, Anzahl Einzel-Ausnahmen, Verantwortlichem, Modul-Tag, letzter Änderung. 32.5.2 Filter-Funktionen nach Lebenszyklus-Stufe, Modul-Tag, Verantwortlichem; Suche über Name und Bezeichnung. 32.5.3 Detail-Ansicht eines Schalters mit allen oben genannten Stamm-Daten plus: Liste der Filter, Liste der Einzel-Ausnahmen, Wirkungs-Statistik („X Mandanten haben den Schalter aktuell aktiv, Y nicht"), Änderungs-Historie. 32.5.4 Filter-Editor mit Live-Vorschau: „Mit dieser Bedingung wären aktuell 12 Mandanten betroffen, Liste anzeigen?" 32.5.5 Ausnahme-Editor mit Mandanten-Suche und optionalem Ablaufdatum. 32.5.6 Massen-Funktion: 12 Mandanten gleichzeitig auf denselben Wert setzen. 32.5.7 Lebenszyklus-Stufen wechselbar mit Bestätigungs-Dialog und Klartext-Hinweis auf Folgen. 32.5.8 Archiv-Funktion für Schalter, die nicht mehr genutzt werden, aber deren Spur bleibt.

32.6 Wer darf was im Plattform-Admin

Bündel Erlaubt
Keine Berechtigung (sieht den Bereich nicht)
Betrachter Schalter und Details lesen
Bediener Schalter anlegen/ändern, Filter und Einzel-Ausnahmen verwalten
Verantwortlicher Alles vom Bediener plus Lebenszyklus wechseln und archivieren

32.7 Protokoll (Nachvollziehbarkeit)

32.7.1 Jede Änderung an einem Schalter, an einem Filter, an einer Einzel-Ausnahme wird mit Vorher/Nachher-Vergleich, Akteur, Zeitstempel und optionalem Begründungs-Text gespeichert. 32.7.2 Die Historie ist im Detail des Schalters einsehbar und im plattformweiten Audit-Bereich durchsuchbar.

32.8 Bewusst NICHT in Phase 1

32.8.1 Schalter pro einzelnem Nutzer (statt nur pro Mandant), Phase 2. 32.8.2 Selbstbedienung für Mandanten („Beta-Funktionen anzeigen"-Schalter im Mandanten), Phase 2. 32.8.3 Schalter mit mehr als zwei Werten (für A/B/C-Tests), Phase 2. 32.8.4 Prozentualer Roll-out („aktiviere für 25 % der Mandanten"), Phase 2. 32.8.5 Zeitgesteuerte Aktivierung („ab 1. Juni 2026 automatisch an"), Phase 2. 32.8.6 Nutzungs-Telemetrie pro Schalter, Phase 2.

32.9 Klartext-Hinweise

32.9.1 Schalter im Code referenziert, aber nicht angelegt: „Funktions-Schalter ‚X‘ ist nicht definiert, bitte im Admin-UI anlegen oder Code-Referenz korrigieren." (im Test-System sichtbarer Fehler, in der Live-Umgebung nur Protokoll-Eintrag). 32.9.2 Filter ohne Bedingung: „Dieser Filter würde alle Mandanten treffen, sicher gewollt?" 32.9.3 Filter wirkungslos durch höhere Priorität: „Dieser Filter ist wirkungslos, weil Filter ‚X‘ mit höherer Priorität dieselbe Mandanten-Menge erreicht." 32.9.4 Ausnahme mit Ablauf-Datum in der Vergangenheit: „Ablauf-Datum liegt in der Vergangenheit, die Ausnahme wird beim nächsten Aufräum-Lauf entfernt."


Modul 37: Plattform-Admin (= unser eigener Bedien-Bereich für HiveGrid)

Was es tut: Eigene, völlig getrennte Verwaltungs-Welt für uns als Software-Betreiber, auf einer eigenen Web-Adresse, mit eigenen Konten, eigenem Login, eigenen Berechtigungen. Hier verwalten wir Mandanten, Abos, Funktions-Schalter, Sicherheits-Protokolle, unsere eigenen Verkaufs-Kontakte und Support-Anfragen. Löst ab: Diverse Eigenbau-Werkzeuge, Notion-Tabellen, Spreadsheet-Listen für interne Verwaltung. Warum es wichtig ist: Ohne diesen Bereich kann HiveGrid die Plattform nicht professionell betreiben. Strikte Trennung zur Mandanten-Welt ist Sicherheits- und Datenschutz-Pflicht: Was wir als Betreiber tun, läuft nie über die Mandanten-Seite, damit der Schaden bei einem Sicherheits-Vorfall begrenzt bleibt und unsere Aktionen separat dokumentiert sind.

37.1 Strikte Trennung zur Mandanten-Welt

37.1.1 Der Plattform-Admin läuft auf einer eigenen Web-Adresse („admin.hivegrid.de"), die nicht mit der Mandanten-App („app.hivegrid.de") vermischt wird. 37.1.2 Plattform-Admin-Konten sind eigenständig, sie sind keine normalen Mitarbeiter eines Mandanten. Es gibt keinen Wechsel-Pfad zwischen den Welten ohne erneute Anmeldung. 37.1.3 Sitzungen (Cookies) der Plattform-Admin-Welt sind technisch von denen der Mandanten-Welt getrennt. 37.1.4 Wenn ein Plattform-Admin Mandanten-Daten ansieht, geschieht das durchgehend über dieselben Schutz-Mechanismen wie ein Mandanten-Mitarbeiter, kein Generalschlüssel, kein Umgehen der Mandanten-Trennung. 37.1.5 Schreibende Aktionen auf Mandanten-Daten sind streng begrenzt auf bestimmte vorgesehene Vorgänge (Status ändern, Test-Phase verlängern, Notiz anlegen, Lösch-Workflow im Auftrag anstoßen). Freies Bearbeiten der Mandanten-Daten ist nicht möglich.

37.2 Anmeldung am Plattform-Admin

37.2.1 Anmeldung ist ausschließlich per Email + Passwort. Keine Magic-Links (zu hohes Risiko bei Email-Account-Übernahme). 37.2.2 Zweiter Faktor (Authenticator-App) ist Pflicht für jeden Plattform-Admin, kein Opt-Out. 37.2.3 Bei 5 Fehlversuchen in 15 Minuten: 15 Minuten Sperre. Bilderrätsel ab 3. Fehlversuch. 37.2.4 Bei 10 Fehlversuchen in 24 Stunden: Konto wird gesperrt; nur ein anderer Super-Admin kann es entsperren. 37.2.5 Anmeldungs-Sitzungen laufen nach 8 Stunden ab (kürzer als bei Mandanten-Mitarbeitern). Inaktivitäts-Timeout: 1 Stunde. 37.2.6 Bei Wechsel der IP-Adresse mitten in der Sitzung wird Neu-Anmeldung verlangt. 37.2.7 „Auf diesem Gerät 30 Tage merken" steht hier nicht zur Verfügung, jede Anmeldung verlangt zweiten Faktor. 37.2.8 Der erste Plattform-Admin wird einmalig per Skript angelegt (kein öffentliches Anmelde-Formular).

37.3 Rollen im Plattform-Admin

37.3.1 Es gibt eigene Rollen, die unabhängig von den Mandanten-Rollen sind. 37.3.2 Standard-Rollen beim Anlegen: Super-Admin (alles), Support (lesender Zugriff plus Ticket-Bearbeitung), Vertrieb (Lead- und Verkaufs-Pipeline-Verwaltung), Engineering (Metriken, Funktions-Schalter, System-Aktionen), Betrachter (nur Lesen). 37.3.3 Rollen sind beliebig anpassbar. 37.3.4 Der letzte Super-Admin kann sich nicht selbst die Rechte entziehen oder sich selbst deaktivieren.

37.4 Bereiche im Plattform-Admin (Übersicht)

37.4.1 Dashboard mit Plattform-Kennzahlen. 37.4.2 Mandanten-Verwaltung. 37.4.3 Mandanten-Mitarbeiter-Verwaltung (alle Mitarbeiter aller Mandanten). 37.4.4 Plattform-Admin-Verwaltung (unsere eigenen Konten und Rollen). 37.4.5 Abo-Verwaltung (Anbindung an Stripe). 37.4.6 Funktions-Schalter (siehe Modul 32). 37.4.7 System-Gesundheit (Server, Hintergrund-Aufgaben, KWP-Sync). 37.4.8 Plattform-weites Audit-Protokoll. 37.4.9 Lead- und Verkaufs-Pipeline für unsere eigenen HiveGrid-Verkäufe. 37.4.10 Support-Anfragen-Posteingang. 37.4.11 Datenschutz-Verwaltung (Auftragsverarbeiter-Liste, Vertrags-Versionen). 37.4.12 Persönliche Einstellungen.

37.5 Dashboard: was wir auf einen Blick sehen

37.5.1 Anzahl Mandanten gesamt mit Trend (Vergleich zum Vormonat) und Aufteilung nach Status (Test-Phase, Bezahlend, Zahlung gescheitert, Pausiert, Gesperrt, Kündigung läuft). 37.5.2 Neue Mandanten letzte 7/30 Tage. 37.5.3 Wiederkehrender Monatsumsatz aktuell, Trend über 12 Monate, neue Umsätze, verlorene Umsätze, Zusatz-Umsätze des letzten Monats; Durchschnittsumsatz pro Mandant. 37.5.4 System-Status: grün/gelb/rot mit Klartext bei Auffälligkeit, Hintergrund-Aufgaben-Stau, Fehler-Quote letzte 24 Stunden, KWP-Sync-Gesundheit. 37.5.5 Aktivität: aktive Mandanten-Mitarbeiter letzte 24 Stunden / 7 Tage; Top 5 Mandanten nach Aktivität. 37.5.6 Unsere eigene Verkaufs-Pipeline: Anzahl Leads pro Status, Pipeline-Volumen. 37.5.7 Support: offene Tickets, ältester offener, durchschnittliche Lösungszeit. 37.5.8 Klick auf jede Kachel öffnet den entsprechenden Bereich. 37.5.9 Zeitraum-Wechsler (24 Stunden / 7 Tage / 30 Tage / 12 Monate).

37.6 Mandanten-Verwaltung

37.6.1 Liste aller Mandanten mit Name, Kennung, Status, Tarif, Monatsumsatz, Erstellungs-Datum, Anzahl Mitarbeiter, letzter Aktivität, Branche, Größe, zuständigem Plattform-Admin. 37.6.2 Filter und Suche, Sortierung, Spalten-Konfiguration, Massen-Aktionen (Kennzeichnung setzen, einem Plattform-Admin zuweisen, Email-Versand für Pflicht-Mitteilungen). 37.6.3 Detail-Ansicht eines Mandanten mit Stamm-Daten, Kontakt-Infos, Liste der Mandanten-Administratoren, Aktivitäts-Indikatoren, Abo-Details, Test-Phase-Info, Funktions-Schalter-Auswertung, Auftragsverarbeitungs-Vertrags-Status, internen Notizen, Aktivitäts-Protokoll. 37.6.4 Möglichkeit, den Status zu ändern (sperren, entsperren, pausieren), jede Änderung verlangt einen Pflicht-Begründungs-Text, der dauerhaft im Protokoll bleibt. 37.6.5 Test-Phase verlängern (Datum + Begründung). 37.6.6 Abo-Konditionen manuell überschreiben (für Enterprise-Sonder-Verträge). 37.6.7 Notizen anlegen, kategorisieren, anpinnen. 37.6.8 Funktions-Schalter pro Mandant setzen (siehe Modul 32). 37.6.9 Email an Mandanten-Administrator(en) versenden (Vorlage oder freier Text). 37.6.10 Daten-Export im Auftrag des Mandanten anstoßen. 37.6.11 Lösch-Workflow im Auftrag anstoßen (vermittelt, der Mandanten-Administrator bestätigt am Ende per Email-Link).

37.7 Stellvertreter-Anmeldung („Als Mandanten-Mitarbeiter einloggen")

37.7.1 Plattform-Admin kann sich für Support-Zwecke kurzzeitig als Mandanten-Mitarbeiter anmelden (z. B. um einen gemeldeten Fehler nachzuvollziehen). 37.7.2 Vor jeder Stellvertreter-Anmeldung ist ein Begründungs-Text Pflicht (z. B. „Bug-Reproduktion Ticket 123"). 37.7.3 Die Stellvertreter-Sitzung läuft maximal 30 Minuten. 37.7.4 Während der Stellvertreter-Anmeldung sehen die anderen Mandanten-Mitarbeiter im Mandanten ein gut sichtbares Banner: „Plattform-Support hat sich gerade als [Name] eingeloggt, Ticket [Nummer]". 37.7.5 Die volle Begründung wird im Protokoll dauerhaft gespeichert. Eine spezielle Berechtigung „Stellvertreter-Anmeldung" ist nötig.

37.8 Mandanten-Mitarbeiter-Verwaltung (alle Mitarbeiter aller Mandanten)

37.8.1 Liste mit Email, Name, Anzahl Mandanten-Mitgliedschaften, letzter Aktivität, 2FA-Status, Erstellungs-Datum, Status. 37.8.2 Detail-Ansicht mit Stamm-Daten, allen Mandanten-Mitgliedschaften und Rollen, aktiven Sitzungen, letzten Anmeldungen, vertrauenswürdigen Geräten, Audit-Spur, Lösch-Status. 37.8.3 Mögliche Aktionen: zweiten Faktor zurücksetzen (mit Begründung), Sitzungen beenden, Email ändern, Mitarbeiter deaktivieren/reaktivieren, Konto-Löschung im Auftrag, Wiederherstellung innerhalb der 24-Stunden-Karenz.

37.9 Plattform-Admin-Verwaltung (unsere eigenen Konten)

37.9.1 Liste aller Plattform-Admins mit Email, Rollen, Status, 2FA-Status, letzter Anmeldung, aktiven Sitzungen. 37.9.2 Plattform-Admin anlegen (Email, Name, Anfangs-Rolle), der Eingeladene bekommt einen Einrichtungs-Link mit verpflichtender 2FA-Einrichtung. 37.9.3 Rolle ändern, deaktivieren, zweiten Faktor zurücksetzen (durch anderen Super-Admin), Sitzungen beenden.

37.10 Abo-Verwaltung

37.10.1 Liste aller Abos mit Mandant, Tarif, Monatsumsatz, Status, Verlängerungs-Datum, Stripe-Sync-Status. 37.10.2 Detail-Ansicht mit Stripe-Verknüpfungen (Direkt-Link zum Stripe-Dashboard), aktuellem Tarif, Sitz-Anzahl (Büro + Monteur), Test-Phase, Rechnungs-Historie, Notizen über manuelle Sonder-Konditionen. 37.10.3 Mögliche Aktionen: Stripe-Abgleich erzwingen, Tarif manuell überschreiben (Enterprise-Sonderpreise mit Begründungs-Pflicht), Test-Phase verlängern, manuelle Rechnung anstoßen, Abo kündigen, Rückzahlung anstoßen. 37.10.4 Wenn die Daten in HiveGrid und in Stripe auseinanderlaufen, wird das im Detail mit Klartext-Vergleich angezeigt.

37.11 System-Gesundheit

37.11.1 Status pro Dienst (Web, API, Hintergrund-Aufgaben, Plan-Job-System, Datenbank, Zwischenspeicher, Datei-Speicher) mit Verfügbarkeit, Antwort-Zeiten, Fehler-Quote. 37.11.2 Hintergrund-Aufgaben-Bereich mit Liste aller Warteschlangen (Automatisierung, Email-Versand, KWP-Sync, Datenschutz-Export …), Status (in Arbeit, wartend, fehlgeschlagen, abgeschlossen), Möglichkeit fehlgeschlagene Aufgaben erneut zu starten oder Warteschlangen zu pausieren. 37.11.3 KWP-Sync-Bereich pro Mandant mit Heartbeat-Status, letztem erfolgreichem Sync, Fehler-Anzahl, Schema-Drift-Hinweisen, Möglichkeit zum Neu-Anstoßen. 37.11.4 Fehler-Anzeige mit den 10 häufigsten Fehlern der letzten 24 Stunden und Klick auf Detail.

37.12 Plattform-weites Audit-Protokoll

37.12.1 Liste aller Plattform-Admin-Aktionen plus Zugriff auf alle internen Mandanten-Audit-Protokolle in zusammengeführter Sicht. 37.12.2 Pro Eintrag: Datum, Akteur (Plattform-Admin, Mandanten-Mitarbeiter, System), Mandanten-Bezug, Aktions-Typ, Klartext-Zusammenfassung, Vorher/Nachher-Vergleich (in Detail-Schublade). 37.12.3 Filter: Akteur, Mandant (mit Auto-Vervollständigung), Aktions-Typ, Zeitraum, Ziel-Art. 37.12.4 Volltext-Suche in den Klartext-Zusammenfassungen. 37.12.5 Audit-Einträge sind unveränderlich, keine Bearbeitung, keine Löschung. 37.12.6 Aufbewahrungs-Frist: 24 Monate Standard. 37.12.7 Export für Compliance-Anfragen (CSV/JSON).

37.13 Eigene Lead- und Verkaufs-Pipeline (für UNSERE HiveGrid-Verkäufe)

37.13.1 HiveGrid hat eine eigene, vom Mandanten-CRM strikt getrennte Lead-Liste. Hier landen Anfragen von Handwerksbetrieben, die HiveGrid kaufen wollen. 37.13.2 Lead-Eingang: über Marketing-Formular auf der Webseite, Demo-Buchung, manuelle Anlage, eingehende Email, Empfehlung, Partner. 37.13.3 Pro Lead werden gespeichert: Name, Email, Telefon, Firma, Branche, Größe, Quelle, Quellen-Detail (Freitext z. B. „LinkedIn-Kampagne Mai 2026"), Status (neu, qualifiziert, kontaktiert, Demo geplant, Angebot raus, gewonnen, verloren, Spam), zugeordneter Plattform-Admin, Verlustgrund, Notizen. 37.13.4 Aktivitäts-Strom pro Lead: Email gesendet/empfangen, Anruf, Demo gehalten, Angebot raus, Notiz, Status-Wechsel, Zuweisung geändert. 37.13.5 Verkaufs-Pipeline (Kanban-Ansicht) mit den Stufen: Erstgespräch, Demo, Angebot, Verhandlung, Gewonnen, Verloren. Pro Karte: Lead-Name, Firma, geschätzter Jahresumsatz, Verantwortlicher, geplantes Abschluss-Datum. 37.13.6 Drag&Drop zwischen Stufen. 37.13.7 Bei „Gewonnen" gibt es eine Funktion „Zu Mandant promoten", die direkt in die manuelle Mandanten-Anlage führt und am Ende den Lead mit dem neu angelegten Mandanten verknüpft.

37.14 Manuelle Mandanten-Anlage und Test-Phase-Verlängerung

37.14.1 Für Demo-Vorbereitung, Enterprise-Onboarding nach Vertrag oder Lead-Promotion können wir Mandanten manuell anlegen. 37.14.2 Eingaben: Mandanten-Name + Kennung (mit Live-Prüfung), Branche, Größe, Erst-Administrator (Email + Name; bestehender Account oder neue Anlage), Anfangs-Tarif, Test-Phase-Dauer (Standard 7 Tage), optional Demo-Daten provisionieren, Begründung (Pflicht, warum manuelle Anlage). 37.14.3 Bestätigung legt Mandant an, Erst-Administrator bekommt Einrichtungs-Email mit Magic-Link. 37.14.4 Test-Phase-Verlängerung: neues End-Datum + Begründung; Klartext-Hinweis im Mandanten: „Test-Phase wurde bis [Datum] verlängert von [Plattform-Admin] mit Grund: [Text]."

37.15 Support-Bereich

37.15.1 Drei Wege, wie ein Support-Ticket entsteht: Klick im Mandanten auf einen Feedback-Knopf, eingehende Email an „support@hivegrid.de" (automatisch zugeordnet), manuelle Anlage durch einen Plattform-Admin nach Anruf oder Chat. 37.15.2 Ticket-Eigenschaften: Betreff, Mandanten-Bezug (falls bekannt), Mitarbeiter-Bezug, Quelle, Status (offen, in Arbeit, wartet auf Nutzer, gelöst, geschlossen), Priorität (niedrig, normal, hoch, dringend), zugewiesener Plattform-Admin, frei wählbare Kennzeichnungen. 37.15.3 Ticket-Detail mit Konversation, Verlinkung auf Mandant und Mitarbeiter, Aktivitäts-Protokoll. 37.15.4 Antworten werden als Email an den Mitarbeiter geschickt und erscheinen im Mandanten als interne Benachrichtigung. 37.15.5 Interne Notizen sind möglich (nur für Plattform-Admins sichtbar). 37.15.6 Standard-Antwort-Vorlagen können genutzt werden.

37.16 Datenschutz-Verwaltung

37.16.1 Auftragsverarbeiter-Liste (alle externen Dienste, die Mandanten-Daten verarbeiten): anlegen, bearbeiten, archivieren. Bei Änderung: automatische Email-Benachrichtigung an alle Mandanten-Administratoren mit 14-Tage-Widerspruchs-Frist (Datenschutz-Pflicht). 37.16.2 Auftragsverarbeitungs-Vertrags-Versionen: neue Version anlegen (PDF-Vorlage hochladen, Aktiv-ab-Datum, Beschreibung der Änderungen), Re-Akzeptanz-Aufforderung an alle Mandanten auslösen, Übersicht über Akzeptanz-Stände.

37.17 Bewusst NICHT in Phase 1

37.17.1 KI-Generations-Protokoll (Token-Verbrauch pro Mandant), Phase 2. 37.17.2 Zentrale Hilfe-Center-Artikel-Pflege im Plattform-Admin, Phase 2. 37.17.3 Vollständiger Helpdesk-Workflow mit SLA und Eskalations-Stufen, Phase 2. 37.17.4 Marketing-Automatisierung für Test-Phasen-Konvertierung, Phase 2. 37.17.5 Eigene Domain pro Mandant (Verwaltung im Plattform-Admin), Phase 2. 37.17.6 Cohorten-Analyse, Churn-Vorhersage, Phase 2. 37.17.7 Plattform-API für interne Automatisierung, Phase 2. 37.17.8 Hardware-Sicherheits-Schlüssel als zweiter Faktor für Plattform-Admins, Phase 2.

37.18 Klartext-Hinweise (Beispiele)

37.18.1 Status-Wechsel ohne Begründung: „Bitte Begründung angeben, wird im Audit-Log dauerhaft gespeichert." 37.18.2 Stellvertreter-Anmeldung ohne Begründung: blockiert, gleicher Hinweis. 37.18.3 Sonder-Tarif: „Diese Konditionen weichen vom Standard-Plan ab. Stripe wird nicht angepasst, manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]" 37.18.4 Doppelte Plattform-Admin-Email: „Diese Email gehört bereits zu einem Plattform-Admin ‚X‘, bitte direkt diesen verwalten." 37.18.5 Letzter Super-Admin: „Du bist der einzige Super-Admin. Rechte-Entzug nicht möglich. Bitte zuerst weiteren Super-Admin anlegen." 37.18.6 Konto gesperrt nach Fehlversuchen: „Account gesperrt nach 10 Fehlversuchen. Bitte anderen Super-Admin um Reaktivierung bitten." 37.18.7 Lösch-Anstoß im Auftrag: „Du startest die Kündigung für Mandant ‚X‘ im Auftrag. Bestätigungs-Email geht an alle Mandanten-Administratoren mit Cancel-Link." 37.18.8 Stripe-Konflikt: „Stripe-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Stripe-Wert] vs. [HiveGrid-Wert]." 37.18.9 Warteschlangen-Pause: „Warteschlange ‚X‘ pausiert. Neue Aufgaben werden eingereiht aber nicht verarbeitet. Vergiss nicht zu reaktivieren!" 37.18.10 Massen-Email an Mandanten-Administratoren: „Diese Email geht an X Mandanten-Administratoren. Bitte nochmal Betreff und Inhalt prüfen. [Senden]"