tessera-ctl/.planning/.continue-here.md

context, phase, task, total_tasks, status, last_updated

context	phase	task	total_tasks	status	last_updated
default	null	null	null	paused	2026-09-23T13:15:42.473Z

<current_state> Kein laufender Meilenstein; die Arbeit laeuft als Quick-Tasks. Version 1.3.1 ist am 23.09. freigegeben (Tag v1.3.1 auf ad004b2, Abbilder live + v1.3.1, Gitea-Release mit beiden Desktop-Paketen).

14 Commits liegen lokal und sind NICHT gepusht. Arbeitsbaum sauber. Der lokale Stack laeuft mit dem Proxmox-Stand (web, api, db neu gebaut).

Unterbrochen wurde NICHT mitten in einer Aufgabe: das Proxmox-Modul ist vollstaendig gebaut, geprueft und die drei Befunde aus dem Rundgang sind behoben. Offen ist EIN Befund aus der Abnahme (siehe Restarbeit) und der Push. </current_state>

<completed_work>

Diese Sitzung (22.09. abends bis 23.09. nachmittags):

• quick-260922-vdk — Dashboard-Raster misst seine Breite auch aus dem Leerzustand heraus. Meldung kam aus dem Linux-Client; Ursache war ein useEffect(..., []), das den ResizeObserver nie anhaengte, wenn das Dashboard beim Einhaengen leer war. Breite blieb auf dem Startwert 1200 -> rechts ein toter Streifen. Im echten AppImage gegengemessen.
• Platte aufgeraeumt — 3,6 GB frei -> 66 GB. Nur Wegwerf-Sachen (Docker-Build-Cache 27,9 GB, 58 verwaiste Image-Schichten 43,3 GB, verwaiste CI-Volumes).
• Freigabe 1.3.1 — CHANGELOG abgeschlossen, live vorgezogen, Tag gepusht.
• quick-260923-ad9 — Dashboard-Reiter: mehrere Dashboards je Benutzer, per Ziehen sortierbar, der erste ist der Standard. Bestand wandert per Migration in den ersten Reiter.
• quick-260923-dhh — Proxmox-Modul (PVE/PBS/PMG), nur beobachten, sieben Aufgaben.
• quick-260923-ku6 — drei Befunde aus dem Proxmox-Rundgang behoben.

Jeder Punkt wurde im Browser bzw. im echten Client geprueft; die Protokolle stehen in den jeweiligen SUMMARY.md unter .planning/quick/. </completed_work>

<remaining_work>

1. Offener Befund der Abnahme (zuerst): sumOrNull in apps/api/src/proxmox/proxmox-normalize.ts liefert bei EINEM fehlenden Teilwert die halbe Summe statt null — also einen stillen Falschwert genau dort, wo die Feldnamen am schlechtesten belegt sind (PMG, Annahme A5). Ein Test fuer „nur eine Haelfte vorhanden“ fehlt bisher ganz.
2. Kleinbefund: „Jetzt aktualisieren“ auf der Proxmox-Modulseite wird allen mit Modulzugriff gezeigt; der Endpunkt verlangt aber ADMIN/SUPER_ADMIN. Bei anderen passiert beim Klick nichts.
3. Push (14 Commits) und CI abwarten.
4. Proxmox-Dashboard-Kachel als eigener kleiner Auftrag ueber den Weg aus 260922-m1h (WIDGET_TYPES + WIDGET_MODULE_SLUGS + registerWidget).
5. Freigabe 1.4.0, sobald Reiter und Proxmox auf alpha bestaetigt sind (neue Funktionen, also Minor, nicht Patch). </remaining_work>

<decisions_made>

• Proxmox: nur beobachten. Einzige nicht-lesende Anfrage ist die Ticket-Anmeldung; sie liegt an genau einer Stelle und proxmox-nur-lesen.spec.ts zaehlt sie gegen eine benannte Konstante.
• Keine SSRF-Adresssperre — Proxmox steht per Definition im internen Netz, eine Sperre wuerde jede echte Adresse blockieren. Schutz ist, dass nur ein Administrator Adressen eintraegt.
• PMG nur Benutzer/Passwort (Recherche A1, Forenbeleg). Faellt beim Test auf, wenn es doch Token kann — dann nachruesten.
• Zertifikats-Ausnahme je Serverzeile, niemals global.
• Dashboard-Reiter: der erste Reiter ist der Standard; „als Favorit festlegen“ heisst nach vorn ziehen. Kein zusaetzliches Kennzeichen.
• Dashboard-Raster: belegter Platz bleibt gesperrt, nichts weicht aus. Nutzeransage 22.09.
• KEIN Umbau der Proxmox-Modulseite. Der Nutzer hat den Wunsch nach mehr Detailgrad und Statusfarben am 23.09. ausdruecklich zurueckgezogen („vergiss das letzte, was ich geschrieben habe“). Nicht von selbst wieder aufgreifen. </decisions_made>

- Die Proxmox-Feldnamen bei PBS und PMG sind nicht aus erster Quelle belegt (A2/A3/A5). Nur der Test des Nutzers auf alpha gegen echte Server klaert das. Die Auswertung ist deshalb nachsichtig gebaut, und jede Feldnamenliste liegt als EINE benannte Konstante in `proxmox-normalize.ts`. - Live steht moeglicherweise noch auf 1.3.0: der Nutzer hat gezogen, bevor die `live`-Abbilder fertig waren (Tag-Lauf war zuerst rot). Ein zweiter `pull` steht aus, unbestaetigt.

Required Reading (in order)

1. .planning/quick/260923-dhh-proxmox-modul-pve-pbs-und-pmg-anbinden-n/260923-dhh-VERIFICATION.md — der offene Befund steht dort mit Reproduktion.
2. .planning/quick/260923-dhh-.../260923-dhh-RESEARCH.md — Annahmen-Log A1…A5, die einzige Stelle, an der steht, was an der Proxmox-Anbindung belegt und was abgeleitet ist.
3. .planning/quick/260923-ku6-.../260923-ku6-SUMMARY.md — die Merge-Regel des Verbindungstests (Formular vs. gespeichert, Geheimnisfelder).
4. .planning/STATE.md — Abschnitt „Current Position“ und die letzten Zeilen der Quick-Tabelle.

Critical Anti-Patterns (do NOT repeat these)

• [ANTI-PATTERN]: Im Desktop-Client gegen getBoundingClientRect()/getComputedStyle() messen → 260922-vdk: die Werte blieben auf dem ALTEN Stand, obwohl style.width bereits richtig war. WebKitGTK friert die Animationsuhr ein, wenn das Fenster im Hintergrund liegt, und die width-Uebergangsanimation bleibt stehen. Mitigation: im Client gegen die GESETZTEN Werte messen (style.width, style.transform) oder gegen die React-Eigenschaften aus dem Fiber.
• [ANTI-PATTERN]: Ein Bestaetigungsfenster nur ueber [role="dialog"] suchen → der Loeschen-Dialog der Reiter traegt role="alertdialog"; die Pruefung sah „es passiert nichts“, obwohl das Fenster offen war. Mitigation: auf beide Rollen abfragen.
• [ANTI-PATTERN]: Nach dem Tag sofort auf dem Server pull ausfuehren → eine Freigabe loest DREI Pipelines aus; faellt der Tag-Lauf um (bei 1.3.1: ein flackernder Test mit 5-Sekunden-Grenze), werden Abbild-Bau und Desktop-Pakete UEBERSPRUNGEN, und pull holt still den alten Stand. Mitigation: erst pruefen, dass die Abbilder live/beta einen neuen Zeitstempel tragen, dann ziehen. Todo zum flackernden Test liegt unter .planning/todos/pending/.
• [ANTI-PATTERN]: Eine Vermutung ueber die Ursache aus einem Bildausschnitt ableiten → beim Raster-Fehler fuehrte der erste Verdacht („eine Nachbarkachel blockiert“) in die Irre; erst das volle Fenster und das Rueckrechnen der Spaltenbreite (51,5 px, letzte Spalte 13) haben die echte Ursache gezeigt. Mitigation: bei Bildbefunden das GANZE Fenster anfordern, nicht den Ausschnitt, und die Geometrie nachrechnen.

Infrastructure State

• Lokaler Stack: docker compose mit web, api, db, gebaut auf dem Proxmox-Stand. up allein baut NICHT neu. DB ohne Host-Port — Prisma vom Host ueber die Container-IP (docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' tessera-ctl-db-1, tessera:tessera_dev).
• Proxmox-Nachbau: Node-Skript mit selbstsigniertem Zertifikat im Scratchpad (scratchpad/fake-proxmox.mjs, Port 8006, aus dem api-Container ueber 172.21.0.1 erreichbar). Laeuft noch; /tmp ueberlebt keinen Neustart, das Skript ist aber schnell neu gebaut. Endpunkte: /api2/json/cluster/resources, /status/datastore-usage, /admin/datastore/{name}/snapshots, /statistics/mail, POST /access/ticket.
• Lokale Testdaten (duerfen weg): zwei Proxmox-Server in der DB („Nachbau PVE“ und „Nachbau kaputth“, letzterer absichtlich unerreichbar), Proxmox im Marktplatz aktiviert, im Admin-Dashboard ein Reiter „Dashboard“ mit 5 Kacheln.
• alpha (alpha.tessera.ctl.de): Stand 1.3.1-Beta; Reiter und Proxmox fehlen dort noch, weil nicht gepusht.
• Live (tessera.ctl.de): 1.3.1 freigegeben; ob der Server sie wirklich zieht, ist offen.

Der rote Faden: erst ein gemeldeter Fehler aus dem Linux-Client (Kachel liess sich nicht ganz nach rechts ziehen), der sich als Breitenmessung entpuppte; dann Freigabe; dann zwei Wuensche des Nutzers nacheinander — Dashboard-Reiter und das Proxmox-Modul. Beim Proxmox-Modul ist die Besonderheit, dass hier KEIN echter Server steht: deshalb wurde ein Nachbau gebaut, die Auswertung bewusst nachsichtig ausgelegt und jede Feldnamenliste an genau eine Stelle gelegt, damit der Nutzer sie nach seinem Test auf alpha in einem Griff korrigieren kann.

<next_action> Start with: den offenen Befund der Abnahme beheben — sumOrNull in apps/api/src/proxmox/proxmox-normalize.ts muss null liefern, sobald EIN Teilwert fehlt (heute (a ?? 0) + (b ?? 0)), plus ein Test fuer „nur eine Haelfte vorhanden“. Gleich mit erledigen: „Jetzt aktualisieren“ nur fuer ADMIN/SUPER_ADMIN anzeigen. Danach Tore laufen lassen, committen, die 14 Commits pushen und die CI abwarten. </next_action>