132 lines
10 KiB
Markdown
132 lines
10 KiB
Markdown
# 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 |
|
|
|