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,33 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-PLAN
package: WF-P9 Plantafel
id: M01
screen: Konflikt-Dialog
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S01 bei Konflikt"
subframe: ""
---
# M01 — Konflikt-Dialog (»Trotzdem zuweisen?«)
## Ziel
Konflikte nicht verhindern, sondern **bewusst machen** — das Büro entscheidet informiert.
## Was das Tool können muss
- Klartext-Grund: »Max ist an dem Tag im Urlaub« / »Max ist bereits bei Projekt X verplant (9–12 Uhr)« / »außerhalb der Arbeitszeit«
- Bei Doppelbelegung: der andere Einsatz verlinkt
- Entscheidung: **»Trotzdem zuweisen«** oder abbrechen (Block springt zurück)
## Pattern / Archetyp
A5 Dialog (echtes Modal).
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,34 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-PLAN
package: WF-P9 Plantafel
id: M02
screen: Einsatz-Dialog
typ: Modal/Panel
umsetzung: Bauen
status: Validiert
route: "aus S01 (leerer Slot / Einsatz-Klick)"
subframe: ""
---
# M02 — Einsatz anlegen/bearbeiten
## Ziel
Einsatz in Sekunden anlegen — Mitarbeiter und Zeit sind vom Slot schon vorbelegt.
## Was das Tool können muss
- Vorbelegt: Mitarbeiter + Zeitraum (vom angeklickten Slot)
- **Projekt wählen** (Auto-Complete) · Zeitraum anpassen · Notiz
- Status setzen (Default: geplant)
- Konflikt-Prüfung beim Speichern → ggf. [[M01 Konflikt-Dialog]]
## Pattern / Archetyp
A5 Dialog (echtes Modal).
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,44 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-PLAN
package: WF-P9 Plantafel
id: S01
screen: Plantafel
typ: BESPOKE Grid
umsetzung: Bauen
status: Validiert
route: "/projects/plantafel"
subframe: ""
---
# S01 — Plantafel (Desktop-Raster) ⭐
## Ziel
Das Büro verplant alle Monteure kollisionsfrei — auf einen Blick.
## Was das Tool können muss
- Raster: **Zeilen = Mitarbeiter, Spalten = Zeit** (Umschalter Tag/Woche/Monat)
- Einsatz-Blöcke: Projekt-Titel, Status-Farbe (vom Board-Status), Adresse kurz
- **Ziehen = verschieben, Kante ziehen = verlängern/kürzen**; Klick auf leeren Slot → [[M02 Einsatz-Dialog]]
- **Konflikt-Marker** am Block (doppelt / Urlaub/krank aus HR / außerhalb Arbeitszeit); Zuweisung trotzdem möglich via [[M01 Konflikt-Dialog]]
- Status-Kette je Einsatz: geplant → bestätigt → unterwegs → fertig/abgesagt
- Mehrfachauswahl → **Bulk-Umplanung** auf anderen Monteur
- Filter: Mitarbeiter (Rolle/Gruppe/Verfügbarkeit) + Projekt · Kalender-Sync-Marker je Einsatz
## Pattern / Archetyp
**BESPOKE** — Scheduling-Grid.
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Noch keine Einsätze in diesem Zeitraum« | Nur dokumentieren |
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,42 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-PLAN
package: WF-P9 Plantafel
id: S02
screen: Meine Termine
typ: BESPOKE-Mobile (offline)
umsetzung: Bauen
status: Validiert
route: "Handy / Bottom-Nav »Heute«"
subframe: ""
---
# S02 — Meine Termine 📱 (Heute ↔ Woche)
## Ziel
Der Monteur weiß immer, wo er als Nächstes hin muss — auch im Keller ohne Netz.
## Was das Tool können muss
- **Heute-Liste** (Hauptansicht): je Einsatz Projekt, Zeit, **Adresse + Navi-Link**, Ansprechpartner mit Anruf-Knopf
- **Status per Tipp**: bestätigt → unterwegs → fertig
- Umschalter oben: **Heute ↔ Woche** (kompakte Wochen-Sicht) — ein Frame, validiert
- Einsatz antippen → Projekt-Mobil-Modus (WF-P9 Projekt-Akte S02)
- **Offline-fähig**: Liste gecacht, Status-Tipps werden bei Verbindung nachgereicht (Sync-Status sichtbar)
## Pattern / Archetyp
📱 BESPOKE-Mobile, große Touch-Ziele, Bottom-Nav-Einstieg »Heute«.
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Offline | Banner »offline — Änderungen werden nachgereicht« + Sync-Status | Nur dokumentieren |
| Keine Termine heute | »Heute keine Einsätze« | Nur dokumentieren |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,21 @@
{
"nodes":[
{"id":"md-paket","type":"file","file":"02 Wireframes/P9 Plantafel/WF-P9 Plantafel/WF-P9 Plantafel.md","x":-80,"y":-440,"width":460,"height":280},
{"id":"group-desktop","type":"group","x":-80,"y":-100,"width":1140,"height":380,"label":"Büro (Desktop, Bespoke)"},
{"id":"group-dialoge","type":"group","x":-80,"y":460,"width":1140,"height":380,"label":"Dialoge"},
{"id":"group-mobil","type":"group","x":1200,"y":-100,"width":1120,"height":380,"label":"Monteur 📱 (offline)"},
{"id":"note-entry","type":"text","text":"# Einstieg\n\nSidebar → Plantafel.\n\nKonflikte gespeist aus HR (Urlaub/krank) + Kalender-Abgleich.","x":0,"y":0,"width":360,"height":200},
{"id":"s01","type":"file","file":"02 Wireframes/P9 Plantafel/WF-P9 Plantafel/Screens/S01 Plantafel.md","x":560,"y":0,"width":420,"height":200},
{"id":"m02","type":"file","file":"02 Wireframes/P9 Plantafel/WF-P9 Plantafel/Screens/M02 Einsatz-Dialog.md","x":0,"y":560,"width":420,"height":200},
{"id":"m01","type":"file","file":"02 Wireframes/P9 Plantafel/WF-P9 Plantafel/Screens/M01 Konflikt-Dialog.md","x":580,"y":560,"width":420,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P9 Plantafel/WF-P9 Plantafel/Screens/S02 Meine Termine.md","x":1240,"y":0,"width":420,"height":200},
{"id":"note-mobil","type":"text","text":"# Monteur-Einstieg\n\nBottom-Nav »Heute«. Ein Frame mit Umschalter Heute ↔ Woche (validiert). Tipp auf Einsatz → Projekt-Mobil-Modus.","x":1800,"y":0,"width":460,"height":200}
],
"edges":[
{"id":"e-entry","fromNode":"note-entry","fromSide":"right","toNode":"s01","toSide":"left","toEnd":"arrow","styleAttributes":{"path":"dotted"}},
{"id":"e-slot","fromNode":"s01","fromSide":"bottom","toNode":"m02","toSide":"top","toEnd":"arrow","label":"Slot-Klick / Einsatz öffnen"},
{"id":"e-konflikt","fromNode":"m02","fromSide":"right","toNode":"m01","toSide":"left","toEnd":"arrow","label":"bei Konflikt"},
{"id":"e-drag","fromNode":"s01","fromSide":"bottom","toNode":"m01","toSide":"top","toEnd":"arrow","label":"Drag&Drop bei Konflikt","styleAttributes":{"path":"long-dashed"}},
{"id":"e-mobil","fromNode":"note-mobil","fromSide":"left","toNode":"s02","toSide":"right","toEnd":"arrow","styleAttributes":{"path":"dotted"}}
]
}
@@ -0,0 +1,118 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-PLAN
package: WF-P9 Plantafel
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P9 Plantafel.canvas"
---
# WF-P9 Plantafel
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P9 Plantafel.canvas>)
Stand: 2026-07-09
---
## 1. Kurzfassung
Die Einsatzplanung: Raster Mitarbeiter × Zeit mit Drag&Drop, Konflikt-Warnungen (Doppelbelegung, Urlaub/krank aus HR, Arbeitszeit) — und der offline-fähige Monteur-Handy-Modus »Meine Termine heute/Woche«. **Bespoke, höchste Priorität nach dem Flow-Editor.**
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Ticket/Modul | D-PLAN, Dev-Pendant R-P9a/R-P9b |
| Nutzer-Ziel | Büro: Monteure kollisionsfrei verplanen · Monteur: wissen, wo er heute hin muss — auch ohne Netz |
| Quellen geprüft | `ticket-docs/D-PLAN.md`, ENTITY-MODEL Domäne 5, HiveGrid Map |
| Sicher im Scope | Desktop-Raster, Einsatz-Dialog, Konflikt-Dialog, Monteur-Modus (Heute + Woche), Kalender-Sync-Marker |
| Sicher nicht im Scope | Material-Ausgang, Zeiterfassung, Leistungspositionen (v2); Abnahme (eigenes Paket) |
| Unsichere Annahmen | — |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Startpunkt | Sidebar »Plantafel« (Desktop) · Bottom-Nav »Heute« (Monteur) |
| Ziel | Einsatz geplant/verschoben ohne Konflikt · Monteur beim Kunden |
| Haupt-Archetyp | **BESPOKE** (Grid) + 📱 offline |
| Out of scope | v2-Themen s. o. |
---
## 4. Entscheidungen (validiert 2026-07-09)
| Entscheidung | Status | Notiz |
|---|---|---|
| Monteur-Modus als EIN Frame mit Umschalter Heute ↔ Woche | genommen | Heute-Liste ist die Hauptansicht |
| Konflikt-Dialog »Trotzdem zuweisen?« wird gebaut | genommen | Klartext-Grund (doppelt / Urlaub / krank / außerhalb Arbeitszeit) + bewusste Entscheidung |
| Einsatz-Dialog (Klick auf leeren Slot / Einsatz) | genommen | Projekt wählen, Zeitraum, Notiz; Status-Kette geplant→bestätigt→unterwegs→fertig/abgesagt |
| Status-Farbe der Einsätze = Board-Status des Projekts | genommen | Ticket-Vorgabe (pipeline-basiert) |
| Konflikte kommen aus HR (Urlaub/krank) + Kalender | genommen | Querverbindungen aus der Map |
### Happy Path
1. Büro öffnet Plantafel (Woche), sieht alle Monteure als Zeilen.
2. Einsatz per Klick auf freien Slot anlegen oder per Ziehen verschieben/verlängern.
3. Konflikt? Dialog erklärt in Klartext, warum — zuweisen geht trotzdem (bewusst).
4. Monteur am Handy: »Heute« — Liste mit Adresse + Navi-Link, Status per Tipp (unterwegs → fertig). Funktioniert offline, synct später.
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Konflikt beim Zuweisen | Dialog »Trotzdem zuweisen?« | ja (Aktion) | Bauen (M01) | Klartext-Grund |
| Offline (Monteur) | Hinweis + Sync-Status | nein | Nur dokumentieren | Status-Tipps werden nachgereicht |
| Kalender-Sync aktiv | kleiner Marker am Einsatz | nein | Nur dokumentieren | — |
| Leere Tafel | Leer-Zustand + CTA | nein | Nur dokumentieren | — |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Plantafel (Desktop-Raster) ⭐ | BESPOKE | Bauen | `/projects/plantafel` | Validiert |
| S02 | Meine Termine 📱 (Heute ↔ Woche) | BESPOKE-Mobile, offline | Bauen | Handy / Bottom-Nav »Heute« | Validiert |
| M01 | Konflikt-Dialog (»Trotzdem zuweisen?«) | Modal | Bauen | aus S01 | Validiert |
| M02 | Einsatz anlegen/bearbeiten | Modal/Panel | Bauen | aus S01 (Slot-Klick) | Validiert |
| D01–D03 | Offline/Sync-Marker/Leer (s. Tabelle) | Inline | Nur dokumentieren | — | Validiert |
---
## 8. Grid
```text
Sidebar -> S01 (Raster: Y=Mitarbeiter, X=Zeit, Tag/Woche/Monat)
S01 -> M02 (Slot-Klick: Einsatz anlegen/bearbeiten)
M02/Drag&Drop -> M01 (bei Konflikt)
Monteur-Handy -> S02 (Heute <-> Woche, offline) -> Projekt-Mobil-Modus (WF-P9 Projekt-Akte S02)
Konflikte gespeist aus: HR (Urlaub/krank) + Kalender-Abgleich
```
---
## 9. Screen-Pakete
- [[S01 Plantafel]] · [[S02 Meine Termine]] · [[M01 Konflikt-Dialog]] · [[M02 Einsatz-Dialog]]
---
## 10. Offene Fragen
- Bulk-Reassign-UX (mehrere Einsätze auf anderen Monteur): Auswahl-Modus im Raster — Feinschliff beim Subframe-Bau
- Zeitraster-Granularität (Stunden vs. Halbtage) → Dev/Subframe-Bau
## 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)*