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,40 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-ABN
package: WF-P9 Abnahme
id: S01
screen: Abnahme-Liste
typ: Liste
umsetzung: Bauen
status: Validiert
route: "/projects/:id/acceptance"
subframe: ""
---
# S01 — Abnahme-Liste
## Ziel
Alle (Teil-)Abnahmen eines Projekts im Blick — mit PDF-Zugriff.
## Was das Tool können muss
- Je Protokoll: Datum · Ergebnis (erfolgt / mit Vorbehalt / verweigert) · Unterzeichner · **PDF-Link** · Mängel-Status
- Teil-/Mehrfach-Abnahmen; die letzte **Voll**-Abnahme löst den Spalten-Wechsel-Vorschlag aus
- »Neue Abnahme« → [[S02 Schritt Pruefungen]]
## Pattern / Archetyp
A2 Liste (im Abnahmen-Reiter der Projekt-Akte).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Noch keine Abnahme« + Start-Knopf | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-ABN
package: WF-P9 Abnahme
id: S02
screen: Schritt Pruefungen
typ: BESPOKE-Mobile (Workflow 1/3)
umsetzung: Bauen
status: Validiert
route: "/projects/:id/acceptance/new"
subframe: ""
---
# S02 — Schritt 1: Prüfungen 📱
## Ziel
Die technische Abnahme erfassen — Feld für Feld, mit Handschuhen bedienbar.
## Was das Tool können muss
- Kopf: Projekt, Datum, Anwesende
- **Druckprobe** (ja/nein + Wert) · **Funktionsprüfung** · **Zählerstände** · Inbetriebnahme-/Garantie-Datum
- **Übergebene Dokumente** als Abhak-Liste
- Felder kommen aus der zugewiesenen Vorlage (SHK-Standard als Referenz)
- Offline: alles lokal gespeichert, Fortschritt bleibt erhalten
- Fortschritts-Anzeige (1/3) · Weiter → [[S03 Schritt Maengel]]
## Pattern / Archetyp
BESPOKE-Mobile Formular-Schritt (große Touch-Ziele).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Pflichtfeld fehlt | Schritt-Validierung beim Weiter | Nur dokumentieren |
| Offline | Banner + lokal gespeichert | Nur dokumentieren |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-ABN
package: WF-P9 Abnahme
id: S03
screen: Schritt Maengel
typ: BESPOKE-Mobile (Workflow 2/3)
umsetzung: Bauen
status: Validiert
route: "Workflow-Schritt 2"
subframe: ""
---
# S03 — Schritt 2: Mängel 📱
## Ziel
Jeden Mangel festhalten — mit Foto, in Sekunden.
## Was das Tool können muss
- **Mängel-Repeater**: je Mangel Beschreibung + **Foto direkt aus der Kamera** + Einstufung
- **Einstufung bestimmt das Ergebnis**: kritisch = Abnahme verweigert · klein = mit Vorbehalt · kosmetisch = erfolgt
- Live-Hinweis, welches Ergebnis die aktuelle Einstufung ergibt (»Mit diesem Mangel wird die Abnahme verweigert«)
- »Keine Mängel« als schneller Pfad
- Bemerkungen Kunde / Monteur (Freitext)
- Fortschritt (2/3) · Weiter → [[S04 Schritt Unterschriften]]
## Pattern / Archetyp
BESPOKE-Mobile Repeater-Schritt.
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Kritischer Mangel erfasst | Hinweis »wird verweigert« | Nur dokumentieren |
| Foto wartet auf Upload | Warteschlangen-Marker (offline) | Nur dokumentieren |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,43 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-ABN
package: WF-P9 Abnahme
id: S04
screen: Schritt Unterschriften
typ: BESPOKE-Mobile (Workflow 3/3)
umsetzung: Bauen
status: Validiert
route: "Workflow-Schritt 3"
subframe: ""
---
# S04 — Schritt 3: Zusammenfassung + Unterschriften 📱
## Ziel
Bewusst abschließen: alles nochmal sehen, dann rechtsgültig unterschreiben.
## Was das Tool können muss
- **Zusammenfassung**: Prüfungen, Mängel mit Einstufung, das daraus folgende **Ergebnis groß sichtbar** (erfolgt / mit Vorbehalt / verweigert)
- **Touch-Unterschrift Kunde** (Name eingebbar, darf vom Kontakt abweichen) + **Touch-Unterschrift Monteur** — IP + Zeitstempel automatisch
- »Abschließen« → PDF wird erzeugt + automatisch an den Kunden gemailt · bei »mit Vorbehalt« werden Mängel zu Aufgaben · bei »verweigert« geht das Projekt zurück in Ausführung + Meldung an den Projektleiter
- Danach **unveränderbar** (Gesperrt-Banner beim späteren Öffnen)
- Offline: Abschluss lokal, PDF/Mail gehen nach Sync raus (Klartext-Hinweis)
## Pattern / Archetyp
BESPOKE-Mobile Abschluss-Schritt mit Unterschriften-Feld (Baukasten-Primitive).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Unterschrift fehlt | »Abschließen« gesperrt bis beide da | Nur dokumentieren |
| Offline-Abschluss | »Gespeichert — PDF + Mail gehen raus, sobald Verbindung da ist« | Nur dokumentieren |
| Später geöffnet | Gesperrt-Banner »Rechtsgültig abgeschlossen« | Nur dokumentieren |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,17 @@
{
"nodes":[
{"id":"md-paket","type":"file","file":"02 Wireframes/P9 Abnahme/WF-P9 Abnahme/WF-P9 Abnahme.md","x":-80,"y":-440,"width":460,"height":280},
{"id":"group-flow","type":"group","x":-80,"y":-100,"width":2500,"height":380,"label":"Abnahme-Workflow 📱 (mehrstufig, offline)"},
{"id":"group-notes","type":"group","x":-80,"y":460,"width":2500,"height":340,"label":"Regeln"},
{"id":"s01","type":"file","file":"02 Wireframes/P9 Abnahme/WF-P9 Abnahme/Screens/S01 Abnahme-Liste.md","x":0,"y":0,"width":420,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P9 Abnahme/WF-P9 Abnahme/Screens/S02 Schritt Pruefungen.md","x":640,"y":0,"width":420,"height":200},
{"id":"s03","type":"file","file":"02 Wireframes/P9 Abnahme/WF-P9 Abnahme/Screens/S03 Schritt Maengel.md","x":1240,"y":0,"width":420,"height":200},
{"id":"s04","type":"file","file":"02 Wireframes/P9 Abnahme/WF-P9 Abnahme/Screens/S04 Schritt Unterschriften.md","x":1880,"y":0,"width":420,"height":200},
{"id":"note-rules","type":"text","text":"# Regeln (nur Doku)\n\n- Einstufung bestimmt Ergebnis: kritisch = verweigert (zurück in Ausführung + PL-Meldung) · klein = mit Vorbehalt (Mängel → Aufgaben) · kosmetisch = erfolgt\n- Nach Abschluss: PDF + Auto-Mail an Kunden, danach UNVERÄNDERBAR (6 Jahre, Gesperrt-Banner)\n- Offline komplett ausfüllbar inkl. Fotos + Unterschriften; Sync bei Verbindung\n- Teil-Abnahmen möglich; letzte Voll-Abnahme → Spalten-Wechsel-Vorschlag","x":0,"y":540,"width":1100,"height":240}
],
"edges":[
{"id":"e-neu","fromNode":"s01","fromSide":"right","toNode":"s02","toSide":"left","toEnd":"arrow","label":"Neue Abnahme"},
{"id":"e-w1","fromNode":"s02","fromSide":"right","toNode":"s03","toSide":"left","toEnd":"arrow","label":"Weiter"},
{"id":"e-w2","fromNode":"s03","fromSide":"right","toNode":"s04","toSide":"left","toEnd":"arrow","label":"Weiter"}
]
}
@@ -0,0 +1,111 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-ABN
package: WF-P9 Abnahme
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P9 Abnahme.canvas"
---
# WF-P9 Abnahme
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P9 Abnahme.canvas>)
Stand: 2026-07-09
---
## 1. Kurzfassung
Das Baustellen-Protokoll: mehrstufiger Mobile-Ablauf (Prüfungen → Mängel → Unterschriften), Touch-Signatur Kunde + Monteur, PDF + Auto-Mail, danach unveränderbar (6 Jahre) — offline-fähig mit Sync. Plus Abnahme-Liste je Projekt.
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Ticket/Modul | D-ABN, Dev-Pendant R-P9a/R-P9b |
| Nutzer-Ziel | Monteur schließt die Baustelle rechtssicher ab — auch ohne Netz |
| Quellen geprüft | `ticket-docs/D-ABN.md`, ENTITY-MODEL Domäne 5 (immutable, Mängel = Checkliste), HiveGrid Map |
| Sicher im Scope | Mehrstufiger Workflow, Mängel-Repeater mit Foto, Signaturen, PDF, Liste, Teil-Abnahmen |
| Sicher nicht im Scope | Plantafel (eigenes Paket); Vorlagen-Editor (Formular-Baukasten, D-FORM) |
| Unsichere Annahmen | — |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Startpunkt | Abnahme-Knopf (Projekt-Mobil-Modus / Abnahmen-Reiter) |
| Ziel | Unterschriebenes Protokoll als PDF beim Kunden, Mängel als Aufgaben |
| Haupt-Archetyp | **BESPOKE-Mobile** (Workflow) + A2 (Liste) |
| Out of scope | Nachträgliches Bearbeiten (immutable!) |
---
## 4. Entscheidungen (validiert 2026-07-09)
| Entscheidung | Status | Notiz |
|---|---|---|
| **Mehrstufiger Ablauf** statt langem Scroll-Screen | genommen | Schritte: 1 Prüfungen → 2 Mängel → 3 Zusammenfassung + Unterschriften. Fortschritt sichtbar, Unterschrift bewusst am Ende |
| Ergebnis folgt aus der Mängel-Einstufung | genommen | kritisch = **verweigert** (zurück in Ausführung + Meldung an PL) · klein = **mit Vorbehalt** (Mängel werden Aufgaben) · kosmetisch/keine = **erfolgt** |
| Touch-Signaturen Kunde + Monteur | genommen | Name eingebbar (darf vom Kontakt abweichen); IP + Zeitstempel automatisch |
| Nach Speichern unveränderbar | genommen | 6 Jahre, nur archivierbar; Gesperrt-Banner |
| Offline-fähig | genommen | komplett ausfüllbar inkl. Fotos + Unterschriften; Sync bei Verbindung |
| Teil-Abnahmen möglich | genommen | mehrere Protokolle je Projekt; letzte Voll-Abnahme → Spalten-Wechsel-Vorschlag |
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Gespeichertes Protokoll geöffnet | Gesperrt-Banner | ja (Edit) | Nur dokumentieren | »Rechtsgültig abgeschlossen — nicht änderbar« |
| Offline beim Abschließen | Hinweis: gespeichert, wird gesendet | nein | Nur dokumentieren | PDF/Mail gehen nach Sync raus |
| Pflichtfeld fehlt beim Weiter | Schritt-Validierung | ja (Schritt) | Nur dokumentieren | Klartext je Feld |
| Kritischer Mangel erfasst | Hinweis »Abnahme wird verweigert« | nein | Nur dokumentieren | vor der Unterschrift sichtbar |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Abnahme-Liste (je Projekt) | Liste | Bauen | `/projects/:id/acceptance` | Validiert |
| S02 | Schritt 1 — Prüfungen 📱 | BESPOKE-Mobile | Bauen | `/projects/:id/acceptance/new` | Validiert |
| S03 | Schritt 2 — Mängel 📱 | BESPOKE-Mobile | Bauen | Workflow | Validiert |
| S04 | Schritt 3 — Zusammenfassung + Unterschriften 📱 | BESPOKE-Mobile | Bauen | Workflow | Validiert |
| D01–D04 | Gesperrt/Offline/Validierung (s. Tabelle) | Inline/Banner | Nur dokumentieren | — | Validiert |
---
## 8. Grid
```text
Projekt (Abnahmen-Reiter / Mobil-Modus) -> S01 (Liste) -> Neue Abnahme
S02 (Pruefungen) -> S03 (Maengel) -> S04 (Zusammenfassung + Unterschriften) -> PDF + Auto-Mail
S03: kritisch -> verweigert (PL-Meldung) · klein -> Maengel werden Aufgaben
Nach Abschluss: immutable; letzte Voll-Abnahme -> Spalten-Wechsel-Vorschlag
```
---
## 9. Screen-Pakete
- [[S01 Abnahme-Liste]] · [[S02 Schritt Pruefungen]] · [[S03 Schritt Maengel]] · [[S04 Schritt Unterschriften]]
---
## 10. Offene Fragen
- Formular-Felder kommen aus der zugewiesenen Vorlage (WF-P9 Projekt-Akte S03); SHK-Standard ist die Referenz fürs Design
- PDF-Layout: Dev/Standard — Design liefert nur die Bildschirm-Flächen
## 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)*