From 317f2a6eb2f4271700be27c8a667e0ea8d932c55 Mon Sep 17 00:00:00 2001 From: Erik Thiele Date: Sat, 4 Jul 2026 10:34:11 +0200 Subject: [PATCH] Doku: README, AGENTS und Hilfeseite aktualisiert - README: Willkommensseite-Sektion mit Ansprechpartner/Markdown/Layout - AGENTS: generate_welcome_html Signatur + Verhalten dokumentiert - help.html: Ansprechpartner-Felder, Markdown-Hilfe, Portrait-Layout --- AGENTS.md | 5 +++-- README.md | 11 +++++++++++ templates/help.html | 17 ++++++++++++++++- 3 files changed, 30 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c97c5af..ebe3de1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -112,7 +112,8 @@ Standorte (sites) sind die oberste Organisationsebene und gruppieren Screens. - New standorte can be added by creating `media///` directories and optionally adding config to `config.json["sites"][]`. - Priority playlist (`config.priority`) is global and affects all sites/screens. - Willkommensseite (`customer.html`) accepts up to 3 customer names; logos are fetched via OpenAI→Brandfetch and displayed in a flex row (portrait: column). -- `generate_welcome_html(customer_names, logo_urls)` takes lists for up to 3 customers; logos have equal width (280px) with `max-height: 180px`. +- `generate_welcome_html(customer_names, logo_urls, contacts=None, site="stuttgart", background_url=None)` takes lists for up to 3 customers; logos have equal width (280px) with fixed height 120px, text left-aligned below each logo. +- Contact info supports Markdown: `**bold**`, `*italic*`, `` `code` ``, `- list items`, and line breaks (preserved as `
`). - `customer_names` are preserved in form fields after POST (via `value`-Attribute). - Admin-UI nutzt keyadmin-Design: `brand-surface` (#2b2f36), `nav-surface` (rot #DA002D), Dark Mode per `localStorage("signage-theme")`. - Gemeinsame HTML-Bausteine: `_header.html`, `_footer.html`, `_styles.html` (CSS-Variablen `--ccm-*`, Dark Mode, Card-Border-Radius 1rem). @@ -148,7 +149,7 @@ Standorte (sites) sind die oberste Organisationsebene und gruppieren Screens. - Zugriffs-Dekoratoren in `app.py`: `admin_required`, `site_access_required`. - Hintergrundbild der Willkommensseite wird pro Standort unter `media//background.*` gespeichert; Fallback auf `static/wallpaper.png` wenn keine Datei existiert. - `get_background_url(site)` prüft auf benutzerdefiniertes Hintergrundbild für einen Standort. -- `generate_welcome_html(customer_names, logo_urls, background_url=None)` akzeptiert optionalen `background_url`-Parameter. +- `generate_welcome_html(customer_names, logo_urls, contacts=None, site="stuttgart", background_url=None)` akzeptiert optionale `contacts`-, `site`- und `background_url`-Parameter. - `welcome.html` wird in `media//lobby/` gespeichert. - `search_customer_logo` in `generate_welcome_page.py` nutzt OpenAI GPT-4 + Brandfetch CDN. - `admin_priority` rendert `priority.html` mit `site_list`, `current_site`, `priority_files`, `server_url`. diff --git a/README.md b/README.md index 0af1e3d..11b5bf6 100755 --- a/README.md +++ b/README.md @@ -279,6 +279,17 @@ http://localhost:5005/willkommen?site=stuttgart Maximal 3 Kunden eingeben → Logos werden via OpenAI + Brandfetch gesucht → `welcome.html` wird in der Lobby-Playlist vorne eingefügt. Pro Standort kann ein eigenes Hintergrundbild hochgeladen werden (Fallback auf `static/wallpaper.png`). +**Ansprechpartner:** Pro Kunde können Kontaktdaten eingegeben werden (Markdown-Format). +- **Fett**: `**Text**` +- *Kursiv*: `*Text*` +- `Code`: `` `Code` `` +- Aufzählungen: `- Punkt` oder `* Punkt` +- Zeilenumbrüche werden als `
` übernommen + +**Layout:** +- Landscape: Logos nebeneinander (280px breit, 120px hoch), Texte linksbündig darunter +- Portrait: Texte links vom Logo, per `order`-CSS gesteuert + --- ### Globale Konfiguration (config.json) diff --git a/templates/help.html b/templates/help.html index 6b4be26..381d396 100644 --- a/templates/help.html +++ b/templates/help.html @@ -193,7 +193,22 @@
  • Aufruf über /willkommen?site=<standort> (oder Menüpunkt)
  • Die generierte welcome.html wird automatisch an den Anfang der Lobby-Playlist gesetzt
  • Pro Standort kann ein eigenes Hintergrundbild hochgeladen werden (Tab "Medien" im Standort-Dashboard)
    • -
  • Im Hochformat (Portrait) werden die Logos untereinander angezeigt
    • +
  • Pro Kunde können Ansprechpartner eingegeben werden (Markdown-Format): +
      +
    • Fett: **Text**
      • +
    • Kursiv: *Text*
      • +
    • Code: `Code`
      • +
    • Aufzählungen: - Punkt oder * Punkt
      • +
    • Zeilenumbrüche werden automatisch übernommen
      • +
    +
    • +
  • Layout: +
      +
    • Landscape: Logos nebeneinander, Texte linksbündig darunter
      • +
    • Portrait: Texte links vom Logo, Abstand 40px
      • +
    +
    • +
  • Reset-Button setzt das Formular und die gespeicherten Daten zurück