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,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P9
package: WF-P9 Projekt-Akte
id: M01
screen: Rechnung anlegen
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus dem Rechnungen-Reiter (S01)"
subframe: ""
---
# M01 — Rechnung anlegen
## Ziel
Rechnung am Projekt festhalten — einfaches Sub-Entity, kein Rechnungs-Generator.
## Was das Tool können muss
- Nummer automatisch (fortlaufend) · Betrag · Status (Entwurf/gestellt/bezahlt/storniert) · Datum + fällig am · PDF anhängen (Dropzone-Baustein)
- Status später direkt in der Liste umschaltbar (z. B. »als bezahlt markieren«)
## Pattern / Archetyp
A5 Dialog (echtes Modal).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Betrag fehlt | Inline-Validierung | Nur dokumentieren |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,45 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P9
package: WF-P9 Projekt-Akte
id: S01
screen: Auftrags-Reiter
typ: Detail-Erweiterung
umsetzung: Bauen
status: Validiert
route: "/projects/:id (Auftrags-Board)"
subframe: ""
---
# S01 — Auftrags-Reiter am Projekt
## Ziel
Die Projekt-Akte für die Bau-Phase: alles zum Auftrag an einem Ort. Erweitert die P8-Detailseite (gleiche Seite, gleiche Daten).
## Was das Tool können muss
- **Team-Reiter:** Mitglieder mit Rollen (Monteur/Projektleiter/zuständig/Beobachter), ganze Gruppe auf einmal zuweisen
- **Termine-Reiter:** Projekt-Termine (speisen die Plantafel)
- **Rechnungen-Reiter (v1 neu):** Liste (Nummer automatisch, Betrag, Status entwurf/gestellt/bezahlt/storniert, fällig am, PDF) + [[M01 Rechnung anlegen]]
- **Checklisten-Reiter:** Checklisten inkl. Mängel (mit Einstufung + Foto, kommen aus der Abnahme)
- **Abnahmen-Reiter:** Einstieg in die Abnahme-Liste/den Workflow (WF-P9 Abnahme)
- Adress-Slots: Baustelle / Rechnung / Bauherr
- Roter **Offene-Mängel-Banner**; Spaltenwechsel ohne Pflicht-Abnahme blockiert (Klartext + Abnahme-Knopf)
## Pattern / Archetyp
A3 — Reiter-Erweiterung der [[../../../P8 Pipelines/WF-P8 Pipelines/Screens/S02 Pipelines Detailansicht|P8-Pipelines-Detailansicht]].
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Offene Mängel | roter Banner | Nur dokumentieren |
| Stage-Block ohne Abnahme | Klartext + Knopf | Nur dokumentieren |
| Laden / Fehler / 404 | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,42 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P9
package: WF-P9 Projekt-Akte
id: S02
screen: Mobil-Modus
typ: Variante 📱
umsetzung: Bauen
status: Validiert
route: "/projects/:id (Handy)"
subframe: ""
---
# S02 — Mobil-Modus 📱
## Ziel
Der Monteur auf der Baustelle: nur das Nötigste, mit einem Daumen bedienbar.
## Was das Tool können muss
- Stammdaten kompakt (Titel, Adresse mit **Navi-Link**, Ansprechpartner mit Anruf-Knopf)
- **Meine heutigen Aufgaben** an diesem Projekt (abhakbar)
- **Abnahme-Knopf** (startet WF-P9 Abnahme)
- **One-Tap-Foto-Upload** (Kamera → hängt direkt am Projekt)
- Offline-tauglich: Hinweis + Sync-Status
## Pattern / Archetyp
📱 Mobile-Variante der Projekt-Detailseite (reduziert, große Touch-Ziele).
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Offline | Hinweis + »wird synchronisiert, sobald Verbindung da ist« | Nur dokumentieren |
| Foto-Upload wartet | Warteschlangen-Hinweis | Nur dokumentieren |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,39 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P9
package: WF-P9 Projekt-Akte
id: S03
screen: Abnahme-Formular-Vorlagen
typ: Settings
umsetzung: Bauen
status: Validiert
route: "/admin/projects/acceptance-forms (Einstellungen -> Arbeitsweise)"
subframe: ""
---
# S03 — Abnahme-Formular-Vorlagen
## Ziel
Welche Felder das Abnahme-Protokoll hat, je Vorlage — SHK-Standard ist vorbefüllt.
## Was das Tool können muss
- Vorlagen-Liste (Name, in Nutzung bei X Boards, Status)
- Zuweisung: welche Vorlage gilt für welches Board/welche Spalte (Verbindung zur Abnahme-Pflicht-Option)
- Bearbeiten öffnet den **Formular-Baukasten** (kommt mit D-FORM/P16) — bis dahin: Verwaltung + Zuweisung
## Pattern / Archetyp
A6 unter Einstellungen → Arbeitsweise.
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,38 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P9
package: WF-P9 Projekt-Akte
id: S04
screen: Projekt-Vorlagen
typ: Settings-Liste
umsetzung: Bauen
status: Validiert
route: "/admin/projects/templates (Einstellungen -> Arbeitsweise)"
subframe: ""
---
# S04 — Projekt-Vorlagen
## Ziel
Wiederkehrende Auftrags-Typen (z. B. »Heizungstausch«) einmal definieren, immer wieder nutzen.
## Was das Tool können muss
- Vorlagen-Liste + Editor: Standard-Board + Start-Spalte · Standard-Team (Rollen) · Standard-Aufgaben · Standard-Termine/Einsätze · vorbelegte eigene Felder
- Beim Projekt-Anlegen wählbar
## Pattern / Archetyp
A2 unter Einstellungen → Arbeitsweise.
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,20 @@
{
"nodes":[
{"id":"md-paket","type":"file","file":"02 Wireframes/P9 Projekt-Akte/WF-P9 Projekt-Akte/WF-P9 Projekt-Akte.md","x":-80,"y":-440,"width":460,"height":280},
{"id":"group-akte","type":"group","x":-80,"y":-100,"width":1820,"height":380,"label":"Projekt-Akte (erweitert P8-Detailseite)"},
{"id":"group-settings","type":"group","x":-80,"y":460,"width":1820,"height":380,"label":"Rechnung + Vorlagen (Einstellungen → Arbeitsweise)"},
{"id":"note-entry","type":"text","text":"# Einstieg\n\nAuftrags-Board → Projekt öffnen. Gleiche Detailseite wie im Vertrieb (P8) — die Auftrags-Reiter kommen dazu.","x":0,"y":0,"width":360,"height":200},
{"id":"s01","type":"file","file":"02 Wireframes/P9 Projekt-Akte/WF-P9 Projekt-Akte/Screens/S01 Auftrags-Reiter.md","x":560,"y":0,"width":420,"height":200},
{"id":"s02","type":"file","file":"02 Wireframes/P9 Projekt-Akte/WF-P9 Projekt-Akte/Screens/S02 Mobil-Modus.md","x":1240,"y":0,"width":420,"height":200},
{"id":"m01","type":"file","file":"02 Wireframes/P9 Projekt-Akte/WF-P9 Projekt-Akte/Screens/M01 Rechnung anlegen.md","x":0,"y":560,"width":420,"height":200},
{"id":"s03","type":"file","file":"02 Wireframes/P9 Projekt-Akte/WF-P9 Projekt-Akte/Screens/S03 Abnahme-Formular-Vorlagen.md","x":580,"y":560,"width":420,"height":200},
{"id":"s04","type":"file","file":"02 Wireframes/P9 Projekt-Akte/WF-P9 Projekt-Akte/Screens/S04 Projekt-Vorlagen.md","x":1160,"y":560,"width":420,"height":200},
{"id":"note-rules","type":"text","text":"# Regeln (nur Doku)\n\n- Board-Auftragsoptionen (Abnahme-Pflicht je Spalte, Auto-Archiv) erweitern die Board-Einstellungen aus WF-P8 (S04)\n- Offene Mängel → roter Banner; Spaltenwechsel ohne Pflicht-Abnahme blockiert\n- Abnahmen-Reiter → Paket WF-P9 Abnahme · Termine speisen die Plantafel","x":1900,"y":0,"width":460,"height":760}
],
"edges":[
{"id":"e-entry","fromNode":"note-entry","fromSide":"right","toNode":"s01","toSide":"left","toEnd":"arrow","styleAttributes":{"path":"dotted"}},
{"id":"e-mobil","fromNode":"s01","fromSide":"right","toNode":"s02","toSide":"left","toEnd":"arrow","label":"Handy-Variante","styleAttributes":{"path":"short-dashed"}},
{"id":"e-rechnung","fromNode":"s01","fromSide":"bottom","toNode":"m01","toSide":"top","toEnd":"arrow","label":"+ Rechnung"},
{"id":"e-vorlage","fromNode":"s03","fromSide":"top","toNode":"s01","toSide":"bottom","toEnd":"arrow","label":"Vorlage gilt je Board/Spalte","styleAttributes":{"path":"long-dashed"}}
]
}
@@ -0,0 +1,114 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P9
package: WF-P9 Projekt-Akte
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P9 Projekt-Akte.canvas"
---
# WF-P9 Projekt-Akte
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P9 Projekt-Akte.canvas>)
Stand: 2026-07-09
---
## 1. Kurzfassung
Die Projekt-Detailseite wächst für die Auftrags-Phase: Reiter Team / Termine / **Rechnungen (v1 neu)** / Checklisten & Mängel / Abnahmen, Adress-Slots, Mängel-Banner — plus Handy-Modus für Monteure und die Vorlagen-Verwaltung. **Gleicher Projekt-Datensatz wie im Vertrieb (Pivot, kein zweites Objekt).**
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Ticket/Modul | D-P9, Dev-Pendant R-P9a/R-P9b |
| Nutzer-Ziel | Alles zum Auftrag an einem Ort: Team, Termine, Geld, Mängel, Abnahmen |
| Quellen geprüft | `ticket-docs/D-P9.md`, ENTITY-MODEL Domäne 5 (Pivot), HiveGrid Map |
| Sicher im Scope | Auftrags-Reiter, Rechnung-Sub-Entity, Mobil-Modus, Vorlagen, Board-Auftragsoptionen |
| Sicher nicht im Scope | Plantafel (WF-P9 Plantafel), Abnahme-Workflow (WF-P9 Abnahme), Material/Zeiterfassung/Leistungspositionen/KWP (v2) |
| Unsichere Annahmen | — |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Startpunkt | Projekt-Detailseite (P8-Basis), Auftrags-Board |
| Ziel | Auftrag komplett dokumentiert bis zur Abnahme + Rechnung |
| Haupt-Archetyp | A3 Sub-Areas + 📱-Variante · A2/A5 Rechnung · A6 Vorlagen |
| Out of scope | KWP-Felder (v1 nicht vorhanden), Material/Lagerist, Zeiterfassung (v2) |
---
## 4. Entscheidungen (validiert 2026-07-09)
| Entscheidung | Status | Notiz |
|---|---|---|
| Drei P9-Pakete (Akte / Plantafel / Abnahme) | genommen | deckt sich mit der Feature-Map |
| Auftrags-Reiter erweitern die P8-Detailseite | genommen | gleicher Datensatz, gleiche Seite — Reiter kommen dazu: Team · Termine · Rechnungen · Checklisten & Mängel · Abnahmen |
| Rechnung = einfaches Sub-Entity am Projekt | genommen | Nummer (automatisch), Betrag, Status entwurf/gestellt/bezahlt/storniert, Datum, fällig am, PDF-Datei |
| Mobil-Modus als eigener Frame | genommen | Stammdaten + heutige Aufgaben + Abnahme-Knopf + One-Tap-Foto |
| Board-Auftragsoptionen erweitern die P8-Board-Einstellungen | genommen | je Spalte: »Abnahme Pflicht« (Wechsel blockiert ohne Abnahme), Abnahme-Vorlagen-Zuweisung, Auto-Archiv nach N Tagen — dokumentiert als Erweiterung von WF-P8 S04, kein neuer Screen |
| Team-Reiter mit Rollen | genommen | Monteur / Projektleiter / zuständig / Beobachter; ganze Gruppe auf einmal zuweisbar |
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Offene Mängel | roter Banner am Projekt | nein | Nur dokumentieren | mit Sprung zur Mängel-Checkliste |
| Spaltenwechsel ohne Pflicht-Abnahme | blockiert + Klartext | ja | Nur dokumentieren | »Erst Abnahme durchführen« + Abnahme-Knopf |
| Offline (Mobil-Modus) | Hinweis + Sync-Status | nein | Nur dokumentieren | A7-offline |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Auftrags-Reiter am Projekt (Team/Termine/Rechnungen/Checklisten/Abnahmen + Adress-Slots) | Detail-Erweiterung | Bauen | `/projects/:id` | Validiert |
| S02 | Mobil-Modus 📱 | Variante | Bauen | gleiche Route, Handy | Validiert |
| M01 | Rechnung anlegen | Modal | Bauen | aus Rechnungen-Reiter | Validiert |
| S03 | Abnahme-Formular-Vorlagen | Settings | Bauen | `/admin/projects/acceptance-forms` | Validiert |
| S04 | Projekt-Vorlagen | Settings-Liste | Bauen | `/admin/projects/templates` | Validiert |
| D01 | Board-Auftragsoptionen (Abnahme-Pflicht/Auto-Archiv) | Doku | Nur dokumentieren | in WF-P8 S04 | Validiert |
| D02–D04 | Banner/Blockade/Offline (s. Tabelle) | Inline | Nur dokumentieren | — | Validiert |
---
## 8. Grid
```text
Auftrags-Board -> Projekt-Detail (P8-S02) + Auftrags-Reiter (S01)
Rechnungen-Reiter -> M01 (Rechnung anlegen)
Abnahmen-Reiter -> WF-P9 Abnahme (S01 Liste / Workflow)
Handy -> S02 (Mobil-Modus) -> Abnahme-Workflow
Einstellungen -> S03 (Abnahme-Vorlagen, nutzt Formular-Baukasten P16) / S04 (Projekt-Vorlagen)
```
---
## 9. Screen-Pakete
- [[S01 Auftrags-Reiter]] · [[S02 Mobil-Modus]] · [[M01 Rechnung anlegen]]
- [[S03 Abnahme-Formular-Vorlagen]] · [[S04 Projekt-Vorlagen]]
---
## 10. Offene Fragen
- Abnahme-Formular-Vorlagen basieren auf dem Formular-Baukasten (P16/D-FORM) — solange der nicht geplant ist, hier nur Verwaltung/Zuweisung; Editor kommt mit D-FORM
- Rechnungs-PDF: nur Datei-Anhang (v1) — kein Rechnungs-Generator (nicht beauftragt)
## 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)*