Umfassende Anleitung: Modellierung eines Telefonsystem-Steuerungssystems mit UML-Zustandsmaschinen

🎯 Übersicht

Diese Anleitung führt Sie durch die Gestaltung und Modellierung eines Telefonie-Anruf-Steuerungssystem unter Verwendung von UML-Zustandsmaschinen-Diagrammen. Sie konzentriert sich auf die Lebenszyklus ausgehender Anrufe, wobei gezeigt wird, wie eine Telefonleitung aufgrund von Benutzeraktionen und Netzwerkevents zwischen Zuständen wechselt.

Das Diagramm erfasst sowohl die glückliche Pfade (Erfolgreiche Anrufherstellung) als auch die unglückliche Pfade (Fehler, Timeouts, besetzte Leitungen), wobei der Fokus auf Robustheit, Ausnahmehandhabung und klaren Zustandsübergängen liegt – zentrale Prinzipien in Echtzeitkommunikationssystemen.

🧩 Grundkonzepte von UML-Zustandsmaschinen

Bevor Sie in das Diagramm einsteigen, verstehen Sie diese grundlegenden UML-Konzepte:

✅ Pro-Tipp: Verwenden Sie Ereignis [Wächter] / Aktion Syntax in UML, um Auslöser, Bedingungen und Nebenwirkungen zu dokumentieren.

🔄 Lebenszyklus ausgehender Anrufe: Schritt-für-Schritt-Aufschlüsselung

1. Initiierungs- und Wählphase

🔹 Anfänglicher Pseudozustand → Bereitschaft

• Das System startet im Anfänglicher Pseudozustand.
• Noch keine Aktivität; das Telefon befindet sich am Hörer.

🔹 Bereitschaft → Wählton (am Hörer)

• Ereignis: am Hörer (Benutzer hebt den Hörer ab)
• Übergang: am Hörer → Wählton
• Aktion: Wählton erzeugen; Vorbereitung auf Eingabe einer Ziffer.

📌 Dies ist die erste sichtbare Zustandsänderung im Anruflebenszyklus.

🔹 Wählton → Wählen (Ziffer(n))

• Ereignis: Ziffer(n) (Benutzer gibt eine Ziffer ein)
• Übergang: Ziffer(n) → Wählen
• Zustand: Wechseln in Wählen Modus.

🔹 Selbstdurchlauf: Wählen → Wählen (Ziffer(n))

• Ereignis: Ziffer(n) (Mehrere Ziffern eingegeben)
• Bedingung: Keine (immer erlaubt)
• Aktion: Füge Ziffer zur eingegebenen Nummer hinzu.
• Zweck: Erlaube kontinuierliche Eingabe von Ziffern ohne den Wahlvorgang Zustand zu verlassen.

💡 Selbstübergänge sind entscheidend für die Behandlung von Eingabefolgen wie Telefonnummern.

2. Verbindungslogik und Ausnahmehandhabung

🔹 Wahlvorgang → Verbindungsaufbau (gültigeNummer)

• Ereignis: gültigeNummer (vollständige Nummer bestätigt)
• Übergang: gültigeNummer → Verbindungsaufbau
• Aktion: Rufaufbau mit dem Netzwerk initiieren.

🔹 Wahlvorgang → Aufgezeichnete Nachricht (ungültigeNummer)

• Ereignis: ungültigeNummer (z. B. falsche Länge, ungültiger Präfix)
• Übergang: ungültigeNummer → Aufgezeichnete Nachricht
• Aktion: Wiedergabe einer vorab aufgezeichneten Nachricht: „Die von Ihnen gewählte Nummer ist nicht im Dienst.“

🔹 Verbindungsaufbau → Besetztton (NummerBesetzt)

• Ereignis: NummerBesetzt
• Übergang: NummerBesetzt → Besetztton
• Aktion: Besetztton abspielen; Benutzer informieren, dass die Leitung belegt ist.

🔹 Verbindungsaufbau → Schneller Besetztton (LeitungBelegt)

• Ereignis: LeitungBelegt
• Übergang: LeitungBelegt → Schneller Besetztton
• Aktion: Schnellen Besetztton abspielen; Netzüberlastung anzeigen.

⚠️ Hinweis: Dies sind Fehlerzustände die den normalen Ablauf unterbrechen. Sie müssen ordnungsgemäß behandelt werden.

3. Timeout- und Warnmechanismus

🔹 Wählen → Warnung (Timeout)

• Ereignis: Timeout nach 30 Sekunden Inaktivität
• Übergang: Timeout → Warnung
• Aktion: Warnsignal abspielen; Benutzer informieren, weiterzumachen oder aufzulegen.

🔹 Warnung → Timeout (Timeout)

• Ereignis: Timeout nochmals nach 10 Sekunden
• Übergang: timeout → Timeout
• Aktion: Rufversuch abbrechen; zurück zu Wartezustand.

⏱️ Die Timeout-Logik verhindert ein unendliches Warten und verbessert die Benutzererfahrung.

4. Aktueller Anruf und Trennung

🔹 Verbindung herstellen → Klingeln (weitergeleitet)

• Ereignis: weitergeleitet (Netzwerk leitet den Anruf erfolgreich weiter)
• Übergang: weitergeleitet → Klingeln
• Aktion: Senden des Klingelsignals an die angerufene Partei.

🔹 Klingeln → Verbunden (angerufene Partei antwortet)

• Ereignis: angerufene Partei antwortet
• Übergang: angerufene Partei antwortet → Verbunden
• Aktion: Audioverbindung herstellen; Aufnahme des Anrufs starten (falls aktiviert).

🔹 Verbunden → Getrennt (auflegen ODER angerufene Partei legt auf)

• Zwei Wege zur Trennung:
  1. Benutzer legt auf: auflegen → Getrennt
  2. Andere Partei legt auf: calledPhoneHangsUp → Getrennt

🔄 Beide Übergänge führen zu Getrennt bevor erreicht wird Endzustand.

🔹 Getrennt → Endzustand

• Ereignis: Kein (implizit oder über Aktion zur Bereinigung)
• Übergang: Getrennt → End
• Aktion: Räume Ressourcen auf, protokolliere Anrufdauer, aktualisiere Statistiken.

✅ Der Endzustand markiert das Ende des Anruflebenszyklus.

🎨 Visuelle Gestaltungsprinzipien für Klarheit

Um komplexe Zustandsmaschinen lesbar und wartbar zu machen:

🔧 Erweiterte Modellierungstechniken

✅ Zusammengesetzter Zustand: Gruppierung „Fehler“

Statt die Auflistung von Besetztton, Schneller Besetztton, und Aufgezeichnete Nachricht als separate Zustände aufzulisten, gruppieren Sie sie unter einem zusammengesetzten Zustand namens Fehler:

[Fehler] 
├── Besetztton
├── Schneller Besetztton
└── Aufgezeichnete Nachricht

• Eintrittsaktion: Spielt einen Fehlerton oder eine Fehlermeldung ab.
• Austrittsaktion: Zurück zu Wähltone oder Ruhestatus nach der Benutzerantwort.

✅ Vorteil:Verringert visuelle Unübersichtlichkeit und verbessert die Skalierbarkeit.

✅ Wächterbedingungen (optionale Verbesserungen)

Fügen Sie Wächter hinzu, um Übergänge zu verfeinern:

digit(n) [number.length < 15] → Wählen

validNumber [number.isInternational] → Verbinden

🛠️ Wächter verhindern ungültige Übergänge und unterstützen bedingte Logik.

📌 Wichtige Erkenntnisse: Best Practices für komplexe Zustandsmaschinen

💻 Codegenerierung: PlantUML & Mermaid

Hier sindfertige Codeblöckeum dieses Diagramm in Ihrem bevorzugten Format zu generieren.

✅ PlantUML-Code

@startuml

[*] --> Idle
Idle --> DialTone : aufgelegt
DialTone --> Dialing : Ziffer(n)
Dialing --> Dialing : Ziffer(n) ' Selbstübergang
Dialing --> Connecting : gültigeNummer
Dialing --> RecordedMessage : ungültigeNummer
Dialing --> Warning : Timeout
Warning --> Timeout : Timeout
Connecting --> Ringing : weitergeleitet
Connecting --> BusyTone : NummerBesetzt
Connecting --> FastBusyTone : TrunkBesetzt
Ringing --> Connected : angerufenesTelefonantwortet
Connected --> Disconnected : aufgelegt
Connected --> Disconnected : angerufenesTelefonlegteauf
Disconnected --> [*] : Bereinigung

state "Fehler" as ErrorState {
state "Besetztton" as BusyTone
state "SchnellBesetztton" as FastBusyTone
state "AufgezeichneteNachricht" as RecordedMessage
}

' Interne Aktionen
Idle : entry / Warten auf Abheben
DialTone : entry / Wählen-Ton abspielen
Dialing : entry / Ziffern sammeln
Connecting : entry / Anruf weiterleiten
Ringing : entry / Ferngerät klingeln lassen
Connected : entry / Anrufsession aufbauen
Disconnected : entry / Session beenden

@enduml

📥 Wie man verwendet: Einfügen in PlantUML Live oder Ihre IDE-Erweiterung.

✅ Mermaid-Code

stateDiagram-v2
    [*] --> Idle
    Idle --> DialTone : onHook

    DialTone --> Dialing : digit(n)
    Dialing --> Dialing : digit(n)  ' Selbstübergang
    Dialing --> Connecting : validNumber
    Dialing --> RecordedMessage : invalidNumber
    Dialing --> Warning : timeout

    Warning --> Timeout : timeout

    Connecting --> Ringing : routed
    Connecting --> BusyTone : numberBusy
    Connecting --> FastBusyTone : trunkBusy

    Ringing --> Connected : calledPhoneAnswers
    Connected --> Disconnected : onHook
    Connected --> Disconnected : calledPhoneHangsUp

    Disconnected --> [*] : cleanup

    state Error {
        BusyTone
        FastBusyTone
        RecordedMessage
    }

    Connecting --> BusyTone : numberBusy
    Connecting --> FastBusyTone : trunkBusy
    Dialing --> RecordedMessage : invalidNumber

    note right of BusyTone
        Standard-Besetztton abspielen
    end note

    note right of FastBusyTone
        Schnellen Besetztton abspielen (Netzüberlastung)
    end note

    note right of RecordedMessage
        Aufgezeichnete Nachricht abspielen: "Die Nummer ist nicht im Service."
    end note

    note right of Timeout
        Anrufversuch nach 40 Sekunden abgebrochen
    end note

📥 So verwenden Sie es: Einfügen in Mermaid Live Editor oder unterstützte Markdown-Tools (VS Code, Obsidian usw.).

📚 Zusammenfassung und abschließende Gedanken

Dieses Telefonie-Anrufsteuerungssystem Zustandsmaschine ist ein realer Anwendungsfall davon, wie UML komplexe, ereignisgesteuerte Systeme mit hoher Zuverlässigkeit modellieren kann.

✅ Was diesen Diagramm effektiv macht:

• Klare glücklicher Pfad mit logischem Ablauf.
• Umfassende Fehlerbehandlung.
• Verwendung von Selbstübergänge, zusammengesetzte Zustände, und Wächter.
• Visuelle Klarheit durch Gruppierung und Anmerkung.

🛠️ Wann sollte dieses Muster verwendet werden:

• Telefoniesysteme
• IoT-Gerätesteuerung
• Benutzersitzungsverwaltung
• Workflowsysteme
• Eingebettete Systeme mit endlichem Zustandslogik

📝 Möchten Sie dies erweitern?

Berücksichtigen Sie Folgendes:

• Anrufaufzeichnung Zustand (mit startAufzeichnung, stopAufzeichnung Ereignisse)
• Anrufumleitung Logik (bedingte Routing)
• Anrufwarteschleife Unterstützung (parallele Zustände)
• Anrufweiterleitung als Unterzustand von Verbunden
• Zustandsverlauf (oberflächlich/tiefes Verlauf) für die Wiederaufnahme nach Unterbrechung

📌 Endgültige Empfehlung

Modellieren Sie immer sowohl die Erfolgspfade als auch die Fehlervorgänge.
Eine Zustandsmaschine, die nur die „glücklichen Pfade“ behandelt, ist unvollständig und in der Produktion anfällig für Fehler.

Verwenden Sie diese Anleitung als Vorlage zur Modellierung jedes Echtzeit-Systems, bei dem Zustandsübergänge, Ereignisse, und Fehlerrobustheit wichtig sind.

✅ Bereit zum Generieren, Visualisieren oder Erweitern?
👉 Kopieren Sie den PlantUML oder Mermaid Code oben und integrieren Sie ihn in Ihre Dokumentation, Architekturdiagramme oder Systemdesigndokumente.

Lassen Sie mich wissen, wenn Sie eine PDF-Version, interaktives Diagramm, oder Integration in ein größeres Systemmodell (z. B. mit Komponenten- oder Ablaufdiagrammen)!

📘 „Die besten Systeme sind nicht nur korrekt – sie antizipieren Fehler.“
— Entwerfen mit UML-Zustandsmaschinen