platform-docs/adr/0018-logo-und-flotte-umbenennung-kundenplattform.md
Thomas Stallinger e96fbd4733 docs: Gegenlese aller 19 ADRs - zwei lange vorgemerkte Diskrepanzen endlich behoben
ADR-0006: Der zitierte Befehl (epiphany --application-mode --profile=...)
wurde nachweislich nie ausgeliefert - ADR-0004s eigene, einen Tag später
datierte Folgeuntersuchung (Fund 2) stellte fest, dass --application-mode
für skriptgesteuerte Einrichtung unbrauchbar ist. Der tatsächlich seit dem
allerersten Commit ausgelieferte Befehl (start-kiosk.sh) nutzt nur
--profile, nie --application-mode. Diese Diskrepanz wurde beim ersten
Lesen von ADR-0004/0006 in einer früheren Session bereits bemerkt, aber
nie zu Ende verfolgt - jetzt korrigiert, an beiden Stellen (Entscheidung +
Konsequenzen), inkl. Verifikation gegen den echten Code.

ADR-0004: 'grouped-window-list@cinnamon.org' war von Anfang an falsch
dokumentiert - der Code verwendet seit demselben Ausgangscommit bewusst
das einfache 'window-list@cinnamon.org' (Begründung stand nur als
Code-Kommentar: die gruppierte Variante brachte ungewollte Pinned-Apps-
Starter mit). Kein späterer Kurswechsel, sondern ein Autorenfehler im
ADR selbst.

ADR-0018: kleinere Wortwahlkorrektur ('gestrichelte' -> 'durchgezogene'
Konturlinien - das SVG hat kein stroke-dasharray, die Linien sind nicht
gestrichelt).

Alle 19 ADRs vollständig neu gelesen (nicht nur grep-Stichproben),
Cross-Referenzen und Struktur erneut geprüft - sonst keine weiteren
Funde.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-23 10:01:13 +02:00

27 lines
3.7 KiB
Markdown

# ADR-0018: Markenlogo im Header + Umbenennung „Geräte" zu „Flotte"
**Status:** Beschlossen
**Datum:** 19.08.2026
## Kontext
`kundenplattform` hatte bislang keine visuelle Markenidentität — der Header zeigte nur den reinen Textlink „Tuxflotte Kundenplattform", obwohl bereits ein fertiges Markenbild im Repo existiert (`pics/tuxflotte-beschriftet-schatten.svg`) und dort schon als „das Logo" referenziert wird (siehe `13-live-provisioning-boot.md`, Abschnitt zum GRUB-Menü-Farbschema und Plymouth-Bootsplash). Außerdem hieß der zentrale Navigationseintrag zur Geräteliste schlicht „Geräte" — technisch zutreffend, aber weniger prägnant als das Produktversprechen (Flottenverwaltung), das der Projektname selbst schon trägt.
## Entscheidung
**Logo:** `pics/tuxflotte-beschriftet-schatten.svg` wird unverändert als `kundenplattform/static/tuxflotte-logo.svg` eingebunden und erscheint im Header links vom Markennamen, auf jeder Seite der Anwendung — auch auf der Login-Seite, da diese wie alle Templates von `base.html` erbt und der Header dort nicht an einen eingeloggten Nutzer gebunden ist.
Vor dem Einbau wurde das SVG probehalber als PNG gerendert (`convert`, sowohl auf hellem als auch auf dunklem Hintergrund) und visuell geprüft, statt es ungesehen zu verlinken: Das Bild besteht ausschließlich aus durchgezogenen Konturlinien in Markenblau (`rgb(52,101,164)`, dieselbe Farbe wie im bestehenden GRUB-Farbschema) ohne deckende Hintergrundfläche — funktioniert dadurch unverändert in beiden Farbschemata (hell/dunkel), ohne eine eigene Variante pflegen zu müssen. Als Nebenbefund zeigte die Vorschau, dass das Bildmotiv selbst bereits die Wortmarke „Tux"/„Flotte" enthält — ein zusätzlicher, ungeplanter Beleg dafür, dass die parallel entschiedene Umbenennung (siehe unten) zum bestehenden Markenbild passt, nicht umgekehrt konstruiert.
Das Original in `pics/` bleibt unangetastet und unoptimiert (ungenutzter LibreOffice-Export-Boilerplate wie leere Bullet-Char-Templates); die kopierte Version in `static/` wird bewusst nicht bereinigt, um das Quellbild nicht anzufassen — bei ca. 78 KB und einmaligem Laden pro Browser-Sitzung (danach gecacht) kein spürbares Performance-Thema für die aktuelle Nutzungsgröße.
**Umbenennung:** Der Navigationseintrag zu `/geraete` heißt jetzt „Flotte" statt „Geräte" — sowohl im Kundenportal-Header (`base.html`) als auch im internen Admin-Bereich (`admin/layout.html`, dort für `/admin/geraete`), für eine über die gesamte Weboberfläche konsistente Beschriftung. Bewusst **nur** der Navigationstext geändert, nicht die URLs/Routen (`/geraete`, `/admin/geraete` bleiben bestehen) und nicht die übrigen Vorkommen von „Gerät"/„Geräte" auf den Seiten selbst (Seitenüberschriften, Tabellenspalten, Fehlermeldungen) — die Umbenennung war explizit auf die Navigation begrenzt angefragt, eine Ausweitung auf jede Textstelle der Anwendung wäre eine eigene, hier nicht getroffene Entscheidung.
## Konsequenzen
Keine Datenbank-, API- oder Routing-Änderung — beide Anpassungen sind reine Template-Änderungen (`base.html`, `admin/layout.html`) plus eine neue statische Datei, ohne Migrationsbedarf und ohne Risiko für bestehende Lesezeichen/Links.
Live auf anode verifiziert: `GET /static/tuxflotte-logo.svg` liefert `200`/`image/svg+xml`, das Logo erscheint auf der ungeschützten Login-Seite, und der Navigationstext zeigt „Flotte" sowohl im Kundenportal- als auch im Admin-Bereich, mit einem echten eingeloggten Testkonto geprüft und anschließend wieder entfernt.
Sollte künftig auch der übrige Sprachgebrauch der Anwendung (Seitentitel, Tabellenüberschriften, Fehlermeldungstexte) auf „Flotte" umgestellt werden sollen, ist das eine eigene, hier nicht vorweggenommene Folgeentscheidung.