# VD-P29 · Screens P29 — Help-Center (Public-Content-Site) & Help-Desk > ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **RAG-Korpus-Andock entfällt** (alter VR-P25/VD-P25-Scope zurückgestellt; kein RAG/Embedding — HiveGrid wird MCP-Server, [[VR-MCP]]/[[VD-MCP]]). Das **Help-Center bleibt** unverändert; Help-Artikel optional später als MCP-Resource. RAG-Stellen unten durchgestrichen. | | | |---|---| | **Typ** | Screen (Design) | | **Owner** | David | | **Phase** | P29 — Help-Center & Help-Desk (v2-P9) · bedient `VA-P29` | | **Cycle/Fenster** | v2-W3 — Admin/Help/Dashboard/v2-Launch · 2026-07-28 → fällig 2026-07-30 | | **Status** | geplant (NEU — Phasen-Ticket) | > ♻️ **Löst Sammel-Ticket auf / erweitert:** Dieses Phasen-Ticket ersetzt und erweitert das alte Sammel-Ticket **`VD-4`** („Help-Center, Public-Content-Site") um In-App-Feedback-Widget + Admin-Help-Desk. > 🌐 **Extern sichtbar (öffentliche Help-Routen, SEO) → eigener Polish** (fließt in `VD-6`). ## Abhängigkeiten & Parallelität - **Blocked by:** D0-Baseline (`D-D0a` App-Shell + Public-Layout-Token, `D-D0b` Archetypen A2/A3/A5) — öffentliche Help-Routen liegen **vor der Auth-Middleware**, ohne Tenant-Context; Admin-Flächen unter `admin.hivegrid.de` - **Bedient (Dev):** `VA-P29` (Help-Center + Help-Desk, M172–175) — v2-W3 (28.–30.07.) - ~~**Retro-Dep:** Help-Artikel werden rückwirkend **RAG-Korpus für alten VD-P25/v2-P4-Scope** (Embedding-Quelle)~~ → **entfällt ([[AD-26]]); optional als MCP-Resource ([[VD-MCP]])** - **Läuft parallel zu:** `VD-P28`, `VD-P30`, `VD-P31` — v2-W3 - **Subframe:** Pflicht je Route (öffentliche A-Public/A2-Public/A3-Public + In-App-Widget A5 + interne Admin A2/A3) ## Was wir bauen Ein **öffentliches, file-basiertes Help-Center** mit SEO-Routen (`/help/{lang}/{category}/{slug}`, ohne Auth), Volltext-Suche und Build-Time-Index (Build-Fail bei kaputten Referenzen). Aus jeder App-Route führt ein **Hilfe-Icon** per Deep-Link zum passenden Artikel. Ein überall erreichbares **Feedback-Widget** („Problem melden") erzeugt `Feedback`-Einträge mit Auto-Kontext + optionalem Screenshot; die **Plattform-Admin-Seite** verwaltet Feedback als Liste + Detail mit Status-Lifecycle/Assignee/Notes/Attachments und Audit. Bewusst klein (Phase 1): Markdown-Artikel via Git-PRs (kein Editor-UI), ~10–20 Artikel, primär Deutsch. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | Help-Home [`/help/{lang}/`] | Hero, Such-Eingang, Kategorien-Übersicht, öffentlich (kein Tenant-Context) | A-Public | | Kategorie-Seite [`/help/{lang}/{category}/`] | Liste der Artikel einer Kategorie, Kategorie-Metadaten | A2-Public | | Artikel-Detail [`/help/{lang}/{category}/{slug}`] | Markdown-Inhalt, TOC, verwandte Artikel, Vote (hilfreich?), SEO-Meta/Canonical | A3-Public | | Such-Ergebnisse [`/help/{lang}/search?q=`] | Volltext-Treffer mit Snippets, Kategorie-Zuordnung | A2-Public | | Feedback-Widget [Modal, überall] | „Problem melden"-Trigger (global erreichbar), Freitext, Screenshot-One-Click-Anhang, Erfolgs-Hinweis | A5 | | Admin-Feedback-Liste [`admin.hivegrid.de/support`] | Feedback-Liste mit Status, Assignee, Quelle, Datum, Filter | A2 | | Admin-Feedback-Detail [`admin.hivegrid.de/support/:ticketId`] | Status-Lifecycle, Assignee, interne Notes, Auto-Kontext (route/browser/app-version), Attachments, Audit | A3 | ## Features (muss abgedeckt sein) - [ ] Markdown mit Frontmatter, Build-Time-Index (Volltext + Kategorien + Sitemap), Build-Fail bei kaputten Referenzen/`related_slug` - [ ] Öffentliche Routen `/help/{lang}/{category}/{slug}` ohne Auth (vor Auth-Middleware), SEO-Defaults (title/description/canonical), Suche - [ ] Deep-Link Route→Artikel (Hilfe-Icon pro App-Route, Fallback Help-Home) - [ ] Feedback-Widget überall → `Feedback` mit Auto-Kontext (tenant/user/route/browser/app-version), Screenshot-Option, Rate-Limit 10/h - [ ] Plattform-Admin: Feedback-Liste + Detail (Status-Lifecycle/Assignee/Notes/Attachments) mit Audit - [ ] ~~Help-Artikel als RAG-Korpus an alten VD-P25/v2-P4-Scope registrierbar (Embedding-Quelle)~~ → **entfällt ([[AD-26]]); optional als MCP-Resource ([[VD-MCP]])** - [ ] **Externer Polish** der öffentlichen Help-Routen (SEO, Responsive, Hell/Dunkel) ## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Such-Eingabe mit Auto-Suggest; Kategorie-Kacheln/-Liste; Artikel-Renderer (Markdown) mit Inhaltsverzeichnis; „War das hilfreich?"-Vote; Breadcrumb; Hilfe-Icon (in-App, deep-link-fähig); Feedback-Trigger (Button/FAB, global); Feedback-Formular (Freitext + Screenshot-One-Click); Erfolgs-/Rate-Limit-Hinweis (Klartext); Admin-Daten-Tabelle (Status-Filter); Status-Lifecycle-Badge; Assignee-Auswahl; Notiz-Liste; Attachment-Vorschau; Empty-/Loading-/Permission-Denied-States (Klartext). ## Quellen (granular) - `designer-briefs/P29-help-center-help-desk.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat) - `ENTITY-MODEL.md` → `Feedback` im **Plattform-Admin-Datenraum (Domäne 11, kein Tenant-RLS, App-Code permission-gegated)** - Plane-Snapshot: ersetzt/erweitert `VD-4`; bedient `VA-P29` (v2-W3, 28.–30.07.); externer Polish → `VD-6` ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: