Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/pflichtenheft/blocks/block3.md
T

506 lines
50 KiB
Markdown
Raw 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.
# Block 3: Workflow-Kern (Vertrieb und Auftrag)
Hier passiert das Geerkens-Tagesgeschäft: Eine Anfrage wird zum Verkaufsfall, der Verkaufsfall wird gewonnen und automatisch zum Auftragsprojekt, das Auftragsprojekt wird über Plantafel und Abnahme zum abgeschlossenen Auftrag. Aufgaben begleiten alle Schritte.
---
## Modul 3: Sales-Pipeline (Verkaufsfälle)
**Was es tut:** Bildet den kompletten Vertriebsprozess ab, von der ersten Anfrage über Besichtigung, Angebot und Verhandlung bis zur Gewonnen- oder Verloren-Entscheidung. Verkaufsfälle (intern „Deals" genannt) durchlaufen frei konfigurierbare Stufen in einer oder mehreren Pipelines.
**Löst ab:** HubSpot Sales-Pipeline.
**Warum es wichtig ist:** Geerkens kennt das Pipeline-Denken aus HubSpot und steuert daran das Vertriebs-Tagesgeschäft. Ohne sauberes Pipeline-Modul gibt es keinen sinnvollen Wechsel von HubSpot zu HiveGrid.
### 3.1 Was zu einem Verkaufsfall gespeichert wird
3.1.1 Eindeutige Verkaufsfall-Nummer, fortlaufend pro Mandant (Beispiel: „D-2026-0042"). Wird beim Anlegen automatisch vergeben.
3.1.2 Titel (Pflichtfeld, kurze Beschreibung des Vorhabens).
3.1.3 Längere Beschreibung als Freitext mit einfachen Formatierungen.
3.1.4 Pipeline und aktuelle Stufe.
3.1.5 Volumen (geschätzter Auftragswert in Euro).
3.1.6 Erwarteter Abschluss-Termin (geschätztes Datum).
3.1.7 Tatsächlicher Abschluss-Termin (wird gesetzt, sobald „Gewonnen" oder „Verloren").
3.1.8 Verantwortlicher Vertriebler (Pflichtfeld). Jeder Verkaufsfall hat zwingend eine zuständige Person, das Feld darf nicht leer bleiben. Bei automatischer Anlage aus Lead, Formular, Email oder Anruf wird ein Default-Verantwortlicher zugewiesen (siehe 2.4 Lead-Routing). [N6, 09.05.2026]
3.1.9 Verknüpfter Hauptkontakt (Pflicht, jeder Verkaufsfall hat einen Ansprechpartner).
3.1.10 Verknüpfte Firma (optional, bei Privatkunden bleibt das Feld leer).
3.1.11 Ursprungs-Lead, falls der Verkaufsfall aus einer Anfrage entstanden ist.
3.1.12 Verlust-Grund, falls der Verkaufsfall verloren wurde, Pflichtfeld in dem Fall.
3.1.13 Tags / Schlagworte zum freien Klassifizieren.
3.1.14 Branchenspezifische Zusatzfelder (zum Beispiel „Anlagen-Typ", „Wärmebedarf in kW", „ist Bestandsanlage", durch den Mandanten konfigurierbar).
3.1.15 Verknüpfung zum Auftragsprojekt. Wann das Auftragsprojekt entsteht, ist mandanten-konfigurierbar (siehe 3.6.7): entweder erst beim Übergang in „Gewonnen" oder bereits bei Anlage des Verkaufsfalls. [N7, 09.05.2026]
### 3.2 Pipeline-Konfiguration durch den Mandanten
3.2.1 Der Mandant kann **mehrere Pipelines parallel** betreiben. Geerkens braucht zum Start mindestens zwei: „Anlagen-Verkauf" und „Wartungsverträge".
3.2.2 Jede Pipeline hat einen Namen, eine optionale Beschreibung und eine Markierung „Standard-Pipeline" (eine pro Mandant ist Default für neue Verkaufsfälle ohne explizite Auswahl).
3.2.3 Pipelines werden vom Mandanten-Administrator angelegt, dupliziert, umsortiert oder archiviert. Hard-Delete nur, wenn nie ein Verkaufsfall in der Pipeline war.
3.2.4 Pro Pipeline definiert der Mandant **Stufen** (zum Beispiel „Anfrage", „Besichtigung", „Bedarfsanalyse", „Angebot", „Verhandlung", „Gewonnen", „Verloren").
3.2.5 Pro Stufe konfigurierbar: Name, Reihenfolge, Stufen-Typ (offen / gewonnen / verloren), Erfolgs-Wahrscheinlichkeit in Prozent (für die Forecast-Rechnung), optionale Stuck-Schwelle in Tagen, Farbe für visuelle Markierung.
3.2.6 Jede Pipeline muss mindestens eine „Gewonnen"-Stufe und eine „Verloren"-Stufe haben. Beim Speichern ohne diese Stufen erscheint Klartext-Hinweis: *„Diese Pipeline hat keine ‚Gewonnen'-Stufe. Bitte mindestens eine Stufe vom Typ ‚gewonnen' anlegen."*
3.2.7 Stufen-Reihenfolge wird per Drag & Drop verändert.
3.2.8 Stufe löschen ist blockiert, wenn noch aktive Verkaufsfälle drin sind. Klartext: *„In dieser Stufe sind 8 aktive Verkaufsfälle. Bitte zuerst neu zuweisen oder Stufe archivieren statt löschen."*
3.2.9 Beim Anlegen eines neuen Mandanten werden die SHK-Standard-Pipelines mit den Standard-Stufen automatisch vorausgefüllt. Der Mandant kann sie behalten, anpassen oder löschen.
### 3.3 Verlust- und Gewinn-Gründe (durch den Mandanten gepflegt) [N8, 09.05.2026]
3.3.1 Liste der möglichen **Verlust-Gründe** wird durch den Mandanten-Administrator gepflegt (zum Beispiel „Preis/Leistung", „Konkurrenz übernommen", „Kein Bedarf mehr", „Kein Budget", „Nicht erreicht").
3.3.2 Liste der möglichen **Gewinn-Gründe** wird ebenfalls durch den Mandanten-Administrator gepflegt (zum Beispiel „Preis überzeugt", „Empfehlung", „bestehende Kunden-Beziehung", „technische Beratung", „Termin-Zuverlässigkeit"). Bei jeder Gewonnen-Markierung wird der Grund zur Auswahl angeboten.
3.3.3 Beim Anlegen eines Mandanten werden je 5 SHK-typische Standard-Gründe (Verlust und Gewinn) vorausgefüllt. Der Mandant kann sie behalten, ändern, ergänzen oder löschen.
3.3.4 Beide Listen können archiviert, aber nicht hart gelöscht werden, sonst leiden die Auswertungen.
3.3.5 Auswertung pro Grund: wie häufig wurde welcher Verlust- oder Gewinn-Grund vermerkt, gefiltert nach Pipeline, Vertriebler, Zeitraum (für die Vertriebs-Strategie-Diskussion).
### 3.4 Verkaufsfall-Liste und Spalten-Ansicht (Kanban)
3.4.1 Verkaufsfälle sind in zwei Ansichten verfügbar: als **Spalten-Ansicht (Kanban)**, in der jede Pipeline-Stufe eine Spalte ist, und als **Tabellen-Ansicht**.
3.4.2 In der Spalten-Ansicht sieht man pro Spalte: Stufen-Name, Anzahl Verkaufsfälle, Summe Volumen, Wahrscheinlichkeit. Pro Karte: Titel, Volumen (sofern berechtigt), Verantwortlicher, erwarteter Abschluss-Termin, Tags, visueller Hinweis bei Überfälligkeit, visueller Hinweis bei „seit zu lange in derselben Stufe" (Stuck-Status).
3.4.3 Verkaufsfälle können per Drag & Drop zwischen Stufen verschoben werden.
3.4.4 Es gibt eine Cross-Pipeline-Sicht, die Verkaufsfälle aus allen Pipelines in einer einzigen Tabelle zeigt.
3.4.5 Suche über Titel, Beschreibung, verknüpfte Kontakt- und Firmen-Namen.
3.4.6 Filter: Verantwortlicher, Tags, Volumen-Spanne, erwarteter Abschluss-Termin, Stufe, Pipeline.
3.4.7 Schnell-Filter „Nur meine Verkaufsfälle".
3.4.8 Sortier- und Spalten-Konfiguration in der Tabellen-Ansicht pro Benutzer speicherbar.
3.4.9 Massen-Aktionen: Tags hinzufügen/entfernen, Verantwortlichen ändern, Stufe wechseln, archivieren.
3.4.10 Export der gefilterten Auswahl als CSV.
3.4.11 Mehrere Benutzer sehen Pipeline-Änderungen anderer in Echtzeit (live-Aktualisierung der Spalten-Ansicht).
### 3.5 Stufen-Übergänge und Gewonnen / Verloren
3.5.1 Vorwärts- und rückwärts-Wechsel zwischen Stufen ist erlaubt. Bei Rückwärts-Wechsel zeigt das System einen Klartext-Hinweis.
3.5.2 Beim Wechsel in eine „Gewonnen"-Stufe öffnet sich ein Bestätigungs-Dialog mit der Frage *„Auftragsprojekt aus diesem Verkaufsfall anlegen?"* (siehe Won-Handoff-Abschnitt 3.6).
3.5.3 Beim Wechsel in „Verloren" wird ein **Verlust-Grund** aus der konfigurierbaren Liste (siehe 3.3) erzwungen. Beim Wechsel in „Gewonnen" wird ein **Gewinn-Grund** aus der konfigurierbaren Liste angeboten (Pflicht für Auswertung; lässt sich pro Mandant auf optional umschalten). Optional kann der Benutzer in beiden Fällen eine freie Notiz hinterlegen. [N8, 09.05.2026]
3.5.4 Eine Gewonnen- oder Verloren-Markierung kann **innerhalb von 24 Stunden zurückgenommen** werden. Danach ist sie endgültig.
3.5.5 Pipeline-Wechsel eines Verkaufsfalls (zum Beispiel von „Anlagen-Verkauf" nach „Wartungsverträge") ist möglich, erfordert aber erweiterte Berechtigungen und wird mit Klartext-Hinweis und Eintrag in die Historie versehen.
3.5.6 Jeder Stufen-Wechsel wird nachvollziehbar protokolliert (wer, wann, von welcher Stufe in welche, wie lange war der Verkaufsfall in der vorherigen Stufe).
### 3.6 Won-Handoff zur Auftragspipeline
3.6.1 Wird ein Verkaufsfall als „Gewonnen" markiert, fragt das System: *„Auftragsprojekt aus diesem Verkaufsfall anlegen?"*, Standard-Antwort „Ja".
3.6.2 Bei „Ja" wird automatisch ein Auftragsprojekt in der Auftragspipeline (Modul 4) angelegt. Übergeben werden: Titel, Volumen, Verantwortlicher, verknüpfter Kontakt und Firma, hochgeladene Dateien, Notizen.
3.6.3 Der Benutzer wählt im Dialog die Ziel-Auftrags-Pipeline (zum Beispiel „Anlagen-Installation") und die Start-Stufe.
3.6.4 Der Verkaufsfall behält die Verknüpfung zum entstandenen Auftragsprojekt. Im Verkaufsfall-Detail erscheint ein Verweis auf das Projekt.
3.6.5 Bei „Nein" wird der Verkaufsfall nur als Gewonnen markiert, ohne Projekt-Anlage.
3.6.6 Aus einem einzigen Verkaufsfall können **mehrere Auftragsprojekte** entstehen, etwa „PV-Anlage" und „Badumbau" parallel beim selben Kunden. Im Verkaufsfall-Detail kann jederzeit nachträglich ein weiteres Projekt erzeugt oder ein bestehendes Projekt manuell verknüpft werden. *Hinweis: Wartungsverträge und einzelne Service-Einsätze sind in HiveGrid keine Projekte, sondern Service. Sie laufen über das Service-Modul (Phase 2, siehe Vision V.3.2.5).* [N9, 09.05.2026]
3.6.7 **Mandanten-Konfiguration: Wann entsteht das Auftragsprojekt?** [N7, 09.05.2026]
- **Option A: bei Gewonnen-Übergang** (Default). Das Projekt wird erst angelegt, wenn der Verkaufsfall als „Gewonnen" markiert ist. Geeignet für Mandanten, die mit einem externen Angebots-Tool (PandaDoc, DocuSign) arbeiten und die Auftragsabwicklung erst nach Vertragsabschluss starten.
- **Option B: bei Verkaufsfall-Anlage**. Das Projekt wird sofort beim Anlegen des Verkaufsfalls automatisch in einer konfigurierbaren Default-Auftrags-Pipeline angelegt und mit dem Verkaufsfall verknüpft. Geeignet für Mandanten, die das Angebot in der ERP (z. B. KWP) erstellen und dort schon eine Projekt-Zuordnung brauchen, bevor der Verkaufsfall gewonnen ist.
- Wahl durch den Mandanten-Administrator pro Sales-Pipeline. Wechsel der Option ist später möglich, gilt nur für neue Verkaufsfälle.
- Bei Option B mit späterem „Verloren" wird das angelegte Projekt automatisch archiviert (nicht hart gelöscht, damit ERP-Verknüpfungen nicht reißen).
### 3.7 Mehrere Quellen für neue Verkaufsfälle
3.7.1 Manuelle Anlage über die Sales-Ansicht.
3.7.2 Aus einer Lead-Anfrage (Modul 2) per „Lead in Verkaufsfall umwandeln". Lead-Daten werden in den Verkaufsfall übernommen.
3.7.3 Aus einer Formular-Einsendung (Modul 5), der Mandanten-Administrator konfiguriert pro Formular, welche Felder wie auf einen Verkaufsfall abgebildet werden.
3.7.4 Aus einer Email-Konversation (Modul 9), „Verkaufsfall aus dieser Email anlegen". Das System schlägt den passenden Kontakt automatisch vor.
3.7.5 Aus einem eingegangenen Anruf (Modul 12, AirCall), Anruf-Notiz wird Verkaufsfall-Beschreibung, Telefonnummer wird automatisch dem Kontakt zugeordnet.
3.7.6 Aus einer Automation (Modul 17), zum Beispiel automatisch bei jeder neuen Anfrage aus einer bestimmten Quelle.
### 3.8 Stuck-Erkennung und Auto-Archivierung
3.8.1 Pro Stufe kann eine Schwellen-Anzahl an Tagen hinterlegt werden. Verkaufsfälle, die länger in dieser Stufe stehen, werden als „liegen geblieben" markiert (visueller Hinweis im Kanban + Banner im Detail).
3.8.2 Tägliche Hintergrund-Prüfung erkennt diese Verkaufsfälle automatisch.
3.8.3 Gewonnen-Verkaufsfälle werden nach 30 Tagen automatisch archiviert (pro Pipeline konfigurierbar).
3.8.4 Verloren-Verkaufsfälle werden nach 90 Tagen automatisch archiviert (pro Pipeline konfigurierbar).
3.8.5 Archivierte Verkaufsfälle bleiben in den Auswertungen und Reports sichtbar, sind aber aus dem Tagesgeschäft ausgeblendet.
3.8.6 Verkaufsfälle können vom Verantwortlichen oder vom Administrator wieder reaktiviert werden.
### 3.9 Verkaufsfall-Detail-Ansicht
3.9.1 Zeigt alle Stammdaten, Stufen-Historie, Notizen, verknüpfte Aufgaben (Modul 26), Dateien, Formular-Einsendungen, Email-Verlauf, Anrufe und Termine.
3.9.2 Wenn der Verkaufsfall aus einem Lead entstand, erscheint ein Hinweis mit Verweis auf den Ursprungs-Lead.
3.9.3 Aktionen aus dem Detail heraus: anrufen (Click-to-Call), Email schreiben, **Termin direkt am Verkaufsfall anlegen** (siehe 3.9.5), Aufgabe anlegen, Notiz hinzufügen, Datei hochladen, Formular-Einsendung verknüpfen, Tags pflegen, archivieren.
3.9.5 **Termin-Anlage direkt aus dem Verkaufsfall (Setter-Closer-Workflow)** [N17, 09.05.2026]
- Aus dem Verkaufsfall heraus kann ein Termin für eine andere Person im Mandanten angelegt werden (Use-Case: ein Setter telefoniert mit dem Kunden und plant für den Closer einen Vor-Ort-Termin).
- Die Verkaufsfall-Daten werden **automatisch in den Termin übernommen**, nach einem mandanten-konfigurierbaren festen Layout: Kunde, Adresse, Telefon, Volumen, Anlagen-Typ, Notizen, Verlinkung zurück auf den Verkaufsfall, Verlinkung zu den hochgeladenen Fotos / Dateien.
- Mandanten-Administrator definiert pro Sales-Pipeline einmalig, welche Verkaufsfall-Felder in welcher Form in den Termin übernommen werden. Setter muss nichts mehr abtippen.
- Der Termin wird über das Kalender-Modul (M25) im Kalender des Closer angelegt und über die Kalender-Synchronisation in seinen Google- oder Microsoft-Kalender geschrieben.
- Bei Termin-Verschiebung oder Absage durch den Closer aktualisiert sich der Verlauf am Verkaufsfall automatisch.
3.9.4 Klartext-Banner bei besonderen Zuständen (Beispiele):
- *„Dieser Verkaufsfall wurde als gewonnen markiert am [Datum]. [Gewonnen-Status zurücknehmen, 24h verfügbar]"*
- *„Dieser Verkaufsfall ist als verloren markiert. Grund: [Grund]. [Wieder öffnen]"*
- *„Dieser Verkaufsfall ist seit X Tagen in der Stufe [Name]. Üblich sind Y Tage. Soll eine Erinnerung erstellt werden?"*
- *„Der zugeordnete Kontakt ist archiviert."*
### 3.10 Forecast und Vertriebs-Kennzahlen
3.10.1 Pro Pipeline und pipelineübergreifend wird ein **Forecast** berechnet: Summe der Verkaufsfälle gewichtet mit der Wahrscheinlichkeit der jeweiligen Stufe. Beispiel: Ein Verkaufsfall über 25.000 Euro in der Stufe „Verhandlung" mit 70% Wahrscheinlichkeit trägt 17.500 Euro zum Forecast bei.
3.10.2 Aufteilung nach Zeitraum: dieser Monat, dieses Quartal, nächste 12 Monate.
3.10.3 **Realisierter Umsatz** als Kontrast zum Forecast: Summe aller Gewonnen-Verkaufsfälle im Zeitraum.
3.10.4 Pro Vertriebler werden gezeigt: aktive Verkaufsfälle, Forecast-Beitrag, Gewinn-Quote der letzten 90 Tage, Aktivitäts-Zahlen (Anrufe, Mails, Termine), durchschnittliche Dauer von Anlage bis Gewonnen, Anzahl liegen-gebliebener Verkaufsfälle.
3.10.5 Stufen-Übergangs-Quoten („Wie viele Prozent der Verkaufsfälle, die in Stufe A waren, kommen in Stufe B an?").
3.10.6 Verteilung der Verlust-Gründe.
3.10.7 Diese Kennzahlen werden im Dashboard-Modul (M20) als Widgets gezeigt.
### 3.11 Berechtigungen
3.11.1 Es gibt mehrere Berechtigungs-Stufen rund um Verkaufsfälle: nur eigene sehen, alle sehen, anlegen/bearbeiten, Stufen wechseln, löschen, Pipeline-Verwaltung.
3.11.2 Eine **eigene Berechtigung gilt für das Volumen-Feld**. Das ist wichtig, weil etwa Bauleiter und Monteure den Verkaufsfall als Kontext sehen sollen, aber **nicht das Volumen**.
3.11.3 Eine eigene Berechtigung gilt für aggregierte Kennzahlen (Forecast, Stufen-Volumen, Performance-Charts).
3.11.4 SHK-Standard-Rollen: Geschäftsführer sieht alles inklusive Volumen und Aggregaten. Vertriebsleiter ebenso. Vertriebler sieht alle Verkaufsfälle, aber Volumen nur bei eigenen. Bauleiter/Projektleiter sehen Verkaufsfälle als Kontext, aber **kein Volumen, keine Aggregate**. Büro sieht alles inklusive Volumen für Rechnungs-Vorbereitung. Monteur sieht keine Verkaufsfälle.
3.11.5 Zugriff auf einen nicht-erlaubten Verkaufsfall ergibt eine 404-Meldung („nicht gefunden") statt einer 403-Meldung („verboten"), damit nicht erkennbar ist, dass es den Verkaufsfall überhaupt gibt.
3.11.6 Klartext bei Berechtigungs-Fehlern, Beispiele:
- *„Du darfst Verkaufsfälle nicht in andere Phasen verschieben. Bitte einen Vertriebsleiter."*
- *„Du kannst diesen Verkaufsfall als gewonnen markieren, aber das automatische Anlegen eines Auftragsprojekts erfordert zusätzliche Berechtigung. Möchtest du nur den Gewonnen-Status setzen?"*
### 3.12 Phase 2 / bewusst NICHT in Phase 1
3.12.1 Marge / Deckungsbeitrag pro Verkaufsfall mit eigener Sicht-Berechtigung.
3.12.2 Versionierung von Angeboten zu einem Verkaufsfall.
3.12.3 Konfigurierbare Sichtbarkeit einzelner Zusatzfelder pro Rolle (Phase-2-Feinschliff).
### 3.13 Klartext-Fehlertexte (Beispiele)
3.13.1 Pipeline ohne Gewonnen-Stufe beim Speichern: *„Diese Pipeline hat keine ‚Gewonnen'-Stufe. Bitte mindestens eine Stufe vom Typ ‚gewonnen' anlegen."*
3.13.2 Pipeline ohne Verloren-Stufe: *„Diese Pipeline hat keine ‚Verloren'-Stufe. Bitte mindestens eine Stufe vom Typ ‚verloren' anlegen."*
3.13.3 Stufe löschen mit Verkaufsfällen drin: *„In dieser Stufe sind 8 aktive Verkaufsfälle. Bitte zuerst neu zuweisen oder Stufe archivieren statt löschen."*
3.13.4 Hard-Delete eines Verkaufsfalls mit angelegtem Auftragsprojekt: *„Dieser Verkaufsfall hat ein verknüpftes Projekt. Bitte zuerst Verknüpfung lösen oder Projekt selbst archivieren/löschen."*
---
## Modul 4: Auftragspipeline (Projektabwicklung)
**Was es tut:** Bildet die komplette Abwicklung eines Auftrags ab, vom Übergang aus dem gewonnenen Verkaufsfall über Disposition, Material-Bestellung, Ausführung auf der Baustelle bis zur Abnahme mit Kunden-Unterschrift. Beinhaltet die **Plantafel** für die Mitarbeiter-Einsatzplanung und das **Abnahme-Protokoll** mit digitaler Unterschrift.
**Löst ab:** Eigenbau-Excel-Pläne, manuelle Disposition, Papier-Abnahme-Protokolle.
**Warum es wichtig ist:** Das ist der **Geerkens-Kern**. Hier passiert das eigentliche Tagesgeschäft eines SHK-Betriebs. Ohne dieses Modul gibt es keinen sinnvollen Mehrwert gegenüber HubSpot.
### 4.1 Was zu einem Auftragsprojekt gespeichert wird
4.1.1 Eindeutige Projekt-Nummer, fortlaufend pro Mandant (Beispiel: „P-2026-0042").
4.1.2 Titel (Pflicht), längere Beschreibung als Freitext.
4.1.3 Pipeline und aktuelle Stufe (offen / abgeschlossen / storniert).
4.1.4 Volumen (Auftragswert).
4.1.5 Geplanter Start-Termin, geplanter End-Termin, tatsächlicher End-Termin.
4.1.6 **Baustellen-Adresse** (kann von der Kontakt-Adresse abweichen, Straße, PLZ, Ort, Land).
4.1.7 Hauptverantwortlicher Projektleiter.
4.1.8 Verknüpfter Hauptkontakt (Pflicht).
4.1.9 Verknüpfte Firma (optional).
4.1.10 **Ursprungs-Verkaufsfall** (optional, Projekte können auch ganz ohne Verkaufsfall angelegt werden, etwa Notfall-Reparaturen oder Wartungstermine).
4.1.11 Eingesetzte Mitarbeiter mit ihrer Rolle im Projekt (Projektleiter, Bauleiter, Monteur, Lehrling, frei beschriftbar).
4.1.12 Tags / Schlagworte.
4.1.13 Branchenspezifische Zusatzfelder.
4.1.14 Stornierungs-Grund (Pflichtfeld, wenn Projekt storniert wurde).
4.1.15 Verknüpftes Projekt-Vorlagen-Muster, falls aus Vorlage angelegt.
### 4.2 Pipeline-Konfiguration
4.2.1 Wie bei Verkaufsfällen kann der Mandant **mehrere Auftrags-Pipelines** parallel führen. Geerkens braucht zum Start drei: „Anlagen-Installation", „Wartungseinsatz", „Notfall-Reparatur".
4.2.2 Pro Stufe konfigurierbar: Name, Reihenfolge, Stufen-Typ (offen / abgeschlossen / storniert), Stuck-Schwelle in Tagen, Farbe.
4.2.3 Eine Stufe kann auf **„erfordert Abnahme-Protokoll"** gestellt werden. Wechsel in diese Stufe ist dann nur möglich, wenn ein gültiges Abnahme-Protokoll vorliegt.
4.2.4 Pro Stufe mit Abnahme-Pflicht muss ein Abnahme-Formular-Muster zugewiesen sein (siehe Abschnitt 4.7).
4.2.5 Beim Anlegen eines Mandanten werden die SHK-Standard-Pipelines mit ihren Stufen vorausgefüllt:
- **Anlagen-Installation:** Vorbereitung → Disposition/Materialbestellung → Ausführung → Abnahme (Abnahme-Pflicht) → Abgeschlossen → Storniert.
- **Wartungseinsatz:** Termin geplant → In Ausführung → Abgeschlossen → Storniert.
- **Notfall-Reparatur:** Eingegangen → Unterwegs → Vor Ort → Abgeschlossen.
4.2.6 Pipeline muss mindestens eine „Abgeschlossen"-Stufe haben.
### 4.3 Projekt-Vorlagen
4.3.1 Der Mandanten-Administrator kann Projekt-Vorlagen anlegen (zum Beispiel „Standard-Anlagen-Installation").
4.3.2 Eine Vorlage enthält: Default-Pipeline, Default-Start-Stufe, Default-Mitarbeiter-Rollen, Default-Aufgaben, Default-Plantafel-Einträge (zum Beispiel „3 Tage Vorbereitung + 2 Tage Installation + 1 Tag Abnahme"), Default-Zusatzfelder.
4.3.3 Beim Anlegen eines neuen Projekts kann eine Vorlage gewählt werden, die genannten Vorbelegungen werden automatisch übernommen und können angepasst werden.
### 4.4 Quellen für neue Auftragsprojekte
4.4.1 **Manuelle Anlage** über die Auftrags-Ansicht.
4.4.2 **Automatisch aus einem gewonnenen Verkaufsfall** (Won-Handoff, siehe Modul 3 Abschnitt 3.6).
4.4.3 **Mehrfach-Anlage aus demselben Verkaufsfall** (zum Beispiel ein Anlagen-Installations-Projekt plus ein Wartungs-Projekt aus dem gleichen Verkauf).
4.4.4 **Aus einer Formular-Einsendung** (Modul 5), zum Beispiel ein Service-Anfrage-Formular legt automatisch ein Projekt in der „Wartungseinsatz"-Pipeline an.
4.4.5 **Aus einer Termin-Buchung** (Modul 6), Wartungstermin-Buchung erzeugt automatisch ein Projekt plus einen passenden Plantafel-Eintrag.
4.4.6 **Aus einem Notfall-Anruf** (Modul 12, AirCall), Funktion „Notfall-Auftrag aus diesem Anruf anlegen".
4.4.7 **Aus einer Automation** (Modul 17).
4.4.8 **Aus einer Vorlage** (siehe 4.3).
### 4.5 Spalten- und Tabellen-Ansicht
4.5.1 Wie bei Verkaufsfällen: Spalten-Ansicht (Kanban) pro Pipeline, plus Tabellen-Ansicht.
4.5.2 Pro Karte: Projekt-Nummer, Titel, Volumen (sofern berechtigt), Mitarbeiter (Avatare, Projektleiter hervorgehoben), Zeitraum, visueller Hinweis bei Stuck oder Überzogenem End-Termin, visueller Hinweis bei **offenen Mängeln aus einer Abnahme**, Tags, Kontakt-Name, Kurz-Adresse.
4.5.3 Drag & Drop zwischen Stufen. Beim Drag in eine Stufe mit Abnahme-Pflicht erscheint Klartext-Block: *„Diese Stufe erfordert ein Abnahmeprotokoll. [Abnahme starten]"*.
4.5.4 Beim Drag in „Abgeschlossen" wird optional der tatsächliche End-Termin erfragt.
4.5.5 Beim Drag in „Storniert" wird der Stornierungs-Grund **erzwungen**.
### 4.6 Plantafel (Mitarbeiter-Einsatzplanung)
> **Erweiterung gem. Anmerkung Noah, 09.05.2026 [N10]:** Die Plantafel ist bei vielen Mandanten ein zentral genutztes Werkzeug der ERP-Welt. Bei Geerkens läuft sie heute überwiegend in KWP, weil dort auch Service-Einsätze mit-disponiert werden. HiveGrid darf hier keine Insel werden. Anforderung: **bidirektionale Synchronisation** zwischen KWP-Plantafel und HiveGrid-Plantafel. Beide Seiten lesen UND schreiben. Der Mandant entscheidet selbst, ob er die Plantafel primär in KWP oder in HiveGrid pflegt. Detail-Anforderungen siehe 4.6.14.
4.6.1 Die Plantafel ist eine **Wochenkalender-Funktion**, die zeigt, welcher Mitarbeiter wann an welchem Projekt arbeitet.
4.6.2 Senkrechte Achse: Mitarbeiter-Liste. Waagerechte Achse: Zeitraum (umschaltbar zwischen Tag, Woche, Monat).
4.6.3 Im Raster werden Einsatz-Blöcke gezeigt, pro Block: Projekt-Titel, Status, Kurz-Adresse, Farbe nach Pipeline.
4.6.4 **Drag & Drop**: Einsatz-Blöcke können verschoben, in der Länge angepasst oder neu angelegt werden (Klick auf einen leeren Slot).
4.6.5 Optional einblendbar: Urlaube und Krankmeldungen aus dem HR-Hub (Modul 14), externe Kalender-Termine (Modul 25), Verfügbarkeits-Regeln pro Mitarbeiter.
4.6.6 Filter: Mitarbeiter (Rolle, Gruppe, Verfügbarkeit), Projekt (Pipeline, Stufe, Tag, Status).
4.6.7 Massen-Aktion „neu zuweisen" (zum Beispiel bei Krankheits-Vertretung).
4.6.8 Anlage aus einer Projekt-Vorlage übernimmt die Default-Einsatz-Blöcke.
#### 4.6.9 Konflikt-Erkennung mit Klartext-Hinweisen
4.6.9.1 Doppel-Belegung: roter Indikator + *„Max ist Mo 10-14 schon im Projekt P-2026-0042 verplant. Trotzdem zuweisen?"*
4.6.9.2 Genehmigter Urlaub: *„Max hat am Dienstag genehmigten Urlaub. Trotzdem zuweisen?"*
4.6.9.3 Krankmeldung: *„Max ist seit gestern krankgemeldet. Trotzdem einplanen?"*
4.6.9.4 Außerhalb der Verfügbarkeits-Regeln: *„Max arbeitet normalerweise nur Mo-Do. Trotzdem für Freitag einplanen?"*
4.6.9.5 Außerhalb Arbeitszeit: *„Slot ist um 22:00, außerhalb der üblichen Arbeitszeit. Bestätigen?"*
#### 4.6.10 Verfügbarkeits-Regeln pro Mitarbeiter
4.6.10.1 Pro Mitarbeiter konfigurierbar: Standard-Wochenarbeitszeit, Pausen-Zeiten, Ausnahmen.
4.6.10.2 Verfügbarkeits-Regeln werden bei der Konflikt-Erkennung der Plantafel berücksichtigt.
#### 4.6.11 Status-Verlauf eines Plantafel-Eintrags
4.6.11.1 Status-Stufen: geplant → bestätigt → in Arbeit → erledigt (oder abgesagt).
4.6.11.2 Statuswechsel kann durch den Mitarbeiter selbst getätigt werden (Mobile-Funktion).
#### 4.6.12 Abgleich mit dem persönlichen Kalender des Mitarbeiters
4.6.12.1 Plantafel-Einträge werden automatisch in den persönlichen Google- oder Microsoft-Kalender des Mitarbeiters synchronisiert (Modul 25).
4.6.12.2 Sagt der Mitarbeiter den Termin in seinem Kalender ab, wird der Status auf „abgesagt" gesetzt und der Projektleiter benachrichtigt.
#### 4.6.13 Mobile Sicht für den Monteur
4.6.13.1 Die Plantafel selbst ist Desktop-Funktion (für die Disposition im Büro).
4.6.13.2 Der Monteur sieht stattdessen auf dem Handy eine vereinfachte **„Meine Termine heute"**-Liste mit allen heutigen Einsätzen.
4.6.13.3 Pro Termin: Projekt-Titel, Adresse mit Karten- und Navigations-Verknüpfung, Notiz, Status, einfacher Knopf zum Statuswechsel (bestätigt → in Arbeit → erledigt).
4.6.13.4 Zusätzlich „Meine Woche"-Übersicht.
4.6.13.5 Push-Benachrichtigung bei neuer Zuweisung oder Änderung.
#### 4.6.14 Bidirektionale Synchronisation mit der KWP-Plantafel [N10, 09.05.2026]
4.6.14.1 **Was synchronisiert wird:** Termine (Einsatz-Blöcke) mit Mitarbeiter-Zuweisung, Datum, Zeitfenster, Projektnummer (oder KWP-Service-Nummer), Adresse, Status. Beide Seiten lesen UND schreiben.
4.6.14.2 **Quellen-Abgleich:** jeder Termin hat eine eindeutige System-übergreifende ID. Wird ein Termin in KWP angelegt, kommt er mit der KWP-ID nach HiveGrid; umgekehrt vergibt HiveGrid eine ID, die KWP übernimmt. So kann jede Seite den Termin der jeweils anderen wiedererkennen.
4.6.14.3 **Sync-Frequenz:** Push (Echtzeit) wo technisch möglich, Pull-Fallback alle 5 Minuten als Backup. Verzögerung im Schnitt unter 30 Sekunden.
4.6.14.4 **Wahl der Primär-Welt durch den Mandanten:** der Mandanten-Administrator legt fest, ob die Disposition primär in KWP oder primär in HiveGrid passiert. Beide Modi sind möglich, beide Seiten bleiben schreibfähig. Diese Einstellung beeinflusst nur die Default-Ansicht und die Konflikt-Auflösungs-Regel (siehe 4.6.14.7).
4.6.14.5 **Service-Einsätze (Wartungen, Reparaturen) aus KWP:** wenn KWP Service-Termine für Mitarbeiter plant, die in HiveGrid keine Projekt-Zuordnung haben, werden diese Termine in HiveGrid als „Service-Einsatz aus KWP" gekennzeichnet sichtbar (zur Vermeidung von Doppel-Disposition). Sobald HiveGrid ein eigenes Service-Modul bekommt (Phase 2, siehe Vision V.3.2.5), werden Service-Einsätze in dieses Modul integriert.
4.6.14.6 **Konflikt-Erkennung:** wird derselbe Termin gleichzeitig in beiden Systemen geändert (z. B. KWP verschiebt um 1 Stunde, HiveGrid wechselt den Mitarbeiter), wird der Konflikt im Audit-Log markiert und der Mandanten-Administrator bekommt Klartext-Notification: *„Termin am [Datum] wurde gleichzeitig in KWP und HiveGrid geändert. Bitte prüfen, welcher Stand gilt."*
4.6.14.7 **Konflikt-Auflösungs-Regel:** Default ist „KWP gewinnt" (konsistent mit 19.6, da KWP System-of-Record für Buchhaltung und Service ist). Pro Mandant umstellbar auf „HiveGrid gewinnt" oder „manuelle Bestätigung erforderlich".
4.6.14.8 **Plantafel-getriebene Automatisierungen (HiveGrid-Stärke):** Termine aus der Plantafel können Auslöser für Automatisierungen sein (Modul 17). Beispiele: Termin-Erinnerung 1 Tag vorher per WhatsApp/SMS an den Endkunden, Status-Update an den Endkunden bei Verschiebung, automatische Rückmeldung an das Kunden-Portal bei „erledigt". Das ist ein Funktions-Vorteil, der KWP nicht hat.
4.6.14.9 **Anti-Endlosschleife:** ein Termin, der durch den Sync von KWP nach HiveGrid übertragen wird, löst keinen Push zurück nach KWP aus. Sync-Status ist pro Termin sichtbar („zuletzt synchronisiert um [Zeit] aus KWP" / „nach KWP geschickt um [Zeit]").
### 4.7 Abnahme-Workflow
4.7.1 Abnahme-Protokoll-Formulare sind durch den Mandanten-Administrator konfigurierbar (basieren auf dem Formular-Baukasten Modul 5).
4.7.2 Beim Anlegen eines Mandanten wird ein **SHK-Standard-Abnahme-Formular** vorausgefüllt mit: Datum/Uhrzeit der Abnahme, Anwesende mit Rollen, Druckprobe-Boolean + Wert, Funktionsprüfung Heizkreis, Wärmemengenzähler-Werte, Inbetriebnahme-Datum, Garantie-Beginn, übergebene Dokumente (Bedienungsanleitung, Garantiekarte, Wartungs-Termin-Übersicht), Mängel-Liste mit Foto-Anhängen, allgemeine Foto-Anhänge, Bemerkungen Kunde, Bemerkungen Monteur.
4.7.3 Eine Abnahme wird vom Monteur **mobil auf der Baustelle** durchgeführt. Die Anwendung ist mobile-first optimiert.
#### 4.7.4 Schritte einer Abnahme
4.7.4.1 **Formular ausfüllen**: Felder werden ausgefüllt, Fotos können direkt aus der Kamera hochgeladen werden, Mängel werden mit Foto-Anhang erfasst, lange Bemerkungen können diktiert werden (Whisper-Transkription, Modul 18).
4.7.4.2 **Mängel-Klassifizierung**: pro Mangel wird gewählt: kritisch (Abnahme verweigert) / kleinere Mängel (Abnahme mit Vorbehalt) / kosmetisch (Abnahme erfolgt). Damit ergibt sich der Abnahme-Typ: vollständig / mit Vorbehalt / abgelehnt.
4.7.4.3 **Kunde unterschreibt**: direkte Touch-Unterschrift auf dem Bildschirm. Kunden-Name wird eingegeben (kann vom hinterlegten Kontakt abweichen). IP-Adresse und Zeitstempel werden automatisch festgehalten.
4.7.4.4 **Mitarbeiter unterschreibt**: Touch-Unterschrift des Monteurs.
4.7.4.5 **Bestätigung**: Abnahme-Protokoll wird gespeichert, automatisch wird ein PDF erzeugt (im Dateien-Bereich des Projekts und im Kunden-Portal sichtbar).
4.7.4.6 **Auto-Email an den Kunden**: Klartext-Email mit dem Protokoll-PDF im Anhang (Vorlage durch Mandant anpassbar).
#### 4.7.5 Folge-Aktionen je nach Abnahme-Typ
4.7.5.1 **Vollständig**: Projekt wechselt automatisch in „Abgeschlossen" (oder die nächste konfigurierte Stufe).
4.7.5.2 **Mit Vorbehalt (kleinere Mängel)**: Projekt bleibt in „Abnahme", erkannte Mängel werden automatisch als Aufgaben (Modul 26) angelegt mit einer Standard-Frist.
4.7.5.3 **Abgelehnt**: Projekt fällt zurück in „Ausführung", Projektleiter wird benachrichtigt.
#### 4.7.6 Mehrere Abnahmen pro Projekt
4.7.6.1 Bei großen Aufträgen sind **Teilabnahmen** möglich. Ein Projekt hat 0 bis beliebig viele Abnahme-Protokolle.
4.7.6.2 Die letzte vollständige Abnahme bestimmt den Projekt-Status.
#### 4.7.7 Klartext-Hinweise und rechtliche Pflicht-Aufbewahrung
4.7.7.1 Abnahme ohne Kunden-Unterschrift wird blockiert: *„Bitte Kunden-Unterschrift einholen, sonst keine rechtsgültige Abnahme."*
4.7.7.2 Mängel ohne Beschreibung werden blockiert: *„Mindestens ein Mangel angekreuzt aber keine Beschreibung. Bitte Mängel detailliert beschreiben."*
4.7.7.3 Abnahme-Protokolle sind **rechtlich aufbewahrungspflichtig (mindestens 6 Jahre)** und können daher **nicht gelöscht**, sondern nur archiviert werden.
4.7.7.4 IP-Adresse, Zeitstempel und Unterschriften-Bilder werden mit aufbewahrt.
### 4.8 Projekt-Detail-Ansicht
4.8.1 Zeigt alle Stammdaten, Mitarbeiter-Liste, eingeplante Plantafel-Einträge, verknüpfte Aufgaben (Modul 26), Dateien (inklusive Fotos von der Baustelle), Formular-Einsendungen, alle Abnahme-Protokolle, Verlaufs-Strom (wer hat wann was gemacht), Stufen-Historie.
4.8.2 Bei Projekten mit Adresse wird optional eine Karten-Ansicht angeboten.
4.8.3 **Mobile-Ansicht** (für den Monteur auf der Baustelle, gemäß Leitplanke 2):
- Vereinfachte Stammdaten oben.
- Heutige Aufgaben im Vordergrund.
- Großer Knopf für Foto-Direkt-Upload.
- Großer Knopf für „Abnahme starten".
- Großer Knopf für „Notiz diktieren".
- Aufgaben mit einfachem Tipp-Wechsel auf erledigt.
- Plantafel und Zusatzfelder reduziert dargestellt.
#### 4.8.4 Sales-Verlauf-Sektion (read-only)
4.8.4.1 Wenn das Projekt aus einem Verkaufsfall entstanden ist, zeigt eine eigene Sektion den **Sales-Verlauf**: Verkaufsfall-Daten zum Zeitpunkt des Won-Handoffs (Volumen, durchlaufene Stufen, Gewonnen-Datum, Lead-Ursprung), Aktivitäts-Strom des Verkaufsfalls (Anrufe, Mails, Notizen, Stufen-Wechsel), Dateien aus der Sales-Phase (Angebot-PDF, Voraufnahme-Fotos, Skizzen), Formular-Einsendungen aus der Sales-Phase.
4.8.4.2 Diese Daten sind **nur lesbar** im Projekt-Kontext. Klartext-Hinweis: *„Diese Daten stammen aus dem Sales-Prozess. Editieren bitte im Verkaufsfall: [D-2026-0042]"*.
4.8.4.3 Hat der Benutzer keine Berechtigung, den Verkaufsfall zu sehen, wird der Sales-Verlauf einfach nicht angezeigt.
4.8.4.4 Volumen-Berechtigungen aus Modul 3 wirken auch hier, ein Bauleiter ohne Volumen-Berechtigung sieht in der Sales-Verlauf-Sektion das Volumen verborgen.
### 4.9 Projekt-Lebenszyklus
4.9.1 Vorwärts/Rückwärts-Wechsel zwischen Stufen erlaubt (bei Rückwärts mit Klartext-Hinweis).
4.9.2 Wechsel in Stufe mit Abnahme-Pflicht: blockiert ohne gültiges Abnahme-Protokoll.
4.9.3 Wechsel in „Abgeschlossen": tatsächlicher End-Termin wird optional erfasst.
4.9.4 Wechsel in „Storniert": Stornierungs-Grund Pflicht.
4.9.5 Rücknahme von Abgeschlossen/Storniert nur innerhalb von 24 Stunden möglich.
4.9.6 Auto-Archivierung: abgeschlossen nach 90 Tagen, storniert nach 30 Tagen (pro Pipeline konfigurierbar). Archivierte Projekte bleiben in Reports sichtbar.
4.9.7 Stuck-Erkennung wie bei Verkaufsfällen.
4.9.8 **Hard-Delete blockiert**, wenn Abnahme-Protokolle hängen, wegen rechtlicher Aufbewahrung. Klartext: *„Dieses Projekt hat 2 Abnahme-Protokolle und 14 verknüpfte Dateien (rechtlich aufbewahrungspflichtig). Hard-Delete blockiert. Bitte archivieren statt löschen."*
### 4.10 Mitarbeiter-Verwaltung im Projekt
4.10.1 Pro Projekt können beliebig viele Mitarbeiter zugewiesen werden, jeweils mit einer Rolle (Projektleiter, Bauleiter, Monteur, Lehrling, Rollen frei beschriftbar).
4.10.2 Mitarbeiter können einzeln oder als ganze Gruppe (zum Beispiel „Team Süd") hinzugefügt werden.
4.10.3 Beim Hinzufügen werden die Mitarbeiter automatisch zum Mitglied im Projekt-Team-Chat (Modul 13) hinzugefügt, der Chat-Channel wird beim Anlegen des Projekts automatisch erstellt.
4.10.4 Hinweis bei Projekten ohne Mitarbeiter: *„Diesem Projekt sind keine Mitarbeiter zugewiesen. [Mitarbeiter hinzufügen]"*.
### 4.11 Berechtigungen
4.11.1 Berechtigungs-Stufen: nur Projekte sehen, in denen ich Mitglied bin / nur Projekte als Projektleiter / alle Projekte / nur aktive Projekte (für Monteure ohne Archiv-Zugriff) / anlegen / bearbeiten / Mitarbeiter verwalten / Stufen wechseln / löschen / administrative Pipeline-Verwaltung.
4.11.2 **Volumen-Berechtigung getrennt** (eigene/alle/keine).
4.11.3 Aggregierte Kennzahlen-Berechtigung getrennt.
4.11.4 **Plantafel-Berechtigungen** getrennt: nur eigene Slots sehen / komplette Plantafel sehen / Plantafel-Schreiben (typisch Projektleiter und Disposition) / Massen-Neu-Zuweisung (typisch Administrator).
4.11.5 **Abnahme-Berechtigungen** getrennt: Abnahme starten und ausfüllen / Abnahme nur lesen / Abnahme-Formular-Vorlagen verwalten.
4.11.6 SHK-Standard-Rollen: Geschäftsführer voll. Vertriebsleiter und Vertriebler sehen alle Projekte (kein Volumen-Detail). Projektleiter/Bauleiter sehen alle, dürfen anlegen, bearbeiten, Plantafel pflegen. Büro/Backoffice sehen alle, dürfen anlegen, lesen Plantafel. Marketing nur lesen ohne Volumen. **Monteur sieht nur die Projekte, in denen er Mitglied ist, nur aktive (keine archivierten), kein Volumen, darf für seine eigenen Projekte aber Abnahmen durchführen.**
### 4.12 Integration mit anderen Modulen
4.12.1 **Modul 1 CRM**: Kontakt und Firma verlinkt; Aktivitäts-Strom auch im Kontakt sichtbar.
4.12.2 **Modul 3 Sales-Pipeline**: Won-Handoff, Mehrfach-Anlage aus einem Verkaufsfall, Sales-Verlauf-Sektion.
4.12.3 **Modul 5 Formulare**: Abnahme-Formulare, Foto-Checklisten, Sales-Aufnahme-Formulare wandern aus dem Verkaufsfall mit, Projekt-Anlage aus Formular.
4.12.4 **Modul 6 Buchungen**: Wartungstermin-Buchung erzeugt automatisch ein Projekt plus Plantafel-Eintrag.
4.12.5 **Modul 9 Email**: Mails an den Kontakt erscheinen im Projekt-Strom; Auto-Verknüpfung über Betreff-Muster `[P-2026-0042]`.
4.12.6 **Modul 12 Telefonie**: Click-to-Call aus dem Projekt heraus; Notfall-Auftrag aus eingehendem Anruf.
4.12.7 **Modul 13 Team-Chat**: automatischer Projekt-Channel mit allen Mitgliedern; wird bei Projekt-Abschluss archiviert.
4.12.8 **Modul 14 HR-Hub**: Urlaube und Krankmeldungen fließen in die Plantafel-Konflikt-Erkennung.
4.12.9 **Modul 15 Kunden-Portal**: Kunde sieht den Projekt-Status (durch Mandant konfigurierbar), Abnahme-PDF wird automatisch freigegeben, Status-Mails bei Stufenwechsel.
4.12.10 **Modul 17 Automation**: Projekte können durch Automationen angelegt, weitergeschoben oder mit Mitarbeitern besetzt werden; Trigger bei Projekt-Anlage, Stufenwechsel, Abschluss, Stornierung, Mitarbeiter-Wechsel, Abnahme-Abschluss, Plantafel-Änderung.
4.12.11 **Modul 19 KWP**: optional automatischer Sync zu KWP bei Projekt-Anlage aus gewonnenem Verkaufsfall; Stufenwechsel auf „Abgeschlossen" triggert optional die Rechnungs-Bereitschaft. Über die einheitliche Adapter-Schicht (Leitplanke 11).
4.12.12 **Modul 22 Benachrichtigungen**: Push an Mitarbeiter bei neuer Zuweisung; Push an Projektleiter bei Mängeln aus Abnahme; Push an Kunde bei Statuswechsel (über Kunden-Portal).
4.12.13 **Modul 23 Dateien**: Projekt hat eigenen Datei-Bereich; Foto-Direkt-Upload vom Handy; Abnahme-PDF wird hier abgelegt.
4.12.14 **Modul 25 Kalender-Sync**: Plantafel-Einträge werden in die Kalender der Mitarbeiter synchronisiert.
4.12.15 **Modul 26 Aufgaben**: Aufgaben mit Projekt verknüpft; Mängel aus Abnahme werden automatisch als Aufgaben angelegt; Default-Aufgaben aus Projekt-Vorlagen.
### 4.13 Phase 2 / bewusst NICHT in Phase 1
4.13.1 Eigene Rechnungs-Erzeugung in HiveGrid (geht über KWP).
4.13.2 Hardware-gestützte digitale Signatur (eIDAS-konform), Phase 1 reicht Touch-Unterschrift.
4.13.3 Detaillierte Material-Bestell-Verwaltung pro Projekt (Phase 2, falls KWP nicht genügt).
### 4.14 Klartext-Fehlertexte (Beispiele)
4.14.1 Drag in Stufe mit Abnahme-Pflicht ohne Protokoll: *„Diese Stufe erfordert ein Abnahmeprotokoll. [Abnahme starten]"*
4.14.2 Plantafel-Schreiben ohne Berechtigung: *„Du kannst die Plantafel sehen, aber nicht ändern. Bitte den Projektleiter oder die Disposition kontaktieren."*
4.14.3 Abnahme-Start ohne Berechtigung: *„Du darfst keine Abnahme starten. Bitte einen Projektleiter oder Bauleiter."*
4.14.4 Hard-Delete bei aufbewahrungspflichtigen Daten: siehe 4.9.8.
4.14.5 Stage „Abnahme" ohne zugewiesenes Formular-Muster: *„Stufe ‚Abnahme' verlangt Abnahme-Protokoll, aber kein Formular ist zugewiesen. Bitte Formular auswählen oder Pflicht deaktivieren."*
---
## Modul 26: Aufgaben
**Was es tut:** Bietet ein leichtgewichtiges Aufgaben-Modul, das quer zu allen anderen Modulen liegt. Aufgaben können mit Verkaufsfällen, Projekten, Kontakten, Firmen oder Leads verknüpft sein und entstehen manuell, aus Chat-Nachrichten, aus Formular-Einsendungen oder aus Automationen.
**Löst ab:** Manuelle Notizzettel, Outlook-Aufgaben, vereinzelt Asana/Trello.
**Warum es wichtig ist:** Ohne ein gemeinsames Aufgaben-Modul gehen To-dos in Email-Postfächern und Chat-Verläufen verloren. Aufgaben sind die kleinste Arbeits-Einheit, die Vertrieb und Auftrag verbinden.
### 26.1 Was zu einer Aufgabe gespeichert wird
26.1.1 Titel (Pflicht).
26.1.2 Beschreibung als Freitext (optional).
26.1.3 **Verantwortlicher**: entweder eine konkrete Person oder eine ganze Gruppe (eines von beiden ist Pflicht). Aufgaben ohne Verantwortlichen sind nicht erlaubt; bei Anlage wird automatisch der Ersteller eingetragen.
26.1.4 Frist / Fälligkeits-Datum (optional).
26.1.5 Priorität: niedrig / normal / hoch / dringend (Standard: normal).
26.1.6 Status: offen / in Arbeit / erledigt.
26.1.7 Erledigt-Datum und Erledigt-von (werden beim Übergang auf erledigt gesetzt).
26.1.8 Verknüpfung zur Haupt-Entität (Kontakt / Firma / Lead / Verkaufsfall / Projekt, optional eines davon).
26.1.9 Quelle der Aufgabe: manuell / aus Chat-Nachricht / aus Formular-Einsendung / aus Automation.
26.1.10 Beobachter-Liste, User, die Benachrichtigungen erhalten, ohne Verantwortlicher zu sein. Der Ersteller wird automatisch Beobachter, wenn er nicht selbst Verantwortlicher ist.
### 26.2 Listen-Ansichten
26.2.1 **„Meine Aufgaben"** als Standard-Ansicht: alle Aufgaben, in denen der User Verantwortlicher ist (oder Mitglied der zugewiesenen Gruppe).
26.2.2 **„Von mir erstellt"** als Filter.
26.2.3 **„Alle Aufgaben im Mandanten"** mit entsprechender Berechtigung.
26.2.4 Pro Eintrag werden gezeigt: Titel, Priorität (visuell), Frist (relativ wenn ≤ 7 Tage, sonst absolut, Markierung wenn überfällig), verknüpfte Entität (klickbar), Verantwortlicher, Status, Quelle (visueller Hinweis bei Chat / Formular / Automation).
26.2.5 Schnell-Aktionen pro Eintrag: auf erledigt setzen, Priorität ändern, Frist ändern.
26.2.6 Suche über Titel und Beschreibung.
26.2.7 Filter: Status, Priorität, Frist (heute / diese Woche / überfällig / kein Datum), Verknüpfungs-Typ, Quelle.
26.2.8 Schalter „Archivierte anzeigen".
26.2.9 Standard-Sortierung: Frist aufsteigend, dann Priorität.
26.2.10 Massen-Aktionen: Status ändern, Priorität ändern, Verantwortlichen ändern, archivieren, löschen.
### 26.3 Aufgaben-Verknüpfungen mit anderen Entitäten
26.3.1 Kontakt-, Firmen-, Lead-, Verkaufsfall- und Projekt-Detailansichten haben jeweils einen **Aufgaben-Bereich**, der die verknüpften Aufgaben zeigt.
26.3.2 Direkt aus diesen Ansichten kann eine neue Aufgabe angelegt werden, die Verknüpfung wird automatisch vorausgefüllt.
26.3.3 Wird die verknüpfte Entität gelöscht, erscheint Klartext-Hinweis: *„Die verknüpfte [Entität] wurde gelöscht. [Verknüpfung entfernen]"*.
### 26.4 Aufgaben-Detail
26.4.1 Zeigt alle Stammdaten, Verlaufs-Strom (wer hat wann was geändert), Beobachter, Quelle mit Verknüpfung zum Ursprung (zur Chat-Nachricht / zur Formular-Einsendung / zur Automation-Regel).
26.4.2 Aktionen: Stammdaten bearbeiten, Status ändern, Verantwortlichen wechseln, Verknüpfung anlegen/entfernen/ändern, Beobachter pflegen, duplizieren, löschen.
26.4.3 Klartext-Hinweise:
- *„Diese Aufgabe ist seit X Tagen überfällig."*
- *„Zugewiesener Mitarbeiter ist nicht mehr aktiv. Bitte neu zuweisen."*
- *„Erledigt, wird in 30 Tagen automatisch archiviert."*
### 26.5 Quellen für neue Aufgaben
26.5.1 **Manuell** über die Aufgaben-Ansicht oder aus jeder Entität-Detailansicht heraus.
26.5.2 **Aus einer Chat-Nachricht** (Modul 13): Kontext-Menü an einer Nachricht → „Als Aufgabe markieren". Vorausgefüllt werden: Titel (erste 80 Zeichen der Nachricht), Beschreibung (volle Nachricht), Verknüpfung (Projekt / Verkaufsfall / Kontakt des Channels), Verantwortlicher (aktueller User). Im Chat erscheint danach ein Eintrag: *„[User] hat eine Aufgabe aus dieser Nachricht erstellt: [Titel]"*.
26.5.3 **Aus einer Formular-Einsendung** (Modul 5): pro Formular kann eine Aktion „Aufgabe erstellen" konfiguriert werden, mit Verantwortlichem (Person oder Gruppe), Priorität, Fristen-Berechnung (zum Beispiel „heute + 3 Tage"), Titel-Vorlage und Beschreibungs-Vorlage mit Platzhaltern aus den Formular-Feldern.
26.5.4 **Aus einer Automation** (Modul 17): Automation-Aktion „Aufgabe erstellen" mit gleichen Parametern wie Formular-Aktion.
### 26.6 Erinnerungen und Auto-Archivierung
26.6.1 Pro Aufgabe mit Frist werden automatisch Erinnerungen versendet: 24 Stunden vor Frist (Push + In-App), bei Frist (Push + In-App), 24 Stunden nach Frist falls noch offen (Push + In-App + Email als Eskalation).
26.6.2 Empfänger sind der Verantwortliche (oder alle Mitglieder der zugewiesenen Gruppe) plus die Beobachter.
26.6.3 Pro User konfigurierbar: Erinnerungen aktiv/aus, Ruhezeiten werden berücksichtigt, mehrere Erinnerungen werden gebündelt (max. 1 pro 4 Stunden pro User).
26.6.4 Beispiel-Texte: *„Die Aufgabe ‚Angebot an Schmidt schicken' ist morgen fällig"*, *„… ist heute fällig"*, *„… ist seit 1 Tag überfällig"*.
26.6.5 Erledigte Aufgaben werden nach 30 Tagen automatisch archiviert (Standard, eventuell pro Mandant konfigurierbar).
26.6.6 Hinweis beim Erledigen: *„Aufgabe erledigt, wird in 30 Tagen automatisch archiviert."*
26.6.7 Hard-Delete erst manuell oder über DSGVO-Workflows (Modul 35).
### 26.7 Verlaufs-Strom-Integration
26.7.1 Folgende Aktivitäten werden im Strom protokolliert: Anlage (mit Quellen-Hinweis), Verantwortlichen-Wechsel, Erledigt-Setzen, Wieder-Öffnen, Frist-Änderung, Priorität-Änderung, Auto-Archivierung.
26.7.2 Aufgaben-Aktivitäten erscheinen automatisch im Verlaufs-Strom der verknüpften Entität (Kontakt / Verkaufsfall / Projekt usw.).
26.7.3 Beispiel-Klartext: *„Max Mustermann hat die Aufgabe ‚Angebot an Schmidt schicken' erstellt"*, *„Lisa Müller hat die Aufgabe von Max Mustermann zu sich genommen"*, *„Automation ‚Lead-Eingang' hat eine Aufgabe für Vertrieb-Team erstellt"*.
### 26.8 Berechtigungen
26.8.1 Berechtigungs-Stufen: nur eigene Aufgaben sehen / alle sehen / anlegen und bearbeiten / administrative Verwaltung (alle bearbeiten/löschen, Massen-Aktionen, Auto-Archivierungs-Einstellungen).
26.8.2 Eine Aufgabe gilt als „eigen", wenn der User Verantwortlicher, Mitglied der zugewiesenen Gruppe, Ersteller oder Beobachter ist.
26.8.3 Bei Zugriffsversuch auf eine fremde Aufgabe ohne Berechtigung: 404 (nicht gefunden), nicht 403 (verboten).
26.8.4 Aktions-Knöpfe ohne Berechtigung werden gar nicht angezeigt; Massen-Aktionen ohne Berechtigung sind grau mit Tooltip *„Hierfür benötigst du erweiterte Berechtigungen"*.
### 26.9 Mobile-Sichtbarkeit (Baustellen-Modus)
26.9.1 Die Aufgaben-Liste muss in beiden UI-Modi (Büro/Desktop und Baustelle/Mobile) gut funktionieren.
26.9.2 Auf dem Handy sieht der Monteur „Meine Aufgaben" prominent und kann mit einem einfachen Tipp eine Aufgabe als erledigt markieren.
### 26.10 Synchronisation mit ERP-Aufgaben-Welt (KWP-Box und vergleichbare) [N11, 09.05.2026]
> **Erweiterung gem. Anmerkung Noah, 09.05.2026:** Viele ERPs (bei Geerkens KWP mit der „KWP-Box" / Aktivitätsmanagement) bieten bereits projektbezogene Tickets/Aufgaben. Geerkens nutzt das vollumfänglich. Ein zweites Aufgaben-Tool in HiveGrid würde Doppelpflege erzeugen. Anforderung: HiveGrid-Aufgaben können mit ERP-Aufgaben gespiegelt werden, modular konfigurierbar, ohne dass sich die Systeme gegenseitig aushebeln.
26.10.1 **Pro Mandant aktivierbar**: die ERP-Aufgaben-Synchronisation wird vom Mandanten-Administrator pro angebundenem ERP-Adapter (KWP, später Taifun, TopKontor, Streit V.1) ein- und ausgeschaltet. Mandanten ohne ERP-Sync nutzen das Aufgaben-Modul rein in HiveGrid wie bisher beschrieben.
26.10.2 **Identifikations-Brücke**: Aufgaben werden über die **Projektnummer** zwischen den Systemen verknüpft. Bei KWP-Box läuft das technisch über die Email-Adresse des HiveGrid-Users (jede „KWP-Box" hat eine Mail-Adresse). Welches Feld die Brücke ist, wird pro ERP-Adapter konfiguriert.
26.10.3 **Sync-Richtung (mandanten-konfigurierbar)**: drei Modi.
- **Modus A (Spiegel ERP → HiveGrid)**: Aufgaben aus dem ERP werden in HiveGrid sichtbar, lesend. Änderungen erfolgen nur in der ERP. HiveGrid zeigt sie als „Quelle: KWP".
- **Modus B (Spiegel HiveGrid → ERP)**: in HiveGrid angelegte Aufgaben werden zur ERP übertragen. Änderungen am Ursprung (HiveGrid) übersteuern die ERP.
- **Modus C (bidirektional)**: beide Seiten lesen und schreiben. Konflikt-Auflösung wie bei M19 (System-of-Record gewinnt, Default KWP).
26.10.4 **Aushebel-Schutz**: keine Aufgabe kann sich gegenseitig löschen oder überschreiben. Status-Wechsel auf erledigt in einem System spiegelt sich in das andere mit Klartext-Vermerk: *„Aufgabe wurde in KWP als erledigt markiert um [Zeit]."*
26.10.5 **Sichtbarkeit**: Aufgaben mit ERP-Quelle bekommen einen visuellen Marker („KWP" als Badge), damit der Nutzer erkennt, woher sie kommen. Klick auf den Marker öffnet (sofern technisch möglich) den ERP-Eintrag.
26.10.6 **Klartext-Hinweis bei Sync-Aussetzern**: *„KWP-Box-Synchronisation seit 12 Minuten ohne Lebenszeichen, einzelne Aufgaben fehlen eventuell. Sync-Programm prüfen."* (siehe A.18 Heartbeat).
26.10.7 **Abschalt-Hinweis**: wird die Sync deaktiviert, behält HiveGrid die zuletzt gespiegelten Aufgaben als historische Einträge sichtbar (mit Hinweis „Historisch, Sync inaktiv"), löscht sie aber nicht.
### 26.11 Phase 2 / bewusst NICHT in Phase 1
26.11.1 **Aufgaben-Vorlagen**: wiederverwendbare Aufgaben-Definitionen mit Sub-Aufgaben.
26.11.2 **Wiederkehrende Aufgaben**: täglich/wöchentlich/monatlich automatisch neu erzeugt.
26.11.3 **Spalten-Ansicht (Kanban)** mit Drag & Drop für Status-Wechsel.
26.11.4 **Abhängigkeiten** zwischen Aufgaben (X blockiert Y).
26.11.5 **Sub-Aufgaben** mit Eltern-Kind-Hierarchie.
26.11.6 **Zeit-Erfassung** pro Aufgabe (Start/Stop, Stunden-Summen).
26.11.7 **Erweiterte Beobachter-Logik** (zum Beispiel Projektleiter wird automatisch Beobachter aller Aufgaben in seinem Projekt).
26.11.8 **Eigene Aufgaben-Kommentare** als separate Sub-Entität (Phase 1 nutzt den Verlaufs-Strom).
26.11.9 KI-Vorschläge für neue Aufgaben sind möglich, aber Anlage erfolgt erst nach User-Bestätigung, KI darf Aufgaben nicht direkt anlegen.
### 26.12 Klartext-Fehlertexte (Beispiele)
26.11.1 Leere Liste: *„Keine offenen Aufgaben, schöne Sache."*
26.11.2 Leere gefilterte Liste: *„Mit den aktuellen Filtern keine Aufgaben gefunden. [Filter zurücksetzen]"*
26.11.3 Aufgabe ohne Verantwortlichen beim Anlegen: *„Wenn niemand zugewiesen ist, wirst automatisch du als Verantwortlicher eingetragen."*
26.11.4 Verknüpfte Entität gelöscht: siehe 26.3.3.
26.11.5 Erinnerungs-Texte: siehe 26.6.4.