chore(repo): sync wireframe structure and references

This commit is contained in:
david committed 2026-08-08 03:09:06 +02:00
1 parent 05d2d5777f
commit d953a79e95
453 files changed
+36639 -621

No files matched your search

@@ -0,0 +1,39 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-BOOK + D-P16 (Teil)
package: WF-P16 Kalender
id: M01
screen: Termin anlegen/bearbeiten
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S01 (Slot-Klick / + Termin)"
subframe: ""
---
# M01 — Termin anlegen/bearbeiten
## Ziel
Einen Termin planen wie in Google Calendar — mit Teilnehmern, und ohne jemanden doppelt zu verplanen.
## Was das Tool können muss
- **Grunddaten:** Titel, Datum + Uhrzeit (von–bis), optional ganztägig, Ort, Beschreibung/Notiz
- **Teilnehmer-Feld** (ein Feld, drei Arten):
- **Team-Mitglieder** (@-Vorschläge) — sehen den Termin sofort in ihrem HiveGrid-Kalender
- **Kontakte** (aus dem CRM) — bekommen E-Mail mit Kalender-Datei (.ics)
- **freie E-Mail-Adressen** — ebenfalls Mail + .ics, ohne Kontakt-Anlage
- **Verfügbarkeits-Check:** beim Hinzufügen interner Teilnehmer zeigt der Dialog belegt/frei im gewählten Zeitraum (»Max ist 9–12 Uhr belegt«) — Warnung, kein Block; Link »Kalender einblenden« aktiviert das Overlay in S01
- Optionale **Projekt-Verknüpfung** (Termin erscheint dann auch in der Projekt-Akte)
- Bearbeiten nutzt denselben Dialog (nur bei eigenen Terminen); Änderung informiert Teilnehmer
- Speichern → zurück in S01, Termin sichtbar; bei Google-Sync geht der Termin auch extern raus
## Pattern / Archetyp
A5 Dialog + A4 Formular-Felder. Teilnehmer-Feld = @-Erwähnungs-Muster aus dem UI-Baukasten.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,35 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-BOOK + D-P16 (Teil)
package: WF-P16 Kalender
id: M02
screen: Termin-Detail
typ: Popover
umsetzung: Bauen
status: Validiert
route: "Termin-Klick in S01"
subframe: ""
---
# M02 — Termin-Detail (Popover)
## Ziel
Schnell sehen, was das für ein Termin ist, wer kommt — und mit einem Klick zur Quelle springen.
## Was das Tool können muss
- Titel, Zeit, Ort, Beschreibung, **Quelle-Badge** (Google / Buchung / Plantafel / Projekt / eigener Termin)
- **Teilnehmer-Liste mit Zu-/Absage-Status** (zugesagt / abgesagt / offen); Bounce-Marker wenn Einladungs-Mail unzustellbar (+ erneut senden)
- **Absprung zur Quelle:** Buchung → Buchungs-Detail · Einsatz → Plantafel · Projekt-Termin → Projekt-Akte · Google-Termin → nur lesen (Hinweis »kommt aus Google«)
- **Aktionen je nach Quelle:** eigene Termine → Bearbeiten (M01) + Löschen (mit Teilnehmer-Info); fremde Quellen → nur Absprung
- Für eingeladene interne Nutzer: **Zusagen/Absagen** direkt im Popover
## Pattern / Archetyp
Popover (leichtgewichtig, kein volles Modal) — Muster: Termin-Klick wie in Google Calendar.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,40 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-BOOK + D-P16 (Teil)
package: WF-P16 Kalender
id: S01
screen: Kalender
typ: BESPOKE Kalender-Grid
umsetzung: Bauen
status: Validiert
route: "/calendar"
subframe: ""
---
# S01 — Kalender (Monat/Woche) ⭐
## Ziel
Alle Termine an einem Ort — egal ob aus Google, einer Online-Buchung, der Plantafel, einem Projekt oder von Hand angelegt. Und: neue Termine direkt hier planen.
## Was das Tool können muss
- **Monats- und Wochen-Ansicht** mit Umschalter, Heute-Knopf, Zeitraum-Navigation (Pfeile)
- **Quell-Marker je Termin** (Farbe/Icon): Google · Buchung · Plantafel-Einsatz · Projekt-Termin · eigener Termin
- **Kollegen einblenden (Overlay):** Mitarbeiter-Auswahl (Avatare/Checkboxen) — deren HiveGrid-Termine erscheinen normal, private Google-Termine nur als **»belegt«** ohne Titel/Details
- **Termin anlegen:** Klick auf freien Slot oder »+ Termin«-Knopf → M01
- **Termin öffnen:** Klick auf Termin → M02 (Detail-Popover)
- **Verbinden-Hinweis** solange kein Google-Konto verbunden ist (dismissbar, mit »Verbinden«-Knopf → S02); Kalender ist auch ohne Verbindung voll nutzbar
- **Re-Connect-Banner** bei kaputter Verbindung (Klartext + Lösungs-Knopf)
- Dezenter Hinweis bei frischen Sync-Konflikten mit Link zum Konflikt-Verlauf (S02)
- Zahnrad → Kalender-Einstellungen (S02)
- Zustände: leer (CTA Termin anlegen / Google verbinden), laden, Fehler
## Pattern / Archetyp
BESPOKE (Kalender-Grid, mittlerer Aufwand laut Ticket). Zustands-Set A7.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-BOOK + D-P16 (Teil)
package: WF-P16 Kalender
id: S02
screen: Kalender-Einstellungen & Sync
typ: Settings (A6)
umsetzung: Bauen
status: Validiert
route: "/calendar/settings"
subframe: ""
---
# S02 — Kalender-Einstellungen & Sync
## Ziel
Sein eigenes Google-Konto verbinden und den Abgleich steuern — pro Mitarbeiter, ohne Admin-Umweg. Erreichbar direkt aus dem Kalender (Zahnrad / Verbinden-Hinweis).
## Was das Tool können muss
- **Provider-Auswahl:** Google (aktiv) · Outlook (**ausgegraut, »bald verfügbar«** — v2); UI bleibt provider-neutral
- **Verbinden:** startet den OAuth-Assistenten im WF-P5-Muster (M01) → danach Connect-Card mit Status-Ampel, verbundenem Konto (E-Mail), letzter Sync-Zeit
- **Kalender-Auswahl:** welche Google-Kalender abgeglichen werden (Checkbox-Liste)
- **Sync-Richtung:** beide Richtungen · nur HiveGrid → Google · nur Google → HiveGrid
- **Trennen** mit »auch extern entfernen?«-Wahl (Trennen-Modal aus WF-P5 M03, erweitert um die Extern-Wahl) — kein Hard-Delete
- **Re-Connect-Banner** bei kaputter Verbindung (Token abgelaufen o. ä.)
- **Konflikt-Verlauf-Sektion:** letzte 50 automatische Auflösungen in Klartext — »Termin ›Wartung Müller‹ wurde in Google auf 14:00 verschoben — HiveGrid hat übernommen« (Last-Write-Wins); jede Auflösung erzeugt zusätzlich eine Benachrichtigung
- Hinweis: Verbindung ist **pro Mitarbeiter** — jeder verwaltet hier nur sein eigenes Konto; fremde Termin-Inhalte bleiben privat (nur »belegt«)
## Pattern / Archetyp
A6 Settings/Connection — Connection-Card-Muster aus WF-P5 Integrationen; Konflikt-Verlauf analog Abgleich-Verlauf (WF-P5 S03), hier nur als Sektion.
## Subframe
- (erst nach explizitem OK)