Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P09-projekt-pipelines-auftrag.md

8.7 KiB
Raw Permalink Blame History

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.) Quellen: ROADMAP.md §Phase 9 (+ Pivot-Note) · ENTITY-MODEL.md Domäne 5 (Sub-Areas am Projekt: Rechnung/Termin/Checkliste/AbnahmeProtokoll/AbnahmeSignatur/ProjektMitglied/ProjektExternesFeld) + Kern-Ketten-Diagramm · SCREEN-MAP.md §4 (Plantafel + Abnahme-Workflow + Projekt-Detail-Sub-Areas) · REQUIREMENTS.md (REQ-projekt-*) · _bmad-output/specs/M04-auftragspipeline.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, nicht die teils noch pre-Pivot-SCREEN-MAP. Konkret: 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 (deshalb auch keine read-only „Sales-Verlauf-Sektion" als Snapshot eines anderen Objekts — die Historie steckt im selben Projekt-Activity-Stream). Rechnung ist ein NEUES 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). Wo M04-Spec von „AcceptanceProtocol / ProjectPipeline / source_deal_id-Snapshot" spricht, ist die Sub-Area am gemeinsamen Projekt-Kern gemeint.

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/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (R-P9a/b) aktualisiert: