# Vorwort und Lese-Anleitung ## Was ist HiveGrid 2.0? HiveGrid 2.0 ist eine **Software-Plattform für Handwerksbetriebe**: speziell aufgesetzt für SHK-Betriebe (Sanitär, Heizung, Klima). Sie bündelt das, was heute typischerweise auf fünf bis sieben verschiedene Werkzeuge verteilt ist: - **CRM und Vertrieb** (heute: HubSpot) - **Mitarbeiter-Kommunikation und HR** (heute: Quiply) - **Bestands-ERP** (heute: KWP, bleibt, wird angebunden) - **Workflow-Automatisierung** (heute: Zapier, n8n, Supabase) - **Telefonie** (heute: AirCall, bleibt, wird angebunden) - **Email und Kalender** (heute: Google Workspace, bleibt, wird angebunden) - **Angebot und Signatur** (heute: PandaDoc, bleibt, wird angebunden) Geerkens ist der **Erstkunde und Referenz-Partner** für Phase 1. Die Plattform wird so gebaut, dass sie für Geerkens am Tag der Live-Schaltung wirklich produktiv nutzbar ist, und gleichzeitig modular genug, dass weitere SHK-Betriebe und später andere Gewerke (Maler, Elektro) darauf aufgenommen werden können. ## Warum dieses Pflichtenheft? Die letzten beiden Implementierungs-Anläufe sind an unscharfer Spezifikation gescheitert. Es gab eine Vision (97 Features, 18 Kategorien), aber keine **vertragsfähige Detail-Beschreibung**. Code wurde geschrieben, ohne dass klar war, welche Knöpfe es geben muss, welche Rollen welche Rechte haben, welche Fehlertexte angezeigt werden, was bei Doppel-Bearbeitung passiert. Dieses Pflichtenheft schließt diese Lücke. Es dokumentiert für **jedes der 35 Module** in nummerierter, klar zitierbarer Form, was die Plattform können muss. ## Wie liest man dieses Dokument? ### Aufbau Das Pflichtenheft besteht aus drei Hauptteilen: 1. **Rahmen** (Sie lesen ihn gerade): Vision, USP-Säulen, Architektur-Vorschriften, Anti-Liste, Glossar. 2. **Module** (Hauptteil): 35 Module, gruppiert in sieben Implementierungs-Blöcken. Pro Modul: Was es tut, warum es wichtig ist, alle wesentlichen Anforderungen in nummerierter Form, was bewusst NICHT in Phase 1 ist, Beispiele für Klartext-Fehlertexte. 3. **Anhang**: Geparkte Themen (Pricing, Migration), Verifikations-Workflow, Verweise auf die technischen Detail-Spezifikationen. ### Nummerierungs-Schema Jeder Punkt im Pflichtenheft hat eine eindeutige Adresse: > **Beispiel: „M17.5.2"** > - **M17** = Modul 17 (Automation Engine) > - **5** = fünfter inhaltlicher Abschnitt im Modul > - **2** = zweiter Punkt in diesem Abschnitt So kann jeder Punkt bei der Durchsprache direkt benannt werden: *„Bei M17.5.2 stimmt was nicht, wir brauchen das Limit anders."* ### Was bedeutet „Phase 1" und was nicht? **Phase 1** = das, was zum Cloud-Launch live ist und Geerkens produktiv nutzen kann. Auf diesem Pflichtenheft. **Phase 2** = nach erfolgreichem Geerkens-Launch, mit zahlenden Folge-Kunden. Kein Bestandteil dieses Vertrags. **Anti-Liste** = explizit ausgeschlossen, auch nicht in Phase 2 (z. B. eigenes Rechnungs-Modul, Marketing-Plattform, eigene CMS-/Sites-Engine). Begründung pro Punkt unter Abschnitt „Was bewusst NICHT gebaut wird". ### Was tun bei Unstimmigkeiten? 1. **Punkt zitieren** (z. B. „M04.6.3 ist mir zu eng"). 2. **Korrektur-Vorschlag** dazu schreiben (Klartext, kein Layout). 3. **Bis zur Sign-off-Runde** sammeln, danach gehen Änderungen über die Change-Request-Liste (siehe Verifikations-Workflow im Anhang). ## Glossar Damit es bei der Durchsprache keine Begriffsverwirrung gibt: | Begriff | Bedeutung in diesem Dokument | |---|---| | **Mandant** | Eine Handwerksfirma als Kunde von HiveGrid (Geerkens ist ein Mandant). Trennscharf zu „Plattform-Admin", der HiveGrid selbst betreibt. | | **Workspace** | Synonym zu Mandant, der abgeschotteten Daten-/Konfigurations-Bereich pro Firma. | | **Tenant** | Englischer Begriff für Mandant, in technischen Texten häufig. In diesem Pflichtenheft synonym verwendet. | | **Nutzer** | Eine einzelne Person (Mitarbeiter), die sich an HiveGrid anmeldet. | | **Rolle** | Vorgefertigtes Berechtigungspaket (z. B. „Geschäftsführer", „Vertriebsleiter", „Monteur"), bestimmt, was ein Nutzer darf. | | **Lead** | Eine eingehende Anfrage, die noch kein Kunde und noch kein Auftrag ist. | | **Verkaufsfall (Deal)** | Eine konkrete Verkaufschance mit Volumen und Wahrscheinlichkeit, durchläuft die Sales-Pipeline. | | **Auftrag (Projekt)** | Ein gewonnener Verkaufsfall in der Abwicklung, mit Plantafel, Aufgaben, Abnahme. | | **Pipeline** | Eine Abfolge von Stufen (z. B. „Angefragt → Besichtigt → Angebot → Verhandlung → Gewonnen"), durch die ein Verkaufsfall oder Auftrag wandert. | | **Stufe (Stage)** | Ein einzelner Schritt in einer Pipeline. | | **Automatisierung** | Eine Wenn-Dann-Regel, die ohne menschliches Zutun auf Ereignisse reagiert. | | **Auslöser (Trigger)** | Das Ereignis, das eine Automatisierung startet (z. B. „Neuer Lead eingegangen"). | | **Aktion (Action)** | Was die Automatisierung macht, wenn der Auslöser gefeuert hat (z. B. „Email senden"). | | **Vorschau (Dry-Run)** | Eine Automatisierung wird ohne echte Wirkung simuliert, der Nutzer sieht, was passieren WÜRDE, bevor er es freigibt. | | **Apps-Engine** | Die zentrale Schicht, über die alle externen Systeme (KWP, Gmail, AirCall, Legacy-Provider, ...) angebunden werden, einheitlich, austauschbar. | | **Adapter** | Die konkrete Anbindung an ein bestimmtes externes System (z. B. der KWP-Adapter). Steht hinter der Apps-Engine. | | **KWP** | Die ERP-Software, mit der Geerkens heute Aufträge und Rechnungen verwaltet. Bleibt System-of-Record für Abrechnung. | | **System-of-Record** | Das System, in dem die maßgebliche Wahrheit für ein Daten-Thema liegt. Beispiel: KWP ist System-of-Record für die Auftrags-Abrechnung; HiveGrid ist System-of-Record für CRM und Workflow. | | **DSGVO** | Datenschutz-Grundverordnung (EU). Pflicht für jede Software, die personenbezogene Daten verarbeitet. | | **EU-Stack** | Alle technischen Bestandteile (Hosting, Datenbank, KI-Anbieter) liegen ausschließlich in der EU. Marketing-Argument und DSGVO-Erleichterung. | | **KI / LLM** | Sprachmodelle (wie ChatGPT, aber bei uns: europäische Anbieter wie Mistral). Werden für Klartext-Hilfe, Lead-Zusammenfassungen und Automatisierung-Erstellung verwendet. | | **Klartext-Diagnostik** | Pflicht-Prinzip: Statt kryptischer Fehlermeldungen („HTTP 401") immer ein Satz, den ein Nicht-Techniker versteht („Die Verbindung zu KWP ist abgelaufen, bitte neu anmelden"). | | **Audit-Log** | Lückenlose Protokollierung aller schreibenden Vorgänge, wer hat wann was geändert. | | **Permissions** | Die feinen Einzelrechte, aus denen die Rollen zusammengesetzt werden. Im Pflichtenheft meist als „Berechtigungen" beschrieben. | | **Capacitor** | Technische Hülle, mit der die Web-App zusätzlich als iOS- und Android-App in den App-Store kommt. Keine zweite Codebasis. | | **Subframe** | Das Design-System, mit dem die Oberflächen der Plattform gebaut werden (technische Umsetzungsentscheidung, Noah betrifft das nur indirekt über das einheitliche Look & Feel). | ## Schnell-Übersicht: Die 35 Module in einem Satz | # | Modul | Was es leistet | |---|---|---| | M01 | CRM-Kern | Kontakte und Firmen verwalten, HubSpot-CRM-Ablösung | | M02 | Lead-Inbox | Eingehende Anfragen aus allen Kanälen sammeln und qualifizieren | | M03 | Sales-Pipeline | Verkaufsfälle bis zum „Gewonnen" durch konfigurierbare Pipelines führen | | M04 | Auftrags-Pipeline | Gewonnene Verkaufsfälle abwickeln, Plantafel, Aufgaben, Abnahme (Geerkens-Kern) | | M05 | Form-Builder | Universelles Formular-Werkzeug, für Webseiten-Forms, Acceptance-Signaturen, Datenerfassung | | M06 | Booking | Online-Termin-Buchungsseiten für Kunden | | M07 | Angebot + Signatur | PandaDoc-Anbindung für Angebote und elektronische Unterschrift | | M09 | Email-Inbox | Posteingang mit Sync zu Gmail/Outlook, eigene Sende-Domain | | M10 | Email-Marketing | Newsletter und Sequenzen mit DSGVO-konformer Listen-Verwaltung | | M12 | Telefonie | AirCall-Anbindung mit Click-to-Call und KI-Transkription | | M13 | Team-Chat | Interne Kommunikation auf Projekt-, Gruppen- und Direktnachrichten-Ebene | | M14 | HR-Hub | Mitarbeiter-Plattform, Quiply-Komplett-Ablösung | | M15 | Customer-Portal | Endkunden sehen Status ihrer Aufträge und können Dateien hochladen | | M17 | Automation Engine | Workflow-Automatisierung mit KI-Erstellung, Zapier-Ablösung (USP-Säule) | | M18 | KI-Layer | Zentrale KI-Schicht, EU-Modelle (Mistral, Scaleway), DSGVO-Versprechen | | M19 | KWP-Integration | Anbindung der Geerkens-Bestands-ERP, erste konkrete App auf Apps-Engine | | M20 | Dashboard | Geschäftsführer-KPIs mit Drill-Down zu Detail-Listen | | M21 | Audit-Log | Wer hat wann was geändert, 24 Monate Aufbewahrung | | M22 | Notifications | Push, Email, In-App, mit Anti-Spam-Bündelung und Ruhezeiten | | M23 | Files | Dokumenten-Ablage auf europäischen Servern (Scaleway) | | M24 | Globale Suche | Stichwort-Suche und KI-Suche über alle Module hinweg | | M25 | Calendar-Sync | Bidirektionale Synchronisation mit Google und Microsoft | | M26 | Tasks | Aufgaben mit Verknüpfung zu Kontakten, Verkaufsfällen, Aufträgen | | M27 | Auth, Mandanten, Rollen | Anmeldung, Mandanten-Trennung, 7 Rollen, 2-Faktor-Authentisierung | | M28 | Subscriptions / Billing | Legacy-Provider-Anbindung, Seat-Modell, Trial, Read-Only-Downgrade | | M29 | Onboarding | Mandanten-Anlage mit Branchen-Wahl, Demo-Daten, Nutzer-Einladung | | M30 | i18n | Mehrsprachigkeit, Phase 1 nur Deutsch, vorbereitet für DeepL-Pipeline | | M31 | Branding | Light/Dark-Mode in Phase 1, alles weitere Phase 2 | | M32 | Feature-Flags | Schalter, mit denen wir Features pro Mandant gezielt aktivieren | | M33a | Apps-Engine | Foundation für alle externen Anbindungen (USP-Säule) | | M34 | Public API | Lese-API und Webhooks für Drittanbieter | | M35 | DSGVO-Export / Löschung | Datenexport pro Person, Account-Löschung, DSGVO- und Apple-Pflicht | | M36 | Mobile-App | Capacitor-Wrapper für iOS/Android mit Offline-Modus | | M37 | Plattform-Admin | Bereich für den HiveGrid-Betreiber (uns) zur Mandanten-Verwaltung | | M38 | Help-Center | Öffentliche Hilfe-Artikel, 10 bis 20 Stück in Phase 1 | | M39 | Help-Desk | Internes Ticket-/Feedback-System für Support |