From 85a2984234711359f68d00d510d4833aa98f8559 Mon Sep 17 00:00:00 2001 From: Philipp Wagner Date: Wed, 18 Nov 2026 20:57:21 +0100 Subject: [PATCH] State the wizard's Finish and write rules precisely The manual named too few conditions for Finish, and spec and project context read as if a skipped page of a new station were not written. It is: only a station left unchanged is written page by page. Written-by: Claude Fable 5.2 --- docs/PROJECT_CONTEXT.md | 8 +++++--- .../2026-11-18-einrichtungsassistent-design.md | 16 +++++++++++----- github_docs/de-Konfiguration.md | 4 ++-- github_docs/en-Configuration.md | 4 ++-- 4 files changed, 20 insertions(+), 12 deletions(-) diff --git a/docs/PROJECT_CONTEXT.md b/docs/PROJECT_CONTEXT.md index 454045cc..d5f1b2cd 100644 --- a/docs/PROJECT_CONTEXT.md +++ b/docs/PROJECT_CONTEXT.md @@ -411,9 +411,11 @@ section records only the durable architecture and operational boundaries. asks for name, login, locator, bands and chat category, and optionally for antenna and 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 + switches them off and says so in its summary. That holds for a new + station also when the operator skips those pages with Finish: they are part of the run and + are written with their start values. A station left unchanged is the opposite case: a page + of it is written only if the operator opened it from the summary, which is what lets such a + profile keep several log sources as they are. The reasons and the open stage 3 are in `docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md`. ## Planned Technical Direction diff --git a/docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md b/docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md index 43c5db49..31c4fea4 100644 --- a/docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md +++ b/docs/superpowers/specs/2026-11-18-einrichtungsassistent-design.md @@ -107,12 +107,18 @@ 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. +eine Quelle eingeschaltet, zeigt die Zusammenfassung das an und hält die Seite geschlossen: +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. +**Bei einer unverändert gelassenen Station wird nur geschrieben, was geöffnet wurde.** +Öffnet der Nutzer weder Antenne noch Logprogramm noch Rotor und AirScout, fasst der +Assistent diese Einstellungen nicht an. Die Zusammenfassung zeigt dann, was im Profil steht, +auch wo das Einstellungsfenster mehr erlaubt als die Fragen des Assistenten: einen +DX-Cluster-Server oder eine Frequenzquelle ohne Logquelle. + +Bei einer **neu eingerichteten** Station gehören alle Seiten zum Lauf. Wer sie mit „Fertig" +überspringt, bekommt ihre Startwerte geschrieben: Integrationen aus, Antennenwerte wie +gespeichert. 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 diff --git a/github_docs/de-Konfiguration.md b/github_docs/de-Konfiguration.md index b8129b5b..708acaf6 100644 --- a/github_docs/de-Konfiguration.md +++ b/github_docs/de-Konfiguration.md @@ -20,11 +20,11 @@ Der Assistent fragt: 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. Mit einem Netzwerk-Logprogramm lässt sich außerdem die eigene Frequenz übernehmen und der lokale DX-Cluster-Server einschalten. +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 Anmeldung, Locator, mindestens ein Band und die Chatkategorie stehen, führt **Fertig** direkt zur Zusammenfassung. Die Schritte 4 bis 6 lassen sich also überspringen. +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". diff --git a/github_docs/en-Configuration.md b/github_docs/en-Configuration.md index 354f1dc2..33cfc03c 100644 --- a/github_docs/en-Configuration.md +++ b/github_docs/en-Configuration.md @@ -20,11 +20,11 @@ The assistant asks for: 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. **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. +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 and start from the stored values, so a log file that is already entered need not be chosen again. 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. +As soon as the required entries are valid – name, login, locator, at least one band, the chat category and, with a second chat enabled, its category – **Finish** leads straight to the summary. Steps 4 to 6 can be skipped. If one of those pages already holds an invalid value, such as a port out of range, it has to be corrected first. 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".