UC01 Screen EQ-02 – Neues Equipment erfassen
Stand: 12.10.2026 11:23
Branch: main
Status: Fachlich ausgearbeitet – MD, SVG und JSX vorhanden
Änderungshistorie anzeigen
UC: UC01 – Equipment erfassen
Screen: EQ-02 – Neues Equipment erfassen
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Ziel des Screens
EQ-02 dient der schnellen Erfassung eines neuen Equipment-Datensatzes. Der Screen muss sowohl eine vollständige qualifizierte Erfassung als auch eine bewusst unvollständige Erfassung in Lager-, Werkstatt- oder Offline-Situationen ermöglichen.
Der Screen ist der Haupteinstieg für neue Ausrüstung in den Equipment-Core.
2. Primäre Aufgaben
| Aufgabe |
Beschreibung |
| Equipment-Typ wählen |
Auswahl aus dem V1-Katalog inkl. other und unknown |
| Basisdaten erfassen |
Anzeigename, Hersteller, Modell, Seriennummer, Inventarnummer |
| Zuordnung festlegen |
Intern, Kunde oder unbestimmt |
| Standort und Zustand erfassen |
Lagerort, Zustand, Farbe / Kennzeichnung |
| Typabhängige Zusatzdaten erfassen |
Dynamischer Bereich je Equipment-Typ |
| Hauptfoto ergänzen |
Optionales Foto in V1 |
| Notiz erfassen |
Strukturierte Erstnotiz mit Datum/Zeit und Benutzerbezug |
| Datenqualität festlegen |
complete, incomplete, needs_review |
| Offline speichern |
Lokale Speicherung mit sync_status, falls offline |
3. Screen-Aufbau
┌────────────────────────────────────────────────────────────┐
│ Equipment › Neues Equipment │
│ [Abbrechen] [Speichern] │
├────────────────────────────────────────────────────────────┤
│ Abschnitt 1: Equipment-Typ │
│ Abschnitt 2: Basisdaten │
│ Abschnitt 3: Zuordnung │
│ Abschnitt 4: Standort, Zustand, Foto, Notiz │
│ Abschnitt 5: Typabhängige Zusatzdaten │
│ Abschnitt 6: Datenqualität / Workflow-Fähigkeit │
└────────────────────────────────────────────────────────────┘
4.1 Equipment-Typ
| Feld |
Pflicht |
Beschreibung |
| Equipment-Typ |
Ja |
Auswahl aus V1-Katalog |
| Freie Typbezeichnung |
Nur bei other |
Bekannter, aber nicht katalogisierter Typ |
| Temporäre Inventur-ID |
Nur bei unknown |
Systemseitig oder manuell ergänzbar |
Regel:
other wird verwendet, wenn der Typ bekannt ist, aber nicht im V1-Katalog existiert.
unknown oder temporärer Inventurmodus wird verwendet, wenn der Typ noch nicht bestimmbar ist.
4.2 Basisdaten
| Feld |
Pflicht |
Beschreibung |
| Anzeigename |
Ja |
Praxisname für Liste und Suche |
| Hersteller |
Nein, empfohlen |
Such- und Identifikationsmerkmal |
| Modell |
Nein, empfohlen |
Such- und Identifikationsmerkmal |
| Seriennummer |
Bedingt |
Mindestens Seriennummer oder Inventarnummer bei qualifizierter Erfassung |
| Inventarnummer |
Bedingt |
Interne Inventarnummer |
| Farbe / Kennzeichnung |
Nein, empfohlen |
Praktisch im Lager und Verleih |
4.3 Zuordnung
| Auswahl |
Bedeutung |
| Intern |
Equipment gehört dem Tenant / der Tauchschule |
| Kunde |
Equipment gehört einem Kunden |
| Unbestimmt |
Zuordnung ist aktuell noch nicht bekannt |
Bei Auswahl Kunde wird eine Kundensuche eingeblendet. Mitarbeiter-Equipment wird über einen Kundendatensatz mit besonderem Merkmal abgebildet.
4.4 Standort, Zustand, Foto, Notiz
| Feld |
Pflicht |
Beschreibung |
| Standort / Lagerort |
Nein, empfohlen |
Lager, Regal, Box, Werkstatt |
| Zustand |
Nein, empfohlen |
Neu, gut, gebraucht, beschädigt, prüfen |
| Hauptfoto |
Nein |
Foto aufnehmen oder hochladen |
| Erstnotiz |
Nein |
Strukturierte Notiz mit Benutzer und Zeitstempel |
Hinweis: Verleih-Zustand wird später zusätzlich pro Ausgabe und Rückgabe protokolliert, nicht nur als Stammdatenfeld.
4.5 Typabhängige Zusatzdaten
Der Bereich ist dynamisch und hängt vom Equipment-Typ ab.
Beispiele:
| Typ |
Zusatzdaten |
| Tauchflasche |
Material, Volumen, Arbeitsdruck, Gewinde, Ventiltyp, letzte/nächste Prüfung |
| Atemregler |
Anschluss, Stufen, letzte/nächste Revision, Serviceintervall |
| Jacket / BCD |
Grösse, Typ, Auftriebsklasse, Sichtprüfung |
| Tauchcomputer |
Batterietyp, Luftintegration, Sender, Firmware |
| Tauchanzug |
Typ, Grösse, Dicke, Schnitt |
| Maske |
optische Gläser, Dioptrien, Passform |
| Flossen |
Grösse, Typ |
| Kompass |
Bauform |
| Lampe |
Akkutyp, Ladegerät, Lumen |
4.6 Datenqualität
| Wert |
Bedeutung |
Workflow-Fähigkeit |
complete |
Alle für Typ und Nutzung nötigen Daten vorhanden |
Ja |
incomplete |
Daten fehlen noch |
Nein |
needs_review |
Datensatz muss geprüft werden |
Nein oder eingeschränkt |
Zusätzlich wird completion_notes gepflegt, wenn der Datensatz nicht vollständig ist.
5. Verhalten bei Speichern
| Situation |
Verhalten |
| Alle Pflichtfelder vollständig |
Speicherung mit data_quality_status = complete, sofern Typdaten vollständig sind |
| Pflichtdaten fehlen, aber Erfassung soll trotzdem gespeichert werden |
Speicherung mit data_quality_status = incomplete und completion_notes |
Typ unknown |
Speicherung mit temporärer ID, nicht workflow-fähig |
Typ other |
Speicherung mit freier Typbezeichnung |
| Offline |
Speicherung lokal mit sync_status = local_only oder pending_sync |
| Konflikt nach Sync |
Datensatz erhält sync_status = conflict |
6. Aktionen
| Aktion |
Rolle |
Beschreibung |
| Speichern |
tenant_admin, mitarbeiter |
Speichert Datensatz |
| Speichern & weiter erfassen |
tenant_admin, mitarbeiter |
Speichert und öffnet leeres Formular |
| Als unvollständig speichern |
tenant_admin, mitarbeiter |
Speichert bewusst unvollständig |
| Abbrechen |
tenant_admin, mitarbeiter |
Zurück zur Equipment-Liste |
| Foto aufnehmen |
tenant_admin, mitarbeiter |
Hauptfoto ergänzen |
| Kunde suchen |
tenant_admin, mitarbeiter |
Kundenzuordnung auswählen |
7. Validierung
| ID |
Regel |
| V01 |
Equipment-Typ ist Pflicht, ausser bei bewusstem unknown-Modus |
| V02 |
Anzeigename ist Pflicht |
| V03 |
Zuordnungstyp ist Pflicht |
| V04 |
Bei Zuordnung customer ist customer_id Pflicht |
| V05 |
Bei qualifizierter Erfassung ist Seriennummer oder Inventarnummer Pflicht |
| V06 |
Seriennummer muss pro Tenant + Equipment-Typ eindeutig sein |
| V07 |
Bei other ist freie Typbezeichnung Pflicht |
| V08 |
Bei unknown ist Workflow-Fähigkeit blockiert |
| V09 |
Bei incomplete muss completion_notes empfohlen oder verlangt werden |
| V10 |
NFC-Felder werden in V1 nicht angeboten |
8. Akzeptanzkriterien
| ID |
Kriterium |
| AC01 |
Benutzer kann ein neues Equipment mit Basisdaten erfassen |
| AC02 |
Benutzer kann zwischen intern, Kunde und unbestimmt wählen |
| AC03 |
Bei Kundenzuordnung wird eine Kundensuche angeboten |
| AC04 |
Benutzer kann other mit freier Typbezeichnung speichern |
| AC05 |
Benutzer kann unknown mit temporärer ID speichern |
| AC06 |
Unvollständiges Equipment ist speicherbar, aber nicht workflow-fähig |
| AC07 |
Datenqualität wird sichtbar gesetzt |
| AC08 |
QR-Code wird nach Speicherung vorbereitet oder erzeugt |
| AC09 |
Offline-Speicherung setzt passenden sync_status |
| AC10 |
Tenant-Isolation wird eingehalten |
9. Offene UI-Details
| ID |
Frage |
Status |
| UI1 |
Soll das Formular als Einzelseite oder Wizard umgesetzt werden? |
Empfehlung: Einzelseite mit klaren Abschnitten |
| UI2 |
Wird data_quality_status manuell gewählt oder automatisch vorgeschlagen? |
Empfehlung: automatisch vorschlagen, manuell prüfbar |
| UI3 |
Soll Speichern & weiter erfassen in V1 angeboten werden? |
Empfehlung: Ja, für Lagererfassung praktisch |
| UI4 |
Wird Fotoaufnahme direkt über Smartphone-Kamera umgesetzt? |
Technisch prüfen |
| UI5 |
Soll QR-Code sofort nach Speichern angezeigt werden? |
Empfehlung: Ja, wenn einfach möglich |
10. Artefakte und Querverweise
| Typ |
Datei |
| Spezifikation |
eq-02-neues-equipment-erfassen.md |
| Statisches Wireframe |
eq-02-neues-equipment-erfassen.svg |
| Interaktives Wireframe |
eq-02-neues-equipment-erfassen.jsx |
Querverweise:
| Ziel |
Bedeutung |
| EQ-01 |
Rückkehr zur Equipment-Liste |
| EQ-03 |
Detailansicht nach Speicherung |
| EQ-08 |
Hauptfoto erfassen oder ersetzen |
| EQ-09 |
QR-Code nach Speicherung anzeigen |
| EQ-10 |
Unvollständige Datensätze später prüfen |
| UC18 |
Späterer Verleih nutzt nur qualifiziert erfasste und workflow-fähige Datensätze |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
0.10 |
Leere Überschrift «11. Ä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:54 |
0.3 |
Status auf fachlich ausgearbeitet und vorhandene Artefakte aktualisiert |
David Mittig |
| 04.05.2026 16:02 |
0.2 |
Artefaktverweise und Querverweise zu EQ-03, EQ-08, EQ-09, EQ-10 und UC18 ergänzt |
David Mittig |
| 04.05.2026 14:49 |
0.1 |
Initialer Screen-Vorschlag für EQ-02 Neues Equipment erfassen erstellt |
David Mittig |