Update hivegrid-cloud reference to latest main

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 16:15:37 +02:00
1 parent e98d38e716
commit 7b21524c86
3781 files changed
+373484 -225607

No files matched your search

@@ -76,7 +76,7 @@ Pflichten-/Lastenheft muss pro Feature liefern: Menüpfad, Entitäten/Felder, Su
Jedes Feature, jede Integration, jede Automation muss eine **fest formulierte Klartext-Erklärschicht** haben (Variante a, nicht KI-on-the-fly). Pro Fehler-Case ist ein menschenlesbarer Text + Lösungs-Button definiert. Kein Feature wird ohne diese Erklärschicht gemerged. Schiebt Spec-Tiefe weiter nach oben — gewollt.
### LP-11 — Adapter-Pattern als Architektur-Vorschrift (aus Modul 19/33a)
Externe Integrationen (KWP, Gmail, AirCall, Stripe, PandaDoc, Calendar...) sprechen gegen ein abstraktes Adapter-Interface, nicht direkt. Die "Apps Engine" liefert dieses Interface. KWP ist die erste ERP-Implementierung. Andere ERPs (Taifun, TopKontor, Streit) hängen sich später an dasselbe Interface, ohne dass Engine umgebaut wird. Connection-Settings, Sync-Jobs und Klartext-Diagnostik sind über alle Apps einheitlich.
Externe Integrationen (KWP, Gmail, AirCall, Legacy-Provider, PandaDoc, Calendar...) sprechen gegen ein abstraktes Adapter-Interface, nicht direkt. Die "Apps Engine" liefert dieses Interface. KWP ist die erste ERP-Implementierung. Andere ERPs (Taifun, TopKontor, Streit) hängen sich später an dasselbe Interface, ohne dass Engine umgebaut wird. Connection-Settings, Sync-Jobs und Klartext-Diagnostik sind über alle Apps einheitlich.
### LP-12 — i18n extrem sauber, mehrere Sprachen easy
Alle UI-Strings konsequent aus Locale-Files. Phase 1: nur DE-Locale befüllt. Phase 2: DeepL-Pipeline für DE→EN/TR/PL Übersetzungen. Damit ist Sprache wirklich kostenlos erweiterbar.
@@ -146,7 +146,7 @@ Ein-Jahr-zurück-Blick (Mai 2027). 5 Failure-Szenarien durchgegangen, pro Szenar
| 25 | Calendar-Sync (Google + MS) | **Phase 1, voll, bidirektional** | OAuth pro User |
| 26 | Tasks | **Phase 1, voll** | Aus Chat / Form / Automation erstellbar |
| 27 | Auth/Multi-Tenancy/Rollen | **Phase 1, voll** | Inkl. **2FA** (User-Korrektur), 7 Rollen, Magic-Link, OAuth Microsoft (kein Google wegen SIWA-Trigger) |
| 28 | Subscriptions/Billing | **Phase 1** | Stripe + Seat-Modell (Büro/Monteur) + Trial + Read-Only-Downgrade |
| 28 | Subscriptions/Billing | **Phase 1** | Legacy-Provider + Seat-Modell (Büro/Monteur) + Trial + Read-Only-Downgrade |
| 29 | Onboarding | **Phase 1, deklarativ branchen-modular** | SHK pre-selected, andere "Coming soon", Demo-Daten-Provisioning |
| 30 | i18n / Mehrsprachigkeit | **Phase 1, DE-only** | Library extrem sauber, Phase 2 DeepL-Pipeline (LP-12) |
| 31 | Branding/Theme | **Phase 1: nur Light/Dark-Mode** | Rest Phase 2 (User-Korrektur) |
@@ -298,7 +298,7 @@ React Router v7 (Remix-basiert, SSR + Client Hydration) auf Node.js 20 / pnpm 10
- **Communication:** Slack, MS Teams, Zoom.
- **Forms:** JotForm, Typeform.
- **Ads:** Facebook Leads, Google Ads (Lead Form).
- **Payments:** Stripe Connect, SumUp.
- **Payments:** Legacy-Provider 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.
@@ -309,16 +309,16 @@ React Router v7 (Remix-basiert, SSR + Client Hydration) auf Node.js 20 / pnpm 10
- **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.
- Subscriptions, Delivery, Delivery-Attempts, Incoming-Ingestion. Verschiedene Provider-Webhooks: Mailersend, Postmark, Aircall, Sipgate, DocuSign, PandaDoc, Calendly, Legacy-Provider, 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)
### Subscriptions / Billing (Legacy-Provider)
- **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.
- **Operationen:** Legacy-Provider-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)
@@ -365,7 +365,7 @@ React Router v7 (Remix-basiert, SSR + Client Hydration) auf Node.js 20 / pnpm 10
| **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). |
| **Legacy-Provider** | Subscriptions, Checkout, Webhook, Dunning, Connect (Marketplace-Auszahlungen). |
| **SumUp** | Payment-Adapter. |
| **LexOffice / sevDesk / FastBill** | Buchhaltungs-Adapter (Rechnung erstellen, Sync). |
| **Datev** | Action: `datev-export-data` (Datenexport). |
@@ -401,7 +401,7 @@ React Router v7 (Remix-basiert, SSR + Client Hydration) auf Node.js 20 / pnpm 10
- 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`
- Payments/Buchhaltung: `legacyProvider-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`
@@ -543,8 +543,8 @@ React Router v7 (Remix-basiert, SSR + Client Hydration) auf Node.js 20 / pnpm 10
- **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.
- **Legacy-Provider-Subscriptions + Checkout + Dunning + Trial** — vollstaendiger Billing-Flow.
- **Legacy-Provider-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.
@@ -17,7 +17,7 @@
| `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/06-TECHNICAL-REQUIREMENTS.md` | 2026-03-07 | 8,2 KB | Architektur / Technical Brief | LegacySourceProduct-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 |
@@ -124,7 +124,7 @@ Aktivitäts-Feed (P0); Filter pro Person/Modul (P1); Effizienz-Metriken (P1).
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).
Web-App (P0, LegacySourceProduct-Basis); Native iOS+Android-App (P0, **Pflicht**); Mobile-First-Monteur-UI (P0).
---
@@ -135,7 +135,7 @@ Das Dokument 06 ist primär Anforderungsliste. Die folgenden konzeptionellen Kom
**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)
- Subscription-/Billing-Modul (Legacy-Provider, gestaffelt Cloud/Cloud Plus/Enterprise)
**Domain-Module:**
- Kontakt-/CRM-Modul
@@ -174,7 +174,7 @@ Das Dokument 06 ist primär Anforderungsliste. Die folgenden konzeptionellen Kom
- REST-API + Webhooks
**Plattformen:**
- Web (SaasRock/React Router v7)
- Web (LegacySourceProduct/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):
@@ -256,7 +256,7 @@ Die **7 Journeys** sind:
| 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-10 | Multi-Tenancy via tenantId / LegacySourceProduct-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) |
@@ -288,11 +288,11 @@ Die **7 Journeys** sind:
| 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-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 (Legacy-Provider 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-9 | **Fehlerfälle & Edge Cases** | Was passiert wenn: ERP-Sync fehlschlägt? Legacy-Provider-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). |
@@ -332,7 +332,7 @@ Die **7 Journeys** sind:
- **@-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.
- **Abrechnungsmodell** — Legacy-Provider-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).
@@ -473,7 +473,7 @@ Die **7 Journeys** sind:
- **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).
- **Web-Applikation** — LegacySourceProduct-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).
@@ -725,11 +725,11 @@
<table>
<thead><tr><th class="col-feat">Sub-Feature</th><th class="col-verd">Verdikt</th><th class="col-note">Anmerkung</th></tr></thead>
<tbody>
<tr><td>Stripe-Checkout mit DPA</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>Legacy-Provider-Checkout mit DPA</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>Subscription-Lifecycle (Trial→Active→Past-Due→Cancelled)</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>Seat-Modell: Büro-Seat + Monteur-Seat</td><td><span class="verd-p1">Phase 1</span></td><td>Spiegelt LP-2</td></tr>
<tr><td>Trial-Phase 5-7 Tage (Vertrieb gibt frei)</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>Dunning (Stripe-Standard)</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>Dunning (Legacy-Provider-Standard)</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>Downgrade-Read-Only-Middleware</td><td><span class="verd-p1">Phase 1</span></td><td>Bei Plan-Ablauf</td></tr>
<tr><td>Service-Metering (Trigger-Volumen, AI-Token)</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>
<tr><td>AI-Credits-System</td><td><span class="verd-p1">Phase 1</span></td><td></td></tr>