From b9cef457c331006c8de11973411218886539528c Mon Sep 17 00:00:00 2001 From: Thomas Stallinger Date: Wed, 12 Aug 2026 21:40:48 +0200 Subject: [PATCH] docs: ADR-0015 Gegenlese-Korrekturen MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Anführungszeichen vereinheitlicht auf „..." (Dokument nutzte durchgängig gerade Anführungszeichen, alle Nachbar-ADRs die deutsche Form) - inkl. Wechsel zu Backticks für die zitierten Code-Literale (quelle-Werte), analog zu ADR-0012s Formulierung derselben Werte. - Konsequenzen-Absatz präzisiert: 'Der Admin-Bereich hat zwei Zugriffswege' war irreführend, da einer der beiden Wege explizit NICHT der Admin-Bereich ist, sondern das Kundenportal. Jetzt 'OEs sind plattformweit über zwei Wege verwaltbar'. Co-Authored-By: Claude Sonnet 5 --- ...rationsgruppen-admin-auftragskatalog-ui.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/adr/0015-konfigurationsgruppen-admin-auftragskatalog-ui.md b/adr/0015-konfigurationsgruppen-admin-auftragskatalog-ui.md index fba8e53..f2a9a66 100644 --- a/adr/0015-konfigurationsgruppen-admin-auftragskatalog-ui.md +++ b/adr/0015-konfigurationsgruppen-admin-auftragskatalog-ui.md @@ -5,7 +5,7 @@ ## Kontext -ADR-0012 brachte OEs/Gruppen samt Herkunfts-Anzeige ("via OE"/"via Gruppe") +ADR-0012 brachte OEs/Gruppen samt Herkunfts-Anzeige („via OE"/„via Gruppe") im Auftragskatalog — nutzbar war das aber nur über das Kundenportal. Der interne Admin-Bereich (`/admin/geraete`) teilt sich zwar dasselbe Auftragskatalog-Template (`templates/auftragskatalog.html`) mit dem @@ -14,12 +14,12 @@ Kundenportal und bekam die Herkunfts-Anzeige dadurch automatisch mit, aber: 1. Die Admin-Geräteliste zeigte keine OE-Spalte und bot keine Möglichkeit, ein Gerät zwischen OEs zu verschieben (die Kundenportal-Liste bekam das bereits in der vorherigen Session). -2. "via OE"/"via Gruppe" war reiner Text ohne Sprungziel — welche konkrete +2. „via OE"/„via Gruppe" war reiner Text ohne Sprungziel — welche konkrete OE oder Gruppe verantwortlich ist, ließ sich aus der Anzeige nicht erkennen, geschweige denn direkt dorthin wechseln. 3. Für Gruppen existierte bereits eine Admin-Detailseite (`/admin/kunden/{org_id}/gruppen/{id}`), für OEs **keine einzige** - Admin-Ansicht — ein Link "via OE" hätte kein Ziel gehabt. + Admin-Ansicht — ein Link „via OE" hätte kein Ziel gehabt. Beim Umsetzen zusätzlich gefunden: `templates/auftragskatalog.html` verdrahtete die Select-/Deselect-Formulare fest auf @@ -37,12 +37,12 @@ Entscheidung hier mitgefixt. **Herkunft bekommt eine konkrete ID, nicht nur einen Typ.** `resolve_katalog_overrides()` (`provisioning-server/app.py`) liefert -zusätzlich zu `quelle` ("oe"/"gruppe"/"geraet"/"workspace") die konkrete +zusätzlich zu `quelle` (`oe`/`gruppe`/`geraet`/`workspace`) die konkrete `quelle_id` — bei OEs eindeutig die gewinnende OE in der Kette, bei Gruppen eine der zustimmenden Gruppen (bei mehreren gleichzeitig zustimmenden Gruppen wird bewusst nicht jede einzeln attribuiert, sondern nur eine davon verlinkt — Sprungziel-Zweck, kein vollständiger Audit-Trail). Die -eigentliche "mehr gewinnt"-Auflösungslogik aus ADR-0012 ändert sich dadurch +eigentliche „mehr gewinnt"-Auflösungslogik aus ADR-0012 ändert sich dadurch nicht, nur die zusätzlich mitgeführte Information. **`fetch_all_devices()` bekommt denselben OE-Join** wie @@ -73,11 +73,11 @@ Fähigkeit. ## Konsequenzen -Der Admin-Bereich hat jetzt für OEs zwei unterschiedlich mächtige -Zugriffswege (volle Selbstverwaltung nur über das Kundenportal als -eingeloggte Kund:in, minimale Merkmal-Bearbeitung über die neue -Admin-Seite) — bewusst asymmetrisch zu Gruppen (dort admin-verwaltbar seit -ADR-0012, inzwischen zusätzlich auch Kundenportal-Self-Service). Sollte +OEs sind jetzt plattformweit über zwei unterschiedlich mächtige Wege +verwaltbar (volle Selbstverwaltung nur als eingeloggte Kund:in im +Kundenportal, minimale Merkmal-Bearbeitung im Admin-Bereich) — bewusst +asymmetrisch zu Gruppen (dort admin-verwaltbar seit ADR-0012, inzwischen +zusätzlich auch Kundenportal-Self-Service). Sollte künftig doch ein vollständiges Admin-seitiges OE-CRUD gebraucht werden (Support-Fall: Kund:in bittet den Betreiber, OEs für sie anzulegen), ist das eine reine Ergänzung um Create/Rename/Delete-Routen nach dem