# Dashboard

## Bereich

- Route: `/`
- Zweck: operative Startseite für Tagesbetrieb, Kontrolle und schnelle Navigation

## Wann du das Dashboard nutzt

Das Dashboard ist die erste Seite nach dem Start der App. Es eignet sich für:

- den schnellen Überblick am Tagesanfang
- die Prüfung von Low-Stock, aktiven Spulen und Filamentbestand
- den direkten Sprung in den nächsten Arbeitsbereich
- die Kontrolle von Status, Version und Paketumgebung

## Voraussetzungen

Damit das Dashboard sinnvoll befüllt ist, sollten bereits Daten vorhanden sein:

- mindestens ein Lager
- mehrere globale Filamente
- mindestens eine aktive Spule
- optional vorhandene Status- oder Bugtracker-Daten

## Wichtige Bereiche auf der Seite

### Kennzahlkarten

Hier siehst du die groben Mengen und aktuelle Situation. Typische Karten sind:

- Anzahl Filamente
- Anzahl aktiver Spulen
- Low-Stock Hinweise
- weitere betriebsrelevante Kennzahlen

### Schnellzugriffe

Diese Buttons bringen dich direkt in die Arbeitsbereiche, die man im Alltag häufig braucht:

- Globale Filamente
- Spulen
- Lager
- Wiegen
- Labels

### Statusleiste

Die untere Statusleiste ist Teil des Dashboards und zeigt:

- XP oder Fortschritt
- Paket- und Update-Zustand
- Bugtracker-Status
- Changelog- oder Roadmap-Einstieg

## Schritt-für-Schritt Anleitung

### Schritt 1: Dashboard öffnen

1. App starten.
2. Im linken Menü auf `Dashboard` klicken, falls du nicht automatisch dort landest.
3. Kurz warten, bis Kennzahlen und Statusleistenwerte sichtbar sind.

### Schritt 2: Kritische Hinweise lesen

1. Zuerst die Karten mit Warn- oder Low-Stock-Bezug lesen.
2. Falls dort kritische Werte stehen, den betroffenen Bereich zuerst bearbeiten.
3. Danach aktive Spulen und Filamentbestand gegen den erwarteten Tagesstand prüfen.

### Schritt 3: In den Arbeitsbereich wechseln

1. Über die Schnellzugriffe den nächsten Bereich öffnen.
2. Für Materialpflege zu `Globale Filamente` wechseln.
3. Für reale Rollen zu `Spulen` wechseln.
4. Für Slot- oder Lagerfragen zu `Lager` wechseln.

## Typische Klickreihenfolge im Alltag

1. Dashboard lesen
2. Low-Stock prüfen
3. Statusleiste prüfen
4. in Filamente, Spulen oder Lager abspringen

## Beispiel-Daten für Doku und Screenshots

```text
Filamente: 250
Aktive Spulen: 87
Low Stock: 4
Lager: 6
```

## Typische Fehler oder Missverständnisse

- Das Dashboard zeigt nur Übersicht, nicht die Detailpflege.
- Wenn Karten leer wirken, fehlen oft Grunddaten in Filamenten, Spulen oder Lagern.
- Die Statusleiste unten wird leicht übersehen, ist aber für Bugs, Pakete und Releases wichtig.

## Screenshot-Pflicht

1. Gesamtansicht Dashboard
   Zeigt Karten, Schnellzugriffe und Seitenkopf.
2. Detailansicht einer relevanten Kennzahl
   Zum Beispiel Low-Stock oder aktive Spulen.
3. Zustand mit sichtbarer Statusleiste
   Damit Nutzer den Zusammenhang zwischen Dashboard und Betriebsstatus verstehen.


