UC04 Screen IS-05 – Service abschliessen
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-05 – Service abschliessen
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Ziel des Screens
IS-05 dient dazu, einen offenen oder laufenden Inhouse-Servicevorgang fachlich abzuschliessen.
Der Screen führt den Benutzer durch Ergebnis, Ergebnisdatum, Ergebnisnotiz, optionale Kostenprüfung und nächste Servicefrist. Nach dem Abschluss wird der Vorgang gegen unbemerkte Änderung geschützt. Spätere Änderungen erfolgen nicht direkt, sondern als Korrektur über IS-08.
2. Primäre Aufgaben
| Aufgabe |
Beschreibung |
| Servicevorgang abschliessen |
finaler Abschluss eines offenen oder laufenden Servicevorgangs |
| Ergebnis erfassen |
bestanden, nicht bestanden, Nacharbeit erforderlich, abgebrochen |
| Ergebnisdatum setzen |
Datum des fachlichen Abschlusses |
| Ergebnisnotiz erfassen |
Pflichtnotiz zum Abschluss |
| Kosten prüfen |
optional erfasste Kosten bestätigen oder ergänzen |
| nächste Servicefrist setzen |
automatisch vorschlagen oder manuell setzen |
| Abschluss bestätigen |
Workflow auf abgeschlossen oder passenden Ergebnisstatus setzen |
| Historie schreiben |
Abschluss nachvollziehbar dokumentieren |
| Vorgang sperren |
abgeschlossene Vorgänge gegen stilles Überschreiben schützen |
3. Screen-Aufbau
┌────────────────────────────────────────────────────────────┐
│ Service abschliessen │
│ [Zurück] [Abschluss] │
├────────────────────────────────────────────────────────────┤
│ Service-Kontext: ID, Equipment, Kunde, Status, Frist │
├────────────────────────────────────────────────────────────┤
│ Abschlussdaten │
│ - Ergebnis │
│ - Ergebnisdatum │
│ - Ergebnisnotiz │
├────────────────────────────────────────────────────────────┤
│ Kosten und nächste Frist │
│ - Kostenbetrag / Währung │
│ - nächste Servicefrist │
├────────────────────────────────────────────────────────────┤
│ Abschlussprüfung │
│ [Bestätigung] [Service abschliessen] │
└────────────────────────────────────────────────────────────┘
4. Kopfbereich
| Element |
Funktion |
Seitentitel Service abschliessen |
klare Einordnung des Abschlussprozesses |
| Service-ID |
eindeutige Vorgangskennung |
| Statusbadge |
aktueller Workflowstatus vor Abschluss |
| Zurück-Link |
zurück zu IS-03 oder IS-04 |
Button Abbrechen |
zurück ohne Abschluss |
Button Service abschliessen |
führt finalen Abschluss aus |
5. Abschlussdaten
5.1 Ergebnis
| Ergebnis |
Bedeutung |
Folgewirkung |
passed |
Service erfolgreich abgeschlossen |
Workflow wird abgeschlossen |
failed |
Service nicht bestanden |
kritischer Abschluss, Equipment kann prüfbedürftig bleiben |
rework_required |
Nacharbeit erforderlich |
Wechsel oder Bezug zu IS-06 möglich |
cancelled |
Vorgang abgebrochen |
Workflow wird abgebrochen statt erfolgreich abgeschlossen |
5.2 Ergebnisdatum
| Feld |
Pflicht |
Beschreibung |
| Ergebnisdatum |
Ja |
Datum, an dem der Service fachlich abgeschlossen wurde |
| Uhrzeit |
optional |
kann systemseitig automatisch gesetzt werden |
5.3 Ergebnisnotiz
| Feld |
Pflicht |
Beschreibung |
| Ergebnisnotiz |
Ja |
fachliche Begründung des Ergebnisses |
| interne Zusatznotiz |
optional |
nicht zwingend für V1 |
Regel:
Ein Abschluss ohne Ergebnisdatum und Ergebnisnotiz ist nicht zulässig.
6. Kosten und nächste Frist
6.1 Kosten
| Feld |
Pflicht |
Beschreibung |
| Kostenbetrag |
Nein |
optionaler dokumentierender Kostenbetrag |
| Währung |
Pflicht, wenn Betrag gesetzt |
z. B. CHF oder EUR |
| Kostenbemerkung |
optional |
Hinweis zu Material oder Aufwand |
Hinweis:
UC04 erzeugt in V1 keine Rechnung. Kosten sind nur dokumentierende Serviceinformationen.
6.2 Nächste Servicefrist
| Feld |
Pflicht |
Beschreibung |
| nächste Servicefrist |
Nein / empfohlen |
kann automatisch vorgeschlagen oder manuell gesetzt werden |
| Intervall Monate |
optional |
z. B. 12 Monate bei Atemregler-Service |
| Frist übernehmen |
optional |
bestätigt den vorgeschlagenen Termin |
Regel:
Die nächste Servicefrist darf manuell angepasst werden, muss aber tenant-isoliert gespeichert oder berechnet werden.
7. Abschlussprüfung
Vor dem endgültigen Speichern zeigt IS-05 eine kurze Abschlussprüfung.
| Prüfpunkte |
Bedeutung |
| Ergebnis gesetzt |
Abschluss ist fachlich vollständig |
| Ergebnisdatum gesetzt |
Datum ist nachvollziehbar |
| Ergebnisnotiz gesetzt |
Abschluss ist begründet |
| Kosten plausibel |
keine negativen Beträge, Währung vorhanden |
| nächste Frist geprüft |
optional, aber empfohlen |
| Sperrhinweis bestätigt |
Benutzer versteht, dass spätere Änderungen Korrekturen sind |
8. Validierungsregeln
| ID |
Regel |
| IS05-VR01 |
Benutzer darf nur Servicevorgänge des eigenen Tenants abschliessen |
| IS05-VR02 |
Nur offene, laufende oder Nacharbeitsvorgänge dürfen abgeschlossen werden |
| IS05-VR03 |
Ergebnis ist Pflicht |
| IS05-VR04 |
Ergebnisdatum ist Pflicht |
| IS05-VR05 |
Ergebnisnotiz ist Pflicht |
| IS05-VR06 |
Wenn Kostenbetrag gesetzt ist, muss Währung gesetzt sein |
| IS05-VR07 |
Kostenbetrag darf nicht negativ sein |
| IS05-VR08 |
Abschluss erzeugt einen Historieneintrag |
| IS05-VR09 |
Abgeschlossener Workflow wird gegen stilles Überschreiben geschützt |
| IS05-VR10 |
Bei Ergebnis failed oder rework_required muss ein kritischer Hinweis angezeigt werden |
9. Status- und Folgelogik
| Ergebnis |
Workflowstatus nach Aktion |
Folge |
| bestanden |
completed |
Service abgeschlossen, nächste Frist optional gesetzt |
| nicht bestanden |
completed oder rework_required |
Entscheidung offen, kritische Kennzeichnung nötig |
| Nacharbeit erforderlich |
rework_required |
Wechsel zu IS-06 oder Nacharbeitsstatus |
| abgebrochen |
cancelled |
Vorgang beendet, keine erfolgreiche Servicefrist |
Empfehlung für V1:
passed führt zu completed.rework_required führt zu rework_required und danach zu IS-06.failed sollte nicht still als normal abgeschlossen gelten.cancelled führt zu cancelled.
10. Verhalten bei Sonderfällen
| Fall |
Verhalten |
| Ergebnisnotiz fehlt |
Abschluss blockieren |
| Ergebnisdatum fehlt |
Abschluss blockieren |
| Kosten ungültig |
Abschluss blockieren |
| Vorgang bereits abgeschlossen |
Abschluss blockieren, Hinweis auf IS-08 |
| parallele Änderung erkannt |
Warnung anzeigen, erneutes Laden anbieten |
| offline |
Abschluss lokal vorbereiten, Sync-Status kennzeichnen |
| Nacharbeit erforderlich |
Hinweis auf IS-06 anzeigen |
11. Aktionen
| Aktion |
Rolle |
Beschreibung |
| Service abschliessen |
tenant_admin, mitarbeiter |
speichert Abschluss und Historie |
| Abbrechen |
tenant_admin, mitarbeiter |
zurück zu IS-03 ohne Abschluss |
| Nacharbeit erfassen |
tenant_admin, mitarbeiter |
Wechsel zu IS-06 bei entsprechendem Ergebnis |
| Korrektur starten |
tenant_admin |
später über IS-08 bei abgeschlossenem Vorgang |
12. Leere Zustände und Hinweise
| Zustand |
Meldung |
| Ergebnis fehlt |
„Bitte wähle ein Ergebnis aus.“ |
| Ergebnisdatum fehlt |
„Bitte erfasse das Ergebnisdatum.“ |
| Ergebnisnotiz fehlt |
„Bitte erfasse eine Ergebnisnotiz.“ |
| Sperrhinweis nicht bestätigt |
„Bitte bestätige, dass spätere Änderungen als Korrektur erfolgen.“ |
| Abschluss erfolgreich |
„Servicevorgang wurde abgeschlossen.“ |
| kritisches Ergebnis |
„Dieses Ergebnis benötigt Nacharbeit oder eine fachliche Prüfung.“ |
13. Akzeptanzkriterien
| ID |
Kriterium |
| IS05-AC01 |
Benutzer kann IS-05 aus IS-03 oder IS-04 öffnen |
| IS05-AC02 |
Benutzer sieht Service-ID, Equipment, Kunde und aktuellen Status |
| IS05-AC03 |
Benutzer muss ein Ergebnis auswählen |
| IS05-AC04 |
Benutzer muss ein Ergebnisdatum erfassen |
| IS05-AC05 |
Benutzer muss eine Ergebnisnotiz erfassen |
| IS05-AC06 |
Benutzer kann optionale Kosten prüfen oder ergänzen |
| IS05-AC07 |
Benutzer kann eine nächste Servicefrist setzen oder bestätigen |
| IS05-AC08 |
Abschluss ohne Pflichtfelder wird blockiert |
| IS05-AC09 |
Abschluss erzeugt einen Workflow-Historieneintrag |
| IS05-AC10 |
Abgeschlossener Vorgang wird gegen stilles Überschreiben geschützt |
| IS05-AC11 |
Bei Nacharbeit oder nicht bestanden wird ein kritischer Hinweis angezeigt |
| IS05-AC12 |
Nach Abschluss öffnet das System IS-03 oder IS-07 |
14. Offene UI-Details
| ID |
Frage |
Status |
| IS05-UI1 |
Wird failed als completed mit negativem Ergebnis oder als eigener Status geführt? |
offen |
| IS05-UI2 |
Soll nächste Servicefrist automatisch aus Serviceintervall berechnet werden? |
Empfehlung: automatische Vorbelegung, manuell prüfbar |
| IS05-UI3 |
Soll Abschluss eine zusätzliche Bestätigungsbox benötigen? |
Empfehlung: Ja |
| IS05-UI4 |
Soll nach Abschluss IS-03 oder IS-07 geöffnet werden? |
Vorschlag: IS-03 |
| IS05-UI5 |
Darf mitarbeiter Kosten beim Abschluss ändern? |
offen |
15. Artefakte und Querverweise
| Typ |
Datei |
| Spezifikation |
is-05-service-abschliessen.md |
| Statisches Wireframe |
is-05-service-abschliessen.svg |
| Interaktives Wireframe |
is-05-service-abschliessen.jsx |
Querverweise:
| Ziel |
Bedeutung |
| IS-03 |
Ausgangs- und Rücksprungpunkt |
| IS-04 |
Bearbeitung vor Abschluss |
| IS-06 |
Nacharbeit / nicht bestanden |
| IS-07 |
Servicehistorie je Equipment |
| IS-08 |
spätere Korrektur abgeschlossener Service |
| UC05 |
nächste Servicefrist wirkt ins Fristen-Dashboard |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
0.7 |
Leere Überschrift «16. Ä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 16:03 |
0.1 |
Initialer Screen-Vorschlag für IS-05 Service abschliessen erstellt |
David Mittig |