docs: ADR-0015 Gegenlese-Korrekturen

- 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 <noreply@anthropic.com>
This commit is contained in:
Thomas Stallinger 2026-08-12 21:40:48 +02:00
parent 172f6f1db8
commit b9cef457c3

View File

@ -5,7 +5,7 @@
## Kontext ## 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 im Auftragskatalog — nutzbar war das aber nur über das Kundenportal. Der
interne Admin-Bereich (`/admin/geraete`) teilt sich zwar dasselbe interne Admin-Bereich (`/admin/geraete`) teilt sich zwar dasselbe
Auftragskatalog-Template (`templates/auftragskatalog.html`) mit dem 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, 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 ein Gerät zwischen OEs zu verschieben (die Kundenportal-Liste bekam das
bereits in der vorherigen Session). 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 OE oder Gruppe verantwortlich ist, ließ sich aus der Anzeige nicht
erkennen, geschweige denn direkt dorthin wechseln. erkennen, geschweige denn direkt dorthin wechseln.
3. Für Gruppen existierte bereits eine Admin-Detailseite 3. Für Gruppen existierte bereits eine Admin-Detailseite
(`/admin/kunden/{org_id}/gruppen/{id}`), für OEs **keine einzige** (`/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` Beim Umsetzen zusätzlich gefunden: `templates/auftragskatalog.html`
verdrahtete die Select-/Deselect-Formulare fest auf verdrahtete die Select-/Deselect-Formulare fest auf
@ -37,12 +37,12 @@ Entscheidung hier mitgefixt.
**Herkunft bekommt eine konkrete ID, nicht nur einen Typ.** **Herkunft bekommt eine konkrete ID, nicht nur einen Typ.**
`resolve_katalog_overrides()` (`provisioning-server/app.py`) liefert `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 `quelle_id` — bei OEs eindeutig die gewinnende OE in der Kette, bei Gruppen
eine der zustimmenden Gruppen (bei mehreren gleichzeitig zustimmenden eine der zustimmenden Gruppen (bei mehreren gleichzeitig zustimmenden
Gruppen wird bewusst nicht jede einzeln attribuiert, sondern nur eine Gruppen wird bewusst nicht jede einzeln attribuiert, sondern nur eine
davon verlinkt — Sprungziel-Zweck, kein vollständiger Audit-Trail). Die 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. nicht, nur die zusätzlich mitgeführte Information.
**`fetch_all_devices()` bekommt denselben OE-Join** wie **`fetch_all_devices()` bekommt denselben OE-Join** wie
@ -73,11 +73,11 @@ Fähigkeit.
## Konsequenzen ## Konsequenzen
Der Admin-Bereich hat jetzt für OEs zwei unterschiedlich mächtige OEs sind jetzt plattformweit über zwei unterschiedlich mächtige Wege
Zugriffswege (volle Selbstverwaltung nur über das Kundenportal als verwaltbar (volle Selbstverwaltung nur als eingeloggte Kund:in im
eingeloggte Kund:in, minimale Merkmal-Bearbeitung über die neue Kundenportal, minimale Merkmal-Bearbeitung im Admin-Bereich) — bewusst
Admin-Seite) — bewusst asymmetrisch zu Gruppen (dort admin-verwaltbar seit asymmetrisch zu Gruppen (dort admin-verwaltbar seit ADR-0012, inzwischen
ADR-0012, inzwischen zusätzlich auch Kundenportal-Self-Service). Sollte zusätzlich auch Kundenportal-Self-Service). Sollte
künftig doch ein vollständiges Admin-seitiges OE-CRUD gebraucht werden 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 (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 das eine reine Ergänzung um Create/Rename/Delete-Routen nach dem