Format nach Keep a Changelog, ein Abschnitt
pro Paket-Release (Tag <paket>/vX.Y.Z). Jeder Eintrag nennt, was sich ändert
und was ein konsumierendes Tool beim Upgrade tun muss („Migration“) — dieses
Changelog ist die Upgrade-Anleitung für die Tools.
- Upgrade-Leitfaden Vite 8, React 19, Django 6.1 und
Tailwind 4: Reihenfolge, Stolperfallen
mit Fehlermeldung und Lösung, Prüfschritte (Erfahrungen aus abstimmbar und
ausleihbar). Kein Paket-Release nötig:
@basicbar/uiund die Django-Pakete laufen unverändert unter dem neuen Stack.
- Neue Konvention „Kopfzeile: Anmelden und Kontomenü“ im README von
@basicbar/ui: Reihenfolge und Aussehen der Kopfzeile für Gäste und Angemeldete, Aufbau des Kontomenüs (inkl. Tastatur und Telefon) und der Startkarte für Gäste. Bisher sah das in jedem Tool etwas anders aus. - Gerüst:
frontend/src/components/UserMenu.tsx(neu) und die Kopfzeile inApp.tsxfolgen der Konvention (statt LogIn/LogOut-Icons und dauerhaftemPreferencesMenu);CLAUDE.mdverweist darauf. - Migration (bestehende Tools, freiwillig): Kopfzeile und Kontomenü an die Konvention angleichen.
CLAUDE.mdübernimmtcopier updatenicht (_skip_if_exists); die Regel bei Bedarf von Hand ergänzen.
- Dependabot-Version-Updates eingeschaltet (
.github/dependabot.yml): wöchentlich, gruppiert, für GitHub Actions und@basicbar/ui(npm, TipTap immer gemeinsam). Die Django-Pakete bleiben bewusst draußen, damit ihre Untergrenzen nicht steigen. Die CI testet jeden Dependabot-PR. Für die Tools ändert sich nichts.
Fix: Link-Dialog verlor die Textauswahl. Seit dem eigenen URL-Dialog
(0.11.0) war die Auswahl nach dem Schließen des Dialogs in Firefox (und in
Chromium nach Doppelklick-Auswahl) auf den Textanfang zusammengefallen — der
Link wurde dann nirgends gesetzt bzw. nicht entfernt. RichTextEditor merkt
sich jetzt die Auswahl vor dem Dialog (und führt sie über zwischenzeitliche
Änderungen, z. B. einen fertigen Upload, nach) und stellt sie vor
setLink/unsetLink wieder her. Die Bildbeschreibung (Bearbeiten-Modus)
war nicht betroffen: Sie folgt der Position des Bildknotens, nicht der
Auswahl.
Migration: keine; nur die Version auf ui/v0.11.1 heben.
RichTextEditor ohne Browser-Dialoge; neuer Hook onImageInserted.
Alt-Text- und Link-Abfrage laufen über einen eigenen modalen Dialog (natives
<dialog>, beschriftetes Eingabefeld, Enter = OK, Esc = Abbrechen, Fokus
zurück in den Editor) statt window.prompt; ein gescheiterter Upload
erscheint als schließbarer Hinweis unter der Toolbar (role="alert") statt
per window.alert. Ein hochgeladenes Bild wird sofort mit alt=""
eingefügt und erst danach beschrieben — Abbrechen verliert also kein Bild,
und bei zwei schnell hintereinander hochgeladenen Bildern landet jede
Beschreibung auf ihrem eigenen Bild (die Dialoge laufen nacheinander). Neue
optionale Prop onImageInserted({ src, alt, mode, file }) →
Promise<{ alt } | null>: Damit zeigt das Tool einen eigenen Bild-Dialog,
nach dem Upload (mode: "insert") und beim Button „Bildbeschreibung“
(mode: "edit"); Details im README („Rich text“).
Migration: neue Übersetzungs-Keys "OK", "Cancel" und "Dismiss" im
Katalog des Tools ergänzen (de: „OK“, „Abbrechen“, „Schließen“).
onImageInserted ist optional; ohne die Prop verhält sich der Editor wie
bisher, nur mit dem eingebauten Dialog statt der Browser-Abfrage.
Neu: SegmentedControl — Auswahl „eins aus wenigen“ als Pill mit
gleich breiten Segmenten und gleitendem Daumen (Klick, Tastatur, Ziehen mit
Finger/Maus; rastet beim Loslassen ein), herausgelöst aus abstimmbar
(components/ui.tsx). Optisch klar von An/Aus-Filter-Pills unterschieden.
Neu gegenüber abstimmbar: role="radiogroup" statt group (die Segmente
sind role="radio"), size="md" für 44-px-Touch-Ziele, sichtbarer
Fokusring, transition-transform für den Daumen (abgeschaltet bei
prefers-reduced-motion).
Migration: Tarball auf ui/v0.10.0, Vite-Dep-Cache leeren. abstimmbar kann
die eigene Kopie in components/ui.tsx löschen und
import { SegmentedControl, type SegOption } from "@basicbar/ui" nutzen
(Props unverändert, size ist optional). Die Tailwind-content-Zeile für
node_modules/@basicbar/ui/dist muss vorhanden sein (ist es in allen Tools).
Neues Paket: gemeinsamer PDF-Rahmen für herunterladbare Dokumente,
herausgelöst aus abstimmbar (common/pdf.py, Sitzungsprotokoll) und um das
erweitert, was kalkulierbar für seine Berichte braucht: A4 quer
(landscape=True), Ränder (margin_mm), Autor, Tabellen mit
col_widths="auto", rechtsbündigen Zahlenspalten (align_right_from) und
fetten Summenzeilen (strong_rows). Mitgeliefert wird Plus Jakarta Sans
(OFL). Abhängigkeit: reportlab>=4.4,<6 (getestet mit 4.4.4 und 5.1.0),
kein Django.
Migration (abstimmbar): common/pdf.py und common/fonts/ löschen,
from basicbar_pdf import PdfDocument, dazu page_label=gettext_lazy("Page %(page)s of %(pages)s") und image_placeholder=gettext_lazy("[Image]")
übergeben (die msgids stehen schon im Katalog). Migration (kalkulierbar):
report_render.render_pdf auf PdfDocument(landscape=True, margin_mm=15)
umstellen; die Schrift wechselt dabei von Helvetica zu Plus Jakarta Sans.
ai.chat_json kann Bilder senden und das Modell überschreiben. Neue
optionale Keyword-Argumente: images=[(bytes, mime), …] hängt die Bilder als
image_url-Teile (Data-URL, base64) an die User-Nachricht an (für
Vision-Modelle; das Verkleinern übernimmt der Aufrufer), und model="…"
ersetzt AI_MODEL nur für diesen Aufruf (z. B. ein eigenes Vision-Modell).
Ohne images bleibt die Nachricht ein einfacher String, bestehende Aufrufe
ändern sich nicht.
Migration: keine nötig; Tarball/Tag auf integrations/v0.5.0 heben, wenn das
Tool die neuen Argumente nutzen will.
Neues Modul metrics: token-geschützter Prometheus-Endpunkt.
MetricsView (DRF-APIView, nur GET/HEAD) rendert Gauges im
Prometheus-Textformat 0.0.4, ohne zusätzliche Abhängigkeit. Das Tool leitet
ab, implementiert collect(gauges) und hängt den View selbst ein (außerhalb
von /api/, das Paket registriert keine URL). Neues Setting METRICS_TOKEN
(Default ""): leer → 404; sonst nur mit exakt Authorization: Bearer <token>, sonst 401 mit WWW-Authenticate: Bearer. Antworten tragen
Cache-Control: no-store; Accept wird ignoriert (kein 406), Default-
Throttles des Projekts greifen nicht. Das Token muss ASCII sein.
Gauges.gauge(...) escaped Label-Werte und weist ungültige Namen sowie
doppelte Familien und Label-Sets mit ValueError ab. Details im
README („Prometheus-Metriken“).
Migration: nur Version heben; Metriken sind opt-in über METRICS_TOKEN.
Wer sie nutzt: Subclass + URL anlegen, METRICS_TOKEN in beiden
Compose-Dateien durchreichen und /metrics im Caddyfile an app:8000
weiterleiten.
Username-Fallback übernimmt keine lokalen oder LTI-Konten mehr (Security-
Review Abstimmbar). Mit OIDC_MATCH_BY_USERNAME_FALLBACK=True konnte ein
IdP-Login ein lokales Break-Glass-Konto (createsuperuser, kein Subject)
oder ein LTI-natives Konto (lti:<platform>:<sub>) mit gleichem Usernamen
übernehmen — samt Superuser-Rechten. Der Fallback matcht jetzt nur Konten
mit vorhandenem, nicht-lti:-Subject (Subject-Drift nach Realm-Reimport
funktioniert unverändert). Jede Übernahme wird als WARNING mit Username sowie
altem und neuem Subject protokolliert. Kollidiert der Username mit einem
solchen Konto, verweigert create_user sauber mit PermissionDenied (Fehler-
Redirect statt 500, WARNING-Log); das bestehende Konto bleibt unberührt. Die Kollisionsprüfung auf dem
Create-Pfad ist case-insensitiv (username__iexact): eine IdP-Identität
„Frank“ wird abgewiesen, wenn lokal „frank“ existiert — bewusste
Verhaltensänderung, unabhängig vom Fallback-Flag.
Migration: Version heben. Wer sich bewusst auf die Übernahme lokaler Konten verlassen hat, muss diesen Account einmalig manuell mit dem OIDC-Subject versehen.
RichTextEditor verwirft keine Eingaben mehr durch veraltete Echos. Der
Editor glich seinen value per Effekt ab und rief bei jeder Abweichung vom
aktuellen Editor-HTML setContent auf. Die eigenen Änderungen kommen aber
einen Render später als value zurück — unter Last (asynchrone
State-/Autosave-Runden) tippt man dazwischen weiter, das Echo ist dann schon
veraltet und setzte den Editor auf den älteren Text zurück: das neueste
Zeichen ging verloren, ein Leerzeichen am Ende endgültig (ProseMirror
entfernt es beim Parsen). Der Editor merkt sich jetzt seine eigenen
onChange-Werte und ignoriert deren Echos (aktuell wie veraltet). Echte
Änderungen von außen werden weiter übernommen — auch eine, die einem früheren
Wert gleicht (z. B. Formular-Reset auf "", Wechsel zu einer Frage mit
identischem Text).
Migration: Tarball auf ui/v0.9.1, Vite-Dep-Cache leeren. Eigene
Echo-Wrapper um den Editor (abstimmbar: RichTextInput in
TranslatableField.tsx) können entfallen.
Caddyfile leitet an den Dienst app weiter: Caddyfile.jinja schickte
/api/*, /admin/* und /oidc/* an backend:8000. In
docker-compose.prod.yml heißt der Django-Dienst aber app, einen Dienst
backend gibt es dort nicht. Caddy konnte den Upstream deshalb nicht
auflösen: API, Login und Django-Admin waren in Produktion nicht erreichbar,
nur die SPA wurde ausgeliefert. Das Template verwendet jetzt app:8000.
Migration (bestehende Tools): Das Caddyfile gehört dem Tool
(_skip_if_exists), copier update ändert es also nicht. Im eigenen
Caddyfile jedes reverse_proxy backend:8000 durch reverse_proxy app:8000
ersetzen, sofern der Prod-Dienst app heißt. Bereits umgestellt:
kalkulierbar, ansehbar. Nicht betroffen: ausleihbar (älteres Gerüst, dessen
Prod-Dienst heißt weiterhin backend).
App-spezifische Cookie-Namen für Session und CSRF (#22): Browser trennen
Cookies pro Host, nicht pro Port. Tools, die parallel auf demselben Host laufen
(in der Entwicklung mehrere „-bar“-Tools auf localhost), überschrieben sich
gegenseitig sessionid/csrftoken – man war in den anderen Tools abgemeldet
(403 "Anmeldedaten fehlen.") und POSTs scheiterten an CSRF. Das Template
setzt jetzt SESSION_COOKIE_NAME = "<project_slug>_sessionid" und
CSRF_COOKIE_NAME = "<project_slug>_csrftoken". basicbar-auth
(Silent Login, Back-Channel-Logout, whoami mit CSRF-Token) und
basicbar-lti setzen keine festen Cookie-Namen voraus; das Template-Frontend
liest den CSRF-Token aus whoami, nicht aus dem Cookie.
Migration (bestehende Tools): in backend/config/settings.py die zwei Zeilen
ergänzen (Slug des Tools einsetzen). Wer das CSRF-Cookie im Frontend selbst
per Namen liest (z. B. getCookie("csrftoken")), stellt auf den neuen Namen
oder auf den Token aus whoami um. Beim Deploy werden alle Nutzenden einmal
abgemeldet (per Silent-SSO meist sofort wieder angemeldet). Bereits
übernommen: ausleihbar (virtUOS/ausleihbar#105), kalkulierbar.
CapabilitiesView entfernt (Framework-Review: kein Tool hat
GET /api/capabilities/ je aufgerufen — alle vier mischen die Flags in ihr
whoami). An seine Stelle tritt capabilities.capabilities_payload() mit
genau den drei Schlüsseln, die die Tools heute von Hand zusammensetzen
(ai_enabled, content_default_language, content_translation_enabled).
basicbar_integrations.urls enthält nur noch translate/.
Migration: Version heben. Wer basicbar_integrations.urls einbindet,
verliert den unbenutzten Endpunkt — sonst nichts. Empfohlen: in
accounts/views.py whoami als
{**whoami_payload(request), **capabilities_payload(), …} schreiben und die
drei Inline-Flags löschen.
__version__ kommt aus den Paket-Metadaten (importlib.metadata) statt aus
einem zweiten handgepflegten String — die Versionen drifteten im Review
auseinander. Ein nicht installierter Checkout meldet 0.0.0.dev0. Keine
Migration.
- CHANGELOG: alle Releases seit Juli standen unter „[Unreleased] (→ wird …)“, obwohl längst getaggt — jetzt je ein datierter Abschnitt pro Tag.
- README: die Paket-Tabelle nennt keine Versionsnummern mehr (sie waren vom Juli); aktuelle Stände stehen in den Tags und hier.
- Doku-Drift zum Capabilities-Endpunkt in CLAUDE.md und EXTRAKTIONSPLAN bereinigt.
Anlass: abstimmbar #178 (Kontrast) brauchte einen Formularfeld-Rahmen mit ≥ 3:1 (WCAG 1.4.11) und Fehlertext mit ≥ 4.5:1 und überschrieb dafür per CSS den Rahmen des Paket-Editors. Beides wird jetzt Paket-Funktion.
- Neue semantische Farben
fieldunddangerim Preset (mit/ <alpha-value>, also z. B.border-field/50,text-danger). Sie lesen die CSS-Variablen--bb-field-borderund--bb-danger(OKLCH-Kanäle ohneoklch()), deren Defaultsbase.csssetzt (hell unter:root, dunkel unter:root.dark). Defaults und berechnete Kontraste stehen als Kommentar inbase.css:fieldhell0.6 0 0(3.5–3.95:1 auf Weiß/slate-50/100), dunkel0.56 0 0(≥ 3.76:1 auf slate-900/950);dangerhell0.55 0.235 27(≥ 4.74:1), dunkel0.704 0.191 22.216= red-400 (≥ 5.03:1). - Komponenten nutzen die Tokens: Rahmen von
RichTextEditor(Fokusring unverändert) und Standard-Input vonTranslatableField→border-field(sichtbar etwas dunkler als vorher); Pflicht-Sternchen, Übersetzungsfehler und „Pflichtfeld“-Meldung inTranslatableFieldsowie die Fehlermeldung der Übersetzungsleiste →text-danger(vorher rose-500/600/400). - Preset-Kommentar korrigiert: „slate-400 ≥ 4.5:1 auf Weiß“ galt nicht für jede Rampe. Gedämpfter Text ist in beiden Themes gegen Seite und Karten auf ≥ 4.5:1 zu prüfen.
Tönen: Die Defaults sind neutral. Ein Tool färbt sie ein, indem es die Variablen in seinem eigenen (ungeschichteten) CSS überschreibt, z. B.
:root { --bb-field-border: 0.62 0.011 220; --bb-danger: 0.55 0.235 27; }
:root.dark { --bb-field-border: 0.56 0.011 220; }und die Kontraste (field ≥ 3:1, danger ≥ 4.5:1) gegen die eigenen Hintergründe nachrechnet.
Migration:
- Tarball auf
ui/v0.9.0, Vite-Dep-Cache leeren. - Eigene Overrides des Editor-Rahmens (z. B.
.xy-rte > div.rounded-lg { border-color: … }) entfernen; stattdessen--bb-field-bordersetzen, falls der Default nicht passt. Eine lokalefield-Farbe im Tool-Preset durch die Variable ersetzen. - Optional: lokale Fehlerrot-Muster (
text-red-600 dark:text-red-400o. ä.) durchtext-dangerersetzen.
Anlass: Auf Smartphones verdeckte die schwebende Übersetzungsleiste („DE · EN · Alle Felder übersetzen“) Formularinhalte (abstimmbar #179); abstimmbar umging das mit einem verschachtelten Provider und zwei CSS-Overrides auf Paket-Markup. Das wird jetzt Paket-Funktion.
- Verschiebbare Übersetzungsleiste: Die schwebende Leiste von
TranslationFormProviderhat links einen Griff (GripVertical, Name/Tooltip"Move translation controls"). Ziehen mit Maus oder Touch verschiebt die ganze Leiste per CSS-translate(setzt sich mit Tailwind-Transform-Utilities incontrolsClassNamezusammen) – die Position auscontrolsClassNamebleibt der Anker. Die Leiste bleibt vollständig im Viewport (auch nach Fenstergrößenänderung); der Versatz wird pro Browser inlocalStorage(basicbar_translation_controls_offset) gemerkt. Tastatur: Pfeiltasten 16 px, mit Umschalt 64 px;Pos1/Escoder Doppelklick auf den Griff setzen zurück. Ein bloßer Klick tut nichts. Der Griff erscheint nur, solange die Leistefixed/absolutepositioniert ist. Abschalten:movable={false}. - Andockplatz
TranslationControlsSlot({ className?, media? }): ein Platzhalter, den eine Seite dorthin setzt, wo die Leiste im Fluss stehen soll (z. B. oben im Formular). Solange ein Slot gemountet ist und seine Media Query passt (Default"(max-width: 767px)", exportiert alsTRANSLATION_SLOT_MEDIA, = unter Tailwindmd), rendert der nächste Provider die Leiste per Portal in den Slot – ohne Fixed-Positionierung, Griff und Versatz. Sonst schwebt sie wie bisher; der leere Slot ist per:emptyausgeblendet. Bei mehreren Slots gewinnt der zuletzt gemountete. Neue Provider-PropslotControlsClassName(Defaultflex justify-end, also rechtsbündig) für die angedockte Variante;controlsClassNamegilt nur für die schwebende. - Rich-Text-Toolbar bricht um (
flex-wrap) statt horizontal zu scrollen – auf schmalen Screens waren die versteckten Buttons nicht zu erahnen; wo die Zeile passt, ändert sich nichts. - Sprach-Tabs von
TranslatableField: Trefferfläche per::afterauf ≥ 24 px Höhe (WCAG 2.5.8), Optik unverändert.
Migration:
- Tarball auf
ui/v0.8.0, Vite-Dep-Cache leeren. - Neuen Übersetzungs-Key
"Move translation controls"in den deutschen Katalog aufnehmen (Vorschlag:"Übersetzungsleiste verschieben"). - Optional:
<TranslationControlsSlot />oben in Formulare mit übersetzbaren Feldern setzen (innerhalb desTranslationFormProvider), damit die Leiste auf Smartphones im Fluss steht statt Inhalte zu verdecken. Wer die Leiste in Tests über eine Hook-Klasse findet, gibt sie auch inslotControlsClassNamemit (z. B."my-hook flex justify-end"). Workarounds wie ein verschachtelter Provider pro Formular entfallen. - Lokale Overrides für Toolbar-Umbruch oder Tab-Trefferfläche (falls vorhanden) entfernen.
- Die schwebende Leiste hat jetzt einen Griff – wer das nicht will:
movable={false}.
Sicherheits-Fix stripHtml / isEmptyHtml (#20): Beide parsten über
innerHTML auf einem Element des Live-Dokuments — dort lädt der Browser
Bilder und führt Inline-Handler aus, <img src=x onerror=…> lief also, auch
ohne Einhängen. Jetzt wird in einem inerten DOMParser-Dokument geparst
(nichts wird ausgeführt oder geladen); isEmptyHtml erkennt Bilder über den
geparsten Body statt per Regex. Verhalten sonst unverändert.
Migration: Tarball auf ui/v0.7.2. Keine Code-Änderung nötig.
A11y-Fix TranslatableField (#11): Der hint hatte mit
text-slate-400 nur ~2,6:1 Kontrast und war nicht mit dem Feld verknüpft.
Jetzt text-slate-600 dark:text-slate-300 (AA), und Hinweis,
Veraltet-Hinweis und Pflichtfeld-Fehler hängen per aria-describedby an der
Eingabe (Screenreader lesen sie mit dem Feld vor); Veraltet- und
Fehlertext ebenfalls auf AA-Kontrast (amber-700, rose-600).
renderInput bekommt dafür describedBy, RichTextEditor eine gleichnamige
Prop (auch zur Laufzeit aktualisiert).
Migration: Tarball auf ui/v0.7.1. Wer renderInput mit RichTextEditor
nutzt, reicht zusätzlich describedBy={describedBy} durch (sonst bleibt der
Editor ohne Beschreibung — nichts bricht).
Session-Endpunkte und Routen im Paket (Framework-Review; die vier Tools
trugen identische Kopien): basicbar_auth.views mit whoami_payload /
whoami, logout_view, set_language; basicbar_auth.urls mit
oidc/logout-redirect/, oidc/silent/, oidc/backchannel-logout/,
oidc/callback/ (neu: SafeOIDCCallbackView aus abstimmbar — Browser-
„Zurück“ nach dem Login landet auf der SPA statt auf einer 400-Seite),
mozillas Routen und api/whoami/language/. AbstractBasicUser hat jetzt
language (alle Tools hatten das identische Feld).
Admin-Gruppe entzieht nur, was sie verliehen hat. Bisher setzte
OIDC_ADMIN_GROUP bei jedem Login is_staff/is_superuser hart auf die
Gruppenmitgliedschaft — eine Beförderung in der Nutzerverwaltung des Tools
wurde beim nächsten Login still zurückgenommen. Jetzt wird nur entzogen,
wenn der Claims-Snapshot des vorigen Logins die Gruppe enthielt.
Session-Index statt Komplett-Scan beim Back-Channel-Logout. Neues Model
UserSession (Login-/Logout-Signale), eigene Migration basicbar_auth 0001. Der Scan über alle unabgelaufenen Sessions bleibt nur als Fallback
für Sessions aus der Zeit vor dem Upgrade.
Außerdem: discover_endpoints loggt Fehler als WARNING statt still {} zu
liefern; filter_users_by_claims spart das exists() ohne aktivierten
Fallback.
Migration:
requirements.txt: Tagauth/v0.2.0;python manage.py migrate(legtbasicbar_auth_usersessionan).- Optional: Tools, die von
AbstractBasicUsererben (erkennbar, Template), können ihr eigeneslanguage = CharField(max_length=10, blank=True)ausaccounts.Userstreichen — Django erlaubt das Überschreiben von Feldern abstrakter Basisklassen, es kollidiert also nichts, und die Definition ist identisch (keine DB-Migration,makemigrations --checkbleibt leer; gegen erkennbar geprüft). Tools aufAbstractUser(ausleihbar, abstimmbar, modulierbar) ändern nichts. - Empfohlen:
config/urls.pyaufpath("", include("basicbar_auth.urls"))plus eigenesapi/whoami/umstellen und die lokalenlogout_view/set_languagelöschen;whoamials{**whoami_payload(request), …}schreiben (Beispiel im README). abstimmbar:accounts/oidc.py(SafeOIDCCallbackView) und die eigeneoidc/callback/-Route entfallen. ausleihbar:SetLanguageView(DRF) kann durchset_languageersetzt werden — gleiche URL, gleiche Antworten. - Admin-Semantik prüfen: Wer sich darauf verlassen hat, dass der IdP- Gruppen-Verlust jede Admin-Rolle entzieht, muss lokale Beförderungen jetzt selbst zurücknehmen (Nutzerverwaltung / Django-Admin).
TipTap raus aus den Bundles, die keinen Editor rendern (Framework-Review):
RichTextEditor liegt jetzt in einem eigenen Entry
@basicbar/ui/rich-text-editor; das Paket ist sideEffects: false und wird
mit Code-Splitting gebaut. Der Haupt-Entry @basicbar/ui importiert kein
@tiptap/* mehr. Nagelprobe am gerenderten Template (kein Editor): Bundle
575 kB → 280 kB (gzip 185 → 91 kB). Die @tiptap/*-Pakete bleiben bewusst
dependencies (nicht optionale Peers): sie kosten nur Installationszeit, und
die eine Pin-Stelle für alle Tools bleibt erhalten.
Außerdem:
stripHtml(html)undisEmptyHtml(html)sind exportiert (abstimmbar hatte vier Kopien).isEmptyHtmlzählt ein Editor-Leer-<p></p>als leer, einen reinen Bild-Inhalt aber als gefüllt;TranslatableFieldmitformat="html"nutzt das für seine Ausgefüllt-Punkte (vorher galt ein Bild ohne Text als „nicht übersetzt“).richTextClass(der Prosa-Default vonRichText) ist exportiert, damit Aufrufer ihn ergänzen können statt zu kopieren;classNameersetzt weiterhin.RichTextEditorhateditable?: boolean(Defaulttrue): schreibgeschützt ohne Toolbar und Cursor, Drop/Paste ignoriert; Umschalten zur Laufzeit viasetEditable.TranslationFormProviderhatcontrolsClassName?für die Position der Floating-Controls (Defaultfixed bottom-6 right-6 z-40) — ersetzt den CSS-Override auf die Utility-Klassen in abstimmbar.renderInputvonTranslatableFieldbekommtonBlurdurchgereicht.- Performance:
TranslatableFieldberechnet die Sprachreihenfolge und den Ausgefüllt-Status pro Render nur noch einmal (vorher pro Tab/Lookup, bei HTML jeweils mit DOM-Parse);targetsim Provider memoisiert. - A11y: die Sprach-Tabs tragen den Status („translated“ …) zusätzlich als
sr-only-Text (der Punkt war farb-only, WCAG 1.4.1);PreferencesMenufokussiert beim Öffnen die erste Zeile und unterstützt Pfeiltasten, Home/End (WAI-ARIA-Menü-Pattern),role="menu"hat einen Namen. - README: Abschnitt „Übersetzungs-Keys“ mit allen Keys des Pakets.
Migration:
package.json: Tarball aufui/v0.7.0.- Jeden
RichTextEditor-Import auf den neuen Pfad umstellen:import { RichTextEditor } from "@basicbar/ui/rich-text-editor";(RichText,RichTextEditorProps-Typ:RichTextbleibt in@basicbar/ui, der Props-Typ kommt aus dem Editor-Entry). Betroffen: ausleihbar (AdminWelcomePage,AdminPagesPage,AdminPoolsPage), abstimmbar (components/TranslatableField.tsx). Tools ohne Editor (erkennbar, modulierbar) ändern nichts. - Optional, empfohlen: lokale
stripHtml-Kopien durch den Export ersetzen (abstimmbar:RoomsPage,ResultsPage,SetPage,QuestionPage— dort!stripHtml(x) && !/<img/.test(x)→isEmptyHtml(x)); abstimmbars.fixed.bottom-6.right-6.z-40-Override inindex.cssdurchcontrolsClassName="fixed bottom-6 right-6 z-40 max-md:bottom-[5.5rem]"am Provider ersetzen. - Katalog: keine neuen Keys.
Sicherheit: Reflected XSS im LTI-Login behoben. Die 400er-Antworten von
lti_login spiegelten iss/client_id aus GET-Parametern in eine
HTML-Antwort (Django-Default-Content-Type) — eine präparierte URL konnte so
Skript auf der Tool-Origin ausführen. Alle Fehlerantworten des Endpunkts sind
jetzt text/plain. Migration: Version heben, sonst nichts.
Sicherheit: Back-Channel-Logout-Tokens werden auf Frische geprüft. Bisher
prüfte der Endpunkt nur Signatur, Nonce-Verbot und iss/aud/events/sub — ein
einmal abgefangenes Token ließ sich unbegrenzt wiederholen (erzwungener
Logout als DoS). Jetzt ist iat Pflicht und darf höchstens
OIDC_BACKCHANNEL_MAX_AGE Sekunden alt sein (neues Setting, Default 300);
exp wird respektiert. Migration: Version heben; bei stark abweichenden
Uhren zwischen IdP und Tool ggf. OIDC_BACKCHANNEL_MAX_AGE erhöhen.
ai.chat_jsonundtranslation_service.translatefangen jetzt alle Transportfehler (ConnectionResetError,IncompleteRead, …) alsAIError/TranslationError, statt sie als 500 durchzulassen.- HTTP-Fehler tragen den Provider-Body in der Meldung (z. B. „HTTP 400: en is not supported“) statt nur „Bad Request“; LibreTranslate-4xx heißen nicht mehr fälschlich „unavailable“.
- Nicht-Objekt-JSON vom Übersetzungsdienst ist ein
TranslationError. - Migration: Version heben; wer
str(exc)an Nutzer durchreicht, zeigt jetzt aussagekräftigere Texte.
- Pins: basicbar-auth
auth/v0.2.0, @basicbar/uiui/v0.7.0. config/urls.pynutztinclude("basicbar_auth.urls")(OIDC-Routen inkl. tolerantem Callback,api/whoami/language/);accounts/views.pyenthält nur nochwhoamials{**whoami_payload(request), …Feature-Flags}—logout_view/set_languagekommen aus dem Paket.accounts.Userhat kein eigeneslanguagemehr (geerbt, Migration unverändert).- Settings brechen produktiv mit
ImproperlyConfiguredab, wennOIDC_OP_ISSUERgesetzt ist, die Discovery aber keine Endpunkte lieferte (sonst scheitert jeder Login später mit unklarem Fehler). REST_FRAMEWORK.DEFAULT_AUTHENTICATION_CLASSESnur nochSessionAuthentication— DRFs Default aktiviertBasicAuthentication, die mit dem Break-glass-Superuser (ModelBackend) jeden Endpunkt für Passwort-Raten ohne Rate-Limit und am CSRF vorbei öffnet. Empfehlung für Bestandstools (abstimmbar, ausleihbar; erkennbar hat es bereits): dieselbe Zeile inconfig/settings.pyübernehmen.- CLAUDE.md: Der ui-Release entsteht als Draft und muss manuell veröffentlicht werden, sonst ist der Tarball nicht abrufbar.
- Template-Refresh (Framework-Review): Paket-Pins aktuell (integrations
0.2.2, auth 0.1.1, lti 0.1.4, ui 0.6.0 — bisher 0.1.0/0.1.0/0.1.2/0.2.1,
d. h. ohne den
clean_media_url-Sicherheitsfix);api.tsfällt im Prod-Build nicht mehr auflocalhostzurück (same-origin) und behandelt 204/FormData korrekt; die 90-Zeilen-SettingsMenu-Kopie ist durchPreferencesMenuaus @basicbar/ui ersetzt (Katalog-Key „Preferences“); Settings verweigernDEBUG=0mit dem Dev-SECRET_KEY. - Prod-Gerüst (bislang nur in abstimmbar/ausleihbar): Root-
Dockerfile(Multi-Stage, SPA gebacken),docker-compose.prod.yml(Pflichtvariablen per:?),.env.prod.example, Release-Workflow nach GHCR. - Neue Copier-Frage
ci_host(github/gitlab, Default github): rendert GitHub-Actions-CI + Release-Workflow oder die GitLab-Pipeline. _skip_if_exists:copier updatelässt Identitäts-/Inhaltsdateien (tailwind.config.js, App.tsx, locales, README/CLAUDE.md, Keycloak-Realm, Caddyfile, .env.prod.example) in Ruhe — erkennbars 11 Hue-Konflikte entfallen damit._message_after_copynennt die ersten Schritte.- Schlankere Images: kein
libpq-dev/gccmehr (Wheels),.dockerignorefür Dev- und Prod-Build-Kontext;gunicornentfernt (ASGI/uvicorn); ruff-Konfiguration (backend/pyproject.toml, Import-Sortierung) und echte Basis-Tests incommon/tests.py. - Repo-CI:
template-probe-Job rendert das Template (mit LTI) und fährt Lint,check,makemigrations --check, Tests gegen PostgreSQL und den Frontend-Build der generierten Anwendung; Paket-Jobs als Matrix mit Caches. - Migration Bestandstools (optional, per
copier update --vcs-ref HEAD): Konflikte sind in Gerüst-Dateien (compose, Dockerfiles, settings, api.ts) zu erwarten — Diff lesen; die Identitätsdateien bleiben unberührt.
Geteilte Einstellungs-Bausteine (ausleihbar#35): LanguageOptions,
AppearanceControl und PreferencesMenu. Die ersten beiden sind Menüzeilen
für das Account-Menü des Tools (je eine beschriftete role="group" mit
menuitemradio-Zeilen, gültig in role="menu"; LanguageOptions hat
heading?); PreferencesMenu ist der runde Einstellungen-Button mit
Popover für nicht angemeldete Besucher. Es gibt bewusst keinen Eintrag „Auto“
bei der Sprache: ohne Wahl folgt der Detector dem System (die angezeigte
Sprache ist markiert), eine Wahl wird von i18next gecacht und ist damit
verbindlich. onChange / onLanguageChange dienen zum serverseitigen
Speichern. README: neuer Abschnitt „Preferences (language & appearance)“.
Migration: additiv, nichts zu tun. Die Tools ergänzen in ihren Katalogen den Schlüssel „Preferences“ (die übrigen — Appearance, Auto, „(follows your system)“, Light, Dark, Language — existieren meist schon).
CSP-tauglicher RichTextEditor (basicbar#9): TipTap hängte beim Mounten
ein <style data-tiptap-style> mit den ProseMirror-Grundregeln an <head> —
unter einer Content-Security-Policy mit style-src 'self' (ohne
'unsafe-inline') blockiert der Browser das, der Editor verliert dann u. a.
sein Umbruchverhalten. Der Editor läuft jetzt mit injectCSS: false; die
Regeln (unverändert aus @tiptap/core src/style.ts, TipTap 3.31) stehen in
base.css — bewusst außerhalb jedes @layer, weil Tailwind die zur Laufzeit
gesetzten ProseMirror-*-Klassen nicht sieht und gelayerte Regeln sonst
entfernen würde. README: neuer Abschnitt „CSP“.
Migration: keine, solange das Tool @basicbar/ui/base.css importiert (wie
im README beschrieben). Wer base.css nicht einbindet, muss die
ProseMirror-Regeln selbst bereitstellen.
Sicherheitsfix: clean_media_url prüfte den rohen String, sodass
Pfade wie /media/%2e%2e/api/whoami/ oder /media/a\..\b durchkamen —
Browser lösen die enthaltenen ..-Segmente nach dem Decodieren aber
trotzdem auf, sodass ein admin-verfasstes <img> einen same-origin GET
auf beliebige Pfade auslösen konnte (basicbar#6). Geprüft wird jetzt der
decodierte, normalisierte Pfad; einfach- und doppelt-encodierte
..-Segmente sowie Backslashes werden abgelehnt.
Fix Runde 2 (basicbar#6): drei weitere Bypasses, die der WHATWG-URL-
Parser aber ein reiner Substring-Check nicht sieht, sind jetzt ebenfalls
abgedeckt: rohe oder %09/%0a/%0d-codierte C0-/DEL-Steuerzeichen
(Browser entfernen sie überall im URL vor dem Auflösen, sodass z. B.
/media/.	./api/ sonst als /api/ aufgelöst würde); ein ?/#
(roh oder codiert), das ein .. davor verbirgt (/media/..?x →
/?x); und url[:300]-Truncation nach der Validierung, die einen
validierten langen Pfad nachträglich wieder auf eine Traversal kürzen
konnte — über 300 Zeichen wird jetzt komplett abgelehnt statt gekürzt.
Migration: keine — reiner Bugfix, die öffentliche Signatur von
clean_media_url/clean_html ändert sich nicht.
Alt-Text für Bilder in RichTextEditor (basicbar#7, WCAG 1.1.1): direkt
nach einem erfolgreichen Bild-Upload fragt der Editor per window.prompt
nach einer Beschreibung (t("Image description (alt text)")) — leere
Eingabe oder Abbrechen setzen beide alt="" (bewusst dekoratives Bild), das
Bild wird in jedem Fall eingefügt. Neuer Toolbar-Button
t("Image description") (nur sichtbar, wenn onUploadImage gesetzt ist),
deaktiviert, solange kein Bild markiert ist; bei markiertem Bild öffnet er
denselben Prompt vorausgefüllt mit dem aktuellen Alt-Text und übernimmt
Änderungen per updateAttributes("image", { alt }) — Abbrechen lässt den
bestehenden Alt-Text unangetastet. ToolbarButton hat dafür eine neue
optionale disabled-Prop (reduzierte Deckkraft, aria-disabled).
Nebenbei behoben: useEditor setzt jetzt shouldRerenderOnTransaction: true
— TipTap 3 rendert standardmäßig nicht mehr bei reinen Selektionsänderungen
neu, sodass sämtliche Toolbar-Buttons (Fett/Kursiv/Überschriften/Link und
jetzt auch der neue Bildbeschreibungs-Button), die ihren aktiven/deaktivierten
Zustand aus editor.isActive(...) lesen, nach einem Klick ohne Dokument-
änderung (z. B. Bild ab-/anwählen) den alten Stand zeigten, bis die nächste
Bearbeitung ein Re-Render auslöste.
Migration: keine für Tools ohne onUploadImage — additiv. Tools mit
Bild-Upload ergänzen die neuen Übersetzungs-Keys
"Image description (alt text)" und "Image description".
RichTextEditor + RichText (modulierbar#5), aus AbstimmBAR verschoben:
der eine WYSIWYG-Editor (TipTap) für formatierte Langtext-Felder — Fett,
Kursiv, Aufzählungen, nummerierte Listen, Link, Überschriften (H2/H3) und
optional Bilder — plus RichText zum Rendern des gespeicherten HTML.
Bilder (Toolbar-Button, Drag&Drop, Einfügen aus der Zwischenablage) gibt es
nur, wenn die App onUploadImage(file) => Promise<string> übergibt (relative
URL, z. B. /media/rich/x.png); ohne die Prop bleiben bestehende <img>-
Inhalte sichtbar, es lassen sich nur keine neuen einfügen. Auf
Upload-Fehler zeigt der Editor t("Image upload failed") per
window.alert und lässt den Inhalt unverändert. Passt zum
Sanitizing-Vertrag von basicbar_integrations.html_sanitize.clean_html
(oder einem gleichwertigen Allowlist-Sanitizer im Tool) — die gespeicherte
HTML wird dort auf genau dieses Subset reduziert. Eingefügtes Rich-HTML
(z. B. aus einer Webseite kopiert) wird per transformPastedHTML gefiltert:
jedes <img>, dessen src nicht mit /media/ beginnt, wird entfernt —
ohne onUploadImage wird jedes eingefügte <img> entfernt. So kann kein
externes Bild am Upload-Flow vorbei ins Dokument gelangen; vorhandene Bilder
im initialen value bleiben unangetastet.
Neue Dependencies: @tiptap/react, @tiptap/pm, @tiptap/starter-kit,
@tiptap/extension-link, @tiptap/extension-image,
@tiptap/extension-bold (alle ^3.27.2); react-dom (>=18) ist jetzt
zusätzlich zu react als Peer-Dependency deklariert (@tiptap/react
importiert es zur Laufzeit).
Der Editor bietet bewusst nur das Subset an, das der Sanitizer behält:
Unterstreichen/Durchgestrichen sind nicht registriert und Links tragen kein
target/rel (das Backend erzwingt rel="noopener" ohnehin). Der externe
value-Sync (Sprachwechsel u. ä.) läuft jetzt außerhalb der Undo-History
(setMeta("addToHistory", false)), damit ein Undo direkt danach nicht in
den vorherigen Inhalt hineinspringt. RichTextEditor hat eine neue optionale
Prop labelledBy (Id eines externen <label>, Alternative zu ariaLabel);
RenderInputArgs (für renderInput) hat entsprechend ein neues optionales
Feld labelId — TranslatableFields eigene Label-Id, additiv und
abwärtskompatibel. Der Bild-Upload-Button ist jetzt per aria-label benannt
und zeigt einen sichtbaren Fokusring; ein fehlgeschlagener Bild-Upload zeigt
zusätzlich zu t("Image upload failed") die Fehlermeldung, falls vorhanden.
Migration: keine für Tools, die die Komponente noch nicht nutzen — additiv.
Ein Tool, das den Editor einsetzt, übernimmt RichTextEditor/RichText
aus @basicbar/ui statt einer lokalen Kopie (z. B. via
TranslatableFields renderInput, labelledBy={labelId} durchreichen) und
ergänzt die Übersetzungs-Keys "Bold", "Italic", "Heading (large)",
"Heading (small)", "Bulleted list", "Numbered list", "Link",
"Enter URL", "Insert image (or drag and drop)", "Image upload failed".
Globaler Sprach-Umschalter (modulierbar#99): Der schwebende
Übersetzungs-Block zeigt jetzt einen kompakten DE/EN-Umschalter, der mit
einem Klick alle gemounteten TranslatableField auf eine Sprache stellt
(über den bestehenden forced-Mechanismus, ohne zu übersetzen) — praktisch,
um einen Datensatz Feld für Feld in einer Sprache zu befüllen. Sichtbar,
sobald mehrsprachige Felder auf dem Bildschirm sind (unabhängig von der
Maschinenübersetzung); der „Alle Felder übersetzen"-Button bleibt daran
gekoppelt.
Migration: keine — rein additiv. Neue UI-Strings "Show all fields in one language" und "Show all fields in {{language}}" (Tools ergänzen ihre
Übersetzungen).
Veraltete Übersetzungen markieren (modulierbar#31, generisch für alle Tools): Wird eine Sprache nach der Übersetzung geändert, gilt die unveränderte Gegensprache als „möglicherweise veraltet“ — sichtbar im Editor, abfragbar im Release-Prozess, per „Als aktuell markieren“ quittierbar. Ändern sich beide Sprachen, wird nichts markiert (bewusste Doppel-Korrektur). Felder ohne aufgezeichneten Sync-Stand (Bestandsdaten) werden nie markiert.
basicbar_integrations.translation_sync(neu):content_hash,record_synced,changed_languages,stale_languages,stale_map,modeltranslation_values. Zustand lebt pro Model in einem vom Tool angelegtenJSONField(eine Zeile + Migration).@basicbar/uiTranslatableField: neue optionale Propsstale(Sprachcodes → amber Tab-Punkt + Hinweiszeile),onMarkSynced(„Als aktuell markieren“) undonTranslated(nach Maschinen- übersetzung — hier den Sync-Stand persistieren). Der Übersetzen-Button erscheint bei veralteten Sprachen auch auf gefülltem Feld (explizites Neu-Übersetzen);TranslationForm-Einträge unterstützenonTranslatedebenfalls („alle Felder übersetzen“ hält den Sync-Stand aktuell, überschreibt aber weiterhin nie gefüllte Felder).
Migration (Adoption ist opt-in — ohne neue Props/Aufrufe ändert sich nichts):
- Model:
translation_sync = models.JSONField(default=dict, blank=True)- Migration.
- Beim Speichern übersetzungsrelevanter Endpunkte bzw. in einem eigenen
„mark synced“-/
onTranslated-Endpunkt:record_synced()aufrufen. - Serializer:
translation_stale = stale_map(instance.translation_sync, {feld: modeltranslation_values(instance, feld, ("de", "en")), …})ausliefern; Frontend reicht es alsstale-Prop durch und ruft beionMarkSynced/onTranslatedden Endpunkt aus Schritt 2. - Release-Checks:
stale_map()über die zu prüfenden Objekte. - Neue Katalog-Schlüssel (de-Übersetzungen ergänzen):
translation may be outdated,The other language was changed since this translation.,Mark as up to date.
lti_loginantwortet bei fehlenden Parametern (iss,login_hint,target_link_uri) und nicht auflösbarer Plattform-Registrierung (Issuer/Client-ID-Mismatch, auch Trailing-Slash) mit erklärendem400statt opakem500; pylti1p3-Exceptions werden abgefangen. Migration: Version heben, sonst nichts.
- LTI-1.3-Fundament (Phase 5), aus abstimmbar extrahiert:
LtiPlatform/LtiToolKey/LtiUserLink,build_tool_conf,lti_login/lti_jwks, Staff-Platform-API, JIT-Provisionierung mit E-Mail-Unifizierung (Opt-in pro Plattform), Constraint-Namen mit Paket-Präfix (koexistenz- sicher während der Umzugsmigration), Frame-Ancestors-Middleware (LTI_FRAME_PATH_PREFIXESkonfigurierbar). 28 Tests inkl. simuliertem LMS-Handshake. - Bewusst Tool-seitig: Message-Launch, Deep Linking, Kontext-Link-Model (FK auf Fachmodelle) und Icon — komponiert aus den Paket-Primitiven.
- Migration abstimmbar: Daten-Umzugsmigration (
lti/0003) kopiert Plattformen/Keys/User-Links PK-erhaltend in die Paket-Tabellen und hängt den Kontext-Link-FK um — läuft als normalesmanage.py migrate, kein manueller Schritt. - ausleihbar: keine Änderung — die Fähigkeit kommt bei Bedarf über Paket + eigene Launch-App.
- Erstes Auth-Paket (Phase 4):
OIDCBackend(Claim-Mapping, JIT- Provisionierung, IdP-Gruppen → Django-Admin),SilentLoginView, Back-Channel-Logout,provider_logout_url,is_oidc_admin,discovery.discover_endpoints,AbstractBasicUser(ADR-0003). - Die bewussten Tool-Unterschiede aus Phase 0 sind jetzt Konfiguration:
MAX_USERS(Obergrenze;anonymized_at-Konvention zählt anonymisierte Konten nicht) undOIDC_MATCH_BY_USERNAME_FALLBACK(Subject-Drift- Heilung per Username-Match, Default aus). Betreiber-Doku zu Fristen und Kennungs-Wiedervergabe im Paket-README. - 25 Tests (aus beiden Tools portiert und vereinigt, inkl. der neuen Flag-Pfade), eigener CI-Job.
- Migration beide Tools:
accounts/oidc.py+config/oidc_discovery.pylöschen;AUTHENTICATION_BACKENDS/OIDC_OP_LOGOUT_URL_METHODaufbasicbar_auth.oidc.*; Importe in urls/views/serializers umstellen;INSTALLED_APPS+basicbar_auth. User-Model bleibt unangetastet. - Migration abstimmbar zusätzlich:
OIDC_MATCH_BY_USERNAME_FALLBACK=Truesetzen (bisheriges Verhalten, an der UOS unkritisch — Kennungen werden nicht neu vergeben).
- Neu:
TranslatableField+TranslationFormProvider/useTranslationForm— die vereinheitlichte Übersetzungs-Editor-Komponente beider Tools. Vertrag: per Sprache (values+onChange(lang, text)), n Sprachen ausSUPPORTED_LANGUAGES(UI-Sprache-zuerst),renderInputfür Custom-Editoren,singleLanguage(Easy Mode) als Prop,format="html"(Statuspunkte ignorieren Markup, Übersetzung erhält es),MAX_TRANSLATE_LENGTH-Kappe. Der HTTP-Aufruf wird vom Tool injiziert:<TranslationFormProvider translate={…}>. - Neue Peer-Dependency:
lucide-react. - Migration beide Tools: lokale
TranslatableField/TranslationFormersetzen;tailwind.configcontentum./node_modules/@basicbar/ui/dist/**/*.jserweitern (Komponenten-Klassen müssen gescannt werden); Provider bekommt dietranslate-Funktion. - Migration ausleihbar:
api.translateumformat-Parameter erweitern; Aufrufstellen bleiben unverändert (gleicher Feld-Vertrag). - Migration abstimmbar: lokaler Wrapper behält
value/onChange(next),variant="rich"(RichTextEditor) und Easy Mode; Tab-Reihenfolge folgt jetzt der UI-Sprache statt fix kanonisch-zuerst.
- Erstes UI-Paket (Phase 3), Modell „ein Designsystem, pro Tool ein eigener
Akzent“:
createPreset({ colors })(Font, Dark Mode per.dark-Klasse, Motion-Tokens; dieslate/brand-Ramps bleiben als Identität im Tool),base.css(A11y-Basis: focus-visible-Ring, Skip-Link, reduced-motion, color-scheme, accent-color),ThemeProvider/useTheme/prePaintScript(Auto/Light/Dark,storageKeykonfigurierbar),initI18n({ resources })undcontentLang. - Distribution: npm-Tarball via GitLab Generic Package Registry,
CI-Publish beim Tag
ui/vX.Y.Z. - Migration ausleihbar: tailwind.config auf Preset, index.css auf
@import "@basicbar/ui/base.css", theme.tsx/i18n.ts/contentLang.ts löschen und Importe auf@basicbar/uiumstellen. - Migration abstimmbar: dito; zusätzlich ThemeProvider statt des lokalen
Theme-Moduls (mit
storageKey="abstimmbar_theme"für Bestandsnutzer).
- Erstes Paket (Phase 2):
ai(LiteLLM-Client) undtranslation_service(LibreTranslate-Client) aus den konsolidierten Tool-Fassungen übernommen; Settings-Zugriff jetzt mit Paket-Defaults (conf.py) — unkonfiguriert ist alles aus, ein Tool ohne Settings-Block startet unverändert. - Kanonischer Translate-Endpunkt:
POST {text, source, target, format?}→{translated}; Sprachvalidierung, HTML-Sanitizing (html_sanitize.pyaus abstimmbar, jetzt mit nh3-Abhängigkeit), englische Fehlertexte. - Neu: Capabilities-Endpoint (
GET→{"translation": bool, "ai": bool}, erweiterbar perextra_capabilities()). - Migration ausleihbar: Response-Key
translation→translated, URL/api/manage/translate/→ Paket-URL,TranslateView-Subclass für dieIsLenderOrAdmin-Permission, Format-Validierung neu. - Migration abstimmbar: Fehlertexte nun englisch; Imports
common.ai/common.translation_service/common.html_sanitize→basicbar_integrations.*.
- Phase 1: Repo-Gerüst, ADRs 0001–0003, CI (SPDX-Check), Extraktionsplan.
- CI: Testjob für basicbar-integrations (python:3.12-slim).