Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,59 @@
|
||||
# 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:
|
||||
Reference in new issue
Block a user