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
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