Erstkonfiguration

Achtung

Superheld ist plattformgleich mit lokalem Backend ausgerichtet. Die hier beschriebene Konfiguration bezieht sich auf den aktuell verifizierten lokalen Installationspfad ueber Android. Schutzmodi, Familienprofile und Benachrichtigungseinstellungen sind Zielarchitektur und noch nicht als Runtime implementiert.

In-App-Einrichtung

Der Settings-Bereich der App bietet seit Commit 0371231 zwei Einrichtungspfade:

DAU-Pfad: Account erstellen oder anmelden (empfohlen)

Fuer normale Endnutzer ist der Account-Sign-in der primaere Einrichtungspfad. Im Settings-Bereich kann ein Account erstellt oder ein bestehender Account verwendet werden:

1. Account erstellen (oder Anmelden, falls bereits vorhanden)

   Die App nutzt POST /account/register (mit E-Mail, Passwort und Tenant-ID) oder POST /account/login (mit E-Mail und Passwort). Nach erfolgreichem Sign-in speichert die App die Session mit den benoetigten Scopes (status:read, devices:read, alerts:read, incidents:read, tokens:read, tokens:write) und kehrt zur Home-Oberflaeche zurueck. Die gespeicherte Session bleibt im Settings-Hub eingeklappt, bis sie explizit geoeffnet wird.

Manuelles Token-Minting, Zugangscode-Eingabe und Familien-Code entfallen fuer diesen Pfad.

Operator-/Entwickler-Pfad: Manuelle Konfiguration

Fuer Operatoren und Entwickler bleibt der manuelle Einrichtungs-Assistent mit drei Schritten verfuegbar:

1. Service-Adresse eingeben

   Die Adresse des Backends. Fuer den verifizierten lokalen Pfad: http://127.0.0.1:8080

2. Zugangscode eingeben

   Ein tenant-gebundenes Token mit den benoetigten Berechtigungen. Mindestscopes: devices:write, events:write, status:read, alerts:read, incidents:read, jobs:read

3. Familien-/Tenant-Code eingeben

   Muss zur Token-Bindung passen. Fuer den lokalen Pfad: tenant-local. Bei einem Mismatch zeigt die App eine Warnung.

Settings-und-Hilfe-Screen

Der Settings-und-Hilfe-Screen ist ueber den Tab „Settings” in der unteren Navigation erreichbar und oeffnet sich zunaechst als ruhige Support-Uebersicht. Bei fehlender Einrichtung zeigt der Home-Screen einen Setup-CTA, der zum Settings-Tab fuehrt. Der Home-Screen zeigt keine separate Settings-/Hilfe-Karte; Setup und Hilfe sind nur ueber die Primaeraaktion auf dem Home-Screen oder den Tab „Settings” in der Bottom-Navigation erreichbar. In beiden Faellen landet der Nutzer zuerst auf der Uebersicht, nicht direkt in Eingabefeldern. Der Hub rendert vier eigene Unterseiten mit jeweils eigenem Header: Connection setup, Support-requested help, Guided checks und Support details. Bei der Erstnutzung verzweigt der Nutzer explizit in den Bereich Connection setup (Account-Sign-in oder Verbindung/Registrierung), um die Einrichtung zu starten. Nach erfolgreicher Einrichtung zeigt der Hub nur noch „Use this area only when you need help.” Token-/Trace-/Backend-Diagnostik erscheint erst nach explizitem Drill-down in Support details. Der Tab „Home” in der unteren Navigation oder die System-Zurueck-Taste fuehrt zurueck zum taeglichen Hauptscreen; geoeffnete Support-Details werden dabei automatisch eingeklappt.

Hinweis

Support-Access-Code und manuelle Geraeteregistrierung (Register this phone) liegen ausschliesslich unter Guided checks (support-angeforderte Aktionen). Service-Adresse, Familiencode und Account-Sign-in bleiben im normalen Connection setup-Pfad. Der DAU-Einrichtungsweg benoetigt keinen Support-Access-Code.

Build-Parameter (Entwickler-Pfad)

Alternativ zur In-App-Konfiguration kann die App auch mit Build-Parametern vorkonfiguriert installiert werden:

./gradlew installDebug \
  -Psuperheld.baseUrl=http://127.0.0.1:8080 \
  -Psuperheld.apiToken=<tenant-app-token> \
  -Psuperheld.tenantId=tenant-local

Konfiguration pruefen

Nach dem Start zeigt der Hauptscreen den aktuellen Zustand:

• Einrichtung noetig: Der Hauptscreen zeigt „Start here” und schlaegt vor, die Einrichtung zu oeffnen
• Eingerichtet und geschuetzt: „Everything looks calm” mit Schnell-Check-Metriken
• Tenant-Mismatch: Warnung im Statusbereich mit Hinweis zur Korrektur

Auf dem Settings-und-Hilfe-Screen sind die gespeicherten Verbindungsdaten (Service-Adresse, Zugangscode, Familien-Code) sowie die Geraete-Identitaet einsehbar.

Was heute noch nicht konfigurierbar ist

• Schutzmodus-Auswahl (Basis, Familie, Experte) — Zielarchitektur
• Familienprofile (Kind, Jugendlich, Erwachsener, Senior) — Zielarchitektur
• Benachrichtigungseinstellungen (Push, Zusammenfassung, stille Blockierung) — Zielarchitektur
• Schutzschichten einzeln aktivieren/deaktivieren — Zielarchitektur

---

Naechster Schritt: Taegliche Nutzung →