mirror of
https://github.com/praktimarc/kst4contest.git
synced 2026-11-19 01:52:29 +01:00
Document the setup wizard
Written-by: Gemini 4 Hydrogen (Antigravity) Written-by: Claude Fable 5.2
This commit is contained in:
5 files changed
+56
-4
No files matched your search
@@ -460,7 +460,7 @@ column.score=Wertung
|
|||||||
monitor.title=Cluster & Fremd-QSOs
|
monitor.title=Cluster & Fremd-QSOs
|
||||||
monitor.dxCluster=DX-Cluster
|
monitor.dxCluster=DX-Cluster
|
||||||
profiles.createFailed=Das Profil konnte nicht angelegt werden. Die Profilliste konnte nicht geschrieben werden.
|
profiles.createFailed=Das Profil konnte nicht angelegt werden. Die Profilliste konnte nicht geschrieben werden.
|
||||||
profiles.createdWithoutCredentials=Das Profil „{0}" wurde ohne Rufzeichen und Passwort angelegt. Nach dem Wechsel zu diesem Profil beides im Reiter „Station" eintragen.
|
profiles.createdWithoutCredentials=Das Profil „{0}" wurde ohne Rufzeichen und Passwort angelegt. Nach dem Wechsel zu diesem Profil fragt der Einrichtungsassistent beides ab.
|
||||||
profiles.duplicateFailed=Das Profil konnte nicht dupliziert werden.
|
profiles.duplicateFailed=Das Profil konnte nicht dupliziert werden.
|
||||||
profiles.rootNotDeletable=Das Standardprofil verwendet die Dateien der Installation selbst und kann nicht gelöscht werden.
|
profiles.rootNotDeletable=Das Standardprofil verwendet die Dateien der Installation selbst und kann nicht gelöscht werden.
|
||||||
profiles.activeNotDeletable=Das gerade benutzte Profil kann nicht gelöscht werden. Zuerst zu einem anderen Profil wechseln.
|
profiles.activeNotDeletable=Das gerade benutzte Profil kann nicht gelöscht werden. Zuerst zu einem anderen Profil wechseln.
|
||||||
|
|||||||
@@ -469,7 +469,7 @@ column.score=Score
|
|||||||
monitor.title=Cluster & QSO of the other
|
monitor.title=Cluster & QSO of the other
|
||||||
monitor.dxCluster=DX cluster
|
monitor.dxCluster=DX cluster
|
||||||
profiles.createFailed=The profile could not be created. The profile registry could not be written.
|
profiles.createFailed=The profile could not be created. The profile registry could not be written.
|
||||||
profiles.createdWithoutCredentials=The profile "{0}" was created without callsign and password. Enter them on the Station tab after switching to it.
|
profiles.createdWithoutCredentials=The profile "{0}" was created without callsign and password. After switching to it, the setup assistant asks for both.
|
||||||
profiles.duplicateFailed=The profile could not be duplicated.
|
profiles.duplicateFailed=The profile could not be duplicated.
|
||||||
profiles.rootNotDeletable=The default profile uses the files of the installation itself and cannot be deleted.
|
profiles.rootNotDeletable=The default profile uses the files of the installation itself and cannot be deleted.
|
||||||
profiles.activeNotDeletable=The profile currently in use cannot be deleted. Switch to another profile first.
|
profiles.activeNotDeletable=The profile currently in use cannot be deleted. Switch to another profile first.
|
||||||
|
|||||||
@@ -400,6 +400,16 @@ section records only the durable architecture and operational boundaries.
|
|||||||
- The station map is a Compose canvas that fetches its own tiles. The JavaFX WebView, the bundled Leaflet resources, the CSS-3D-transform workaround and the `TileProxyServer` were removed with JavaFX; offline DEM, terrain packages and the profile cache are unaffected and must stay that way.
|
- The station map is a Compose canvas that fetches its own tiles. The JavaFX WebView, the bundled Leaflet resources, the CSS-3D-transform workaround and the `TileProxyServer` were removed with JavaFX; offline DEM, terrain packages and the profile cache are unaffected and must stay that way.
|
||||||
- Deliberate test data, comments and Easter eggs are preserved unless explicitly changed.
|
- Deliberate test data, comments and Easter eggs are preserved unless explicitly changed.
|
||||||
- Chat frames (issue #105, second slice): CH (live) and CR (history) go through one `MessageBusManagementThread.processChatFrame(fields, live)`. `classifyRoute` and `decideChatFrameEffects` are pure; history frames never play sounds, answer or spot, and keep their frequency extraction after publishing. Known oddities kept on purpose: TO_ME is case-sensitive, FROM_ME case-insensitive; the CR SERVER sender has no AirScout info.
|
- Chat frames (issue #105, second slice): CH (live) and CR (history) go through one `MessageBusManagementThread.processChatFrame(fields, live)`. `classifyRoute` and `decideChatFrameEffects` are pure; history frames never play sounds, answer or spot, and keep their frequency extraction after publishing. Known oddities kept on purpose: TO_ME is case-sensitive, FROM_ME case-insensitive; the CR SERVER sender has no AirScout info.
|
||||||
|
- **The setup wizard writes `preferences.xml` and does not touch a running session.** It runs
|
||||||
|
in `startRuntime` after the profile is resolved and before the `ChatController` exists, on
|
||||||
|
a `ChatPreferences` of its own, so what it stores is read like any stored setting. That is
|
||||||
|
why it needs neither `SettingsDraft` nor the tab states: there is no session to bring up to
|
||||||
|
date. From the menu the runtime is torn down first and the same profile restarted
|
||||||
|
(`ApplicationRuntimeLauncher.rerunSetupWizard`), which costs the session and asks first. A
|
||||||
|
profile counts as unconfigured when its callsign is empty or it still carries the bundled
|
||||||
|
template's credentials (`LoginConfiguration`); there is no flag for it in the file. Stage 1
|
||||||
|
asks for name, login, locator, bands and chat category; the reasons and the later stages
|
||||||
|
are in `docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md`.
|
||||||
|
|
||||||
## Planned Technical Direction
|
## Planned Technical Direction
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> 🇬🇧 [English version](en-Configuration) | 🇩🇪 Du liest gerade die deutsche Version
|
> 🇬🇧 [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.
|
> **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,27 @@ 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. **Zusammenfassung** – erst **Speichern** schreibt die Einstellungen. **Speichern und verbinden** meldet danach gleich am Chat an.
|
||||||
|
|
||||||
|
Hat das Profil schon eine Station (etwa nach dem Duplizieren), fragt die erste Seite, ob sie **unverändert** bleiben oder **neu eingerichtet** werden soll. So braucht ein weiterer Operator an derselben Station nur Namen und Anmeldung einzutragen.
|
||||||
|
|
||||||
|
**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.
|
||||||
|
|
||||||
|
Logprogramm, Rotor, AirScout und DX-Cluster-Server fragt der Assistent noch nicht ab; sie behalten ihre Werte und werden wie bisher im Einstellungsfenster eingestellt.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Station Settings (Stationseinstellungen)
|
## Station Settings (Stationseinstellungen)
|
||||||
|
|
||||||

|

|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Konfiguration)
|
> 🇬🇧 You are reading the English version | 🇩🇪 [Deutsche Version](de-Konfiguration)
|
||||||
|
|
||||||
After the first start, the **settings window** opens – this is the central starting point for all configuration. It is recommended to keep the settings window open during operation (e.g. to quickly toggle the beacon on and off).
|
On the first start, the **setup assistant** asks for the essentials (see below). After that the **settings window** opens – this is the central starting point for all configuration. It is recommended to keep the settings window open during operation (e.g. to quickly toggle the beacon on and off).
|
||||||
|
|
||||||
> **Important**: Changes in the settings window take effect when you click **Apply/Close prefs** or **Save Settings**; **Connect** applies them first as well. Closing the window, switching the operator profile or exiting with changes pending first asks whether to apply or discard them, or to go back. Colours, the language, the login data on the **Station** tab and both beacon enable settings take effect immediately.
|
> **Important**: Changes in the settings window take effect when you click **Apply/Close prefs** or **Save Settings**; **Connect** applies them first as well. Closing the window, switching the operator profile or exiting with changes pending first asks whether to apply or discard them, or to go back. Colours, the language, the login data on the **Station** tab and both beacon enable settings take effect immediately.
|
||||||
>
|
>
|
||||||
@@ -10,6 +10,27 @@ After the first start, the **settings window** opens – this is the central sta
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Setup Assistant (since v1.50)
|
||||||
|
|
||||||
|
As long as a profile has no callsign of its own, it starts with the setup assistant. This applies to the first installation and to every newly created or duplicated operator profile.
|
||||||
|
|
||||||
|
The assistant asks for:
|
||||||
|
|
||||||
|
1. **Personal** – language and the name shown in the chat.
|
||||||
|
2. **Login** – callsign and password of the ON4KST account.
|
||||||
|
3. **Location and bands** – locator, active bands and chat category. The category is suggested from the bands and can be changed. A second chat is optional.
|
||||||
|
4. **Summary** – nothing is written until you click **Save**. **Save and connect** logs into the chat right afterwards.
|
||||||
|
|
||||||
|
If the profile already has a station (after duplicating one, for example), the first page asks whether to leave it **unchanged** or to **set it up anew**. A further operator at the same station then only enters a name and a login.
|
||||||
|
|
||||||
|
**Later** closes the assistant without writing anything. It appears again on the next start of the profile as long as the callsign is missing.
|
||||||
|
|
||||||
|
**Options → Setup assistant...** opens it again at any time. This ends the running session after a confirmation and restarts the profile. Use the settings window for single changes during operation.
|
||||||
|
|
||||||
|
The assistant does not ask about log program, rotator, AirScout and DX cluster server yet; they keep their values and are configured in the settings window as before.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Station Settings
|
## Station Settings
|
||||||
|
|
||||||

|

|
||||||
|
|||||||
Reference in new issue
Block a user