Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VD-P29.md
T

5.4 KiB
Raw Blame History

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 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 VD-P25/v2-P4 (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 VD-P25/v2-P4 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)
  • 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; 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: