schalli de7fdb7377 fix(quick-260921-ldf): Fehler-melden-Dialog stimmt ab dem ersten Commit, nicht erst einen spaeter
Gemessene Ursache des Wackeltests aus CI-Lauf 395, und es ist ein
Produktfehler, kein Testfehler. Ein MutationObserver ueber jeden
DOM-Commit beim Oeffnen protokollierte:

  COMMIT dialog=true img=ja box=AUS   <- falsch, aber festgeschrieben
  COMMIT dialog=true img=ja box=AN

Der erste Zustand entstand bei JEDEM Oeffnen, nicht nur unter Last, und
hielt ohne act() zwei volle Makrotask-Runden - der Browser hat in dieser
Zeit mindestens zwei Gelegenheiten, ihn zu zeichnen. Ein Nutzer sieht
also sein Vorschaubild kurz mit ausgeschaltetem Haekchen. Der Test fiel
nur dann durch, wenn er zufaellig den ersten statt den zweiten Commit
sah; die Last im vollen Lauf war der Ausloeser, nicht die Ursache.

Zwei Bedingungen mussten zusammentreffen. Erstens war der Dialog
dauerhaft eingehaengt und gab bei geschlossenem Zustand nur null zurueck
- useState(screenshot !== null) lief damit ein einziges Mal, beim
allerersten Mount des Knopfs, als noch gar kein Bild da war. Das
Haekchen startete also immer aus. Zweitens zog ein useEffect den
Zustand nach, und passive Effekte laufen erst NACH dem Commit.

Beides ist jetzt weg. Der Dialog wird nur noch eingehaengt, solange er
offen ist, also ist jedes Oeffnen ein frischer Mount mit frischem
Zustand. Und das Haekchen wird beim Rendern aus screenshot abgeleitet
statt per Effekt nachgezogen; attachChoice haelt allein die bewusste
Abwahl des Nutzers. Der Effekt, der Status, Text und Haekchen beim
Oeffnen zuruecksetzte, entfaellt ersatzlos.

Damit verschwindet dieselbe Klasse an einer zweiten Stelle: beim
erneuten Oeffnen nach einem Versand stand bisher zwei Runden lang der
alte Danke-Bildschirm im DOM, bevor das frische Formular erschien.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TPPB4ApQxzSU1rwV2Ffj9J
2026-09-21 15:38:38 +02:00

Tessera — Anleitungen

Tessera ist eine Plattform, auf der verschiedene Arbeitswerkzeuge — genannt Module — an einer Stelle zusammenlaufen. Statt zwischen mehreren Anwendungen zu wechseln, meldet man sich einmal an und findet alles in derselben Oberfläche: ein einstellbares Dashboard, eine Seitenleiste mit den freigeschalteten Modulen und einen Marktplatz, über den weitere hinzukommen.

Diese Sammlung richtet sich an vier verschiedene Leserkreise. Suchen Sie sich den passenden heraus — die Anleitungen überschneiden sich bewusst kaum.

Anleitung Für wen Worum es geht
Für Anwender alle, die mit Tessera arbeiten Anmelden, Dashboard einrichten, Module benutzen
Für Administratoren wer Tessera einrichtet Benutzer, Gruppen, AD-Anbindung, Freigaben, SMTP
Für den Betrieb wer die Server betreut Installieren, neue Fassungen einspielen, Sicherungen, Fehlersuche
Für Entwickler wer an Tessera mitbaut Aufbau, Modulsystem, Berechtigungen, Konventionen

Daneben liegt das CI/CD-Runbook, das die Einrichtung der Bau-Pipeline in Gitea beschreibt. Es richtet sich an dieselben Leute wie die Betriebsanleitung, deckt aber nur den Weg vom Quelltext zum fertigen Abbild ab.

Ebenfalls dabei: Mandantentrennung auf Datenbankebene, das sich an dieselben Leute wie die Betriebsanleitung richtet und ausschliesslich die Datenbankrolle behandelt, mit der Tessera verbindet (WINDOWS #18).


Die drei Dinge, die am häufigsten Zeit kosten

Wenn Sie nur wenig lesen wollen — diese drei Punkte haben in der Praxis am meisten Verwirrung gestiftet:

1. Die Anmeldung läuft über den Benutzernamen, nicht über die E-Mail-Adresse. Das Feld heißt „Benutzername". Wer stattdessen seine E-Mail-Adresse einträgt, kommt nicht hinein — ohne dass eine hilfreiche Meldung erscheint. Es sieht aus wie ein kaputter Login, ist aber nur das falsche Feld.

2. „Aktiviert" und „freigegeben" sind zwei verschiedene Dinge. Ein Modul wird zuerst für das Unternehmen aktiviert und danach einzelnen Gruppen oder Personen freigegeben. Sehen Sie ein Modul im Marktplatz, aber nicht in Ihrer Seitenleiste, fehlt die zweite Stufe — wenden Sie sich an Ihre Administration. Details in der Administrationsanleitung.

3. Beim Ausrollen genügt docker compose up -d nicht. Ohne --force-recreate laufen die alten Container weiter, obwohl ein neues Abbild heruntergeladen wurde — ohne jede Fehlermeldung. Das Einspielen wirkt erfolgreich, ist es aber nicht. Der genaue Ablauf samt Kontrollbefehl steht in der Betriebsanleitung.


Zum Stand dieser Anleitungen

Sie wurden gegen den tatsächlichen Quelltext geschrieben, nicht aus der Planung abgeleitet. Beschriftungen von Schaltflächen und Feldern sind wörtlich aus den Sprachdateien der Oberfläche übernommen, damit sie zu dem passen, was auf dem Bildschirm steht.

Zwei Einschränkungen, die Sie kennen sollten:

  • Wo eine Aussage sich nicht aus dem Quelltext belegen ließ — etwa eine Einstellung, die von Hand auf dem Server ergänzt wurde — steht ein Hinweis im Text statt einer Vermutung.
  • Tessera wird derzeit ausschließlich intern eingesetzt. Die Trennung mehrerer Mandanten ist in der Architektur angelegt, aber nicht Gegenstand dieser Anleitungen.
S
Description
Tessera - Modulare Workflow-Automatisierung und Tool-Integration
Readme 34 MiB
Tessera 1.9.1 Latest
2026-10-01 14:30:23 +02:00
Languages
TypeScript 90.3%
JavaScript 5.6%
Rust 1.5%
HTML 1.1%
Shell 0.6%
Other 0.8%