docs: Entscheid 6 — Faehigkeiten statt Modus-Name, und ein Setup das fragt
Ampel / ampel (push) Failing after 54s

Beide Befunde des Commanders vom 28.08.2026 festgehalten, mitsamt der
Begruendung, warum ein 'if (windows)' an dreissig Stellen die falsche
Reparatur gewesen waere: Die Oberflaeche haette weiterhin nichts ueber ihren
Betrieb gewusst, nur eine zweite Sorte Vermutung gehabt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Hitonabi
2026-08-28 13:56:41 +02:00
co-authored by Claude Opus 5
parent a4a045f303
commit b47d21510d
2 changed files with 62 additions and 0 deletions
+54
View File
@@ -1362,8 +1362,62 @@ Black-Box-Trennung aus `KONZEPT.md` § 6. Beides bleibt gültig.
`vendor/`-Ordner für MakeMKV auf der VM. Ein Binärblob in git wäre bei jedem
Klon dabei und bei jedem Update ein zweites Mal.
### Entscheid 6 — Die Oberfläche kennt ihren Betrieb, und das Setup fragt
Zwei Befunde des Commanders am 28.08.2026, beide am selben Punkt:
> „Du hast ja quasi nur rippy genommen und die docker installation für Windows
> gebaut. […] Das gilt für die ganze standalone version für Windows, auch für
> die settings und die Anleitung usw."
> „Dann hätte ich beim Setup' auch erwartet das nen echtes setup passiert —
> wo will ich das hinspeichern, nen pre requirement check usw. Da kommt
> garnichts Rippy geht einfach auf."
#### 6a — Fähigkeiten statt Modus-Name
Im Windows-Fenster stand `Worker erreichbar: 0 von 1`, `Container-Platte:
unbekannt` und `Prüfen: docker compose ps`. Kein Satz davon ergibt dort einen
Sinn.
Die naheliegende Reparatur wäre ein `if (windows)` an dreißig Stellen gewesen
— dieselbe Falle noch einmal, nur mit einer zweiten Sorte Vermutung. Es
fehlte etwas anderes: **Das UI hat nie erfahren, worauf es läuft.**
`GET /betrieb` meldet deshalb **Fähigkeiten**, keinen Namen:
externe_worker Gibt es andere Maschinen, die Jobs übernehmen?
freigaben_einhaengen Kann Rippy Netzwerk-Freigaben selbst einhängen?
container_pfade Sind Pfade wie /app/media überhaupt gemeint?
werkzeuge_verwalten Kann Rippy MakeMKV/HandBrake selbst beschaffen?
Ein Modus-Name würde das UI zwingen, aus einem Namen auf Verhalten zu
schließen — und das bricht beim nächsten Betriebsfall: Ein Docker-All-in-One
hat Container-Pfade, aber keinen zweiten Worker.
#### 6b — Ein Setup, das prüft und fragt
Acht Voraussetzungs-Prüfungen, zwei Ordner-Wahlen (Programm **und** Ablage),
Port, drei Schalter. Drei Regeln:
1. **Nur ein Fehler blockiert.** Eine Warnung, die den Knopf sperrt, ist eine
Bevormundung; ein Fehler, der nur warnt, ist eine Falle. Kein optisches
Laufwerk ist eine Warnung — eine reine Komprimier-Maschine ist ein
vorgesehener Betriebsfall.
2. **Jeder Befund sagt, was zu tun ist.** Ein Test hält das für jede Prüfung
fest.
3. **Die Prüfungen kennen kein Fenster.** Sie stehen in `einrichtung.py` und
sind vollständig ohne WebView2 prüfbar; im Fenstermodul steht nur Aufbau
und Brücke.
WebView2 statt Win32-Dialog: Es ist wegen Entscheid 4 ohnehin da — der
Assistent kostet **null zusätzliche Bytes**. Die Seite lädt nichts aus dem
Netz; sie muss auf einem Rechner ohne Internet aufgehen.
---
### Was jetzt noch fehlt, bevor gebaut wird
- **`KONZEPT.md` § 10 fortschreiben** — Entscheid 2 widerspricht dem Eintrag vom
+8
View File
@@ -639,6 +639,14 @@ Medien.
- [x] Symbol mit allen Größen, die Windows holt (16/32/48/256) — vorher steckte
nur 256×256 in der `.ico`, und Desktop, Startmenü und Taskleiste zeigten
ein leeres Blatt
- [x] **Ein echtes Setup** (`einrichtung.py`, `setup_fenster.py`): acht
Voraussetzungs-Prüfungen, Zielordner UND Ablage zur Wahl, Port,
Autostart/Verknüpfungen/Werkzeuge als Schalter. Vorher installierte der
Doppelklick stillschweigend und öffnete das Fenster.
- [x] **Die Oberfläche kennt ihren Betrieb** (`betrieb.py`, `GET /betrieb`,
`useBetrieb.tsx`): keine Worker-Zähler, keine Container-Platte, kein
`docker compose ps` mehr im Windows-Client — und der Docker-Betrieb
behält alles.
- [ ] Standby blocken via `SetThreadExecutionState`, ohne `ES_DISPLAY_REQUIRED`
**offen**
- **Fertig, wenn:** auf einem frischen Win-11-Rechner gilt: Installer →