Skip to content

OpenGewerk 0.6.0

Choose a tag to compare

@github-actions github-actions released this 20 Oct 19:03
· 203 commits to main since this release
v0.6.0
ea86ea5

Diese Fassung enthält eine Sicherheitskorrektur. Was betroffen war, steht im Abschnitt „Sicherheit“ und im Advisory. Wer OpenGewerk betreibt, aktualisiert bitte bald.

Die sechste Fassung schließt acht Sicherheitslücken, die eine Prüfung vor der nächsten Fassung von OpenGewerk Haustechnik im gemeinsamen Fundament gefunden hat; die Advisories erscheinen mit ihr. Am schwersten wog, dass die Anmeldung den Körper einer Anfrage ohne Grenze las, bevor irgendetwas geprüft war. Dazu kommen der zweite Faktor an der Sitzung statt am Konto, eine Grenze für das Ablegen von Dateien, kein HTTP-Cache für Antworten der Anwendung, Grenzen nach der Adresse hinter dem Reverse Proxy, Konflikte des Abgleichs, die Gerät und Person gehören, und eine Sicherung, die nur fertig und verschlüsselt auf das Ziel kommt und nur eigene Archive zurückspielt. Die Dienste laufen gehärtet, der Renderer in einem eigenen Netz, und das Paket nennt jedes Abbild mit Digest und prüft seine Signatur vor dem Start.

Das meiste, was seit 0.5.0 sonst dazukam, sind Bausteine des Fundaments für OpenGewerk Haustechnik. In der Handwerkersoftware zeigt das Änderungsprotokoll geänderte Werte, ein Ansprechpartner hat eine zweite Nummer, und eine neue Fassung wird von selbst übernommen.

Aktualisiert wird wie bei jeder Fassung, vorher gesichert; die Migrationen 0069_contacts_kept bis 0087_purge_attachments laufen von selbst. Danach:

  • Wer die Instanz betreibt, trägt unter „Instanz verwalten“, „Einstellungen“ den Mailserver der Instanz ein. Über ihn gehen jetzt der Link zu einem neuen Passwort und der Hinweis auf einen neuen Passkey, und bis er eingetragen ist, geht keines von beiden hinaus.
  • Wer nur mit dem Passwort auf einem Konto mit Authenticator-App angemeldet war, meldet sich neu an.
  • Sicherungen von vor dem Update spielt restore.sh nur mit --skip-origin-check zurück. Wer verschlüsselt sichert, löscht auf dem Ziel jedes Archiv .tar.gz ohne Gegenstück .age.

Hinzugefügt

  • Eine Anwendung, die ihre Fristen an Orten hält, die nicht jeder sieht, sagt dem Fundament, wer eine Frist dort bekommen darf (MayAnswer, im Lauf der Fristen und in den Regeln der Liste, OpenGewerk/opengewerk-haustechnik#473). Die Erinnerung geht dann an die erste Person in der gewohnten Reihenfolge, die das darf, die Leitung eingeschlossen, und an niemanden, wo es niemand darf; die Liste nennt dieselbe Person, und als Person einer Frist lehnt die Route jemanden ab, der den Ort nicht sieht. Ohne die Frage bleibt alles, wie es war. Warum: die Erinnerung ging nach der Mitgliedschaft und nannte einer Person ohne den Bereich Art, Tag und Kennung der Frist, gefunden in der Sicherheitsprüfung der Haustechnik.

  • Ein Dokument und seine Dateien lassen sich nach Ablauf einer Aufbewahrung endgültig löschen (#658), auf dem einen Weg, den eine Anwendung dafür öffnet: purge_attachment(dokument, titel) löscht die Fassungen, lässt das Dokument als gelöschte Hülle mit dem gegebenen Titel stehen, damit ein Gerät davon erfährt. Die Zeile jeder Datei in files, auf die danach kein Schlüssel mehr zeigt, nimmt ein Trigger der Fassung mit, samt dem Eintrag, wer sie abgelegt hat; die Anwendung selbst darf in files nicht löschen, eine Datei geht nur mit der Fassung, die sie nennt. Wann, entscheidet die Anwendung mit application_attachment_may_go; ohne sie geht nichts, und die Riegel lehnen jedes andere Löschen einer Fassung oder einer Datei ab, auch für den Eigentümer der Tabellen. Das Änderungsprotokoll schreibt dabei nichts ab. Diese Anwendung öffnet den Weg nicht; Migration 0087_purge_attachments. Warum: die Haustechnik markierte ein Dokument nach Ablauf der Aufbewahrung nur als entfernt, und Titel, Dateinamen und Dateien blieben.

  • Der Dateispeicher räumt sich auf (#657): einmal am Tag nimmt ein Lauf die Bytes jeder Datei heraus, die kein Betrieb mehr hält und die älter als ein Tag ist, dazu liegengebliebene Reste abgebrochener Schreibvorgänge. Welche Namen noch gehalten werden, beantwortet files_held mit den Rechten des Eigentümers (Migration 0086_file_sweep, Policy readable_by_the_owner an files); ein erneutes Ablegen derselben Bytes macht eine Datei wieder neu, und eine Datei wird vor dem Löschen beiseitegelegt, damit ein gleichzeitiges Ablegen sie nicht verliert. Warum: mit dem Löschen nach Ablauf einer Aufbewahrung verschwinden Zeilen, und die Bytes blieben sonst für immer auf der Platte.

  • Vorlagen für den Reverse Proxy unter docker/proxy/, apache.conf für Apache 2.4 und nginx.conf für nginx, jede für sich vollständig: die Weiterleitung von HTTP auf HTTPS, das Zertifikat unter dem Pfad, den certbot anlegt, der Proxy auf 127.0.0.1:23700 mit Host, Protokoll und ergänztem X-Forwarded-For, die Grenzen je Pfad und 300 Sekunden für lange Drucke, ohne Sicherheits-Header. Jede Zeile, die zur eigenen Instanz passen muss, trägt einen Kommentar. Die Vorlagen liegen auch im Installationspaket, die CI prüft beide mit nginx -t und httpd -t in der ältesten Fassung, die eine noch unterstützte Distribution mitbringt, und in der neuesten (docker/test-proxy.sh), und das README hat dazu den Abschnitt „Reverse Proxy“. Die Zeilen für Apache, die bisher dort standen, begrenzten nichts: Apache wendet LimitRequestBody auf eine Anfrage, die es mit ProxyPass weiterreicht, nicht an. Die Vorlage vergleicht deshalb die Länge, die eine Anfrage angibt, mit mod_rewrite. Warum: wer installiert, musste sich den vHost bisher aus einzelnen Zeilen im README zusammensetzen.

  • Ein Weg in die Ansicht für unterwegs im Kontomenü des Büros (für opengewerk-haustechnik#464): unter einem Strich zwischen „Instanz verwalten“ und „Abmelden“ steht der Satz entry.goTo.site der Anwendung mit einem Telefon und der Zeile „Große Knöpfe, auch ohne Netz“, auch im Bereich der Instanz; in der Handwerkersoftware heißt er „Zur Baustellenansicht“. Er merkt sich die Wahl wie der Weg ins Büro im Menü vor Ort und öffnet /m/, danach führt / auf diesem Gerät in die Ansicht für unterwegs, bis dort wieder das Büro gewählt wird. Warum: vor Ort gab es einen Weg ins Büro, im Büro keinen zurück; wer am Schreibtisch oder auf einem Tablet in der Desktop-Ansicht wechseln wollte, hatte nur die Leiste mit dem Vorschlag, die nicht immer erscheint, oder musste /m von Hand eingeben.

  • Eine zweite Nummer am Ansprechpartner, „Mobil“ (für opengewerk-haustechnik#428): contactsSchema hat die Spalte mobile, contactTextFields das Feld zwischen Telefon und E-Mail, und Formular, Karte im Büro, die Zeile je Person und die Liste vor Ort zeigen sie wie die erste Nummer, zum Antippen. Vor Ort steht die erste Nummer jetzt mit einem Hörer, die mobile mit einem Telefon in der Hand. Die Handwerkersoftware bekommt die Spalte mit der Migration 0080_contact_mobile, ihr Abgleich nennt sie „Mobil“, und die Vorschau eines Kunden zeigt beide Nummern. Warum: viele Ansprechpartner haben Festnetz mit Durchwahl und ein Mobiltelefon, und bisher blieb die zweite Nummer in der Funktion oder ging verloren; Moritz hat am 18.10.2026 das eigene Feld entschieden.

  • Maßnahmen der Instanz (für opengewerk-haustechnik#358): Teil B der technischen und organisatorischen Maßnahmen (B.1 bis B.9 der Vorlage zur Auftragsverarbeitung auf opengewerk.de) und die Unterauftragsverarbeiter pflegt, wer die Instanz betreibt, auf einem eigenen Bildschirm ihres Bereichs (InstanceMeasuresScreen, GET und PUT instance/measures), mit einem Speichern für alles. Gehalten in zwei Spalten der Einstellungen der Instanz (measures, subprocessors), deren Änderungen wie jede andere im Protokoll der Instanz stehen; eine Anwendung liest sie mit readMeasures für die Dokumente eines Mandanten, ohne den Namen dessen, der sie geändert hat. Die Handwerkersoftware bekommt die Spalten mit der Migration 0079_instance_measures; ihren Bildschirm bindet sie erst mit einer Tafel. Warum: die Haustechnik erzeugt die Maßnahmen eines Betreibers als Anlage 1 zum Vertrag zur Auftragsverarbeitung, und was beim Betrieb der Instanz sichergestellt ist, weiß nur, wer sie betreibt.

  • Ein Foto zu einem Punkt auch aus der Galerie (für die Rundgänge der Haustechnik): PhotoTaker hat neben „Foto aufnehmen“, das die Kamera sofort öffnet, einen zweiten Knopf „Aus der Galerie“ ohne capture. Mit multiple hält ein Punkt mehrere Fotos: ein weiteres kommt dazu statt das vorige zu ersetzen, und aus der Galerie lassen sich mehrere auf einmal wählen. Warum: mit capture öffnete das Telefon nur die Kamera, ein Foto, das schon gemacht war, ließ sich nicht hinzufügen. Auf dem Telefon stehen die beiden Knöpfe untereinander, weil nebeneinander jede Beschriftung in zwei Zeilen umbrach; wo beide Platz haben, wie im Büro, stehen sie nebeneinander. Mit compact (für opengewerk-haustechnik#451) sind es zwei kurze Knöpfe „Foto“ und „Galerie“ nebeneinander unter den Fotos, für einen Punkt unter vielen in einer Liste, wo zwei Knöpfe über die ganze Breite an jedem Punkt die Liste doppelt so lang machten. Mit accept (für opengewerk-haustechnik#458) bieten Kamera und Galerie nur die genannten Dateiarten an, weil eine Seite ohne Anmeldung nur JPEG, PNG und WebP annimmt und ein anderes Bild aus der Galerie erst beim Senden abgelehnt würde.

  • Einen Wert im Änderungsprotokoll schwärzen (für opengewerk-haustechnik#355, ADR 0013): wer den Mandanten führt, leert den Wert davor oder danach eines Eintrags mit einem Grund (POST audit/entries/:id/redactions, Tabelle audit_redactions, Migration 0078). Die Kette bleibt ganz: neue Einträge (Fassung 2) rechnen ihren Fingerabdruck über einen Fingerabdruck je Wert, der beim Schwärzen bleibt, und für einen Eintrag von vorher hält die Schwärzung einen Zeugen des ganzen Eintrags fest; kein bestehender Eintrag wird umgeschrieben. Liste und Tabelle zeigen „geschwärzt“ mit Zeitpunkt, Person und Grund, das Protokoll des Büros bietet „Schwärzen“ mit einer Rückfrage an, und die Schwärzung selbst steht im Protokoll, ohne den Wert. Warum: die Haustechnik muss einen personenbezogenen Wert aus dem Protokoll nehmen können, etwa auf einen Antrag auf Löschung hin, ohne dass die Prüfung der Kette danach eine Manipulation meldet.

  • Die Angaben eines beendeten Zugangs entfernen (für opengewerk-haustechnik#356): removeAccountData nimmt nach dem letzten Tag einer Zugehörigkeit die Geräte der Person in diesem Mandanten und die Passkeys, die er von ihr kennt. Arbeitet das Konto für keinen anderen Mandanten mehr, oder nur für solche, deren letzter Tag ebenfalls vorbei ist, und betreibt es die Instanz nicht, gehen auch seine Adresse (removedAddress), seine Passkeys, sein zweiter Faktor und sein Passwort; der Name bleibt, weil das, was die Person unterschrieben hat, sie nennt. Warum: die Haustechnik entfernt nach einer einstellbaren Frist, was kein Nachweis mehr braucht, und das liegt bei den Konten im Fundament. Dazu bekommt der Dialog eines Zugangs unter dem letzten Tag einen Platz für die Anwendung (afterLastDay), sobald ein Tag eingetragen ist, etwa für das, was noch an der Person hängt.

  • Regeln zählen auch in reinen Kilogramm (für opengewerk-haustechnik#351): die Einheit kilograms in ruleUnits, und Migration 0077 nimmt sie in den Typ rule_unit von tenant_parameters auf, wie 0066 und 0071. Warum: die F-Gas-Verordnung von 2024 setzt die Schwellen der Dichtheitskontrolle für ungesättigte Kältemittel in Kilogramm, nicht in CO2-Äquivalent.

  • Das Änderungsprotokoll als Tabelle spricht mit den Wörtern des Mandanten (für opengewerk-haustechnik#426): tenantWords in den Teilen des Protokolls bildet die Wörter der Werte je Anfrage in der Transaktion des Mandanten, an der Stelle der Wörter, die die Anwendung einmal mitgibt. Warum: was ein Mandant selbst anlegt, etwa eigene Anlagenarten und Felder, stand in der Tabelle mit seinem Schlüssel statt mit seiner Bezeichnung.

  • Vor dem Einschalten von Push steht, über welchen Dienst die Nachrichten gehen (für opengewerk-haustechnik#390): auf der Karte „Benachrichtigungen“ im Konto und im Menü vor Ort ein Satz, dass Push über den Dienst des Browser-Herstellers in den USA geht, den Inhalt verschlüsselt, mit dem Risiko bei den Diensten ohne Zertifizierung nach dem EU-US Data Privacy Framework und dem Verweis auf die Datenschutzhinweise der Instanz (pushNotice). Warum: für Safari und Firefox ist das Einschalten die Einwilligung nach Art. 49 Abs. 1 lit. a DSGVO, und die gilt nur, wenn die Person vorher vom Risiko weiß.

  • Eine Ausbuchung im Lager (für opengewerk-haustechnik#430): die Art write_off einer Buchung nimmt Bestand weg wie eine Entnahme und nennt ihren Grund, in Domäne und Datenbank (stock_movements_write_off_with_a_reason). Warum: Material, das für etwas ohne Auftrag gebraucht wird, ließ sich bisher nur über eine Zählung ausbuchen, die den Bestand setzt, statt zu sagen, was weggenommen wurde und wofür.

  • Ein Artikel im Lager hat einen Lagerplatz (für opengewerk-haustechnik#385): die Spalte bin an store_articles, frei als Text bis zur Länge des Orts eines Lagers, mit ihrer Prüfung in Domäne und Datenbank. Warum: Wo im Lager ein Artikel liegt, stand bisher behelfsweise in seiner Beschreibung, die aber für jedes Lager gilt.

  • Ein Datensatz, über den sein Protokoll schweigt, heißt dort, wie die Anwendung ihn angelegt hat (für opengewerk-haustechnik#422): firstValues in den Teilen des Änderungsprotokolls fragt die Anwendung nach den Werten, mit denen ein Datensatz geschrieben wurde, nur für ein Namensfeld, das sein Protokoll nie geschrieben hat, und was das Protokoll hat, gewinnt. Warum: Zeilen, die eine Anwendung in einem Zug schreibt und als einen Eintrag protokolliert, hießen im Protokoll „ohne Bezeichnung“.

  • Über dem Protokoll eines Datensatzes kann eine Anwendung sagen, woher er stammt (für opengewerk-haustechnik#174): lead in den Wörtern des Änderungsprotokolls, ein Baustein mit Tabelle und Kennung, der nichts zeichnet, wo die Anwendung nichts weiß. Warum: dass ein Datensatz aus einem Import stammt, sagt keine Änderung, und das Protokoll begann bisher mit seiner ersten.

  • Dateien, die ein Gerät behält und wieder freigibt (für opengewerk-haustechnik#348): holdVersion holt die Datei einer Fassung auf das Gerät und behält sie nur, wenn ihre Bytes die sind, die die Fassung nennt (rememberChecked); forgetFile gibt eine geholte Datei wieder frei, eine hier gemachte erst, wenn der Server sie hat (dropFile im lokalen Speicher). Warum: bisher hielt ein Gerät Vorschauen und eigene Fotos, aber nie die Datei eines Dokuments, und eine einmal geholte Datei blieb, bis die ganze Ablage ging.

  • Rollen, die ein Mandant selbst führt (für opengewerk-haustechnik#346): die Anwendung darf an einer Zeile von tenant_roles jetzt Bezeichnung, Rechte, zweiten Faktor und die neue Spalte offered_rights ändern und eine Zeile entfernen; Schlüssel und leads bleiben, wie die Zeile geschrieben wurde. offered_rights hält, was der Katalog beim letzten Speichern einer eigenen Rolle zur Wahl stellte, damit ein Recht einer späteren Fassung von einem weggelassenen zu unterscheiden ist. Welche Zeilen ein Mandant ändert und welche Rechte eine eigene Rolle bekommt, entscheidet die Anwendung an ihren Routen; dahinter hält ein Auslöser (tenant_role_stays_whole im Baustein setup.sql) eine führende Rolle mit jedem Recht und dem zweiten Faktor und lässt keine Rolle gehen, die ein Zugang oder eine offene Einladung nennt (OG004, OG005). Wer Rollen vergibt, hält ihre Zeilen bis zum Schreiben (holdRoles): eine Rolle, die im selben Augenblick entfernt wird, wird nicht vergeben, sondern mit „Unbekannte Rollen“ abgelehnt. Die Handwerkersoftware bietet noch keine eigenen Rollen an und zieht Spalte, Rechte und Auslöser mit 0076_tenant_roles_of_their_own nach. Warum: der Pilotbetrieb der Haustechnik braucht Zuschnitte, die die festen Rollen nicht hergeben.

  • Ein Zugang mit letztem Tag (für opengewerk-haustechnik#339 und #356): memberships.last_day und invitations.last_day, gesetzt mit der Einladung oder dem Wechsel der Rolle (lastDay an POST /staff und PATCH /staff/:userId) und beim Einlösen übernommen. Nach dem letzten Tag, dem Tag in Deutschland, gilt der Zugang wie gesperrt, ohne dass jemand etwas tut: die Identität wird abgelehnt (endedInTenant), die Auswahl nach der Anmeldung bietet den Mandanten nicht mehr an, und wer Fristen verantwortet, Aufgaben und Aufträge bekommt, erinnert wird oder in der Liste der Kollegen aktiv steht, ist sie nicht mehr (stillWorks, beforeItsEnd). AccessRules.endingRoles nennt die Rollen, die es nur mit letztem Tag gibt; die letzte Person, die einen Mandanten führt, bekommt keinen. „Zugänge“ mit Dialogen fragt nach dem letzten Tag und nennt ihn im Zustand („Aktiv bis 30.11.2026“). Die Handwerkersoftware zieht die Spalten mit 0075_membership_last_day nach. Warum: die Haustechnik gibt einem Prüfer von außen einen befristeten Zugang, und das Ende einer Zugehörigkeit (#356) braucht dieselbe Naht.

  • Qualifikationen der Mitarbeiter als Baustein (ADR 0012, für opengewerk-haustechnik#337): Regeln in platform-domain (model/qualification.ts: Stufen einer Person, Prüfungen, Stand an einem Tag und ob jemand die geforderte Art hält) und die Tabellenfabrik qualificationSchema() in platform-server mit den eigenen Arten eines Mandanten und den Qualifikationen je Person, gültig bis, mit Nachweis. Warum: die Haustechnik weist beim Zuteilen auf eine fehlende oder abgelaufene Qualifikation hin, und die Handwerkersoftware plant dieselben Angaben für ihre Mitarbeiterakte; ein Modell statt zwei.

  • Ein Anlass für Push kann ein Recht nennen (für opengewerk-haustechnik#398): right an den Wörtern eines Anlasses, und „Konto“ bietet ihn nur an, wer das Recht hält. Bisher stand jeder Anlass bei jeder Person, auch einer, die er nie betreffen kann, etwa „Eingegangene Störungen“ bei jemandem, der keine annehmen darf; ein solcher Schalter ließ sich umlegen und blieb stumm. Ohne Recht steht ein Anlass wie bisher für alle da.

  • Eine Seite der Anwendung vor der Anmeldung (für opengewerk-haustechnik#332): signedOutPage der Anwendung bekommt die Adresse, unter der die Seite geöffnet wurde, und was es zurückgibt, steht für jemanden ohne Anmeldung an der Stelle der Anmeldung. Gefragt wird erst, wenn feststeht, dass niemand angemeldet ist und die Instanz eingerichtet ist; wer angemeldet ist, bekommt wie bisher die Bildschirme hinter dem Tor. Die Haustechnik braucht das für die Störmeldung ohne Konto über das Etikett, dessen Adresse angemeldet die Akte öffnet.

  • Zwei Schalter am Rahmen vor Ort (für opengewerk-haustechnik#392): SiteFrame lässt mit conflicts={false} den Reiter „Konflikte“ weg und mit office={false} den Vorschlag, das Büro zu nehmen, samt dem Weg dorthin im Menü. Beide stehen ohne Angabe da wie bisher. Eine Anwendung braucht das für Personen, auf deren Gerät nichts in Konflikt geraten kann und für die es kein Büro gibt: der Reiter bliebe immer leer, und das Büro schickte sie gleich wieder zurück.

  • Die Umbuchung im Lager (für opengewerk-haustechnik#391, Nachtrag in ADR 0011): zwei neue Arten einer Buchung, transfer_out und transfer_in, mit dem anderen Lager in counterpart_store_id, und der Bestand rechnet sie mit. Damit zieht ein Artikel, der im falschen Lager angelegt wurde, mit seinem Bestand um, ohne dass eine Zählung vorgibt, es sei gezählt worden.

  • Ein Leserecht je Elternteil für die Ansprechpartner (für opengewerk-haustechnik#328): ContactRoutes.parentReadRight nennt zu einer Art Datensatz das Recht, das eine Person braucht, um dessen Ansprechpartner zu sehen, und GET /contacts lässt alle anderen aus. Bisher gab es das nur fürs Schreiben (parentRight); eine Anwendung, deren Ansprechpartner auch an etwas ohne Ort hängen, braucht es fürs Lesen genauso.

  • Lager, Artikel und Lieferanten als Baustein des Fundaments (ADR 0011, für opengewerk-haustechnik#325): Regeln, Einheiten und der Bestand aus seinen Buchungen in platform-domain, die Tabellenfabrik stockSchema in platform-server. Die Haustechnik braucht ein Lager vor der Abschaltung der Vorgängeranwendung beim Pilotbetrieb, und es soll in der Organisation nur ein Modell davon geben; die Handwerkersoftware bindet es mit #298. Die Prüfung einer EAN zieht dafür aus der Handwerkersoftware ins Fundament.

  • Der Scan vor Ort liest auch den kurzen Strichcode EAN-8 über den Leser des Browsers, für die Entnahme von Material per Scan in opengewerk-haustechnik#326. Kleine Artikel tragen oft nur ihn, und das Lager nimmt eine EAN mit 8 Ziffern an; ZXing las ihn schon, der Leser des Browsers wurde nicht danach gefragt.

  • Der Import schlägt eine Spalte auch vor, wenn ihr Kopf ä, ö, ü und ß ausschreibt (STRASSE, GEBAEUDE), und umgekehrt, für opengewerk-haustechnik#177. Listen aus Programmen ohne Umlaute oder aus der Schweiz bekamen sonst für diese Spalten keinen Vorschlag. Das gilt nur für die Köpfe der Spalten (tableHeadKey); die Werte, an denen ein Import wiedererkennt, bleiben genau, damit nicht zwei ähnliche Namen zusammenfallen.

  • "Angemeldete Geräte" unter "Konto" nennt an jedem Gerät die Netzadresse, von der es sich angemeldet hat, soweit der Webserver davor sie durchreicht (#563). Die Zeile der Sitzung hielt die Adresse schon, nur las sie niemand; wer jetzt eine Adresse sieht, die er nicht kennt, erkennt eine Anmeldung, die nicht seine ist, und meldet das Gerät ab. Die Geräte einer Person, die die Leitung unter "Zugänge" sieht, nennen sie nicht. Die Feature-Gliederung sagt es in v2.36.

  • Je Fristart lässt sich einstellen, wie eine Frist erinnert: per E-Mail und Push, nur per E-Mail oder mit keiner Nachricht (opengewerk-haustechnik#269). Bisher erinnerte jede Frist auf beiden Wegen. Ohne Nachricht steht sie weiter in der Liste und legt ihre Aufgabe oder ihren Auftrag an; nur per Push gibt es nicht, weil Push nur die erreicht, die es für sich eingeschaltet haben. Die Handwerkersoftware bekommt die Spalte mit Migration 0074, und ihre E-Mails und Push-Nachrichten fragen die Einstellung vor dem Schreiben und vor dem Senden.

  • Auch ein errechneter Grenzwert kann einer sein, unter dem ein Messwert bleiben muss (under an WorkedOutValue, opengewerk-haustechnik#299): die Formular-Engine nimmt dann den Grenzwert selbst als außerhalb und schreibt "unter". Die Haustechnik braucht das für einen eigenen Wert mit Quelle in einer Vorlage, etwa den Maßnahmenwert für Legionellen; bisher konnte nur eine Regel eines Pakets so messen.

  • Ein Grenzwert aus einer Regel, unter dem ein Messwert bleiben muss (below an RuleLimit, opengewerk-haustechnik#93): schon das Erreichen ist außerhalb, die Formular-Engine schreibt "unter 100 je 100 ml" und limitMark zeigt <, ebenso der kurze Grenzwert im Protokoll vor Ort und die Liste der Grenzwerte im gedruckten Protokoll, die ihre Worte jetzt aus der Engine nimmt. Die Trinkwasserverordnung verlangt Maßnahmen, sobald ein Befund den technischen Maßnahmenwert für Legionellen erreicht; mit "höchstens" wäre genau dieser Befund als innerhalb durchgegangen.

  • Eine Einladung sagt, wofür der Zugang ist (#623): GET /invitation/:token nennt die Rollen mit den Namen, die der Mandant ihnen gibt, und einen Satz der Anwendung über das, was sie zur Einladung hält (offered an MembershipAdditions, gelesen im Mandanten des Tokens, nur lesend und ohne Anmeldung); der Satz newAccount bekommt beides herein. Nur solange der Link gilt, ein verbrauchter nennt beides nicht mehr. Die Tafel der Haustechnik zeigt Rolle und Bereich, damit die eingeladene Person vor dem Passwort sieht, wofür das Konto ist.

  • Eigene Angaben unter "Konto" (opengewerk-haustechnik#128): Name und E-Mail-Adresse des eigenen Kontos ändert jede Person selbst, nach der Bestätigung mit Passwort und Code aus der App (PATCH /auth/account). Die Änderung steht im Änderungsprotokoll jedes Mandanten, für den das Konto arbeitet, mit dem Weg "Eigene Angaben geändert", und ein offener Link zu einem neuen Passwort endet mit der neuen Adresse. Ein Konto, das für mehrere Mandanten arbeitet oder die Instanz verwaltet, ließ sich bisher gar nicht berichtigen, denn das tut nur die Person selbst. Die Bestätigung zieht dafür aus dem Anlegen eines Passkeys in Reconfirmation um.

  • Rechtstexte der Instanz (opengewerk-haustechnik#129): Impressum und Datenschutzhinweise pflegt, wer die Instanz betreibt, in deren Bereich, und jeder liest sie ohne Anmeldung unter /rechtliches. Der Fuß der Anmeldung verlinkt nur einen Text, der hinterlegt ist, und zeigt jetzt auch auf dem Telefon Lizenz und Version. Bisher stand ein Impressum nirgends, und im Quelltext hätte es für jede Instanz falsch gestanden. Die Handwerkersoftware bekommt die Spalten mit der Migration 0073_instance_legal_texts; ihren Bildschirm bindet sie erst mit einer Tafel. Eine Vorschau, die ohne die Anmeldung des Fundaments startet, gibt die Texte mit legalTexts an authenticationParts trotzdem aus, damit ihre Seite dort zu sehen ist.

  • Das Büro bekommt eine Hilfe neben dem Bildschirm (opengewerk-haustechnik#131): gibt eine Anwendung dem Rahmen ihre Texte herein (help an OfficeFrame), steht in der Kopfleiste ab 1024 Pixeln das Fragezeichen "Hilfe zu dieser Seite" zwischen Suche und Person und darunter derselbe Eintrag am Fuß der Navigation hinter "Menü". Die Schublade zeigt den Text der Seite, die gerade steht, und folgt der Adresse; ab 1024 Pixeln liegt sie neben dem Bildschirm, der dabei bedienbar bleibt, darunter über ihm. Die Texte kommen als Markdown von der Anwendung und werden erst geholt, wenn jemand sie lesen will. Dazu Markdown, ein kleiner Leser für einen festen Teil von Markdown (Überschriften, Absätze, Listen, fett, Code, Verweise): aus einem Text wird nie HTML, ein Verweis führt nur in die Anwendung oder über https hinaus, und markdownProblems nennt dem Test einer Anwendung, was ein Text darüber hinaus benutzt. Mit level sagt eine Anwendung, auf welcher Ebene die Überschriften eines Textes stehen: ist der Text der Bildschirm und nennt dessen Kopf den Titel, folgen die Abschnitte als zweite Ebene, damit keine Ebene übersprungen wird. Eine Anwendung ohne Hilfe zeigt weder Knopf noch Eintrag, weil die Texte zu den Bildschirmen einer Anwendung gehören und das Fundament keine hat.

  • Das Änderungsprotokoll benennt auch eine Liste von Verweisen (opengewerk-haustechnik#171): ein Feld, das mehrere Kennungen anderer Datensätze hält, nennt eine Anwendung in ihrem Vokabular unter referenceLists, mit der Tabelle, in die es zeigt. Bildschirm und Tabelle schreiben dann die Namen der Datensätze statt ihrer Kennungen und eine leere Liste als "leer", der Server liefert die Namen mit der Seite, und auditVocabularyGaps nennt eine solche Angabe, zu der es Tabelle oder Spalte nicht gibt. Vorher ging das nur für ein Feld mit genau einer Kennung, und eine Liste stand als Reihe von Kennungen im Protokoll.

  • Fristen, Zugänge und das Änderungsprotokoll als Tabelle (opengewerk-haustechnik#236): GET /deadlines/table, GET /staff/table und GET /audit/table schreiben, was die Liste unter ihrem Filter zeigt, ganz und nicht als Seite, als Excel oder CSV, und die drei Bildschirme bekommen den Knopf "Als Tabelle" (die Fristen über die Eigenschaft table). Was die Anwendung daneben zeigt, gibt sie über listAsTable, inTable und words an auditLogParts herein. Eine Person nennt eine Tabelle nur für wen die Zugänge sieht (tableNamesPeople), und nur wer sie sieht, grenzt die Fristen als Tabelle auf eine Person ein: so hat es die Projektleitung am 11.10.2026 für die Haustechnik entschieden. Das Änderungsprotokoll nennt in jeder Zeile Personen, auch dort, wo ein Datensatz nach einer Person heißt, und geht deshalb als Tabelle nur an wen die Zugänge sieht; wer es nur liest, bekommt die Absage in einem Satz und keinen Knopf. Eine Liste mit mehr als 50.000 Zeilen lehnt tableAnswer mit einem Satz ab und kürzt sie nie (refuseOverlongTable), damit eine Tabelle den Speicher des Servers nicht beliebig füllt. Die Wörter dieser Listen und der Name eines Geräts stehen dafür in platform-domain, damit Bildschirm und Tabelle dasselbe sagen.

  • Die Bausteine der Aufgaben, wie die Tafeln der Haustechnik sie zeichnen (opengewerk-haustechnik#124): im Formular einer Karte steht der Text allein in seiner Zeile, Tag und Person teilen sich die nächste (ab 1024 Pixeln der Tag in 112 Pixeln); note setzt einen Satz unter die Knöpfe, vor Ort etwa, dass eine Aufgabe auf dem Gerät gesichert ist. Eine abgehakte Aufgabe, die noch nicht beim Server ist, sagt "noch nicht übertragen" in der Farbe dessen, was wartet. Vorher standen Text und Tag in einer Spalte von 320 Pixeln nebeneinander, und der Hinweis fiel im Rest der Zeile nicht auf.

  • Die Aufgaben als Baustein (opengewerk-haustechnik#124): platform-domain hat taskEntity, taskStatuses, TaskBase und die Regeln, die Formular und Abgleich gleich fragen (taskTitleProblem, isTaskOverdue, compareTasksForWork, mayNameForTask, mayChangeTask): eine Aufgabe nennt sich selbst jede Person, eine andere nur, wer Aufgaben verteilt, und ändern darf sie, für wen sie ist, und wer verteilt. Der neue Einstieg @opengewerk/platform-web/tasks bringt die Zeile einer Aufgabe, die Liste in der Reihenfolge, in der jemand sie abarbeitet, und das Formular für eine neue, im Büro und vor Ort. Woran eine Aufgabe hängt, wen sie erreichen darf und wie die Anwendung die Person anredet, gibt die Anwendung herein (ADR 0010), damit die Haustechnik ihre Aufgaben an Ort, Anlage und Vorgang hängt, ohne den Bildschirm ein zweites Mal zu bauen. Die Handwerkersoftware nimmt die beiden Zustände einer Aufgabe von dort, ihre Tabelle bleibt, wie sie ist; ob sie auf den Baustein umzieht, steht in #597.

  • Die Suche über die Datensätze einer Anwendung (opengewerk-haustechnik#125): OfficeFrame nimmt eine Quelle (search) und zeigt ab 1024 Pixeln ein Feld in der Kopfleiste, darunter eine Lupe, die die Suche über dem Bildschirm öffnet; Strg K (Cmd K) springt von jedem Bildschirm hinein. SiteSearch legt dasselbe vor Ort über das, was ein Bildschirm zeigt, und setzt die Treffer an dessen Stelle, solange Wörter dastehen. Die Treffer stehen in Gruppen in der Reihenfolge der Arten, das Gesuchte markiert, der erste gewählt; Pfeiltasten wählen, Eingabe öffnet. Was gesucht wird, wo und wie die Arten heißen, gibt die Anwendung herein (ADR 0010): eine Quelle mit Arten, Wörtern und einer Funktion, die findet. Gefragt wird sie auch ohne Netz, damit sie dann im Bestand des Geräts sucht, und erst ab der kürzesten Länge, die sie nennt. Eine Art mit mehr Treffern sagt es ohne Zahl. Ein Treffer, dessen Adresse vom Server wegführt, wird nicht gezeigt (isOwnAddress), damit kein Link und kein location.assign ihr folgt, gleich welche Anwendung sie liefert: die Adresse beginnt mit /, hat kein Leer- und kein Steuerzeichen (ein Browser streicht Tabulator und Zeilenumbruch, und aus /<Tab>/host würde //host) und bleibt, wie ein Browser sie liest, auf dem eigenen Server. Ohne Quelle hat die Kopfleiste keine Suche, die Handwerkersoftware bleibt, wie sie ist. Mit Quelle steht unter 640 Pixeln die Marke ohne den Namen daneben, damit Lupe und Person auf ein Telefon passen; der Name bleibt der Name des Links.

  • Eine Liste des Büros geht als Tabelle hinaus (opengewerk-haustechnik#138): tableAnswer im Server schreibt, was die Route einer Liste unter den Rechten und in den Bereichen der fragenden Person liest, als Arbeitsmappe (.xlsx) oder als Text mit Semikolon (.csv), und useTableExport im Büro gibt der Liste den Knopf "Als Tabelle" mit beiden Formaten, ab der Breite eines Tablets. Geschrieben wird ohne Paket, wie der Import liest: die Arbeitsmappe ist ein ZIP mit wenigen Teilen XML (zipped neben unzip), die CSV ist UTF-8 mit der Marke am Anfang, damit Excel in Deutschland Umlaute, Zahlen mit Komma und Tage ohne Nacharbeit liest. Ein Wert, der mit =, +, -, @, einem Tabulator oder einem Wagenrücklauf beginnt, wird nie als Formel ausgeführt: in der Arbeitsmappe ist jeder Text eine Textzelle mit dem Zeichen, dass sie Text bleibt, in der CSV steht ein Apostroph davor. Was der Leser des Imports als Tag, Zahl und Text liest, schreibt der Schreiber so, damit eine ausgegebene Liste sich wieder einlesen lässt. requestFile holt eine solche Datei mit der Sitzung und dem Mandanten, in dem die Seite arbeitet.

  • Die Regeln kennen einen Tag im Jahr und den Abstand zu Ostersonntag (opengewerk-haustechnik#200): die Einheiten month_day (der Monat mal hundert und der Tag, 1003 ist der 3. Oktober) und days_from_easter (-2 ist Karfreitag), dazu easterSunday(year) im Kalender und ruleDayIn, das aus einer solchen Regel den Tag eines Jahres macht. Ein Tag, den nicht jedes Jahr hat, wird beim Bau des Regelsatzes abgelehnt. Damit sind gesetzliche Feiertage eines Landes Regeln wie alle anderen, mit Fundstelle und Gültigkeit. Ostern ist gegen die Gaußsche Osterformel als zweite Rechnung über die Jahre 1583 bis 9999 geprüft. Migration 0071 nimmt die beiden Werte in den Typ rule_unit der Einstellungen auf, wie 0066; die Handwerkersoftware speichert keinen davon

  • Die Prüfung der Breiten prüft auf Wunsch einer Anwendung jede Art von Seite auch auf Barrierefreiheit (accessibility an checkWidths, opengewerk-haustechnik#132): mit axe-core nach WCAG 2.1 in den Stufen A und AA, wie die EN 301 549 sie öffentlichen Stellen abverlangt, und den bewährten Regeln von axe, hell und dunkel, bei der Breite eines Telefons und eines Desktops. Beschriftungen, Rollen, die Reihenfolge der Überschriften und der Kontrast gehören dazu; die experimentellen Regeln nicht. Ein Verstoß nennt die Regel und die Elemente und macht die Prüfung rot. Das Skript kommt über das Protokoll des Browsers in die Seite, die Richtlinie der Anwendung bleibt an. Ohne die Option bleibt die Prüfung, wie sie war; die Handwerkersoftware schaltet sie noch nicht ein

  • Bausteine für die Feldarten eines Formulars unter dem neuen Einstieg @opengewerk/platform-web/forms (opengewerk-haustechnik#107): der Prüfpunkt mit seinen vier Antworten, groß für einen Punkt auf eigener Seite und kurz in einer Reihe, der Messwert mit Grenzwert, Urteil und Fundstelle, die Zahl und der Zählerstand mit der Einheit im Feld und einer Rückfrage bei einem Wert, der unmöglich aussieht, die Bemerkung oder der Grund unter einer Antwort, das Foto eines Punkts, die Antwort in einer Liste von Punkten mit dem Fortschritt und der Schlüssel eines neuen Blocks. Die Engine der Formulare liegt seit dem 04.10.2026 im Fundament, gezeichnet hat sie bisher nur die Handwerkersoftware in ihrem eigenen Prüfprotokoll; Prüfpunkt und Zählerstand zeigte keine Anwendung. Die Bausteine halten weder Formular noch Datensatz, wie eine Antwort gespeichert wird, sagt die Anwendung.

  • Der Nummernkreis des Fundaments gibt mehrere Nummern in einem Schritt aus (assignNumbers, opengewerk-haustechnik#100). Wer eine ganze Liste übernimmt, zog bisher je Datensatz eine Nummer, und jede Ziehung ist eine Änderung am Zähler, die im Änderungsprotokoll steht: ein Import von tausend Anlagen schrieb tausend Einträge über den Zähler neben den einen über den Import. Jetzt rückt der Zähler in einer Anweisung um die Zahl weiter, seine Zeile wird einmal gesperrt, und im Protokoll steht eine Änderung. Die Nummern sind dieselben, stehen in ihrer Reihenfolge und gehen wie eine einzelne mit der Transaktion zurück, die sie gezogen hat. assignNumber bleibt, wie es ist.

  • "Zugänge" gibt es im Fundament ein zweites Mal: mit einer Rolle je Zugang, die in einem Dialog vergeben wird (opengewerk-haustechnik#84). Die Haustechnik führt neben einer Zugehörigkeit die Bereiche einer Person, und Rolle und Bereiche sind eine Entscheidung mit einem "Speichern"; die Zeile mit den Kästchen hat dafür keinen Platz. Der neue Bildschirm (StaffDialogsScreen) zeigt je Zugang seine Rolle und eine Spalte der Anwendung, legt einen Zugang in einem Dialog an und bearbeitet ihn in einem zweiten, in dem auch Name und E-Mail berichtigt werden und die Geräte der Person stehen. Die Handwerkersoftware behält ihren Bildschirm, wie er ist. Dazu kommen zwei Bausteine für beide Einstiege: Dialog, ein kurzes Formular über der Seite, und Choice, eine von wenigen als Karten oder in einer Zeile.

  • Wer die Zugänge verwaltet, berichtigt Name und E-Mail eines Kontos (opengewerk-haustechnik#84). Ein Name, der bei der Einladung falsch geschrieben wurde, und eine Adresse, die sich geändert hat, ließen sich bisher von niemandem ändern. Das Fundament bekommt dafür die Route PATCH /staff/:userId/account, hinter demselben Recht wie die Rollen. Ein Konto gehört der Instanz und nicht einem Betrieb, deshalb hat die Route eine Schranke: arbeitet das Konto auch in einem anderen Betrieb der Instanz oder betreibt es die Instanz, lehnt sie ab, und Name und E-Mail bleiben Sache der Person. An die Adresse geht der Link für ein neues Passwort, und wer sie ändern darf, käme sonst an ein Konto, das nicht allein seinem Betrieb gehört. Was von was in was berichtigt wurde, steht im Änderungsprotokoll des Betriebs, über die neue Tabelle account_corrections (Migration 0070): eine Zeile je Berichtigung, die die Anwendung nur lesen und einfügen darf. Lässt sich die Zeile nicht schreiben, wird die Änderung am Konto zurückgenommen. Ein Link für ein neues Passwort, der noch offen ist, endet mit der alten Adresse. Die Oberfläche dieser Anwendung zeigt davon noch nichts.

  • Eine Anwendung schreibt mit, wenn jemand eingeladen wird, beitritt oder andere Rollen bekommt (opengewerk-haustechnik#84). Das Fundament kennt eine Zugehörigkeit nur mit ihren Rollen. Die Haustechnik führt daneben, in welchen Bereichen jemand arbeitet, und das soll schon mit der Einladung feststehen und mit einem Rollenwechsel in einem Zug gespeichert werden, statt in einem zweiten Schritt, der scheitern kann. Die Regeln einer Anwendung nehmen dafür additions (MembershipAdditions): das Fundament ruft sie in der Transaktion, die die Einladung oder die Zugehörigkeit schreibt, nach seiner eigenen Zeile, mit dem, was der Rumpf unter additions nannte, und lehnt die Anwendung ab, wird nichts geschrieben. Beim Einlösen eines Einmal-Links läuft der Aufruf im Mandanten und als die Person, die beitritt. invite und setRoles der Oberfläche reichen dasselbe durch. Für diese Anwendung ändert sich nichts, sie führt nichts neben einer Zugehörigkeit.

  • Ein Formular lässt sich zeichnen, wie eine Tafel es zeichnet, und die schmale Spalte einer Seite steht auf Wunsch links (opengewerk-haustechnik#85). Die Tafel "Neue Liegenschaft" der Haustechnik hat eine Notiz über mehrere Zeilen, eine Postleitzahl, die schmaler ist als der Ort daneben, und ein Sternchen an jedem Pflichtfeld; die Tafel "Liegenschaft" zeichnet Anschrift und Ansprechpartner links und die Gebäude rechts. Das Formular über einem Datensatz (RecordForm) kannte nur einzeilige Felder in gleich breiten Zellen. Ein Feld der Art textarea ist jetzt ein Kasten für mehr als eine Zeile, über die ganze Breite, wenn es nichts anderes sagt; place nennt, wie viele Spalten des Rasters ein Feld nimmt, placeholder ein Beispiel im leeren Feld, und mit starred steht neben dem Namen jedes Pflichtfelds ein Sternchen. Das Sternchen steht neben dem Namen und nicht darin, damit der Name bleibt, wie ein Bildschirmleser ihn vorliest, und es steht nur, wo ein Bildschirm es verlangt: die Anmeldung fragt nur Pflichtfelder und markiert keines. RecordColumns nimmt sideFirst und setzt die schmale Spalte dann an den Anfang, auf dem Bildschirm und in der Seite. Was eine Liste vor ihrem ersten Eintrag sagt, steht als EmptyState auch für sich: die Liste der Liegenschaften zeigt die Gebäude unter jeder Liegenschaft und ist deshalb keine Tabelle aus flachen Zeilen, soll leer aber dasselbe sagen wie jede andere. Für diese Anwendung ändert sich nichts, ihre Formulare, Seiten und Listen stehen wie bisher.

  • Eine Anwendung zeichnet die Karte eines Konflikts selbst, wo weder eine der beiden Fassungen noch ein einzelner weiterer Knopf sagt, was zu entscheiden ist (opengewerk-haustechnik#99). Die Haustechnik braucht das für eine mögliche Dublette aus der Bestandsaufnahme: die Karte zeigt die Anlage, die es schon gibt, und fragt "Ist dieselbe Anlage" oder "Trotzdem anlegen", und das Foto und das Etikett derselben Aufnahme werden mit ihr entschieden statt als drei weitere Karten. Dafür nimmt records im Wert der Anwendung ownDecision: die Antwort ist die Karte, nichts für einen Konflikt, der mit einem anderen entschieden wird, oder die Karte des Fundaments wie bisher. Den Rahmen dazu gibt DecisionFrame aus @opengewerk/platform-web/sync, im Büro und vor Ort derselbe wie um die Karten des Fundaments. Die Handwerkersoftware nutzt es nicht.

  • Das Fundament liest Tabellen, wie jemand sie in einer Tabellenkalkulation führt, und gibt einer Anwendung, was sie braucht, um eine solche Liste zu übernehmen (opengewerk-haustechnik#100). Die Haustechnik importiert damit Liegenschaften, Gebäude, Geschosse, Räume und Anlagen; die Handwerkersoftware nutzt es noch nicht und kann es für Kunden oder Artikel auf demselben Weg tun.

    • platform-domain beschreibt die Tabelle (TableFile, TableSheet), ihre Grenzen (tableLimits: 10 MB je Datei, 10.000 Zeilen, 100 Spalten), die Zuordnung der Spalten zu den Feldern einer Anwendung mit einem Vorschlag nach den Namen der Spalten (suggestedMapping, columnMappingProblem), die Zeilen als Datensätze mit ihrer Zeile in der Datei (tableRecords) und liest CSV mit Semikolon, Komma oder Tabulator (csvRows).
    • platform-server liest eine Datei in diese Tabelle (tableFileOf): eine Arbeitsmappe (.xlsx) mit ihren Blättern oder eine CSV-Datei in UTF-8, UTF-16 oder Windows-1252. Jede Zelle wird der Text, den jemand darin liest: ein Tag als 02.10.2026, eine Zahl mit Komma, ja und nein. Dafür kommt kein Paket dazu. Geprüft wurden vier: exceljs ist seit 2023 ohne Fassung und bringt neun Abhängigkeiten mit, die Fassung von xlsx auf npm hat zwei offene Meldungen der Stufe hoch, hucre ist ein halbes Jahr alt und liest sieben Formate, und read-excel-file ist gepflegt, entpackt aber ohne Grenze: eine Arbeitsmappe von 293 kB, die sich auf 300 MB entpackt, hielt den Prozess 63 Sekunden an und belegte 1 GB. Eine Arbeitsmappe ist ein ZIP-Archiv aus vier Arten von XML-Teilen, und der ZIP-Leser mit Grenze war für DATANORM schon da; er liegt jetzt im Fundament (unzip), entpackt nur die Teile, die gefragt sind, und hält eine Arbeitsmappe bei 60 MB an.
    • Eine Tabelle erreicht eine Route auf zwei Wegen, und für beide gibt es den Baustein (uploadedTable, tableBodyOf mit AcceptsTableFile und AcceptsTable). Als Datei geht sie als Bytes mit ihrem Namen im Kopf; gespeichert wird dabei nichts, weil eine Liste ansehen noch kein Übernehmen ist. Mit dem, was über sie entschieden wurde, geht sie als JSON unter einem eigenen Typ, application/x.table+json: ein solcher Inhalt ist Megabytes groß, der Leser vor den Routen nimmt weiter nur 100 kB JSON an, und gelesen wird er erst für den, den die Guards durchlassen (bodyBytesOf, bisher nur in der Dateiroute).
    • @opengewerk/platform-web/office bringt die Schrittanzeige (Steps), die Karte der Datei mit Blattwahl (TableFilePanel) und die Zuordnung der Spalten (ColumnsPanel), dazu die beiden Anfragen (readTableFile, sendTable). Was die Felder sind und was aus den Zeilen wird, sagt die Anwendung.
  • Das Änderungsprotokoll nennt einen Datensatz mit dem, woran er hängt, wo eine Anwendung das sagt (standsAt im Vokabular, opengewerk-haustechnik#258): hinter seinem Namen steht der Name des Datensatzes, auf den das erste der genannten Felder zeigt, das einen Wert hat, etwa "Zange fehlt, Werkzeug". Datensätze, die sich in ihrer Tabelle einen Namen teilen, standen in der Liste gleich untereinander, und erst der geöffnete Eintrag zeigte, welcher gemeint ist. Der Titel auf der Seite des Protokolls trägt dafür at, und die Seite bringt den Namen dieses Datensatzes mit, auch wenn keine Änderung auf ihr auf ihn zeigt. Es gilt in der Liste, am Chip eines einzelnen Datensatzes, wo ein Feld auf den Datensatz zeigt, und im Protokoll als Tabelle. Hängt das, woran ein Datensatz hängt, selbst an etwas, steht das nicht mehr dahinter. Der Abgleich des Vokabulars mit der Datenbank meldet ein solches Feld, das die Tabelle nicht hat oder das auf nichts zeigt. Eine Anwendung, die nichts nennt, sieht keinen Unterschied.

  • Das Änderungsprotokoll liest einen Wert als Datensatz, wo er hinter einer Vorsilbe auf einen zeigt (prefixedReferences im Vokabular, opengewerk-haustechnik#259): ein Feld, das sonst ein Wort einer Liste hält, nennt mit einer Vorsilbe und einer Kennung einen Datensatz, und im Protokoll stand dafür die Kennung. Die Seite bringt den Namen dieses Datensatzes mit, auch wenn sonst nichts auf ihr auf ihn zeigt, und Bildschirm und Tabelle schreiben ihn statt des Werts. Jeder andere Wert des Felds liest sich wie bisher. Für ein Feld, dessen Wert das Protokoll für sich behält, gilt es nicht. Der Abgleich des Vokabulars mit der Datenbank meldet eine solche Angabe, deren Spalte oder Tabelle es nicht gibt oder die keine Vorsilbe nennt.

  • Das Änderungsprotokoll fragt die Anwendung, wie ein Wert zu schreiben ist, den seine Regeln nicht lesen können (written in den Wörtern des Protokolls, opengewerk-haustechnik#263): was ein Feld als strukturierte Angabe hält, stand als roher Text da. Die Anwendung bekommt Tabelle, Feld und Wert und dazu, wie Zahlen und Tage geschrieben werden, wo gelesen wird; Bildschirm und Tabelle fragen dieselben Wörter. Kein Text heißt, dass die Regeln des Protokolls gelten, ein leerer Text, dass es keinen Wert gibt, und ein langer wird gekürzt wie jeder andere. Für ein Feld, dessen Wert das Protokoll für sich behält, wird die Anwendung nicht gefragt.

  • Mailserver der Instanz (opengewerk-haustechnik#81): im Bereich der Instanz steht unter „Einstellungen“ die Karte „Mailserver der Instanz“. Über ihn gehen die Mails an ein Konto, der Link zu einem neuen Passwort und der Hinweis auf einen neuen Passkey, und über den Mailserver keines Mandanten: ein Konto gehört der Instanz, und wer einen Mandanten leitet, könnte ein Konto zu sich holen, einen eigenen Mailserver eintragen und den Link dort lesen. Eintragen, prüfen und entfernen kann ihn nur, wer die Instanz betreibt und einen zweiten Faktor hat (GET, PUT, DELETE /instance/mail-server, POST /instance/mail-server/check). Das Passwort steht versiegelt an der Zeile der Einstellungen der Instanz, für diesen Zweck allein, und geht an keinen anderen Server und keinen anderen Benutzernamen als die, für die es eingegeben wurde. Das Protokoll der Instanz hält fest, wann ein Passwort gesetzt wurde, und nie das Passwort, auch nicht versiegelt: der Trigger record_instance_change lässt die Spalte aus. Eine Anwendung bindet die beiden Nähte der Authentifizierung mit accountMails und gibt ihre Texte und ihren Namen herein; ohne Mailserver der Instanz geht nichts hinaus. Jede Anwendung braucht dafür eine Migration: sieben Spalten an instance_settings, drei Bedingungen und der geänderte Trigger.

  • Mailserver eines Mandanten und Push als Bausteine der Oberfläche (opengewerk-haustechnik#126): die Karte „Mailserver“ mit Signatur und Vorschau (MailServerSection), der eine Satz für alle ohne das Recht (MailStatusSection), die Karte „Benachrichtigungen“ unter „Konto“ (PushPanel), Push im Menü vor Ort (SitePush) und was ein Gerät dafür braucht (usePush, usePushRefresh, leavePush) liegen im Fundament. Bisher lagen sie in der Handwerkersoftware, und die Haustechnik braucht dieselben Bildschirme. Was nur eine Anwendung weiß, kommt als Wörter herein: was über den Mailserver hinausgeht, woher der Name des Absenders kommt, was eine Signatur enthalten darf und was eine Push-Nachricht sagt; Anlässe und Einstiege sind die Schlüssel, die der Server nennt. Die Handwerkersoftware bindet die Bausteine mit ihren Wörtern, an ihren Bildschirmen ändert sich nichts.

  • Eine Push-Nachricht kann sagen, dass sie kommt, auch wenn ihre Person den Anlass abgeschaltet hat (always am Entwurf, opengewerk-haustechnik#126). Die Haustechnik braucht das für einen Auftrag der Dringlichkeit „sofort“. An ein abgemeldetes Gerät geht auch eine solche Nachricht nicht.

  • Die Sicht des Mailservers eines Mandanten nennt nicht mehr, wann seine Zeile zuletzt geändert wurde (updatedAt, opengewerk-haustechnik#126). Die Haustechnik sagt zu, dass keine Antwort einen solchen Stempel herausgibt (opengewerk-haustechnik#157), und das Formular braucht ihn nicht: es erkennt einen anderen Mailserver an dem, was es zeigt, und an dem Zeitpunkt, zu dem das Passwort gesetzt wurde.

Geändert

  • Die Release-Seite nimmt den Abschnitt einer Fassung bis 120.000 Zeichen, bisher 110.000; GitHub nimmt 125.000, und Hinweis und Anleitung darunter brauchen weniger als 2.500. Warum: 0.6.0 hatte mit seiner Einleitung rund 111.000 Zeichen, und die Seite hätte sonst nur auf den CHANGELOG verwiesen.

  • Die README hält nur noch das Wichtigste: was OpenGewerk ist, den Stand, den Schnellstart, wo die Dokumentation steht, Hilfe und Lizenz. Betrieb, Entwicklung sowie Funktionsumfang und Stand stehen unverändert in docs/betrieb.md, docs/entwicklung.md und docs/funktionsumfang.md; Meldungen, Kommentare, die Seite der Sicherung im Büro und die Beschreibung auf Docker Hub verweisen dorthin. Warum: mit 1463 Zeilen stand die Installation erst nach 560 Zeilen über den Bau.

  • Die Dienste in docker/compose.yaml laufen gehärtet (#688, gefunden in der Sicherheitsprüfung opengewerk-haustechnik#360). Jeder gibt alle Capabilities von root ab (cap_drop: [ALL]) und kann über ein setuid-Programm keine gewinnen (no-new-privileges); Anwendung, Migration, Renderer und Datenbank laufen mit einem Dateisystem, in das nichts schreibt, die Datenbank von Anfang an als postgres. Die Sicherung bleibt root mit beschreibbarem Dateisystem und behält CHOWN, DAC_OVERRIDE und FOWNER, der Zeitplan nur DAC_OVERRIDE, der Grund steht jeweils an ihr. Die Anwendung hat eine Speichergrenze von 10 GB (OPENGEWERK_MEMORY_LIMIT), ihr Heap endet bei drei Vierteln davon. 10-roles.sh setzt die Passwörter mit :'…', so dass auch eines mit Anführungszeichen oder Doppelpunkt gilt. Zwei neue Schritte der CI prüfen beides (test-stack.sh hardening, test-roles.sh). Warum: Ohne Grenze trifft ein voller Speicher womöglich die Datenbank, und ein Dienst, der übernommen wird, soll so wenig dürfen wie möglich.

  • Eine neue Fassung kommt von selbst (für opengewerk-haustechnik#465, Nachtrag in ADR 0004): die Leiste „Eine neue Fassung liegt bereit.“ mit „Jetzt übernehmen“ (UpdateBar) ist aus Büro, Baustelle und dem Bereich der Instanz entfernt, mit offerUpdate, subscribeToUpdates, updateWaiting und applyUpdate. Eine Anwendung übergibt die Registrierung ihres Service Workers an takeUpdates aus @opengewerk/platform-web/shell, und die Seite übernimmt die wartende Fassung selbst: beim Öffnen, wenn sie schon wartete, wenn die Seite verborgen wird, und wenn die Adresse wechselt (useUpdateOnNavigation in den drei Rahmen). Nie, solange etwas sie hält (holdUpdates, useHoldUpdates): RecordForm mit Eingaben, die nicht gespeichert sind, eine Unterschrift auf dem SignaturePad, der Postausgang, während er gesendet wird, und was seit dem letzten Wechsel der Adresse getippt wurde; in der Handwerkersoftware dazu der Entwurf eines Protokolls. Ohne Netz bleibt die Seite bei ihrer Fassung. Eine Seite, die offen bleibt, fragt jede Stunde und bei jeder Rückkehr nach einer neuen Fassung. Für Tests steht standInWorker in @opengewerk/platform-web/testing. Die Handwerkersoftware registriert ihren Service Worker mit onRegisteredSW und einem leeren onNeedReload. Warum: eine neue Fassung soll ohne Zutun ankommen, auch auf einer Seite, die tagelang offen steht und sonst bei der alten bliebe, selbst wenn die mit dem Server nicht mehr abgleichen kann; das Neuladen ist nötig, weil eine Seite der alten Fassung ihre Bildschirme je Adresse nachlädt und der neue Worker nur die Stücke der neuen hält.

  • Die Formulare mit Stromkreis sind ein Teil des Fundaments (Nachtrag in ADR 0014, für opengewerk-haustechnik#350). In platform-domain stehen, was ein Block von seinem Stromkreis hält (CircuitFacts, BlockCircuit, isBlockCircuit), die Liste einer Gruppe je Stromkreis (circuitList) und die Rechner der Grenzwerte für Schleifenimpedanz und Auslösestrom (loopImpedance, residualTripCurrent), für die Begriffe jeder Anwendung; in platform-web unter /electrical die Stromkreise eines Datensatzes in der Reihenfolge des Stromkreisverzeichnisses (useBlockCircuitsOf). Die Handwerkersoftware bindet beides, ihre Protokolle rechnen und ordnen wie bisher. Warum: die Haustechnik misst bei der Prüfung ihrer elektrischen Anlagen je Stromkreis gegen dieselben Grenzwerte, und eine zweite Fassung der Rechner liefe auseinander.

  • Die Elektro-Struktur und die PV-Struktur sind ein Baustein des Fundaments (ADR 0014, für opengewerk-haustechnik#180). In platform-domain stehen Arten, Grenzen, Prüfungen und Texte von Verteiler, Feld, Stromkreis, Betriebsmittel, Wechselrichter, String und Modul samt den Wörtern des Änderungsprotokolls (structureAuditTables); in platform-server die Fabriken electricalSchema und photovoltaicSchema, die Prüfungen des Abgleichs (structureProblem, sectionRefusal) und das Stromkreisverzeichnis (circuitChartJob); in platform-web unter dem neuen Einstieg /electrical die Formulare und Teile der Bildschirme. Woran ein Verteiler und ein Wechselrichter hängen, gibt eine Anwendung als eigene Spalte hinein. Die Handwerkersoftware bindet den Baustein sofort, ihre Tabellen behalten ihre Namen und drizzle-kit generate findet keinen Unterschied, eine Instanz braucht also keine Migration. Was ein Formular über eine unbekannte Art sagt, nennt keinen Produktnamen mehr („Diese Schutzeinrichtung ist unbekannt.“). Warum: die Haustechnik braucht dieselbe Struktur unter ihrer Niederspannungsanlage (opengewerk-haustechnik#349), und zwei Fassungen liefen auseinander; Moritz hat den Umzug am 08.10.2026 entschieden und das ADR am 19.10.2026 angenommen.

  • Bei einer Liste, die nie null ist (.array().notNull()), nimmt der Abgleich die leere Liste als das, was ein Gerät sah, wenn es dort nichts gesehen hat (für opengewerk-haustechnik#451). Ein Gerät hält eine Zeile von vor der Spalte ohne sie und schickt beim ersten Ändern from: null; die Spalte kam aber mit der leeren Liste, und jede erste Änderung wäre ein Konflikt gewesen. Eine Liste, die null sein darf, behält null als Wert. Warum: Die Haustechnik bekommt eine solche Liste an ihren Antworten, und ein Rundgang, der beim Update läuft, soll weitere Fotos nehmen.

  • describe der Fristen einer Anwendung bekommt, wer fragt (für opengewerk-haustechnik#337). Warum: eine Frist liest, wer Fristen ansehen darf, was sie über eine Person sagt, aber vielleicht nur, wer ein weiteres Recht hält; so nennt die Haustechnik den Namen an der Frist einer Qualifikation nur, wer Qualifikationen ansieht.

  • Die Läufe auf einem Stapel halten ihn mit allen Profilen an (#566). Ein Profil auf der Kommandozeile tritt bei Docker Compose an die Stelle des Profils aus der .env, und "down" mit dem Profil der Sicherung ließ den Renderer weiterlaufen, im Schritt "Datenplatte verlieren" wie beim Aufräumen der CI. Der Schritt sagt jetzt, wenn ein Container bleibt.

  • Wer genau einem Mandanten angehört, wird nach der Anmeldung nicht mehr gefragt, welchem (#624): TenantScreen öffnet ihn selbst, wie ein Klick auf seine Kachel, mit dem Gerät vom Eingang vor Ort, und zeigt die Kachel mit dem Grund nur, wenn das nicht ging. Das war ein überflüssiger Klick bei jeder Anmeldung, gerade direkt nach der Ersteinrichtung.

  • Die Bildschirme vor der Anmeldung, der Bereich der Instanz, "Konto" und die Konflikte vor Ort folgen ihren Tafeln (opengewerk-haustechnik#128), die bis dahin niemand gegen die gebaute Oberfläche gehalten hatte. Eine Anwendung kann ihren Namen an der Anmeldung als Familie und Linie zeigen (brand, die Linie in Kupfer); eine Meldung allein in der Karte steht so groß wie "Einen Moment"; der Schlüssel für die Authenticator-App steht in Vierergruppen. Im Bereich der Instanz tragen die Tabellen der Mandanten und der Verwaltung eine Überschrift (ihr Satz caption), das eigene Konto heißt dort "Sie" wie in den Zugängen, der Knopf zum Benennen trägt den Satz der Anwendung, der Link für einen neuen Mandanten steht ohne sichtbare Beschriftung (hideLabel an Field), "Mandant anlegen" bleibt gesperrt, solange er zu sehen ist, und das Protokoll der Instanz zieht seine Karte nicht mehr bis zum Ende des Fensters. Zwei Sätze zum Mailserver nennen die Anwendung nicht mehr, und der Befehl reset-password steht als Code (accountMailMissing nimmt dafür ein ReactNode). "Konto" stellt seine Karten wie die Tafel: Eigene Angaben und Darstellung, Zweiter Faktor und Passwort, dann die Passkeys; unter dem Titel stehen die Rollen. Vor Ort steht über den Konflikten kein Streifen mehr, der zu ihnen führt.

  • completeInitialMigration stellt in der ersten Migration einer Anwendung einen eindeutigen Index vor die Fremdschlüssel und sagt es im Kopf der Datei (#568). drizzle-kit schreibt jeden Schlüssel vor jeden Index, und eine Anwendung, deren erste Migration Dateispeicher und Ablage zugleich anlegt, scheiterte am Schlüssel einer Fassung auf files. Die Migrationen beider Anwendungen bleiben, wie sie sind.

  • Der Dialog mit einem Formular (Dialog) steht auch unter 640 Pixeln in der Mitte des Fensters (opengewerk-haustechnik#147). Auf einem Telefon stand er am oberen Rand, damit eine Tastatur ihn nicht verdeckt; damit stand dieselbe Karte je nach Breite an zwei Stellen, und die Frage daneben seit dem Eintrag darunter in der Mitte. Das Feld, das den Fokus hat, holt der Browser selbst ins Bild. Ein Dialog, der höher ist als das Fenster, beginnt weiter an seinem oberen Rand und lässt sich schieben.

  • Die Frage vor etwas, das sich nicht zurücknehmen lässt (Confirm), steht in der Mitte des Fensters, bei jeder Breite (opengewerk-haustechnik#147). Sie stand ein Fünftel der Höhe von oben, also nur in der Breite mittig, während der Dialog mit einem Formular seit opengewerk-haustechnik#115 in der Mitte steht; auf einem hohen Bildschirm hing sie damit weit über dem, worauf sie sich bezieht. Eine Frage, die höher ist als das Fenster, beginnt an seinem oberen Rand und lässt sich schieben.

  • Die Formulare der Ansprechpartner in der schmalen Karte (opengewerk-haustechnik#147): zeichnet eine Anwendung die Karte mit einer Zeile je Person (dense), fragen ihre Formulare nach einer Sache je Zeile, und "Entfernen" steht in einer eigenen Zeile über "Abbrechen" und "Speichern". RecordForm und NewContactForm nehmen dafür narrow. In einer Spalte von 340 Pixeln standen zwei Felder nebeneinander: von einer E-Mail-Adresse war nur der Anfang zu lesen, der Hinweis unter einem Feld brach in drei Zeilen um, und die drei Knöpfe waren ein paar Pixel breiter als die Karte, so dass "Speichern" allein in die nächste Zeile rutschte. Die Karte, wie sie zuerst gezeichnet war, bleibt, wie sie ist.

  • Wann ein Datensatz zuletzt geändert wurde, von wem und von welchem Gerät, verlässt den Server nicht mehr (opengewerk-haustechnik#157). Der Abruf eines Geräts lässt updatedAt, updatedBy und deviceId weg (travellingRows), und der neue StampInterceptor nimmt sie aus jeder Antwort einer Route, an jedem Datensatz, wie tief er auch steht; updatedBy überall. Eine Anwendung meldet ihn für ihr ganzes Modul an, die Handwerkersoftware tut es. In der Zeile und im Änderungsprotokoll bleiben alle drei. Kein Gerät und kein Bildschirm las sie, aber sie lagen auf jedem Gerät, das den Datensatz lesen darf, und eine Arbeitnehmervertretung fragt genau danach. „Zuletzt geändert“ in den Listen des Büros ordnet deshalb nach der Nummer im Änderungsstrom statt nach dem Zeitpunkt; die Reihenfolge ist dieselbe. Ein Gerät, das einen Datensatz schon hält, verliert den Stempel daran mit dessen nächster Änderung.

  • Ein Dialog des Büros steht auf breiten Bildschirmen senkrecht in der Mitte des Fensters statt oben unter dem Kopf (opengewerk-haustechnik#115). Die Tafeln beider Anwendungen zeichnen ihn über dem Bildschirm, zu dem er gehört, und das Fundament setzte jeden bei 8 % der Fensterhöhe an; einer, der höher ist als das Fenster, beginnt am oberen Rand und rollt. Auf dem Telefon bleibt er oben, wo die Tastatur ihn sichtbar lässt.

  • Der Testbaukasten setzt eine Testdatenbank in einem Bruchteil der Zeit auf den frisch migrierten Stand zurück (#578). resetToMigrated legt sie als Kopie einer Vorlage neu an, in die die Migrationen je Lauf einmal liefen, statt das Schema zu löschen und alle Migrationen neu laufen zu lassen: 0,2 bis 0,3 statt 2 Sekunden je Mal. Die Vorlage heißt nach einem Fingerabdruck der Migrationen, eine geänderte Migration bekommt eine eigene. Die Tests des Fundaments (über probeFoundation().empty()) und 60 Testdateien dieser Anwendung nutzen sie; die Tests der Migrationen selbst bauen weiter. Viele Tests setzten die Datenbank vor jedem einzelnen Test neu auf, und die Servertests waren der längste Teil der CI

  • Die Liste der Fristen blättert auf dem Server (opengewerk-haustechnik#104, #75). Ein Mandant der Haustechnik hat vom ersten Tag an ein paar tausend offene Fristen, und GET /deadlines gab alle Zeilen eines Stands auf einmal; der Bildschirm suchte und filterte dann im Browser. Jetzt nimmt die Route Stand, Art, Person, Suche, die Filter der Anwendung und die Seite (offset, limit, ohne Angabe 50, höchstens 200) und antwortet mit einer Seite, ihrer Zahl und ob weitere folgen; der Bildschirm lädt mit "Weitere laden" nach und sagt "50 von 248". Eingegrenzt auf eine Person nennt die Liste keine Zahl, weder über der Liste noch darunter: wie viele Fristen jemand hat und wie viele davon überfällig sind, ist eine Auswertung über eine Person. Eine Anwendung gibt mit searchIn an ihren Regeln, worin die Suche außerdem sieht, und mit filters eigene Filter, die der Bildschirm zwischen Art und Person zeigt. Die Auswahl der Personen kommt aus usePeople der Anwendung statt aus den geladenen Zeilen. Mit late=true fragt eine Anwendung nach den überfälligen Fristen, um sie zu zählen, und eine Spalte der Anwendung kann in der Tabelle mehr zeigen als ihren Text (cell). Die Handwerkersoftware findet den Kunden einer Frist jetzt auf dem Server.

  • Der ZIP-Leser der DATANORM-Lieferungen liegt im Fundament (packages/platform/server/src/files/zip.ts), weil eine Arbeitsmappe ebenfalls ein Archiv ist (opengewerk-haustechnik#100). Er nennt die Dateien jetzt mit ihrem Ordner und entpackt auf Wunsch nur die gefragten; für DATANORM ändert sich nichts, packages/server/src/datanorm/zip.ts reicht die Dateien wie bisher unter ihrem bloßen Namen weiter, mit derselben Grenze von 400 MB und denselben Sätzen.

  • Das Etikett mit QR-Code ist ein Baustein des Fundaments, und woran ein Etikett hängt, sagt die Anwendung (opengewerk-haustechnik#98). Die Haustechnik klebt Etiketten an Anlagen und an die Türen von Räumen, und Abschnitt 2.1 ihres Konzepts nennt die Etiketten dieser Anwendung unter dem, was sich fast unverändert nutzen lässt; hier hingen Code, Druck und Karte an der Anlage eines Kunden. Was ein Etikett ist, steht jetzt im Fundament: in platform-domain der Code mit seinem Alphabet, die Adresse im QR-Code, das nachsichtige Lesen eines Scans, die beiden Formate und die Prüfung eines Drucks (labelCodeFrom, labelAddress, labelCodeFromScan, labelLayouts, labelPrintProblem, dazu labelPolicy für den Abgleich), in platform-server das Ziehen eines Codes mit Wiederholung (withLabelCode), die Seite für Etikettendrucker und Bogen (labelPrintJob, qrSvg), die zwei Spalten jeder Tabelle von Etiketten (labelColumns, labelCodeShaped, labelIsValid) und der neue Baustein sql/labels.sql mit der Funktion, die ein gesperrtes Etikett gesperrt hält, und in platform-web die Karte des Büros (LabelCard). Ein Druck nimmt jetzt eine Liste von Etiketten, jedes mit eigenem Code und eigenen drei Zeilen, weil die Haustechnik einen Bogen mit vielen verschiedenen druckt. Diese Anwendung bindet die Teile an ihre Anlage, ihr Recht, ihre Routen und ihre Sätze. Für sie ändert sich nichts: die Tabelle bleibt, wie sie war, es gibt keine Migration, und Routen, Abgleich, Karte und PDF antworten wie vorher. Der Scanner vor Ort und die Seite nach dem Scan sind nicht mit umgezogen, sie folgen den Tafeln dieser Anwendung. Nachtrag in ADR 0010.

  • Die Ablage mit ihren Fassungen ist ein Baustein des Fundaments, und woran eine Datei hängt, sagt die Anwendung (opengewerk-haustechnik#97). Die Haustechnik legt Dokumente an Liegenschaft, Gebäude, Raum, Anlage und Vorgang ab, und die Ablage dieser Anwendung kannte Kunde, Objekt, Anlage und Auftrag in jeder Schicht beim Namen. Was eine Datei und eine Fassung sind, steht jetzt im Fundament: die Regeln (attachmentRules), die beiden Tabellen als Fabrik (attachmentsSchema) mit dem Riegel, der eine Fassung hält, wie sie geschrieben wurde (neuer Baustein sql/attachments.sql), die Auslieferung nach der Kennung einer Fassung unter /attachments (attachmentParts), was der Abgleich von einer Datei und einer Fassung fragt (attachmentRecordRules, attachmentVersionFiles) und, unter dem neuen Einstieg @opengewerk/platform-web/attachments, was auf dem Gerät aus einer gewählten Datei wird: ein Foto verkleinert, eine Vorschau für die Liste, die Bytes vor dem Datensatz geschickt, auch ohne Netz. Diese Anwendung bindet sie an ihre vier Orte, ihr Recht und ihre zwei Sätze. Für sie ändert sich nichts: ihre Tabellen bleiben, wie sie waren, es gibt keine Migration, und Routen, Abgleich und Bildschirme antworten wie vorher. Die Karte des Büros und die Liste vor Ort sind nicht mit umgezogen, sie folgen den Tafeln dieser Anwendung. Nachtrag in ADR 0010.

  • Die Oberfläche der Ansprechpartner steht im Fundament (opengewerk-haustechnik#85). Die Karte "Ansprechpartner" des Büros (ContactsPanel), die Liste zum Antippen vor Ort (ContactList) und das Formular für einen neuen (NewContactForm, neuer Einstieg @opengewerk/platform-web/contacts) nehmen von der Anwendung, woran ein Ansprechpartner hängt, wer anlegen und berichtigen darf, und ihre Wörter. Für die Haustechnik kann die Karte einen Ansprechpartner an seiner Route anlegen statt über den Postausgang (make) und zeichnet auf Wunsch eine Zeile je Person (dense). Für diese Anwendung ändert sich nichts: das HTML ihrer Karte und ihrer Liste ist in 26 gemessenen Zuständen vor und nach dem Umzug gleich. Nicht mit umgezogen ist, was die Liste vor Ort konnte und kein Bildschirm je anbot, das Berichtigen und Entfernen. Nachtrag in ADR 0010.

  • Die Ansprechpartner sind ein Baustein des Fundaments, und woran einer hängt, sagt die Anwendung (opengewerk-haustechnik#85). Die Haustechnik führt Ansprechpartner an der Liegenschaft, und der Baustein dieser Anwendung kannte Kunde, Objekt und Lieferant in jeder Schicht beim Namen. Wer jemand ist und wie man ihn erreicht, steht jetzt im Fundament: die Regeln (contactRules), die Tabelle als Fabrik (contactsSchema), die Routen unter /contacts (contactParts) und was der Abgleich von einem Kontakt fragt (contactRecordRules, contactWithoutParent). Diese Anwendung bindet sie an ihre drei Eltern, ihre Rechte und ihre zwei Sätze; ihre Tabelle bleibt, wie sie war. Vier Antworten sind dabei anders geworden. Die Route kürzt Texte, speichert einen leer gelassenen als keinen, wie die Formulare es immer geschickt haben, und lehnt ab, was kein Text ist. Ein Kontakt ohne Nachnamen wird mit "Der Nachname fehlt." abgelehnt. Ein Kontakt, den es nicht mehr gibt, wird mit einem Satz gemeldet statt mit "Not Found". Und der Konflikt eines Kontakts ohne Elternteil nennt alle drei Felder, der Lieferant fehlte dort seit #296. Nachträge in ADR 0010 und ADR 0005.

  • Die Anwendungsrolle entfernt keinen Ansprechpartner mehr endgültig (Migration 0069, opengewerk-haustechnik#85). Ein Kontakt wird als gelöscht markiert, damit ein Gerät, das gerade kein Netz hatte, davon erfährt; das Recht zum Löschen stammte aus der ersten Vergabe über alle Tabellen und wurde nie benutzt. Die Beschreibung der Tabelle im Fundament sagt "markiert, nie entfernt", und die Migration macht das hier wahr, wie 0064 bei den Nummernkreisen. Keine Zeile wird angefasst.

  • Die Navigation des Büros nimmt einen Eintrag vor den Gruppen und Einträge der Anwendung am Fuß, und vor Ort gibt es den Pfad (opengewerk-haustechnik#83). Die Tafeln der Haustechnik zeichnen über den Gruppen eine Übersicht ohne Titel und am Fuß einen Katalog vor "Abgleich" und "Einstellungen". Beides ließ der Rahmen nicht zu: eine Gruppe brauchte einen Titel, und der Fuß gehörte dem Fundament allein. Eine Gruppe ohne Titel steht jetzt als ihre Einträge allein, ohne leere Zeile darüber, und OfficeFrame nimmt unter foot Einträge der Anwendung, die so leise stehen wie die beiden des Fundaments. SiteCrumbs unter /site zeichnet den Pfad über einer Seite vor Ort aus denselben Schritten wie Crumbs im Büro, in der Schrift vor Ort und mit Umbruch am Telefon; der Typ Crumb steht dafür bei den gemeinsamen Bausteinen. Für diese Anwendung ändert sich nichts, sie nutzt keines der drei.

  • Die Prüfung "Breiten und Auflösungen" misst auf mehreren Seiten des Browsers zugleich (#576): hell und dunkel nebeneinander, und je Farbwahl teilen sich zwei Seiten die Arten von Seiten, jede nimmt die nächste, sobald sie frei ist. Eine Anwendung kann die Zahl je Farbwahl nennen (lanes). Geprüft wird dasselbe wie vorher, und die Befunde stehen in derselben Reihenfolge. Nacheinander brauchte der Job in OpenGewerk Haustechnik zuletzt 30 Minuten, nahe an der Frist, die der Browser einer Sitzung in der CI lässt, und er war der längste der CI. Jede Seite öffnet ihre erste Adresse vor der ersten Breite, auch wenn ihre erste Art ein Dialog ist: eine nie geöffnete Seite behält die 800 Pixel, mit denen sie entsteht, und die Prüfung brach in der Haustechnik daran ab.

  • Das Security-Review jedes Pull Requests läuft in GitHub Actions, mit dem Workflow der Organisation (opengewerk/.github#27): für einen Branch dieses Repositorys von einem Mitglied mit einer Shell in der Sandbox von Claude Code, für einen PR von außen nur lesend und erst nach der Freigabe eines Maintainers. Geprüft wird der neueste Commit, ein neuer Push bricht den Lauf davor ab; das Ergebnis steht als Kommentar am PR und als Status PR-Security-Review. Der Aufruf heftet einen Commit des Workflows an. Bisher lief das Review auf dem Rechner von Moritz mit einem kostenlosen Modell, dessen Kontingent am 10.10.2026 aufgebraucht war

  • Das Security-Review gibt einen PR frei oder verlangt Änderungen, wie früher der lokale Reviewer, und läuft mit einem zweiten Konto weiter, wenn das Guthaben des ersten aufgebraucht ist (opengewerk/.github#32 bis #34, Aufruf angehoben). Ein PR von außen bekommt nie eine Freigabe, nur einen Kommentar: über ihn urteilt ein Modell, das Text aus dem PR lenken kann. Hebt ein PR den Aufruf an, liest das Review den Diff des Workflows aus dessen Repository; bisher blieb der neue Commit für das Review ein offener Punkt.

  • Das Security-Review stoppt Docker, bevor es sudo abschaltet, und prüft beides; den Checkout, in dem der Agent schreiben kann, entfernt es gleich nach ihm, bevor der Post-Schritt von actions/checkout dort git aufruft. Lässt sich das Review am PR nicht ablegen, steht der Status auf error statt dauerhaft auf "läuft" (opengewerk/.github#35 und #36, Aufruf angehoben). Vorher war Docker ein zweiter Weg zu root, und eine Git-Konfiguration aus der Sandbox hätte nach ihr außerhalb laufen können.

  • Das Security-Review kann Tests ausführen, auch mit Datenbank: es startet die Testdatenbank dieses Repositorys als PostgreSQL 18 in seiner Sandbox, erreicht die Registry über deren Proxy, findet pnpm im Pfad und installiert in einer Kopie des Checkouts (opengewerk/.github#38 und #40, Aufruf angehoben, mit der Eingabe database). Vorher ließ sich in der Sandbox nichts installieren, und was erst die Datenbank durchsetzt, Policies, Trigger und die Rechte der Rollen, blieb nur gelesen.

  • Die Prüfung "Breiten und Auflösungen" nimmt von einer Anwendung Muster für Adressen, die einen Eintrag mit seinem Schlüssel statt einer Kennung nennen (keys an checkWidths, opengewerk-haustechnik#227). Was eine Gruppe eines Musters fängt, zählt wie eine Kennung, und Seiten, die sich nur dort unterscheiden, sind eine Art. Bisher war jeder solche Eintrag eine Art für sich, die bei jeder Breite hell und dunkel gemessen wurde, und der Gang wuchs mit jedem Eintrag; in der Haustechnik waren es 50 der 177 Arten, alle Seiten ihres Katalogs

  • Handwerkersoftware: der Link zu einem neuen Passwort und der Hinweis auf einen neuen Passkey gehen über den Mailserver der Instanz und nicht mehr über den Mailserver eines Betriebs (opengewerk-haustechnik#81, Migration 0072_instance_mail_server). Die Regel, dass solche Mails nur auf einer Instanz mit genau einem Betrieb hinausgehen (mayMailAccounts), entfällt damit, und der Hinweis auf einen Passkey steht nicht mehr im Postausgang eines Betriebs. Beide Mails unterschreibt OpenGewerk und nicht mehr ein Betrieb. Nach dem Update zu tun: wer eine Instanz betreibt, trägt unter „Instanz verwalten“, „Einstellungen“ den Mailserver der Instanz ein. Bis dahin geht kein Link zu einem neuen Passwort und kein Hinweis auf einen Passkey hinaus, auch nicht auf einer Instanz mit einem Betrieb, auf der das bisher über dessen Mailserver ging; der Weg zurück in ein Konto ist solange der Inhaber oder reset-password auf dem Server.

  • Das Änderungsprotokoll nennt in der Spalte "Änderung" die Werte, wenn sich ein oder zwei Felder geändert haben: "Telefon: 040 987 654 32 → 0621 400 18 24" statt "Telefon" (opengewerk-haustechnik#260). Wer das Protokoll las, sah bisher nur, welches Feld sich geändert hatte, und musste jede Zeile öffnen, um zu sehen, wie. Ab drei Feldern bleibt es bei den Namen. Ein Wert mit mehr als 24 Zeichen wird nicht ausgeschrieben, die Zeile sagt dann, was mit dem Feld geschah: "Notizen neu", "geändert" oder "entfernt". So auch bei einem Wert, den das Protokoll für sich behält und der vorher wie nachher "gesetzt" heißt. Dasselbe steht in der Tabelle, die das Protokoll hinausgibt, und im Protokoll der Instanz

  • Die Beschreibung von versionColumns an attachmentsSchema sagt, dass eine eigene Spalte an der Fassung einer Datei nach dem Anlegen feststeht und keinem Schlüssel mit ON UPDATE CASCADE folgen kann (#569). Der Auslöser, der eine Fassung hält, wie sie geschrieben wurde, lehnt auch die Änderung ab, die die Kaskade auslöst, und die Anweisung dahinter scheitert als Ganzes; die nächste Anwendung sucht dieselbe Stunde nicht noch einmal.

  • Die Nummernkreise und die Sicherung unter "Einstellungen" gehören jetzt dem Fundament (opengewerk-haustechnik#127, ADR 0010): die Routen GET und PUT /settings/number-ranges als numberRangeParts, die Bildschirme "Nummernkreise" und "Sicherung" und die Leiste "Sicherung überfällig" als NumberRangesScreen, BackupScreen und BackupBar in @opengewerk/platform-web/office. Die Haustechnik braucht dieselben Bildschirme; welche Nummernkreise es gibt, wer sie sehen und ändern darf und was die Sätze sagen, gibt die Anwendung mit. In der Handwerkersoftware sehen beide Bildschirme aus wie vorher. Der Lauf "Sicherung und Rückspielen" ruft nach dem Schritt record den Haken after_record der Anwendung, damit sie dort ihre Route der letzten Sicherung fragt.

  • Ein Test hält fest, dass die Breitenprüfung auf einen Knopf wartet, der erst mit einer Antwort des Servers erscheint, und einen, den eine Breite nie zeichnet, weiter meldet (#565). Das Warten selbst kam schon mit #591; vorher galt ein solcher Knopf als "nicht zu sehen", und die Prüfung wurde an einer Seite rot, die niemand angefasst hatte.

Behoben

  • Das Tor richtet die Authenticator-App eines Kontos, das sie schon hat, nicht noch einmal ein (#691). Kam die Anmeldung ohne zweiten Faktor und verlangt eine Rolle ihn, sagt es jetzt, dass die Anmeldung ihn braucht, und bietet das Abmelden an, wie die Tafel "Zweiter Faktor fehlt in der Anmeldung" der Haustechnik es zeigt. Warum: seit #690 gehört der zweite Faktor zur Sitzung, better-auth lehnt ein zweites Einrichten mit "already enabled" ab, und die Person steckte fest.

  • Die Karte eines Konflikts, dessen Datensatz die Person nicht mehr sieht, sagt, warum sie leer ist (#697): "Nicht mehr sichtbar" unter der Art des Datensatzes, der Satz, dass die Änderung deshalb nicht übernommen wurde, und nur "Schließen", im Büro und vor Ort wie die Tafeln "Konflikt ohne Werte" der Haustechnik. Warum: seit #696 kommt ein solcher Konflikt ohne Felder und Werte, und die Karte mit Grund, ohne Zeilen und mit zwei Knöpfen, die beide nur schließen, sah aus wie ein Fehler der Anzeige.

  • Der Fehlerfilter (DatabaseExceptionFilter) schreibt einen Fehler, den er nicht kennt, mit Stack ins Protokoll des Servers, bevor er mit 500 und einem allgemeinen Satz antwortet (#694, gefunden bei opengewerk-haustechnik#475). Was er kennt, eine Ablehnung der Datenbank, einen zu großen Körper oder eine fertige Antwort, bleibt draußen. Warum: Der Filter steht für jede Route und ersetzt damit den von Nest, der den Fehler sonst protokolliert hätte; ein Lesefehler vor einem Druck stand so in keinem Protokoll.

  • Eine neue Fassung wird nicht mehr übernommen, während die Kamera oder die Dateiauswahl eines Dateifelds offen ist, und das eben aufgenommene Foto geht nicht mehr beim Neuladen verloren (für opengewerk-haustechnik#465, Nachtrag in ADR 0004). Ein Dateifeld öffnet auf dem Telefon die Kamera oder die Auswahl und verbirgt damit die Seite, und eine verborgene Seite übernahm eine wartende Fassung und lud neu. Jetzt hält takeUpdates die Fassung für jedes Dateifeld der Seite vom Klick an, auch wenn ein Knopf es anklickt, bis es liefert oder aufgegeben wird (cancel, sonst ein kurzer Augenblick nach der Rückkehr auf den Bildschirm); was es geliefert hat, hält sie danach wie Getipptes bis zum nächsten Wechsel der Adresse. Warum: Die Halte kannten Formulare, Unterschriften und Getipptes, aber nicht den Augenblick, in dem ein Foto entsteht, und genau dann sieht niemand auf die Seite.

  • Die Auswahl „Charakteristik“ im Formular eines Stromkreises zeigt ihren Wert ganz, auch „nicht angegeben“ (gefunden bei opengewerk-haustechnik#349). Vor Ort teilte sie sich die Zeile zu gleichen Hälften mit dem Nennstrom, im Büro bekam sie ein Viertel des Kastens; auf einem Telefon von 390 Pixeln und in einem schmalen Dialog war das zu wenig, und der Wert brach ab. Jetzt ist ihre Spalte mindestens so breit wie ihre längste Wahl, der Rest geht an die Felder daneben. Warum: Was im Feld steht, muss man lesen können, bevor man es ändert.

  • Eine Zahl im Formular eines Stromkreises, die keine ist, meldet readFigure sofort, auch hinter einem Vorzeichen und einer langen Folge von Leerzeichen oder Tabulatoren (Code-Scanning-Alert 22, js/polynomial-redos). Das Muster, das „keine Zahl“ von „zu viele Nachkommastellen“ trennt, hatte Leerzeichen auf beiden Seiten einer Wahl, und bei einer Eingabe, die am Ende scheitert, probierte es jede Teilung durch, mit einer Zeit, die mit dem Quadrat der Länge wuchs. Jetzt kommen die Vorzeichen zuerst ab, und der Rest wird mit einem Muster ohne Wahl geprüft. Warum: Eine eingefügte Zeichenfolge soll den Browser nicht anhalten können.

  • Ein Foto, das abgelegt wird, während der Abgleich die Dateien davor hochlädt, kommt nicht mehr als Konflikt record_missing an seiner Prüfsumme zurück (gefunden bei opengewerk-haustechnik#451). Seine Version stand schon im Ausgang, die Datei aber erst auf der Liste für den nächsten Abgleich, und der Server fand sie nicht. Jetzt wartet eine Änderung, die eine noch wartende Datei nennt, samt den späteren am selben Datensatz, bis die Datei oben ist, und der Abgleich geht dafür eine Runde weiter. Warum: Mehrere Fotos aus der Galerie auf einmal, bei langsamem Netz, trafen das fast jedes Mal.

  • Ein Gerät vor Ort sieht die Konflikte, die der Server für es abgelegt hat, auch wenn die Anmeldung im Büro begann (gefunden bei opengewerk-haustechnik, 19.10.2026). Das Büro schickt ein Telefon auf die Seite für vor Ort, und eine dort angekommene Anmeldung nannte kein Gerät: Der Abgleich sendete unter der Kennung des Geräts, die Liste der Konflikte fragte nach der der Anmeldung und blieb leer. Ein abgelehntes Foto eines Rundgangs verschwand so ohne ein Wort. Jetzt trägt der Start vor Ort das Gerät für die Anmeldung ein (registerDevice), wie es die Anmeldung vor Ort selbst tut, sobald der Server eine Anmeldung ohne Gerät oder mit einem anderen nennt; danach gilt die lange Anmeldung eines Geräts (ADR 0006). Im Büro bleibt es bei der kurzen ohne Gerät. Warum: Was der Server ablehnt, muss auf dem Gerät ankommen, das es geschickt hat, sonst geht es verloren.

  • Eine Antwort ohne Inhalt gilt in request nicht mehr als Fehler (gefunden bei opengewerk-haustechnik#346). Eine Route, die etwas entfernt, antwortet mit 200 und leerem Körper; die Seite las ihn als JSON, scheiterte, nachdem der Server getan hatte, worum er gebeten war, und blieb mit „ohne Verbindung“ auf einem Datensatz stehen, den es nicht mehr gab, etwa auf einem entfernten Entwurf einer Übertragung.

  • Auf dem Telefon öffnet sich der Einstieg vor Ort von selbst, und die Anwendung schaltet um, wenn der Browser zwischen seiner mobilen und seiner Desktop-Ansicht wechselt. Bisher öffnete die Adresse der Instanz immer das Büro: eine gemerkte Wahl hielt nur den Vorschlag still, und ein Telefon, das für seinen Stift einen feinen Zeiger meldet, bekam gar keinen; man musste /m von Hand eingeben. Die Datei vor dem Einstieg (tools/entry-guard.js) entscheidet das jetzt, bevor ein Bündel lädt. Ein Link ins Büro bleibt das Büro, ein Schreibtisch auf der Seite vor Ort bleibt dort, und wer auf dem Telefon das Büro wählt, behält es.

  • Die Rechtstexte der Instanz bleiben nicht mehr leer, wenn sie auf einen Pfad verweisen (opengewerk-haustechnik#386). Markdown zeichnete jeden Pfad als Link des Routers, die Rechtsseite steht aber vor dem Router; dort fand der Link keinen und riss die ganze Seite mit, bei einer Instanz die Datenschutzhinweise mit einem Verweis auf das Impressum. Ohne Router wird ein Pfad jetzt ein gewöhnlicher Verweis im selben Fenster. Unter "Rechtstexte" steht dazu, unter welchen Adressen Impressum und Datenschutzhinweise zu lesen sind, damit ein Verweis zwischen beiden stimmt.

  • Fett und Überschriften eines Texts zum Durchlesen passen zum Text (opengewerk-haustechnik#387). Ein Abschnitt eines Rechtstexts (##) kam als graues Etikett in Kapitälchen, kleiner als der Text darunter, und Fett stand mit dem Gewicht 700 des Browsers, schwerer als jede Überschrift der Anwendung. In reading ist ein Abschnitt jetzt eine Überschrift in der Farbe des Texts mit Abstand davor, Fett hat überall das Gewicht 600. Die Hilfe neben einem Bildschirm behält ihre Etiketten.

  • Der Abgleich legt keinen Konflikt mehr vor, wenn ein Feld anderswo schon auf den Wert gesetzt wurde, den das Gerät setzen will (#601). Er verglich den Wert des Servers nur mit dem, was das Gerät gesehen hatte; in der Haustechnik bekam so jeder einen Konflikt, der die Aufgabe "Zähler ablesen" abhakte, nachdem die Fristen-Engine sie mit den Ständen schon erledigt hatte. Steht jedes Feld schon so, wird die Änderung übersprungen, wie eine, die zweimal ankommt; ein dritter Wert bleibt ein Konflikt.

  • In "Zugänge" stehen die Knöpfe einer Zeile bei 1280 Pixeln wieder nebeneinander, auch wenn die Spalte der Anwendung einen langen Namen zeigt (#562). Die Knöpfe gaben als Erste nach, und jede Zeile wurde doppelt so hoch; in der Haustechnik traf das jeden Zugang mit dem Bereich "Alle Liegenschaften". Jetzt kürzt sich die Adresse unter dem Namen mit Auslassungspunkten, und die Spalten haben die Breiten der Tafel.

  • Eine Runde des Abgleichs, die während eines laufenden Austauschs angefragt wurde, findet auch statt, wenn dieser Austausch scheitert (#572). Hing eine Anfrage an einer schwachen Verbindung und kam das Netz in der Zeit zurück, fiel die Runde des Netzes mit dem Fehler weg, und der Streifen sagte "Keine Verbindung" auf einem Gerät mit Netz, bis etwas anderes eine Runde anstieß. Eine gescheiterte Runde fragt weiter nichts von sich aus an, damit aus einer Ablehnung keine Schleife wird.

  • Ein Knopf, der gesperrt wird, während er den Fokus hat, behält ihn (#629). Wer mit der Tastatur ein Formular abschickte und eine Ablehnung bekam, stand danach am Anfang der Seite, weil ein gesperrtes Element keinen Fokus halten kann; ein Bildschirmleser verlor den Ort. Jetzt trägt der Knopf in dieser Lage aria-disabled, lässt keinen Druck durch und hält den Fokus. Gesperrt, während der Fokus woanders steht, ist er gesperrt wie bisher.

  • Ein Hinweiskasten mit zwei Knöpfen lässt dem Satz auf dem Telefon wieder seine Breite (#564). Symbol, Satz und Knöpfe standen in einer Zeile, die nicht umbrach, und der Satz lief Buchstabe für Buchstabe nach unten. Jetzt gehen die Knöpfe unter den Satz, wo sie nicht daneben passen, und stehen auf dem Desktop weiter rechts.

  • Das Feld für einen Messwert oder Zählerstand zeigt mit der Tastatur den Rahmen in Kupfer wie jedes andere Bedienelement (opengewerk-haustechnik#132). Das Feld nahm ihn sich selbst (outline-none), und sein Rahmen wurde nur dunkler; wer mit der Tastatur durch einen Rundgang ging, sah kaum, wo er stand. Jetzt zeichnet der Rahmen um das Feld den Ring.

  • Die Breitenprüfung drückt nur einen Öffner, der sich drücken lässt (opengewerk-haustechnik#128): ein gesperrter Knopf öffnet nichts, und auf ihn zu warten beendete den Lauf nach einer halben Minute. Unter "Konto" ist "Ändern" der eigenen Angaben gesperrt, bis sich etwas geändert hat.

  • Ein Text in Markdown lässt keine Ebene der Überschriften mehr aus (opengewerk-haustechnik#129): beginnt er bei ## oder überspringt er eine, folgen die Überschriften trotzdem lückenlos auf den Kopf der Seite. Rechtstexte der Instanz schreibt, wer sie betreibt, und die Datenschutzhinweise der Vorschau sprangen auf der Seite "Rechtliches" von der ersten auf die dritte Ebene, was die Breitenprüfung als Befund meldet.

  • Das Menü vor Ort zeigt seine Trennlinien wieder (opengewerk-haustechnik#131): war das Menü höher als das Fenster, wurden die Linien von einem Pixel auf null gestaucht und fehlten ganz. Dasselbe galt für die Linie vor dem Fuß der Navigation hinter "Menü" im Büro und im Bereich der Instanz. Die Linie unter den Zeilen der Anwendung zieht jetzt das Menü selbst, bevor "Zur Büroansicht" und "Abmelden" folgen, wie die Tafel "Menü" sie zeichnet; bisher hing sie am Teil für Push und stand damit vor jeder Zeile, die eine Anwendung nach Push einhängt.

  • Der Kopf einer Seite im Büro bleibt auf dem Desktop eine Zeile, wie auf den Tafeln: Der Titel gibt nach und seine Abzeichen brechen um, die Knöpfe bleiben rechts daneben. Bisher brach die ganze Zeile um, sobald Titel, Abzeichen und Knöpfe nicht nebeneinander passten, und die Knöpfe standen unter dem Titel. Aufgefallen am Nachweis der Haustechnik, der mit opengewerk-haustechnik#111 einen dritten Knopf bekommt. Unter der Breite eines Desktops bleibt es beim Umbruch.

  • Was die neue Prüfung der Barrierefreiheit in den Bausteinen fand (opengewerk-haustechnik#132): Ein Eintrag der Navigation mit Zahl heißt "Fristen, 4 überfällig", sichtbar stand aber "Fristen4" ohne Trennung, und wer per Sprache "Fristen 4" sagt, fand das im Namen nicht; jetzt steht ein Leerzeichen davor. Die Initialen im Knopf des Kontos stehen nicht mehr als Text vor dem Namen, sondern werden aus einem Attribut gezeichnet. Die Leiste unten vor Ort ist eine benannte Region ("Aktionen"), damit ihr Inhalt in einer Landmark steht (WCAG 2.5.3 und 1.3.1)

  • Das Tor einer Zeile im Abgleich (gateFrom) liest den Datensatz, an dem die Zeile hängt, jetzt mit Sperre (#582). Bisher las es ihn ohne: Eine Transaktion, die den Datensatz zur selben Zeit festschrieb, wurde nicht abgewartet, die Zeile wurde gegen den Stand von vorher geprüft und landete, nachdem die Festschreibung die Zeilen schon gelesen hatte. In der Haustechnik konnte so eine Antwort ankommen, nachdem eine Unterschrift die Seite gelesen hatte, und der Nachweis hielt eine andere Antwort als die Zeile. Die Sperre ist die einer Änderung, keine geteilte: Zwei Übertragungen, die denselben Datensatz geteilt halten und ihn danach ändern, etwa zwei Unterschriften unter denselben Vorgang, warten sonst im Kreis aufeinander, und die Datenbank beendet eine von beiden mit einem Fehler. Gefunden im Security-Review von opengewerk-haustechnik#197.

  • Ein Ansprechpartner ohne Nachnamen kommt auf keinem Weg mehr in den Bestand (opengewerk-haustechnik#85). Die Route verlangte den Nachnamen, der Abgleich nicht: ein Name aus lauter Leerzeichen bestand die Prüfung des Browsers für ein Pflichtfeld und wurde über den Postausgang als leerer Name gespeichert, und ein ganz fehlender scheiterte erst an der Datenbank, mit "Die Angaben passen nicht zum Datenmodell." für die ganze Übertragung. Formulare, Route und Abgleich fragen jetzt dieselbe Regel des Fundaments, das Formular zuerst.

  • Eine Auswahlliste zeigt, was das Formular hält (opengewerk-haustechnik#85). Hielt ein Formular einen Wert, den die Liste nicht anbietet, zeigte der Browser ihre erste Auswahl, und gespeichert wurde etwas anderes, als auf dem Bildschirm stand. Aufgefallen ist es am Formular einer neuen Liegenschaft: dort fiel "Bitte wählen" aus der Liste, sobald die ersten Datensätze auf einem neuen Gerät ankamen, die Liste zeigte "Baden-Württemberg", und das Formular meldete "Das Bundesland fehlt.". SelectField zeigt einen solchen Wert jetzt als das, was er ist, und er lässt sich nicht wieder wählen; hält ein Pflichtfeld nichts, hält der Browser das Formular an wie bei einem leeren Feld. In den Tests der Bildschirme dieser Anwendung hält keine Liste einen Wert, den sie nicht anbietet, gemessen mit einer Probe, die in diesem Fall einen Fehler wirft; für sie ändert sich also nichts.

  • Die Prüfung "Breiten und Auflösungen" wartet, bis ein Bildschirm gezeichnet ist (opengewerk-haustechnik#231): nach dem Laden, bis main etwas enthält, und vor "ist nicht zu sehen", bis der Knopf erscheint, jeweils höchstens 10 Sekunden. Bisher fragte sie gleich nach dem Laden, und ein Bildschirm, dessen Datensätze erst danach auf das Gerät kamen, war noch leer oder ohne seinen Knopf. Die Prüfung wurde so an Seiten rot, die niemand geändert hatte, jedes Mal an einer anderen, auch auf main.

  • Ein Befund der Prüfung "Breiten und Auflösungen" nennt, welche Anfragen seiner Seite beim Laden scheiterten, mit Status und Adresse (opengewerk-haustechnik#231). Ein Knopf, der mit einer Antwort des Servers kommt, etwa mit den Rechten, fehlt, wenn diese Antwort fehlt, und Warten bringt ihn nicht zurück; bisher stand im Bericht nur, dass er nicht zu sehen war. Zu einem solchen Befund liegt jetzt auch ein Foto der Seite im Bericht, wie zu einer zu breiten.

  • Ein Befund der Prüfung "Breiten und Auflösungen" zählt erst, wenn er bei einer zweiten Messung derselben Seite wieder da ist (opengewerk-haustechnik#231). Eine zu breite Seite, ein Knopf außer Reichweite und eine verletzte Regel sind bei jedem Öffnen da; was nur einmal da ist, war bisher die Messung selbst, und trotz des Wartens oben wurde die Prüfung weiter an Seiten rot, die niemand geändert hatte, am 13.10.2026 in drei von vier Läufen. Was nur eine der beiden Messungen fand, steht im Bericht vor den Befunden, zählt nicht, und ein Lauf auf GitHub zeigt dazu eine Warnung neben dem Job; die Fotos dazu lädt der Job auch dann hoch, wenn er grün ist.

  • Eine Seite, die nach zehn Sekunden nichts gezeichnet hat, ist in der Prüfung "Breiten und Auflösungen" ein eigener Befund (opengewerk-haustechnik#231). Bisher hieß das bei einer Seite mit Knopf "ist nicht zu sehen", und eine Seite ohne Knopf bestand, weil eine leere Seite nie breiter ist als ihr Fenster. Der Befund nennt, was die Seite dabei meldete: Fehler ihres Skripts und ihrer Konsole, auch abgebrochene Anfragen, und ihren Zustand (ob ihr Skript lief, ob ihre Zeitgeber laufen, ob ein Service Worker für sie antwortet, welche Skripte ankamen). Warum eine Seite manchmal nicht startet, ist damit nicht geklärt; ohne diese Angaben zeigte ein Vorkommen aber nichts, woran es sich klären ließe. Der Gang durch die Seiten öffnet eine leere Seite ein zweites Mal, statt die Seiten hinter ihr ungeprüft zu lassen, und eine leere erste Seite bricht die Prüfung nicht mehr mit der Meldung ab, der Durchgang laufe in der falschen Farbwahl.

  • Eine Anfrage, die der Server abgelehnt hat, stellt der Abfrage-Client des Fundaments nicht ein zweites Mal (OpenGewerk/opengewerk-haustechnik#246). Bisher galt das nur für 401 und 403; ein 404 ging noch einmal hinaus, und dieser zweite Versuch wartet auf ein Fenster, das jemand ansieht. Die Seite eines entfernten Datensatzes meldete deshalb in einem Reiter im Hintergrund eine fehlende Verbindung statt "nicht gefunden". Wiederholt wird jetzt nur, was sich durch erneutes Fragen ändern kann: keine Antwort, ein 5xx, 408 und 429 (isRefusedForGood)

  • Die Wörter des Änderungsprotokolls schlagen einen Wert nur unter den eigenen Einträgen einer Liste nach (gefunden beim Review von opengewerk-haustechnik#261). Das Protokoll hält, was geschrieben wurde, auch einen Wert, der constructor, toString oder __proto__ heißt; eine einfache Liste von Wörtern antwortete darauf mit dem, was jedes Objekt mitbringt, und statt des Werts stand etwas anderes da oder der Bildschirm brach ab. Das gilt für die Wörter eines Felds, die Rollen und Rechte, die Namen von Personen und Geräten und die Titel der Datensätze.

  • Die Prüfung "Breiten und Auflösungen" fotografiert einen Befund bei der Breite, bei der er stand, und misst nach einem Wechsel der Breite erst, wenn die Seite ihm gefolgt ist (opengewerk-haustechnik#280). Jedes Foto war 1280 mal 720 Pixel groß, gleich bei welcher Breite der Befund stand: das Foto von Playwright stellt die Seite auf die Größe, die Playwright für sie führt, und lässt sie dort stehen, und dieselbe Breite noch einmal zu setzen, änderte daran nichts. Das Foto kommt jetzt über die Sitzung des DevTools-Protokolls, die auch die Breite setzt (photograph), und die Prüfung hält an, wenn das Bild oder das Fenster danach eine andere Breite hat. Nach einem Wechsel der Breite wartete sie 150 ms und maß; eine Seite, die bis dahin kein Bild gezeichnet hatte, stand noch im Zuschnitt der Breite davor und galt als "bei 320 px 150 px zu breit", mit dem Suchfeld der Kopfleiste eines Desktops. Jetzt wartet sie, bis die Seite bei der neuen Breite zwei Bilder gezeichnet hat (drawnAt, followed): im ersten erfährt die Seite von ihrer Breite, das zweite gilt dem, was sie daraufhin ändert. Eine Seite, die in zehn Sekunden nicht folgt, hält die Prüfung an, statt gemessen zu werden, wie sie dasteht

  • Startet das Skript eines Einstiegs nicht, lädt sich die Seite einmal von selbst neu und sagt es danach, statt leer zu bleiben (opengewerk-haustechnik#279). Ein Modulskript, das selbst oder in einem seiner Teile nicht geladen werden kann, läuft nie, und das Dokument merkt sich den Fehlschlag: die Seite blieb in ihrer Grundfarbe stehen, ohne ein Wort, und noscript greift nicht, weil JavaScript ja an ist. Das geschieht, wenn die Verbindung reißt, wenn eine Seite aus einem Zwischenspeicher Teile nennt, die es nach einem Update nicht mehr gibt, und es wurde gesehen, wo der Browser die Anfrage nach einem Skript selbst abbrach (opengewerk-haustechnik#275). Der Bau setzt jetzt eine kleine eigene Datei vor das Skript des Einstiegs und einen Satz in die Seite (entryGuard aus @opengewerk/platform-web/tools/entry-guard): die Datei hört den Fehlschlag am Element des Skripts, lädt die Seite einmal neu, und zeigt beim nächsten Fehlschlag den Satz mit dem Knopf "Neu laden". Dass schon neu geladen wurde, hält der Reiter fest, damit ein Teil, der auf Dauer fehlt, die Seite nicht ohne Ende neu lädt; eine Seite, die gestartet ist, vergisst es wieder. Eine eigene Datei und kein Skript in der Seite, weil die Content-Security-Policy nichts anderes zulässt. checkEntries (tools/entry-check) fragt in der CI einen echten Browser danach, an beiden Einstiegen, mit einmal und mit auf Dauer abgeschnittenem Skript: ob ein Browser den Fehlschlag am Element meldet, weiß kein Test ohne einen

  • Eine Instanz startet ohne die Warnung von better-auth, die Basis-Adresse fehle (#551). Die Anmeldung bekommt jetzt den ersten Eintrag von TRUSTED_ORIGINS als ihre Adresse, die auch das QR-Etikett druckt; Cookies, Passkeys und jede weitere vertraute Adresse bleiben, wie sie waren. Dabei fiel auf, dass better-auth seine Prüfung der Herkunft in Tests von selbst abschaltet; sie steht jetzt ausdrücklich an, und die Tests laufen mit derselben Prüfung wie eine Instanz.

Sicherheit

  • Jede Seite, die der Renderer druckt, trägt eine Content-Security-Policy, die nur Eingebettetes zulässt, und der Renderer hängt in einem eigenen, internen Netz nur mit der Anwendung (#686, gefunden in der Sicherheitsprüfung opengewerk-haustechnik#360). renderPdf setzt die Richtlinie (printPolicy, withPrintPolicy) als Erstes in den Kopf jeder Seite: Bilder und Schriften nur als data:, Stile inline, kein Skript, kein Abruf, kein Formular. In docker/compose.yaml hängt der Renderer nur im Netz printing; test-stack.sh hardening und print-network prüfen das. Warum: die Maskierung der Vorlagen war bisher die einzige Barriere, und der Renderer erreichte im Netz von Compose auch die Datenbank.

  • Der Workflow "Release" behält den Token mit Schreibrecht nicht mehr in .git/config (persist-credentials: false, #644). Warum: kein Schritt danach spricht mit git, und der Token lag sonst während des ganzen Baus der Abbilder auf der Platte; die Haustechnik hält es schon so.

  • Das Installationspaket nennt jedes Abbild der Anwendung mit Fassung und Digest, und start.sh prüft ihre Signatur mit cosign, bevor es sie holt (#687, gefunden in der Sicherheitsprüfung opengewerk-haustechnik#360). Ohne cosign sagt der Start, wie man von Hand prüft; ein Paket mit Digest startet immer seine eigene Fassung, eine Fassung in der .env gilt nur für einen Checkout. Die Basisabbilder im Bau (node:24-alpine, postgres:18-alpine) und die Datenbank in compose.yaml stehen auf einem Digest, den Dependabot nachzieht; test-stack.sh base-images prüft das und dass die Sicherung auf dem Abbild der Datenbank baut. docker/kit-images.sh schreibt Fassung und Digests in das Paket, für beide Anwendungen gleich. Warum: ein Tag nennt, was zuletzt darunter geschoben wurde, und die Signatur der Abbilder prüfte bisher niemand.

  • Die Anwendung prüft beim Start, was ihre Datenbankrolle kann, nicht nur, wie sie heißt (#685, gefunden in der Sicherheitsprüfung opengewerk-haustechnik#360). Ist die Rolle Superuser, hat sie BYPASSRLS, besitzt sie Tabellen oder ist sie Mitglied von opengewerk_owner, startet die Instanz nicht und nennt den Grund (Database.roleProblem im Fundament). Warum: abgelehnt wurden bisher nur die Namen postgres und opengewerk_owner, eine Rolle mit anderem Namen und denselben Rechten startete, und die Mandantentrennung griff dann nicht.

  • Wer die Instanz betreibt, sieht von den offenen Einladungen zur Leitung eines Betriebs nur noch die, die jemand aus dem Bereich der Instanz verschickt hat (#701, gefunden in der Sicherheitsprüfung opengewerk-haustechnik#360). tenants_with_leads() fragt dafür instance_operators, das die Policy readable_by_the_owner bekommt; die Migration 0085_instance_own_invitations ersetzt die Funktion, der Baustein sql/instance.sql zieht nach. Warum: die Liste nannte auch die Adressen, die die Leitung eines Betriebs selbst zur Leitung eingeladen hatte, und was in einem Betrieb entsteht, liest der Bereich der Instanz nicht.

  • Die Anmeldung liest den Körper einer Anfrage nur noch bis 64 kB, und POST /sync liest den Postausgang erst, nachdem die Sitzung geprüft ist (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher las der Handler von better-auth jeden Körper ohne eigene Grenze und der Parser vor /sync bis zu 8 MB, beides bevor feststand, wer die Anfrage schickt. Eine Länge über der Grenze der Anmeldung wird jetzt mit 413 abgewiesen, ohne dass gelesen wird, ein Körper ohne Länge beim Lesen gezählt und abgewiesen, sobald er darüber ist; was darunter bleibt, bekommt better-auth genau so, wie es gesendet wurde (mountAuthentication). Eine Anfrage an /sync ohne Sitzung bekommt 401, ohne dass ihr Körper gelesen wird. Das README empfiehlt dem Reverse Proxy dazu eine Grenze je Pfad, groß nur für /files/ und /sync, mit Beispielen für nginx und Apache.

  • Der zweite Faktor gehört zur Sitzung und nicht mehr zum Konto (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher lasen eine Rolle mit Pflicht zum zweiten Faktor und der Bereich der Instanz am Konto ab, ob die App eingerichtet ist, und so galt eine Sitzung, die nur mit dem Passwort begonnen hatte, als zweifach angemeldet, sobald das Konto die App bekam. Jetzt schreibt der Server beim Anlegen einer Sitzung auth_sessions.second_factor: wahr nach dem Code aus der App, einem Wiederherstellungscode oder einem Passkey, in der Sitzung, in der die App eingerichtet wurde, und in der neuen Sitzung nach einem neuen Passwort, wenn die alte ihn hatte; kein Client kann die Spalte setzen. hasSecondFactor fragt nur noch sie, das Tor im Web ebenso (Account.secondFactor). Entsteht eine Sitzung mit zweitem Faktor auf einem Konto mit App, enden dessen Sitzungen ohne, Sitzungen mit Passkey bleiben. Die Handwerkersoftware bekommt die Spalte mit der Migration 0081_session_second_factor; Sitzungen mit Passkey behalten den zweiten Faktor, Sitzungen mit Passwort auf einem Konto mit App enden, weil sich bei ihnen nicht sagen lässt, ob sie mit dem Code begannen. Wer so angemeldet war, meldet sich nach dem Update einmal neu an.

  • better-auth und @better-auth/passkey stehen auf 1.7.11, @better-auth/utils auf 0.5.0. Darin steckt die Korrektur aus better-auth 1.7.7, nach der gleichzeitige Anfragen die Ratengrenzen in PostgreSQL nicht mehr überschreiten; OpenGewerk hält diese Grenzen in der Datenbank und war davon betroffen.

  • Keine Antwort der Anwendung bleibt mehr im HTTP-Cache des Browsers (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher trugen die Antworten der API kein Cache-Control, und das Abmelden löschte die Daten auf dem Gerät, diesen Cache aber nicht. Jetzt trägt jede Antwort Cache-Control: no-store; die gebauten Dateien der Oberfläche behalten ihre Regel, ebenso eine Route, die selbst eine nennt. Das Web fragt die API und Dateien zusätzlich mit cache: 'no-store'. Clear-Site-Data beim Abmelden kommt nicht dazu: ob es die Dateien verschont, die der Service Worker für einen Start ohne Netz hält, lässt die Spezifikation offen. Das README sagt, dass der Proxy keine Antwort zwischenspeichert, und wie man es prüft.

  • Die Grenzen je Adresse zählen nach der Adresse, die die Anwendung selbst bestimmt, auch die der Anmeldung, und eine IPv6-Adresse mit ihrem /64 (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher las better-auth X-Forwarded-For selbst und nur mit genau einem Eintrag, jede andere Anfrage zählte es in einem gemeinsamen Zähler, und jede Grenze zählte eine IPv6-Adresse einzeln. Jetzt schreibt nameTheClient vor der Anmeldung die Adresse aus clientAddress in einen eigenen Header, ersetzt dabei, was ein Client dort mitschickt, und better-auth liest nur diesen. Anfragen, deren Adresse kein Proxy nennt, zählen zusammen in einem Zähler mit derselben Grenze wie eine Adresse, und das Log sagt einmal, was am Proxy fehlt. Zehn falsche Codes aus der App halten das Konto weiter eine Viertelstunde fest, von jeder Adresse aus; das steht jetzt ausdrücklich in der Konfiguration. Für Anwendungen: clientAddress gibt null, wo die Adresse fehlt, und eine Grenze je Adresse zählt nach addressForLimits (limitKey). Das README sagt, dass der Reverse Proxy X-Forwarded-For ergänzen muss, mit Beispielen für nginx und Apache und einer Prüfung.

  • Ein Konflikt aus dem Abgleich gehört dem Gerät und der Person, deren Änderung es war (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher fragten Liste und Erledigen nur nach dem Gerät, und auf einem Gerät, das weitergegeben wird, sah die nächste Person die Konflikte der vorigen samt ihren Werten. Jetzt schreibt der Server die Person der Sitzung in jeden neuen Konflikt (sync_conflicts.user_id), und GET /sync/conflicts und das Erledigen gelten nur für Gerät und Person der Sitzung. Die Werte eines Datensatzes, den die Person nicht mehr sieht, bleiben aus der Liste; ein solcher Konflikt kommt ohne Felder und Werte und lässt sich erledigen. Eine Übertragung des Postausgangs, deren Gerät nicht das der Sitzung ist, wird mit 400 abgewiesen; eine Sitzung am Schreibtisch nennt kein Gerät und sendet wie bisher. Die Handwerkersoftware bekommt die Spalte mit der Migration 0082_conflict_person, die einem Konflikt von vorher die eine Person gibt, die zu der Zeit mit diesem Gerät im Betrieb arbeitete; lässt sich keine eindeutig sagen, sieht ihn niemand.

  • Wer Dateien ablegt, legt in einer Stunde höchstens eine feste Menge ab, und unter einem freien Rest auf dem Datenträger der Dateien wird nichts mehr abgelegt (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher war nur die einzelne Datei auf 25 MB begrenzt, weder ihre Zahl noch ihre Summe, und weil der Speicher nach dem Inhalt entdoppelt, zählte jede neue Datei voll. Jetzt fragt PUT /files/:sha256 vor dem Speichern UploadLimits: ein Konto legt in der letzten Stunde bis 1 GB ab, alle eines Mandanten zusammen bis 5 GB, eine Datei zählt dabei mindestens 100 kB, und darüber kommt 429 mit einem Satz. Bleiben auf dem Datenträger weniger als 2 GB frei, kommt 507, damit Datenbank, Drucke und Sicherung weiterlaufen. Anwendungen bekommen UploadLimits aus fileParts und fragen es auf ihren eigenen Wegen zum Ablegen, die Handwerkersoftware beim Logo des Briefkopfs. Das Gerät behält eine Datei, die mit 429, 507 oder einem Fehler des Servers zurückkommt, und schickt sie beim nächsten Abgleich; bisher ließ es sie bei jeder Antwort außer 401 und 403 fallen. HEIC und HEIF gelten nur noch, wenn die ftyp-Box der Datei sie zeigt; ein Inhalt, der nur als HEIC angegeben ist, wird als application/octet-stream abgelegt, und ein Weg, der nur ein Foto nimmt, weist ihn ab.

  • Ein Datensatz nennt eine abgelegte Datei nur noch, wenn die Person sie selbst abgelegt hat oder eine Zeile in ihrer Reichweite sie schon nennt (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher gehörte die Zeile einer Datei dem ganzen Mandanten, und wer den Hash einer Datei kannte, die er nicht sehen durfte, hängte sie an einen eigenen Datensatz und bekam ihre Bytes. Jetzt schreibt fileRowFor die Person der Transaktion in die neue Tabelle file_uploads, in der jede Person nur ihre eigenen Zeilen sieht, und mayNameFile fragt sie zusammen mit den Orten, die eine Anwendung nennt. Der Abgleich der Fassungen fragt es für die Datei und die Vorschau (attachmentVersionFiles, mit attachmentVersionPlace für Fassungen in Reichweite, deren Ablage nicht entfernt ist); eine Datei, die nicht genannt werden darf, ist ein Konflikt wie eine, die nie ankam. In der Handwerkersoftware fragt es auch der Start eines Imports aus DATANORM, und die Migration 0083_file_uploads gibt jeder Datei von vorher die Person, die sie laut Änderungsprotokoll zuerst abgelegt hat.

  • Den Mailserver der Instanz ändert, wer die Instanz betreibt, nur noch nach der Bestätigung mit Passwort und Code, und jeder Betrieb erfährt davon und von jedem neuen Passwort (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Über diesen Server geht der Link zu einem neuen Passwort; bisher genügte zum Ändern eine Sitzung, und weder die Änderung noch ein zurückgesetztes Passwort stand irgendwo, wo ein Betrieb es sah. Jetzt verlangen PUT und DELETE /instance/mail-server die Bestätigung aus reconfirmation.ts und verbrauchen sie; der Bereich der Instanz fragt sie vor dem Speichern und dem Entfernen. Jede Änderung steht vorher als Zeile von account_mail_server_changes im Änderungsprotokoll jedes Betriebs, mit Server und Absenderadresse vorher und nachher, und geht danach per E-Mail an die Inhaber aller Betriebe, über den Mailserver von vorher und nicht über den neuen (AccountMessages.mailServerChanged, für Anwendungen authenticationParts({ accountMessages })). Jedes neue Passwort, über den Link oder mit reset-password, steht als Zeile von password_resets im Protokoll jedes Betriebs des Zugangs, mit Zeitpunkt und ohne Link oder Token. Einen Tag nach einem neuen Passwort lassen sich keine App und kein Passkey einrichten, damit eine fremde Rücksetzung auffallen kann, bevor ein zweiter Faktor sie festigt. Die Handwerkersoftware bekommt beide Tabellen mit der Migration 0084_password_resets_and_mail_server_changes.

  • Zurückspielen und Prüfen nehmen nur noch ein Archiv, das diese Instanz geschrieben hat, und die Sicherung legt auf dem Ziel nur noch das fertige, verschlüsselte Archiv ab (gefunden in der Sicherheitsprüfung, opengewerk-haustechnik#360). Bisher prüfte restore.sh ein Archiv nur gegen das Manifest im Archiv selbst, und backup.sh legte die Sicherung unverschlüsselt auf das Ziel, bevor age lief, und ließ sie dort, wenn age scheiterte. Jetzt hält jede Sicherung Name und SHA-256 ihres Archivs in archives.sha256 im Volume backup-status fest, auf der Instanz und nicht auf dem Ziel, dazu in last.json; die Prüfsumme kommt aus dem Strom im Container, nicht von der Datei auf dem Ziel. restore.sh und verify.sh lehnen ein Archiv ab, das dort nicht mit derselben Prüfsumme steht, und bei gesetztem BACKUP_AGE_RECIPIENT jedes unverschlüsselte, bevor sie etwas entschlüsseln. Geprüft und gelesen wird dabei eine Kopie im Container, nicht die Datei auf dem Ziel. Für eine neue Maschine ohne das Verzeichnis gibt es --skip-origin-check, das README sagt, wann. Dump und Dateispeicher entstehen im Container mit umask 077, gepackt und verschlüsselt wird in einem Strom in eine verborgene Datei, die erst am Ende ihren Namen bekommt, und bei einem Fehler bleibt auf dem Ziel nichts und im Verzeichnis kein Eintrag; das Verzeichnis wird unter einer Sperre geschrieben. Die Archive sind nur noch für ihren Besitzer lesbar. Den Dump spielt opengewerk_owner zurück statt des Superusers, der Dienst backup bekommt dafür OPENGEWERK_OWNER_PASSWORD, und die Köpfe der Audit-Ketten müssen eine UUID und eine Zahl sein, bevor sie in eine Abfrage gehen. Sicherungen von vor dem Update stehen nicht im Verzeichnis und spielt nur der Schalter zurück.

Installieren und aktualisieren

Das Paket opengewerk-0.6.0.tar.gz enthält den Ordner opengewerk/docker. Zum Installieren entpacken, mit tar --no-same-owner -xzf opengewerk-0.6.0.tar.gz, und im Ordner opengewerk sh docker/start.sh aufrufen. Für ein Update das neue Paket genauso an dieselbe Stelle entpacken, die .env bleibt, und derselbe Befehl. Gebaut wird dabei nichts, geholt werden die Abbilder dieser Fassung, für x86_64 und ARM64:

  • ghcr.io/opengewerk/opengewerk:0.6.0 (sha256:1ab82a4ccfa218a9c53e13be12a701d243b277523f396444280e4079c1efe02c)
  • ghcr.io/opengewerk/backup:0.6.0 (sha256:1c4982f733fa040a8056bea980563eff7ea41ae3e58365fb8fcbd8de271261bc)

Dieselben Abbilder liegen mit denselben Digests und Signaturen auch auf Docker Hub, als opengewerk/opengewerk:0.6.0 und opengewerk/backup:0.6.0. Das Paket holt sie trotzdem aus ghcr.io, denn Docker Hub begrenzt anonyme Pulls.

Gebraucht werden Docker und Docker Compose ab 2.22. Beide Abbilder sind ohne Schlüssel über Sigstore signiert. Prüfen:

cosign verify ghcr.io/opengewerk/opengewerk:0.6.0 \
  --certificate-identity https://github.com/opengewerk/opengewerk/.github/workflows/release.yml@refs/tags/v0.6.0 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com