/// Zustände der Ländererkennungs-/Notrufnummern-Ermittlung
/// (`docs/plan.md`, Abschnitt 5 + 8, AP5).
///
/// Siehe [EmergencyProvider] für die Zustandsübergänge.
enum EmergencyStatus {
  /// [EmergencyProvider.init] wurde gerade gestartet, die Notrufnummern-
  /// Datenbasis wird geladen.
  initializing,

  /// Die Datenbasis ist geladen, die Ländererkennungskette
  /// (SIM → GPS → Cache) läuft gerade.
  locating,

  /// Ermittlung abgeschlossen. `country` ist gesetzt, wenn das ermittelte
  /// Land in der Datenbasis vorhanden ist; ist es `null`, wurde zwar ein
  /// Ländercode ermittelt, aber kein Eintrag dafür gefunden (Plan
  /// Abschnitt 7, "Land nicht in Datenbasis") – die UI zeigt dann nur den
  /// globalen Panik-Button.
  ready,

  /// Aktuell unbenutzt (siehe Doc-Kommentar in [EmergencyProvider]): Die
  /// Standortberechtigung wurde verweigert. Dieser Fall wird zur Laufzeit
  /// bewusst nicht von [countryUnknown] unterschieden, ist als Status aber
  /// für eine spätere, gezieltere UI-Behandlung (z. B. Banner mit
  /// Berechtigungs-Hinweis) bereits vorbereitet.
  permissionDenied,

  /// Kein Ländercode ermittelbar (alle Quellen der Ermittlungskette lieferten
  /// `null`, Plan Abschnitt 7, "Land nicht ermittelbar").
  countryUnknown,

  /// Laden der Notrufnummern-Datenbasis ist fehlgeschlagen (z. B. kaputtes
  /// JSON-Asset). Sollte im Normalbetrieb nicht auftreten, siehe Doc-Kommentar
  /// in `EmergencyNumberRepository.load()`.
  error,
}