diff --git a/.planning/HANDOFF.json b/.planning/HANDOFF.json index 48c09fc..e381834 100644 --- a/.planning/HANDOFF.json +++ b/.planning/HANDOFF.json @@ -1,44 +1,34 @@ { "version": "1.0", - "timestamp": "2026-09-16T10:28:05.211Z", - "phase": null, - "phase_name": "Betrieb nach dem Live-Gehen — Quick-Tasks auf Zuruf des Users (kein laufender Meilenstein)", - "phase_dir": null, - "plan": null, - "task": null, - "total_tasks": 0, + "timestamp": "2026-09-17T07:38:47.449Z", + "phase": "18", + "phase_name": "desktop-client-fertigstellen", + "phase_dir": ".planning/phases/18-desktop-client-fertigstellen", + "plan": 6, + "task": 3, + "total_tasks": 3, "status": "paused", "completed_tasks": [ - {"id": 1, "name": "WINDOWS #29 Rechteausweitung ADMIN -> SUPER_ADMIN geschlossen (260914-ebg)", "status": "done", "commit": "759ea3b"}, - {"id": 2, "name": "Etappe 3c Systemkontext forSystem() fuer Hintergrunddienste (260914-eym)", "status": "done", "commit": "939c812"}, - {"id": 3, "name": "Zwei Auslieferungskanaele beta/live, Versionsstempel, Versionsanzeige (260914-ku1)", "status": "done", "commit": "ea6aa99"}, - {"id": 4, "name": "Fehler-melden-Knopf mit Bildschirmfoto per E-Mail (260914-m97)", "status": "done", "commit": "77117de"}, - {"id": 5, "name": "Erstfreigabe v1.0.0, Live-Gehen tessera.ctl.de am 2026-09-15 (User)", "status": "done", "commit": "e509860"}, - {"id": 6, "name": "Dashboard: feineres Raster, skalierende Widget-Inhalte, halbe Abstaende (260916-bwo)", "status": "done", "commit": "1aefaa3"}, - {"id": 7, "name": "Dashboard-Nachbesserung: Mindestgroessen, Rand oben, Drag & Drop (260916-dyv, Rechner-Minimum 8792819)", "status": "done", "commit": "cf97b5b"}, - {"id": 8, "name": "Aenderungsliste: CHANGELOG.md, Seite Was ist neu, Gitea-Release je Tag (260916-dcz)", "status": "done", "commit": "c5f4ade"}, - {"id": 9, "name": "21 fehlende Uebersetzungen (Kalenderquellen-Formular, Kalender-Einstellungen, Marktplatz)", "status": "done", "commit": "c3d8e16"}, - {"id": 10, "name": "Version 1.1.0 freigegeben (Tag v1.1.0, live-Abbilder, Gitea-Release von der Pipeline); User hat Live gepullt: 'sieht gut aus'", "status": "done", "commit": "e0d4532"} + {"id": 1, "name": "Phase 18 komplett: 6 Plaene, Code-Review behoben, Verifikation passed, Windows-Bedienprobe bestanden", "status": "done", "commit": "626f60e"}, + {"id": 2, "name": "Schnellkorrektur: Startseite setup.html im Fenster main (asset not found: index.html), CARGO_BUILD_JOBS=4", "status": "done", "commit": "b6d9013"}, + {"id": 3, "name": "Dashboard-Nachbesserungen (6 Quick-Tasks 260916-hiv/htc/iex/j4f/jvj/k2z): Kalender-Widget-Umbau, Notiz-Haekchen, Favoriten-Titel, Link-Widget entfernt, Plaketten in Kalenderfarbe, Markdown-Aufzaehlungspunkte", "status": "done", "commit": "7110512"} ], "remaining_tasks": [ - {"id": 11, "name": "Nichts Angefangenes. Naechste Arbeit kommt vom User (Feedback aus dem Betrieb; Fehlermeldungen landen per Knopf im Postfach aus Administrator -> SMTP). Jede Aenderung SOFORT in CHANGELOG.md unter '## Unveröffentlicht' eintragen.", "status": "not_started"}, - {"id": 12, "name": "Todo ohne Termin: Desktop-Client auslieferungsreif (Versions-Check, Windows-Installer, Abnahme, CI-Bau) — erst wenn der User die Bau-/Testmoeglichkeit hat (.planning/todos/pending/2026-09-15-desktop-client-auslieferungsreif-machen.md)", "status": "not_started"}, - {"id": 13, "name": "Formal: /gsd-ship fuer Phase 17 (v1.2) nie gelaufen; windows_enforce blockiert bei open_count 15 — keine Dringlichkeit", "status": "not_started"}, - {"id": 14, "name": "Ledger ohne Dringlichkeit: #35 Biome-Konfiguration im Bestand nicht lauffaehig (pnpm lint = Leerlauf), #36 Admin-Frontend verschluckt 403 still, #37 DKV Single-Flight prozessweit; die uebrigen 12 offenen Eintraege haengen am ruhenden Mandantenthema", "status": "not_started"} + {"id": 4, "name": "Benchmark nach dem Neustart wiederholen (User aendert RAM/CPU der VM) — vier Messungen aus memory/reference_benchmark_dev_host.md, mit Referenz vergleichen", "status": "not_started"}, + {"id": 5, "name": "Beim naechsten Freigabe-Tag (1.2.0): Release-Anhaenge (Tessera-Setup-1.2.0.exe, Tessera-1.2.0.AppImage) am Gitea-Release und Update-Hinweis im Client beobachten (18-UAT.md #2/#3)", "status": "not_started"} ], "blockers": [], "async_jobs": [], "human_actions_pending": [ - {"action": "Auf alpha (Beta) einmalig IMAGE_TAG=beta in /opt/tessera/.env und die zwei image:-Zeilen auf ${IMAGE_TAG:-beta} bringen (Kap. 9) — solange nicht geschehen, laeuft alpha ueber 'latest', das dasselbe Abbild wie 'beta' ist; nichts kaputt, nur unsauber", "context": "docs/anleitung-betrieb.md Kapitel 9, Abschnitt 'Die eine Zeile je Server'", "blocking": false} + {"action": "VM neu starten nach RAM/CPU-Aenderung, dann neue Claude-Sitzung und 'Benchmark wiederholen'", "context": "Vergleich, ob mehr RAM/CPU beim Kompilieren hilft (Referenz: 8 vCPU/15 GB: Teilbau 43 s, Vollbau 165 s, Web-Tests 22 s, API-tsc 7 s)", "blocking": false}, + {"action": "Freigabe 1.2.0 auf Zuruf: CHANGELOG 'Unveröffentlicht' -> '1.2.0 – Datum', live ff-merge, Tag, Push (docs/anleitung-betrieb.md Kap. 9)", "context": "Erst dann sind Release-Anhang und Update-Hinweis pruefbar", "blocking": false} ], "decisions": [ - {"decision": "Mandantenfaehigkeit RUHT — 3a und Etappe 4 nicht weiterverfolgen, Thema nicht ansprechen; Ein-Firmen-Betrieb reicht; evtl. spaeter ein Container je Kunde", "rationale": "User 2026-09-14, veraergert ueber den Zeitaufwand; Memory feedback-mandantenfaehigkeit-nicht-ansprechen", "phase": "Betrieb"}, - {"decision": "Kanalmodell: main = beta (alpha.tessera.ctl.de), Zweig live + Tag vX.Y.Z = live (tessera.ctl.de); IMAGE_TAG je Server", "rationale": "User will Live und Beta getrennt, Hotfixes ohne Beta-Neuerungen; Rezept Kap. 9", "phase": "260914-ku1"}, - {"decision": "Versionsnummer entscheide ich: neue Funktionen -> mittlere Stelle (1.1.0), nur Fehlerbehebungen -> dritte Stelle (1.0.1)", "rationale": "User 2026-09-16: 'du entscheidest, ich habe keine Ahnung'", "phase": "Freigabe 1.1.0"}, - {"decision": "Lizenzmodell (Betreiber gibt Modul je Server mit Lizenzanzahl frei, Firmenadmin lizenziert an bis zu N Benutzer) nur festgehalten, nicht bauen, nicht ansprechen", "rationale": "User 2026-09-14; Zettel .planning/todos/pending/2026-09-14-lizenzmodell-freigabe-je-server-mit-lizenzanzahl.md", "phase": "Betrieb"}, - {"decision": "Dashboard: Mindestgroessen inhaltsgetrieben statt verdoppelt; gespeicherte Minima beim Rendern ueberschrieben; ganze Kachel Griff; preventCollision mit noCompactor", "rationale": "User-Test auf alpha 2026-09-16 ('nicht klein genug', 'Drag and Drop semi'); Messungen in 260916-dyv", "phase": "260916-dyv"} + {"decision": "Windows-Installer per Cross-Bau (cargo-xwin + NSIS) auf dem Linux-Runner; Pakete im API-Abbild (/app/desktop-dist + manifest.json), bei Tags zusaetzlich am Gitea-Release; Server-Adresse beim Erststart; Update nur Hinweis + Link; keine Signierung", "rationale": "User-Entscheidung Download in Tessera + Gitea; kein Windows-Rechner in der Pipeline; Live-Server ohne Gitea-Zugang", "phase": "18"}, + {"decision": "CARGO_BUILD_JOBS=4 im CI-Job desktop", "rationale": "8 rustc-Prozesse brachten den gemeinsam genutzten Host (Gitea + Runner + Dev-Stack, 15 GB) an die Speichergrenze; Claude Code beendete deshalb eine Hintergrundaufgabe", "phase": "18"}, + {"decision": "Keine Kalenderquellen-Auswahl pro Widget; Plaketten je Kalenderfarbe, ab 2 Kalendern kleine Kreise (max. 3, Rest grau)", "rationale": "User: nur Optik wie personal-dashboard; globaler 'sichtbar'-Schalter je Quelle reicht", "phase": "quick"} ], "uncommitted_files": [], - "next_action": "/gsd-resume-work; dann das aufgreifen, was der User aus dem Betrieb von v1.1.0 mitbringt. Vor jeder Aenderung: CHANGELOG.md '## Unveröffentlicht' pflegen. Bei 'Version freigeben': Unveroeffentlicht -> X.Y.Z – Datum, neues leeres Unveroeffentlicht, Commit+Push, dann git checkout live && git merge --ff-only main && git tag -a vX.Y.Z -m 'Tessera X.Y.Z' && git push origin live vX.Y.Z — die Pipeline baut live/vX.Y.Z und legt den Gitea-Release an.", - "context_notes": "Gemessen 2026-09-16 10:28Z: git status --porcelain leer, main == origin/main (29fe3d7), keine async-jobs. LIVE: tessera.ctl.de auf v1.1.0 (User hat gepullt, 'sieht gut aus'); BETA: alpha.tessera.ctl.de holt 'beta'/'latest' (= v1.1.0 Stand, e0d4532). Registry: beta/latest/live/v1.0.0/v1.1.0. Gitea-Releases: v1.0.0 (manuell per Skript), v1.1.0 (von der Pipeline — erster CI-Beweis des Release-Wegs). DER SCHALTER IST AUS (DATABASE_URL auf BYPASSRLS-Rolle) und bleibt es. Endstand Tests: Web 49 Dateien / 309 Tests, API 67 / 1078; rls-scratch-check 253/253; Ledger 15 offen / 1 zurueckgestellt / 23 geschlossen / 39 gesamt. Arbeitsweise, die sich bewaehrt hat: /gsd-quick --validate mit voller Kette (Planer opus, Pruefer, Executor opus bei >10 Dateien, Verifizierer) — der Pruefer fing in dieser Sitzung u. a. ein fehlendes Clamp bei angehobenen Minima, ich selbst im Browser das abgeschnittene Rechner-Minimum (Planer zaehlte 5 statt 6 Tastenreihen). Browser-Nachweise mache ich selbst per Playwright MCP gegen lokale Container (docker compose up -d --build web; DB-Container ohne Host-Port; Admin admin/admin123 lokal; mailhog aus docker-compose.dev.yml fuer Mail-Proben). Fallen: Platte lief einmal voll (docker builder prune half); der Gitea-Runner arbeitet nur einen Auftrag gleichzeitig (andere Repos blockieren die Warteschlange); auf diesem Host ist grep = ugrep ($ wirkt als Anker); .dockerignore schliesst *.md aus (CHANGELOG.md per !-Ausnahme); Next.js bettet NEXT_PUBLIC_* nur bei woertlichem Zugriff ein; jsdom verwirft clamp() im Inline-Style; git checkout -- setzt auch unkommittierte Aenderungen zurueck. User-Praeferenzen: Deutsch, duzen, Alltagssprache, keine technischen Fragen, nur Produktfragen; App-Texte siezen. Diese Sitzung endete bei ~70% Kontext — deshalb pausiert." + "next_action": "Nach dem Neustart: `nproc`, `free -h`, dann die vier Benchmark-Befehle aus memory/reference_benchmark_dev_host.md (Rechner idle, kein CI-Lauf) und Zeiten vergleichen. Danach normal weiter: nichts ist angefangen; naechster groesserer Schritt ist die Freigabe 1.2.0 auf Zuruf des Users.", + "context_notes": "Alles auf origin/main (HEAD 626f60e + dieser WIP-Commit), Arbeitsbaum leer, CI-Lauf 369 gruen (Pakete Tessera-Setup-1.1.0-beta.03fd85a.exe / Tessera-1.1.0-beta.03fd85a.AppImage). Beta laeuft auf diesem Stand; Live weiterhin v1.1.0. Gitea-API von aussen nur mit Token — Token steckt in remote.origin.pushurl, Monitor-Skripte lesen ihn per git config und geben ihn nie aus. Lokaler Docker-Stack (api/web/db/mailhog) laeuft mit dem 1.1.0-Desktop-Manifest. Playwright-MCP-Browser wurde nachinstalliert (chrome-for-testing)." } diff --git a/.planning/phases/18-desktop-client-fertigstellen/.continue-here.md b/.planning/phases/18-desktop-client-fertigstellen/.continue-here.md new file mode 100644 index 0000000..8334caa --- /dev/null +++ b/.planning/phases/18-desktop-client-fertigstellen/.continue-here.md @@ -0,0 +1,69 @@ +--- +context: phase +phase: 18-desktop-client-fertigstellen +task: 3 +total_tasks: 3 +status: complete +last_updated: 2026-09-17T07:38:47.449Z +--- + +## Critical Anti-Patterns + +| Pattern | Description | Severity | Prevention Mechanism | +|---------|-------------|----------|---------------------| +| Fenster ohne Startseite | Tauri-Fenster `main` hatte keine `url`; im gebauten Paket erschien "asset not found: index.html" (Altlast Phase 6, nie in einem echten Paket sichtbar). Lokaler `cargo check`/AppImage-Bau fing es nicht. | advisory | `tauri.conf.json` `app.windows[].url = "setup.html"` (b6d9013); Startseite im Binary per `strings target/release/tessera-desktop \| grep setup.html` pruefen | +| Rust-Bau frisst den Host | 8 parallele rustc-Prozesse des CI-Runners (auf demselben Host wie Gitea + Dev-Stack, 15 GB) -> Speichergrenze, Claude Code beendete eine Hintergrundaufgabe | advisory | `CARGO_BUILD_JOBS: "4"` im Job `desktop` (b6d9013); bei Rust-Vollbau lokal nicht parallel zur CI messen | +| Gitea-API ohne Token | `https://git.vicolab.de/api/v1/...` antwortet 401 ohne Token | advisory | Token aus `git config --get remote.origin.pushurl` lesen (nie ausgeben), gegen `http://localhost:3002/api/v1/...` | + + +Phase 18 (Desktop-Client) ist ABGESCHLOSSEN und gepusht (626f60e): Verifikation passed, Windows-Bedienprobe des Users bestanden (Pakete aus CI-Lauf 369, Commit 03fd85a). Nichts ist angefangen. Der User startet die VM nach einer RAM/CPU-Aenderung neu; als Naechstes soll der Bau-Benchmark wiederholt und mit der Referenz verglichen werden. + + + + +Completed Tasks (diese Sitzung, 2026-09-16/17): +- Sechs Quick-Tasks Dashboard (260916-hiv/htc/iex/j4f/jvj/k2z): URL-Platzhalter Kalenderquellen, Kalender-Widget nach Vorbild personal-dashboard (Monatsraster + Naechste Termine + 3 Einstellungen), Notiz-Haekchen abhakbar, Favoriten-Titel, Link-Widget entfernt (Migration), Tooltip-Umbruch, Notiz-Farbmodus, Changelog-Stichpunkte, Plaketten in Kalenderfarbe, Mehrfach-Kreise, Markdown-Aufzaehlungspunkte — alle gepusht, CI 365 gruen +- Phase 18, 6 Plaene: 18-01 Durchstich Linux (Manifest-Skript, API /desktop/latest + /desktop/download/:platform, Abbild), 18-02 CI-Job desktop + Cache-Uebergabe + Release-Anhaenge, 18-03 Web (Anmeldeseite-Link, Einstellungen -> Allgemein -> Desktop-App), 18-04 Client (Erststart-Seite per Rust-Kommandos, Versionspruefung, Tray Update/Autostart, Icons), 18-05 Windows-Cross-Bau (1 Korrekturrunde: clippy), 18-06 Handbuecher/Changelog/REQUIREMENTS +- Code-Review (1 kritisch, 3 Warnungen) behoben + Commit-Stempel via TESSERA_COMMIT +- Schnellkorrektur Startseite setup.html + CARGO_BUILD_JOBS=4 (b6d9013) +- Benchmark-Referenz vor dem Umbau erfasst (memory/reference_benchmark_dev_host.md) + + + + +- Benchmark nach dem Neustart wiederholen (vier Befehle, Rechner idle) und vergleichen +- Beim naechsten Freigabe-Tag (1.2.0): Release-Anhaenge am Gitea-Release + Update-Hinweis im Client beobachten (18-UAT.md #2/#3) — nur Beobachtung, kein Code offen +- Freigabe 1.2.0 selbst nur auf Zuruf des Users (Kap. 9 Betriebshandbuch) + + + + +- Installer in Tessera herunterladbar UND am Gitea-Release (User); Windows per Cross-Bau auf Linux; Pakete im API-Abbild (kein Gitea-Zugang vom Live-Server noetig); Server-Adresse beim Erststart; Update nur Hinweis + Link; keine Signierung (SmartScreen-Hinweis im Handbuch) +- Beta-Builds: Version X.Y.Z des letzten Tags + Commit-Stempel im Dateinamen/Manifest; Client vergleicht auf beta Version + Commit +- Kalender-Widget: keine Quellenauswahl pro Widget (User: nur Optik) +- Mandantenfaehigkeit und Lizenzierung ruhen weiterhin (nicht ansprechen) + + + +- keine + + +## Required Reading (in order) +1. `.planning/STATE.md` — Aktenstand, Quick-Task-Tabelle, Phase 18 Complete +2. `memory/reference_benchmark_dev_host.md` (Claude-Memory) — Benchmark-Referenz und Befehle +3. `.planning/phases/18-desktop-client-fertigstellen/18-UAT.md` — was beim naechsten Tag zu beobachten ist +4. `docs/anleitung-betrieb.md` Kap. 9 (Freigabe) und Kap. 10 (Desktop-Pakete) + +## Infrastructure State +- Beta (alpha.tessera.ctl.de): Stand main 03fd85a-Pakete, vom User gepullt; Live: v1.1.0 +- Lokaler Docker-Stack (api/web/db/mailhog) laeuft, API-Abbild mit 1.1.0-Desktop-Manifest; Gitea + Runner auf demselben Host +- Playwright MCP: Browser-Binary nachinstalliert (`npx @playwright/mcp@latest install-browser chrome-for-testing`) +- VM wird vom User neu gestartet (RAM/CPU-Aenderung) — danach `nproc`/`free -h` neu erfassen + + +Alles committet und gepusht, Arbeitsbaum leer. Naechste Sitzung beginnt mit dem Benchmark-Vergleich; danach gibt es keinen offenen Auftrag — auf den User warten (Freigabe 1.2.0 oder neue Wuensche). + + + +Start with: `nproc && free -h`, dann die vier Benchmark-Befehle aus memory/reference_benchmark_dev_host.md (kein CI-Lauf parallel), Tabelle vorher/nachher an den User. +