OpenGewerk 0.3.0

Die dritte Fassung, klein und aus der ersten Einrichtung einer echten Instanz mit 0.2.0 entstanden. Der Name des Betriebs lässt sich jetzt unter "Einstellungen", "Briefkopf" ändern, und die Signatur unter jeder E-Mail trägt, was ein eingetragener Betrieb auf Geschäftsbriefen angeben muss.

Wer 0.2.0 betreibt, aktualisiert mit dem Paket dieser Fassung; Migration 0047 läuft dabei von selbst. Wie bei den Fassungen davor fehlen vor dem produktiven Einsatz die fachliche Abnahme der Regelpakete und der Grenzwerte des Prüfprotokolls (#31) und der Praxistest der E-Rechnung (#133).

Hinzugefügt

• Der Name des Betriebs lässt sich ändern, unter "Einstellungen", "Briefkopf" in der Karte "Betrieb", neben dem Namen auf den Belegen (#276). Bisher schrieb ihn nur die Ersteinrichtung, und ein falscher Name ließ sich nur in der Datenbank korrigieren; auf msk.opengewerk.de stand so ein Name in der Kopfleiste, den niemand getippt hatte. Ändern darf ihn, wer den Briefkopf ändern darf (settings.write). Er wird mit dem Briefkopf in derselben Transaktion gespeichert, und das Audit-Log hält fest, wer ihn geändert hat. Kopfleiste und "Betrieb wählen" zeigen danach den neuen Namen, ebenso ein Beleg, dessen Briefkopf keinen eigenen Namen trägt; ein festgeschriebener behält seinen. Die Anwendungsrolle darf dafür seit Migration 0047 an der Zeile ihres Betriebs in tenants genau name und updated_at ändern. Anlegen, Löschen und die Kennung bleiben gesperrt, wie seit 0007.

Geändert

• Das Feld "Betrieb" der Ersteinrichtung bietet sich Browsern und Passwortmanagern nicht mehr als Firma zum Ausfüllen an (autocomplete="off" statt organization, #276), denn am wahrscheinlichsten kam der fremde Name auf msk.opengewerk.de genau so hinein. Ersteinrichtung und Einstellungen prüfen den Namen mit derselben Regel (businessNameProblem in domain): nicht leer und höchstens 120 Zeichen, weil er in der Kopfleiste steht. Der vollständige Name für die Belege hat sein eigenes Feld.

Behoben

• Die Signatur unter jeder E-Mail trägt mit {briefkopf} jetzt auch, was der Briefkopf unter "Handelsregister und Vertretung" hält, und die USt-IdNr., wie die Fußzeile jedes Belegs (#278). Eine E-Mail an einen Kunden ist ein Geschäftsbrief, und ein eingetragener Betrieb nennt darauf je nach Rechtsform Registergericht, Registernummer und seine Geschäftsführer oder seinen Vorstand (§ 37a HGB, § 35a GmbHG und die Vorschriften der übrigen Rechtsformen); bisher ging jede Nachricht ohne diese Angaben hinaus. Sie stehen unter einer Leerzeile nach den Kontaktdaten, Steuernummer und Bankverbindung bleiben den Belegen vorbehalten. Eine Signatur ohne {briefkopf} trägt sie nicht, und als Sitz gilt der Ort der Anschrift, beides entschieden von Moritz am 26.09.2026. Die Vorschau unter "E-Mail-Einstellungen" zeigt die Angaben ebenso, und die Feature-Gliederung nennt die Pflichtangaben auf Geschäftsbriefen seit v2.21.

Installieren und aktualisieren

Das Paket opengewerk-0.3.0.tar.gz enthält den Ordner opengewerk/docker. Zum Installieren entpacken, mit tar --no-same-owner -xzf opengewerk-0.3.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.3.0 (sha256:4c890924a51d129b21fb024514c37e62710c8a54b8f29e3b0aa7b6cc9eec429e)
• ghcr.io/opengewerk/backup:0.3.0 (sha256:81504825b5446ffdacce479b28a5f91e01cf152d374fcc1f88a8b37bc8a662f9)

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.3.0 \
  --certificate-identity https://github.com/opengewerk/opengewerk/.github/workflows/release.yml@refs/tags/v0.3.0 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com