5.4 KiB
VD-P29 · Screens P29 — Help-Center (Public-Content-Site) & Help-Desk
⚠️ KI→MCP-Pivot (AD-26): Der RAG-Korpus-Andock entfällt (VR-P25/VD-P25 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 inVD-6).
Abhängigkeiten & Parallelität
- Blocked by: D0-Baseline (
D-D0aApp-Shell + Public-Layout-Token,D-D0bArchetypen A2/A3/A5) — öffentliche Help-Routen liegen vor der Auth-Middleware, ohne Tenant-Context; Admin-Flächen unteradmin.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→ entfällt (AD-26); optional als MCP-Resource (VD-MCP)VD-P25/v2-P4 (Embedding-Quelle)- 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 →
Feedbackmit 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→ entfällt (AD-26); optional als MCP-Resource (VD-MCP)VD-P25/v2-P4 registrierbar (Embedding-Quelle)- 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→Feedbackim Plattform-Admin-Datenraum (Domäne 11, kein Tenant-RLS, App-Code permission-gegated)ROADMAP-V2.md§v2-P9 (Screens/Features = Hauptquelle) ·ROADMAP.md§Phase 29 ·_bmad-output/specs/M38-help-center.md·_bmad-output/specs/M39-help-desk.md- Plane-Snapshot: ersetzt/erweitert
VD-4; bedientVA-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: