Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,146 @@
# Apple App Store Rules — Briefing fuer HiveGrid (B2B-SaaS-CRM, Stand Mai 2026)
Kontext: HiveGrid ist ein B2B-SaaS-CRM (Multi-Tenant) fuer Handwerksbetriebe. Web-App ist Hauptzugang. Nativer Wrapper (Capacitor/React Native) fuer App-Store-Praesenz erwogen. Subscriptions zahlt der Betrieb extern (Web/Rechnung), Endnutzer (Monteure/Buero) loggen sich nur ein.
---
## 1. In-App Purchases (IAP) — fuer HiveGrid NICHT Pflicht (bedingt)
- **Grundregel 3.1.1:** Digitale Goods/Services in der App muessen via Apple-IAP (15-30% Provision) verkauft werden.
- **Relevante Ausnahme — Guideline 3.1.3(c) "Enterprise Services":** Wenn die App ausschliesslich an Organisationen/Gruppen fuer deren Mitarbeiter verkauft wird (typisches B2B-SaaS-Modell), darf extern abgerechnet werden. HiveGrid faellt klar darunter.
- **Zusaetzlich 3.1.3(b) "Multiplatform Services":** Login fuer eine bereits ausserhalb der App (Web) erworbene Subscription ist erlaubt — solange die App **keinen Link, Button oder Hinweis enthaelt, der auf externe Bezahlung steert**.
- **Was in der App NICHT erlaubt ist (ausserhalb EU/USA):** Pricing-Pages, "Upgrade your plan"-Buttons, Links zur Web-Bezahlung, "Sign up at hivegrid.cloud"-Hinweise. Nur reiner Login-Screen ist sicher.
- **EU-DMA-Update (Juni 2025):** In der EU duerfen Apps inzwischen aktiv auf externe Bezahloptionen verlinken (Core Technology Commission 5%, optionales Modell). Fuer HiveGrid **nicht relevant**, da gar keine Consumer-Bezahlung in der App stattfindet — die DMA-Lockerung betrifft primaer Apps die selbst IAP umgehen wollen.
- **Fazit:** Nicht-Pflicht, sofern strikt nur Login + App-Funktionen, keinerlei Pricing-/Upsell-Inhalte. Reject-Risiko bei jedem "Subscribe"-Hinweis.
Quellen:
- [App Review Guidelines (Apple)](https://developer.apple.com/app-store/review/guidelines/)
- [Apple Forum: 3.1.3(c) Enterprise Services](https://developer.apple.com/forums/thread/666450)
- [Forum-Thread: B2B SaaS Reject 3.1.1](https://developer.apple.com/forums/thread/811018)
- [iOS IAP Compliance Guide 2025 (Twinr)](https://twinr.dev/blogs/ios-in-app-purchase-compliance/)
- [DMA Update Juni 2025 (RevenueCat)](https://www.revenuecat.com/blog/growth/apple-eu-dma-update-june-2025/)
---
## 2. Sign in with Apple — fuer HiveGrid NICHT Pflicht (bedingt)
- **Grundregel 4.8:** Wer Drittanbieter-Login (Google, Facebook, Microsoft) als **primaeren** Auth-Mechanismus anbietet, MUSS Sign in with Apple gleichwertig anbieten.
- **Klare Ausnahme:** "Education, enterprise, or business apps that require the user to sign in with an existing education or enterprise account" — also genau HiveGrids Modell (Mitarbeiter logged sich mit Firma-Credentials ein).
- **Weitere Ausnahme:** Apps die ausschliesslich eigene Account-Systeme nutzen (Email + Passwort) brauchen kein Sign in with Apple.
- **Knifflig:** Wenn HiveGrid auch Google/Microsoft-OAuth fuer "regulaere" Endnutzer (nicht nur SSO via Tenant) anbietet, koennte ein Reviewer das als "primaeres Auth" werten. Dann **doch Pflicht**.
- **Magic-Link/Email-Only:** Reicht aus, um die Anforderung zu umgehen — keine Apple-Login-Pflicht.
- **Fazit:** Nicht-Pflicht, wenn HiveGrid den Login als "Enterprise/Tenant-Login" framed. Pflicht, wenn Google-OAuth als allgemeiner Consumer-Login angeboten wird.
Quellen:
- [WorkOS: Sign in with Apple 2025](https://workos.com/blog/apple-app-store-authentication-sign-in-with-apple-2025)
- [Apple Forum: Is SIWA mandatory?](https://developer.apple.com/forums/thread/124006)
- [Apple Developer Docs: Authenticating with SIWA](https://developer.apple.com/documentation/signinwithapple/authenticating-users-with-sign-in-with-apple)
---
## 3. Face ID / Touch ID Integration
- **Apple stellt keine Pflicht** zu Biometrie-Login. Es ist optional, aber dringend empfohlen fuer eine "app-like experience" (s. Punkt 5 / Guideline 4.2).
- **Capacitor:** Plugins wie `@aparajita/capacitor-biometric-auth` oder `capacitor-face-id` wrappen Apples `LocalAuthentication`-Framework. Integration: ~1-2 Tage. Kein Problem mit Apple Review.
- **React Native:** `react-native-keychain` + `expo-local-authentication` (bei Expo) — vergleichbar simpel.
- **Echt nativ (Swift):** Direkt `LocalAuthentication.framework`, ~paar Stunden Aufwand.
- **Apple-Anforderungen:** `NSFaceIDUsageDescription` im Info.plist (Pflicht-String warum Face ID genutzt wird), Fallback-Mechanismus (PIN/Passwort) muss existieren.
- **Fazit:** Nicht-Pflicht. Mit Capacitor problemlos machbar (~1-2 Tage). Hilft enorm gegen Guideline 4.2 Reject (s.u.).
Quellen:
- [Apple Dev: LocalAuthentication](https://developer.apple.com/documentation/localauthentication/logging-a-user-into-your-app-with-face-id-or-touch-id)
- [Capacitor Biometric Auth Plugin](https://github.com/aparajita/capacitor-biometric-auth)
---
## 4. Sonstige Huerden fuer B2B-SaaS-CRM
### 4.1 Account-Loeschung in der App — PFLICHT seit 30.06.2022 (Guideline 5.1.1(v))
- Jede App mit Account-Erstellung muss In-App-Loeschung anbieten — auch wenn Account ausserhalb erstellt wurde.
- Deaktivieren reicht nicht, alle Personendaten muessen geloescht werden.
- Ausnahme fuer "highly regulated industries" (5.1.1(ix)) — Handwerk **faellt nicht** darunter.
- Praktisch: Settings-Screen mit "Konto loeschen"-Button, der Backend-Endpoint anstoesst. Fuer Multi-Tenant: kann sein dass nur "Mitarbeiter aus Tenant entfernen" gemeint ist, aber Apple ist da streng — User-eigene Daten muessen weg.
- [Apple: Account deletion](https://developer.apple.com/support/offering-account-deletion-in-your-app/)
### 4.2 Privacy Manifest — PFLICHT seit 01.05.2024
- `PrivacyInfo.xcprivacy` muss alle gesammelten Daten + Drittanbieter-SDK-APIs deklarieren.
- Apple lehnt 12% der Submissions in Q1 2025 wegen fehlerhafter Manifests ab.
- Capacitor/Expo-Communities haben i.d.R. fertige Manifests — trotzdem pruefen.
- App Tracking Transparency (ATT) Prompt nur wenn echtes Tracking stattfindet — fuer ein internes B2B-Tool i.d.R. nicht noetig.
- [Apple Privacy Manifest Docs](https://developer.apple.com/documentation/bundleresources/privacy-manifest-files)
### 4.3 TestFlight & Sandbox
- Internal Testing: 100 Tester, sofort verfuegbar, keine Apple-Pruefung.
- External Testing: 10.000 Tester, **erfordert App-Review** (leichter als Production, ~1-2 Tage).
- Sandbox-Accounts fuer IAP-Tests in App Store Connect anlegen — fuer HiveGrid nicht relevant da kein IAP.
### 4.4 Typische Reject-Gruende fuer B2B-Apps
1. **Guideline 2.1 (App Completeness):** ~40% aller Rejects. Reviewer kann nicht einloggen → bricht ab. **Demo-Account in Review Notes ist kritisch.**
2. **Guideline 4.2 (Minimum Functionality):** "Webview-Wrapper" (s. Punkt 5).
3. **Guideline 3.1.1 (IAP):** Schon ein "Upgrade auf Pro"-Button im UI loest Reject aus.
4. **Guideline 5.1.1 (Privacy):** Fehlende Account-Loeschung, kein Privacy-Manifest, fehlende Privacy-Policy-URL.
5. **Guideline 2.3 (Metadata):** Screenshots zeigen Features die in der App nicht funktionieren.
Quellen:
- [NextNative: App Store Review Guidelines 2025](https://nextnative.dev/blog/app-store-review-guidelines)
- [Twinr: Rejection Reasons 2025](https://twinr.dev/blogs/apple-app-store-rejection-reasons-2025/)
- [RevenueCat: Ultimate Guide to Rejections](https://www.revenuecat.com/blog/growth/the-ultimate-guide-to-app-store-rejections/)
---
## 5. Capacitor vs React Native vs Expo vs nativ — und Guideline 4.2
- **Apple ist agnostisch ggue. Framework**, aber sehr empfindlich gegenueber "Webview-Wrappern" ohne nativen Mehrwert (Guideline 4.2 "Minimum Functionality").
- **Was sicher rejected wird:** Pure WebView, die nur die mobile Website laedt, ohne native Features.
- **Was 2026 minimal verlangt wird (Best Practice, nicht alle gleichzeitig):**
- Native Navigation (kein Hamburger-Menue im Webview)
- Push Notifications (echt genutzt — nicht nur "registriert")
- Mind. ein Device-Feature: Kamera (Foto vom Auftrag), Biometrie (Login), Geolocation (Einsatzort), Offline-Mode (mind. teilweise)
- App-Icons, Splash-Screens, vernuenftige Tab-Bar
- **Capacitor:** Webview-basiert aber mit nativen Plugins. Gut geeignet, wenn Web-App schon existiert (HiveGrid-Fall). Reject-Risiko **nur**, wenn Native Features fehlen — Framework selbst ist kein Problem.
- **React Native:** Native UI-Components, leichter durch 4.2 zu kommen, aber doppelter Code-Aufwand vs. Capacitor.
- **Expo:** React-Native + Managed Workflow + EAS Build. 2026 die beliebteste Variante fuer kleinere Teams. Privacy Manifest weitgehend automatisiert.
- **Echt nativ (Swift/SwiftUI):** Maximale Akzeptanz, ~3-5x Aufwand vs. Capacitor.
- **Empfehlung 2026:** Capacitor ist OK fuer HiveGrid, **wenn** mindestens 2-3 native Features (Push, Biometrie, Kamera fuer Auftrags-Fotos) implementiert werden.
Quellen:
- [Mobiloud: Webview App Rejection](https://www.mobiloud.com/blog/app-store-review-guidelines-webview-wrapper)
- [iOS Submission Guide: 4.2](https://iossubmissionguide.com/guideline-4-2-minimum-functionality/)
- [Capacitor vs React Native 2025](https://nextnative.dev/blog/capacitor-vs-react-native)
---
## 6. Google Play Store — deutlich einfacher
- **Keine Sign-in-with-Google-Pflicht** analog zu Apples SIWA.
- **Account-Loeschung** ebenfalls Pflicht seit Mai 2024 — aber Google akzeptiert auch externe Loesch-URL (Apple verlangt In-App).
- **In-App-Billing:** Theoretisch aehnliche Regel, aber in der Praxis weniger streng durchgesetzt fuer B2B. Seit Epic-vs-Google (Okt 2025, USA) duerfen externe Bezahllinks in den USA frei verwendet werden. EU: External Offers Program seit 2025.
- **Webview-Apps:** Google ist toleranter — "Minimum Functionality"-Aequivalent (Spam Policy) wird selten gegen B2B-Wrapper gezueckt.
- **Data Safety Form** (analog Privacy Manifest) — etwas einfacher als Apples Manifest.
- **Fazit:** Google Play ist klar einfacher. Tipp: Erst Google Play launchen (lower risk), dann Apple.
Quellen:
- [Google Play External Billing 2025](https://solidgate.com/blog/external-billing-google-play/)
- [Android SaaS Subscriptions Guide 2025](https://dev.to/krlz/android-saas-app-with-subscriptions-complete-2025-guide-52ak)
---
## Empfehlungen fuer HiveGrid
1. **IAP komplett vermeiden:** App nur mit Login-Screen starten. **Keine** Pricing-, Upgrade-, "Plan waehlen"-Inhalte in der App. Subscription-Mgmt strikt im Web-Dashboard. Im App-Store-Listing als "B2B Enterprise Tool" positionieren — Reviewer-Hinweis in den App Review Notes: "Enterprise SaaS, sold directly to organizations, all payments handled outside the app per Guideline 3.1.3(c)".
2. **Sign in with Apple sparen:** Login-Screen sollte als "Firma-Login" auftreten (z.B. "Mit Firma-Account anmelden"). Wenn Google/Microsoft-OAuth, dann als "Enterprise SSO" framen, nicht als allgemeiner Consumer-Login. Magic-Link/Email-Only ist die sicherste Variante zum Umgehen.
3. **Capacitor + native Features:** Mind. 3 native Funktionen: Push Notifications (Auftrag-Updates fuer Monteure), Biometrie-Login (Face ID), Kamera (Fotos vom Einsatz). Damit ist 4.2 sicher gepasst.
4. **Account-Loeschung jetzt einplanen:** Endpoint im Backend, Settings-Screen "Konto loeschen" — auch fuer Multi-Tenant. Loescht User-Personendaten, behaelt anonymisiert was rechtlich noetig ist (Audit-Trail).
5. **Privacy Manifest sauber:** `PrivacyInfo.xcprivacy` mit allen Capacitor-Plugin-Reasons. Privacy-Policy-URL im App Store Connect setzen.
6. **Reviewer-Demo-Account vorbereiten:** Dedizierter Tenant "apple-review" mit Mitarbeiter-Login, Beispieldaten, **immer** in App Review Notes mitliefern. Reduziert 2.1-Reject-Risiko massiv.
7. **Launch-Strategie:** Erst Google Play (niedrigere Huerde, schneller Feedback) → dann Apple. Bei Apple unbedingt mit TestFlight (External Testing) ein paar Wochen vor Production-Submit testen — gleiches Review-Team, niedrigerer Stress.
---
**Unklarheit (ehrlich):** Ob ein Reviewer Google-OAuth als "Enterprise SSO" (kein SIWA noetig) oder als "Consumer Social Login" (SIWA Pflicht) wertet, ist Einzelfall. Im Zweifel SIWA mit-implementieren — Aufwand ~1 Tag.
@@ -0,0 +1,563 @@
# HiveGrid Codebase Feature-Inventur
Quelle: `/Users/raffaelsheikh/Documents/GitHub/archive/hivegrid-cloud`
Stand: Repo-Snapshot (letzte Commits Mai 2026, Codebasis verworfen wegen Komplexitaet/Spaghetti).
> Diese Inventur listet was die Codebasis in Form von Code, Routes, Schemas und Modul-Verzeichnissen enthielt — **nicht** was reibungslos funktionierte. Reifegrad-Einschaetzung beruht auf Vorhandensein/Tiefe der Files, nicht auf Lauffaehigkeit.
---
## Tech-Stack-Kurzuebersicht
React Router v7 (Remix-basiert, SSR + Client Hydration) auf Node.js 20 / pnpm 10. ORM: Prisma mit Multi-File-Schema (~50 `.prisma`-Dateien). DB: PostgreSQL 16 mit pgvector. Cache/Queue: Redis 7 + BullMQ. Frontend: Tailwind CSS, Headless UI, Subframe-UI-Components, Lucide/Heroicons, react-i18next. AI: AI SDK (Anthropic, OpenAI, OpenRouter, Scaleway, Whisper). Tests: Vitest + Playwright (inkl. VRT). Deployment: PM2 mit 4 Prozessen (`web`, `api`, `worker`, `scheduler`), Caddy als Reverse Proxy, Scaleway-Infrastruktur, Docker Compose. Multi-Tenant via Postgres Row-Level-Security (Dual-DB-URLs). Observability: Sentry. Geplante Mobile-App: Expo (nur Skeleton vorhanden, nicht ausgebaut).
---
## Domaenen-Modell (Entities)
**Account / Auth / Tenant**
- `User` — globale Login-Identitaet (email/password, oauth)
- `AdminUser` — globaler Plattform-Admin (super-admin)
- `Tenant` — Mandant (Handwerksbetrieb), inkl. `TenantType`
- `TenantUser` — Mitgliedschaft eines Users in einem Tenant (Rolle, Status)
- `TenantUserInvitation` — Email-Einladung
- `Registration`, `Blacklist`, `TenantIpAddress`, `AccountDeletionRequest`
- `Role`, `Permission`, `RolePermission`, `UserRole`, `Group`, `GroupUser` — RBAC
- `ApiKey`, `ApiKeyLog` — API-Key-Auth fuer extern
**CRM**
- `Company` — Firmen-Stammdaten (B2B-Kunde)
- `Contact` — Personen (Privat/Ansprechpartner), `ContactHistory` (Aktivitaeten)
- `Pipeline`, `PipelineStage` — konfigurierbare Sales-Pipelines
- `Deal`, `DealActivity` — Deal-Karten + Aktivitaets-Log
- `DealForm` — verknuepfte Form-Submissions
- `HiveNumberSeq` — fortlaufende CRM-Nummern
**Projekt-/Auftragsmanagement**
- `ProjectPipeline`, `ProjectPipelineStage` — Auftragspipelines
- `Project`, `ProjectActivity`, `ProjectMember` — Auftraege + Beteiligte
- `AcceptanceProtocol` — digitales Abnahmeprotokoll
- `Task` — Aufgaben (mit Zuweisung, Deadline)
- `ProjectTemplate` — Projekt-Vorlagen
- `ProjectForm` — am Projekt haengende Formulare
- `ScheduleEntry` — Plantafel-/Termin-Eintrag
**Automation Engine**
- `AutomationRule`, `AutomationExecution`, `AutomationCredential`
**Termine / Booking**
- `BookingPage`, `BookingPageProvider` — Calendly-aehnliche oeffentliche Buchungsseite
- `Appointment` — Termin
- `AvailabilityRule`, `AvailabilityException` — Verfuegbarkeiten
**Kalender-Integration**
- `CalendarEvent`, `CalendarEventMapping`, `CalendarSyncCursor`, `CalendarWebhookEvent` (Google + Microsoft)
**Email**
- `TenantInboundAddress`, `Email`, `EmailRead`, `EmailCc`, `EmailAttachment`, `EmailSender` — Inbound-Mailbox
- `Campaign`, `OutboundEmail`, `OutboundEmailOpen`, `OutboundEmailClick` — Email-Marketing
- `EmailIntegrationMailbox`, `EmailIntegrationMessage`, `EmailIntegrationSyncCursor`, `EmailIntegrationWebhookEvent` — externe Mail-Sync (Gmail/Outlook)
- `TenantSendingDomain` — eigener Absender-Domain mit DKIM
**Dokument-Signatur (PandaDoc/DocuSign)**
- `SignatureProviderConnection`, `DealSignatureDocument`, `DealSignatureSigner`, `DealSignatureStatusTransition`, `SignatureWebhookEvent`
**Telefonie (Aircall/Sipgate)**
- `TelephonyConnection`, `TelephonyCallSession`, `TelephonyWebhookEvent`
**WhatsApp**
- `WhatsAppBusinessAccount`, `WhatsAppChatMessage`, `WhatsAppOptIn`, `WhatsAppTemplate`, `WhatsAppQuickReply`, `WhatsAppMessageLog` (Meta WABA + Unipile)
**Team-Chat (intern)**
- `TeamChat`, `TeamChatMember`, `TeamChatMessage`, `TeamChatPinnedMessage`, `TeamChatReaction`
**Form Builder**
- `Form`, `FormSubmission`, `FormLink`, `FormsTag`, `FormTag`, `FormAction`, `FormActionLog`, `FormLog`, `FormFile`
**Kundenportal**
- `Portal`, `PortalUser`, `PortalPage`, `PortalUserRegistration`
- `CustomerPortalAccount`, `CustomerPortalMagicLinkToken`, `CustomerPortalSession`, `CustomerPortalProjectAccess`, `CustomerPortalProjectDocument`
- `PortalSubscription*` — Abo-Verwaltung im Portal
**HR-Hub / Mitarbeiterplattform**
- `HrAnnouncement` (+ `Read`/`Reaction`/`Comment`)
- `HrRequest`, `HrRequestTemplate` — generische Antragsformulare
- `HrEmployeeDocument` — Mitarbeiter-Dokumente
- `HrLocation` — Standorte
- `HrResource`, `HrQuickLink`
- `HrSurvey`, `HrSurveySubmission` — Umfragen
- `EmployeePayslip`, `EmployeeUploadReminder`, `EmployeeUploadReminderDispatch`
- `EmployeePasswordSafeEntry`, `EmployeePasswordSafeVault`
- `EmployeeVacationRequest`, `EmployeeSickLeaveReport`
**Knowledge Base / Wiki**
- `KnowledgeBase`, `KnowledgeBaseCategory`, `KnowledgeBaseCategorySection`
- `KnowledgeBaseArticle`, `KnowledgeBaseArticleEntityLink`, `KnowledgeBaseRelatedArticle`
- `KnowledgeBaseViews`, `KnowledgeBaseArticleViews`/`Upvotes`/`Downvotes`
**Help-Desk / Support**
- `Feedback`, `Survey`, `SurveyItem`, `SurveySubmission`, `SurveySubmissionResult`
- `SupportChatThread`, `SupportChatMessage`
**Files / Storage**
- `File`, `FileUploadProgress`, `FileChunk`
**Analytics**
- `AnalyticsSettings`, `AnalyticsUniqueVisitor`, `AnalyticsPageView`, `AnalyticsEvent`
**KI / AI**
- `Chat`, `ChatMessage`, `ChatMessagePart` — Conversations mit AI-Assistent
- `AiSettings`, `TenantAgentSettings`, `AiCredits`, `AiTokenUsage`
- `HelpArticleEmbedding`, `TenantEmbedding` — RAG-Vectors (pgvector)
- `GeneratedObject` — strukturierte AI-Outputs
**Tenant-Assistant ("HiveMind")**
- `TenantAssistantConversation`, `TenantAssistantGroundingReference`
- `UserAIMemory`, `TenantAIKnowledge`
- `HiveMindScheduledAction`, `HiveMindActionLog`, `HiveMindCustomTool`, `HiveMindInsight`
**Prompt-Flows**
- `PromptFlowGroup`, `PromptFlow`, `PromptFlowInputVariable`, `PromptTemplate`, `PromptFlowOutput`, `PromptFlowOutputMapping`, `PromptFlowExecution`, `PromptTemplateResult`
**Apps Engine / App-Catalog**
- `App`, `DataConnection`, `AppSyncRun`, `AppSyncRunLog`, `AppSyncItem`
- `CommunityApp`, `CommunityAppInstall` — Community-Marketplace
- `TemplateMarketplaceDefinition`, `TemplateMarketplacePurchase`, `TemplateMarketplaceInstall`
**KWP-Integration (Handwerks-ERP)**
- `KwpProjectQueue`, `KwpProjectNumberSequence`, `KwpProjectNumberReservation`
- `KwpApiKey`, `KwpSettings`, `KwpRegistry`, `KwpErrorReport`, `KwpDocument`
**Subscriptions / Billing**
- `SubscriptionProduct`, `SubscriptionPrice`, `SubscriptionFeature`
- `SubscriptionUsageBasedPrice`, `SubscriptionUsageBasedTier`
- `TenantSubscription`, `TenantSubscriptionProduct`, `TenantSubscriptionProductPrice`, `TenantSubscriptionUsageRecord`
- `CheckoutSessionStatus`, `Credit`
**API & Webhooks**
- `IntegrationApiRequest`, `WebhookSubscription`, `WebhookDelivery`, `WebhookDeliveryAttempt`, `IncomingWebhookIngestion`
- `Event`, `EventWebhookAttempt` — interne Event-Bus-artige Persistenz
**Onboarding / Demo**
- `Onboarding`, `OnboardingFilter`, `OnboardingStep`, `OnboardingSession`, `OnboardingSessionAction`, `OnboardingSessionFilterMatch`, `OnboardingSessionStep`
- `OnboardingDemoProvisioning`, `OnboardingInvitationDispatch`
**Sonstiges**
- `Page`, `PageBlock`, `PageMetaTag` — CMS/Marketing-Seiten
- `Site`, `MySiteDemoSubmission`
- `BlogCategory`, `BlogTag`, `BlogPost`, `BlogPostTag` — Blog
- `Widget`, `DashboardLayout` — konfigurierbare Dashboards
- `AuditLog` — Audit-Trail
- `FeatureFlag`, `FeatureFlagFilter`
- `NotificationPreference`, `NotificationDevice` (Push)
- `IpAddress`, `IpAddressLog`
- `GdprExportJob` — DSGVO-Datenexport
---
## Feature-Module (sortiert nach Bedeutung)
### CRM-Kern (Kontakte, Companies, Deals, Pipelines)
- **User-Sicht:** Kontakt- und Firmenverzeichnis, Deal-Pipeline mit Kanban + Listen-View, Deal-Detailseite mit Aktivitaets-Historie, Lead-Inbox, Statistiken zu Leads, Lead-CSV-Import.
- **Routes:** `/$tenant/contacts` (Index, New, Detail), `/$tenant/contacts/companies` (Index, Detail, New), `/$tenant/deals` (Index/Kanban, Liste, Detail, New, Archive), `/$tenant/leads` (Inbox, Statistiken, Import).
- **Operationen:** CRUD Kontakte/Firmen, CRM-Sequenznummern, Deal-Stage-Aenderung mit Side-Effects (Automationen), Aktivitaets-Logging, Duplikat-Erkennung (`api.contacts.duplicates`), Kontakt-Suche (`api.contacts.search`), Activity-Timeline.
- **Reifegrad:** vollstaendig.
### Projekt-/Auftragsmanagement
- **User-Sicht:** Projektpipeline (Kanban), Projekt-Detail mit Members/Schedule/Tasks/Forms, Abnahmeprotokoll-Erstellung, Plantafel (Ressourcen-/Termin-Planung), Archivansicht.
- **Routes:** `/$tenant/projects` (Index, Detail, New, Archive, Plantafel, Acceptance, Acceptance/new).
- **Operationen:** Projekt-Erstellung aus gewonnenem Deal (Handoff-Service), kombinierte Activity-Timeline, Abnahmeprotokoll mit Kunden-Signatur, Projektmitglieder-Verwaltung, Projekt-Templates, Projekt-Archivierung.
- **Reifegrad:** vollstaendig (Plantafel, Acceptance, Handoff sind alle implementiert).
### Automation Engine ("Workflow Studio")
- **User-Sicht:** Tab-basierte Studio-UI (Workflows-Liste / Flow-Editor / API+Webhooks / Execution Logs), Flow-Canvas (visuell), Workflow-Templates, Trigger->Action-Regeln.
- **Routes:** `/$tenant/automations`, Audit-/Execution-Logs.
- **Operationen:** Trigger-/Action-Registry mit ~50 Triggern und ~45 Actions (siehe Liste unten), Loop-Guard, Metering, BullMQ-Queue + Worker, Scheduled-Rule-Worker, Stage-Stuck-Eskalation (cron im Scheduler), Credentials-Verwaltung pro Tenant.
- **Reifegrad:** sehr ausgepraegt (eine der reifsten Module).
### Team-Chat
- **User-Sicht:** Chat-Index mit Threads, Chat-Detail, neuer Chat, Pinned Messages, Reactions, Threads (`chat.$id.thread.$threadId`).
- **Routes:** `/$tenant/chat`, `/$tenant/chat/$id`, `/$tenant/chat/new`, Thread-Detail.
- **Operationen:** Channel-Mitgliederverwaltung, Datei-Upload im Chat, Link-Preview, Media-Service, WebSocket-Server (`app/modules/chat/ws`).
- **Reifegrad:** vollstaendig (mit Pinned, Reactions, Threads).
### Email-Inbox & Email-Marketing
- **User-Sicht:** Tenant-Mailbox (eingehende Mails verknuepft mit Kontakten/Deals), Marketing-Kampagnen-Builder, Sender-Verwaltung, Activity-Tracking (Open/Click).
- **Routes:** `/$tenant/emails`, `/$tenant/emails/$id`, `/$tenant/email-marketing` (Index, Activity, Senders, Campaigns Index/Detail/New).
- **Operationen:** Inbound-Webhooks (MailerSend, Postmark), eigene Sending-Domain mit DKIM (`email-domain`), Outbound-Tracking, Campaign-Scheduling-Cron (`api.email-marketing.cron`), Linking zu Kontakten/Deals.
- **Reifegrad:** vollstaendig.
### WhatsApp-Integration
- **User-Sicht:** WhatsApp-Inbox (`/$tenant/whatsapp`), Chat pro Telefonnummer (`/$tenant/whatsapp/$phone`), Connect-Flow.
- **Operationen:** Provider-Abstraktion (Meta WABA + Unipile), Templates, Quick-Replies, Opt-Ins, Avatare/Media-Endpoints, Webhook-Handling, Sync-Service.
- **Reifegrad:** vollstaendig (zwei Provider, Templates, Sync).
### Telefonie-Integration
- **User-Sicht:** Click-to-Call aus Deal/Contact, Anruf-Logs in Activity-Stream, Settings fuer Telefonie unter Settings/Integrations.
- **Operationen:** Aircall- und Sipgate-Adapter, Webhook-Handler, Call-Log-Sync, automatisches Verknuepfen von Anrufen mit Kontakten/Deals.
- **Reifegrad:** vollstaendig.
### Signatur-Integration (PandaDoc / DocuSign)
- **User-Sicht:** Angebot/PDF in Deal hochladen -> Signatur-Anfrage erstellen, Signer-Status verfolgen, automatischer Stage-Wechsel bei Unterzeichnung.
- **Operationen:** PandaDoc- + DocuSign-Provider, Webhook-Verarbeitung, Status-Transition-Logging, Multi-Signer-Support.
- **Reifegrad:** vollstaendig.
### Booking / Termin-Buchung (Calendly-aehnlich)
- **User-Sicht:** Oeffentliche Booking-Page (`/public/booking/$slug`), Verfuegbarkeit pflegen (`/$tenant/availability`), Buchungen managen (`/$tenant/bookings`, `/$tenant/bookings/$id`), Mitarbeiter-Kalender (`/$tenant/calendar`).
- **Operationen:** AvailabilityRule + Exception, Multi-Provider (mehrere Mitarbeiter pro Booking-Page), Stepper-UI, Slot-Picker, Kalender-Sync (Google/Microsoft).
- **Reifegrad:** vollstaendig.
### Form Builder
- **User-Sicht:** Forms-Index, neuer Form, Editor (Drag&Drop), Sharing/Embed, Submissions-Ansicht, Fill-View, Public Forms (`/f/$tenantSlug/$formSlug`), Submitted-Bestaetigung.
- **Operationen:** Form-Charts, Form-Tags, Form-Actions (Workflow nach Submit), Form-Files, Form-Logs, Form-Submission-Trigger fuer Automationen.
- **Reifegrad:** vollstaendig.
### Knowledge Base / Wiki
- **User-Sicht:** Tenant-Wiki (`/$tenant/wiki`, `/$tenant/wiki/$slug`), Knowledge-Base (`/$tenant/knowledge-base`), oeffentliche Help-Center-Seiten (`/help/$slug/...articles/categories`).
- **Operationen:** Kategorien + Sections, Artikel-Embeddings (RAG-Suche), Up-/Downvotes, Article-Views-Tracking, Article-Entity-Linking (Verknuepfung mit Deals/Projekten).
- **Reifegrad:** vollstaendig.
### Tenant-Assistant ("HiveMind") / KI-Agent
- **User-Sicht:** AI-Assistent (`/$tenant/hivemind`), Custom-Tools-Verwaltung (`/$tenant/settings/hivemind-custom-tools`), Team-Log (`/$tenant/settings/hivemind-team-log`), Hivemind-Settings.
- **Operationen:** Conversation-Speicher, User- und Tenant-AI-Memory, Grounding-References (RAG), Custom-Tools mit Executor (Tenant kann eigene Tools bauen), Scheduled-Actions, Insights-Generation (cron im Scheduler), Reminder-Sweeper, Suggestion-Engine, Screen-Context (UI-Kontext fuer den Agent), Fuzzy-Resolver (Entity-Lookup).
- **Reifegrad:** sehr ausgepraegt (eigene Engine inkl. Scheduler-Hooks).
### KI-Infrastruktur (Generic)
- LLM-Gateway mit Multi-Provider (Anthropic, OpenAI, OpenRouter, Scaleway), Token-Tracking, Token-Limits, Whisper-Transkription, Generated-Objects (strukturierte Outputs), Tenant-Embeddings, RAG-Context, Prompt-Flows (visueller Prompt-Editor).
- API-Endpoints: `api.ai.chat`, `api.ai.generate`, `api.ai.generate-object`, `api.ai.transcribe`, `api.ai.suggestions`, `api.ai.insights`, `api.ai.upload`, OpenAI-kompatibler Endpoint.
- **Reifegrad:** vollstaendig.
### HR-Hub / Mitarbeiterplattform
- **User-Sicht:** HR-Hub mit Tabs: Announcements, Documents, My-Documents, Leave (Urlaub/Krank), Locations, Password-Safe, Payslips, Quick-Links, Resources, Surveys, Requests, Request-Templates.
- **Operationen:** Vacation-Request-Workflow (Antrag -> Genehmigung), Sick-Leave-Reporting, Payslip-Upload durch Buero, Upload-Reminders mit Cron (Mitarbeiter werden erinnert, Dokumente einzureichen), Password-Safe-Vaults (Team-Passwoerter), HR-Surveys, Generic-Request-Templates.
- **Reifegrad:** vollstaendig (sehr breit).
### Customer-Portal (Endkunden-Login)
- **User-Sicht:** Portal-Login (`/portal/$tenant/login`), Dashboard (`/portal/$tenant`), Dokumente (`/portal/$tenant/documents`).
- **Operationen:** Magic-Link-Auth + Password-Auth, Project-Access-Verwaltung (welcher Endkunde sieht welches Projekt), Sales-Phase-Access (Portal schon im Vertriebsprozess oeffnen), Dokument-Freigabe konfigurierbar, Endkunden-File-Upload (`api.portal.files.upload-url`).
- **Reifegrad:** vollstaendig.
### Dashboard / Reporting
- **User-Sicht:** Tenant-Dashboard (`/$tenant/dashboard`) mit konfigurierbaren Widgets pro Rolle (GF, Vertriebler, PL).
- **Widgets:** Pipeline-KPIs, Deal-Trend, Revenue-Overview, Sales-Performance, Project-Overview, Task-Completion, Greetings.
- **Operationen:** Layout-Persistenz pro User/Tenant, Delta-Berechnung (Vergleich Vormonat), rollenbasierte Default-Layouts.
- **Reifegrad:** vollstaendig.
### Tasks
- **User-Sicht:** Task-Liste (`/$tenant/tasks`), inline-Tasks aus Chat-Nachrichten markierbar.
- **Operationen:** Task-CRUD, Zuweisung, Deadlines.
- **Reifegrad:** vollstaendig.
### Files / Dokumente
- **User-Sicht:** Files-Browser (`/$tenant/files`), Datei-Preview/Download.
- **Operationen:** Upload mit Chunked-Progress, Storage-Adapter (lokal/S3-aehnlich), Preview-Generation.
- **Reifegrad:** vollstaendig.
### Analytics (Pipeline / Sales / Projects / Export)
- **User-Sicht:** `/$tenant/analytics` Hub, Sub-Pages: pipeline, sales, projects, export, plus Detail-View.
- **Operationen:** aggregierte Auswertungen aus den Pipelines, CSV/Export-Funktion.
- **Reifegrad:** vollstaendig.
### Audit-Log
- **User-Sicht:** Audit-Trail (`/$tenant/audit`), in Admin: `/admin/audit-trails`.
- **Operationen:** Audit-Diff (Vorher/Nachher), Filter nach Person/Modul/Zeit.
- **Reifegrad:** vollstaendig.
### Notifications
- **User-Sicht:** Notification-Center (`/$tenant/notifications`), Praeferenzen (`/$tenant/settings/notifications`).
- **Operationen:** In-App + Email + Mobile-Push (Novu-Hook im Worker), pro-User-Praeferenzen, Mobile-Device-Registration (`api.notifications.mobile-device`), Ruhezeiten konfigurierbar.
- **Reifegrad:** vollstaendig.
### Search
- **User-Sicht:** Globale Suche (`/$tenant/search`).
- **Operationen:** Unified-Search ueber Entitaeten (Contacts/Deals/Projects/Files/Articles), Search-Token-Generation (`api.search.token`).
- **Reifegrad:** vollstaendig (Tests vorhanden).
### KWP-Integration (Handwerks-ERP)
- **User-Sicht:** KWP-Settings (`/$tenant/settings/integrations/kwp`), KWP-Hub (`/$tenant/kwp`), externer kwpsync.exe Windows-Client (separates Verzeichnis `kwpsync/`).
- **Operationen:** Bidirektionale Anbindung — HiveGrid-Cloud stellt Queue + API bereit (`api.kwp-bundle.$token`), kwpsync.exe (Windows x64) pollt alle 30s, schreibt in MSSQL. Projektnummer-Sequenz + Reservierungen, Builder fuer KWP-Payloads, Validation, Marketplace-Integration, Error-Reports, Document-Sync, Auto-Queue.
- **Reifegrad:** vollstaendig (mit Tests).
### Calendar-Integration (Google + Microsoft)
- **User-Sicht:** Booking/Calendar nutzt externen Kalender; OAuth-Anbindung in Settings.
- **Operationen:** Google + Microsoft Adapter, Sync-Cursor + Webhook-Events, Mapping zwischen HiveGrid-Appointments und externen Calendar-Events, Sync-Service.
- **Reifegrad:** vollstaendig.
### Email-Integration (Gmail + Outlook)
- **Operationen:** OAuth2-basierter Gmail/Outlook-Adapter, Mailbox-Sync, Linking eingehender Mails an Kontakte/Deals.
- **Reifegrad:** vollstaendig.
### Accounting-Integration
- **Operationen:** Adapter fuer LexOffice, sevDesk, FastBill (Rechnung erstellen, Synchronisation).
- **Reifegrad:** vollstaendig (mit Tests).
### Storage-/Drive-/Productivity-Integrationen
- **Drive:** Google Drive, Microsoft OneDrive, Dropbox.
- **Productivity:** Asana, Jira, Trello, Monday, MeisterTask, Notion.
- **Marketing/CRM:** HubSpot, Mailchimp, ActiveCampaign, Brevo.
- **Communication:** Slack, MS Teams, Zoom.
- **Forms:** JotForm, Typeform.
- **Ads:** Facebook Leads, Google Ads (Lead Form).
- **Payments:** Stripe Connect, SumUp.
- **Maps:** Google Maps (Geocoding).
- **Dev:** GitHub.
- **Reifegrad:** Adapter (server.ts) jeweils vorhanden, ueberwiegend ueber das Automation-Registry konsumiert (Trigger/Action-Knoten); UI-Integrationsseiten: nur teilweise ausgebaut.
### Public REST API (`api.v1.*`)
- **Endpoints:** `/api/v1/contacts`, `/api/v1/deals`, `/api/v1/projects`, `/api/v1/users`, `/api/v1/integrations/events`, `/api/v1/webhooks/incoming`.
- **Operationen:** API-Key-Auth + Logs, OpenAPI/Swagger (`/swagger`, `postman_collection.json`), Rate-Limiting via Metering, eingehende Webhook-Subscriptions.
- **Reifegrad:** vollstaendig.
### Webhooks (eingehend + ausgehend)
- Subscriptions, Delivery, Delivery-Attempts, Incoming-Ingestion. Verschiedene Provider-Webhooks: Mailersend, Postmark, Aircall, Sipgate, DocuSign, PandaDoc, Calendly, Stripe, SumUp, Calendar (Google/Microsoft), WhatsApp.
### Onboarding
- **User-Sicht:** Tenant-Onboarding-Wizard (`/onboarding/$id`, `/$tenant/onboarding`), Branchen-/Rollen-Filter.
- **Operationen:** Onboarding-Sessions mit Steps + Actions, Demo-Provisioning (Beispiel-Daten ausrollen), Filter-Matches, Invitation-Dispatch, Setup-Service.
- **Reifegrad:** vollstaendig (eigenes Modul mit Blocks/Components).
### Subscriptions / Billing (Stripe)
- **User-Sicht:** `/pricing`, `/subscribe/$tenant`, Success-Page, in-app Subscription/Billing/Usage Pages.
- **Operationen:** Stripe-Checkout, Subscription-Lifecycle, Seats-Verwaltung, Dunning, Webhook, Trial-Lifecycle, Downgrade-Logik mit Read-Only-Middleware, Service-Metering, Usage-Tracker, AI-Credits.
- **Reifegrad:** vollstaendig.
### Admin (Plattform-Admin)
- **Routes:** `/admin/dashboard`, `/admin/accounts` (Index, Detail, Subscriptions, Roles & Permissions, Users, Blacklist, IP-Adressen), `/admin/email-marketing`, `/admin/help-desk` (Feedback, Inbound-Emails), `/admin/knowledge-base` (Articles, Bases, Import, Danger), `/admin/feature-flags` (Flags, Settings), `/admin/onboarding`, `/admin/notifications`, `/admin/metrics`, `/admin/audit-trails`, `/admin/community-apps`, `/admin/chat`, `/admin/ai` (Chats, Generations), `/admin/api` (Keys, Logs, Credits, Docs), `/admin/events`, `/admin/health`, `/admin/setup`, `/admin/forms`, `/admin/settings/...` (Authentication, Cache, Cookies, Profile, Analytics, Internationalization, Transactional Emails, Accounts/Types, General, Danger).
- **Reifegrad:** sehr breit, vollstaendig.
### Tenant-Settings
- **Routes:** Settings-Hub mit Sub-Pages: account, profile, members (incl. groups), groups, roles, billing, subscription, branding, theme, language, ai-credits, hivemind (+ custom-tools, team-log), notifications, debug, privacy, integrations (kwp, telephony, email, email-domain, signature, webhooks, whatsapp), api (keys, docs, logs), pipelines (Sales-Pipelines konfigurieren), project-pipelines, forms (+ Form-Editor), logs, usage.
- **Reifegrad:** vollstaendig.
### Help-Desk / Support (intern)
- **User-Sicht:** Support-Page (`/$tenant/support`), Help-Center-Page (`/$tenant/help-center`).
- **Operationen:** Support-Chat, Threads, Feedback-Submissions, Surveys.
- **Reifegrad:** vollstaendig.
### Feature-Flags
- Tenant-/User-spezifische Flags, Filter, Admin-Verwaltung.
### GDPR
- Daten-Export-Jobs (`GdprExportJob`), Privacy-Settings.
### Apps Engine / Community-Marketplace / Template-Marketplace
- Generische "App"-Definition mit DataConnections, AppSyncRuns. CommunityApps inkl. Install-Flow im Admin. Template-Marketplace fuer Project-/Form-Templates.
- **Reifegrad:** Admin-UI vorhanden, Tenant-Sicht eher rudimentaer.
### Blog / Pages / Sites (CMS)
- Page/PageBlock/PageMetaTag, Site, BlogPost/Tag/Category, MySiteDemoSubmission (`/dev/components-catalog`, generic Pages).
- **Reifegrad:** Schema vorhanden, vermutlich fuer Marketing/Public-Pages, in den Tenant-Routes eher Stub.
### Mobile-App
- **Verzeichnis:** `apps/mobile/` enthaelt nur Expo-Skeleton (`.expo/`-Ordner).
- **Reifegrad:** Stub (laut Feature-Catalogue P0 mit XL-Aufwand geplant, in Code nicht vorhanden).
---
## Integrationen
| System | Tiefe |
|---|---|
| **KWP** (Handwerks-ERP) | Tiefe Integration: Cloud-API + separater Windows-Client (kwpsync.exe), MSSQL-Sync, Projektnummer-Sequenzen, Document-Sync, Error-Reports, Auto-Queue. |
| **Taifun** (Handwerks-ERP) | **Nicht implementiert** (laut Feature-Catalogue geplant, im Code nicht gefunden). |
| **Aircall / Sipgate** | Telefonie: Click-to-Call, Webhook, Call-Log-Sync, Voicemail-/Transkript-Verknuepfung. |
| **PandaDoc / DocuSign** | Dokument-Signatur: Send + Webhook + Status-Transition, Multi-Signer. |
| **Google Calendar / Microsoft Calendar** | Bidirektionale Sync mit Cursor + Webhooks. |
| **Gmail / Outlook** | Email-Sync mit OAuth2, Linking an CRM. |
| **WhatsApp (Meta WABA + Unipile)** | 2 Provider, Templates, Quick-Replies, Opt-Ins, Sync. |
| **Stripe** | Subscriptions, Checkout, Webhook, Dunning, Connect (Marketplace-Auszahlungen). |
| **SumUp** | Payment-Adapter. |
| **LexOffice / sevDesk / FastBill** | Buchhaltungs-Adapter (Rechnung erstellen, Sync). |
| **Datev** | Action: `datev-export-data` (Datenexport). |
| **MailerSend / Postmark / Resend** | Outbound + Inbound-Email. |
| **Slack / Microsoft Teams** | Send-Message-Action, Trigger fuer empfangene Nachrichten. |
| **Zoom** | Meeting-Erstellung. |
| **Google Drive / OneDrive / SharePoint / Dropbox** | File-Storage-Aktionen + Trigger. |
| **HubSpot / Mailchimp / ActiveCampaign / Brevo** | CRM-/Marketing-Sync (Contact-Add, Trigger bei neuem Contact). |
| **Asana / Jira / Trello / Monday / MeisterTask / Notion** | Task-/Issue-Erstellung + Trigger. |
| **JotForm / Typeform / Google Forms / Calendly / Facebook Leads / Google Ads Lead Form** | Lead-Eingangs-Trigger. |
| **GitHub** | Issue-Erstellung + Trigger bei neuem Issue. |
| **Anthropic / OpenAI / OpenRouter / Scaleway** | LLM-Provider, OpenAI-kompatibler eigener Endpoint. |
| **Google Maps** | Geocoding-Action. |
| **Novu** | Push-Notification-Versand (Worker-Hook). |
| **Sentry** | Observability. |
| **OAuth-Provider** | Google + GitHub als Login-Methode. |
---
## Automation Engine
**Konzept:** Trigger-->(Conditions)-->Action(s) mit visuellem Flow-Editor (Canvas-basiert), Templates, Workflow-Liste, Execution-Log, separates "API & Webhooks"-Tab.
**Trigger (~50, im Registry):**
- CRM: `contact-created`, `contact-updated`, `contact-deleted`, `deal-created`, `deal-updated`, `deal-stage-changed`, `deal-won`, `deal-lost`
- Projekt/Task: `project-created`, `project-stage-changed`, `project-stage-stuck`, `project-completed`, `task-created`, `task-completed`
- Forms/HR: `form-submitted`, `hr-request-submitted`
- Schedule: `schedule.trigger` (Cron-like Time-Based)
- Telefonie: `aircall-call-completed`, `sipgate-call-completed`
- Email: `gmail-email-received`, `outlook-email-received`, `mailersend-email-delivered`, `mailersend-email-bounced`
- WhatsApp: `whatsapp-message-received`
- Slack: `slack-message-received`
- Lead-Eingang: `facebook-leads-lead-received`, `google-ads-lead-form-submitted`, `google-forms-response-submitted`, `jotform-submission-received`, `typeform-response-submitted`
- Calendar/Booking: `calendly-event-scheduled`, `zoom-meeting-created`
- Signatur: `docusign-envelope-sent`, `docusign-envelope-completed`, `pandadoc-document-completed`
- Payments/Buchhaltung: `stripe-payment-received`, `sumup-payment-received`, `lexoffice-invoice-created`, `sevdesk-invoice-created`
- Externe Tools: `asana-task-created`, `github-issue-created`, `jira-issue-created`, `meistertask-task-created`, `monday-item-created`, `notion-page-created`, `trello-card-created`, `dropbox-file-uploaded`
- Marketing: `activecampaign-contact-added`, `brevo-contact-added`, `hubspot-contact-created`, `mailchimp-subscriber-added`
**Actions (~45):**
- Intern: `create-project-from-deal`, `update-deal-stage`, `create-task`, `notify-projektleiter`, `escalate-pipeline`, `add-tag`, `send-email`, `send-chat-message`, `send-notification`, `send-whatsapp-message`, `delay`, `request-google-review`, `http-request`, `webhook-send`
- AI: `anthropic-generate-text`, `openai-generate-text`, `openrouter-generate-text`
- Email-Provider: `gmail-send-email`, `outlook-send-email`, `mailersend-send-email`, `resend-send-email`
- CRM/Marketing: `hubspot-create-contact`, `mailchimp-add-subscriber`, `activecampaign-add-contact`, `brevo-add-contact`
- Productivity: `asana-create-task`, `jira-create-issue`, `trello-create-card`, `monday-create-item`, `meistertask-create-task`, `notion-create-page`, `github-create-issue`
- Files: `google-drive-upload`, `onedrive-upload`, `sharepoint-upload-file`, `dropbox-upload-file`
- Buchhaltung: `lexoffice-create-invoice`, `sevdesk-create-invoice`, `fastbill-create-invoice`, `datev-export-data`
- Communication: `slack-send-message`, `teams-send-message`, `zoom-create-meeting`, `google-calendar-create-event`
- Maps: `google-maps-geocode`
**Infrastruktur:**
- BullMQ-basierter Automation-Worker, separater Scheduled-Rule-Worker, Loop-Guard (Endlosschleifen-Schutz), Metering (Trigger-Volumen-Modell wie Zapier), Tenant-spezifische Credentials, Templates ("schon vorgefertigte Workflows"), Stage-Stuck-Eskalation laeuft im Scheduler-Tick (alle 10 Min).
- Eigene i18n-Files fuer Automation-Knoten (`automation-i18n-de.json` / `-en.json`).
---
## Auth / Multi-Tenancy / Rollen
**Auth-Methoden:**
- Email + Passwort
- OAuth: Google + GitHub
- Magic-Link (fuer Customer-Portal)
- API-Keys (mit Logs)
- JWT (`jwt-auth.server.ts`)
**Multi-Tenancy:**
- **Tenant-Slug in URL:** `/$tenant/...` Route-Praefix
- **Row-Level-Security:** Postgres RLS via Dual-DB-Connection (`DATABASE_URL` Superuser fuer Migrations vs. `DATABASE_URL_APP` mit App-Role + RLS Policies). Eigener Tenant-Context-Helper (`tenantPrisma(tenantId)`).
- Subdomain-/Custom-Domain-Auflistung per Tenant moeglich (siehe `tenant/url.server.ts`, Caddy-Konfigs).
- IP-Whitelisting pro Tenant (`TenantIpAddress`).
- Custom Branding pro Tenant.
**RBAC:**
- Vorkonfigurierte Rollen (laut `docs/03-ROLES-AND-PERMISSIONS.md`): Geschaeftsfuehrer/Admin, Vertriebsleiter, Vertriebler, Projektleiter/Bauleiter, Buero/Backoffice, Marketing, Monteur.
- Frei anlegbare eigene Rollen (Settings -> Roles, Settings -> Groups).
- Permissions als technische Granularitaet im Schema (`Role`, `Permission`, `RolePermission`, `UserRole`).
- Feature-Gating: `requireTenantFeatureAccess()` als Loader-First-Call (Convention, siehe `PROJECT.md`).
- Globale Admin-Rolle (`AdminUser`) mit eigenem `/admin`-Bereich.
**Customer-Portal:**
- Eigene `PortalUser`/`CustomerPortalAccount`-Tabelle, getrennt vom internen `User`.
- Magic-Link + Password.
- Project-Access-Granularitaet (welcher Endkunde sieht welche Projekte/Dokumente).
**Subscriptions/Trial:**
- Trial-Lifecycle, Downgrade -> Read-Only-Middleware (verhindert schreibende Aktionen wenn Plan abgelaufen).
**Audit:**
- Vollstaendiger Audit-Trail mit Vorher-/Nachher-Diff.
---
## Auffaellige Luecken & halbfertige Bereiche
- **Mobile-App:** Im Repo nur leerer Expo-Skeleton (`apps/mobile/.expo/`). Im Feature-Katalog als P0-Pflicht definiert ("Native Mobile App PFLICHT"), aber **gar nicht implementiert**. Push-Notifications-Backend ist da (Novu, NotificationDevice), Mobile-Device-Registration-Endpoint existiert — Client fehlt.
- **Taifun-ERP:** Im Feature-Katalog (`14.4`) explizit als Pflicht-Integration genannt, im Code aber **nicht vorhanden** — nur KWP ist implementiert.
- **Blog/CMS/Sites:** Schemas (`Page`, `PageBlock`, `BlogPost`, `Site`) existieren, sichtbare Tenant-Routes dafuer kaum vorhanden — vermutlich fuer das Customer-Portal-Upgrade ("Blog-Funktion" laut Feature-Catalogue 8.10, P2) angefangen.
- **Community-Apps / Template-Marketplace:** Admin-UI vorhanden, Tenant-Sichtbarkeit (z.B. Browser fuer Templates aus Tenant-Sicht) eher rudimentaer. `app-catalog`-Modul wirkt als Vorbereitung.
- **AppsEngine (`App`, `DataConnection`, `AppSyncRun*`):** Generisches Sync-Framework — wirkt wie Vorbereitung fuer Drittanbieter-Apps; konkret genutzt fuer KWP, sonst eher leer.
- **Plantafel:** Eigene Route `/$tenant/projects/plantafel` und Service vorhanden — Implementierungstiefe nicht klar, Plantafel-bezogenes ScheduleEntry-Modell ist da.
- **Ai-Gen Objects/Forms:** Ordner `app/modules/ai-gen/objects/forms` und `_template` deuten auf "AI generiert komplette Formulare" — sieht angefangen aber begrenzt aus.
- **Wiki vs. Knowledge-Base:** Zwei parallele Module (`/$tenant/wiki/...` MDX-basiert vs. `/$tenant/knowledge-base/...` DB-gestuetzt). Unklar welches vorne war — das Wiki-Routes-Verzeichnis ist sehr klein, Wahrscheinlich abgeloest durch Knowledge-Base.
- **`templates.tsx` im Tenant-Bereich:** Datei existiert mit nur 213 Bytes — Stub.
- **Pricing-Page:** `/pricing` existiert als Public-Route — vermutlich Marketing-Stub.
- **Hivemind-Custom-Tools:** Sehr ambitionierter Bereich (User definiert Tools, AI-Agent fuehrt aus) — wirkt experimentell.
- **GDPR-Export-Job:** Schema existiert, UI duerftig (vermutlich nur Admin-getriggert).
- **Help-Center oeffentlich (`/help/$slug/...`):** Multi-Language-Unterstuetzung (`($lang)`-Param) angedeutet — Implementierungstiefe unklar.
- **Sehr hoher Refactor-Druck dokumentiert:** `PROJECT.md` (M002 Codebase-Cleanup) erwaehnt 15 Routes >600 LOC, ~30% UI noch English-only, viel `any`/`console.log`/`ts-ignore` Cleanup. Das ist genau der Spaghetti-Code-Grund fuer die Verwerfung.
---
## Feature-Cheatsheet (alphabetisch)
- **Abnahmeprotokoll** — digitale Abnahme-Checkliste fuer Projekte, mit Foto-Upload und Kunden-Signatur am Smartphone.
- **Activity-Stream** — kombinierte Timeline aus Calls, Mails, Chat-Nachrichten, Stage-Wechseln pro Deal/Projekt/Kontakt.
- **Admin-Bereich (Plattform)** — globale Tenant-/User-Verwaltung, Subscription-Auswertung, Feature-Flags, Knowledge-Base-Verwaltung, Help-Desk, Setup-Wizards, Health-Checks, AI-Logs.
- **Aircall-/Sipgate-Telefonie** — Click-to-Call, automatisches Logging im Deal, Webhook-Integration.
- **Analytics-Dashboard (Tenant)** — Pipeline-, Sales-, Project-, Export-Auswertungen.
- **Angebots-PDF-Upload + Signatur-Anfrage** — PandaDoc/DocuSign-getrieben, Status-Auto-Sync zu Deal-Stage.
- **API (REST v1)** — Public API mit OpenAPI/Swagger, API-Keys, Logs, Rate-Limit, Postman-Collection.
- **API-Key-Verwaltung** — pro Tenant (Settings/API/Keys) und global (Admin/API/Keys).
- **Apps Engine (Generic Sync)** — Framework fuer Datenverbindungen + Sync-Runs (KWP nutzt es).
- **Audit-Log** — Aktivitaets-Trail mit Diff, filterbar nach Person/Modul.
- **Auth (OAuth/Email/Magic-Link)** — Google + GitHub OAuth, Email/Pwd, Magic-Link fuers Portal, JWT, API-Keys.
- **Automation Studio** — Visueller Flow-Editor, ~50 Trigger, ~45 Actions, Templates, Loop-Guard, Trigger-Metering.
- **Booking-Pages (Calendly-Style)** — oeffentliche Buchungsseite mit Multi-Provider, Verfuegbarkeitsregeln/Ausnahmen.
- **Branding/Theme** — pro Tenant konfigurierbares Branding und Theme.
- **Buchhaltungs-Integrationen** — LexOffice, sevDesk, FastBill, Datev (Export).
- **Calendar-Sync** — Google + Microsoft, bidirektional mit Webhooks.
- **CMS-Pages/Blog (rudimentaer)** — Page/Block/Blog-Schemas vorhanden.
- **Chat (intern, Team)** — Channels, DMs, Pinned, Reactions, Threads, Datei-Uploads, WebSockets.
- **Community-Apps Marketplace** — Admin-Verwaltung von Drittanbieter-Apps.
- **Customer-Portal** — Endkunden-Login, Dokument-Einsicht, Datei-Upload, Projekt-Status, Magic-Link-Auth.
- **Dashboard-Widgets** — konfigurierbare Tiles (Pipeline-KPIs, Deal-Trend, Revenue, Sales-Performance, Project-Overview, Task-Completion).
- **Deals & Sales-Pipeline** — Kanban + Liste + Detail, Stages, Activities, Archive, Form-Linkage.
- **Demo-Provisioning** — Beispiel-Daten beim Onboarding.
- **DSGVO-Export** — `GdprExportJob` per Tenant.
- **Email-Marketing** — Kampagnen, Segmente, Sender, Activity (Open/Click), Cron-Versand.
- **Email-Inbox (Tenant)** — Eingehende Mails verknuepft mit Kontakten/Deals, eigene Sending-Domain mit DKIM, Inbound-Webhooks (MailerSend/Postmark).
- **Email-Sync (Gmail/Outlook)** — OAuth2-basierter Mailbox-Sync.
- **Embed-Forms** — eingebettetes Formular auf Handwerker-Website per Code-Snippet.
- **Feature-Flags** — pro Tenant/User, Filter, Admin-UI.
- **Files / Dokumente** — Browser, Upload mit Chunked-Progress, Preview.
- **Form Builder** — Drag-&-Drop Forms, Submissions, Sharing/Embed, Form-Actions, Foto-Checklisten.
- **Geocoding** — Google-Maps-Integration als Action.
- **Globale Suche** — Cross-Entity Unified-Search.
- **Help-Center (oeffentlich)** — Public Help-Pages mit Multi-Language.
- **HiveMind (Tenant-AI-Agent)** — RAG-basierter Assistent mit Custom-Tools, Insights, Reminders, Scheduled-Actions, Screen-Context.
- **HR-Hub** — Announcements, Documents, Leave (Urlaub/Krank), Locations, Password-Safe, Payslips, Quick-Links, Resources, Surveys, Requests.
- **Inbound-Webhooks** — generisches Ingestion-System fuer externe Events.
- **Internationalisierung** — i18n via react-i18next (DE+EN), Admin-Settings fuer i18n.
- **KI-Suche / RAG** — Embeddings ueber Tenant-Entitaeten und Help-Articles via pgvector.
- **KI-Workflows / Prompt-Flows** — Visueller Prompt-Editor mit Input-Variablen, Templates, Output-Mapping.
- **Knowledge-Base** — Categories/Sections/Articles mit Embeddings, Up-/Downvotes, View-Tracking.
- **KWP-ERP-Sync** — Cloud-Queue + Windows-kwpsync.exe Client gegen MSSQL, Projektnummer-Reservierung, Document-Sync.
- **Leads** — Inbox, Statistiken, CSV-Import.
- **LLM-Gateway** — Multi-Provider (Anthropic, OpenAI, OpenRouter, Scaleway), Token-Tracking, Limits, AI-Credits.
- **Magic-Link-Auth** — fuer Customer-Portal.
- **Mehrsprachigkeit** — DE/EN am Start, Sprache pro User.
- **Mobile-Push** — Novu-basiert, Device-Registration, Praeferenzen (inkl. Ruhezeiten).
- **Notification-Center** — In-App + Email + Push, pro-User-Praeferenzen.
- **OAuth2-Framework** — generischer Provider-Helper (Google, Microsoft, GitHub, weitere).
- **Onboarding-Wizard** — branchenbasiert, mit Filtern, Steps, Demo-Daten.
- **Page-Blocks (CMS)** — Block-basiertes Page-Editor (rudimentaer).
- **Password-Safe (HR)** — Team-Password-Vault.
- **Payslips (Lohnabrechnung)** — Buero laedt hoch, Mitarbeiter sieht ein.
- **Pipeline-Eskalation** — automatische Erinnerung wenn Deal/Projekt zu lange in Stage haengt.
- **Plantafel** — Ressourcen-/Termin-Planung fuer Projekte (Schedule-Entries).
- **Portale (mehrere Endkunden-Portale je Tenant)** — `Portal`-Modell + Subscriptions im Portal.
- **Projects & Auftragspipeline** — Kanban, Detail, Members, Acceptance, Archive, Plantafel, Templates.
- **Push-Notifications** — Mobile + Email + In-App.
- **Quick-Links (HR)** — kuratierte Schnellzugriffe.
- **Roles & Permissions** — Settings-UI fuer Rollen-Verwaltung, fertige Templates.
- **Schedule-Entries** — Termin-/Plantafel-Eintraege.
- **Search-Token** — sichere Suche mit kurzlebigen Tokens.
- **Sites / MySite** — Tenant-spezifische Public-Sites (Schema vorhanden, Implementation rudimentaer).
- **Slack/Teams/Zoom/Calendly-Integrationen** — Action+Trigger-Knoten.
- **Stripe-Subscriptions + Checkout + Dunning + Trial** — vollstaendiger Billing-Flow.
- **Stripe-Connect / SumUp** — Marketplace-Auszahlungen / Payment-Processing.
- **Support / Help-Desk** — Support-Chat-Threads, Feedback, Surveys (admin + tenant).
- **Tasks** — Aufgaben aus Chat-Nachrichten ableitbar, mit Zuweisung+Deadline.
- **Telephony-Click-to-Call** — Aircall + Sipgate.
- **Template-Marketplace** — kaufbare Project-/Form-Templates.
- **Tenant-Branding** — Logo, Farben, Theme.
- **Tenant-Switcher** — UI fuer Mehrfach-Tenant-Mitgliedschaften.
- **Trial + Downgrade-Read-Only** — verhindert Schreibaktionen nach Plan-Ablauf.
- **Upload-Reminders (HR)** — Mitarbeiter werden zyklisch erinnert, Dokumente einzureichen.
- **Urlaub & Krankmeldung** — Form-basierte Workflows, Genehmigung, Kalender.
- **Usage-Tracking / Metering** — pro Tenant, fuer Subscription-Quota und AI-Credits.
- **Verfuegbarkeitsregeln** — Booking-Page-Verfuegbarkeit + Ausnahmen.
- **Wiki (MDX)** — content-basiert (parallel zur DB-getriebenen Knowledge-Base).
- **Webhooks (eingehend + ausgehend)** — Subscriptions, Delivery-Tracking, Retries.
- **WhatsApp Business** — Meta WABA + Unipile, Templates, Quick-Replies, Sync, Webhook.
- **Whisper-Transkription** — Audio-Transkription (z.B. fuer Anrufe / Sprachnachrichten).
- **Widgets-Engine** — anpassbare Dashboard-Tiles pro Rolle.
@@ -0,0 +1,485 @@
# HiveGrid März-Planning — Inhaltliche Inventur
**Quelle:** `/Users/raffaelsheikh/Downloads/_bmad-output`
**Stand der Quelle:** 2026-03-07 (Production-Docs) bzw. 2026-03-10 (Landing Page)
**Erstellt:** 2026-05-07
**Methodik:** Vollständige Lektüre aller textbasierten Dokumente; Faktenextraktion und davon getrennt Annahmen-/Lückenauswertung
---
## Dokumentenübersicht
| Datei | Datum | Größe | Typ | Kurzbeschreibung |
|---|---|---|---|---|
| `analysis/brainstorming-session-2026-03-07.md` | 2026-03-07 | 7,3 KB | Brainstorming-Protokoll | BMad-Session-Zusammenfassung (Question Storming, SCAMPER, Role Playing); 97 Ideen; Verweis auf 7 Production-Dokumente |
| `production/01-PRODUCT-VISION-AND-ICP.md` | 2026-03-07 | 5,4 KB | Product Brief / Vision | Vision, ICP, Pain Points, Go-to-Market, Stufenmodell |
| `production/02-FEATURE-CATALOGUE.md` | 2026-03-07 | 15,6 KB | PRD-äquivalent / Featureliste | 97 Features in 18 Kategorien, P0/P1/P2-Priorisierung, Cloud/Cloud+/Enterprise/Upgrade |
| `production/03-ROLES-AND-PERMISSIONS.md` | 2026-03-07 | 6,1 KB | Rollen-/Rechte-Spezifikation | 7 Rollen + Endkunde, ~20 Ja/Nein-Permission-Bundles, Nutzertypen |
| `production/04-USER-JOURNEYS.md` | 2026-03-07 | 10,2 KB | UX/Journey-Spezifikation | 7 End-to-End-Journeys (Lead-to-Cash, GF-Tag, Monteur-Tag, Endkunde, Onboarding, Backoffice, Marketing) |
| `production/05-PRICING-AND-PACKAGING.md` | 2026-03-07 | 5,4 KB | Pricing-/Packaging-Konzept | Stufen, Lizenzpreise, Setup-Fees, Beispielrechnung, Wettbewerbsvergleich |
| `production/06-TECHNICAL-REQUIREMENTS.md` | 2026-03-07 | 8,2 KB | Architektur / Technical Brief | SaasRock-Basis, Datenmodell, Integrationen, Mobile, Security, i18n |
| `production/07-OPEN-ITEMS-AND-DECISIONS.md` | 2026-03-07 | 7,7 KB | Decision Log / Risiken | 8 Tech-Entscheidungen, 7 Pricing-Fragen, 8 Produkt-Fragen, 6 Risiken, 20 feste Entscheidungen |
| `landing-page/index.html` | 2026-03-10 (mtime 2026-03-10 17:47) | 141 KB | Marketing-Artefakt | Statische Landing Page (HTML), assets/-Ordner leer |
| `implementation-artifacts/` | 2026-03-07 | leer | (geplant) | Verzeichnis existiert, aber **keine Inhalte** — keine Architecture-Doc, keine Epics, keine Stories, keine Test-Pläne |
**Auffälligkeiten der Dokumentenlage:**
- Es gibt **kein dediziertes PRD-Dokument** im klassischen Sinn — die "PRD-Funktion" wird durch die Feature-Tabelle (`02-FEATURE-CATALOGUE.md`) übernommen.
- Es gibt **keine Architecture-Doc** im Sinne eines Solution-Designs (ADRs, Komponentendiagramme); das vorhandene `06-TECHNICAL-REQUIREMENTS.md` ist eher eine Anforderungsliste.
- Es gibt **keine Epics, keine User Stories, keine Acceptance Criteria** — `implementation-artifacts/` ist leer.
- Es gibt **kein Research-Dokument** zu Wettbewerb, Domain, KWP/Taifun, Markt — Domain-Insights sind verstreut in Brief und Pricing.
- Es gibt **kein Retrospektive-/Decision-Dokument** zu verworfenen Optionen.
- Die Brainstorming-Session referenziert einen externen `/Users/dejancosic/Downloads/PROJECT-REPORT.md`, dieser liegt **nicht im Output-Verzeichnis** vor.
---
## Vision / Product Brief
### Mission (laut Dokument 01)
HiveGrid Cloud ist eine "eigenständige Multi-Tenant-SaaS-Plattform für mittelständische Unternehmen (Fokus Handwerk)", die als **ERP-Ergänzung** Insellösungen (WhatsApp, Excel, Google Drive) konsolidiert.
**Kernversprechen:** "Kommunikation, Erreichbarkeit und durchgängiger Datenfluss — vom Lead bis zum Serviceabschluss — ohne die bestehende ERP-Software zu ersetzen."
**Positionierung:** "Die Plattform, die dein ERP ergänzt und deine WhatsApp-Gruppen und Excel-Listen ersetzt."
### Zielkunde (ICP)
- **Branche:** Handwerksunternehmen, branchenneutral (Behauptung: 80-90% identische Prozesse, 10% gewerkspezifisch via Checklisten)
- **Größe:** Ab 25 MA, Sweet Spot **40-75 MA**, nach oben offen
- **Umsatz:** ca. 5-15 Mio EUR
- **Kaufentscheider:** GF (95%), ab ~60 MA auch Bereichsleiter
- **Tech-Affinität:** niedrig bis mittel
- **Ist-Zustand:** ERP (Taifun, KWP, TopKontor, Streit V.1) + WhatsApp + Excel
- **Sekundär:** Andere Mittelständler (Agenturen, IT-Dienstleister) — Cloud + Enterprise sind branchenneutral
- **Anti-Persona:** Solo/<20 MA, Betriebe ohne Vertriebsprozess, Betriebe die ERP ersetzen wollen
### Kernprobleme (Pain Points, Doc 01 §3.1)
1. Insellösungen → Informationsverlust
2. Keine Vertriebssteuerung / Pipeline / KPIs
3. Kommunikationschaos (WhatsApp losgelöst von Projekten)
4. Keine Kundentransparenz (ständige Anrufe "Wann kommt der Monteur?")
5. Keine Mitarbeiterplattform
6. GF hat keinen Überblick (KPIs)
7. Manuelle/unvollständige Dokumentation der Monteure
### USP / Kaufargumente
Zeitersparnis, Organisation statt Zettelwirtschaft, Kontrolle ohne Mikromanagement (Automationen), Kundenerlebnis als Differenzierung, professioneller Vertriebsprozess.
### Kaufhürden (im Dokument benannt)
Budget-Sensibilität (Schwelle 500 EUR/Monat, harte Grenze 1000 EUR), kein aktives Suchen, "CRM" als Begriff fremd, Angst vor Komplexität.
---
## Geplanter Feature-Scope (PRD)
Aus `02-FEATURE-CATALOGUE.md`: **97 Features in 18 Kategorien**, Aufteilung ~55 P0 / ~30 P1 / ~12 P2.
### Kategorie 1 — Chat & Kommunikation (12 Features)
Projekt-/Gruppen-/Einzel-Chats (P0); Datei-Upload (P0); bidirektionale Navigation Deal/Projekt↔Chat (P0); Chat-Archivierung mit Projekt (P0); Monteur sieht nur aktive Projekte (P0); Lesebestätigungen, @-Mentions, Pinned Messages, Threads, Slack-artige Kanäle (P1/P2).
### Kategorie 2 — Deal-/Vertriebspipeline (10 Features)
Kanban (P0); Drag&Drop (P0); Deal-Karte mit Volumen/Deadline/Zuständiger (P0); Filter pro Person (P0); Auto-Lead-Erstellung aus Formular (P0); Mobile Datenerfassung Vertriebler vor Ort (P0); Deal→Projekt-Automation bei "Gewonnen" (P0); Vertriebler-KPIs (P0); KPI-Sichtbarkeit zwischen Vertrieblern optional (P1); Deal-Notizen/Aktivitäten (P0).
### Kategorie 3 — Auftrags-/Projektpipeline (10 Features)
Projekt-Kanban (P0); Verknüpfung mit Deal (P0); Filter pro PL (P0); Auto-Projekt-Chat (P0); Aufgaben aus Chat (P0); Abnahme-Checkliste (P0); Kundenunterschrift auf Smartphone (P0); Dokumentenablage (P0); Eskalations-Automation (P1); PL-Mini-Dashboard (P2).
### Kategorie 4 — CRM/Kontaktmanagement (4 Features)
Zentrale Kontakte, Historie, Verknüpfung Deal/Projekt (P0); Segment-Filter für Marketing (P1).
### Kategorie 5 — Angebot & Signatur (6 Features)
PDF-Upload (P0); Freigabe-Link à la PandaDoc (P0); rechtssichere Signatur mit IP/Timestamp (P0); Status-Automation bei Unterschrift (P0); Versionierung (P1); PandaDoc/DocuSign-Integration (P0, **Cloud Plus**).
### Kategorie 6 — Mitarbeiterplattform (8 Features)
Persönlicher Bereich (P0); Passwort-Safe (P1); Doc-Upload durch MA (P0); Lohnabrechnungs-Ablage (P1); Upload-Erinnerungen (P2); Krankmeldung als Formular (P1); Urlaubsantrag mit Workflow (P2); Onboarding-Tool-Integration (P2).
### Kategorie 7 — Form Builder / Checklisten (7 Features)
Freier Form Builder à la Google Forms (P0, XL); Abnahmeprotokolle (P0); Sales-Datenaufnahme-Formulare (P0); Endkunden-Formulare mit Datenfluss in Deal (P0); Foto-Checklisten mit Vorgaben (P0); Formular→Deal-Automation (P0); einbettbares Formular (P0).
### Kategorie 8 — Kundenportal (Upgrade-Modul, 10 Features)
Kunden-Login (P0); konfigurierbare Statusanzeige (P0); Dokumenten-Einsicht (P0); bidirektionale Kommunikation optional (P1); Kunden-Upload (P0); Zugang ab Sales-Prozess (P1); Portal bleibt nach Abschluss offen (P0); Doc-Freigabe konfigurierbar (P1); Standard-Benachrichtigungen (P1); Blog (P2).
### Kategorie 9 — GF-Dashboard / Reporting (8 Features)
Aggregierte Pipeline-KPIs (P0); Umsatz-Überblick/Forecast (P0); Rechnungs-Tracking (P1); Vertriebler-Performance inkl. "warum" (P0); Projekt-Überblick + Auslastung (P0); strategische KPIs (Auslastungstrend, Wachstum) (P1); KI-Zusammenfassungen (P2); automatische Reports (P0).
### Kategorie 10 — Automationen (8 Features)
Wenn-Dann-Trigger-Engine (P0, XL); Pipeline-Eskalationen (P0); Deal-gewonnen-Automation (P0); Abschluss-Automation Bewertung+Buchhaltung (P1); unbegrenzte Regeln (P0); Trigger-Volumen-Aufpreis-Modell (P0); Google-Bewertung-Automation (P1); Empfehlungs-Automation (P2).
### Kategorie 11 — Email-Marketing (6 Features)
Templates (P0); Empfängerlisten aus CRM (P0); Kampagnen-Versand (P0); trigger-basierte Mails (P1); Automation-Ketten (P1); Basis-Analytics (P1).
### Kategorie 12 — KI-Assistent (4 Features)
Programm-Hilfe (P0); Dokument-Suche (P1); FAQ-Beantwortung (P0); Erweiterte KI mit MCP/M.Y.R.A nur Enterprise (P2).
### Kategorie 13 — Wissensdatenbank (4 Features)
Internes Wiki (P0); kontextgebundene Dokumente an Deals/Projekten (P0); Suche (P0); Versionierung (P1).
### Kategorie 14 — Integrationen (7 Features)
Telefonie Aircall/Sipgate (P0, Cloud); Signatur PandaDoc/DocuSign (P0, Cloud Plus); Buchhaltung Datev/LexOffice (P1); Handwerks-ERP Taifun/KWP etc. (P0, Cloud Plus, **XL**); Pipedrive (P1); REST-API (P0); einbettbares Kontaktformular (P0).
### Kategorie 15 — Benachrichtigungen (5 Features)
Push (P0); Email (P0); In-App (P0); Ruhezeiten (P1); Konfigurations-Optionen (P1).
### Kategorie 16 — Audit-Log (3 Features)
Aktivitäts-Feed (P0); Filter pro Person/Modul (P1); Effizienz-Metriken (P1).
### Kategorie 17 — Nutzerverwaltung & Onboarding (7 Features)
CSV-Import (P0); Email-Einladung (P0); Smart-Onboarding (Branche/Größe → Auto-Konfiguration, P1); vorkonfigurierte Demo (P0); DE+EN i18n (P0); weitere Sprachen TR/PL (P2); Chat-Übersetzung (P2).
### Kategorie 18 — Plattformen (3 Features)
Web-App (P0, SaasRock-Basis); Native iOS+Android-App (P0, **Pflicht**); Mobile-First-Monteur-UI (P0).
---
## Konzeptionelle Architektur (nicht Tech)
Das Dokument 06 ist primär Anforderungsliste. Die folgenden konzeptionellen Komponenten/Module lassen sich aus den Inhalten herauslesen:
**Plattform-Backbone:**
- Multi-Tenant-Mandantenmodell (logische Trennung via tenantId, Tendenz nicht final)
- Identity-/Rollen-Modul mit Ja/Nein-Permission-Bundles (~20 Schalter, 7 vorkonfigurierte Rollen + freie Rollen)
- Subscription-/Billing-Modul (Stripe, gestaffelt Cloud/Cloud Plus/Enterprise)
**Domain-Module:**
- Kontakt-/CRM-Modul
- Pipeline-Modul (zwei Varianten: Deal-Pipeline und Projekt-Pipeline, beide konfigurierbar mit Phasen)
- Chat-Modul mit drei Kanal-Ebenen (Projekt, Gruppe, Einzel) mit projektgebundener Archivierung
- Task-Modul (leichtgewichtig, aus Chat-Nachrichten generierbar)
- Form-Builder-Modul (Checklisten, Abnahmeprotokolle, Endkunden-Formulare)
- Dokumentenablage (kontextgebunden an Deal/Projekt/User/KB)
- Knowledge-Base-Modul
- Mitarbeiterplattform (HR-Dokumente, Krankmeldung, Urlaub)
**Automations-Layer:**
- Trigger→Aktion-Engine mit Volumen-Quoting (Zapier-artig)
- Eskalations-Mechaniken auf Pipeline-Phasen
**Reporting-Layer:**
- GF-Dashboard mit Aggregat-KPIs
- Audit-Log / Activity-Feed
- Vertriebler-Performance-Auswertung
**Engagement-Layer:**
- Push-/Email-/In-App-Notifications
- Email-Marketing-Modul
- KI-Assistent (Cloud: Programm-Hilfe; Enterprise: MCP/M.Y.R.A)
**Customer-Facing:**
- Kundenportal (Upgrade-Modul) mit Login, Status, Doc-Einsicht, Upload, optionalem Chat
- Eingebettete Formulare auf Handwerker-Websites
- Digitale Signatur (Angebot + Abnahme-Checkliste)
**Integrations-Schicht:**
- Telefonie-Connectoren (Aircall, Sipgate)
- Signatur-Connectoren (PandaDoc, DocuSign)
- Buchhaltungs-Connectoren (Datev, LexOffice)
- Handwerks-ERP-Connectoren (Taifun, KWP, TopKontor, Streit V.1)
- REST-API + Webhooks
**Plattformen:**
- Web (SaasRock/React Router v7)
- Native Mobile-Apps (iOS + Android) mit eigener Monteur-UI
**Wie sollen die Module zusammenspielen** (laut Doc 04, Journey 1 = Lead-to-Cash):
Eingebettetes Formular → Auto-Deal → Pipeline → Telefonie-Logging → mobile Datenerfassung → PDF-Angebot via PandaDoc → digitale Signatur → Status-Automation → Auto-Projekt-Erstellung → Auto-Projekt-Chat → Aufgaben aus Chat → Monteur-App mit Push → Foto-Checklisten → Abnahme mit Kunden-Signatur → Auto-Notification an Buchhaltung → Auto-Bewertungs-Email → Portal-Doc-Freigabe → Chat archiviert.
---
## Epics & Stories — was war runtergebrochen?
**Befund:** Es gibt **keine Epics und keine User Stories**. `implementation-artifacts/` ist leer. Es existieren nur:
- die 18 Feature-Kategorien aus Doc 02 (mit ~97 Features als Tabellenzeilen)
- die 7 Journeys aus Doc 04, die als Workflow-Beschreibungen lesbar sind, aber **nicht als Epic mit Stories formalisiert** sind
Wenn man die 18 Kategorien als implizite Epics liest, dann existiert **keine Story-Granularität** (keine Acceptance Criteria, keine Definition of Done, keine Schätzungen außer der groben S/M/L/XL-Aufwandsskala in der Featuretabelle, keine Reihenfolge/Dependencies).
Die **7 Journeys** sind:
1. Lead-to-Cash (durchgängiger Datenfluss, der zentrale E2E-Prozess)
2. GF-Tagesablauf (strategische Steuerung, Dashboard-zentriert)
3. Monteur-Tagesablauf (Push → Chat → Checkliste → Foto → Signatur)
4. Endkunde / Kundenportal (Formular → Portal-Zugang ab Sales → Status → Reklamation → Bewertung → Langzeit-Zugang)
5. Neuer Mandant / Firma-Onboarding (Landingpage → Vertriebscall → Trial → Setup-Gebühr → Smart-Onboarding → Go-Live in 16-21 Tagen)
6. Backoffice/Sandra (minimal, ERP bleibt Haupttool)
7. Marketing (Kampagne erstellen)
---
## Domain-Research
**Befund:** Es gibt **kein eigenständiges Research-Dokument**. Domain-Insights sind verstreut:
**Über das Handwerk (aus Doc 01 + 07):**
- 80-90% der Prozesse sind branchenneutral, 10% gewerkspezifisch und über Checklisten abbildbar (Behauptung)
- Sweet Spot 40-75 MA, Umsatz 5-15 Mio EUR
- GF ist Kaufentscheider (95%)
- Push-Marketing nötig — Kunde sucht nicht aktiv
- "CRM" ist kein bekannter Begriff in der Zielgruppe
- Pain-Point-Marketing: "Zeitersparnis + Organisation", nicht "CRM" oder "SaaS"
- Budget-Sensibilität: 500 EUR-Schwelle, 1000 EUR-Hartgrenze
**Über die ERPs (aus Doc 01 + 06 + 07):**
- Vier Systeme genannt: **Taifun, KWP, TopKontor, Streit V.1**
- Cloud Plus = bidirektionale Anbindung an diese ERPs (P0, Aufwand XL)
- Priorisierung der ERPs ist offen (PR-2): "Marktanalyse nötig"
- Es gibt **keine** Dokumentation, was diese ERPs konkret können, welche APIs sie bieten, welche Datenmodelle, welche Authentifizierung, welche Lizenz-/Partnerschaftsanforderungen
- Backoffice (Sandra) "arbeitet primär in der ERP" — HiveGrid ist Nebentool für sie
**Über den Wettbewerb (aus Doc 05 §8):**
- Slack: 7-12 EUR/User/Monat — HiveGrid verbindet Chat mit Projekten/Deals
- Pipedrive: 15-99 EUR/User/Monat — HiveGrid geht über CRM hinaus
- OpenHandwerk / TopKontor: variabel — HiveGrid ersetzt ERP nicht
- WhatsApp + Excel: "kostenlos" — HiveGrid konsolidiert
- Keine Tiefen-Recherche zu Wettbewerbern wie OpenHandwerk, Plancraft, ToolTime, Craftnote, blue:solution, etc.
**Über Pricing (aus Doc 05):**
- Grundlizenz Cloud: ~350 EUR/Monat inkl. 5 Büro-Nutzer
- Monteur-Nutzer: ~5 EUR/Monat (eingeschränkt)
- Setup-Gebühr Cloud: ~1.000 EUR, Cloud Plus: ~1.900 EUR, Enterprise: auf Anfrage
- Jahresrabatt-Prozentsatz offen, 15-20% genannt als typisch
- Trigger-Volumen-Modell offen
- Beispielrechnung 50-MA-Betrieb: 350 + 35×5 + TBD = ~525 EUR/Monat + TBD
**Tools & Vorbilder explizit genannt (aus Brainstorming):**
- Slack-Kanalstruktur, Trello-Kanban, PandaDoc-Signatur, Notion-Wiki, Hubspot-Marketing, Zapier-Trigger-Modell, WhatsApp-Einfachheit für Monteure
---
## Annahmen & Behauptungen
(Liste aller Stellen, an denen etwas behauptet wird, ohne dass im Planning eine Verifikation/Quelle dokumentiert ist.)
| # | Annahme | Wo |
|---|---|---|
| A-1 | "80-90% identische Prozesse über Handwerksgewerke hinweg, 10% gewerkspezifisch" | Doc 01 §2.1 + Doc 07 §6.1 |
| A-2 | Sweet-Spot Zielgröße ist 40-75 MA | Doc 01 §2.1 |
| A-3 | GF ist in 95% der Fälle Kaufentscheider | Doc 01 §2.1 |
| A-4 | Budget-Schwelle 500 EUR/Monat, Hartgrenze 1.000 EUR | Doc 01 §3.3 + Doc 05 §6 |
| A-5 | Setup-Gebühr 1.000 EUR Cloud / 1.900 EUR Cloud Plus wird akzeptiert | Doc 05 §6 |
| A-6 | "CRM" als Begriff ist im Kopf des Handwerkers nicht verankert | Doc 01 §3.3 |
| A-7 | Push-Marketing notwendig, Kunde sucht nicht aktiv | Doc 01 §4.1 |
| A-8 | Bidirektionale ERP-Anbindung (Taifun/KWP/TopKontor/Streit) ist machbar als P0-Konnektor in Cloud Plus | Doc 06 §3.3 + Doc 02 §14 |
| A-9 | Vier ERPs (Taifun, KWP, TopKontor, Streit V.1) decken den relevanten Markt ab | Doc 01 §2.1 (genannt als "Ist-Zustand IT") + Doc 06 §3.3 |
| A-10 | Multi-Tenancy via tenantId / SaasRock-Standard ist tragfähig | Doc 06 §1 + Doc 07 R-1 (offiziell offen, aber im PRD vorausgesetzt) |
| A-11 | Native Mobile-App (iOS + Android) ist Pflicht und in der Roadmap-Zeit machbar | Doc 06 §4 + Doc 07 RI-1 (Risiko erkannt, Mitigation: PWA als Notlösung) |
| A-12 | Form Builder als XL-Feature (Google-Forms-Niveau) wird zum Launch geliefert | Doc 02 §7 |
| A-13 | Trigger→Aktion-Automations-Engine mit Volumen-Quoting (Zapier-artig) zum Launch | Doc 02 §10 (P0, XL) |
| A-14 | Rechtssichere digitale Signatur (IP, Timestamp, Identifikation) ohne weitere eIDAS-Klärung umsetzbar | Doc 06 §5 + Doc 07 R-7 (offen, aber im PRD bereits P0) |
| A-15 | Kundenportal-Zugang "ab Sales-Prozess" und "bleibt nach Abschluss offen" wird vom Endkunden tatsächlich genutzt | Doc 02 §8 + Doc 04 Journey 4 |
| A-16 | Smart-Onboarding (Branche/Größe wählen → System konfiguriert sich) ist mit angemessenem Aufwand baubar (P1, L) | Doc 02 §17 |
| A-17 | "Vorkonfigurierte Demo statt leerem Trial" überzeugt im 15-Min-Pitch | Doc 04 Journey 5 + Doc 07 §6 (feste Entscheidung 16) |
| A-18 | Vertriebspartner-Modell (Agenturen mit Provision) ist umsetzbar und skaliert | Doc 01 §4.2 |
| A-19 | KI-Assistent zum Launch als "Programm-Hilfe" ist in Cloud-Lizenzpreis eingepreist | Doc 02 §12 + Doc 05 |
| A-20 | "Automationen als Kontrollorgan" ersetzen Mikromanagement | Doc 01 §3.2 + Doc 07 §6 (feste Entscheidung 12) |
| A-21 | Monteur-Nutzer-Lizenz für 5 EUR/Monat ist wirtschaftlich tragbar bei Storage/Push/App-Kosten | Doc 03 §5 + Doc 05 §3 |
| A-22 | Backoffice (Sandra) wird HiveGrid wirklich nur als Nebentool nutzen — diese Korrektur ist vom Partner Noah validiert (Brainstorming-Highlight) | Doc Brainstorming §"Breakthrough-Momente" + Doc 04 Journey 6 |
| A-23 | Die Aussage "Geerkens braucht/will Feature X" ist im Planning **nicht erwähnt** — Geerkens als initialer Kunde taucht in den Production-Docs **nicht namentlich auf**; das gesamte Planning operiert auf Personas-Ebene | (siehe Lücke L-1) |
| A-24 | Email-Marketing in Cloud (auch 50-Mann-Betrieb braucht es) | Doc 07 §6 (feste Entscheidung 18) |
| A-25 | Telefonie-Integration in Cloud (nicht erst Enterprise) | Doc 07 §6 (feste Entscheidung 19) |
| A-26 | Wartungsverträge und Einsatzplanung "bleiben in der ERP" — HiveGrid baut das nicht | Doc 07 §6 (feste Entscheidung 20) |
| A-27 | "Cloud bekommt feste Entitäten" (kein Entity Builder), "Workflow Engine nur Enterprise" — diese Reduktion vereinfacht Cloud genug für Standard-Pricing | Doc 06 §7 + Doc 07 §6 (Entscheidung 6) |
| A-28 | M.Y.R.A. (in Enterprise-KI erwähnt) ist eine bekannte/existierende Komponente | Doc 02 §12 + Doc 05 (Begriff nicht erklärt) |
| A-29 | "5-7 Tage Trial" ist die richtige Trial-Dauer | Doc 05 §5 |
| A-30 | Telefonie-Anbieter (Aircall, Sipgate) decken Zielgruppe ab — Priorisierung explizit offen (PR-3), aber als Launch-P0 gesetzt | Doc 02 §14 vs. Doc 07 PR-3 |
---
## Auffällige Lücken im Planning
| # | Lücke | Was fehlt |
|---|---|---|
| L-1 | **Initialkunde Geerkens** | In keinem Production-Dokument namentlich erwähnt. Keine Anforderungs-Mapping zu Geerkens-Spezifika, kein Pilot-Plan, kein Discovery-Bericht von Geerkens, kein Onboarding-Plan für den Erstkunden. |
| L-2 | **Keine Architecture-Doc** | `06-TECHNICAL-REQUIREMENTS.md` ist Anforderungsliste, kein Solution-Design. Keine ADRs, keine Komponentendiagramme, keine Sequenzdiagramme, kein Modul-Schnitt. |
| L-3 | **Keine Epics/Stories** | `implementation-artifacts/` ist leer. Keine Story-Granularität, keine Acceptance Criteria, keine Definition of Done, keine Sprint-/Release-Planung, keine Dependency-Graphen. |
| L-4 | **Migration aus Bestandssystem** | Wie wird ein Betrieb aus WhatsApp/Excel/Google Drive migriert? Datenimport für historische Kontakte, alte Angebote, laufende Projekte? Nicht behandelt. CSV-Import für User existiert (Doc 02 §17.1), für Domain-Daten nicht. |
| L-5 | **DSGVO/Datenschutz nur oberflächlich** | AVV erwähnt (R-3), Löschkonzept als offene Frage (R-2), Datenexport offen (R-4) — aber keine Datenklassifizierung, keine Auftragsverarbeiter-Liste, kein Privacy-by-Design-Konzept, keine Cookie-/Consent-Behandlung, kein Drittland-Transfer-Thema (Stripe US, ggf. KI-APIs). |
| L-6 | **Support / Customer Success** | Kein Support-Konzept (SLA, Response Times, Channels — Email/Chat/Telefon?). Keine Eskalationspfade. Keine Knowledge-Base für Endnutzer (anders als die Tenant-interne KB). Keine Trainings-/Schulungs-Materialien. Onboarding endet bei "Go-Live", danach undefiniert. |
| L-7 | **Pricing-Kalkulation unfertig** | 7 von 7 Pricing-Punkten in Doc 07 sind explizit "TBD". Es gibt keine Margenrechnung, keine Cost-of-Goods (Hosting, Storage pro Tenant, Push-Volumen, KI-API-Kosten). |
| L-8 | **Onboarding-Flows nur grob skizziert** | Doc 04 Journey 5 ist High-Level. Smart-Onboarding (Doc 02 §17.3) ist als P1-Feature gelistet, aber nicht spezifiziert: Welche Branchen-Templates? Welche Pipelines werden vorkonfiguriert? Welche Permission-Bundles per Default? |
| L-9 | **Fehlerfälle & Edge Cases** | Was passiert wenn: ERP-Sync fehlschlägt? Stripe-Zahlung scheitert? Endkunde unterschreibt nicht in 14 Tagen? Monteur arbeitet offline und Daten kollidieren beim Sync? Keine Behandlung dieser Pfade. |
| L-10 | **Messaging zu nicht-Handwerk** | ICP sekundär: "Agenturen, IT-Dienstleister, andere Mittelständler" — aber kein Messaging, keine angepasste Demo-Konfig, keine Branding-Klärung (heißt das Produkt für Agenturen auch HiveGrid? Geht das mit dem Slogan "Plattform die dein ERP ergänzt"?). |
| L-11 | **Mobile App: Tech-Entscheidung offen** | R-6 explizit offen (React Native vs. Flutter vs. PWA-Wrapper vs. Native), obwohl die App P0 zum Launch ist und das größte Single-Risk (RI-1). |
| L-12 | **Offline-Konflikt-Auflösung** | Offline-Fähigkeit für Checklisten genannt (P1, Doc 06 §4), aber kein Konfliktlösungs-Konzept (zwei Geräte editieren dieselbe Checkliste). |
| L-13 | **Audit-Log: Retention & Compliance** | P0 (Doc 02 §16), aber keine Aufbewahrungsfrist, keine Manipulationssicherheit, keine Export-Funktion bei Audits/Behörden definiert. |
| L-14 | **Mehrmandantigkeit innerhalb eines Tenants** | Was wenn ein Konzern mit mehreren Niederlassungen ein Konto will? "Sweet Spot 40-75 MA" deckt das nicht ab, aber "nach oben offen" lässt es offen. |
| L-15 | **Wettbewerbs-Recherche dünn** | Nur 4 grobe Vergleiche im Pricing-Dokument. Keine Auseinandersetzung mit handwerksspezifischen Tools (OpenHandwerk, Plancraft, Craftnote, ToolTime, Wolters, etc.) — gerade weil HiveGrid in dieselbe Nische zielt. |
| L-16 | **Internationalisierung Strategie** | DE/EN zu Launch (P0), TR/PL P2. Aber keine Aussage zu Märkten außerhalb DACH, Währungsfähigkeit, Steuerlogik (USt., Reverse-Charge), Rechtsraumen. |
| L-17 | **Notification-Throttling / Spam-Schutz** | Push für "alle relevanten Events" (Doc 06 §4), aber keine Anti-Spam-/Bündelungs-Logik. Risiko: Monteure schalten Push aus, App wird unbrauchbar. |
| L-18 | **Mehrere Pipelines pro Tenant** | "Pipeline" als Entität (Doc 06 §2.2) klingt nach generisch, aber Doc 02 spricht von "Vertriebspipeline" und "Auftragspipeline" als feste Konzepte. Können Tenants eigene zusätzliche Pipelines anlegen? Nicht eindeutig. |
| L-19 | **Konkrete Reporting-Anforderungen** | "Strategische KPIs" P1, aber keine Liste konkreter Reports. Welche Visualisierungen? Welche Zeiträume? Welche Drill-Downs? |
| L-20 | **Branding und Marketing-Material außerhalb der Landing Page** | Eine Landing Page existiert (Mar-10), aber keine Brand-Guidelines, keine Pitch-Deck-Quellen, keine Sales-Skripte für den 15-Min-Pitch (der laut Plan überzeugen muss). |
| L-21 | **API-Umfang offen** | Doc 02 §14.6 sagt "REST API P0", Doc 07 R-5 sagt der Umfang ist offen (Read-only/CRUD/eingeschränkt) — interner Widerspruch. |
| L-22 | **Provider-/Auftragsverarbeiter-Mapping** | KI-Assistent (welcher Provider?), Email-Marketing (welcher Sender?), Push (Firebase/APNs), Storage (S3-kompatibel: AWS? Wasabi? Hetzner?), Hosting (TBD) — alles ungeklärt. Hat direkten DSGVO-Impact. |
| L-23 | **Skalierungs-/Performance-Anforderungen** | Keine NFRs: Wie viele Tenants concurrent? Wie viele Chat-Nachrichten/Tag? Wie viele Foto-Uploads pro Projekt? Welche Antwortzeiten? Keine SLAs. |
| L-24 | **Test-/QA-Strategie** | Komplett nicht behandelt (keine Test-Pyramide, keine UAT-Pläne, keine E2E-Strategie, keine Beta-Kunden-Strategie). |
---
## Geplant aber vermutlich nie gebaut
(Hinweis: aus dem Planning allein nicht final beurteilbar — die folgenden Punkte sind Kandidaten, weil sie als P0/XL gelistet sind, ungewöhnlich ambitioniert wirken und in den späteren Codebase-Anläufen typischerweise zuerst zurückgestellt werden.)
- **Native Mobile-App iOS + Android** (P0, XL, Tech-Entscheidung offen — typisches Risk-1-Item)
- **Form Builder à la Google Forms** (P0, XL — sehr breite Funktion)
- **Automations-Engine mit Trigger-Volumen-Quoting** (P0, XL — eigene Engine ist groß)
- **Bidirektionale ERP-Konnektoren Taifun/KWP/TopKontor/Streit** (P0, XL, Cloud Plus — Risiko RI-2)
- **Rechtssichere digitale Signatur** (P0, L — eIDAS-Frage offen, R-7)
- **Smart-Onboarding mit Branchen-Auto-Konfiguration** (P1, L — komplex)
- **Telefonie-Integration mit Transkript-Import** (P0, L)
- **Kundenportal als Upgrade-Modul mit eigener Login-Schiene** (P0, mehrere L-Features)
- **Automations-Ketten im Email-Marketing** (P1, L)
- **GF-Dashboard mit Vertriebler-Performance + "warum"-Analyse** (P0, M, aber semantisch sehr ambitioniert)
---
## Feature-Cheatsheet (alphabetisch)
- **@-Mentions** — Verlinkung auf Projekte/Deals/Kontakte/Personen im Chat (P1).
- **Abnahme-Checkliste** — Im Projekt-Chat verfügbar, durch Monteur oder PL ausfüllbar (P0).
- **Abrechnungsmodell** — Stripe-basiert, monatlich oder jährlich mit Rabatt (TBD %), keine Usage-Kosten außer Trigger-Volumen.
- **Abschluss-Automation** — Bei "Abgeschlossen": Bewertungs-Email + Buchhaltungs-Notification (P1).
- **Activity-Feed / Audit-Log** — Wer hat wann was geändert (P0).
- **Aircall/Sipgate-Integration** — Anrufe aus HiveGrid mit Auto-Logging und Transkript (P0).
- **Aktivitäts-Metriken** — Aggregat-Auswertung Anrufe/Updates pro Person (P1).
- **Angebots-PDF-Upload** — Aus ERP exportiertes PDF im Deal hochladen (P0).
- **API (REST)** — Standard-API in allen Stufen (P0); Custom Endpoints nur Enterprise.
- **Audit-Filter** — Filter pro Person/Modul (P1).
- **Aufgaben aus Chat** — Nachricht als Aufgabe markieren, Person + Deadline + erledigt (P0).
- **Auftragspipeline** — Kanban: angenommen → Vorbereitung → Ausführung → Abnahme → abgeschlossen (P0).
- **Automation-Engine** — Wenn-Dann-Regeln, unbegrenzte Anzahl, Trigger-Volumen-Aufpreis (P0, XL).
- **Automations-Ketten Marketing** — If öffnet → Follow-up nach X Tagen (P1).
- **AVV (Auftragsverarbeitung)** — Rechtliche Pflicht, Verantwortung Raphael (offen).
- **Backoffice-Sicht (Sandra)** — Minimaler Zugang: Kalender, HR-Dokumente, Status lesend.
- **Basis-Analytics Email** — Open-/Click-Rate (P1).
- **Benachrichtigungen Push/Email/In-App** — Drei Kanäle parallel (P0).
- **Bidirektionale Navigation** — Aus Deal/Projekt in Chat und zurück (P0).
- **Blog-Funktion** — Im Kundenportal-Upgrade enthalten (P2).
- **Büro-Nutzer** — Volllizenz, 5 in Grundlizenz inkludiert.
- **Chat 3 Ebenen** — Projekt, Gruppe, Einzel (P0).
- **Chat-Archivierung** — Mit Projekt automatisch archiviert (P0).
- **Chat-Übersetzung** — Auto-Übersetzung von Nachrichten (P2, Nice-to-have).
- **Cloud-Stufe** — Standard-Features, branchenneutral, ~350 EUR/Monat Grundlizenz.
- **Cloud Plus-Stufe** — + Handwerks-ERP-Anbindung, ~1.900 EUR Setup.
- **CSV-Import (Mitarbeiter)** — Onboarding-Hilfe (P0).
- **Datev-Integration** — Buchhaltung, Mahnwesen (P1).
- **Datenexport** — Tenant kann alle Daten exportieren (P1, Format offen).
- **Datenisolation** — Logisch via tenantId (Empfehlung, finale Entscheidung Raphael).
- **Deal-Karte** — Kunde, Volumen, Deadline, Zuständiger (P0).
- **Deal-Notizen/Aktivitäten** — Chronologische Historie (P0).
- **Deal-Pipeline (Kanban)** — Anfrage → Besichtigung → Angebot → Verhandlung → Gewonnen/Verloren (P0).
- **Deal-zu-Projekt-Automation** — Bei "Gewonnen" automatisch Projekt-Ticket (P0).
- **Demo (vorkonfiguriert)** — Mit Beispieldaten zum Probieren (P0).
- **Digitale Signatur** — Angebot + Abnahme; rechtssicher mit IP/Timestamp (P0).
- **DocuSign-Integration** — Cloud Plus Connector (P0, C+).
- **Dokumenten-Ablage** — Kontextgebunden an Deal/Projekt (P0).
- **Dokumenten-Versionierung (KB)** — Alte Versionen nachvollziehbar (P1).
- **Drag&Drop Pipeline** — Deals/Projekte zwischen Spalten (P0).
- **Effizienz-Metriken** — Aggregat pro Person (P1).
- **Email-Einladung Mitarbeiter** — Einzeln einladen (P0).
- **Email-Kampagnen-Versand** — Zeitgesteuert an Segmente (P0).
- **Email-Marketing** — Templates, Listen, Kampagnen (P0).
- **Email-Notifications** — Parallel zu Push (P0).
- **Empfehlungs-Automation** — Zufriedene Kunden → Empfehlungsmail (P2).
- **Endkunden-Formulare** — Link-basiert, Daten fließen in Deal/Projekt (P0).
- **Endkunde / Portal-Nutzer** — Kein Tenant-Member; nur Status, Doc, Kommunikation, Signatur.
- **Enterprise-Stufe** — + Entity Builder, Workflow Engine, MCP-KI/M.Y.R.A., volle Anpassung; auf Anfrage.
- **Entity Builder** — Nur Enterprise (Cloud bekommt feste Entitäten).
- **ERP-Connector Taifun/KWP/TopKontor/Streit V.1** — P0 für Cloud Plus, XL.
- **Eskalations-Automation** — Status-Stagnation triggert Erinnerung (P1).
- **FAQ-KI** — Beantwortet Fragen zur Nutzung des Systems (P0).
- **Filter Vertrieb pro Person** — Eigene Deals oder alle (P0).
- **Filter Projekt pro PL** — Zugewiesene Projekte (P0).
- **Foto-Checklisten** — Welche Fotos der Monteur machen muss (P0).
- **Foto-Upload aus App** — Direkt oder aus Camera Roll (P0).
- **Form Builder** — Frei konfigurierbar à la Google Forms (P0, XL).
- **Formular-Embed** — Code für Handwerker-Website (P0).
- **Formular→Deal-Automation** — Kontaktformular erstellt Deal (P0).
- **Freigabe-Link** — Kunde sieht Angebot via Link (P0).
- **GF-Dashboard** — Aggregat-KPIs, Pipeline, Forecast, Vertriebler-Performance (P0).
- **Google-Bewertungs-Automation** — Nach Abschluss Bewertungsanfrage (P1).
- **Google Calendar-Sync** — P1.
- **Gruppen-Chats** — Frei erstellbar (z.B. "Team Süd") (P0).
- **HR-Dokumente** — Vertrag, Zertifikate, Lohnabrechnungen (P0/P1).
- **i18n (DE/EN)** — Launch-Sprachen (P0); TR/PL später (P2).
- **In-App-Notifications** — Notification Center im Web (P0).
- **Jahresabo** — Mit Rabatt (Prozent TBD).
- **Kalender-Feature** — Backoffice nutzt; Umfang offen (PR-7).
- **Kanban-Boards** — Für Deals und Projekte (P0).
- **Kanalstruktur (Slack-artig)** — #projekt-xy, #team-xy, #allgemein (P1).
- **KI-Dokument-Suche** — "Finde Abnahmeprotokoll Müller" (P1).
- **KI-Programm-Hilfe** — Erklärt Features (P0).
- **KI-Zusammenfassungen** — Wochen-Reports im Dashboard (P2).
- **KI Erweitert (M.Y.R.A.)** — Nur Enterprise, MCP-Tools (P2).
- **Kontakte zentral** — Stammdatenverwaltung (P0).
- **Kontakthistorie** — Anrufe/Emails/Chats chronologisch (P0).
- **Kontakte-zu-Deals/Projekt-Verknüpfung** — Sichtbar am Kontakt (P0).
- **Konfigurierbare Notifications** — Nutzer wählt Kanäle (P1).
- **Krankmeldung als Formular** — Auto-Versand ans Büro (P1).
- **Kunden-Login Portal** — Email/Passwort oder Magic Link (P0).
- **Kunden-Upload Portal** — Reklamations-Fotos etc. (P0).
- **Kunden-zu-Firma-Kommunikation Portal** — Optional aktivierbar (P1).
- **Kundenportal-Upgrade** — Modul für Cloud/Cloud Plus, in Enterprise inkl.
- **Kundenunterschrift Smartphone** — Auf Abnahme-Checkliste (P0).
- **Lead-Auto-Erstellung** — Aus Kontaktformular Deal (P0).
- **Leselisten/Lesebestätigungen** — Hat Monteur gelesen? (P1).
- **LexOffice-Integration** — Buchhaltung (P1).
- **Löschkonzept** — Nach Kündigung; Frist offen (R-2).
- **Magic Link Login** — Für Endkunden (P0).
- **Marketing-Rolle** — Email-Marketing, Lead-Einsicht, Content.
- **Mehrsprachigkeit Chat** — Nice-to-have (P2).
- **Mitarbeiterplattform** — Persönlicher Bereich, HR-Dokumente, Formulare (P0/P1).
- **Mobile App (iOS + Android)** — Native, Pflicht (P0, XL).
- **Mobile Datenerfassung Vertrieb** — Fotos, Checklisten vor Ort (P0).
- **Mobile-First Monteur-UI** — WhatsApp-simpel (P0).
- **Monteur-Lizenz** — ~5 EUR/Monat, eingeschränkter Zugang.
- **Monteur-Sicht: nur aktive Projekte** — Archiviertes verschwindet (P0).
- **Notification Center** — Web-In-App (P0).
- **Offline-Fähigkeit (Mobile)** — Mind. Checklisten offline (P1; R-8).
- **Onboarding-Tool-Integration** — Statt Eigenentwicklung (P2; PR-1).
- **Passwort-Safe** — Geteilte Firmenzugänge (P1).
- **Permission-Bundles** — ~20 Ja/Nein-Schalter pro Rolle.
- **Pinned Messages** — Wichtige Projektinfos angeheftet (P1).
- **Pipedrive-Integration** — CRM-Anbindung (P1).
- **Pipeline-Eskalation** — Status-Stagnation triggert Erinnerung (P0).
- **PL-Mini-Dashboard** — Eigene Projekte, Status-Verteilung (P2).
- **PortalUser** — Kostenlos, kein Tenant-Member.
- **Programm-Assistent (KI)** — Hilft Navigation/Features (P0).
- **Projekt-Chat automatisch** — Bei Projekterstellung (P0).
- **Projekt-Dokumente** — Fotos, Protokolle, Anleitungen (P0).
- **Projekt-Kanban** — Auftragspipeline (P0).
- **Projektleiter** — Hoher HiveGrid-Use, Power-User.
- **Push-Notifications** — Mobile (P0).
- **Rechnungs-Tracking** — Verwaltungsleistung sichtbar (P1).
- **REST-API** — In allen Stufen (P0).
- **Rollen vorkonfiguriert** — GF, VL, Vertriebler, PL, Backoffice, Marketing, Monteur.
- **Rollen frei anlegbar** — Ergänzend zu vorkonfigurierten.
- **Ruhezeiten-Notifications** — Individuell konfigurierbar (P1).
- **Sales-Datenaufnahme-Formulare** — Dachfläche, Verbrauch etc. (P0).
- **Segment-Filter CRM** — Für Email-Marketing (P1).
- **Self-Service Signup (später)** — Initial Vertrieb, später direkt (PR-4).
- **Setup-Gebühr** — Cloud 1.000 EUR / Cloud Plus 1.900 EUR / Enterprise auf Anfrage.
- **Smart-Onboarding** — Branche/Größe → Auto-Konfiguration (P1).
- **Standard-Status-Email Portal** — "Neue Dokumente verfügbar" (P1).
- **Status-Automation Signatur** — Unterschrift ändert Deal-Status (P0).
- **Strategische KPIs** — Auslastungstrend, Wachstum (P1).
- **Subscription-Stufen** — Cloud / Cloud Plus / Enterprise.
- **Suche Wissensdatenbank** — Volltextsuche (P0).
- **Threads** — Sub-Diskussionen im Chat (P2).
- **Telefonie-Integration** — Aircall/Sipgate (P0).
- **Trial 5-7 Tage** — Vertrieb gibt frei.
- **Trigger-Volumen-Modell** — Zapier-artig, Aufpreis bei Überschreitung (P0).
- **Umsatz-Forecast** — Pipeline-Volumen × Wahrscheinlichkeiten (P0).
- **Upload-Erinnerungen MA** — Z.B. Führerschein-Scan in Intervall (P2).
- **Urlaubsantrag-Workflow** — Formular → Genehmigung → Kalender (P2).
- **Versionierung Angebote** — V1, V2, V3 nachvollziehbar (P1).
- **Versionierung Dokumente** — In KB (P1).
- **Vertriebler-KPIs** — Eigene Abschlussquote, Volumen, Vergleich (P0).
- **Vertriebler-Performance (GF-Sicht)** — Sieht WARUM jemand nicht performt (P0).
- **Vertriebsleiter-Rolle** — Identisch GF im Vertrieb.
- **Vorkonfigurierte Demo** — Beispieldaten beim Trial (P0).
- **Web-Applikation** — SaasRock-Basis, React Router v7 (P0).
- **Webhook-Support** — Für Automationen ein/aus (P0).
- **Wenn-Dann-Automationen** — Trigger→Aktion (P0).
- **Wiki / Knowledge Base** — Firmenintern, kontextgebunden (P0).
---
## Schluss
Der März-Stand ist eine **breite Vision + Feature-Liste auf hoher Detailtiefe** (97 Features inkl. Prio + Stufe + Aufwand) und **7 End-to-End-Journeys**, aber ohne Architektur-Design, ohne Epic-/Story-Granularität, ohne Migrations-/Support-/Test-Strategie und ohne Kunden-spezifischen Pilot-Plan (Geerkens fehlt). Die kritischen Entscheidungen sind bewusst offen markiert (8 R-Punkte für Raphael, 7 P-Punkte Pricing, 8 PR-Punkte Produkt) — d.h. das Planning **dokumentiert seine eigene Unfertigkeit**, was eine ehrliche Grundlage für ein Re-Planning bildet.