diff --git a/README.md b/README.md index 64a8beb..49e40f5 100644 --- a/README.md +++ b/README.md @@ -31,11 +31,11 @@ dieser Ausnahme sind Folgearbeit. | Pfad | Artefakt | |---|---| | [`CLAUDE.md`](CLAUDE.md) | **Kanonische Arbeitskonventionen für alle Agenten-Sessions** (Topologie, Framework, Secrets, Karpathy-Guidelines) | -| `vision/` | Eine Vision je Linie: Community (axion1337.chat), Tool (ThreadNet), Plattform (Homelab) — dazu [`branding.md`](vision/branding.md) (Marke, Farben, wo welches Theme eingestellt ist) | +| `vision/` | Eine Vision je Linie: Community (axion1337.chat), Tool (ThreadNet), Plattform (Homelab) | | `roadmap.md` | Linien, Meilenstein-Kandidaten, Kadenz — GitLab-Milestones halten den Stand | | `decisions/` | ADRs — Pflicht bei Architekturentscheidungen **und dauerhaften Ausnahmen** | | `verfahren/` | Wie wir arbeiten: [Deploy-Übergabe/DoD](verfahren/deploy-uebergabe.md), [Refinement & Retro](verfahren/refinement.md), [AARs](verfahren/aar/), Werkzeuge | -| `hosts/`, `shared/` | **Bestand + Historie** je Host/Thema — offene Punkte sind Issues | +| `hosts/`, `shared/` | **Bestand + Historie** je Host/Thema — u. a. [Branding](shared/branding.md) (Marke, Paletten, wo welches Theme eingestellt ist); offene Punkte sind Issues | Gelesen wird das alles auch gebündelt unter **[axionwiki.lab](https://axionwiki.lab)** — dort stehen Plattform-Wiki, Homelab-Doku und dieses Repo nebeneinander diff --git a/vision/branding.md b/shared/branding.md similarity index 80% rename from vision/branding.md rename to shared/branding.md index ad73c50..165ab7c 100644 --- a/vision/branding.md +++ b/shared/branding.md @@ -1,9 +1,14 @@ # Branding: Marke, Farben, Bildsprache -Der verbindliche Ort für alles, was das Erscheinungsbild betrifft — über alle -Oberflächen hinweg (Chat-Clients, Wikis, künftige Dienste). Hier, weil dieses Repo -jede Werkzeugentscheidung überlebt: Wird das BookStack-Experiment abgeräumt oder -ein Client ersetzt, bleiben Marke und Palette bestehen. +Übergreifend, weil dieselben Farben in mehreren Oberflächen eingestellt werden +(Chat-Clients, Wikis, künftige Dienste) und sich das nicht pro Host oder Linie +trennen lässt: **Bestand** (welche Farbe wo eingetragen ist) und **Historie** +(was wann warum geändert wurde). + +Hier im `management`-Repo, weil es als einziges der beteiligten Repos +**gespiegelt** ist und jede Werkzeugentscheidung überlebt: Wird das +BookStack-Experiment nach [ADR-0007](../decisions/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md) +abgeräumt oder ein Client ersetzt, bleiben Marke und Paletten bestehen. ## Bildmarke @@ -87,7 +92,7 @@ dazuerfunden werden. |---|---|---| | Element/ThreadNet-Web | `apps/production/custom-configs/element-values.yaml` (gitops), `setting_defaults.custom_themes` | 17 Themes; Änderungen chirurgisch, **nie die YAML neu serialisieren** | | ThreadNet Desktop | `apps/desktop/axion1337/config.json` (ThreadNet-Web) | eigene Kopie derselben Themes — beim Ändern beide mitziehen | -| BookStack | *Settings → Customization*, getrennt für hell und dunkel | liegt in der Datenbank, **nicht im Repo** — Kopie in `theme/sorbs-palette.md` | +| BookStack | *Settings → Customization*, getrennt für hell und dunkel | liegt in der Datenbank, **nicht im Repo** — schriftlich hier und in `theme/sorbs-palette.md` | | BookStack (Feinschliff) | `theme/*.css` im Wiki-BookStack-Repo | nur Flächen, Text, Ränder — die sieben Farben oben gehören in die Oberfläche | | Docusaurus-Wiki | `src/css/custom.css` (homelab/wiki) | bislang nur Akzentfarbe | @@ -95,8 +100,15 @@ dazuerfunden werden. ist es weg — deshalb steht es oben in dieser Tabelle. Wiederherstellen heißt: sieben Felder in der Oberfläche neu eintragen. +Es steht bewusst an **zwei** Stellen schriftlich, und die Rollen sind verschieden: +`theme/sorbs-palette.md` im BookStack-Repo ist die betriebsnahe Kopie mit den +DB-Schlüsseln, liegt aber in der Gruppe `homelab` — die hat **keine Mirrors** und +ist von außerhalb des Labs nicht lesbar. Diese Datei hier ist die gespiegelte +und damit maßgebliche Fassung. Wer die Farben ändert, zieht beide mit; im +Zweifel gilt, was in der laufenden Instanz eingestellt ist. + ## Offen Ob die Terrakotta-Richtung das Stammschema ablösen oder eine Alternative neben Gruvbox bleiben soll, ist nicht entschieden — das gehört in die Rebranding-Runde -(→ [`threadnet.md`](threadnet.md), ThreadNet-Web#10). +(→ [`vision/threadnet.md`](../vision/threadnet.md), ThreadNet-Web#10). diff --git a/verfahren/aar/2026-08-02-wiki-und-desktop-clients.md b/verfahren/aar/2026-08-02-wiki-und-desktop-clients.md index 5d53d51..97e14fd 100644 --- a/verfahren/aar/2026-08-02-wiki-und-desktop-clients.md +++ b/verfahren/aar/2026-08-02-wiki-und-desktop-clients.md @@ -11,7 +11,7 @@ | gitops-Wiki (15 Seiten) auf git.lab, inhaltlich korrigiert | ✅ | | Docusaurus-Wiki unter `axionwiki.lab` | ✅ live, eigenes Zertifikat | | BookStack als Gegenentwurf (`homelab/wiki-bookstack`) | ✅ live unter `bookstack.lab` | -| 11 neue Themes (aXion1337 Light + 10 Paletten) | ✅ Web live, in allen Clients | +| 11 neue Themes (aXion1337 Light + 10 Paletten) | ✅ Web live, in allen Clients — ⚠️ **Paletten waren falsch**, korrigiert → [Nachtrag](#nachtrag-2026-08-02--die-paletten-waren-erfunden) | | Desktop-Clients Linux/Windows/macOS | ✅ Release `desktop-1.12.17-themes` | | Rebrand Schritt 1 (Name + Icons) | ✅ alle vier Plattformen heißen ThreadNet | @@ -110,3 +110,42 @@ Ergebnis. Die Diagnose war jedes Mal gut, sobald echte Daten vorlagen - **Rebrand-Rest**: About-Attribution im Client, `brand` in der Prod-Config, Signing (ThreadNet-Web#6) — ohne Signatur bleibt für Nutzer auf macOS der `xattr`-Schritt und auf Windows die SmartScreen-Warnung. + +## Nachtrag 2026-08-02 — die Paletten waren erfunden + +Nachmittags nachgetragen, weil der Befund das Ergebnis oben relativiert. + +**Was war.** Die zehn Themes aus dem Rollout trugen nicht die Farben aus Anthropics +[theme-factory-Skill](https://github.com/anthropics/skills/tree/main/skills/theme-factory), +sondern **meine Auslegung ihrer Namen**. Ich hatte den Skill benannt, aber nie +seine Farbwerte gelesen. Aufgefallen ist es sorb an „Sunset Boulevard": Er hatte +gedämpftes Terrakotta erwartet, bekam Koralle und Pink. Die Prüfung an der Quelle +zeigte, dass fast alle zehn danebenlagen — am gröbsten beim Grundcharakter: +**sieben der zehn sind hell gemeint, ich hatte sechs dunkel angelegt.** + +**Warum es nicht auffiel.** Erfundene Farben sehen nicht falsch aus. Ein Theme +namens „Ocean Depths" in dunklem Türkis wirkt stimmig — es fällt erst auf, wenn +jemand die Vorlage kennt. Anders als ein kaputter Healthcheck erzeugt eine +erfundene Palette kein Symptom, auf das man stoßen könnte. + +**Falle für die nächste Runde.** Ob ein Theme hell oder dunkel gemeint ist, steht +in den Skill-Beschreibungen **nicht verlässlich** — „Warm Sand · backgrounds" +findet sich bei einem Theme, dessen Showcase-Seite dunkel ist. Belastbar ist nur +`theme-showcase.pdf`: Seiten rendern, Hintergrundfarbe messen. Werte und Fallen +stehen in [`shared/branding.md`](../../shared/branding.md). + +**Bestätigung des Musters aus Abschnitt 4.** Auch das war kein Analysefehler, +sondern eine **ungeprüfte Änderung** — dieselbe Wurzel wie Healthcheck, toter +Issue-Verweis und Icon-Skript. Nur diesmal ohne Fehlermeldung, die es aufdeckt. +Die Lehre schärft sich damit: Es genügt nicht, Ergebnisse zu prüfen — bei +Vorlagen ist die **Quelle** zu prüfen, bevor etwas daraus abgeleitet wird. + +**Nebenbefund.** sorbs von Hand eingestelltes BookStack-Schema und die offizielle +Sunset-Boulevard-Palette sind bis auf zwei Ziffern identisch (`#e76e51`/`#e76f51`, +`#f3a261`/`#f4a261`) — unabhängig voneinander auf demselben Coolors-Satz gelandet. + +**Korrigiert:** gitops `8a9d778` (Web, live verifiziert) · ThreadNet-Web `55e1a09` +(Desktop-Config). Das BookStack-CSS lag bereits richtig. +⚠️ **Die released Desktop-Binaries tragen weiter die alten Farben** — die Themes +stecken in `resources/webapp.asar`. Abgestimmt so belassen; der nächste reguläre +Build zieht die Korrektur mit (nachgehalten in ThreadNet-Web#11, `status:wartet`).