Add a setup assistant for unconfigured profiles (#174)

A profile without a callsign of its own now starts in a setup assistant instead
of the twelve-tab settings window. It asks for name, login, locator, bands and
chat category, and optionally for antenna and power, log program, rotator and
AirScout. Login and station can each be taken from another configured profile.

The assistant runs in startRuntime after the profile is resolved and before the
ChatController exists. It works on a ChatPreferences of its own, writes
preferences.xml, and the runtime then reads that file like any stored setting.
It never touches a running session. From the Options menu the runtime is torn
down first and the same profile restarted with the assistant in front.

A station set up anew gets only what the operator confirmed: the bundled
template has several integrations enabled, and the assistant switches off what
was not chosen and names it in its summary. A station left unchanged is written
page by page, only for pages the operator opened. A taken station is the whole
station, every setter listed in wizard-station-setters.txt; a test fails when a
new ChatPreferences setter is classified in neither list.

Changes outside the assistant:
- ChatPreferences.readPreferencesFromXmlFile() returns false when the file could
  not be read or parsed, or its root element is not praktiKST. It reads on as
  before, and its two existing callers ignore the return value.
- ApplicationRuntimeLauncher.switchProfile refuses a second switch while one is
  in progress.
- The Log synch tab's file chooser takes an optional owner dialog.

The design and its reasons are in
docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md.

Written-by: Claude Fable 5.2
Written-by: DeepSeek V4 Pro
Written-by: Gemini 4 Hydrogen (Antigravity)
Written-by: Codex (GPT-6.2 Sol)
This commit is contained in:
Rsclub2_2 authored and GitHub committed 2026-11-18 23:16:52 +01:00
1 parent b0960a3f04
commit 1dd0139e10
36 files changed
+5768 -25

No files matched your search

+47 -1
View File
@@ -2,7 +2,7 @@
> 🇬🇧 [English version](en-Configuration) | 🇩🇪 Du liest gerade die deutsche Version
Nach dem ersten Start öffnet sich das **Einstellungsfenster** – dieses ist der zentrale Ausgangspunkt für alle Konfigurationen. Es empfiehlt sich, das Einstellungsfenster während des Betriebs geöffnet zu lassen (z. B. um den Beacon schnell ein- und auszuschalten).
Beim ersten Start fragt der **Einrichtungsassistent** das Nötigste ab (siehe unten). Danach öffnet sich das **Einstellungsfenster** – dieses ist der zentrale Ausgangspunkt für alle Konfigurationen. Es empfiehlt sich, das Einstellungsfenster während des Betriebs geöffnet zu lassen (z. B. um den Beacon schnell ein- und auszuschalten).
> **Wichtig**: Änderungen im Einstellungsfenster wirken, sobald **Apply/Close prefs** oder **Save Settings** gedrückt wird; **Connect** übernimmt sie ebenfalls vorher. Wer mit offenen Änderungen das Fenster schließt, das Profil wechselt oder das Programm beendet, wird zuerst gefragt, ob sie übernommen oder verworfen werden sollen, oder kann zurück. Farben, Sprache, die Anmeldedaten im Reiter **Station** und die beiden Beacon-Aktivierungsschalter wirken sofort.
>
@@ -10,6 +10,52 @@ Nach dem ersten Start öffnet sich das **Einstellungsfenster** – dieses ist de
---
## Einrichtungsassistent (ab v1.50)
Solange ein Profil kein eigenes Rufzeichen hat, startet es mit dem Einrichtungsassistenten. Das gilt für die erste Installation und für jedes neu angelegte oder duplizierte Operator-Profil.
Der Assistent fragt:
1. **Persönliches** – Sprache und Anzeigename im Chat.
2. **Anmeldung** – Rufzeichen und Passwort des ON4KST-Kontos.
3. **Standort und Bänder** – Locator, aktive Bänder und Chatkategorie. Die Kategorie wird aus den Bändern vorgeschlagen und lässt sich ändern. Ein zweiter Chat ist freiwillig.
4. **Antenne und Leistung** – freiwillig: Öffnungswinkel, Antennengewinn, Antennenhöhe, Sendeleistung und Standorthöhe. Die Werte speisen die Pfadanalyse; für den Chat braucht sie niemand.
5. **Logprogramm** – keines, Win-Test, UCXLog/DXLog.net/N1MM+/QARTEST oder eine Logdatei. Port, Stationsname oder Datei erscheinen erst nach der Wahl und sind mit den gespeicherten Werten vorbelegt; eine schon eingetragene Logdatei muss also nicht neu gewählt werden. Mit einem Netzwerk-Logprogramm lässt sich außerdem die eigene Frequenz übernehmen und der lokale DX-Cluster-Server einschalten.
6. **Rotor und AirScout** – je ein Schalter; Host, Port und Kennungen erscheinen erst, wenn er gesetzt ist.
7. **Zusammenfassung** – erst **Speichern** schreibt die Einstellungen. **Speichern und verbinden** meldet danach gleich am Chat an.
Sobald die Pflichtangaben gültig sind – Anzeigename, Anmeldung, Locator, mindestens ein Band, die Chatkategorie und bei eingeschaltetem Zweitchat dessen Kategorie –, führt **Fertig** direkt zur Zusammenfassung. Die Schritte 4 bis 6 lassen sich also überspringen. Steht auf einer dieser Seiten schon ein ungültiger Wert, etwa ein Port außerhalb des Bereichs, muss er erst berichtigt werden.
Eine **neu eingerichtete** Station bekommt nur eingeschaltet, was im Assistenten bejaht wurde. Die mitgelieferte Vorlage hat Logabgleich, Frequenzübernahme, DX-Cluster-Server und AirScout an; der Assistent schaltet ab, was nicht gewählt wurde, und nennt es in der Zusammenfassung unter „Wird abgeschaltet".
Gibt es schon ein eingerichtetes Profil oder hat das Profil selbst schon eine Station, fragt die erste Seite getrennt für **Anmeldung** und **Station**, woher die Angaben kommen:
- **neu eingeben** – immer möglich; die Schritte erscheinen, eine neue Station beginnt leer;
- **von einem anderen Profil übernehmen** – nur, wenn es ein anderes Profil mit eigener Anmeldung gibt; die Werte kommen aus dem gewählten Profil;
- **unverändert lassen** – das Profil behält, was es hat. Für die Anmeldung gibt es das nur, wenn das Profil schon eine eigene hat; für die Station immer, solange das Profil nicht mehr die mitgelieferten Anmeldedaten der Vorlage trägt, also nicht bei einer frischen Installation.
Anmeldung und Station werden unabhängig gewählt und können aus verschiedenen Profilen kommen.
Damit sind die üblichen Fälle mit wenigen Klicks erledigt:
| Fall | Anmeldung | Station |
|---|---|---|
| Mehrmannbetrieb, gemeinsames Rufzeichen | übernehmen | übernehmen |
| Mehrmannbetrieb, eigenes Rufzeichen | neu | übernehmen |
| Ein Operator, mehrere Standorte | übernehmen | neu |
Übernommen wird beim Punkt **Station** die ganze Station: Locator, Bänder, das Ausweichband für Spots, Chatkategorien, Antennen- und Pfadanalysewerte, QTF-Vorgabe und größte Entfernung, alle Logquellen, die Frequenzübernahme samt SO2R, der lokale DX-Cluster-Server, Rotoren und AirScout – auch Einzelheiten, die der Assistent nie fragt. Sprache, Anzeigename, Fensteranordnung, Farben, Kurzbefehle und Baken gehören zum Operator und werden nie übernommen, ebenso wenig das Spotter-Rufzeichen des DX-Cluster-Servers. Schaltet das Übernehmen etwas ab, das im eigenen Profil eingeschaltet war, steht es in der Zusammenfassung unter „Wird abgeschaltet".
Übernommene Werte lassen sich in der Zusammenfassung über **Ändern** anpassen, etwa ein `/P` am Rufzeichen. Ändern lässt sich dort, was der Assistent auch fragt; übernommene Einzelheiten wie Rotor 2, SO2R oder die Win-Test-Feineinstellungen ändert man im Einstellungsfenster. Schaltet das Übernehmen SO2R oder Rotor 2 ab, steht auch das unter „Wird abgeschaltet". Die Zusammenfassung zeigt außerdem das Ausweichband für Spots, das mit der Station kommt. Eine Ausnahme: Hat die übernommene Station mehrere Logquellen zugleich eingeschaltet, kommen alle an, die Seite „Logprogramm" lässt sich dann aber nicht öffnen, weil sie nur eine Quelle kennt; solche Änderungen macht man im Einstellungsfenster. Das andere Profil wird nur gelesen und nie verändert. Angeboten werden nur Profile, die selbst eine Anmeldung haben.
**Später** schließt den Assistenten, ohne etwas zu schreiben. Er erscheint beim nächsten Start des Profils wieder, solange das Rufzeichen fehlt.
Über **Options → Einrichtungsassistent...** lässt er sich jederzeit erneut aufrufen. Dabei wird die laufende Sitzung nach einer Rückfrage beendet und das Profil neu gestartet. Für einzelne Änderungen im Betrieb ist das Einstellungsfenster gedacht.
Bleibt die Station **unverändert**, fasst der Assistent Antenne, Logprogramm, Rotor und AirScout nicht an, solange die zugehörige Seite nicht über **Ändern** geöffnet wird. Sind im Profil mehrere Logquellen zugleich eingeschaltet, lässt sich die Seite „Logprogramm" nicht öffnen: sie kennt nur eine Quelle. Solche Stationen stellt man weiter im Einstellungsfenster ein.
---
## Station Settings (Stationseinstellungen)
![Stationseinstellungen](client_settings_window_station.png)