UC04 Screen IS-03 – Servicevorgang Detail
Stand: 12.10.2026 11:23
Branch: main
Status: Fachlich ausgearbeitet – MD, SVG und JSX vorgesehen
Änderungshistorie anzeigen
UC: UC04 – Inhouse-Service erfassen
Screen: IS-03 – Servicevorgang Detail
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Ziel des Screens
IS-03 zeigt die vollständige Detailansicht eines einzelnen Inhouse-Servicevorgangs.
Der Screen dient dazu, Status, Equipment, Kunde, Serviceart, verantwortlichen Mitarbeiter, Fristen, Notizen, Kosten und Verlauf eines Servicevorgangs nachvollziehbar darzustellen. IS-03 ist damit die zentrale Arbeits- und Kontrollansicht für einen konkreten UC04-Workflow.
2. Primäre Aufgaben
| Aufgabe |
Beschreibung |
| Servicevorgang prüfen |
zentrale Übersicht über alle wichtigen Vorgangsdaten |
| Equipment-Kontext anzeigen |
Equipment, Seriennummer, Inventarnummer, Kunde und Status sichtbar machen |
| Workflowstatus anzeigen |
aktueller Bearbeitungsstand mit Statusbadge |
| Serviceverlauf anzeigen |
chronologische Workflow-Historie anzeigen |
| Notizen anzeigen |
Startnotiz, Bearbeitungsnotizen und Ergebnisnotiz sichtbar machen |
| Kosten anzeigen |
optional erfasste Kosten kompakt darstellen |
| Bearbeitung starten |
Wechsel zu IS-04 Service bearbeiten |
| Abschluss starten |
Wechsel zu IS-05 Service abschliessen |
| Nacharbeit starten |
Wechsel zu IS-06 Nacharbeit / nicht bestanden |
| Historie öffnen |
Wechsel zu IS-07 Servicehistorie je Equipment |
3. Screen-Aufbau
┌────────────────────────────────────────────────────────────┐
│ Servicevorgang Detail │
│ [Zurück] [Bearbeiten] [Abschliessen] │
├────────────────────────────────────────────────────────────┤
│ Kopfdaten: Service-ID, Status, Serviceart, Priorität │
├────────────────────────────────────────────────────────────┤
│ Equipment- und Kundenkontext │
├────────────────────────────────────────────────────────────┤
│ Serviceinformationen │
│ - Serviceobjekt │
│ - Verantwortlicher Mitarbeiter │
│ - geplantes Datum / Frist │
│ - Ergebnis / Kosten │
├────────────────────────────────────────────────────────────┤
│ Notizen │
├────────────────────────────────────────────────────────────┤
│ Workflow-Historie │
└────────────────────────────────────────────────────────────┘
4. Kopfbereich
| Element |
Funktion |
Seitentitel Servicevorgang Detail |
klare Einordnung der Detailansicht |
| Service-ID |
eindeutige fachliche Referenz, z. B. IS-2026-004 |
| Statusbadge |
aktueller Workflowstatus |
| Zurück-Link |
zurück zu IS-01 |
Button Bearbeiten |
öffnet IS-04, sofern Vorgang bearbeitbar ist |
Button Abschliessen |
öffnet IS-05, sofern Vorgang offen oder in Bearbeitung ist |
Button Nacharbeit |
öffnet IS-06, wenn Nacharbeit oder nicht bestanden relevant ist |
Button Korrektur |
öffnet IS-08, falls Vorgang abgeschlossen ist und Rolle berechtigt ist |
5. Detailbereiche
5.1 Service-Kopfdaten
| Feld |
Beschreibung |
| Service-ID |
eindeutige Vorgangskennung |
| Serviceart |
z. B. Atemregler-Service oder Jacket-Service |
| Serviceobjekt |
z. B. Atemregler, Jacket / BCD, Tauchcomputer |
| Status |
aktueller Workflowstatus |
| Priorität |
normal, hoch, kritisch |
| erstellt am |
Zeitpunkt der Anlage |
| erstellt durch |
Benutzer, der den Vorgang angelegt hat |
| zuletzt geändert |
letzter Änderungszeitpunkt |
5.2 Equipment- und Kundenkontext
| Feld |
Beschreibung |
| Equipment-Name |
Anzeigename des Equipment-Datensatzes |
| Equipment-Typ |
Typ aus UC01 |
| Hersteller / Modell |
technische Einordnung |
| Seriennummer / Inventarnummer |
eindeutige Identifikation |
| Kunde / Eigentümer |
Kundendatensatz oder internes Equipment |
| Standort |
Lager, Werkstatt, Ausgabe usw. |
| Equipment-Status |
aktiv, inaktiv, archiviert usw. |
| Datenqualität |
vollständig, unvollständig, Prüfung nötig |
| Feld |
Beschreibung |
| verantwortlicher Mitarbeiter |
aktuell zugewiesener Bearbeiter |
| geplantes Datum |
geplanter Servicezeitpunkt |
| Friststatus |
ok, bald fällig, heute fällig, überfällig, unbekannt |
| Ergebnis |
offen, bestanden, nicht bestanden, Nacharbeit, abgebrochen |
| Kostenbetrag |
optional |
| Währung |
optional, z. B. CHF oder EUR |
| Ergebnisdatum |
erst nach Abschluss relevant |
6. Notizen
| Notiztyp |
Bedeutung |
| Startnotiz |
Hinweis bei Anlage des Servicevorgangs |
| Bearbeitungsnotizen |
laufende interne Notizen während der Bearbeitung |
| Ergebnisnotiz |
Pflicht bei Abschluss oder Nacharbeit |
| Korrekturhinweis |
Pflicht bei Korrektur eines abgeschlossenen Vorgangs |
Regel:
Notizen dürfen fachlich nachvollziehbar ergänzt werden. Abgeschlossene Vorgänge dürfen nicht still überschrieben werden.
7. Workflow-Historie
IS-03 zeigt eine chronologische Historie aller relevanten Status- und Bearbeitungsschritte.
| Eintrag |
Inhalt |
| Anlage |
Servicevorgang wurde erstellt |
| Statuswechsel |
alter und neuer Status |
| Zuweisung |
verantwortlicher Mitarbeiter geändert |
| Notiz ergänzt |
Bearbeitungsnotiz hinzugefügt |
| Abschluss |
Ergebnis, Ergebnisdatum und Ergebnisnotiz |
| Nacharbeit |
Nacharbeit oder nicht bestanden markiert |
| Korrektur |
Korrektur mit Pflichtgrund |
8. Statusabhängige Aktionen
| Status |
mögliche Aktionen |
draft |
bearbeiten, starten, abbrechen |
open |
bearbeiten, in Arbeit setzen, abschliessen, abbrechen |
in_progress |
bearbeiten, abschliessen, Nacharbeit erfassen |
waiting_for_parts |
bearbeiten, in Arbeit setzen, abbrechen |
rework_required |
bearbeiten, Nacharbeit bearbeiten, abschliessen |
completed |
Historie anzeigen, Korrektur starten |
cancelled |
Historie anzeigen |
corrected |
Historie anzeigen, Korrekturbezug anzeigen |
9. Sicherheits- und Schutzregeln
| ID |
Regel |
| IS03-SEC01 |
Benutzer sieht nur Servicevorgänge des eigenen Tenants |
| IS03-SEC02 |
Kunde sieht IS-03 nicht direkt |
| IS03-SEC03 |
Abgeschlossene Vorgänge sind gegen unbemerkte Änderung zu schützen |
| IS03-SEC04 |
Korrekturen benötigen einen Pflichtgrund |
| IS03-SEC05 |
Workflow-Historie darf nicht gelöscht oder still überschrieben werden |
| IS03-SEC06 |
Kostenfelder können später rollenabhängig eingeschränkt werden |
10. Leere Zustände und Hinweise
| Zustand |
Meldung |
| Servicevorgang nicht gefunden |
„Der Servicevorgang wurde nicht gefunden oder du hast keinen Zugriff.“ |
| Historie leer |
„Noch keine Verlaufseinträge vorhanden.“ |
| Notizen leer |
„Noch keine Notizen erfasst.“ |
| Vorgang abgeschlossen |
„Dieser Servicevorgang ist abgeschlossen. Änderungen sind nur als Korrektur möglich.“ |
| Vorgang kritisch |
„Dieser Vorgang benötigt Nacharbeit oder Prüfung.“ |
| Offline |
„Du arbeitest offline. Änderungen werden später synchronisiert.“ |
11. Akzeptanzkriterien
| ID |
Kriterium |
| IS03-AC01 |
Benutzer kann einen Servicevorgang aus IS-01 oder IS-02 öffnen |
| IS03-AC02 |
Benutzer sieht nur Servicevorgänge des eigenen Tenants |
| IS03-AC03 |
Service-ID, Status, Serviceart und Serviceobjekt werden angezeigt |
| IS03-AC04 |
Equipment-Kontext mit Kunde, Seriennummer und Status wird angezeigt |
| IS03-AC05 |
verantwortlicher Mitarbeiter und geplantes Datum werden angezeigt |
| IS03-AC06 |
Friststatus und Ergebnisstatus werden angezeigt |
| IS03-AC07 |
Notizen werden angezeigt, sofern vorhanden |
| IS03-AC08 |
Workflow-Historie wird chronologisch angezeigt |
| IS03-AC09 |
Bearbeiten öffnet IS-04, sofern Vorgang bearbeitbar ist |
| IS03-AC10 |
Abschliessen öffnet IS-05, sofern Vorgang offen oder in Bearbeitung ist |
| IS03-AC11 |
Nacharbeit öffnet IS-06, wenn fachlich relevant |
| IS03-AC12 |
Abgeschlossene Vorgänge sind nicht still änderbar |
| IS03-AC13 |
Korrektur öffnet IS-08 nur für berechtigte Rollen |
12. Offene UI-Details
| ID |
Frage |
Status |
| IS03-UI1 |
Soll die Historie als Timeline oder Tabelle dargestellt werden? |
Vorschlag: Timeline |
| IS03-UI2 |
Sollen Kosten in der Detailansicht prominent oder sekundär angezeigt werden? |
Vorschlag: sekundär |
| IS03-UI3 |
Wird Equipment-Detail aus UC01 direkt verlinkt? |
Ja, sinnvoll |
| IS03-UI4 |
Werden Notizen inline oder als eigener Abschnitt bearbeitet? |
Bearbeitung in IS-04 |
| IS03-UI5 |
Soll der Korrekturhinweis direkt im Kopf sichtbar sein? |
Ja, bei korrigierten Vorgängen |
13. Artefakte und Querverweise
| Typ |
Datei |
| Spezifikation |
is-03-servicevorgang-detail.md |
| Statisches Wireframe |
is-03-servicevorgang-detail.svg |
| Interaktives Wireframe |
is-03-servicevorgang-detail.jsx |
Querverweise:
| Ziel |
Bedeutung |
| IS-01 |
zurück zur Inhouse-Service-Übersicht |
| IS-02 |
Servicevorgang wurde dort gestartet |
| IS-04 |
Service bearbeiten |
| IS-05 |
Service abschliessen |
| IS-06 |
Nacharbeit / nicht bestanden |
| IS-07 |
Servicehistorie je Equipment |
| IS-08 |
Korrektur abgeschlossener Service |
| UC01 |
Equipment-Detail und Stammdaten |
| UC05 |
Fristen-Dashboard nutzt Service- und Fristinformationen |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
0.7 |
Leere Überschrift «14. Ä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 |
| 08.05.2026 15:47 |
0.1 |
Initialer Screen-Vorschlag für IS-03 Servicevorgang Detail erstellt |
David Mittig |