Document stage 2 of the setup wizard

Written-by: DeepSeek V4 Pro
Written-by: Claude Fable 5.2
This commit is contained in:
Rsclub2_2 committed 2026-11-18 21:32:14 +01:00
1 parent a24534bbb1
commit 175b6350c2
4 files changed
+36 -9

No files matched your search

+8 -3
View File
@@ -407,9 +407,14 @@ section records only the durable architecture and operational boundaries.
date. From the menu the runtime is torn down first and the same profile restarted 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 (`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 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 template's credentials (`LoginConfiguration`); there is no flag for it in the file. It
asks for name, login, locator, bands and chat category; the reasons and the later stages asks for name, login, locator, bands and chat category, and optionally for antenna and
are in `docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md`. power, log program, rotator and AirScout. A station set up anew gets only what the
operator said yes to: the bundled template has several integrations on, and the wizard
switches them off and says so in its summary. A page that was not shown in a run is not
written, which is what lets "leave the station unchanged" keep a profile with several log
sources as it is. The reasons and the open stage 3 are in
`docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md`.
## Planned Technical Direction ## Planned Technical Direction
@@ -105,6 +105,15 @@ Die Wahl bestimmt, **womit die Schritte vorbelegt sind**, und ob sie im Ablauf e
In allen drei Fällen zeigt die Zusammenfassung die Werte, und von dort lässt sich jeder In allen drei Fällen zeigt die Zusammenfassung die Werte, und von dort lässt sich jeder
Schritt öffnen und ändern. Ein übernommenes Rufzeichen bekommt so sein `/P`. Schritt öffnen und ändern. Ein übernommenes Rufzeichen bekommt so sein `/P`.
Eine Ausnahme hat das Logprogramm. Das Einstellungsfenster erlaubt mehrere Logquellen
zugleich, die Frage des Assistenten nur eine. Hat ein unverändert gelassenes Profil mehr als
eine Quelle eingeschaltet, zeigt die Zusammenfassung das an und lässt die Seite zu: sie
würde beim Öffnen alle Quellen bis auf eine abschalten.
**Geschrieben wird nur, was gezeigt wurde.** Bleibt die Station unverändert und öffnet der
Nutzer weder Antenne noch Logprogramm noch Rotor und AirScout, fasst der Assistent diese
Einstellungen nicht an.
Die **Startwerte des Assistenten** für eine neue Station sind bewusst nicht die der Vorlage: Die **Startwerte des Assistenten** für eine neue Station sind bewusst nicht die der Vorlage:
kein Band gewählt, Locator leer, kein Zweitchat, kein Logprogramm, kein lokaler kein Band gewählt, Locator leer, kein Zweitchat, kein Logprogramm, kein lokaler
DX-Cluster-Server, kein Rotor, kein AirScout. Wer „neu einrichten" wählt, bekommt nur DX-Cluster-Server, kein Rotor, kein AirScout. Wer „neu einrichten" wählt, bekommt nur
@@ -229,8 +238,7 @@ tatsächlichen Anmeldestatus.
Startwerten, die Integrationen abschalten. Startwerten, die Integrationen abschalten.
3. „Von Profil X übernehmen". 3. „Von Profil X übernehmen".
Stufe 1 ist für sich benutzbar; bis Stufe 2 lässt „neu einrichten" die Integrationen auf Stufe 1 und 2 sind umgesetzt. Offen ist Stufe 3.
ihren gespeicherten Werten und sagt das in der Zusammenfassung.
## Unverändert ## Unverändert
+9 -2
View File
@@ -19,7 +19,14 @@ Der Assistent fragt:
1. **Persönliches** – Sprache und Anzeigename im Chat. 1. **Persönliches** – Sprache und Anzeigename im Chat.
2. **Anmeldung** – Rufzeichen und Passwort des ON4KST-Kontos. 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. 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. 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. 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 Anmeldung, Locator, mindestens ein Band und die Chatkategorie stehen, führt **Fertig** direkt zur Zusammenfassung. Die Schritte 4 bis 6 lassen sich also überspringen.
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".
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. 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.
@@ -27,7 +34,7 @@ Hat das Profil schon eine Station (etwa nach dem Duplizieren), fragt die erste S
Ü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. Ü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. 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.
--- ---
+9 -2
View File
@@ -19,7 +19,14 @@ The assistant asks for:
1. **Personal** – language and the name shown in the chat. 1. **Personal** – language and the name shown in the chat.
2. **Login** – callsign and password of the ON4KST account. 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. 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. 4. **Antenna and power** – optional: beam width, antenna gain, antenna height, transmit power and site elevation. These values feed the path analysis; the chat does not need them.
5. **Log program** – none, Win-Test, UCXLog/DXLog.net/N1MM+/QARTEST, or a log file. Port, station name or file appear only after the choice. With a network log program you can also take your own frequency from it and enable the local DX cluster server.
6. **Rotator and AirScout** – one switch each; host, port and identifiers appear only once it is set.
7. **Summary** – nothing is written until you click **Save**. **Save and connect** logs into the chat right afterwards.
As soon as login, locator, at least one band and the chat category are there, **Finish** leads straight to the summary. Steps 4 to 6 can be skipped.
A station that is **set up anew** gets only what was confirmed in the assistant. The bundled template has log synchronisation, frequency takeover, DX cluster server and AirScout enabled; the assistant switches off what was not chosen and names it in the summary under "Will be switched off".
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. 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.
@@ -27,7 +34,7 @@ If the profile already has a station (after duplicating one, for example), the f
**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. **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. If the station is left **unchanged**, the assistant does not touch antenna, log program, rotator and AirScout unless the corresponding page is opened through **Change**. If several log sources are enabled in the profile at once, the "Log program" page cannot be opened: it knows one source only. Such stations are still configured in the settings window.
--- ---