Files

54 lines
8.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Designer-Brief · P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas)
**Phase:** 9/21 · **Modul:** M04 · **Owner-Dev:** Raffael (R-P9a/b) · **Designer:** David (D-CRM, Plantafel-Paket Mi 01.07.)
**Aktive Quellen:** zugehörige Ticket-Docs · `ROADMAP.md`/`ROADMAP-V2.md` · `REQUIREMENTS.md` · `ENTITY-MODEL.md`.
**Subframe:** Pflicht je Route. Plantafel + Abnahme-Workflow sind **BESPOKE** (📱 mobile-first + offline); Sub-Area-Tabs aus A3.
> 🔴 **Pivot-Vorrang (AD-20):** Für die Auftrags-Welt gilt das **`ENTITY-MODEL.md`**. **Kein separates Project-Objekt** — die Auftrags-Welt ist eine **Pipeline-View auf denselben `Projekt`-Kern** (P8). Es gibt **keinen Won-Handoff** und keinen zweiten Datensatz; ein Projekt wechselt nur die Pipeline / erhält Auftrags-Felder. **Rechnung ist ein Sub-Entity (v1)** am Projekt. **Abnahme = Checklisten/Protokoll-Sub-Area** am Projekt: `AbnahmeProtokoll` ist **immutable** (6 Jahre, signatur-gebunden), bindet eine **Mängel-Checkliste** (`Checkliste typ=maengel`) ein, hat **Touch-Signaturen** (Kunde + Monteur) und ist **offline-fähig**. **Material-Ausgang/Lagerist-Sicht, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets → v2** (Material-Listen am Auftrag bleiben v1).
## Was dieses Modul tut (Kurzfassung)
Liefert die auftragsspezifischen Features auf dem `Projekt`-Kern aus P8: die **Plantafel** (Scheduling pro Monteur/Tag, Drag&Drop, Konflikt-Detection aus HR/Kalender, offline-fähiger Monteur-Mobil-Modus), die **Sub-Areas am Projekt** (Termine, **Rechnungen [v1 NEU]**, Checklisten, Aufgaben, Aktivitäten, Dokumente, ProjektMitglieder, ProjektExterneFelder/KWP-Halter) und die **Abnahme** als immutable Checklisten/Protokoll-Sub-Area mit Touch-Signatur, PDF + Auto-Email, offline-Sync. Mängel sind Checklisten (`typ=maengel`).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 📱 **Plantafel** [`/projects/plantafel`] | Desktop: Y = Mitarbeiter, X = Zeit (Tag/Woche/Monat-Switcher) · Einträge je Person×Slot: Projekt-Titel, Status-Farbe (pipeline-basiert), Adresse-Kurzform · **Drag&Drop verschieben/resizen** · neue ScheduleEntry per Klick auf leeren Slot · **Konflikt-Indikatoren** (Doppelbelegung; Urlaub/krank aus HR M14; außerhalb Verfügbarkeit/Arbeitszeit) mit Klartext-„Trotzdem?" · MA-Filter (Rolle/Group/Verfügbarkeit) + Projekt-Filter · Status-Wechsel (planned→confirmed→in_progress→done/cancelled) · Bulk-Reassign · Calendar-Sync-Indikator · **Monteur-Mobil-Modus: „Meine Termine heute"** (Liste mit Adresse + Navigations-Link, Tap-Statuswechsel) + „Meine Woche", **offline-fähig** | **BESPOKE** (höchste Priorität nach Flow-Editor) |
| 📱 **Projekt-Detail — Auftrags-Sub-Areas** [`/projects/:id`] | Erweitert P8-Detail um Sub-Area-Tabs/Sektionen: **ProjektMitglieder** (Monteure/PL/zuständig/Beobachter mit Rolle, Multi-Add aus Group), **Termine**, **Rechnungen [v1 NEU]**, **Checklisten** (inkl. Mängel), **Aufgaben**, **Dateien/Dokumente**, **Abnahmen**, **ProjektExterneFelder** (KWP/API — v1 nur Anzeige) · Baustellen-/Rechnungs-/Bauherr-Adress-Slots · Offene-Mängel-Banner · **Mobil-Modus: Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload** | A3 + 📱-Variante |
| 📱 **Abnahme-Workflow** [`/projects/:id/acceptance/new`] | SHK-Abnahme-Protokoll (Datum, Anwesende, Druckprobe ja/nein+Wert, Funktionsprüfung, Zählerstände, Inbetriebnahme/Garantie-Datum, übergebene Dokumente-Checkliste, **Mängel-Repeater mit Foto je Mangel**, Bemerkungen Kunde/Monteur) → **Mängel-Klassifizierung** (kritisch=verweigert / klein=mit Vorbehalt / kosmetisch=erfolgt) bestimmt acceptance_kind → **Touch-Signatur Kunde** (Name eingeben, kann von Kontakt abweichen; IP+Timestamp auto) → **Touch-Signatur Monteur** → Bestätigen → PDF + Auto-Email an Kunden · **offline-fähig, Sync bei Verbindung** · nach Speichern **immutable** (nur archivierbar) | **BESPOKE-Mobile** |
| Abnahme-Liste [`/projects/:id/acceptance`] | Protokoll-Liste je Projekt (Mehrfach-/Teilabnahmen): Datum, acceptance_kind, Unterzeichner, PDF-Link, Mängel-Status · letzte `full`-Abnahme bestimmt Stage-Wechsel-Vorschlag | A2 |
| Rechnung-Sub-Entity [im Projekt-Detail, Sub-Area] | Rechnung anlegen/anzeigen: Rechnungsnummer (HiveNumberSeq), Betrag, Status (entwurf/gestellt/bezahlt/storniert), Datum, fällig_am, verknüpfte Datei, Quelle (manuell/kwp) · einfaches Sub-Entity am Projekt (v1 NEU, E3) | A2/A5 (in Sub-Area) |
| Pipeline-Config-Auftragsteil [`/admin/pipelines/:id`] | Auftrags-spezifische Stage-Optionen: `requires_acceptance_protocol` je Stage (Block beim Wechsel ohne Abnahme), Acceptance-Form-Template-Zuweisung, auto_archive_after_days · (Basis-Pipeline-Editor = P8) | A6 |
| Acceptance-Form-Templates [`/admin/projects/acceptance-forms`] | Form-Builder-basiert (M05, Subtyp acceptance_form), SHK-Default geseedet · Verwaltung/Zuweisung | A6 |
| Project-Templates [`/admin/projects/templates`] | Vorlagen mit Default-Pipeline/Stage/Mitgliedern/Tasks/ScheduleEntries/Custom-Feldern | A2 |
*(Projekt-Kanban + Listen-View + Projekt-Detail-Basis + Pipeline-Engine = P8. „Sales-Verlauf-Sektion" als Deal-Snapshot entfällt — gemeinsamer Projekt-Activity-Stream. Material-Ausgang/Lagerist/Zeiterfassung/Leistungspositionen → v2.)*
## Geplante Features (muss abgedeckt sein)
- [ ] **Plantafel** (Scheduling pro Monteur/Tag, Drag&Drop verschieben/resizen, Status-Workflow, Bulk-Reassign) — offline-fähiger Monteur-Mobil-Modus („Meine Termine heute"/„Meine Woche")
- [ ] **Konflikt-Detection** (Doppelbelegung, Urlaub/krank aus HR M14, Verfügbarkeits-Regeln) mit Klartext-„Trotzdem zuweisen?" · Calendar-Sync (M25) der ScheduleEntries
- [ ] **Sub-Areas am Projekt:** Termine, **Rechnungen [v1 NEU]**, Checklisten (inkl. Mängel typ=maengel), Aufgaben, Aktivitäten, Dokumente, ProjektMitglieder, ProjektExterneFelder (KWP-Halter v1)
- [ ] **Abnahme als Checklisten/Protokoll-Sub-Area:** immutable (6 J), Mängel-Checkliste eingebunden, Touch-Signatur Kunde + Monteur, Mängel-Klassifizierung, PDF + Auto-Email, **offline-Sync**, Mehrfach-/Teilabnahmen
- [ ] Stage-Wechsel-Validation: `requires_acceptance_protocol` blockt ohne Abnahme; cancelled erfordert Grund; 24h-Reverse aus Terminal-Stages
- [ ] Mängel mit `with_defects` werden als Tasks angelegt; `rejected` → zurück in Ausführung + Notification an PL
- [ ] Permissions: `projects.*` (read_own_member/read_own_pl/read_all/write/change_stage/manage_members/delete/admin), `plantafel.*` (read_own/read_all/write/bulk_reassign), `acceptance.*` (read/write/admin); Volumen-Field-Level + PipelineFieldConfig; Hard-Delete blockt bei Abnahme-Protokollen (Aufbewahrung)
## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Plantafel-Raster (Y=MA, X=Zeit, Zeitraum-Switcher Tag/Woche/Monat), Drag&Drop-/Resize-ScheduleEntry-Blöcke, leerer-Slot-Klick-Anlage, Konflikt-Indikatoren + „Trotzdem?"-Dialog, MA-/Projekt-Filter, Status-Wechsler je Eintrag, Bulk-Reassign-Funktion, Calendar-Sync-Indikator, Monteur-Mobil-Tagesliste mit Adresse/Navigations-Link + Tap-Statuswechsel + Offline-Hinweis, Sub-Area-Tabs/Sektionen am Projekt-Detail, ProjektMitglieder-Liste mit Rollen-Badge + Multi-Add, Rechnungs-Sub-Liste (Nummer/Betrag/Status/Fälligkeit/Quelle/Datei) + Anlage-Form, Checklisten-/ChecklistItem-Liste mit Status + Mängel-Klasse + Foto, Abnahme-Formular-Renderer (Repeater für Mängel mit Foto-Upload aus Kamera), Mängel-Klassifizierungs-Auswahl (kritisch/klein/kosmetisch), Touch-Unterschriften-Feld (Kunde + Monteur), PDF-Vorschau/-Download, immutable/gesperrt-Banner, Offene-Mängel-roter-Banner, KWP-Externe-Felder-Anzeige (read-only), Acceptance-Form-Template-Picker, Project-Template-Auswahl, One-Tap-Foto-Upload, Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext + Lösungs-Knopf).
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
## Dev-Nachzug (wir nach Davids Delta)
- [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- [ ] REQUIREMENTS/ROADMAP nachgezogen:
- [ ] Plane-Ticket (R-P9a/b) aktualisiert: