Zum Inhalt

UC01 Screen EQ-01 – Equipment-Liste

Stand: 12.10.2026 11:23 Branch: main Status: Fachlich ausgearbeitet – MD, SVG und JSX vorhanden

Änderungshistorie anzeigen


UC: UC01 – Equipment erfassen
Screen: EQ-01 – Equipment-Liste


Wireframe

EQ-01 – Equipment-Liste

Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.


1. Ziel des Screens

EQ-01 ist die zentrale Übersicht über alle Equipment-Datensätze eines Tenants. Der Screen dient dazu, Equipment schnell zu finden, nach Typ und Status zu filtern, unvollständige Datensätze zu erkennen und neue Equipment-Datensätze anzulegen.

Die Liste muss für den praktischen Einsatz im Lager, in der Werkstatt, am Kompressorraum und im Schulbetrieb geeignet sein.


2. Primäre Aufgaben

Aufgabe Beschreibung
Equipment suchen Suche nach Anzeigename, Seriennummer, Inventarnummer, Hersteller, Modell, Kunde oder QR-Code-Wert
Equipment filtern Filter nach Typ, Status, Datenqualität, Zuordnung, Standort und Sync-Status
Equipment öffnen Klick auf Datensatz öffnet EQ-03 Equipment-Detail
Neues Equipment erfassen Button öffnet EQ-02 Neues Equipment erfassen
Unvollständige Datensätze erkennen Datensätze mit data_quality_status = incomplete oder needs_review werden deutlich markiert
Offline-Datensätze erkennen Datensätze mit sync_status = local_only, pending_sync oder conflict werden sichtbar markiert
QR-Code scannen Optionaler Einstieg: QR-Code scannen und passenden Datensatz öffnen

3. Screen-Aufbau

┌────────────────────────────────────────────────────────────┐
│ Equipment                                                   │
│ [Suche...]                         [+ Neues Equipment] [QR] │
├────────────────────────────────────────────────────────────┤
│ Filter: Typ | Zuordnung | Status | Datenqualität | Standort │
├────────────────────────────────────────────────────────────┤
│ Kennzahlen: Gesamt | Unvollständig | Intern | Kunden | Sync │
├────────────────────────────────────────────────────────────┤
│ Liste / Tabelle                                             │
│ - Typ                                                       │
│ - Anzeigename                                               │
│ - Hersteller / Modell                                       │
│ - Seriennummer / Inventarnummer                             │
│ - Zuordnung                                                 │
│ - Standort                                                  │
│ - Status                                                    │
│ - Datenqualität                                             │
│ - Sync-Status                                               │
│ - Aktionen                                                  │
└────────────────────────────────────────────────────────────┘

4. Kopfbereich

Element Funktion
Seitentitel Equipment Klare Einordnung des Bereichs
Suchfeld Volltextsuche über zentrale Identifikationsfelder
Button + Neues Equipment Öffnet EQ-02
Button QR scannen Öffnet QR-Scan-Dialog, falls QR-Funktion in V1 aktiviert ist

5. Filter

5.1 Pflichtfilter für V1

Filter Werte
Equipment-Typ Tauchflasche, Atemregler, Jacket / BCD, Tauchcomputer, Tauchanzug, Maske, Flossen, Kompass, Lampe, Blei / Bleisystem, Boje / SMB, Sonstiges, Unbestimmt
Zuordnung Intern, Kunde, Unbestimmt
Equipment-Status Aktiv, Inaktiv, Ausgemustert, Archiviert
Datenqualität Vollständig, Unvollständig, Prüfung nötig
Standort Freitext / Dropdown, falls Standort gepflegt ist
Sync-Status Synchronisiert, Lokal, Synchronisierung ausstehend, Konflikt

5.2 Schnellfilter

Schnellfilter Bedeutung
Unvollständig Zeigt nur Datensätze mit data_quality_status = incomplete
Prüfung nötig Zeigt nur Datensätze mit data_quality_status = needs_review
Nicht synchronisiert Zeigt local_only, pending_sync, conflict
Internes Equipment Zeigt assignment_type = internal
Kundenequipment Zeigt assignment_type = customer
Unbestimmt Zeigt Datensätze mit unbestimmter Zuordnung oder unbestimmtem Typ

6. Tabellen- / Listenansicht

6.1 Desktop-Tabelle

Spalte Inhalt Hinweis
Typ Icon + Anzeigename des Equipment-Typs z. B. Flasche, Regler, Maske
Anzeigename Hauptname des Datensatzes Klick öffnet Detail
Hersteller / Modell Kompakte Anzeige Optional leer möglich
Seriennummer / Inventarnummer Wichtigste Identifikation Mindestens eines vorhanden, sofern qualifiziert
Zuordnung Intern, Kunde, Unbestimmt Bei Kunde: Name anzeigen
Standort Lagerort / Box / Regal Optional
Status Fachlicher Status active, inactive, retired, archived
Datenqualität complete, incomplete, needs_review Deutlich markieren
Sync synced, local_only, pending_sync, conflict Besonders offline-relevant
Aktionen Öffnen, Bearbeiten, QR anzeigen Rollenabhängig

6.2 Mobile Kartenansicht

Auf mobilen Geräten wird keine breite Tabelle verwendet. Jeder Datensatz erscheint als Karte.

[Icon] 12l Stahlflasche gelb
Tauchflasche · Intern · Lager A
SN: 123456 · INV: INT-0047
Status: Aktiv · Daten: Unvollständig · Sync: Ausstehend
[Öffnen] [Bearbeiten] [QR]

7. Statusanzeigen

7.1 Datenqualität

Wert Anzeige Bedeutung
complete Vollständig Für spezifische Workflows grundsätzlich nutzbar
incomplete Unvollständig Speicherbar, aber nicht für spezifische Workflows nutzbar
needs_review Prüfung nötig Muss fachlich geprüft werden

7.2 Sync-Status

Wert Anzeige Bedeutung
local_only Nur lokal Noch nie synchronisiert
pending_sync Sync ausstehend Wird synchronisiert, sobald online
synced Synchronisiert Serverseitig gespeichert
conflict Konflikt Manuelle Prüfung nötig

8. Verhalten bei other und unknown

Typ Anzeige Verhalten
other Sonstiges: freie Typbezeichnung Bekannter, aber nicht katalogisierter Typ
unknown Unbestimmter Typ Noch nicht bestimmbar, nicht workflow-fähig

Regel:

other wird verwendet, wenn der Typ bekannt ist, aber nicht im V1-Katalog existiert.
unknown oder ein temporärer Inventurmodus wird verwendet, wenn der Typ noch nicht bestimmbar ist.


9. QR-Code in EQ-01

Für V1 wird QR-Code umgesetzt. NFC ist nicht Bestandteil von V1 und bleibt nur spätere Prüfoption.

Funktion V1
QR-Code-Wert anzeigen Ja, im Detail oder Aktionsmenü
QR-Code scannen Wenn technisch einfach möglich, sonst V1.1
QR-Code-Etikett exportieren Später oder V1.1
NFC Nein

10. Aktionen

Aktion Rolle Beschreibung
Öffnen tenant_admin, mitarbeiter Öffnet EQ-03 Detailansicht
Bearbeiten tenant_admin, mitarbeiter Öffnet EQ-04 Bearbeiten
Neues Equipment tenant_admin, mitarbeiter Öffnet EQ-02
QR anzeigen tenant_admin, mitarbeiter Zeigt QR-Code zum Datensatz
Archivieren tenant_admin Markiert Datensatz als archiviert
Unvollständige prüfen tenant_admin, mitarbeiter Öffnet EQ-10 als gefilterte Prüfansicht
Sync-Konflikt prüfen tenant_admin, mitarbeiter Öffnet Konfliktansicht oder Detailansicht

11. Leere Zustände und Hinweise

Zustand Meldung
Noch kein Equipment „Noch kein Equipment erfasst. Lege dein erstes Equipment an.“
Keine Treffer „Keine passenden Equipment-Datensätze gefunden.“
Offline „Du arbeitest offline. Neue oder geänderte Datensätze werden später synchronisiert.“
Sync-Konflikt „Für einzelne Datensätze besteht ein Synchronisationskonflikt. Bitte prüfen.“
Unvollständige Daten „Einige Datensätze sind unvollständig und können noch nicht für Workflows genutzt werden.“

12. Akzeptanzkriterien

ID Kriterium
AC01 Benutzer sieht nur Equipment des eigenen Tenants
AC02 Benutzer kann Equipment über Suche finden
AC03 Benutzer kann nach Equipment-Typ filtern
AC04 Benutzer kann nach Zuordnung filtern
AC05 Benutzer kann unvollständige Datensätze gezielt anzeigen
AC06 Benutzer kann nicht synchronisierte Datensätze erkennen
AC07 Klick auf Datensatz öffnet Detailansicht
AC08 Button + Neues Equipment öffnet Erfassungsformular
AC09 QR-Code-Funktion ist sichtbar, sofern V1 technisch aktiviert ist
AC10 NFC-Funktion ist in V1 nicht sichtbar
AC11 unknown-Datensätze sind erkennbar und nicht workflow-fähig
AC12 Mobile Ansicht ist ohne horizontales Scrollen nutzbar

13. Offene UI-Details

ID Frage Status
UI1 Welche Icons werden pro Equipment-Typ verwendet? Offen
UI2 Soll die Liste standardmässig nach zuletzt geändert sortiert werden? Empfehlung: Ja
UI3 Soll es eine Inventuransicht geben? Prüfen
UI4 Wird QR-Scan bereits in V1 oder erst V1.1 umgesetzt? Technisch prüfen
UI5 Welche Farben / Badges werden für Status und Datenqualität verwendet? Design-System klären

14. Artefakte und Querverweise

Typ Datei
Spezifikation eq-01-equipment-liste.md
Statisches Wireframe eq-01-equipment-liste.svg
Interaktives Wireframe eq-01-equipment-liste.jsx

Querverweise:

Ziel Bedeutung
EQ-02 Neues Equipment erfassen
EQ-03 Equipment-Detail öffnen
EQ-09 QR-Code anzeigen
EQ-10 Unvollständige Datensätze prüfen
UC18 Späterer Equipment-Verleih nutzt EQ-01 als Bestands- und Einstiegspunkt

Änderungshistorie

Datum, Uhrzeit Version Änderung Autor
12.10.2026 11:23 0.10 Leere Überschrift «15. Änderungshistorie» aus der Zeit vor dem einheitlichen Dokumentaufbau entfernt; Abschnitt «Wireframe» mit klickbarem Bild des Screens ergänzt Claude
12.10.2026 11:01 0.9 Versionsnummern der Änderungshistorie chronologisch durchgehend nummeriert (5 Einträge angepasst; Datum, Änderung und Autor unverändert) Claude
12.10.2026 10:19 0.8 Datum und Uhrzeit von 3 älteren Historieneinträgen aus der Git-Historie ergänzt (Zeitpunkt des Commits, der den Eintrag eingeführt hat) Claude
12.10.2026 10:09 0.7 Änderungshistorie absteigend sortiert; Einträge inhaltlich unverändert Claude
12.10.2026 09:58 0.6 Änderungshistorie ans Dokumentende verschoben und Sprunglink «Änderungshistorie anzeigen» unter dem Kopf ergänzt (einheitlicher Dokumentaufbau gemäss AGENTS.md) Claude
12.10.2026 09:08 0.5 Branch-Angabe im Kopfbereich auf main korrigiert Claude
01.08.2026 14:55 0.4 Kopfbereich vereinheitlicht David Mittig
07.05.2026 23:52 0.3 Status auf fachlich ausgearbeitet und vorhandene Artefakte aktualisiert David Mittig
04.05.2026 16:01 0.2 Artefaktverweise und Querverweise zu EQ-10 und UC18 ergänzt David Mittig
04.05.2026 13:21 0.1 Initialer Screen-Vorschlag für EQ-01 Equipment-Liste erstellt David Mittig