Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-P29.md
T

59 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: