docs: sync wireframes and finalize calendar
This commit is contained in:
1 parent
586994e28c
commit
e0a963aaab
67 files changed
+1125
-703
No files matched your search
@@ -4,23 +4,24 @@ project: HiveGrid Screen Project
|
||||
ticket: D-BOOK + D-P16 (Teil)
|
||||
package: WF-P16 Kalender
|
||||
typ: Flow
|
||||
status: Validiert
|
||||
subframe: ""
|
||||
status: Fertig / Development-Handoff
|
||||
subframe: "https://app.subframe.com/f023064a5ca0/flow/67196422-e7bc-4a60-9556-17b4edb83246/edit"
|
||||
canvas: "WF-P16 Kalender.canvas"
|
||||
source_checked: 2026-08-31
|
||||
---
|
||||
|
||||
# WF-P16 Kalender
|
||||
|
||||
Status: Validiert (Screen-Liste)
|
||||
Subframe-Link: -
|
||||
Canvas: [Canvas](<WF-P16 Kalender.canvas>)
|
||||
Stand: 2026-07-09
|
||||
Status: Fertig / Development-Handoff
|
||||
Subframe-Link: [Subframe-Flow](https://app.subframe.com/f023064a5ca0/flow/67196422-e7bc-4a60-9556-17b4edb83246/edit)
|
||||
Canvas: [Canvas](<WF-P16 Kalender.canvas>)
|
||||
Stand: 2026-08-31
|
||||
|
||||
---
|
||||
|
||||
## 1. Kurzfassung
|
||||
|
||||
Der HiveGrid-Kalender: Monats-/Wochen-Ansicht mit allen Terminen (Google-Sync, Buchungen, Plantafel, Projekt-Termine — je mit Herkunfts-Marker). **Davids Delta: ein vollwertiger Kalender**, nicht nur eine Lese-Sicht — Termine anlegen, Personen einladen (Team, Kontakte, freie E-Mails), Kollegen-Kalender als Verfügbarkeits-Overlay einblenden. Funktioniert eigenständig ohne Google; Google-Sync ist optional (Outlook → v2, in der UI als »bald verfügbar« sichtbar).
|
||||
Der Kalender bleibt ein bewusst kleines Feature: Termine aus Google, Buchungen, Plantafel, Projekten und HiveGrid in einer Wochen-/Monatsansicht sehen, schnell anlegen, öffnen und bearbeiten. Quick Create ist der Standardweg. Der vollständige Dialog erscheint nur über Weitere Optionen oder beim Bearbeiten. Nach relevanten Änderungen an einem bestehenden Termin entscheidet ein kleines Modal, ob die Teilnehmenden per E-Mail informiert werden.
|
||||
|
||||
---
|
||||
|
||||
@@ -28,12 +29,11 @@ Der HiveGrid-Kalender: Monats-/Wochen-Ansicht mit allen Terminen (Google-Sync, B
|
||||
|
||||
| Frage | Antwort |
|
||||
|---|---|
|
||||
| Ticket/Modul | D-BOOK (Kalender-View) + D-P16 (Kalender-Verbindungen), Dev-Pendant AK-P16a |
|
||||
| Nutzer-Ziel | Alle Termine an einem Ort sehen, neue Termine planen ohne Doppelbelegung, Google bleibt synchron |
|
||||
| Quellen geprüft | `ticket-docs/D-BOOK.md`, `ticket-docs/D-P16.md`, `designer-briefs/P16-…md`, HiveGrid Map |
|
||||
| Sicher im Scope | Kalender-Grid (Monat/Woche), Termin anlegen/bearbeiten + Einladen, Termin-Detail, Sync-Einstellungen inkl. Konflikt-Verlauf |
|
||||
| Sicher nicht im Scope | Buchungsseiten + Verfügbarkeits-Editor (WF-P16 Terminbuchung); Plantafel (WF-P9); Outlook-Sync (v2) |
|
||||
| Unsichere Annahmen | Termin-Objekt + Einladungen sind NICHT im Dev-Ticket — Change-Request nötig (s. Offene Fragen) |
|
||||
| Ticket/Modul | D-BOOK (Kalender-View) + D-P16 (Kalender-Verbindungen) |
|
||||
| Nutzer-Ziel | Termine zentral sehen und die meisten davon mit möglichst wenig Aufwand anlegen |
|
||||
| Sicher im Scope | Kalender-Grid, Quick Create, Quick-Create-Edit-State, vollständiger Termin-Dialog, Termin-Detail, E-Mail-Entscheidung bei Änderungen und eine schlanke Google-Verbindungsseite |
|
||||
| Sicher nicht im Scope | Buchungsseiten, Verfügbarkeits-Editor, Plantafel-Bearbeitung, Outlook-Sync v1, eigenes Konfliktfeature |
|
||||
| Leitlinie | Zustände innerhalb bestehender Oberflächen bevorzugen; keine unnötigen Unterseiten |
|
||||
|
||||
---
|
||||
|
||||
@@ -41,90 +41,131 @@ Der HiveGrid-Kalender: Monats-/Wochen-Ansicht mit allen Terminen (Google-Sync, B
|
||||
|
||||
| Punkt | Inhalt |
|
||||
|---|---|
|
||||
| Startpunkt | Sidebar »Kalender« |
|
||||
| Ziel | Termin geplant (mit Teilnehmern, ohne Kollision) · Google verbunden und synchron |
|
||||
| Haupt-Archetyp | **BESPOKE** (Kalender-Grid) + A6 (Einstellungen) |
|
||||
| Out of scope | Booking-Pages, Plantafel-Einsätze (nur als Quelle sichtbar), Outlook |
|
||||
| Startpunkt | Sidebar Kalender |
|
||||
| Ziel | Termin schnell geplant oder geändert; Teilnehmende bei Bedarf per E-Mail informiert |
|
||||
| Haupt-Archetyp | Bespoke Kalender-Grid + kompakte Dialoge + Settings |
|
||||
| Out of scope | Booking-Pages, Plantafel-Einsätze als Bearbeitungsfläche, Outlook-Sync |
|
||||
|
||||
---
|
||||
|
||||
## 4. Entscheidungen (validiert 2026-07-09)
|
||||
## 4. Entscheidungen
|
||||
|
||||
| Entscheidung | Status | Notiz |
|
||||
|---|---|---|
|
||||
| Vollwertiger Kalender statt reiner Lese-Sicht | genommen (Delta) | Termine anlegen/bearbeiten/löschen, »alles was man für einen Kalender braucht« — **Change-Request an Dev** (Ticket sah nur Grid + Marker vor) |
|
||||
| Einladen: Team + Kontakte + freie E-Mails | genommen (Delta) | Interne sehen den Termin in ihrem HiveGrid-Kalender; Externe bekommen E-Mail mit Kalender-Datei (.ics); Zu-/Absagen sichtbar |
|
||||
| Kollegen-Kalender einblendbar (Overlay) | genommen (Delta) | Vor dem Einladen prüfen, ob jemand Zeit hat; fremde private Google-Termine nur als »belegt« ohne Details |
|
||||
| Eigener + fremde Kalender in einer Ansicht | genommen | Plantafel bleibt die Baustellen-/Einsatz-Sicht — der Kalender ist die Termin-Sicht |
|
||||
| Verbinden-Einstieg direkt im Kalender | genommen | Hinweis-Karte solange nichts verbunden ist; danach über Zahnrad → Einstellungen. Kalender ist auch ohne Google voll nutzbar |
|
||||
| Provider-Auswahl mit Outlook-Teaser | genommen | Google aktiv (v1), Outlook ausgegraut »bald verfügbar« — UI bleibt provider-neutral |
|
||||
| Sync-Konflikt-Verlauf in den Einstellungen | genommen | Kleine Sektion (letzte 50, Klartext: was kollidierte, wie gelöst) — Muster wie Abgleich-Verlauf WF-P5; im Kalender nur dezenter Hinweis bei frischen Konflikten |
|
||||
| OAuth-Assistent + Trennen-Modal aus WF-P5 wiederverwenden | genommen | Trennen mit »auch extern entfernen?«-Wahl |
|
||||
| Vollwertiger Kalender | genommen | Termine können angelegt, geöffnet, bearbeitet und gelöscht werden |
|
||||
| Quick Create als Standardweg | final | Slot-Klick und Termin anlegen öffnen M01; Weitere Optionen führt mit übernommenen Eingaben zu M01b |
|
||||
| Datum/Uhrzeit direkt in Quick Create korrigieren | final | Klick auf die Zeitzeile wechselt in M01a mit Inline-Date-/Time-Pickern |
|
||||
| Vollständiger Termin-Dialog | final | Nur die zweispaltige Version bleibt; V2 und V3 wurden gelöscht |
|
||||
| Einladen: Team, Kontakte und freie E-Mails | genommen | Interne sehen den Termin in HiveGrid; Externe erhalten E-Mail und Kalenderdaten |
|
||||
| Änderungen per E-Mail senden | final | M03 erscheint nach relevanten Änderungen an einem bestehenden Termin mit Teilnehmenden; Zurück, ohne E-Mail speichern oder E-Mail senden |
|
||||
| Kollegen-Kalender als Overlay | genommen | Private Fremdtermine erscheinen nur als Belegt |
|
||||
| Konflikte bewusst schlank | final | Kein eigener Konflikt-Screen oder Pop-up; nur ein kleiner Badge Möglicher Konflikt direkt an einer Person |
|
||||
| Einstellungen auf Verbindung reduzieren | final | Eine Seite für Google-Status, Kalenderauswahl, neu verbinden und trennen |
|
||||
| Outlook | Backlog | In S02 nur als deaktivierter Demnächst-Teaser |
|
||||
|
||||
### Happy Path
|
||||
|
||||
1. Mitarbeiter öffnet Kalender (Woche), sieht eigene Termine quell-farbig (Google / Buchung / Plantafel / Projekt / eigene).
|
||||
2. Klick auf freien Slot → Termin-Dialog: Titel, Zeit, Teilnehmer (Kollege @Max, Kontakt Müller, freie E-Mail) — beim Hinzufügen zeigt der Dialog, wer belegt ist; optional Kollegen-Kalender als Overlay einblenden.
|
||||
3. Speichern → Interne sehen den Termin sofort, Externe bekommen Mail mit .ics; Zu-/Absagen laufen am Termin auf.
|
||||
4. Einmalig: »Google verbinden« → OAuth (P5-Muster) → Kalender auswählen, Sync-Richtung — ab da läuft alles synchron.
|
||||
1. Mitarbeiter öffnet S01 und sieht Termine aus allen Quellen.
|
||||
2. Slot-Klick oder Termin anlegen öffnet M01 Quick Create mit vorausgefüllter Zeit.
|
||||
3. Klick auf die Zeitzeile wechselt bei Bedarf in M01a und danach zurück in den kompakten Zustand.
|
||||
4. Speichern legt einen einfachen Termin direkt an.
|
||||
5. Weitere Optionen öffnet M01b für zusätzliche Angaben.
|
||||
6. Termin-Klick öffnet M02; Bearbeiten führt bei eigenen Terminen zu M01b.
|
||||
7. Wird ein bestehender Termin mit Teilnehmenden relevant geändert, öffnet Speichern M03.
|
||||
8. M03 speichert ohne E-Mail oder speichert und versendet die aktualisierten Termindaten per E-Mail.
|
||||
|
||||
### Meldungs-/Error-States (validiert)
|
||||
### Zustände
|
||||
|
||||
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|
||||
| Ereignis | UI-Form | Blockiert? | Status |
|
||||
|---|---|---|---|
|
||||
| Kein Google verbunden | Hinweis in S01 und Verbindungsbereich in S02 | nein | dokumentiert |
|
||||
| Verbindung abgelaufen | Re-Connect-Banner in S01 und Aktion in S02 | nein | in S01 sichtbar |
|
||||
| Person möglicherweise belegt | Kleiner Badge direkt an der Person | nein | in M01b sichtbar |
|
||||
| Fremder privater Google-Termin | Belegt-Block ohne Details | nein | in S01 sichtbar |
|
||||
| Einladungs-Mail unzustellbar | Hinweis am Teilnehmer plus erneut senden | nein | in M02 sichtbar |
|
||||
| Änderungen an bestehendem Termin | M03 E-Mail-Entscheidung | ja, bis Entscheidung | gebaut |
|
||||
| Leerer Kalender | Empty State mit Termin-/Google-CTA | nein | nur dokumentiert |
|
||||
|
||||
---
|
||||
|
||||
## 5. Validierte Screen-Liste
|
||||
|
||||
| ID | Screen/Zustand | Typ | Ort | Status |
|
||||
|---|---|---|---|---|
|
||||
| Kein Google verbunden | Hinweis-Karte in S01 (dismissbar) + Bereich in S02 | nein | Nur dokumentieren | »Verbinde deinen Google-Kalender …« — Kalender funktioniert trotzdem |
|
||||
| Verbindung kaputt (Token abgelaufen) | Re-Connect-Banner in S01 + S02 | nein | Nur dokumentieren | Klartext + »Neu verbinden«-Knopf |
|
||||
| Sync-Konflikt (beidseitige Änderung) | Benachrichtigung (Glocke) + Eintrag im Konflikt-Verlauf (S02) | nein | Nur dokumentieren | »Termin X wurde in Google auf 14:00 verschoben — HiveGrid hat übernommen« (Last-Write-Wins) |
|
||||
| Teilnehmer belegt | Inline-Warnung im Termin-Dialog | nein (bewusst buchbar) | in M01 enthalten | »Max ist 9–12 Uhr belegt« — analog Plantafel-Konflikt, aber ohne Block |
|
||||
| Fremder privater Google-Termin | nur »belegt«-Block ohne Titel/Details | nein | Nur dokumentieren | Datenschutz-Vorgabe aus dem Ticket |
|
||||
| Einladungs-Mail unzustellbar | Hinweis am Teilnehmer in M02 | nein | Nur dokumentieren | Bounce-Marker + erneut senden |
|
||||
| Leerer Kalender | Leer-Zustand + CTA (Termin anlegen / Google verbinden) | nein | Nur dokumentieren | — |
|
||||
| S01 | Kalender | Bespoke Grid | /calendar | Fertig / Development-Handoff |
|
||||
| M01 | Quick Create | Kompakter Dialog | Slot-Klick / Termin anlegen | Fertig / Development-Handoff |
|
||||
| M01a | Quick Create Edit Mode | Zustand von M01 | Klick auf Zeitzeile | Fertig / Development-Handoff |
|
||||
| M01b | Termin vollständig anlegen/bearbeiten | Modal | Weitere Optionen / Bearbeiten | Fertig / Development-Handoff |
|
||||
| M02 | Termin-Detail | Popover | Termin-Klick | Fertig / Development-Handoff |
|
||||
| M03 | Änderungen per E-Mail senden | Bestätigungsmodal | Speichern eines geänderten Termins | Fertig / Development-Handoff |
|
||||
| S02 | Kalender-Verbindungen | Settings | /settings/integrations/calendar | Fertig / Development-Handoff |
|
||||
|
||||
Wiederverwendet werden der OAuth-Assistent und das Trennen-Modal aus WF-P5. Sie sind keine zusätzlichen Kalender-Screens.
|
||||
|
||||
---
|
||||
|
||||
## 7. Validierte Screen-Liste
|
||||
## 6. Flow
|
||||
|
||||
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|
||||
|---|---|---|---|---|---|
|
||||
| S01 | Kalender (Monat/Woche, Quell-Marker, Kollegen-Overlay) ⭐ | BESPOKE | Bauen | `/calendar` | Validiert |
|
||||
| M01 | Termin anlegen/bearbeiten (Teilnehmer + Verfügbarkeits-Check) | Modal | Bauen | aus S01 (Slot-Klick / + Termin) | Validiert |
|
||||
| M02 | Termin-Detail (Quelle + Absprung, Zu-/Absagen) | Popover | Bauen | Termin-Klick in S01 | Validiert |
|
||||
| S02 | Kalender-Einstellungen & Sync (Provider, Kalender-Auswahl, Richtung, Konflikt-Verlauf) | Settings (A6) | Bauen | `/calendar/settings` | Validiert |
|
||||
| D01 | OAuth-Assistent | Wiederverwenden | Wiederverwenden | WF-P5 M01 | Validiert |
|
||||
| D02 | Trennen-Bestätigung (»auch extern entfernen?«) | Wiederverwenden | Wiederverwenden | WF-P5 M03 (+ Extern-Wahl) | Validiert |
|
||||
| D03–D07 | Verbinden-Hinweis / Re-Connect / Konflikt / »belegt« / Leer (s. Tabelle) | Inline | Nur dokumentieren | — | Validiert |
|
||||
- Sidebar → S01
|
||||
- S01 → M01 über Slot-Klick oder Termin anlegen
|
||||
- M01 → M01a über Klick auf Datum/Uhrzeit
|
||||
- M01a → M01 mit aktualisiertem Zeitraum
|
||||
- M01 → M01b über Weitere Optionen
|
||||
- S01 → M02 über Termin-Klick
|
||||
- M02 → M01b über Bearbeiten
|
||||
- M01b → M03, wenn ein bestehender Termin mit Teilnehmenden relevant geändert wurde
|
||||
- M03 → M01b über Zurück
|
||||
- M03 → Kalender beziehungsweise Termin-Detail über Ohne E-Mail speichern oder E-Mail senden
|
||||
- S01 → S02 über Verbinden beziehungsweise Einstellungen
|
||||
|
||||
---
|
||||
|
||||
## 8. Grid
|
||||
## 7. Screen-Dateien
|
||||
|
||||
```text
|
||||
Sidebar -> S01 (Monat/Woche, Quellen: Google + Buchung + Plantafel + Projekt + eigene)
|
||||
S01 -> M01 (Slot-Klick / »+ Termin«: anlegen mit Teilnehmern + Verfügbarkeits-Check)
|
||||
S01 -> M02 (Termin-Klick: Detail-Popover, Quelle-Absprung, Zu-/Absagen)
|
||||
M02 -> M01 (Bearbeiten, nur bei eigenen Terminen)
|
||||
S01 -> S02 (Zahnrad / Verbinden-Hinweis: Provider, Kalender-Auswahl, Sync-Richtung, Konflikt-Verlauf)
|
||||
S02 nutzt WF-P5: OAuth-Assistent (M01) + Trennen-Modal (M03)
|
||||
Quell-Absprünge: Buchung -> WF-P16 Terminbuchung · Einsatz -> WF-P9 Plantafel · Projekt-Termin -> WF-P9 Projekt-Akte
|
||||
```
|
||||
- [[S01 Kalender]]
|
||||
- [[M01 Quick Create]]
|
||||
- [[M01a Quick Create Edit Mode]]
|
||||
- [[M01b Termin-Dialog]]
|
||||
- [[M02 Termin-Detail]]
|
||||
- [[M03 Änderungen per E-Mail senden]]
|
||||
- [[S02 Kalender-Einstellungen]]
|
||||
|
||||
---
|
||||
|
||||
## 9. Screen-Pakete
|
||||
## 8. Subframe-Vollabgleich
|
||||
|
||||
- [[S01 Kalender]] · [[M01 Termin-Dialog]] · [[M02 Termin-Detail]] · [[S02 Kalender-Einstellungen]]
|
||||
Der Flow enthält aktuell genau sieben Live-Seiten für sieben dokumentierte Screens beziehungsweise Zustände. Die gelöschten Seiten M01 V2, M01 V3 und der frühere Quick-Create-Picker sind nicht mehr Teil des Pakets.
|
||||
|
||||
---
|
||||
| Subframe-Seite | Logische Zuordnung | Befund | Link |
|
||||
|---|---|---|---|
|
||||
| S01 Kalender V1 | S01 | Wochenansicht mit Quellen und Kollegen-Overlay | [Subframe](https://app.subframe.com/f023064a5ca0/design/238adab5-a284-4065-91b5-28cd894f6b31/edit) |
|
||||
| M01 Quick Create | M01 | Kompakter Standardweg | [Subframe](https://app.subframe.com/f023064a5ca0/design/a4088a8a-fab2-433c-b2ff-46a521640999/edit) |
|
||||
| M01a Quick Create Edit Mode | M01a | Inline-Felder für Start und Ende | [Subframe](https://app.subframe.com/f023064a5ca0/design/1c0335d4-b6c9-4418-9ee6-f817928720e7/edit) |
|
||||
| M01 Termin anlegen V4 Zweispaltig | M01b | Einzige verbliebene Vollansicht | [Subframe](https://app.subframe.com/f023064a5ca0/design/eaf3f0ba-f80f-4ba3-b0a1-16e2695a2122/edit) |
|
||||
| M02 Termindetail Popover V1 | M02 | Termin-Detail mit Teilnehmerstatus und Antwortaktionen | [Subframe](https://app.subframe.com/f023064a5ca0/design/99fbcf22-50fd-42de-9243-278d1ef746c1/edit) |
|
||||
| M03 Änderungen per E-Mail senden | M03 | Google-ähnliche Entscheidung mit drei Aktionen | [Subframe](https://app.subframe.com/f023064a5ca0/design/3bac63a2-82fe-487a-9a0a-0dab263cc6d0/edit) |
|
||||
| S02 Kalender-Verbindungen V2 | S02 | Eine schlanke Verbindungsseite | [Subframe](https://app.subframe.com/f023064a5ca0/design/e95220a1-132a-445d-b785-d292385faa5e/edit) |
|
||||
|
||||
## 10. Offene Fragen
|
||||
### High-Level-Bewertung
|
||||
|
||||
- **Change-Request an Dev (groß):** Eigenes Termin-Objekt + Einladungen (Team/Kontakt/freie E-Mail, .ics-Versand, Zu-/Absage-Tracking) + Free/Busy-Overlay — Ticket AK-P16a sah nur Lese-Grid + Sync vor; ENTITY-MODEL Domäne 9 braucht Ergänzung
|
||||
- Zu-/Absage-Tracking bei internen Teilnehmern: eigener Status oder reicht angenommen/abgelehnt wie extern? → Dev
|
||||
- Erinnerungen vor Terminen (Push/Mail)? → v2-Kandidat, mit Benachrichtigungen (P3) klären
|
||||
- Tages-Ansicht zusätzlich zu Monat/Woche? → beim Subframe-Bau entscheiden
|
||||
Der Satz ist für den einfachen Kalender ausreichend. M01a und M03 sind klar begrenzte Zustände, keine eigenen tiefen Features. Zusätzliche Seiten für Konflikte, Datenschutz, Benachrichtigungseinstellungen oder ein Verbindungsdetail sind nicht nötig.
|
||||
|
||||
### Finaler Development-Vertrag
|
||||
|
||||
- S01 implementiert in v1 Monat und Woche. Der im statischen Mock sichtbare Tag-Umschalter wird nicht übernommen.
|
||||
- S01 erhält Heute, einen direkten Zugang zu S02 und im Re-Connect-Banner die konkrete Aktion Neu verbinden.
|
||||
- M01a und M01b übernehmen Datum und Uhrzeit immer aus dem gewählten Slot beziehungsweise bestehenden Termin; die sichtbaren Platzhalter sind nur Design-Daten.
|
||||
- M02 wird rollen- und quellenabhängig ausgespielt: Organisatoren sehen Bearbeiten/Löschen, eingeladene Nutzer Zusagen/Ablehnen und fremde Quellen nur den passenden Absprung. Duplizieren und Verschieben sind nicht Teil von v1.
|
||||
- Bounce wird in der Nutzeroberfläche als Nicht zustellbar bezeichnet.
|
||||
- Der ältere technische Subframe-Name von M01b ist kein Implementierungsbegriff und blockiert den Handoff nicht.
|
||||
- Empty-, Loading-, Error-, Permission- und Offline-Zustände verwenden bestehende globale Standards und benötigen keine zusätzlichen Kalender-Screens.
|
||||
|
||||
## Handoff-Check
|
||||
|
||||
- [x] Jeder Screen ist mit Umsetzung markiert.
|
||||
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
|
||||
- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*
|
||||
- [x] Alle sieben Live-Seiten sind erfasst.
|
||||
- [x] Gelöschte Varianten und tote Links sind aus dem Paket entfernt.
|
||||
- [x] Quick Create und Edit Mode entsprechen der aktuellen Benennung.
|
||||
- [x] M03 ist gebaut, gerendert und dokumentiert.
|
||||
- [x] Der Konfliktumfang bleibt auf den kleinen Personen-Badge beschränkt.
|
||||
- [x] Sichtbare Mock-Abweichungen sind als verbindliche Development-Regeln entschieden.
|
||||
- [x] Das Kalender-Paket ist bereit für Development.
|
||||
Reference in new issue
Block a user