UC01 Screen EQ-05 – Kunde zuordnen / wechseln
Stand: 12.10.2026 11:23
Branch: main
Status: Entwurf
Änderungshistorie anzeigen
UC: UC01 – Equipment erfassen
Screen: EQ-05 – Kunde zuordnen / wechseln
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Ziel des Screens
EQ-05 dient dazu, die Zuordnung eines Equipment-Datensatzes zu ändern. Ein Equipment kann internem Bestand, einem Kunden oder vorübergehend keiner bekannten Zuordnung zugewiesen werden.
Der Screen ist wichtig für die Praxis, weil Equipment bei Ersterfassung zunächst unbestimmt sein kann, später aber internem Bestand oder einem konkreten Kunden zugeordnet wird.
2. Primäre Aufgaben
| Aufgabe |
Beschreibung |
| Aktuelle Zuordnung anzeigen |
Intern, Kunde oder unbestimmt sichtbar machen |
| Zuordnung ändern |
Wechsel zwischen internal, customer, unassigned |
| Kunde suchen |
Kundendatensatz suchen und auswählen |
| Mitarbeiter-Equipment abbilden |
Mitarbeiter als Kunde mit besonderem Merkmal verwenden |
| Änderungsnotiz erfassen |
Fachlicher Grund für Zuordnungswechsel |
| Workflow-Fähigkeit prüfen |
Auswirkungen auf spätere Workflows sichtbar machen |
| Änderung speichern |
Auditierbar speichern |
3. Screen-Aufbau
┌────────────────────────────────────────────────────────────┐
│ Equipment › Zuordnung wechseln │
│ [Abbrechen] [Zuordnung speichern] │
├────────────────────────────────────────────────────────────┤
│ Equipment-Kopf: Name, Typ, aktuelle Zuordnung │
│ Auswahl: Intern | Kunde | Unbestimmt │
│ Bei Kunde: Kundensuche + Trefferliste │
│ Hinweisbereich: Auswirkungen auf Datenqualität / Workflows │
│ Änderungsnotiz │
└────────────────────────────────────────────────────────────┘
4. Zuordnungsarten
| Wert |
Bedeutung |
internal |
Equipment gehört dem Tenant / der Tauchschule |
customer |
Equipment gehört einem Kunden |
unassigned |
Zuordnung ist aktuell noch nicht bekannt |
Mitarbeiter-Equipment wird nicht als eigene Zuordnungsart geführt, sondern über customer abgebildet. Der entsprechende Kundendatensatz erhält ein besonderes Merkmal, z. B. is_employee_contact = true.
5. Verhalten je Zuordnung
5.1 Intern
| Punkt |
Verhalten |
assignment_type |
internal |
customer_id |
leer |
| Bedeutung |
Equipment gehört dem Tenant |
| Typische Nutzung |
Schulbestand, Verleihbestand, Werkstattbestand |
5.2 Kunde
| Punkt |
Verhalten |
assignment_type |
customer |
customer_id |
Pflicht |
| Bedeutung |
Equipment gehört einem konkreten Kunden |
| Typische Nutzung |
Kundenflasche, Kundenregler, Kundencomputer |
5.3 Unbestimmt
| Punkt |
Verhalten |
assignment_type |
unassigned |
customer_id |
leer |
| Bedeutung |
Zuordnung muss später geklärt werden |
| Typische Nutzung |
Inventur, Lagerfund, unvollständige Erfassung |
6. Auswirkungen auf Datenqualität und Workflows
| Zuordnung |
Datenqualität |
Workflow-Fähigkeit |
| Intern |
Kann vollständig sein |
Ja, wenn übrige Daten vollständig sind |
| Kunde |
Kann vollständig sein |
Ja, wenn Kunde und übrige Daten vollständig sind |
| Unbestimmt |
Eher unvollständig oder needs_review |
Spezifische Workflows ggf. blockieren |
Regel:
Ein Equipment mit assignment_type = unassigned darf gespeichert werden, sollte aber für Workflows blockiert oder mindestens mit needs_review markiert werden, wenn die Zuordnung für den Workflow relevant ist.
7. Änderungsnotiz
Bei jeder Änderung der Zuordnung sollte eine Änderungsnotiz erfasst werden.
Beispiele:
| Wechsel |
Beispielnotiz |
| Unbestimmt zu Intern |
„Inventur abgeschlossen, Gerät gehört zum Schulbestand.“ |
| Intern zu Kunde |
„Gerät wurde als Kundenequipment identifiziert.“ |
| Kunde zu Intern |
„Gerät wurde von der Tauchschule übernommen.“ |
| Kunde zu Unbestimmt |
„Zuordnung unklar, muss geprüft werden.“ |
8. Aktionen
| Aktion |
Rolle |
Beschreibung |
| Zuordnung speichern |
tenant_admin, mitarbeiter |
Speichert neue Zuordnung |
| Abbrechen |
tenant_admin, mitarbeiter |
Zurück zu EQ-03 ohne Änderung |
| Kunde suchen |
tenant_admin, mitarbeiter |
Suche nach Kundendatensatz |
| Kunden öffnen |
tenant_admin, mitarbeiter |
Öffnet Kundendetail in separatem Kontext |
| Neuen Kunden anlegen |
tenant_admin, mitarbeiter |
Optionaler Absprung zur Kundenanlage |
9. Validierung
| ID |
Regel |
| V01 |
Zuordnungstyp ist Pflicht |
| V02 |
Bei customer ist customer_id Pflicht |
| V03 |
Bei internal muss customer_id leer sein |
| V04 |
Bei unassigned muss customer_id leer sein |
| V05 |
Zuordnungswechsel wird auditierbar protokolliert |
| V06 |
Bei Zuordnungswechsel wird eine Änderungsnotiz empfohlen |
| V07 |
Tenant-Isolation der Kundensuche muss eingehalten werden |
10. Akzeptanzkriterien
| ID |
Kriterium |
| AC01 |
Benutzer sieht aktuelle Zuordnung des Equipments |
| AC02 |
Benutzer kann Intern, Kunde oder Unbestimmt auswählen |
| AC03 |
Bei Kunde wird eine Kundensuche angezeigt |
| AC04 |
Benutzer kann nur Kunden des eigenen Tenants auswählen |
| AC05 |
Mitarbeiter-Equipment kann über Kundendatensatz mit Merkmal abgebildet werden |
| AC06 |
Änderung der Zuordnung wird auditierbar gespeichert |
| AC07 |
Änderungsnotiz kann erfasst werden |
| AC08 |
Auswirkungen auf Workflow-Fähigkeit werden angezeigt |
| AC09 |
Bei unassigned wird ein Prüfhinweis angezeigt |
| AC10 |
Nach Speicherung führt der Screen zurück zu EQ-03 |
11. Offene UI-Details
| ID |
Frage |
Status |
| UI1 |
Soll Kundenanlage direkt aus EQ-05 möglich sein? |
Empfehlung: Ja, aber als späterer Absprung |
| UI2 |
Soll Zuordnungswechsel immer eine Notiz verlangen? |
Empfehlung: mindestens bei Wechsel von/zu Kunde |
| UI3 |
Soll Mitarbeiter über Filter in Kundensuche sichtbar sein? |
Empfehlung: Ja, mit Badge „Mitarbeiter“ |
| UI4 |
Soll Historie früherer Zuordnungen angezeigt werden? |
Später prüfen |
| UI5 |
Wird Workflow-Fähigkeit direkt berechnet oder nur Hinweis angezeigt? |
Technisch prüfen |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
0.7 |
Leere Überschrift «12. Ä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.6 |
Versionsnummern der Änderungshistorie chronologisch durchgehend nummeriert (4 Einträge angepasst; Datum, Änderung und Autor unverändert) |
Claude |
| 12.10.2026 10:19 |
0.5 |
Datum und Uhrzeit von 1 älteren Historieneinträgen aus der Git-Historie ergänzt (Zeitpunkt des Commits, der den Eintrag eingeführt hat) |
Claude |
| 12.10.2026 09:58 |
0.4 |
Ä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.3 |
Branch-Angabe im Kopfbereich auf main korrigiert |
Claude |
| 01.08.2026 14:55 |
0.2 |
Kopfbereich vereinheitlicht |
David Mittig |
| 04.05.2026 15:28 |
0.1 |
Initialer Screen-Vorschlag für EQ-05 Kunde zuordnen / wechseln erstellt |
David Mittig |