UC04 Screen IS-04 – Service bearbeiten
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-04 – Service bearbeiten
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Ziel des Screens
IS-04 dient dazu, einen laufenden oder offenen Inhouse-Servicevorgang fachlich zu bearbeiten.
Der Screen erlaubt die Pflege von Status, verantwortlichem Mitarbeiter, geplantem Datum, Priorität, Bearbeitungsnotizen und optionalen Kosten. IS-04 verändert keinen abgeschlossenen Vorgang direkt; abgeschlossene Vorgänge werden über IS-08 korrigiert.
2. Primäre Aufgaben
| Aufgabe |
Beschreibung |
| Servicevorgang bearbeiten |
zentrale Bearbeitungsmaske für offene und laufende Servicevorgänge |
| Status ändern |
z. B. offen, in Arbeit, wartet, Nacharbeit erforderlich |
| Mitarbeiter zuweisen |
verantwortlichen Bearbeiter setzen oder ändern |
| geplantes Datum anpassen |
Serviceplanung oder Fälligkeitsbezug aktualisieren |
| Priorität setzen |
normal, hoch oder kritisch |
| Bearbeitungsnotiz ergänzen |
neue Notiz append-only ergänzen |
| Kosten erfassen |
optionaler Kostenbetrag mit Währung |
| Änderungen speichern |
Änderungen validieren, speichern und historisieren |
| Abbrechen |
ohne Änderung zurück zu IS-03 |
3. Screen-Aufbau
┌────────────────────────────────────────────────────────────┐
│ Service bearbeiten │
│ [Zurück] [Speichern] │
├────────────────────────────────────────────────────────────┤
│ Service-Kontext: ID, Equipment, Kunde, aktueller Status │
├────────────────────────────────────────────────────────────┤
│ Bearbeitbare Felder │
│ - Status │
│ - Mitarbeiter │
│ - geplantes Datum │
│ - Priorität │
│ - Kosten / Währung │
├────────────────────────────────────────────────────────────┤
│ Neue Bearbeitungsnotiz │
├────────────────────────────────────────────────────────────┤
│ Änderungsvorschau / Validierung │
└────────────────────────────────────────────────────────────┘
4. Kopfbereich
| Element |
Funktion |
Seitentitel Service bearbeiten |
klare Einordnung der Bearbeitungsansicht |
| Service-ID |
eindeutige Vorgangskennung |
| Statusbadge |
aktueller Workflowstatus vor Bearbeitung |
| Zurück-Link |
zurück zu IS-03 |
Button Speichern |
speichert gültige Änderungen und schreibt Historie |
Button Abbrechen |
zurück zu IS-03 ohne Änderung |
5. Bearbeitbare Felder
5.1 Status
| Status |
Bearbeitbar in IS-04 |
Hinweis |
draft |
Ja |
optional, falls Entwurf in V1 erlaubt wird |
open |
Ja |
Standard nach Start |
in_progress |
Ja |
aktive Bearbeitung |
waiting_for_parts |
Ja |
wartet auf Teile oder Rückmeldung |
rework_required |
Ja |
Nacharbeit erforderlich |
completed |
Nein |
Abschluss über IS-05, spätere Korrektur über IS-08 |
cancelled |
eingeschränkt |
falls V1 Abbruch in IS-04 erlaubt wird |
corrected |
Nein |
nur Historie / Korrekturbezug |
5.2 Mitarbeiter und Planung
| Feld |
Pflicht |
Beschreibung |
| verantwortlicher Mitarbeiter |
Nein / empfohlen |
Bearbeiter kann zugewiesen oder geändert werden |
| geplantes Datum |
Nein / empfohlen |
unterstützt Planung und UC05-Fristenbezug |
| Priorität |
Nein |
normal, hoch, kritisch |
5.3 Kosten
| Feld |
Pflicht |
Beschreibung |
| Kostenbetrag |
Nein |
optionaler Kostenhinweis für Servicevorgang |
| Währung |
Pflicht, wenn Betrag gesetzt |
z. B. CHF oder EUR |
| Kostenbemerkung |
optional |
Hinweis zu Material oder Aufwand, ohne Rechnungsfunktion |
Regel:
UC04 erzeugt in V1 keine Rechnung. Kosten sind nur dokumentierende Serviceinformationen.
6. Notizen
IS-04 ergänzt neue Bearbeitungsnotizen. Bestehende Notizen werden angezeigt, aber nicht still überschrieben.
| Notiztyp |
Verhalten |
| bestehende Startnotiz |
anzeigen, nicht direkt überschreiben |
| bestehende Bearbeitungsnotizen |
anzeigen, nicht direkt überschreiben |
| neue Bearbeitungsnotiz |
kann ergänzt werden |
| Ergebnisnotiz |
wird in IS-05 oder IS-06 erfasst |
| Korrekturhinweis |
wird in IS-08 erfasst |
Regel:
Neue Notizen werden nachvollziehbar mit Benutzer und Zeitpunkt ergänzt.
7. Validierungsregeln
| ID |
Regel |
| IS04-VR01 |
Benutzer darf nur Servicevorgänge des eigenen Tenants bearbeiten |
| IS04-VR02 |
Abgeschlossene Vorgänge dürfen nicht direkt in IS-04 geändert werden |
| IS04-VR03 |
Statuswechsel muss fachlich erlaubt sein |
| IS04-VR04 |
Wenn Kostenbetrag gesetzt ist, muss eine Währung gesetzt sein |
| IS04-VR05 |
Kostenbetrag darf nicht negativ sein |
| IS04-VR06 |
Neue Bearbeitungsnotiz darf nicht leer gespeichert werden, wenn nur eine Notizaktion ausgeführt wird |
| IS04-VR07 |
Änderungen müssen historisiert werden |
| IS04-VR08 |
Bei kritischer Priorität sollte eine Notiz empfohlen werden |
8. Änderungshistorie
Beim Speichern erzeugt das System je nach Änderung einen oder mehrere nachvollziehbare Einträge.
| Änderung |
Historieneintrag |
| Status geändert |
alter Status, neuer Status, Benutzer, Zeitpunkt |
| Mitarbeiter geändert |
alter und neuer Bearbeiter |
| Datum geändert |
altes und neues Datum |
| Priorität geändert |
alte und neue Priorität |
| Kosten geändert |
Kostenänderung dokumentieren |
| Notiz ergänzt |
neuer Notizeintrag mit Benutzer und Zeitpunkt |
9. Verhalten bei Sonderfällen
| Fall |
Verhalten |
| Servicevorgang abgeschlossen |
Bearbeitung blockieren, Hinweis auf IS-08 anzeigen |
| Servicevorgang abgebrochen |
Bearbeitung nur eingeschränkt oder blockiert |
| parallele Änderung erkannt |
Warnung anzeigen, erneutes Laden anbieten |
| offline |
lokale Änderung vorbereiten und Sync-Status anzeigen |
| ungültiger Statuswechsel |
Speichern blockieren |
| fehlende Berechtigung |
Aktion ausblenden oder Fehlermeldung anzeigen |
10. Aktionen
| Aktion |
Rolle |
Beschreibung |
| Speichern |
tenant_admin, mitarbeiter |
speichert gültige Änderungen |
| Abbrechen |
tenant_admin, mitarbeiter |
zurück zu IS-03 ohne Änderung |
| Service abschliessen |
tenant_admin, mitarbeiter |
Wechsel zu IS-05 |
| Nacharbeit erfassen |
tenant_admin, mitarbeiter |
Wechsel zu IS-06 |
| Korrektur starten |
tenant_admin |
bei abgeschlossenen Vorgängen Wechsel zu IS-08 |
11. Leere Zustände und Hinweise
| Zustand |
Meldung |
| keine Änderung |
„Es wurden noch keine Änderungen vorgenommen.“ |
| keine neue Notiz |
„Keine neue Bearbeitungsnotiz erfasst.“ |
| abgeschlossen |
„Dieser Servicevorgang ist abgeschlossen. Änderungen sind nur als Korrektur möglich.“ |
| ungültige Kosten |
„Bitte Kostenbetrag und Währung prüfen.“ |
| offline |
„Du arbeitest offline. Änderungen werden später synchronisiert.“ |
12. Akzeptanzkriterien
| ID |
Kriterium |
| IS04-AC01 |
Benutzer kann IS-04 aus IS-03 öffnen, sofern Vorgang bearbeitbar ist |
| IS04-AC02 |
Benutzer sieht Service-ID, Equipment, Kunde und aktuellen Status |
| IS04-AC03 |
Benutzer kann Status ändern, sofern der Statuswechsel erlaubt ist |
| IS04-AC04 |
Benutzer kann verantwortlichen Mitarbeiter ändern |
| IS04-AC05 |
Benutzer kann geplantes Datum ändern |
| IS04-AC06 |
Benutzer kann Priorität setzen |
| IS04-AC07 |
Benutzer kann optional Kostenbetrag und Währung erfassen |
| IS04-AC08 |
Benutzer kann eine neue Bearbeitungsnotiz ergänzen |
| IS04-AC09 |
bestehende Notizen werden nicht still überschrieben |
| IS04-AC10 |
Speichern erzeugt nachvollziehbare Historieneinträge |
| IS04-AC11 |
Abgeschlossene Vorgänge sind in IS-04 nicht direkt bearbeitbar |
| IS04-AC12 |
Abbrechen führt zurück zu IS-03 ohne Änderung |
13. Offene UI-Details
| ID |
Frage |
Status |
| IS04-UI1 |
Soll Kostenbearbeitung für mitarbeiter erlaubt sein? |
offen |
| IS04-UI2 |
Soll Status cancelled in IS-04 oder eigener Abbruchdialog sein? |
offen |
| IS04-UI3 |
Soll jede Statusänderung eine Pflichtnotiz verlangen? |
Vorschlag: nur bei kritisch, Nacharbeit, Abbruch |
| IS04-UI4 |
Soll es eine Änderungsvorschau vor Speichern geben? |
Empfehlung: Ja |
| IS04-UI5 |
Soll der Bearbeiter beim Öffnen automatisch auf den aktuellen Benutzer gesetzt werden? |
offen |
14. Artefakte und Querverweise
| Typ |
Datei |
| Spezifikation |
is-04-service-bearbeiten.md |
| Statisches Wireframe |
is-04-service-bearbeiten.svg |
| Interaktives Wireframe |
is-04-service-bearbeiten.jsx |
Querverweise:
| Ziel |
Bedeutung |
| IS-03 |
Ausgangs- und Rücksprungpunkt |
| IS-05 |
Service abschliessen |
| IS-06 |
Nacharbeit / nicht bestanden |
| IS-08 |
Korrektur abgeschlossener Service |
| UC01 |
Equipment-Kontext |
| UC05 |
geänderte Fristen wirken ins Fristen-Dashboard |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
0.7 |
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.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:51 |
0.1 |
Initialer Screen-Vorschlag für IS-04 Service bearbeiten erstellt |
David Mittig |