# Einstellungen und Tools

## Bereich

- Route: `/settings`
- Zweck: App-Grundlagen, Community-Profil, Hardware, Daten und Wartungswerkzeuge an einer Stelle verwalten

## Wann du diesen Bereich nutzt

Die Einstellungen sind die Schaltzentrale für alles, was nicht direkt zum täglichen Filament-Buchen gehört. Du nutzt sie:

- wenn Theme, Sprache oder Firmenname angepasst werden sollen
- wenn dein Community-Profil mit Nickname und Avatar gepflegt werden soll
- wenn Hardware wie Waage, MQTT oder Firmware geprüft werden muss
- wenn Diagnosen, Service-Tools oder Testläufe gebraucht werden
- wenn du deine lokale Datenbank sichern oder wiederherstellen willst

## Aufbau des Screens

Der Screen ist im Windows-ähnlichen Stil organisiert:

- links: Bereichs-Navigation mit Suche
- rechts: die Karten des aktiven Settings-Abschnitts
- oben: klare Überschrift und Kontextinfo
- in den Karten: jeweils ein zusammenhängender Themenblock statt verstreuter Einzeltools

## Wichtige Themenblöcke

- `Basis`
- `Community Profil`
- `Hardware`
- `Service Tools & Diagnose`
- `Test Runner`
- `Daten & Sicherung`

## Community-Profil und Rangsystem

Seit dem Community-Ausbau nutzt die App bewusst **nur noch einen einzigen Userrang**. Dadurch werden alte Parallelbegriffe wie gesonderter Filament-Rang oder Upload-Rang ersetzt.

Der aktuelle Stand des Nutzers setzt sich zusammen aus:

- XP aus Aktivitäten in der App
- XP aus Community-Beiträgen
- einem gemeinsamen Level-System mit 60 Rängen
- festen Multiplikatoren pro Rangstufe, damit der Fortschritt später spürbar mehr Gewicht bekommt

Wichtig ist:

- Nickname und Avatar können geändert werden
- die öffentliche 8-stellige ID bleibt fest
- Avatar, Nickname, Rangdaten und Community-Zähler werden beim App-Start und nach Profil-/Share-Aktionen synchronisiert

## Schritt-für-Schritt Anleitung

### Schritt 1: Einstellungen öffnen

1. In der linken Navigation auf `Settings` klicken.
2. Links den passenden Unterbereich auswählen.
3. Oben prüfen, ob die Überschrift zum gewünschten Thema passt.

### Schritt 2: Basis-Einstellungen pflegen

1. Im Bereich `Basis` Theme, Sprache, Firmenname oder Standardwerte anpassen.
2. Änderungen speichern.
3. Direkt in Navigation, Dashboard oder Statusleiste prüfen, ob die Wirkung sichtbar ist.

### Schritt 3: Community-Profil einrichten

1. Den Bereich `Community Profil` öffnen.
2. Nickname eintragen oder ändern.
3. Einen Preset-Avatar wählen oder ein eigenes Bild hochladen.
4. Speichern.
5. Danach die Profilbox in der linken Navigation kontrollieren.
6. Prüfen, ob Avatar, Name, Level, Rang und XP direkt sichtbar aktualisiert wurden.

### Schritt 4: Öffentliche User-ID richtig verstehen

1. Die öffentliche Community-ID wird automatisch erzeugt.
2. Sie ist bewusst **nicht frei veränderbar**.
3. Sie dient dazu, Uploads, Feedback und Community-Daten eindeutig einer Installation zuzuordnen.

### Schritt 5: Hardware prüfen

1. Den Bereich `Hardware` öffnen.
2. Waagen, MQTT oder sonstige Gerätepfade kontrollieren.
3. Nur die Werte ändern, die wirklich zur vorhandenen Testumgebung passen.
4. Anschließend direkt im Zielbereich gegenprüfen, ob die Verbindung funktioniert.

### Schritt 6: Service Tools und Diagnose nutzen

1. `Service Tools & Diagnose` öffnen.
2. Das passende Werkzeug gezielt wählen, statt alles nacheinander zu starten.
3. Ergebnis, Status oder Log prüfen.
4. Nur bei echten Problemen Reparatur- oder Testroutinen erneut laufen lassen.

### Schritt 7: Lokale SQLite-Sicherung erzeugen

1. Den Bereich `Daten & Sicherung` öffnen.
2. Die Komplett-Sicherung der lokalen Datenbank starten.
3. Die Datei an einem sicheren Ort außerhalb des Projektordners ablegen.

### Schritt 8: Lokale Datenbank wiederherstellen

1. Vor dem Restore immer zuerst ein frisches Backup der aktuellen Daten erzeugen.
2. Danach die gewünschte Sicherungsdatei auswählen.
3. Den Warnhinweis bewusst bestätigen.
4. Nach dem Wiederherstellen App neu laden und die wichtigsten Bereiche prüfen:
   - Dashboard
   - Lager
   - Spulen
   - Globale Filamente

### Schritt 9: Community-Stand nach Änderungen prüfen

1. Profilbox links prüfen.
2. Über den Info-Button bei Bedarf den `Neuheiten und Community`-Dialog öffnen.
3. Kontrollieren, ob Avatar, Nickname, Rang, Level, XP und Upload-Zahlen plausibel aussehen.
4. Danach optional die `Filament-Statistik` öffnen und dort im Profilbereich nachsehen, wie viel XP aus App und Community kommt.

## Beispiel-Eingaben

```text
Firmenname: Codeschmiede Testlab
Sprache: Deutsch
Theme: Dark
Low Stock: 120 g
Community Name: Schlumpf
MQTT Host: 192.168.178.20
```

## Typische Fehler oder Stolperstellen

- Änderungen werden gespeichert, aber nicht direkt in der App gegengeprüft.
- Vor Restore oder Import wird kein Backup erzeugt.
- Nickname und öffentliche User-ID werden verwechselt.
- Ein Avatar wird gespeichert, aber der Nutzer prüft die Profilbox danach nicht.
- Diagnosefunktionen werden genutzt, ohne dass das eigentliche Problem vorher eingegrenzt wurde.
- Der Nutzer erwartet mehrere getrennte Ränge, obwohl die App bewusst nur noch einen gemeinsamen Userrang verwendet.
- Nach dem Speichern des Profils wird nicht geprüft, ob der Community-Sync Avatar und Statistiken wirklich übernommen hat.

## Screenshot-Pflicht

1. Gesamtansicht des Settings-Screens mit linker Navigation
2. Community-Profil mit Avatar-Auswahl oder Upload
3. Community-Profil mit ID, Rang, Level und XP-Anzeige
4. Daten & Sicherung mit Backup-/Restore-Bereich
