mirror of
https://github.com/praktimarc/kst4contest.git
synced 2026-11-16 17:02:27 +01:00
Harden beacon sessions and mark automatic messages
This commit is contained in:
1 parent
19bcdb428d
commit
f13fe54fde
63 files changed
+1905
-252
No files matched your search
@@ -0,0 +1,128 @@
|
||||
# Beacon Session Safety Design
|
||||
|
||||
Freigegeben von Marc am 2026-11-11.
|
||||
|
||||
## Ziel
|
||||
|
||||
Die Beacon-Funktion darf nach einem Programmstart oder Profilwechsel nicht aus einer
|
||||
gespeicherten Aktivierung weiterlaufen. Jeder Beacon wird in der laufenden Sitzung bewusst
|
||||
eingeschaltet, hält seine eigene Kategorie-QRG als Referenz fest und schaltet nur bei einer
|
||||
automatisch von UCXLog oder Win-Test gemeldeten Abweichung von mehr als 5 kHz ab.
|
||||
|
||||
Der zusammengefasste `MyBeacon`-Chip macht Aktivierung, Teilaktivierung, automatische
|
||||
Abschaltung und Versandfehler ohne Umweg über das Einstellungsfenster erkennbar.
|
||||
|
||||
## Verbindliches Verhalten
|
||||
|
||||
### Intervall und Sitzung
|
||||
|
||||
- Das kleinste zulässige gemeinsame Beacon-Intervall beträgt fünf Minuten.
|
||||
- Genau fünf Minuten sind zulässig. Kleinere geladene Werte werden im Speicher auf fünf
|
||||
Minuten normalisiert; die mitgelieferte Konfiguration verwendet für beide Kategorien fünf.
|
||||
- Nach jedem Programmstart und Profilwechsel sind beide Beacons ausgeschaltet.
|
||||
- Ein Disconnect oder Reconnect innerhalb derselben Programmsitzung verändert ihre
|
||||
Aktivierung nicht.
|
||||
- Die Aktivierungsflags werden nicht aus XML gelesen. Die vorhandenen XML-Elemente bleiben
|
||||
für die Dateikompatibilität erhalten, werden aber immer mit `false` geschrieben.
|
||||
|
||||
### Aktivierung und benötigte QRG-Werte
|
||||
|
||||
- `MYQRG` und `MYQRGSHORT` benötigen eine gültige Haupt-QRG.
|
||||
- `SECONDQRG` benötigt eine gültige zweite QRG.
|
||||
- Diese Voraussetzung gilt unabhängig davon, in welchem der beiden Bakentexte die Variable
|
||||
vorkommt.
|
||||
- Fehlt ein benötigter Wert oder ist er ungültig, bleibt der betroffene Beacon aus. Sein
|
||||
kategorieweiser Status nennt die fehlende oder ungültige QRG als Grund.
|
||||
- Der gemeinsame Chip aktiviert beide nutzbaren Kategorien unabhängig. Ein gültiger Beacon
|
||||
wird eingeschaltet, auch wenn der andere abgelehnt wird; der Chip zeigt dann `1/2`.
|
||||
- Ein Text ohne QRG-Platzhalter darf ohne bekannte QRG aktiviert werden.
|
||||
- Geprüft wird der bereits angewendete Text, nicht ein noch offener Settings-Entwurf.
|
||||
|
||||
### Kategoriebezogene Referenz-QRG
|
||||
|
||||
- Beim Einschalten übernimmt jeder Beacon die aktuell gültige QRG seiner eigenen Kategorie
|
||||
als Referenz.
|
||||
- Ist keine gültige Kategorie-QRG vorhanden und benötigt der Text sie nicht, wird die erste
|
||||
später gültige manuelle oder externe QRG zur Referenz.
|
||||
- Eine gültige manuelle QRG-Eingabe ist eine bewusste Operatorentscheidung. Sie deaktiviert
|
||||
keinen Beacon und verschiebt die Referenz der zugehörigen Kategorie.
|
||||
- Eine ungültige manuelle Eingabe deaktiviert jeden aktiven Beacon, dessen angewendeter Text
|
||||
den betroffenen QRG-Wert benötigt. Benötigt sein Text ihn nicht, bleibt der Beacon aktiv;
|
||||
nur die Referenz seiner Kategorie wird gelöscht.
|
||||
- Ausschließlich QRG-Übernahmen von UCXLog `RadioInfo` und Win-Test `STATUS`, für die der
|
||||
bestehende QRG-Abgleich aktiv ist, dürfen automatisch abschalten.
|
||||
- Der Vergleich erfolgt in ganzzahligen Hz gegen die aktuelle Referenz. Genau 5.000 Hz sind
|
||||
zulässig; erst eine größere Abweichung schaltet ab.
|
||||
- Ohne Referenz setzt die erste externe QRG nur die Referenz und schaltet nicht ab.
|
||||
- Ohne SO2R betrifft eine externe Änderung von `MYQRG` ausschließlich die Hauptbake. Mit
|
||||
SO2R folgt Radio 1 `MYQRG` und Radio 2 `SECONDQRG`.
|
||||
|
||||
### Status und Tooltip
|
||||
|
||||
- Der Status wird als strukturierter Snapshot aus `core` geliefert. Übersetzte Anzeigetexte
|
||||
entstehen ausschließlich in `app-desktop`.
|
||||
- Der Snapshot kennt `OFF`, `PARTIAL`, `ON` und `FAILED` sowie den Zustand beider Kategorien.
|
||||
- Der Tooltip zeigt je Kategorie den aktuellen Zustand oder letzten Abschalt-/Ablehnungsgrund:
|
||||
noch nicht in dieser Sitzung aktiviert, durch den Benutzer ausgeschaltet, fehlende oder
|
||||
ungültige Haupt-QRG, fehlende oder ungültige zweite QRG oder automatische QRG-Abweichung
|
||||
von mehr als 5 kHz.
|
||||
- Der QRG-Grund nennt keine konkreten Frequenzen.
|
||||
- Timeraktivität überschreibt den kategorieweisen Grund nicht.
|
||||
- Ein erfolgreicher späterer Lauf löscht einen früheren Versandfehler der Kategorie.
|
||||
|
||||
### Verkehrsfarben des `MyBeacon`-Chips
|
||||
|
||||
- `on` und `1/2`: Hintergrund `#238636`, Rand `#56D364`, weiße Schrift.
|
||||
- Der bestehende 200-ms-Aktivitätsblitz verwendet Hintergrund `#FFB300`, Rand `#FFE082`
|
||||
und Schrift `#1B1B1B`.
|
||||
- `off`: neutraler Theme-Hintergrund mit `#D50000` im hellen beziehungsweise `#FF6B6B` im
|
||||
dunklen Design.
|
||||
- `FAILED`: dauerhaft `#D50000` mit Rand `#FF6B6B` und weißer Schrift.
|
||||
- `FAILED` unterdrückt den orangefarbenen Aktivitätsblitz.
|
||||
- Andere Status-Chips behalten ihr heutiges Theme-Verhalten.
|
||||
|
||||
## Technischer Ansatz
|
||||
|
||||
Eine controllerseitige `BeaconSessionState`-Komponente koordiniert den Zustand beider
|
||||
Kategorien. Die beobachtbaren Flags in `ChatPreferences` bleiben kompatible UI-Projektion,
|
||||
aber kein persistenter Produktzustand. Die Komponente verwaltet Referenzen, kategorieweise
|
||||
Gründe und Versandfehler und ist der einzige Produktionsschreibpfad der Aktivierungsflags.
|
||||
|
||||
Manuelle QRG-Eingaben und externe Logger-Meldungen verwenden getrennte Controller-Einstiege.
|
||||
UCXLog und Win-Test übergeben die bereits ermittelte Kategorie, den formatierten Anzeigewert
|
||||
und die genaue Frequenz in Hz innerhalb der bestehenden `UiDispatcher`-Grenze. Damit ist die
|
||||
Herkunft explizit; Listener, Thread-lokale Markierungen oder erratene Ursprünge sind unnötig.
|
||||
|
||||
Der vorhandene `BeaconTask` bleibt für Auflösung, Validierung und Einreihung in die reguläre
|
||||
TX-Warteschlange verantwortlich. Er meldet je Kategorie Erfolg oder Fehler an den
|
||||
Sitzungszustand zurück. Ein DTO im gemeinsamen Model transportiert den strukturierten Status
|
||||
über den bestehenden Threadstatus-Kanal; Compose übersetzt Gründe und wählt die Chipfarben.
|
||||
|
||||
## Unveränderte Grenzen
|
||||
|
||||
- Beide Kategorien teilen einen Timer und besitzen getrennte Aktivierung und Texte.
|
||||
- Der zweite Versand setzt weiterhin eine verfügbare zweite Chatkategorie voraus.
|
||||
- Aktivieren sendet nicht sofort und startet den Timer nicht neu.
|
||||
- Der erste Timerlauf nach dem Verbindungsaufbau bleibt bei ungefähr zehn Sekunden.
|
||||
- Nachrichtenauflösung, Längenlimit, TX-Warteschlange und ON4KST-Framing bleiben unverändert.
|
||||
- Die Chip-Texte `off`, `1/2`, `on` und `FAILED` und seine gemeinsame Klickfunktion bleiben.
|
||||
- Es gibt keine neue Produktionsabhängigkeit, kein neues persistentes Schema und keine
|
||||
Änderung eines externen Protokolls.
|
||||
|
||||
## Berücksichtigte Ansätze
|
||||
|
||||
1. **Gewählt:** controllerseitiger Sitzungszustand mit expliziten manuellen und externen
|
||||
Ereignissen. Das hält Policy, Referenzen und Gründe zusammen und bleibt testbar.
|
||||
2. **Verworfen:** Flags in Preferences, Referenzen in einem Guard und Gründe in `BeaconStatus`.
|
||||
Der zusammengehörige Zustand wäre auf mehrere Besitzer verteilt.
|
||||
3. **Verworfen:** Beobachtung der QRG-Werte mit temporärer Herkunftsmarkierung. `MutableValue`
|
||||
trägt keine Quelle; die asynchrone UI-Weitergabe machte diesen Ansatz fragil.
|
||||
|
||||
## Dokumentationswirkung
|
||||
|
||||
Die Änderung ist benutzerseitig sichtbar, betrifft Laufzeit/Persistenz sowie die bestehende
|
||||
UCXLog-/Win-Test-Integration. Geprüft und bei Bedarf angepasst werden die relevanten
|
||||
deutschen und englischen Konfigurations-, Workflow-, Variablen-, Funktions- und
|
||||
Benutzeroberflächenabschnitte, Changelog, Website-Texte, `docs/PROJECT_CONTEXT.md` und der
|
||||
ältere Live-Beacon-Entwurf. README und verbundene Projekte sind voraussichtlich nicht
|
||||
betroffen.
|
||||
Reference in new issue
Block a user