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:
- Rahmen (Sie lesen ihn gerade): Vision, USP-Säulen, Architektur-Vorschriften, Anti-Liste, Glossar.
- 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.
- 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?
- Punkt zitieren (z. B. „M04.6.3 ist mir zu eng").
- Korrektur-Vorschlag dazu schreiben (Klartext, kein Layout).
- 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 |