Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/pflichtenheft/01-vorwort.md
T

10 KiB

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, Stripe, ...) 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 Stripe-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