⚙️ 🤖 Theme-Schicht: Design und Funktion trennen, Template-Updates ohne Bruch in Tenants #105

Closed
opened 2026-11-02 23:51:24 +01:00 by holm · 1 comment
Owner
Dimension Bewertung Einschätzung
Aufwand ███████░░░ Hoch: CSS-Schnitt, Template-Blöcke, Overlay-Suche, Migration advent
Nutzen █████████░ Sehr hoch: jeder Tenant bekommt Updates ohne Handarbeit
Bruchhäufigkeit ███████░░░ Ohne Trennung bei jedem Template-Update
Nachhaltigkeit █████████░ Sehr hoch
Dringlichkeit ██████░░░░ Mittel-hoch: vor dem zweiten Tenant

Anlass (Holm 2026-11-03)

zpub init kopiert das ganze Template in den Tenant (#102). Dadurch kommen Publisher-Verbesserungen (z. B. #104 Player) nicht in Tenants an. Holm: „Dann müssen wir das Template customizable machen und Design und Funktion so voneinander trennen, dass ein Update ohne Bruch möglich ist.“

Zielbild (Vorschlag v00)

Schicht Gehört Liegt Update
Funktion HTML-Struktur, JS (Player, SPA, Mastodon), Basis-CSS (Layout, Komponenten) Publisher templates/<name>/ kommt mit jedem Publisher-Release
Design Tokens (Farben, Schrift, Radius, Glow …), Komponenten-Feinschliff Tenant theme/tokens.css (+ optional theme/extra.css) gehört dem Tenant
Inhalt/Branding Wortmarke, Logos, Favicon, Footer-Spalten, Hero-Texte Tenant podcast.toml [brand]/[links] + theme/assets/ gehört dem Tenant
Struktur-Ausnahme einzelne Blöcke (z. B. Hero, Header-Zusatz) Tenant theme/blocks/*.j2, minijinja-Blöcke mit dokumentierter Schnittstelle Vertrag: Blocknamen + Variablen versioniert in TEMPLATE.md
  • Überlagerung pro Datei: Tenant-Theme vor Publisher; alles Nicht-Überschriebene kommt aus dem Publisher.
  • Stabiler Vertrag: dokumentierte CSS-Tokens + Blocknamen; Änderungen daran = Compat/Breaking + Versionswarnung (#102).
  • Hell/Dunkel-Umschalter als Funktion im Publisher (opt-in per [theme] modes), Tenant liefert nur Tokens je Modus.
  • zpub init kopiert nicht mehr das Template, sondern legt theme/ mit kommentierter tokens.css an.
  • Migration: advent (#2 im Tenant) liegt bereits als getrennte theme.css + markierte Hooks vor → in die neue Schicht überführen, Tenant-Kopie des Templates entfällt.

🤖 angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschätzung | |---|---|---| | Aufwand | `███████░░░` | Hoch: CSS-Schnitt, Template-Blöcke, Overlay-Suche, Migration advent | | Nutzen | `█████████░` | Sehr hoch: jeder Tenant bekommt Updates ohne Handarbeit | | Bruchhäufigkeit | `███████░░░` | Ohne Trennung bei jedem Template-Update | | Nachhaltigkeit | `█████████░` | Sehr hoch | | Dringlichkeit | `██████░░░░` | Mittel-hoch: vor dem zweiten Tenant | ## Anlass (Holm 2026-11-03) `zpub init` kopiert das ganze Template in den Tenant (#102). Dadurch kommen Publisher-Verbesserungen (z. B. #104 Player) nicht in Tenants an. Holm: „Dann müssen wir das Template customizable machen und Design und Funktion so voneinander trennen, dass ein Update ohne Bruch möglich ist.“ ## Zielbild (Vorschlag v00) | Schicht | Gehört | Liegt | Update | |---|---|---|---| | Funktion | HTML-Struktur, JS (Player, SPA, Mastodon), Basis-CSS (Layout, Komponenten) | Publisher `templates/<name>/` | kommt mit jedem Publisher-Release | | Design | Tokens (Farben, Schrift, Radius, Glow …), Komponenten-Feinschliff | Tenant `theme/tokens.css` (+ optional `theme/extra.css`) | gehört dem Tenant | | Inhalt/Branding | Wortmarke, Logos, Favicon, Footer-Spalten, Hero-Texte | Tenant `podcast.toml` `[brand]/[links]` + `theme/assets/` | gehört dem Tenant | | Struktur-Ausnahme | einzelne Blöcke (z. B. Hero, Header-Zusatz) | Tenant `theme/blocks/*.j2`, minijinja-Blöcke mit dokumentierter Schnittstelle | Vertrag: Blocknamen + Variablen versioniert in `TEMPLATE.md` | - Überlagerung pro Datei: Tenant-Theme vor Publisher; alles Nicht-Überschriebene kommt aus dem Publisher. - Stabiler Vertrag: dokumentierte CSS-Tokens + Blocknamen; Änderungen daran = `Compat/Breaking` + Versionswarnung (#102). - Hell/Dunkel-Umschalter als Funktion im Publisher (opt-in per `[theme] modes`), Tenant liefert nur Tokens je Modus. - `zpub init` kopiert nicht mehr das Template, sondern legt `theme/` mit kommentierter `tokens.css` an. - Migration: advent (#2 im Tenant) liegt bereits als getrennte `theme.css` + markierte Hooks vor → in die neue Schicht überführen, Tenant-Kopie des Templates entfällt. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

Abgenommen und gemergt (5ac8183; Worker e0f4380, fd024c1, e2dc051, 33a18d6). Vertrag theme-v1 in TEMPLATE.md + docs/theming.md: Tenant theme/tokens.css, extra.css, assets/, blocks/ (Einschub head_end/header_extra/hero_extra/footer_extra/body_end, Ersetzung hero/card_cover/card_top/ep_head_cover/ep_head_top); [theme] modes/default/follow_system/theme_color; hartcodierte Farben → Komponenten-Tokens; zpub init ohne Template-Kopie. Beleg: Sample pixelgleich (Worker), v00 Build nix-shell + check 13 ✓; advent migriert (Tenant #3), live mit neuem Player/Teilen.

🤖 angelegt von Claude v00 (API/Token holm)

Abgenommen und gemergt (5ac8183; Worker e0f4380, fd024c1, e2dc051, 33a18d6). Vertrag theme-v1 in TEMPLATE.md + docs/theming.md: Tenant `theme/tokens.css`, `extra.css`, `assets/`, `blocks/` (Einschub head_end/header_extra/hero_extra/footer_extra/body_end, Ersetzung hero/card_cover/card_top/ep_head_cover/ep_head_top); `[theme] modes/default/follow_system/theme_color`; hartcodierte Farben → Komponenten-Tokens; `zpub init` ohne Template-Kopie. Beleg: Sample pixelgleich (Worker), v00 Build nix-shell + check 13 ✓; advent migriert (Tenant #3), live mit neuem Player/Teilen. > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-03 01:08:48 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Zentonic/zentonic-publisher#105
No description provided.