Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
Binary file not shown.
BIN
Binary file not shown.
+2
-2
@@ -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) |
|
||||
|
||||
+8
-8
@@ -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.
|
||||
|
||||
+9
-9
@@ -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).
|
||||
|
||||
+2
-2
@@ -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>
|
||||
|
||||
BIN
Binary file not shown.
@@ -75,7 +75,7 @@ Damit es bei der Durchsprache keine Begriffsverwirrung gibt:
|
||||
| **Auslöser (Trigger)** | Das Ereignis, das eine Automatisierung startet (z. B. „Neuer Lead eingegangen"). |
|
||||
| **Aktion (Action)** | Was die Automatisierung macht, wenn der Auslöser gefeuert hat (z. B. „Email senden"). |
|
||||
| **Vorschau (Dry-Run)** | Eine Automatisierung wird ohne echte Wirkung simuliert, der Nutzer sieht, was passieren WÜRDE, bevor er es freigibt. |
|
||||
| **Apps-Engine** | Die zentrale Schicht, über die alle externen Systeme (KWP, Gmail, AirCall, Stripe, ...) angebunden werden, einheitlich, austauschbar. |
|
||||
| **Apps-Engine** | Die zentrale Schicht, über die alle externen Systeme (KWP, Gmail, AirCall, Legacy-Provider, ...) angebunden werden, einheitlich, austauschbar. |
|
||||
| **Adapter** | Die konkrete Anbindung an ein bestimmtes externes System (z. B. der KWP-Adapter). Steht hinter der Apps-Engine. |
|
||||
| **KWP** | Die ERP-Software, mit der Geerkens heute Aufträge und Rechnungen verwaltet. Bleibt System-of-Record für Abrechnung. |
|
||||
| **System-of-Record** | Das System, in dem die maßgebliche Wahrheit für ein Daten-Thema liegt. Beispiel: KWP ist System-of-Record für die Auftrags-Abrechnung; HiveGrid ist System-of-Record für CRM und Workflow. |
|
||||
@@ -116,7 +116,7 @@ Damit es bei der Durchsprache keine Begriffsverwirrung gibt:
|
||||
| M25 | Calendar-Sync | Bidirektionale Synchronisation mit Google und Microsoft |
|
||||
| M26 | Tasks | Aufgaben mit Verknüpfung zu Kontakten, Verkaufsfällen, Aufträgen |
|
||||
| M27 | Auth, Mandanten, Rollen | Anmeldung, Mandanten-Trennung, 7 Rollen, 2-Faktor-Authentisierung |
|
||||
| M28 | Subscriptions / Billing | Stripe-Anbindung, Seat-Modell, Trial, Read-Only-Downgrade |
|
||||
| M28 | Subscriptions / Billing | Legacy-Provider-Anbindung, Seat-Modell, Trial, Read-Only-Downgrade |
|
||||
| M29 | Onboarding | Mandanten-Anlage mit Branchen-Wahl, Demo-Daten, Nutzer-Einladung |
|
||||
| M30 | i18n | Mehrsprachigkeit, Phase 1 nur Deutsch, vorbereitet für DeepL-Pipeline |
|
||||
| M31 | Branding | Light/Dark-Mode in Phase 1, alles weitere Phase 2 |
|
||||
|
||||
+1
-1
@@ -12,7 +12,7 @@ Diese 20 Vorschriften gelten **modulübergreifend für die gesamte Plattform**.
|
||||
|
||||
## A.2 Adapter-Schicht für jede Integration
|
||||
|
||||
A.2.1 Externe Systeme (KWP, Gmail, AirCall, Stripe, PandaDoc, Calendar, ...) werden **nur über die Apps-Engine** (Modul 33a) angebunden, nie direkt aus einem Modul heraus.
|
||||
A.2.1 Externe Systeme (KWP, Gmail, AirCall, Legacy-Provider, PandaDoc, Calendar, ...) werden **nur über die Apps-Engine** (Modul 33a) angebunden, nie direkt aus einem Modul heraus.
|
||||
|
||||
A.2.2 Auch wenn aktuell nur eine konkrete Implementierung existiert (z. B. nur KWP als ERP), wird das Adapter-Interface so gebaut, dass weitere ERPs (Taifun, TopKontor) später ohne Engine-Umbau dazu kommen.
|
||||
|
||||
|
||||
+42
-42
@@ -245,7 +245,7 @@
|
||||
</tr>
|
||||
<tr>
|
||||
<td><strong>Apps-Engine</strong></td>
|
||||
<td>Die zentrale Schicht, über die alle externen Systeme (KWP, Gmail, AirCall, Stripe, ...) angebunden werden, einheitlich, austauschbar.</td>
|
||||
<td>Die zentrale Schicht, über die alle externen Systeme (KWP, Gmail, AirCall, Legacy-Provider, ...) angebunden werden, einheitlich, austauschbar.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><strong>Adapter</strong></td>
|
||||
@@ -426,7 +426,7 @@
|
||||
<tr>
|
||||
<td>M28</td>
|
||||
<td>Subscriptions / Billing</td>
|
||||
<td>Stripe-Anbindung, Seat-Modell, Trial, Read-Only-Downgrade</td>
|
||||
<td>Legacy-Provider-Anbindung, Seat-Modell, Trial, Read-Only-Downgrade</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>M29</td>
|
||||
@@ -550,7 +550,7 @@
|
||||
<p>A.1.2 <strong>Keine KI-on-the-fly-Übersetzung von Fehlertexten</strong> in Phase 1. Texte sind redaktionell vorgefertigt, durchsuchbar, mehrsprach-fähig (über das i18n-Modul M30).</p>
|
||||
<p>A.1.3 Kein Feature wird freigegeben, bevor die Klartext-Texte definiert und im Pflichtenheft des jeweiligen Moduls aufgeführt sind.</p>
|
||||
<h2 id="a2-adapter-schicht-für-jede-integration">A.2 Adapter-Schicht für jede Integration</h2>
|
||||
<p>A.2.1 Externe Systeme (KWP, Gmail, AirCall, Stripe, PandaDoc, Calendar, ...) werden <strong>nur über die Apps-Engine</strong> (Modul 33a) angebunden, nie direkt aus einem Modul heraus.</p>
|
||||
<p>A.2.1 Externe Systeme (KWP, Gmail, AirCall, Legacy-Provider, PandaDoc, Calendar, ...) werden <strong>nur über die Apps-Engine</strong> (Modul 33a) angebunden, nie direkt aus einem Modul heraus.</p>
|
||||
<p>A.2.2 Auch wenn aktuell nur eine konkrete Implementierung existiert (z. B. nur KWP als ERP), wird das Adapter-Interface so gebaut, dass weitere ERPs (Taifun, TopKontor) später ohne Engine-Umbau dazu kommen.</p>
|
||||
<p>A.2.3 Verbindungs-Status, Sync-Jobs und Klartext-Diagnostik sind <strong>über alle Apps einheitlich</strong>: gleiche Anzeige, gleiche Bedien-Logik.</p>
|
||||
<h2 id="a3-branchen-templates-deklarativ-nicht-hartkodiert">A.3 Branchen-Templates deklarativ, nicht hartkodiert</h2>
|
||||
@@ -934,7 +934,7 @@
|
||||
37.4.2 Mandanten-Verwaltung.
|
||||
37.4.3 Mandanten-Mitarbeiter-Verwaltung (alle Mitarbeiter aller Mandanten).
|
||||
37.4.4 Plattform-Admin-Verwaltung (unsere eigenen Konten und Rollen).
|
||||
37.4.5 Abo-Verwaltung (Anbindung an Stripe).
|
||||
37.4.5 Abo-Verwaltung (Anbindung an Legacy-Provider).
|
||||
37.4.6 Funktions-Schalter (siehe Modul 32).
|
||||
37.4.7 System-Gesundheit (Server, Hintergrund-Aufgaben, KWP-Sync).
|
||||
37.4.8 Plattform-weites Audit-Protokoll.
|
||||
@@ -979,10 +979,10 @@
|
||||
37.9.2 Plattform-Admin anlegen (Email, Name, Anfangs-Rolle), der Eingeladene bekommt einen Einrichtungs-Link mit verpflichtender 2FA-Einrichtung.
|
||||
37.9.3 Rolle ändern, deaktivieren, zweiten Faktor zurücksetzen (durch anderen Super-Admin), Sitzungen beenden.</p>
|
||||
<h3 id="3710-abo-verwaltung">37.10 Abo-Verwaltung</h3>
|
||||
<p>37.10.1 Liste aller Abos mit Mandant, Tarif, Monatsumsatz, Status, Verlängerungs-Datum, Stripe-Sync-Status.
|
||||
37.10.2 Detail-Ansicht mit Stripe-Verknüpfungen (Direkt-Link zum Stripe-Dashboard), aktuellem Tarif, Sitz-Anzahl (Büro + Monteur), Test-Phase, Rechnungs-Historie, Notizen über manuelle Sonder-Konditionen.
|
||||
37.10.3 Mögliche Aktionen: Stripe-Abgleich erzwingen, Tarif manuell überschreiben (Enterprise-Sonderpreise mit Begründungs-Pflicht), Test-Phase verlängern, manuelle Rechnung anstoßen, Abo kündigen, Rückzahlung anstoßen.
|
||||
37.10.4 Wenn die Daten in HiveGrid und in Stripe auseinanderlaufen, wird das im Detail mit Klartext-Vergleich angezeigt.</p>
|
||||
<p>37.10.1 Liste aller Abos mit Mandant, Tarif, Monatsumsatz, Status, Verlängerungs-Datum, Legacy-Provider-Sync-Status.
|
||||
37.10.2 Detail-Ansicht mit Legacy-Provider-Verknüpfungen (Direkt-Link zum Legacy-Provider-Dashboard), aktuellem Tarif, Sitz-Anzahl (Büro + Monteur), Test-Phase, Rechnungs-Historie, Notizen über manuelle Sonder-Konditionen.
|
||||
37.10.3 Mögliche Aktionen: Legacy-Provider-Abgleich erzwingen, Tarif manuell überschreiben (Enterprise-Sonderpreise mit Begründungs-Pflicht), Test-Phase verlängern, manuelle Rechnung anstoßen, Abo kündigen, Rückzahlung anstoßen.
|
||||
37.10.4 Wenn die Daten in HiveGrid und in Legacy-Provider auseinanderlaufen, wird das im Detail mit Klartext-Vergleich angezeigt.</p>
|
||||
<h3 id="3711-system-gesundheit">37.11 System-Gesundheit</h3>
|
||||
<p>37.11.1 Status pro Dienst (Web, API, Hintergrund-Aufgaben, Plan-Job-System, Datenbank, Zwischenspeicher, Datei-Speicher) mit Verfügbarkeit, Antwort-Zeiten, Fehler-Quote.
|
||||
37.11.2 Hintergrund-Aufgaben-Bereich mit Liste aller Warteschlangen (Automatisierung, Email-Versand, KWP-Sync, Datenschutz-Export …), Status (in Arbeit, wartend, fehlgeschlagen, abgeschlossen), Möglichkeit fehlgeschlagene Aufgaben erneut zu starten oder Warteschlangen zu pausieren.
|
||||
@@ -1031,12 +1031,12 @@
|
||||
<h3 id="3718-klartext-hinweise-beispiele">37.18 Klartext-Hinweise (Beispiele)</h3>
|
||||
<p>37.18.1 Status-Wechsel ohne Begründung: „Bitte Begründung angeben, wird im Audit-Log dauerhaft gespeichert."
|
||||
37.18.2 Stellvertreter-Anmeldung ohne Begründung: blockiert, gleicher Hinweis.
|
||||
37.18.3 Sonder-Tarif: „Diese Konditionen weichen vom Standard-Plan ab. Stripe wird nicht angepasst, manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]"
|
||||
37.18.3 Sonder-Tarif: „Diese Konditionen weichen vom Standard-Plan ab. Legacy-Provider wird nicht angepasst, manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]"
|
||||
37.18.4 Doppelte Plattform-Admin-Email: „Diese Email gehört bereits zu einem Plattform-Admin ‚X‘, bitte direkt diesen verwalten."
|
||||
37.18.5 Letzter Super-Admin: „Du bist der einzige Super-Admin. Rechte-Entzug nicht möglich. Bitte zuerst weiteren Super-Admin anlegen."
|
||||
37.18.6 Konto gesperrt nach Fehlversuchen: „Account gesperrt nach 10 Fehlversuchen. Bitte anderen Super-Admin um Reaktivierung bitten."
|
||||
37.18.7 Lösch-Anstoß im Auftrag: „Du startest die Kündigung für Mandant ‚X‘ im Auftrag. Bestätigungs-Email geht an alle Mandanten-Administratoren mit Cancel-Link."
|
||||
37.18.8 Stripe-Konflikt: „Stripe-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Stripe-Wert] vs. [HiveGrid-Wert]."
|
||||
37.18.8 Legacy-Provider-Konflikt: „Legacy-Provider-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Legacy-Provider-Wert] vs. [HiveGrid-Wert]."
|
||||
37.18.9 Warteschlangen-Pause: „Warteschlange ‚X‘ pausiert. Neue Aufgaben werden eingereiht aber nicht verarbeitet. Vergiss nicht zu reaktivieren!"
|
||||
37.18.10 Massen-Email an Mandanten-Administratoren: „Diese Email geht an X Mandanten-Administratoren. Bitte nochmal Betreff und Inhalt prüfen. [Senden]"</p>
|
||||
<h1 id="block-2-stammdaten">Block 2: Stammdaten</h1>
|
||||
@@ -1899,20 +1899,20 @@
|
||||
<p>Hier liegt der Wettbewerbsvorteil von HiveGrid gegenüber HubSpot/Quiply: eine einheitliche Anbindungs-Schicht für externe Systeme, eine Automatisierungs-Engine mit KI-Erstellung per Sprache, ein KI-Layer komplett auf europäischen Modellen (DSGVO), und die saubere Anbindung an die Geerkens-Bestands-ERP KWP.</p>
|
||||
<hr />
|
||||
<h2 id="modul-33a-apps-engine-einheitliche-anbindungs-schicht">Modul 33a: Apps-Engine (einheitliche Anbindungs-Schicht)</h2>
|
||||
<p><strong>Was es tut:</strong> Stellt eine einheitliche Anbindungs-Schnittstelle für alle externen Systeme bereit (KWP, Gmail, AirCall, Stripe, Google Calendar, PandaDoc, …). Jedes externe System wird zur „App", mit gleichem Verbindungs-Aufbau, gleichem Status-Verhalten, gleichen Fehler-Texten, gleichem Sync-Verlauf.
|
||||
<p><strong>Was es tut:</strong> Stellt eine einheitliche Anbindungs-Schnittstelle für alle externen Systeme bereit (KWP, Gmail, AirCall, Legacy-Provider, Google Calendar, PandaDoc, …). Jedes externe System wird zur „App", mit gleichem Verbindungs-Aufbau, gleichem Status-Verhalten, gleichen Fehler-Texten, gleichem Sync-Verlauf.
|
||||
<strong>Löst ab:</strong> Das individuelle Verdrahten externer Systeme (Zapier, Supabase-Glue, eigens gebaute Adapter).
|
||||
<strong>Warum es wichtig ist:</strong> Ohne diese Foundation wird jede neue Anbindung wieder Sonder-Code mit Sonder-Fehlern. Die Apps-Engine ist die Plattform-Grundlage, auf der KWP, Telefonie, Mail-Sync und Zahlungs-Anbindung sauber aufsetzen. <strong>Phase 1 ist nur die Auswahl der Apps, die Geerkens braucht</strong> (KWP, Gmail, AirCall, Stripe, Calendar). Marketplace und Drittanbieter-Apps sind ausdrücklich Phase 2.</p>
|
||||
<strong>Warum es wichtig ist:</strong> Ohne diese Foundation wird jede neue Anbindung wieder Sonder-Code mit Sonder-Fehlern. Die Apps-Engine ist die Plattform-Grundlage, auf der KWP, Telefonie, Mail-Sync und Zahlungs-Anbindung sauber aufsetzen. <strong>Phase 1 ist nur die Auswahl der Apps, die Geerkens braucht</strong> (KWP, Gmail, AirCall, Legacy-Provider, Calendar). Marketplace und Drittanbieter-Apps sind ausdrücklich Phase 2.</p>
|
||||
<h3 id="33a1-was-eine-app-ist">33a.1 Was eine App ist</h3>
|
||||
<p>33a.1.1 Eine App ist die Anbindung an ein externes System (Beispiele: KWP, Gmail, AirCall, Stripe, Google Calendar, PandaDoc).
|
||||
<p>33a.1.1 Eine App ist die Anbindung an ein externes System (Beispiele: KWP, Gmail, AirCall, Legacy-Provider, Google Calendar, PandaDoc).
|
||||
33a.1.2 Jede App hat einen Namen, eine Kategorie (z.B. ERP, Kommunikation, Kalender, Zahlung), eine Beschreibung und eine eindeutige Anbindungs-Art (z.B. Single-Sign-On per OAuth, API-Schlüssel, lokales Sync-Programm).
|
||||
33a.1.3 Eine App kann pro Tenant mehrfach verbunden werden (Beispiel: drei Gmail-Postfächer in einem Betrieb, oder zwei KWP-Server an verschiedenen Standorten). Eine Verbindung trägt einen sprechenden Namen, den der Tenant-Admin selber vergibt („Geerkens Hauptbüro KWP").
|
||||
33a.1.4 Phase 1 sind ausschließlich die für Geerkens benötigten Apps freigeschaltet: KWP, Gmail, AirCall, Stripe, Google Calendar, PandaDoc. Alle weiteren Apps werden bewusst zurückgehalten, bis sie ein zahlender Kunde braucht.
|
||||
33a.1.4 Phase 1 sind ausschließlich die für Geerkens benötigten Apps freigeschaltet: KWP, Gmail, AirCall, Legacy-Provider, Google Calendar, PandaDoc. Alle weiteren Apps werden bewusst zurückgehalten, bis sie ein zahlender Kunde braucht.
|
||||
33a.1.5 Eine App kann an einen Funktions-Plan gekoppelt sein (Beispiel: KWP nur in „Cloud Plus"). In tieferen Plänen wird die App im Catalog als „nicht im aktuellen Paket" markiert.</p>
|
||||
<h3 id="33a2-verbindung-herstellen-setup-wizard">33a.2 Verbindung herstellen (Setup-Wizard)</h3>
|
||||
<p>33a.2.1 Jede App hat einen geführten Setup-Wizard mit immer derselben Reihenfolge: (1) Voraussetzungs-Check in Klartext, (2) Eingabe der Zugangsdaten oder OAuth-Anmeldung, (3) automatische Prüfung der Verbindung, (4) optionaler Initial-Sync der Bestandsdaten.
|
||||
33a.2.2 Die nötigen Eingabefelder pro App werden automatisch aus der App-Definition erzeugt, der Tenant-Admin sieht nur das, was die jeweilige App tatsächlich benötigt.
|
||||
33a.2.3 Vier Anbindungs-Arten werden in Phase 1 unterstützt: (a) Single-Sign-On per OAuth (Gmail, Google Calendar, Microsoft), (b) API-Schlüssel (Stripe, PandaDoc), (c) Benutzername/Passwort (Legacy-Systeme), (d) lokales Sync-Programm beim Kunden vor Ort (KWP, siehe Modul 19).
|
||||
33a.2.4 Vor Abschluss prüft das System die Verbindung mit einem Probe-Aufruf. Bei Fehlschlag erscheint ein Klartext-Hinweis mit konkretem Lösungsvorschlag (z.B. „Der API-Schlüssel ist falsch oder abgelaufen. Bitte einen neuen Schlüssel im Stripe-Dashboard erstellen und hier einsetzen.").
|
||||
33a.2.3 Vier Anbindungs-Arten werden in Phase 1 unterstützt: (a) Single-Sign-On per OAuth (Gmail, Google Calendar, Microsoft), (b) API-Schlüssel (Legacy-Provider, PandaDoc), (c) Benutzername/Passwort (Legacy-Systeme), (d) lokales Sync-Programm beim Kunden vor Ort (KWP, siehe Modul 19).
|
||||
33a.2.4 Vor Abschluss prüft das System die Verbindung mit einem Probe-Aufruf. Bei Fehlschlag erscheint ein Klartext-Hinweis mit konkretem Lösungsvorschlag (z.B. „Der API-Schlüssel ist falsch oder abgelaufen. Bitte einen neuen Schlüssel im Legacy-Provider-Dashboard erstellen und hier einsetzen.").
|
||||
33a.2.5 Nach erfolgreichem Setup kann der Tenant-Admin auf Wunsch direkt einen ersten Sync der Bestandsdaten anstoßen, mit Klartext-Vorschau („1.247 Kontakte und 384 Aufträge aus KWP übernehmen?").</p>
|
||||
<h3 id="33a3-verbindungs-status-sichtbar-überall">33a.3 Verbindungs-Status (sichtbar überall)</h3>
|
||||
<p>33a.3.1 Jede Verbindung hat zu jedem Zeitpunkt genau einen von fünf Zuständen: <strong>wartet auf Setup</strong>, <strong>aktiv</strong>, <strong>eingeschränkt</strong>, <strong>defekt</strong>, <strong>getrennt</strong>.
|
||||
@@ -2064,7 +2064,7 @@
|
||||
- Sichtbarkeit pro Vorlage: nur intern (eigener Mandant) / öffentlich-mit-Mandanten-Zustimmung (Marketplace, Phase 2) / öffentlich-kostenfrei / öffentlich-kostenpflichtig.
|
||||
- Mandanten-eigene Vorlagen sind in Phase 1 nur intern sichtbar; Marketplace-Sichtbarkeit wird in Phase 2 aktiviert.
|
||||
17.10.4 <strong>Kommerzielle Vorlagen-Anbieterschaft (Phase 1 vorbereitet, Phase 2 aktiviert)</strong>:
|
||||
- Plattform-Vorlagen können kostenpflichtig sein (Einmalzahlung pro Mandant; alternativ Mini-Abo). Bezahlung läuft über das Subscription-Modul (M28) und Stripe.
|
||||
- Plattform-Vorlagen können kostenpflichtig sein (Einmalzahlung pro Mandant; alternativ Mini-Abo). Bezahlung läuft über das Subscription-Modul (M28) und Legacy-Provider.
|
||||
- Mandanten-Vorlagen, die im Marketplace verkauft werden, generieren Umsatz an den anbietenden Mandanten (Revenue-Share). Konkrete Provision wird mit dem Pricing-Modell festgelegt (geparkt, siehe H.1.1).
|
||||
- Auswertung pro Vorlage: Anzahl Anwendungen, Anzahl bezahlter Käufe, häufige Anpassungen durch Anwender.
|
||||
17.10.5 <strong>Service-Einsätze und Wartung sind keine Beispiele</strong> (siehe N9): „Wartungstermin-Reminder" wurde durch „Termin-Erinnerung an Endkunden" ersetzt, die für jede Termin-Art (Vor-Ort-Termin, Abnahme, Service) gilt. Ein dediziertes Service-Modul kommt erst in Phase 2.</p>
|
||||
@@ -2152,7 +2152,7 @@
|
||||
18.8.5 <strong>Upsell-Logik</strong>:
|
||||
- Wenn der Aufschlags-Verbrauch in einem Monat höher ist als die Differenz zum nächsten Plan, schlägt das System dem Mandanten-Administrator aktiv vor, das Abo zu upgraden („Du hast diesen Monat 87 Euro Aufschlag bezahlt. Mit Plan Cloud+ (49 Euro/Monat zusätzlich) wäre alles enthalten.").
|
||||
- Soft-Recommendation, kein Zwang.
|
||||
18.8.6 <strong>Rechnungsstellung</strong>: Aufschlags-Verbrauch wird in der nächsten Stripe-Rechnung als Zusatzposition ausgewiesen. Mandant sieht in M28 (Subscription) den exakten Verbrauch nachvollziehbar.
|
||||
18.8.6 <strong>Rechnungsstellung</strong>: Aufschlags-Verbrauch wird in der nächsten Legacy-Provider-Rechnung als Zusatzposition ausgewiesen. Mandant sieht in M28 (Subscription) den exakten Verbrauch nachvollziehbar.
|
||||
18.8.7 <strong>Notbremse für Missbrauch</strong>: pro Mandant gibt es eine konfigurierbare absolute Obergrenze („nie mehr als X Euro Aufschlag pro Monat"). Wird sie erreicht, geht das System NICHT in Pause, sondern in einen Drosselungs-Modus mit Klartext-Warnung an den Administrator („Notbremse erreicht, ab jetzt nur noch geschäftskritische KI-Aufrufe (Klartext-Diagnostik). Sofortige Reaktion empfohlen."). Damit ist das Kostenrisiko gedeckelt, aber nichts geht schlagartig schwarz.
|
||||
18.8.8 Reset des Inklusiv-Volumens zum Monatsersten.
|
||||
18.8.9 Im Verbrauchs-Bereich des Mandanten-Administrators werden gezeigt: Verbrauch pro Anwendungsfall, Verbrauch über Zeit, Top-Verbraucher (welche Module / welche Nutzer), Hochrechnung Monatsende, aktueller Tarif, Notbremse-Stand.</p>
|
||||
@@ -2968,7 +2968,7 @@
|
||||
6.11.2 Automatische Erinnerungs-Mails 24h und 1h vor dem Termin.
|
||||
6.11.3 SMS-Erinnerungen (kostenpflichtige Zusatz-Funktion).
|
||||
6.11.4 Eigene Domain für Buchungsseiten (<code>termine.geerkens.de</code>).
|
||||
6.11.5 Vorauszahlung / Anzahlung über Stripe.
|
||||
6.11.5 Vorauszahlung / Anzahlung über Legacy-Provider.
|
||||
6.11.6 Gruppen-Termine (mehrere Endkunden für einen Slot).
|
||||
6.11.7 KI-Buchungs-Assistent.</p>
|
||||
<h3 id="612-klartext-fehlertexte-beispiele">6.12 Klartext-Fehlertexte (Beispiele)</h3>
|
||||
@@ -3311,7 +3311,7 @@
|
||||
<p>15.14.1 Bidirektionale Kommunikation (Chat zwischen Endkunde und Tenant).
|
||||
15.14.2 Eigenes Portal-Branding (Logo + Farben + eigene Domain <code>kunden.geerkens.de</code>).
|
||||
15.14.3 Mehrere Portale pro Tenant (Privatkunden vs. Bauträger).
|
||||
15.14.4 Wartungs-Abos / Service-Pakete im Portal abschließbar mit Stripe.
|
||||
15.14.4 Wartungs-Abos / Service-Pakete im Portal abschließbar mit Legacy-Provider.
|
||||
15.14.5 Blog/CMS für redaktionelle Inhalte (Wartungs-Tipps, News).
|
||||
15.14.6 Push-Notifications über installierbare PWA.
|
||||
15.14.7 Auto-Deaktivierung nach X Tagen ohne Login.
|
||||
@@ -3437,7 +3437,7 @@
|
||||
20.10.3 Veraltete Daten: „Daten zuletzt aktualisiert vor 12 Minuten."
|
||||
20.10.4 Layout-Reset: „Dein angepasstes Layout wird durch das Standard-Layout deiner Rolle ersetzt."</p>
|
||||
<h1 id="block-7-plattform-außenseite-betrieb-compliance-zugang">Block 7: Plattform-Außenseite (Betrieb, Compliance, Zugang)</h1>
|
||||
<p>Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbares Produkt machen: das Audit-Log für Nachvollziehbarkeit, Stripe-basierte Abrechnung, Onboarding für neue Mandanten, eine Lese-API mit Webhooks für Drittanbieter, der DSGVO-Export, die Mobile-App auf Capacitor-Basis, das öffentliche Hilfe-Center und der interne Help-Desk.</p>
|
||||
<p>Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbares Produkt machen: das Audit-Log für Nachvollziehbarkeit, Legacy-Provider-basierte Abrechnung, Onboarding für neue Mandanten, eine Lese-API mit Webhooks für Drittanbieter, der DSGVO-Export, die Mobile-App auf Capacitor-Basis, das öffentliche Hilfe-Center und der interne Help-Desk.</p>
|
||||
<hr />
|
||||
<h2 id="modul-21-audit-log">Modul 21: Audit-Log</h2>
|
||||
<p><strong>Was es tut:</strong> Schreibt für jeden Mandanten einen lückenlosen Verlauf aller verändernden Aktionen mit Vorher-/Nachher-Vergleich mit. Macht nachvollziehbar, wer wann was geändert hat, von Mitarbeitern, Automationen, KI oder externen Schnittstellen.</p>
|
||||
@@ -3498,14 +3498,14 @@
|
||||
21.8.6 Ohne Audit-Recht: „Du hast keine Berechtigung, das Audit-Log zu sehen. Bitte Mandanten-Admin kontaktieren."</p>
|
||||
<hr />
|
||||
<h2 id="modul-28-subscriptions-billing">Modul 28: Subscriptions / Billing</h2>
|
||||
<p><strong>Was es tut:</strong> Verbindet HiveGrid mit Stripe als Bezahl-Anbieter und steuert den gesamten Abo-Lebenszyklus jedes Mandanten, vom Trial über aktive Bezahlung, Pausen, Mahnwesen bis zur Kündigung. Zählt Sitzplätze (Büro vs. Monteur) und nutzungsbasierten Verbrauch (Automationen, KI-Verbrauch).</p>
|
||||
<p><strong>Was es tut:</strong> Verbindet HiveGrid mit Legacy-Provider als Bezahl-Anbieter und steuert den gesamten Abo-Lebenszyklus jedes Mandanten, vom Trial über aktive Bezahlung, Pausen, Mahnwesen bis zur Kündigung. Zählt Sitzplätze (Büro vs. Monteur) und nutzungsbasierten Verbrauch (Automationen, KI-Verbrauch).</p>
|
||||
<p><strong>Warum es wichtig ist:</strong> Ohne stabile, regelkonforme Abrechnung verdient die Plattform kein Geld. Die Mechanik muss flexibel genug sein, dass Preise später angepasst werden können, ohne den Code zu ändern. Apple-Compliance (siehe 28.X) ist dabei ein hartes Tabu, das die ganze Architektur prägt.</p>
|
||||
<h3 id="281-bezahl-anbieter-stripe">28.1 Bezahl-Anbieter Stripe</h3>
|
||||
<p>28.1.1 Stripe ist exklusiver Bezahl-Anbieter in Phase 1, Vertragspartner ist die EU-Tochter Stripe Payments Europe (Irland), DSGVO-Auftragsverarbeitungsvertrag elektronisch unterzeichnet beim Signup.
|
||||
28.1.2 Steuern werden über Stripe Tax mit EU-Reverse-Charge-Logik abgewickelt.
|
||||
<h3 id="281-bezahl-anbieter-legacyProvider">28.1 Bezahl-Anbieter Legacy-Provider</h3>
|
||||
<p>28.1.1 Legacy-Provider ist exklusiver Bezahl-Anbieter in Phase 1, Vertragspartner ist die EU-Tochter Legacy-Provider Payments Europe (Irland), DSGVO-Auftragsverarbeitungsvertrag elektronisch unterzeichnet beim Signup.
|
||||
28.1.2 Steuern werden über Legacy-Provider Tax mit EU-Reverse-Charge-Logik abgewickelt.
|
||||
28.1.3 Zahlungsarten in Phase 1: SEPA-Lastschrift (Default Deutschland/EU) und Kreditkarte.
|
||||
28.1.4 Stripe sendet Ereignisse (Webhooks) an HiveGrid: erfolgreicher Bezahlvorgang, Rechnung erstellt, Zahlung gescheitert, Plan geändert, Subscription gelöscht, Trial-Ende-Vorwarnung.
|
||||
28.1.5 Jedes Stripe-Ereignis wird genau einmal verarbeitet (Doppel-Schutz über eindeutige Stripe-Event-Kennung).
|
||||
28.1.4 Legacy-Provider sendet Ereignisse (Webhooks) an HiveGrid: erfolgreicher Bezahlvorgang, Rechnung erstellt, Zahlung gescheitert, Plan geändert, Subscription gelöscht, Trial-Ende-Vorwarnung.
|
||||
28.1.5 Jedes Legacy-Provider-Ereignis wird genau einmal verarbeitet (Doppel-Schutz über eindeutige Legacy-Provider-Event-Kennung).
|
||||
28.1.6 Plan-Konfiguration ist nicht im Code festgenagelt, sondern in Daten-Strukturen, neue Pläne, Preise und Quotas sind ohne Code-Release änderbar.</p>
|
||||
<h3 id="282-seat-modell-büromonteur">28.2 Seat-Modell (Büro/Monteur)</h3>
|
||||
<p>28.2.1 Zwei Sitzplatz-Typen, gespiegelt zur Leitplanke „Büro vs. Baustelle als zwei Erlebnisse":
|
||||
@@ -3514,7 +3514,7 @@
|
||||
28.2.2 Bei jeder Mitarbeiter-Einladung wählt der Mandanten-Admin den Sitzplatz-Typ, Pflichtfeld.
|
||||
28.2.3 Sitzplatz-Typ ist Lizenz-Konzept, Rolle ist Rechte-Konzept, getrennt.
|
||||
28.2.4 Monteur-Sitzplatz darf nur Rollen mit Default-Modus „Baustelle" bekommen (Validierungs-Regel).
|
||||
28.2.5 Sitzplatz-Zähler werden bei jeder Einladung/Aktivierung/Deaktivierung mit Stripe synchronisiert.
|
||||
28.2.5 Sitzplatz-Zähler werden bei jeder Einladung/Aktivierung/Deaktivierung mit Legacy-Provider synchronisiert.
|
||||
28.2.6 Plan-Quotas (z.B. „max. 10 Büro-Sitzplätze, max. 50 Monteur-Sitzplätze") sind pro Plan konfigurierbar.
|
||||
28.2.7 Quota-Verhalten: Default „Hartes Limit", neue Einladung blockiert mit Klartext-Hinweis. Optional „weiches Limit", zusätzliche Sitzplätze werden automatisch nutzungsbasiert abgerechnet.
|
||||
28.2.8 Verbrauchs-Übersicht im Mandanten-Admin zeigt aktuelle Sitzplätze pro Typ, verfügbare Sitzplätze laut Plan, Trend-Chart.</p>
|
||||
@@ -3525,16 +3525,16 @@
|
||||
28.3.4 Zahlungsmethode ist im Vertriebs-Modus nicht zwingend zu Trial-Beginn.
|
||||
28.3.5 3 Tage und 1 Tag vor Trial-Ende: In-App-Banner und E-Mail-Benachrichtigung mit Klartext-Hinweis und Verweis auf Marketing-Site (NICHT auf In-App-Upgrade, siehe Apple-Compliance 28.X).
|
||||
28.3.6 Trial-Ende ohne Konversion: Mandant geht in 30-Tage-Lösch-Vorlauf (siehe Modul 35.6).
|
||||
28.3.7 Trial-Konversion läuft über Marketing-Site, von dort zurück in die App mit Stripe-Session-Token.</p>
|
||||
28.3.7 Trial-Konversion läuft über Marketing-Site, von dort zurück in die App mit Legacy-Provider-Session-Token.</p>
|
||||
<h3 id="284-read-only-downgrade-bei-nichtzahlung">28.4 Read-Only-Downgrade bei Nichtzahlung</h3>
|
||||
<p>28.4.1 Wenn der Mandant nicht bezahlt, kann er nur noch ansehen, nichts mehr ändern, bis er bezahlt, das ist die Klartext-Idee dahinter.
|
||||
28.4.2 Auslöser: Stripe meldet Zahlung gescheitert.
|
||||
28.4.3 Stripe-Standard-Mahnwesen: 3 automatische Wiederholungs-Versuche über 14 Tage (typisch Tag 0, 3, 7, 14).
|
||||
28.4.2 Auslöser: Legacy-Provider meldet Zahlung gescheitert.
|
||||
28.4.3 Legacy-Provider-Standard-Mahnwesen: 3 automatische Wiederholungs-Versuche über 14 Tage (typisch Tag 0, 3, 7, 14).
|
||||
28.4.4 Während Mahnwesen wechselt der Mandant in den Status „Zahlung überfällig" → kompletter Workspace ist Read-Only:
|
||||
- Anmeldung, Daten lesen, Kunden-Portal-Zugang (Endkunden) und Stripe-Kunden-Portal-Zugang bleiben möglich.
|
||||
- Anmeldung, Daten lesen, Kunden-Portal-Zugang (Endkunden) und Legacy-Provider-Kunden-Portal-Zugang bleiben möglich.
|
||||
- Stammdaten-Edits, neue Datensätze, E-Mail-/WhatsApp-/Push-Versand, Automationen-Ausführung, eingehende Webhooks und API-Schreiboperationen sind blockiert.
|
||||
- Eingehende Trigger werden verworfen (nicht in Warteschlange), sonst stauen sich Aktionen auf, die mit gepausten Zahlungen kollidieren.
|
||||
28.4.5 Klartext-Banner: „Zahlung fehlgeschlagen, Konto in 14 Tagen gesperrt, [Zahlungsmethode aktualisieren]" mit Direkt-Link zum Stripe-Kunden-Portal.
|
||||
28.4.5 Klartext-Banner: „Zahlung fehlgeschlagen, Konto in 14 Tagen gesperrt, [Zahlungsmethode aktualisieren]" mit Direkt-Link zum Legacy-Provider-Kunden-Portal.
|
||||
28.4.6 E-Mail-Benachrichtigungen an Mandanten-Admins bei jedem Zustand: erste Zahlung gescheitert, 2. Versuch gescheitert, 1 Tag vor finalem Cancel.
|
||||
28.4.7 Nach 3 Fehlversuchen + 14 Tagen ohne Erfolg: Status wechselt auf „gekündigt".
|
||||
28.4.8 Sobald Zahlung nachgereicht: automatischer Wechsel zurück auf „aktiv".</p>
|
||||
@@ -3542,14 +3542,14 @@
|
||||
<p>28.5.1 Der Mandant kann seinen Workspace freiwillig pausieren statt zu kündigen, gedacht für Saison-Pausen kleiner Betriebe.
|
||||
28.5.2 Reduzierte Gebühr (Default ca. 1/10 des Standardpreises, exakte Werte gehören in die Pricing-Festlegung), Workspace Read-Only, jederzeit reaktivierbar, Daten bleiben erhalten.
|
||||
28.5.3 Pause-Bestätigung erfordert Eingabe der Phrase „PAUSIEREN" als Schutz gegen Versehen.
|
||||
28.5.4 Reaktivierung über Bezahl-Vorgang in Stripe.</p>
|
||||
28.5.4 Reaktivierung über Bezahl-Vorgang in Legacy-Provider.</p>
|
||||
<h3 id="286-rechnungsstellung">28.6 Rechnungsstellung</h3>
|
||||
<p>28.6.1 Rechnungs-Übersicht im Mandanten-Admin als Stripe-Kunden-Portal eingebettet (von Stripe gehostet).
|
||||
<p>28.6.1 Rechnungs-Übersicht im Mandanten-Admin als Legacy-Provider-Kunden-Portal eingebettet (von Legacy-Provider gehostet).
|
||||
28.6.2 Funktionen dort: Rechnungs-Historie als PDF herunterladen, Zahlungsmethode aktualisieren, Steuer-Daten/USt-IdNr. editieren.
|
||||
28.6.3 Rechnungen werden in HiveGrid als Referenz gespiegelt; Original-Dateien lädt der User aus Stripe.</p>
|
||||
28.6.3 Rechnungen werden in HiveGrid als Referenz gespiegelt; Original-Dateien lädt der User aus Legacy-Provider.</p>
|
||||
<h3 id="287-setup-gebühren">28.7 Setup-Gebühren</h3>
|
||||
<p>28.7.1 Pro Plan optional eine einmalige Setup-Gebühr.
|
||||
28.7.2 Im Stripe-Bezahlvorgang erscheinen zwei Posten, wiederkehrender Plan-Preis plus einmalige Setup-Gebühr.
|
||||
28.7.2 Im Legacy-Provider-Bezahlvorgang erscheinen zwei Posten, wiederkehrender Plan-Preis plus einmalige Setup-Gebühr.
|
||||
28.7.3 Bei Plan-Wechsel zu höherem Plan wird nur die Differenz der Setup-Gebühr berechnet.
|
||||
28.7.4 Klartext-Hinweis im Bezahlvorgang: „Bei Buchung wird zusätzlich eine einmalige Setup-Gebühr von [Betrag] berechnet."</p>
|
||||
<h3 id="288-verbrauchs-erfassung-automationen-ki-n13-09052026">28.8 Verbrauchs-Erfassung (Automationen, KI) [N13, 09.05.2026]</h3>
|
||||
@@ -3557,13 +3557,13 @@
|
||||
28.8.2 Pro Plan ein <strong>Inklusiv-Volumen</strong> plus <strong>Aufschlags-Tarif</strong> für Mehrverbrauch (Pay-as-you-go). KI-Funktionen werden NICHT pausiert (siehe M18.8). Konkrete Schwellen und Stückpreise mit Pricing-Festlegung (geparkt, siehe H.1.1).
|
||||
28.8.3 Verbrauchs-Sicht im Mandanten-Admin: aktuelle Periode, Inklusiv-Menge, Verbrauch in Prozent, Trend, Historie der letzten 12 Perioden, aktueller Aufschlags-Verbrauch in Euro, voraussichtlicher Monats-Aufschlag, CSV-Export.
|
||||
28.8.4 KI-Inklusiv-Menge verfällt am Periodenende. Manuelle Boni vom Vertrieb bleiben.
|
||||
28.8.5 <strong>Aufschlags-Verbrauch</strong> wird pro Stripe-Rechnungs-Periode als separate Position ausgewiesen (Detail-Aufschlüsselung pro KI-Funktion und Tag).
|
||||
28.8.5 <strong>Aufschlags-Verbrauch</strong> wird pro Legacy-Provider-Rechnungs-Periode als separate Position ausgewiesen (Detail-Aufschlüsselung pro KI-Funktion und Tag).
|
||||
28.8.6 <strong>Notbremse</strong>: pro Mandant konfigurierbar, max. Aufschlags-Betrag pro Monat. Bei Erreichen wird in Drosselungs-Modus geschaltet (nur Klartext-Diagnostik bleibt aktiv), nicht in Komplett-Pause. Klartext-Warnung an Administrator (siehe M18.8.7).
|
||||
28.8.7 <strong>Upsell-Vorschlag</strong>: wenn Aufschlag in 2 aufeinanderfolgenden Monaten höher liegt als die Differenz zum nächsten Plan, schlägt das System aktiv ein Upgrade vor. Soft-Recommendation, kein Zwang.
|
||||
28.8.8 Bei aufgebrauchtem Inklusiv-Volumen: Klartext im Banner: <em>„Inklusiv-Volumen verbraucht, weitere Anfragen kosten ab jetzt [Aufschlags-Tarif] pro 1.000 Tokens. [Plan-Vergleich auf hivegrid.de]"</em>. Web-App: direkter Link zur Vergleichs-Seite. Mobile-App: Hinweis ohne Upgrade-UI (Apple-Compliance, siehe 28.X.10).</p>
|
||||
<h3 id="28x-phase-2-bewusst-nicht-in-phase-1">28.X Phase 2 / bewusst NICHT in Phase 1</h3>
|
||||
<p>28.X.1 In-App-Plan-Wechsel und Add-On-Käufe (alles muss zur Marketing-Site, Apple-Compliance Phase 1).
|
||||
28.X.2 Mehr-Mandanten-Abrechnung für Konzerne (mehrere Mandanten in einer Stripe-Subscription gebündelt).
|
||||
28.X.2 Mehr-Mandanten-Abrechnung für Konzerne (mehrere Mandanten in einer Legacy-Provider-Subscription gebündelt).
|
||||
28.X.3 Individual-Pricing pro Mandant durch Plattform-Admin (Enterprise-Verhandlung).
|
||||
28.X.4 Promo-Code-System mit Rabatt-Codes im Bezahlvorgang.
|
||||
28.X.5 Jahres-Abrechnung mit konfigurierbarem Jahres-Rabatt.
|
||||
@@ -3588,7 +3588,7 @@
|
||||
<p><strong>Was es tut:</strong> Führt einen frisch angemeldeten Mandanten in 5 Minuten von der nackten Anmeldung in einen einsatzbereiten Workspace, mit branchen-spezifischer Standard-Konfiguration, optionalen Beispieldaten und Mitarbeiter-Einladung.</p>
|
||||
<p><strong>Warum es wichtig ist:</strong> Wenn der Mandant nach Anmeldung in einer leeren App landet und nicht weiß, wo er anfangen soll, ist er weg. Onboarding entscheidet über die Aktivierungs-Quote. Branchen-Templates müssen so abgelegt sein, dass Phase 2 weitere Branchen ohne Code-Patch möglich macht.</p>
|
||||
<h3 id="291-mandanten-anmeldung-tenant-anlage">29.1 Mandanten-Anmeldung (Tenant-Anlage)</h3>
|
||||
<p>29.1.1 Anmelde-Pfad: Marketing-Site <code>hivegrid.de/signup</code> → in-App-Account-Anlage → Mandanten-Daten → Plan-Auswahl → Stripe-Bezahlvorgang → Onboarding-Wizard.
|
||||
<p>29.1.1 Anmelde-Pfad: Marketing-Site <code>hivegrid.de/signup</code> → in-App-Account-Anlage → Mandanten-Daten → Plan-Auswahl → Legacy-Provider-Bezahlvorgang → Onboarding-Wizard.
|
||||
29.1.2 Beim ersten Login auf der Mandanten-Adresse: automatische Weiterleitung in den Wizard.
|
||||
29.1.3 Wizard läuft im Vollbild-Modus ohne Sidebar, mit Fortschritts-Anzeige.
|
||||
29.1.4 Wizard ist resumable, bei Abbruch wird beim nächsten Login zum letzten Schritt zurückgekehrt.
|
||||
@@ -3758,7 +3758,7 @@
|
||||
<p>35.3.1 Mandanten-Kündigung läuft als Multi-Step-Workflow:
|
||||
- Schritt 1: Klartext-Erklärung was passiert (Status wechselt sofort auf „Lösch-Vorlauf", Workspace bleibt 30 Tage Read-Only sichtbar, danach Hard-Delete aller Daten unwiderruflich).
|
||||
- Schritt 2: Datensicherungs-Hinweis mit Direkt-Link zum Mandanten-Export.
|
||||
- Schritt 3: Stripe-Hinweis (Restbetrag, Pro-rata-Erstattung, letzte Rechnung).
|
||||
- Schritt 3: Legacy-Provider-Hinweis (Restbetrag, Pro-rata-Erstattung, letzte Rechnung).
|
||||
- Schritt 4: Identitäts-Bestätigung (Passwort + 2FA).
|
||||
- Schritt 5: Final-Klick mit Eingabe des Mandanten-Slugs als Confirm-Phrase.
|
||||
35.3.2 30-Tage-Grace-Period: jeder Mandanten-Admin kann mit einem Klick zurückziehen, Status zurück auf „aktiv". Audit dokumentiert wer kündigte und wer zurückzog.
|
||||
@@ -3957,7 +3957,7 @@
|
||||
- Mitarbeiter: HR-Hub-Übersicht, Krankmeldung/Urlaubsantrag stellen.
|
||||
- Integrationen: KWP-Setup, Google-Kalender verbinden, AirCall-Setup, E-Mail-Integration (Gmail/Outlook).
|
||||
- Mobile: Mobile-App-Setup, Offline-Modus auf Baustelle.
|
||||
- Abrechnung: Stripe-Setup, Plan wechseln, Rechnungen einsehen.
|
||||
- Abrechnung: Legacy-Provider-Setup, Plan wechseln, Rechnungen einsehen.
|
||||
- Tutorials: Form-Builder-Tutorial, Automation-Builder-Tutorial.
|
||||
38.2.2 Phase 1 nur Deutsch. Andere Sprachen: 404 mit Klartext-Banner „Englischsprachige Hilfe ist in Vorbereitung. Hier ist die deutsche Version." plus automatischer Redirect auf DE.
|
||||
38.2.3 Performance Phase 1: Client-side Volltext-Index (FlexSearch oder ähnlich, ca. 50 KB für 20 Artikel) ODER Server-side Postgres-FTS, Tooling-Wahl beim Bau.</p>
|
||||
|
||||
+7
-7
@@ -350,7 +350,7 @@ Diese fünf Module bilden die Basis, auf der alle anderen Module aufsetzen: Anme
|
||||
37.4.2 Mandanten-Verwaltung.
|
||||
37.4.3 Mandanten-Mitarbeiter-Verwaltung (alle Mitarbeiter aller Mandanten).
|
||||
37.4.4 Plattform-Admin-Verwaltung (unsere eigenen Konten und Rollen).
|
||||
37.4.5 Abo-Verwaltung (Anbindung an Stripe).
|
||||
37.4.5 Abo-Verwaltung (Anbindung an Legacy-Provider).
|
||||
37.4.6 Funktions-Schalter (siehe Modul 32).
|
||||
37.4.7 System-Gesundheit (Server, Hintergrund-Aufgaben, KWP-Sync).
|
||||
37.4.8 Plattform-weites Audit-Protokoll.
|
||||
@@ -407,10 +407,10 @@ Diese fünf Module bilden die Basis, auf der alle anderen Module aufsetzen: Anme
|
||||
|
||||
### 37.10 Abo-Verwaltung
|
||||
|
||||
37.10.1 Liste aller Abos mit Mandant, Tarif, Monatsumsatz, Status, Verlängerungs-Datum, Stripe-Sync-Status.
|
||||
37.10.2 Detail-Ansicht mit Stripe-Verknüpfungen (Direkt-Link zum Stripe-Dashboard), aktuellem Tarif, Sitz-Anzahl (Büro + Monteur), Test-Phase, Rechnungs-Historie, Notizen über manuelle Sonder-Konditionen.
|
||||
37.10.3 Mögliche Aktionen: Stripe-Abgleich erzwingen, Tarif manuell überschreiben (Enterprise-Sonderpreise mit Begründungs-Pflicht), Test-Phase verlängern, manuelle Rechnung anstoßen, Abo kündigen, Rückzahlung anstoßen.
|
||||
37.10.4 Wenn die Daten in HiveGrid und in Stripe auseinanderlaufen, wird das im Detail mit Klartext-Vergleich angezeigt.
|
||||
37.10.1 Liste aller Abos mit Mandant, Tarif, Monatsumsatz, Status, Verlängerungs-Datum, Legacy-Provider-Sync-Status.
|
||||
37.10.2 Detail-Ansicht mit Legacy-Provider-Verknüpfungen (Direkt-Link zum Legacy-Provider-Dashboard), aktuellem Tarif, Sitz-Anzahl (Büro + Monteur), Test-Phase, Rechnungs-Historie, Notizen über manuelle Sonder-Konditionen.
|
||||
37.10.3 Mögliche Aktionen: Legacy-Provider-Abgleich erzwingen, Tarif manuell überschreiben (Enterprise-Sonderpreise mit Begründungs-Pflicht), Test-Phase verlängern, manuelle Rechnung anstoßen, Abo kündigen, Rückzahlung anstoßen.
|
||||
37.10.4 Wenn die Daten in HiveGrid und in Legacy-Provider auseinanderlaufen, wird das im Detail mit Klartext-Vergleich angezeigt.
|
||||
|
||||
### 37.11 System-Gesundheit
|
||||
|
||||
@@ -475,11 +475,11 @@ Diese fünf Module bilden die Basis, auf der alle anderen Module aufsetzen: Anme
|
||||
|
||||
37.18.1 Status-Wechsel ohne Begründung: „Bitte Begründung angeben, wird im Audit-Log dauerhaft gespeichert."
|
||||
37.18.2 Stellvertreter-Anmeldung ohne Begründung: blockiert, gleicher Hinweis.
|
||||
37.18.3 Sonder-Tarif: „Diese Konditionen weichen vom Standard-Plan ab. Stripe wird nicht angepasst, manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]"
|
||||
37.18.3 Sonder-Tarif: „Diese Konditionen weichen vom Standard-Plan ab. Legacy-Provider wird nicht angepasst, manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]"
|
||||
37.18.4 Doppelte Plattform-Admin-Email: „Diese Email gehört bereits zu einem Plattform-Admin ‚X‘, bitte direkt diesen verwalten."
|
||||
37.18.5 Letzter Super-Admin: „Du bist der einzige Super-Admin. Rechte-Entzug nicht möglich. Bitte zuerst weiteren Super-Admin anlegen."
|
||||
37.18.6 Konto gesperrt nach Fehlversuchen: „Account gesperrt nach 10 Fehlversuchen. Bitte anderen Super-Admin um Reaktivierung bitten."
|
||||
37.18.7 Lösch-Anstoß im Auftrag: „Du startest die Kündigung für Mandant ‚X‘ im Auftrag. Bestätigungs-Email geht an alle Mandanten-Administratoren mit Cancel-Link."
|
||||
37.18.8 Stripe-Konflikt: „Stripe-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Stripe-Wert] vs. [HiveGrid-Wert]."
|
||||
37.18.8 Legacy-Provider-Konflikt: „Legacy-Provider-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Legacy-Provider-Wert] vs. [HiveGrid-Wert]."
|
||||
37.18.9 Warteschlangen-Pause: „Warteschlange ‚X‘ pausiert. Neue Aufgaben werden eingereiht aber nicht verarbeitet. Vergiss nicht zu reaktivieren!"
|
||||
37.18.10 Massen-Email an Mandanten-Administratoren: „Diese Email geht an X Mandanten-Administratoren. Bitte nochmal Betreff und Inhalt prüfen. [Senden]"
|
||||
+8
-8
@@ -6,24 +6,24 @@ Hier liegt der Wettbewerbsvorteil von HiveGrid gegenüber HubSpot/Quiply: eine e
|
||||
|
||||
## Modul 33a: Apps-Engine (einheitliche Anbindungs-Schicht)
|
||||
|
||||
**Was es tut:** Stellt eine einheitliche Anbindungs-Schnittstelle für alle externen Systeme bereit (KWP, Gmail, AirCall, Stripe, Google Calendar, PandaDoc, …). Jedes externe System wird zur „App", mit gleichem Verbindungs-Aufbau, gleichem Status-Verhalten, gleichen Fehler-Texten, gleichem Sync-Verlauf.
|
||||
**Was es tut:** Stellt eine einheitliche Anbindungs-Schnittstelle für alle externen Systeme bereit (KWP, Gmail, AirCall, Legacy-Provider, Google Calendar, PandaDoc, …). Jedes externe System wird zur „App", mit gleichem Verbindungs-Aufbau, gleichem Status-Verhalten, gleichen Fehler-Texten, gleichem Sync-Verlauf.
|
||||
**Löst ab:** Das individuelle Verdrahten externer Systeme (Zapier, Supabase-Glue, eigens gebaute Adapter).
|
||||
**Warum es wichtig ist:** Ohne diese Foundation wird jede neue Anbindung wieder Sonder-Code mit Sonder-Fehlern. Die Apps-Engine ist die Plattform-Grundlage, auf der KWP, Telefonie, Mail-Sync und Zahlungs-Anbindung sauber aufsetzen. **Phase 1 ist nur die Auswahl der Apps, die Geerkens braucht** (KWP, Gmail, AirCall, Stripe, Calendar). Marketplace und Drittanbieter-Apps sind ausdrücklich Phase 2.
|
||||
**Warum es wichtig ist:** Ohne diese Foundation wird jede neue Anbindung wieder Sonder-Code mit Sonder-Fehlern. Die Apps-Engine ist die Plattform-Grundlage, auf der KWP, Telefonie, Mail-Sync und Zahlungs-Anbindung sauber aufsetzen. **Phase 1 ist nur die Auswahl der Apps, die Geerkens braucht** (KWP, Gmail, AirCall, Legacy-Provider, Calendar). Marketplace und Drittanbieter-Apps sind ausdrücklich Phase 2.
|
||||
|
||||
### 33a.1 Was eine App ist
|
||||
|
||||
33a.1.1 Eine App ist die Anbindung an ein externes System (Beispiele: KWP, Gmail, AirCall, Stripe, Google Calendar, PandaDoc).
|
||||
33a.1.1 Eine App ist die Anbindung an ein externes System (Beispiele: KWP, Gmail, AirCall, Legacy-Provider, Google Calendar, PandaDoc).
|
||||
33a.1.2 Jede App hat einen Namen, eine Kategorie (z.B. ERP, Kommunikation, Kalender, Zahlung), eine Beschreibung und eine eindeutige Anbindungs-Art (z.B. Single-Sign-On per OAuth, API-Schlüssel, lokales Sync-Programm).
|
||||
33a.1.3 Eine App kann pro Tenant mehrfach verbunden werden (Beispiel: drei Gmail-Postfächer in einem Betrieb, oder zwei KWP-Server an verschiedenen Standorten). Eine Verbindung trägt einen sprechenden Namen, den der Tenant-Admin selber vergibt („Geerkens Hauptbüro KWP").
|
||||
33a.1.4 Phase 1 sind ausschließlich die für Geerkens benötigten Apps freigeschaltet: KWP, Gmail, AirCall, Stripe, Google Calendar, PandaDoc. Alle weiteren Apps werden bewusst zurückgehalten, bis sie ein zahlender Kunde braucht.
|
||||
33a.1.4 Phase 1 sind ausschließlich die für Geerkens benötigten Apps freigeschaltet: KWP, Gmail, AirCall, Legacy-Provider, Google Calendar, PandaDoc. Alle weiteren Apps werden bewusst zurückgehalten, bis sie ein zahlender Kunde braucht.
|
||||
33a.1.5 Eine App kann an einen Funktions-Plan gekoppelt sein (Beispiel: KWP nur in „Cloud Plus"). In tieferen Plänen wird die App im Catalog als „nicht im aktuellen Paket" markiert.
|
||||
|
||||
### 33a.2 Verbindung herstellen (Setup-Wizard)
|
||||
|
||||
33a.2.1 Jede App hat einen geführten Setup-Wizard mit immer derselben Reihenfolge: (1) Voraussetzungs-Check in Klartext, (2) Eingabe der Zugangsdaten oder OAuth-Anmeldung, (3) automatische Prüfung der Verbindung, (4) optionaler Initial-Sync der Bestandsdaten.
|
||||
33a.2.2 Die nötigen Eingabefelder pro App werden automatisch aus der App-Definition erzeugt, der Tenant-Admin sieht nur das, was die jeweilige App tatsächlich benötigt.
|
||||
33a.2.3 Vier Anbindungs-Arten werden in Phase 1 unterstützt: (a) Single-Sign-On per OAuth (Gmail, Google Calendar, Microsoft), (b) API-Schlüssel (Stripe, PandaDoc), (c) Benutzername/Passwort (Legacy-Systeme), (d) lokales Sync-Programm beim Kunden vor Ort (KWP, siehe Modul 19).
|
||||
33a.2.4 Vor Abschluss prüft das System die Verbindung mit einem Probe-Aufruf. Bei Fehlschlag erscheint ein Klartext-Hinweis mit konkretem Lösungsvorschlag (z.B. „Der API-Schlüssel ist falsch oder abgelaufen. Bitte einen neuen Schlüssel im Stripe-Dashboard erstellen und hier einsetzen.").
|
||||
33a.2.3 Vier Anbindungs-Arten werden in Phase 1 unterstützt: (a) Single-Sign-On per OAuth (Gmail, Google Calendar, Microsoft), (b) API-Schlüssel (Legacy-Provider, PandaDoc), (c) Benutzername/Passwort (Legacy-Systeme), (d) lokales Sync-Programm beim Kunden vor Ort (KWP, siehe Modul 19).
|
||||
33a.2.4 Vor Abschluss prüft das System die Verbindung mit einem Probe-Aufruf. Bei Fehlschlag erscheint ein Klartext-Hinweis mit konkretem Lösungsvorschlag (z.B. „Der API-Schlüssel ist falsch oder abgelaufen. Bitte einen neuen Schlüssel im Legacy-Provider-Dashboard erstellen und hier einsetzen.").
|
||||
33a.2.5 Nach erfolgreichem Setup kann der Tenant-Admin auf Wunsch direkt einen ersten Sync der Bestandsdaten anstoßen, mit Klartext-Vorschau („1.247 Kontakte und 384 Aufträge aus KWP übernehmen?").
|
||||
|
||||
### 33a.3 Verbindungs-Status (sichtbar überall)
|
||||
@@ -217,7 +217,7 @@ Auslöser entstehen aus den verschiedenen Modulen, der Tenant kombiniert das, wa
|
||||
- Sichtbarkeit pro Vorlage: nur intern (eigener Mandant) / öffentlich-mit-Mandanten-Zustimmung (Marketplace, Phase 2) / öffentlich-kostenfrei / öffentlich-kostenpflichtig.
|
||||
- Mandanten-eigene Vorlagen sind in Phase 1 nur intern sichtbar; Marketplace-Sichtbarkeit wird in Phase 2 aktiviert.
|
||||
17.10.4 **Kommerzielle Vorlagen-Anbieterschaft (Phase 1 vorbereitet, Phase 2 aktiviert)**:
|
||||
- Plattform-Vorlagen können kostenpflichtig sein (Einmalzahlung pro Mandant; alternativ Mini-Abo). Bezahlung läuft über das Subscription-Modul (M28) und Stripe.
|
||||
- Plattform-Vorlagen können kostenpflichtig sein (Einmalzahlung pro Mandant; alternativ Mini-Abo). Bezahlung läuft über das Subscription-Modul (M28) und Legacy-Provider.
|
||||
- Mandanten-Vorlagen, die im Marketplace verkauft werden, generieren Umsatz an den anbietenden Mandanten (Revenue-Share). Konkrete Provision wird mit dem Pricing-Modell festgelegt (geparkt, siehe H.1.1).
|
||||
- Auswertung pro Vorlage: Anzahl Anwendungen, Anzahl bezahlter Käufe, häufige Anpassungen durch Anwender.
|
||||
17.10.5 **Service-Einsätze und Wartung sind keine Beispiele** (siehe N9): „Wartungstermin-Reminder" wurde durch „Termin-Erinnerung an Endkunden" ersetzt, die für jede Termin-Art (Vor-Ort-Termin, Abnahme, Service) gilt. Ein dediziertes Service-Modul kommt erst in Phase 2.
|
||||
@@ -333,7 +333,7 @@ Auslöser entstehen aus den verschiedenen Modulen, der Tenant kombiniert das, wa
|
||||
18.8.5 **Upsell-Logik**:
|
||||
- Wenn der Aufschlags-Verbrauch in einem Monat höher ist als die Differenz zum nächsten Plan, schlägt das System dem Mandanten-Administrator aktiv vor, das Abo zu upgraden („Du hast diesen Monat 87 Euro Aufschlag bezahlt. Mit Plan Cloud+ (49 Euro/Monat zusätzlich) wäre alles enthalten.").
|
||||
- Soft-Recommendation, kein Zwang.
|
||||
18.8.6 **Rechnungsstellung**: Aufschlags-Verbrauch wird in der nächsten Stripe-Rechnung als Zusatzposition ausgewiesen. Mandant sieht in M28 (Subscription) den exakten Verbrauch nachvollziehbar.
|
||||
18.8.6 **Rechnungsstellung**: Aufschlags-Verbrauch wird in der nächsten Legacy-Provider-Rechnung als Zusatzposition ausgewiesen. Mandant sieht in M28 (Subscription) den exakten Verbrauch nachvollziehbar.
|
||||
18.8.7 **Notbremse für Missbrauch**: pro Mandant gibt es eine konfigurierbare absolute Obergrenze („nie mehr als X Euro Aufschlag pro Monat"). Wird sie erreicht, geht das System NICHT in Pause, sondern in einen Drosselungs-Modus mit Klartext-Warnung an den Administrator („Notbremse erreicht, ab jetzt nur noch geschäftskritische KI-Aufrufe (Klartext-Diagnostik). Sofortige Reaktion empfohlen."). Damit ist das Kostenrisiko gedeckelt, aber nichts geht schlagartig schwarz.
|
||||
18.8.8 Reset des Inklusiv-Volumens zum Monatsersten.
|
||||
18.8.9 Im Verbrauchs-Bereich des Mandanten-Administrators werden gezeigt: Verbrauch pro Anwendungsfall, Verbrauch über Zeit, Top-Verbraucher (welche Module / welche Nutzer), Hochrechnung Monatsende, aktueller Tarif, Notbremse-Stand.
|
||||
|
||||
+2
-2
@@ -207,7 +207,7 @@ Sechs eigenständige Module, die jeweils einen wichtigen Geschäfts-Workflow abb
|
||||
6.11.2 Automatische Erinnerungs-Mails 24h und 1h vor dem Termin.
|
||||
6.11.3 SMS-Erinnerungen (kostenpflichtige Zusatz-Funktion).
|
||||
6.11.4 Eigene Domain für Buchungsseiten (`termine.geerkens.de`).
|
||||
6.11.5 Vorauszahlung / Anzahlung über Stripe.
|
||||
6.11.5 Vorauszahlung / Anzahlung über Legacy-Provider.
|
||||
6.11.6 Gruppen-Termine (mehrere Endkunden für einen Slot).
|
||||
6.11.7 KI-Buchungs-Assistent.
|
||||
|
||||
@@ -607,7 +607,7 @@ Sechs eigenständige Module, die jeweils einen wichtigen Geschäfts-Workflow abb
|
||||
15.14.1 Bidirektionale Kommunikation (Chat zwischen Endkunde und Tenant).
|
||||
15.14.2 Eigenes Portal-Branding (Logo + Farben + eigene Domain `kunden.geerkens.de`).
|
||||
15.14.3 Mehrere Portale pro Tenant (Privatkunden vs. Bauträger).
|
||||
15.14.4 Wartungs-Abos / Service-Pakete im Portal abschließbar mit Stripe.
|
||||
15.14.4 Wartungs-Abos / Service-Pakete im Portal abschließbar mit Legacy-Provider.
|
||||
15.14.5 Blog/CMS für redaktionelle Inhalte (Wartungs-Tipps, News).
|
||||
15.14.6 Push-Notifications über installierbare PWA.
|
||||
15.14.7 Auto-Deaktivierung nach X Tagen ohne Login.
|
||||
|
||||
+22
-22
@@ -1,6 +1,6 @@
|
||||
# Block 7: Plattform-Außenseite (Betrieb, Compliance, Zugang)
|
||||
|
||||
Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbares Produkt machen: das Audit-Log für Nachvollziehbarkeit, Stripe-basierte Abrechnung, Onboarding für neue Mandanten, eine Lese-API mit Webhooks für Drittanbieter, der DSGVO-Export, die Mobile-App auf Capacitor-Basis, das öffentliche Hilfe-Center und der interne Help-Desk.
|
||||
Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbares Produkt machen: das Audit-Log für Nachvollziehbarkeit, Legacy-Provider-basierte Abrechnung, Onboarding für neue Mandanten, eine Lese-API mit Webhooks für Drittanbieter, der DSGVO-Export, die Mobile-App auf Capacitor-Basis, das öffentliche Hilfe-Center und der interne Help-Desk.
|
||||
|
||||
---
|
||||
|
||||
@@ -76,16 +76,16 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
|
||||
## Modul 28: Subscriptions / Billing
|
||||
|
||||
**Was es tut:** Verbindet HiveGrid mit Stripe als Bezahl-Anbieter und steuert den gesamten Abo-Lebenszyklus jedes Mandanten, vom Trial über aktive Bezahlung, Pausen, Mahnwesen bis zur Kündigung. Zählt Sitzplätze (Büro vs. Monteur) und nutzungsbasierten Verbrauch (Automationen, KI-Verbrauch).
|
||||
**Was es tut:** Verbindet HiveGrid mit Legacy-Provider als Bezahl-Anbieter und steuert den gesamten Abo-Lebenszyklus jedes Mandanten, vom Trial über aktive Bezahlung, Pausen, Mahnwesen bis zur Kündigung. Zählt Sitzplätze (Büro vs. Monteur) und nutzungsbasierten Verbrauch (Automationen, KI-Verbrauch).
|
||||
|
||||
**Warum es wichtig ist:** Ohne stabile, regelkonforme Abrechnung verdient die Plattform kein Geld. Die Mechanik muss flexibel genug sein, dass Preise später angepasst werden können, ohne den Code zu ändern. Apple-Compliance (siehe 28.X) ist dabei ein hartes Tabu, das die ganze Architektur prägt.
|
||||
|
||||
### 28.1 Bezahl-Anbieter Stripe
|
||||
28.1.1 Stripe ist exklusiver Bezahl-Anbieter in Phase 1, Vertragspartner ist die EU-Tochter Stripe Payments Europe (Irland), DSGVO-Auftragsverarbeitungsvertrag elektronisch unterzeichnet beim Signup.
|
||||
28.1.2 Steuern werden über Stripe Tax mit EU-Reverse-Charge-Logik abgewickelt.
|
||||
### 28.1 Bezahl-Anbieter Legacy-Provider
|
||||
28.1.1 Legacy-Provider ist exklusiver Bezahl-Anbieter in Phase 1, Vertragspartner ist die EU-Tochter Legacy-Provider Payments Europe (Irland), DSGVO-Auftragsverarbeitungsvertrag elektronisch unterzeichnet beim Signup.
|
||||
28.1.2 Steuern werden über Legacy-Provider Tax mit EU-Reverse-Charge-Logik abgewickelt.
|
||||
28.1.3 Zahlungsarten in Phase 1: SEPA-Lastschrift (Default Deutschland/EU) und Kreditkarte.
|
||||
28.1.4 Stripe sendet Ereignisse (Webhooks) an HiveGrid: erfolgreicher Bezahlvorgang, Rechnung erstellt, Zahlung gescheitert, Plan geändert, Subscription gelöscht, Trial-Ende-Vorwarnung.
|
||||
28.1.5 Jedes Stripe-Ereignis wird genau einmal verarbeitet (Doppel-Schutz über eindeutige Stripe-Event-Kennung).
|
||||
28.1.4 Legacy-Provider sendet Ereignisse (Webhooks) an HiveGrid: erfolgreicher Bezahlvorgang, Rechnung erstellt, Zahlung gescheitert, Plan geändert, Subscription gelöscht, Trial-Ende-Vorwarnung.
|
||||
28.1.5 Jedes Legacy-Provider-Ereignis wird genau einmal verarbeitet (Doppel-Schutz über eindeutige Legacy-Provider-Event-Kennung).
|
||||
28.1.6 Plan-Konfiguration ist nicht im Code festgenagelt, sondern in Daten-Strukturen, neue Pläne, Preise und Quotas sind ohne Code-Release änderbar.
|
||||
|
||||
### 28.2 Seat-Modell (Büro/Monteur)
|
||||
@@ -95,7 +95,7 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
28.2.2 Bei jeder Mitarbeiter-Einladung wählt der Mandanten-Admin den Sitzplatz-Typ, Pflichtfeld.
|
||||
28.2.3 Sitzplatz-Typ ist Lizenz-Konzept, Rolle ist Rechte-Konzept, getrennt.
|
||||
28.2.4 Monteur-Sitzplatz darf nur Rollen mit Default-Modus „Baustelle" bekommen (Validierungs-Regel).
|
||||
28.2.5 Sitzplatz-Zähler werden bei jeder Einladung/Aktivierung/Deaktivierung mit Stripe synchronisiert.
|
||||
28.2.5 Sitzplatz-Zähler werden bei jeder Einladung/Aktivierung/Deaktivierung mit Legacy-Provider synchronisiert.
|
||||
28.2.6 Plan-Quotas (z.B. „max. 10 Büro-Sitzplätze, max. 50 Monteur-Sitzplätze") sind pro Plan konfigurierbar.
|
||||
28.2.7 Quota-Verhalten: Default „Hartes Limit", neue Einladung blockiert mit Klartext-Hinweis. Optional „weiches Limit", zusätzliche Sitzplätze werden automatisch nutzungsbasiert abgerechnet.
|
||||
28.2.8 Verbrauchs-Übersicht im Mandanten-Admin zeigt aktuelle Sitzplätze pro Typ, verfügbare Sitzplätze laut Plan, Trend-Chart.
|
||||
@@ -107,17 +107,17 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
28.3.4 Zahlungsmethode ist im Vertriebs-Modus nicht zwingend zu Trial-Beginn.
|
||||
28.3.5 3 Tage und 1 Tag vor Trial-Ende: In-App-Banner und E-Mail-Benachrichtigung mit Klartext-Hinweis und Verweis auf Marketing-Site (NICHT auf In-App-Upgrade, siehe Apple-Compliance 28.X).
|
||||
28.3.6 Trial-Ende ohne Konversion: Mandant geht in 30-Tage-Lösch-Vorlauf (siehe Modul 35.6).
|
||||
28.3.7 Trial-Konversion läuft über Marketing-Site, von dort zurück in die App mit Stripe-Session-Token.
|
||||
28.3.7 Trial-Konversion läuft über Marketing-Site, von dort zurück in die App mit Legacy-Provider-Session-Token.
|
||||
|
||||
### 28.4 Read-Only-Downgrade bei Nichtzahlung
|
||||
28.4.1 Wenn der Mandant nicht bezahlt, kann er nur noch ansehen, nichts mehr ändern, bis er bezahlt, das ist die Klartext-Idee dahinter.
|
||||
28.4.2 Auslöser: Stripe meldet Zahlung gescheitert.
|
||||
28.4.3 Stripe-Standard-Mahnwesen: 3 automatische Wiederholungs-Versuche über 14 Tage (typisch Tag 0, 3, 7, 14).
|
||||
28.4.2 Auslöser: Legacy-Provider meldet Zahlung gescheitert.
|
||||
28.4.3 Legacy-Provider-Standard-Mahnwesen: 3 automatische Wiederholungs-Versuche über 14 Tage (typisch Tag 0, 3, 7, 14).
|
||||
28.4.4 Während Mahnwesen wechselt der Mandant in den Status „Zahlung überfällig" → kompletter Workspace ist Read-Only:
|
||||
- Anmeldung, Daten lesen, Kunden-Portal-Zugang (Endkunden) und Stripe-Kunden-Portal-Zugang bleiben möglich.
|
||||
- Anmeldung, Daten lesen, Kunden-Portal-Zugang (Endkunden) und Legacy-Provider-Kunden-Portal-Zugang bleiben möglich.
|
||||
- Stammdaten-Edits, neue Datensätze, E-Mail-/WhatsApp-/Push-Versand, Automationen-Ausführung, eingehende Webhooks und API-Schreiboperationen sind blockiert.
|
||||
- Eingehende Trigger werden verworfen (nicht in Warteschlange), sonst stauen sich Aktionen auf, die mit gepausten Zahlungen kollidieren.
|
||||
28.4.5 Klartext-Banner: „Zahlung fehlgeschlagen, Konto in 14 Tagen gesperrt, [Zahlungsmethode aktualisieren]" mit Direkt-Link zum Stripe-Kunden-Portal.
|
||||
28.4.5 Klartext-Banner: „Zahlung fehlgeschlagen, Konto in 14 Tagen gesperrt, [Zahlungsmethode aktualisieren]" mit Direkt-Link zum Legacy-Provider-Kunden-Portal.
|
||||
28.4.6 E-Mail-Benachrichtigungen an Mandanten-Admins bei jedem Zustand: erste Zahlung gescheitert, 2. Versuch gescheitert, 1 Tag vor finalem Cancel.
|
||||
28.4.7 Nach 3 Fehlversuchen + 14 Tagen ohne Erfolg: Status wechselt auf „gekündigt".
|
||||
28.4.8 Sobald Zahlung nachgereicht: automatischer Wechsel zurück auf „aktiv".
|
||||
@@ -126,16 +126,16 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
28.5.1 Der Mandant kann seinen Workspace freiwillig pausieren statt zu kündigen, gedacht für Saison-Pausen kleiner Betriebe.
|
||||
28.5.2 Reduzierte Gebühr (Default ca. 1/10 des Standardpreises, exakte Werte gehören in die Pricing-Festlegung), Workspace Read-Only, jederzeit reaktivierbar, Daten bleiben erhalten.
|
||||
28.5.3 Pause-Bestätigung erfordert Eingabe der Phrase „PAUSIEREN" als Schutz gegen Versehen.
|
||||
28.5.4 Reaktivierung über Bezahl-Vorgang in Stripe.
|
||||
28.5.4 Reaktivierung über Bezahl-Vorgang in Legacy-Provider.
|
||||
|
||||
### 28.6 Rechnungsstellung
|
||||
28.6.1 Rechnungs-Übersicht im Mandanten-Admin als Stripe-Kunden-Portal eingebettet (von Stripe gehostet).
|
||||
28.6.1 Rechnungs-Übersicht im Mandanten-Admin als Legacy-Provider-Kunden-Portal eingebettet (von Legacy-Provider gehostet).
|
||||
28.6.2 Funktionen dort: Rechnungs-Historie als PDF herunterladen, Zahlungsmethode aktualisieren, Steuer-Daten/USt-IdNr. editieren.
|
||||
28.6.3 Rechnungen werden in HiveGrid als Referenz gespiegelt; Original-Dateien lädt der User aus Stripe.
|
||||
28.6.3 Rechnungen werden in HiveGrid als Referenz gespiegelt; Original-Dateien lädt der User aus Legacy-Provider.
|
||||
|
||||
### 28.7 Setup-Gebühren
|
||||
28.7.1 Pro Plan optional eine einmalige Setup-Gebühr.
|
||||
28.7.2 Im Stripe-Bezahlvorgang erscheinen zwei Posten, wiederkehrender Plan-Preis plus einmalige Setup-Gebühr.
|
||||
28.7.2 Im Legacy-Provider-Bezahlvorgang erscheinen zwei Posten, wiederkehrender Plan-Preis plus einmalige Setup-Gebühr.
|
||||
28.7.3 Bei Plan-Wechsel zu höherem Plan wird nur die Differenz der Setup-Gebühr berechnet.
|
||||
28.7.4 Klartext-Hinweis im Bezahlvorgang: „Bei Buchung wird zusätzlich eine einmalige Setup-Gebühr von [Betrag] berechnet."
|
||||
|
||||
@@ -144,14 +144,14 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
28.8.2 Pro Plan ein **Inklusiv-Volumen** plus **Aufschlags-Tarif** für Mehrverbrauch (Pay-as-you-go). KI-Funktionen werden NICHT pausiert (siehe M18.8). Konkrete Schwellen und Stückpreise mit Pricing-Festlegung (geparkt, siehe H.1.1).
|
||||
28.8.3 Verbrauchs-Sicht im Mandanten-Admin: aktuelle Periode, Inklusiv-Menge, Verbrauch in Prozent, Trend, Historie der letzten 12 Perioden, aktueller Aufschlags-Verbrauch in Euro, voraussichtlicher Monats-Aufschlag, CSV-Export.
|
||||
28.8.4 KI-Inklusiv-Menge verfällt am Periodenende. Manuelle Boni vom Vertrieb bleiben.
|
||||
28.8.5 **Aufschlags-Verbrauch** wird pro Stripe-Rechnungs-Periode als separate Position ausgewiesen (Detail-Aufschlüsselung pro KI-Funktion und Tag).
|
||||
28.8.5 **Aufschlags-Verbrauch** wird pro Legacy-Provider-Rechnungs-Periode als separate Position ausgewiesen (Detail-Aufschlüsselung pro KI-Funktion und Tag).
|
||||
28.8.6 **Notbremse**: pro Mandant konfigurierbar, max. Aufschlags-Betrag pro Monat. Bei Erreichen wird in Drosselungs-Modus geschaltet (nur Klartext-Diagnostik bleibt aktiv), nicht in Komplett-Pause. Klartext-Warnung an Administrator (siehe M18.8.7).
|
||||
28.8.7 **Upsell-Vorschlag**: wenn Aufschlag in 2 aufeinanderfolgenden Monaten höher liegt als die Differenz zum nächsten Plan, schlägt das System aktiv ein Upgrade vor. Soft-Recommendation, kein Zwang.
|
||||
28.8.8 Bei aufgebrauchtem Inklusiv-Volumen: Klartext im Banner: *„Inklusiv-Volumen verbraucht, weitere Anfragen kosten ab jetzt [Aufschlags-Tarif] pro 1.000 Tokens. [Plan-Vergleich auf hivegrid.de]"*. Web-App: direkter Link zur Vergleichs-Seite. Mobile-App: Hinweis ohne Upgrade-UI (Apple-Compliance, siehe 28.X.10).
|
||||
|
||||
### 28.X Phase 2 / bewusst NICHT in Phase 1
|
||||
28.X.1 In-App-Plan-Wechsel und Add-On-Käufe (alles muss zur Marketing-Site, Apple-Compliance Phase 1).
|
||||
28.X.2 Mehr-Mandanten-Abrechnung für Konzerne (mehrere Mandanten in einer Stripe-Subscription gebündelt).
|
||||
28.X.2 Mehr-Mandanten-Abrechnung für Konzerne (mehrere Mandanten in einer Legacy-Provider-Subscription gebündelt).
|
||||
28.X.3 Individual-Pricing pro Mandant durch Plattform-Admin (Enterprise-Verhandlung).
|
||||
28.X.4 Promo-Code-System mit Rabatt-Codes im Bezahlvorgang.
|
||||
28.X.5 Jahres-Abrechnung mit konfigurierbarem Jahres-Rabatt.
|
||||
@@ -182,7 +182,7 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
**Warum es wichtig ist:** Wenn der Mandant nach Anmeldung in einer leeren App landet und nicht weiß, wo er anfangen soll, ist er weg. Onboarding entscheidet über die Aktivierungs-Quote. Branchen-Templates müssen so abgelegt sein, dass Phase 2 weitere Branchen ohne Code-Patch möglich macht.
|
||||
|
||||
### 29.1 Mandanten-Anmeldung (Tenant-Anlage)
|
||||
29.1.1 Anmelde-Pfad: Marketing-Site `hivegrid.de/signup` → in-App-Account-Anlage → Mandanten-Daten → Plan-Auswahl → Stripe-Bezahlvorgang → Onboarding-Wizard.
|
||||
29.1.1 Anmelde-Pfad: Marketing-Site `hivegrid.de/signup` → in-App-Account-Anlage → Mandanten-Daten → Plan-Auswahl → Legacy-Provider-Bezahlvorgang → Onboarding-Wizard.
|
||||
29.1.2 Beim ersten Login auf der Mandanten-Adresse: automatische Weiterleitung in den Wizard.
|
||||
29.1.3 Wizard läuft im Vollbild-Modus ohne Sidebar, mit Fortschritts-Anzeige.
|
||||
29.1.4 Wizard ist resumable, bei Abbruch wird beim nächsten Login zum letzten Schritt zurückgekehrt.
|
||||
@@ -378,7 +378,7 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
35.3.1 Mandanten-Kündigung läuft als Multi-Step-Workflow:
|
||||
- Schritt 1: Klartext-Erklärung was passiert (Status wechselt sofort auf „Lösch-Vorlauf", Workspace bleibt 30 Tage Read-Only sichtbar, danach Hard-Delete aller Daten unwiderruflich).
|
||||
- Schritt 2: Datensicherungs-Hinweis mit Direkt-Link zum Mandanten-Export.
|
||||
- Schritt 3: Stripe-Hinweis (Restbetrag, Pro-rata-Erstattung, letzte Rechnung).
|
||||
- Schritt 3: Legacy-Provider-Hinweis (Restbetrag, Pro-rata-Erstattung, letzte Rechnung).
|
||||
- Schritt 4: Identitäts-Bestätigung (Passwort + 2FA).
|
||||
- Schritt 5: Final-Klick mit Eingabe des Mandanten-Slugs als Confirm-Phrase.
|
||||
35.3.2 30-Tage-Grace-Period: jeder Mandanten-Admin kann mit einem Klick zurückziehen, Status zurück auf „aktiv". Audit dokumentiert wer kündigte und wer zurückzog.
|
||||
@@ -601,7 +601,7 @@ Acht Module, die HiveGrid als bezahlbares, regelkonformes und sicher betreibbare
|
||||
- Mitarbeiter: HR-Hub-Übersicht, Krankmeldung/Urlaubsantrag stellen.
|
||||
- Integrationen: KWP-Setup, Google-Kalender verbinden, AirCall-Setup, E-Mail-Integration (Gmail/Outlook).
|
||||
- Mobile: Mobile-App-Setup, Offline-Modus auf Baustelle.
|
||||
- Abrechnung: Stripe-Setup, Plan wechseln, Rechnungen einsehen.
|
||||
- Abrechnung: Legacy-Provider-Setup, Plan wechseln, Rechnungen einsehen.
|
||||
- Tutorials: Form-Builder-Tutorial, Automation-Builder-Tutorial.
|
||||
38.2.2 Phase 1 nur Deutsch. Andere Sprachen: 404 mit Klartext-Banner „Englischsprachige Hilfe ist in Vorbereitung. Hier ist die deutsche Version." plus automatischer Redirect auf DE.
|
||||
38.2.3 Performance Phase 1: Client-side Volltext-Index (FlexSearch oder ähnlich, ca. 50 KB für 20 Artikel) ODER Server-side Postgres-FTS, Tooling-Wahl beim Bau.
|
||||
|
||||
Binary file not shown.
@@ -636,7 +636,7 @@ Activity-Typen produziert von Modul 6:
|
||||
- **Reminder-Mails:** 24h/1h vor Termin automatisch
|
||||
- **SMS-Reminder:** via Twilio/Sipgate (kostenpflichtige Add-on-Funktion)
|
||||
- **Custom-Domain für Booking-Pages:** `termine.{tenant-domain}` statt `app.hivegrid.de/buch/{tenant}/...` (nur Enterprise)
|
||||
- **Pre-Payment / Deposit:** Stripe-Vorauszahlung beim Buchen
|
||||
- **Pre-Payment / Deposit:** Legacy-Provider-Vorauszahlung beim Buchen
|
||||
- **Round-Robin mit Gewichtung:** Provider mit höherem Faktor bekommt mehr Termine
|
||||
- **Workload-Cap pro Provider:** „max. 5 Termine pro Tag"
|
||||
- **Tenant-Branding-Customization** auf öffentlicher Page (Logo, Farben — kommt aus Modul 31 in Phase 2)
|
||||
|
||||
@@ -991,7 +991,7 @@ PortalUser hat **keine** atomaren Permissions im M27-Stil. Stattdessen wirken im
|
||||
- **Blog/CMS im Portal** (Tenant kann redaktionelle Inhalte für Endkunden veröffentlichen — Wartungs-Tipps, News)
|
||||
- **Mehrere Portale pro Tenant** mit unterschiedlichem Branding/Slug (z.B. Privatkunden vs. Bauträger)
|
||||
- **Portal-eigenes Branding** (eigenes Logo + Farben + Custom-Domain `portal.geerkens.de`)
|
||||
- **PortalSubscription** (Wartungs-Abos, Service-Pakete im Portal abschließbar mit Stripe-Integration)
|
||||
- **PortalSubscription** (Wartungs-Abos, Service-Pakete im Portal abschließbar mit Legacy-Provider-Integration)
|
||||
- **Multi-Faktor-Auth für PortalUser** (TOTP-optional)
|
||||
- **In-App-Notifications im Portal** (statt nur Email)
|
||||
- **Bulk-Download** (ZIP) aller freigegebenen Dokumente
|
||||
|
||||
+4
-4
@@ -129,7 +129,7 @@ Status-Werte:
|
||||
```
|
||||
trial → Self-Service-Tenant in Trial-Phase (5-7 Tage)
|
||||
active → Bezahlend
|
||||
past_due → Stripe-Zahlung gescheitert, Read-Only-Modus
|
||||
past_due → Legacy-Provider-Zahlung gescheitert, Read-Only-Modus
|
||||
frozen → Tenant zahlt reduzierte Gebühr, Workspace read-only, jederzeit reaktivierbar
|
||||
suspended → Manuell gesperrt von Plattform-Admin (z.B. AGB-Verstoß)
|
||||
deletion_pending → Kündigung läuft, 30-Tage-Grace
|
||||
@@ -138,7 +138,7 @@ deleted → Hard-Delete erfolgt
|
||||
|
||||
**Übergänge:**
|
||||
- `trial → active`: nach Zahlungs-Setup
|
||||
- `active → past_due`: Stripe-Webhook bei Fehlversuch
|
||||
- `active → past_due`: Legacy-Provider-Webhook bei Fehlversuch
|
||||
- `past_due → active`: nach Nachzahlung
|
||||
- `past_due → deletion_pending`: nach 30 Tagen Read-Only
|
||||
- `active → frozen`: User klickt „Workspace pausieren" + reduzierten Plan bestätigen
|
||||
@@ -444,7 +444,7 @@ Wenn der zu deaktivierende User noch zugewiesene Entitäten hat, wird ein Bestä
|
||||
```
|
||||
SubscriptionProduct (z.B. "Cloud", "Cloud+", "Enterprise")
|
||||
├── enthält viele SubscriptionFeatures (z.B. "crm", "automation", "kwp_integration")
|
||||
└── verknüpft mit Stripe-Price
|
||||
└── verknüpft mit Legacy-Provider-Price
|
||||
TenantSubscription
|
||||
└── verweist auf SubscriptionProduct + Status
|
||||
```
|
||||
@@ -493,7 +493,7 @@ Bezug aus Master-Session-Datei (Architektur-Vorschriften):
|
||||
|
||||
## Detail-Spec-Status: DRAFT
|
||||
|
||||
Erste vollständige Detail-Spec für Modul 27. **Vor Bau:** Verifizierung mit Noah (zusammen mit Pflichtenheft-Sweep). Bei Implementierung dann konkrete Permission-IDs, RLS-Policy-SQL, Stripe-Price-IDs ergänzen.
|
||||
Erste vollständige Detail-Spec für Modul 27. **Vor Bau:** Verifizierung mit Noah (zusammen mit Pflichtenheft-Sweep). Bei Implementierung dann konkrete Permission-IDs, RLS-Policy-SQL, Legacy-Provider-Price-IDs ergänzen.
|
||||
|
||||
**Offene Detail-Punkte (nicht-blockierend, beim Bau zu klären):**
|
||||
- Konkrete Permission-IDs pro Modul (entstehen modulweise mit den jeweiligen Detail-Specs)
|
||||
|
||||
+53
-53
@@ -11,14 +11,14 @@ spec_style: requirements-pur
|
||||
|
||||
# Modul 28 — Subscriptions / Billing
|
||||
|
||||
> **Detail-Spec gemäß LP-9.** Subscription-Engine und Billing-Anbindung an Stripe. Pricing-Modell selbst ist **geparkt** — die Engine wird so flexibel gebaut, dass konkrete Plans später konfigurativ definiert werden können (LP-7 + Brainstorming „Geparkt für später"). **Apple-Compliance (LP-8):** keinerlei Pricing-/Upgrade-UI in der App selbst — Self-Service-Signup ausschließlich über Marketing-Site `hivegrid.de`.
|
||||
> **Detail-Spec gemäß LP-9.** Subscription-Engine und Billing-Anbindung an Legacy-Provider. Pricing-Modell selbst ist **geparkt** — die Engine wird so flexibel gebaut, dass konkrete Plans später konfigurativ definiert werden können (LP-7 + Brainstorming „Geparkt für später"). **Apple-Compliance (LP-8):** keinerlei Pricing-/Upgrade-UI in der App selbst — Self-Service-Signup ausschließlich über Marketing-Site `hivegrid.de`.
|
||||
|
||||
## Themenblöcke
|
||||
|
||||
```
|
||||
A. Datenmodell + Pricing-Konfiguration
|
||||
B. Subscription-Lifecycle + Status-Übergänge
|
||||
C. Self-Service-Signup-Flow + Stripe-Checkout
|
||||
C. Self-Service-Signup-Flow + Legacy-Provider-Checkout
|
||||
D. Seat-Modell (Büro vs. Monteur)
|
||||
E. Trial-Phase
|
||||
F. Dunning + Past-Due
|
||||
@@ -61,15 +61,15 @@ Ein Plan-Produkt (z.B. `Cloud`, `Cloud+`, `Enterprise` — Namen werden später
|
||||
|
||||
#### `SubscriptionPrice`
|
||||
|
||||
Konkreter Preispunkt (Stripe-Price-Mapping).
|
||||
Konkreter Preispunkt (Legacy-Provider-Price-Mapping).
|
||||
|
||||
- `id`, `subscription_product_id` (FK)
|
||||
- `stripe_price_id` (string, eindeutig)
|
||||
- `legacyProvider_price_id` (string, eindeutig)
|
||||
- `currency` (ISO 4217 — `EUR` Default)
|
||||
- `interval` (Enum: `month | year | one_time` — `one_time` für Setup-Fee)
|
||||
- `interval_count` (Integer, default 1)
|
||||
- `unit_amount_cents` (Integer)
|
||||
- `tax_behavior` (Enum: `inclusive | exclusive` — Stripe-konform)
|
||||
- `tax_behavior` (Enum: `inclusive | exclusive` — Legacy-Provider-konform)
|
||||
- `is_active`
|
||||
- `valid_from`, `valid_until` (für preisliche Übergangsphasen)
|
||||
|
||||
@@ -115,7 +115,7 @@ Aktive Subscription pro Tenant.
|
||||
- `id`, `tenant_id` (unique, M:1)
|
||||
- `status` (Enum: `trial | active | past_due | cancelled | frozen` — siehe Block B)
|
||||
- `subscription_product_id` (FK)
|
||||
- `stripe_customer_id`, `stripe_subscription_id`
|
||||
- `legacyProvider_customer_id`, `legacyProvider_subscription_id`
|
||||
- `started_at`, `current_period_start`, `current_period_end`
|
||||
- `trial_start`, `trial_end`
|
||||
- `cancel_at_period_end` (Boolean)
|
||||
@@ -149,15 +149,15 @@ Verbrauchs-Datensatz für metered Pricing.
|
||||
|
||||
- `id`, `tenant_subscription_id`, `metric_code`, `period_start`, `period_end`
|
||||
- `usage_amount` (Integer)
|
||||
- `reported_to_stripe_at` (Timestamp, nullable)
|
||||
- `reported_to_legacyProvider_at` (Timestamp, nullable)
|
||||
- `created_at`
|
||||
- Indexe auf `(tenant_subscription_id, metric_code, period_start)`
|
||||
|
||||
#### `CheckoutSessionStatus`
|
||||
|
||||
Tracking des Stripe-Checkout-Flows pro Tenant-Anlage.
|
||||
Tracking des Legacy-Provider-Checkout-Flows pro Tenant-Anlage.
|
||||
|
||||
- `id`, `tenant_id` (FK), `stripe_checkout_session_id`
|
||||
- `id`, `tenant_id` (FK), `legacyProvider_checkout_session_id`
|
||||
- `status` (Enum: `pending | completed | expired | failed`)
|
||||
- `intent` (Enum: `initial_signup | plan_change | reactivate_from_frozen | reactivate_from_past_due`)
|
||||
- `created_at`, `completed_at`, `expires_at`
|
||||
@@ -199,7 +199,7 @@ Status-Werte (entsprechen M27 A.5 Tenant-Status-Werten — `TenantSubscription.s
|
||||
```
|
||||
trial → Self-Service-Signup-Phase, Vertrieb-freigegeben für 5-7 Tage
|
||||
active → Bezahlend, voller Funktionsumfang
|
||||
past_due → Stripe-Zahlung gescheitert, Read-Only (siehe Block G)
|
||||
past_due → Legacy-Provider-Zahlung gescheitert, Read-Only (siehe Block G)
|
||||
cancelled → User-Kündigung wirkt zum Period-Ende oder sofort
|
||||
frozen → User pausiert Workspace, reduzierte Gebühr, Read-Only (siehe Block H)
|
||||
```
|
||||
@@ -208,11 +208,11 @@ frozen → User pausiert Workspace, reduzierte Gebühr, Read-Only (siehe Blo
|
||||
|
||||
| Von | Nach | Trigger |
|
||||
|---|---|---|
|
||||
| `trial` | `active` | Trial-Konversion: Stripe-Checkout-Setup erfolgreich abgeschlossen |
|
||||
| `trial` | `active` | Trial-Konversion: Legacy-Provider-Checkout-Setup erfolgreich abgeschlossen |
|
||||
| `trial` | `cancelled` | Trial läuft ab ohne Konversion → Tenant wird zu `deletion_pending` (M27) |
|
||||
| `active` | `past_due` | Stripe-Webhook `invoice.payment_failed` |
|
||||
| `past_due` | `active` | Nachzahlung erfolgreich (Stripe-Webhook `invoice.payment_succeeded`) |
|
||||
| `past_due` | `cancelled` | Nach 14 Tagen + 3 Dunning-Versuchen erfolglos → Stripe gibt `subscription.deleted` |
|
||||
| `active` | `past_due` | Legacy-Provider-Webhook `invoice.payment_failed` |
|
||||
| `past_due` | `active` | Nachzahlung erfolgreich (Legacy-Provider-Webhook `invoice.payment_succeeded`) |
|
||||
| `past_due` | `cancelled` | Nach 14 Tagen + 3 Dunning-Versuchen erfolglos → Legacy-Provider gibt `subscription.deleted` |
|
||||
| `active` | `frozen` | User klickt „Workspace pausieren" + bestätigt reduzierten Plan |
|
||||
| `frozen` | `active` | User klickt „Reaktivieren" + Standard-Plan-Checkout |
|
||||
| `frozen` | `past_due` | Reduzierte Gebühr scheitert |
|
||||
@@ -222,7 +222,7 @@ frozen → User pausiert Workspace, reduzierte Gebühr, Read-Only (siehe Blo
|
||||
### Übergangs-Hooks (Side-Effects)
|
||||
|
||||
Bei jedem Übergang wird ausgelöst:
|
||||
- Audit-Log-Eintrag mit alt/neu Status, Trigger-Quelle, Stripe-Event-ID
|
||||
- Audit-Log-Eintrag mit alt/neu Status, Trigger-Quelle, Legacy-Provider-Event-ID
|
||||
- Activity-Stream-Eintrag (`subscription_status_changed`)
|
||||
- Tenant-Status-Synchronisation (M27 A.5)
|
||||
- Notification an Tenant-Admin (Email + In-App via M22)
|
||||
@@ -230,39 +230,39 @@ Bei jedem Übergang wird ausgelöst:
|
||||
|
||||
---
|
||||
|
||||
## Block C — Self-Service-Signup-Flow + Stripe-Checkout
|
||||
## Block C — Self-Service-Signup-Flow + Legacy-Provider-Checkout
|
||||
|
||||
### Signup-Pfad (extern → intern)
|
||||
|
||||
Externer Pfad — siehe M27 A.1:
|
||||
1. Marketing-Site `hivegrid.de/signup` (Next.js, extern, **nicht** Teil dieser Codebase)
|
||||
2. Leitet zu `app.hivegrid.de/signup` für Account-Erstellung
|
||||
3. Nach Account-Anlage: automatischer Tenant-Anlage-Schritt + Stripe-Checkout
|
||||
3. Nach Account-Anlage: automatischer Tenant-Anlage-Schritt + Legacy-Provider-Checkout
|
||||
|
||||
### In-App-Signup-Schritte (`/signup`)
|
||||
|
||||
1. Auth-Account-Anlage (siehe M27 B.1) — Email, Pwd, AGB, DSGVO, AVV
|
||||
2. Tenant-Daten — Firmenname, Slug, Branche, Größe (siehe M27 A.1)
|
||||
3. Plan-Auswahl mit `is_self_service_eligible=true`-Filter
|
||||
4. Stripe-Checkout-Session-Erstellung mit `intent=initial_signup`
|
||||
5. Redirect auf Stripe-Checkout (extern bei Stripe gehostet)
|
||||
4. Legacy-Provider-Checkout-Session-Erstellung mit `intent=initial_signup`
|
||||
5. Redirect auf Legacy-Provider-Checkout (extern bei Legacy-Provider gehostet)
|
||||
6. Nach Erfolg → `/{tenant}/onboarding/setup/` (siehe M29)
|
||||
|
||||
### Checkout-Konfiguration
|
||||
|
||||
- **Stripe-Customer** mit Tenant-`id` als `metadata.tenant_id`
|
||||
- **Legacy-Provider-Customer** mit Tenant-`id` als `metadata.tenant_id`
|
||||
- **Subscription-Setup** mit Trial (siehe Block E)
|
||||
- **Steuer-Behandlung:** Stripe Tax aktiv, EU-Reverse-Charge-Logik
|
||||
- **Steuer-Behandlung:** Legacy-Provider Tax aktiv, EU-Reverse-Charge-Logik
|
||||
- **Zahlungsmethoden:** SEPA-Lastschrift (Default DE/EU), Kreditkarte
|
||||
- **DPA (Auftragsverarbeitungsvertrag):** wird elektronisch im Signup unterzeichnet (M27 A.1 — AVV-Akzeptanz-Checkbox)
|
||||
- **EU-Entity-Präferenz:** Stripe Ireland Ltd. (Stripe Payments Europe DAC — EU-Vertragspartner)
|
||||
- **EU-Entity-Präferenz:** Legacy-Provider Ireland Ltd. (Legacy-Provider Payments Europe DAC — EU-Vertragspartner)
|
||||
|
||||
### Stripe-Webhooks (Pflicht-Handling)
|
||||
### Legacy-Provider-Webhooks (Pflicht-Handling)
|
||||
|
||||
| Webhook-Event | Wirkung in HiveGrid |
|
||||
|---|---|
|
||||
| `checkout.session.completed` | `CheckoutSessionStatus.status = completed`, Trial-Aktivierung oder direkter Active-Wechsel |
|
||||
| `invoice.created` | Rechnung lokal als Referenz speichern (Customer-Portal lädt Original aus Stripe) |
|
||||
| `invoice.created` | Rechnung lokal als Referenz speichern (Customer-Portal lädt Original aus Legacy-Provider) |
|
||||
| `invoice.payment_succeeded` | Falls `past_due` → `active`-Übergang triggern |
|
||||
| `invoice.payment_failed` | `past_due`-Übergang triggern, Dunning-Counter erhöhen |
|
||||
| `customer.subscription.updated` | Plan-Wechsel propagieren (Snapshot aktualisieren) |
|
||||
@@ -271,7 +271,7 @@ Externer Pfad — siehe M27 A.1:
|
||||
|
||||
### Idempotenz
|
||||
|
||||
Webhook-Handler **Pflicht-idempotent** über `stripe_event_id` als Unique-Constraint in einer `StripeWebhookLog`-Tabelle (Schreib-Idempotenz, AV #8).
|
||||
Webhook-Handler **Pflicht-idempotent** über `legacyProvider_event_id` als Unique-Constraint in einer `Legacy-ProviderWebhookLog`-Tabelle (Schreib-Idempotenz, AV #8).
|
||||
|
||||
---
|
||||
|
||||
@@ -294,10 +294,10 @@ Spiegelt LP-2 (Büro vs. Baustelle als kontextuelle Modi).
|
||||
- Ein Monteur-Seat kann **nur** Rollen mit Default-UI-Modus `Baustelle` zugewiesen bekommen (Validierungs-Regel)
|
||||
- Ein Büro-Seat kann jede Rolle bekommen
|
||||
|
||||
### Seat-Counting + Stripe-Sync
|
||||
### Seat-Counting + Legacy-Provider-Sync
|
||||
|
||||
- Bei Einladung/Aktivierung eines neuen Users: Seat-Counter hochzählen, Stripe-`Subscription.items[].quantity` updaten
|
||||
- Bei Deaktivierung/Entfernung: Seat-Counter runter, Stripe-Update zum Period-Ende (proration nach Tenant-Admin-Setting)
|
||||
- Bei Einladung/Aktivierung eines neuen Users: Seat-Counter hochzählen, Legacy-Provider-`Subscription.items[].quantity` updaten
|
||||
- Bei Deaktivierung/Entfernung: Seat-Counter runter, Legacy-Provider-Update zum Period-Ende (proration nach Tenant-Admin-Setting)
|
||||
- **Übersicht in `/{tenant}/admin/usage/`:** aktuelle Seats pro Typ + verfügbare Seats laut Plan + Trend-Chart
|
||||
|
||||
### Plan-Quotas
|
||||
@@ -324,7 +324,7 @@ Bei Erreichung Quota:
|
||||
- **Dauer:** 5-7 Tage (per `SubscriptionProduct.trial_default_days`)
|
||||
- **Vertriebs-freigegeben:** Vertrieb (Plattform-Admin) muss Trial **manuell aktivieren** (`requires_manual_activation=true` für Phase-1-Trials), um Spam zu verhindern
|
||||
- **Voller Funktionsumfang während Trial** (kein Read-Only)
|
||||
- **Stripe:** Subscription mit `trial_end` gesetzt, keine Zahlungs-Auslösung vor Trial-Ende
|
||||
- **Legacy-Provider:** Subscription mit `trial_end` gesetzt, keine Zahlungs-Auslösung vor Trial-Ende
|
||||
- **Zahlungsmethode:** **nicht** zwingend zu Trial-Beginn (Vertriebs-Modus). Wird in Phase 2 für Self-Service-Trials erforderlich (User-Diskussion auslagerbar)
|
||||
|
||||
### Trial-Aktivierungs-Flow
|
||||
@@ -342,22 +342,22 @@ Bei Erreichung Quota:
|
||||
|
||||
### Trial-Konversion
|
||||
|
||||
Tenant-Admin geht auf Marketing-Site (`hivegrid.de/upgrade`), wählt Plan, gelangt zurück nach `app.hivegrid.de/{tenant}/admin/subscription/checkout-return` mit Stripe-Session-Token → CheckoutSessionStatus + Webhook-Verarbeitung → `active`-Übergang.
|
||||
Tenant-Admin geht auf Marketing-Site (`hivegrid.de/upgrade`), wählt Plan, gelangt zurück nach `app.hivegrid.de/{tenant}/admin/subscription/checkout-return` mit Legacy-Provider-Session-Token → CheckoutSessionStatus + Webhook-Verarbeitung → `active`-Übergang.
|
||||
|
||||
---
|
||||
|
||||
## Block F — Dunning + Past-Due
|
||||
|
||||
### Stripe-Standard-Dunning
|
||||
### Legacy-Provider-Standard-Dunning
|
||||
|
||||
- **3 Wiederholungs-Versuche** über **14 Tage** (Stripe Smart Retries oder eigene Schedule)
|
||||
- **3 Wiederholungs-Versuche** über **14 Tage** (Legacy-Provider Smart Retries oder eigene Schedule)
|
||||
- Versuche typischerweise: Tag 0 (initial), Tag 3, Tag 7, Tag 14
|
||||
- HiveGrid empfängt `invoice.payment_failed` und `invoice.payment_succeeded`-Events
|
||||
|
||||
### Past-Due-Verhalten
|
||||
|
||||
- Workspace **read-only** (siehe Block G)
|
||||
- In-App-Banner: *„Zahlung fehlgeschlagen, Konto in 14 Tagen gesperrt — [Zahlungsmethode aktualisieren]"* mit Direkt-Link zum Stripe-Customer-Portal
|
||||
- In-App-Banner: *„Zahlung fehlgeschlagen, Konto in 14 Tagen gesperrt — [Zahlungsmethode aktualisieren]"* mit Direkt-Link zum Legacy-Provider-Customer-Portal
|
||||
- Email-Notification an Tenant-Admins mit Klartext + Direkt-Link
|
||||
- Nach 3 Fehlversuchen + 14 Tagen ohne Erfolg: `cancelled`
|
||||
|
||||
@@ -396,14 +396,14 @@ Bei Status `past_due` ODER `frozen` ODER `cancelled` (mit `cancel_at_period_end=
|
||||
| Customer-Portal-Zugang (Endkunden) | ✓ (read-only) |
|
||||
| API (Read) | ✓ |
|
||||
| API (Write) | ✗ (402) |
|
||||
| Stripe-Customer-Portal-Zugang | ✓ (Pflicht zur Reaktivierung) |
|
||||
| Legacy-Provider-Customer-Portal-Zugang | ✓ (Pflicht zur Reaktivierung) |
|
||||
| Plan-Wechsel / Reaktivierung | ✓ (einziger erlaubter Schreib-Pfad) |
|
||||
|
||||
### Implementierungs-Vorgabe
|
||||
|
||||
- Middleware **vor** Route-Loader: prüft `TenantSubscription.status` + `is_writable_status()`-Helper
|
||||
- Middleware **vor** Worker-Job-Ausführung: blockiert Automation-Worker, Notification-Worker, Webhook-Outbound-Worker bei nicht-schreibendem Status
|
||||
- Cache der Status-Auflösung: 30 Sekunden (TTL), bei Stripe-Webhook explizit invalidieren
|
||||
- Cache der Status-Auflösung: 30 Sekunden (TTL), bei Legacy-Provider-Webhook explizit invalidieren
|
||||
|
||||
### Klartext-Hinweise
|
||||
|
||||
@@ -423,7 +423,7 @@ Tenant kann Workspace pausieren statt zu kündigen (z.B. Saison-Pause bei kleine
|
||||
1. Tenant-Admin in `/{tenant}/admin/subscription/` → „Workspace pausieren"
|
||||
2. Klartext-Erklärung: was bleibt, was nicht geht, welche Gebühr
|
||||
3. Bestätigung mit Tipp-Eingabe „PAUSIEREN" (Multi-Step-Schutz)
|
||||
4. Stripe: Subscription-Wechsel auf `frozen_plan_price` (eigener `SubscriptionPrice` mit reduzierter Gebühr)
|
||||
4. Legacy-Provider: Subscription-Wechsel auf `frozen_plan_price` (eigener `SubscriptionPrice` mit reduzierter Gebühr)
|
||||
5. `TenantSubscription.status = frozen`, `frozen_since = now()`
|
||||
6. M27 Tenant-Status synchronisiert auf `frozen`
|
||||
|
||||
@@ -435,7 +435,7 @@ Tenant kann Workspace pausieren statt zu kündigen (z.B. Saison-Pause bei kleine
|
||||
### Reaktivierungs-Flow
|
||||
|
||||
1. User klickt In-App-Banner „Reaktivieren"
|
||||
2. Stripe-Checkout-Session mit `intent=reactivate_from_frozen` und gewähltem Standard-Plan
|
||||
2. Legacy-Provider-Checkout-Session mit `intent=reactivate_from_frozen` und gewähltem Standard-Plan
|
||||
3. Nach Erfolg: `frozen → active`-Übergang
|
||||
|
||||
### Sonderfälle
|
||||
@@ -462,12 +462,12 @@ Engine baut bereits Tracking auf, **konkrete Pricing-Schwellen geparkt**:
|
||||
|
||||
- Jede Automation-Trigger-Ausführung: `TenantSubscriptionUsageRecord` inkrementieren (idempotent über Trigger-Run-ID)
|
||||
- Jeder LLM-Call: Token-Verbrauch nach Response loggen, in `Credit`-Verbrauch verrechnen
|
||||
- Aggregation pro **Period** (entspricht Stripe-Subscription-Period — typisch monatlich)
|
||||
- Aggregation pro **Period** (entspricht Legacy-Provider-Subscription-Period — typisch monatlich)
|
||||
|
||||
### Reporting an Stripe
|
||||
### Reporting an Legacy-Provider
|
||||
|
||||
- Bei `metric_code` mit `is_metered=true`-Subscription-Item: Usage-Reporting an Stripe via `usage_records.create` am Period-Ende oder real-time (Strategie pro Metrik konfigurierbar)
|
||||
- `reported_to_stripe_at`-Feld für Tracking
|
||||
- Bei `metric_code` mit `is_metered=true`-Subscription-Item: Usage-Reporting an Legacy-Provider via `usage_records.create` am Period-Ende oder real-time (Strategie pro Metrik konfigurierbar)
|
||||
- `reported_to_legacyProvider_at`-Feld für Tracking
|
||||
|
||||
### In-App-Sicht (`/{tenant}/admin/usage/`)
|
||||
|
||||
@@ -546,7 +546,7 @@ Permissions: `billing.read`.
|
||||
|
||||
- `SubscriptionProduct.setup_fee_required = true` aktiviert Pflicht-Setup-Fee
|
||||
- Separater `SubscriptionPrice` mit `interval=one_time`
|
||||
- Im Stripe-Checkout: zwei Items (recurring + one_time)
|
||||
- Im Legacy-Provider-Checkout: zwei Items (recurring + one_time)
|
||||
|
||||
### Tracking
|
||||
|
||||
@@ -591,10 +591,10 @@ Sidebar-Hauptpunkt **Admin** (Workspace-Admin, siehe M27 A.3) → Sub-Eintrag
|
||||
```
|
||||
/{tenant}/admin/subscription/ → Subscription-Übersicht
|
||||
/{tenant}/admin/subscription/plan-info/ → Plan-Details (Read-Only)
|
||||
/{tenant}/admin/subscription/checkout-return/ → Stripe-Checkout-Return-Handler
|
||||
/{tenant}/admin/subscription/checkout-return/ → Legacy-Provider-Checkout-Return-Handler
|
||||
/{tenant}/admin/usage/ → Verbrauchs-Übersicht (Trigger, AI-Token, Seats)
|
||||
/{tenant}/admin/usage/ai-credits/ → AI-Credits-Detail
|
||||
/{tenant}/admin/billing/ → Stripe-Customer-Portal-Embed (Rechnungen + Zahlungsmethode)
|
||||
/{tenant}/admin/billing/ → Legacy-Provider-Customer-Portal-Embed (Rechnungen + Zahlungsmethode)
|
||||
```
|
||||
|
||||
### `/admin/subscription/` — Übersicht
|
||||
@@ -623,7 +623,7 @@ Siehe Block I.
|
||||
|
||||
### `/admin/billing/`
|
||||
|
||||
Stripe-Customer-Portal-Embed (Stripe-gehostet, IFrame oder Redirect):
|
||||
Legacy-Provider-Customer-Portal-Embed (Legacy-Provider-gehostet, IFrame oder Redirect):
|
||||
- Rechnungs-Historie (PDF-Download)
|
||||
- Zahlungsmethode aktualisieren
|
||||
- Steuer-Daten / USt-Id editieren
|
||||
@@ -695,7 +695,7 @@ Pflicht-Texte (LP-10 + AV #1):
|
||||
- **Seat-Quota-erreicht:** *„Plan-Limit von [N] [Typ]-Seats erreicht. Plan-Wechsel über hivegrid.de"*
|
||||
- **AI-Credits-aufgebraucht:** *„AI-Credits für diese Period verbraucht. Verfügbar wieder am [Period-Start]. Plan-Wechsel über hivegrid.de"*
|
||||
- **Trigger-Volumen-Limit:** *„Automation-Trigger-Limit erreicht für diese Period. Eingehende Trigger werden verworfen bis [Period-Start]. Plan-Wechsel über hivegrid.de"*
|
||||
- **Stripe-Webhook-Verarbeitungsfehler:** Plattform-Admin-Alert mit Klartext-Stack-Trace
|
||||
- **Legacy-Provider-Webhook-Verarbeitungsfehler:** Plattform-Admin-Alert mit Klartext-Stack-Trace
|
||||
- **Plan-Wechsel-Confirmation-Email:** *„Plan-Wechsel auf [Plan-Name] wirksam ab [Datum]. Differenz: [Betrag] EUR."*
|
||||
- **Setup-Fee-Hinweis im Checkout:** *„Bei Buchung wird zusätzlich eine einmalige Setup-Gebühr von [Betrag] berechnet."*
|
||||
|
||||
@@ -703,8 +703,8 @@ Pflicht-Texte (LP-10 + AV #1):
|
||||
|
||||
| Fehler | Klartext + Lösungs-Hinweis |
|
||||
|---|---|
|
||||
| Stripe-Checkout-Session abgelaufen | *„Die Bezahl-Session ist abgelaufen. Bitte Plan-Wahl wiederholen."* + Direkt-Link |
|
||||
| Stripe-Customer-Portal nicht erreichbar | *„Die Rechnungs-Verwaltung ist gerade nicht erreichbar. Bitte später erneut versuchen oder [Support-Link]"* |
|
||||
| Legacy-Provider-Checkout-Session abgelaufen | *„Die Bezahl-Session ist abgelaufen. Bitte Plan-Wahl wiederholen."* + Direkt-Link |
|
||||
| Legacy-Provider-Customer-Portal nicht erreichbar | *„Die Rechnungs-Verwaltung ist gerade nicht erreichbar. Bitte später erneut versuchen oder [Support-Link]"* |
|
||||
| Plan-Wechsel auf nicht existierenden Plan | *„Der gewählte Plan ist nicht mehr verfügbar. Bitte aktuelle Plan-Liste auf hivegrid.de wählen."* |
|
||||
| Setup-Fee-Zahlung fehlgeschlagen, Subscription aktiv | Plattform-Admin-Alert + Tenant-Admin-Klartext: *„Setup-Gebühr-Zahlung gescheitert. Bitte Zahlungsmethode prüfen — sonst wird Konto in 14 Tagen gesperrt."* |
|
||||
| Webhook-Signature ungültig | 401-Response, Plattform-Admin-Alert (möglicher Angriff) |
|
||||
@@ -718,7 +718,7 @@ Bewusst NICHT in Phase 1 (LP-8 + Apple-Compliance):
|
||||
|
||||
- **In-App-Subscription-Self-Service** (Plan-Wechsel direkt in der App ohne Marketing-Site-Umweg) — wartet auf App-Store-Compliance-Klärung
|
||||
- **Add-On-Käufe** (zusätzliche Trigger-Volumen-Pakete, AI-Credits-Top-Ups) — Marketing-Site oder Phase-2-In-App
|
||||
- **Multi-Tenant-Billing** für Konzerne (mehrere Tenants in einer Stripe-Subscription gebündelt)
|
||||
- **Multi-Tenant-Billing** für Konzerne (mehrere Tenants in einer Legacy-Provider-Subscription gebündelt)
|
||||
- **Custom-Pricing-Tier** per Plattform-Admin (individuelle Preisverhandlung Enterprise)
|
||||
- **Promo-Code-System** (Discount-Codes im Checkout)
|
||||
- **Annual-Billing-Toggle** mit konfigurierbarem Jahres-Rabatt
|
||||
@@ -732,23 +732,23 @@ Bewusst NICHT in Phase 1 (LP-8 + Apple-Compliance):
|
||||
## Architektur-Vorschriften (Querschnitt)
|
||||
|
||||
- **AV #6 — Audit-Trail-Default:** Jede Subscription-Status-Änderung, jeder Plan-Wechsel, jede Credit-Veränderung geloggt mit Diff
|
||||
- **AV #8 — Idempotenz pro Webhook-Verarbeitung:** Stripe-Events nicht doppelt verarbeiten (über `stripe_event_id`)
|
||||
- **AV #8 — Idempotenz pro Webhook-Verarbeitung:** Legacy-Provider-Events nicht doppelt verarbeiten (über `legacyProvider_event_id`)
|
||||
- **AV #5 — Permissions-aware-Default:** Listen / Verbrauchs-Sicht filtert nach `billing.read`/`tenant.admin`
|
||||
- **LP-8 — Apple-Compliance:** keinerlei Pricing-/Upgrade-UI in App; alle externen Links öffnen in neuem Browser-Fenster mit `noopener noreferrer`
|
||||
- **LP-10 + AV #1 — Klartext-Diagnostik:** alle Subscription-/Billing-Fehler menschenlesbar mit Lösungs-Hinweis
|
||||
- **LP-13 — EU-Stack:** Stripe-Vertragspartner ist Stripe Payments Europe DAC (Ireland), DPA elektronisch unterzeichnet
|
||||
- **LP-13 — EU-Stack:** Legacy-Provider-Vertragspartner ist Legacy-Provider Payments Europe DAC (Ireland), DPA elektronisch unterzeichnet
|
||||
- **AV #11 — Read-Only-Middleware** strukturell für alle Schreib-Pfade (Routes, API, Worker)
|
||||
|
||||
---
|
||||
|
||||
## Detail-Spec-Status: DRAFT
|
||||
|
||||
Erste vollständige Detail-Spec für Modul 28. **Vor Bau:** Verifizierung mit Noah + Pricing-Modell-Konkretisierung (separate Runde). Konkrete Stripe-Price-IDs, Webhook-Endpoint-URLs, EU-Entity-Vertragsdetails kommen mit Implementierung.
|
||||
Erste vollständige Detail-Spec für Modul 28. **Vor Bau:** Verifizierung mit Noah + Pricing-Modell-Konkretisierung (separate Runde). Konkrete Legacy-Provider-Price-IDs, Webhook-Endpoint-URLs, EU-Entity-Vertragsdetails kommen mit Implementierung.
|
||||
|
||||
**Offene Detail-Punkte (nicht-blockierend):**
|
||||
- Konkretes Pricing-Modell (Cloud/Cloud+/Enterprise-Preise, Trigger-Volumen-Schwellen, AI-Token-Mengen, Setup-Fee-Beträge, Frozen-Mode-Preis, Annual-Discount-%) — geparkt für eigene Runde
|
||||
- Konkretes Branchen-Plan-Mapping (alle Branchen können alle Pläne, oder Branchen-spezifische Trial-Tage?)
|
||||
- Genaue Stripe-Smart-Retries-Konfiguration vs. eigene Schedule
|
||||
- Genaue Legacy-Provider-Smart-Retries-Konfiguration vs. eigene Schedule
|
||||
- Edge-Case bei Plan-Downgrade mid-period (Pro-rata vs. Period-End)
|
||||
- Migration für Bestandskunden (Geerkens beim Go-Live) — Pricing-Modell-Festlegung erforderlich
|
||||
- Konkrete Permission-IDs zusammen mit M27-Permission-Konsolidierung
|
||||
|
||||
@@ -144,7 +144,7 @@ Tracking der Mitarbeiter-Einladungen (Verbindung zu M27 D.1 `TenantUserInvitatio
|
||||
|
||||
### Aufruf-Pfad
|
||||
|
||||
1. User schließt Self-Service-Signup ab (M27 A.1) → Tenant + Stripe-Subscription angelegt (M28)
|
||||
1. User schließt Self-Service-Signup ab (M27 A.1) → Tenant + Legacy-Provider-Subscription angelegt (M28)
|
||||
2. Bei erstem Login auf Tenant-Slug-Route: Auto-Redirect nach `/onboarding/setup/`
|
||||
3. Wizard läuft → bei Abschluss Redirect nach `/{tenant}/`
|
||||
|
||||
|
||||
@@ -11,7 +11,7 @@ spec_style: requirements-pur
|
||||
|
||||
# Modul 33a — Apps-Engine / Adapter-Layer
|
||||
|
||||
> **Detail-Spec gemäß LP-9.** Foundation für alle externen Integrationen (LP-11). Wenn das sauber ist, hängen sich KWP, AirCall, Gmail, Stripe, Calendar konsistent dran.
|
||||
> **Detail-Spec gemäß LP-9.** Foundation für alle externen Integrationen (LP-11). Wenn das sauber ist, hängen sich KWP, AirCall, Gmail, Legacy-Provider, Calendar konsistent dran.
|
||||
|
||||
## Themenblöcke
|
||||
|
||||
@@ -152,7 +152,7 @@ User sieht nur Apps mit:
|
||||
### Connect-Flow (pro Connection-Type unterschiedlich, aber UI einheitlich)
|
||||
|
||||
- **OAuth2** (Gmail, Microsoft, Google Calendar): Redirect-Flow → Auto-Token-Speicherung → Health-Check
|
||||
- **API-Key** (PandaDoc, Stripe, Mistral): User trägt Key in Form ein → Validation → Speicherung
|
||||
- **API-Key** (PandaDoc, Legacy-Provider, Mistral): User trägt Key in Form ein → Validation → Speicherung
|
||||
- **Username/Password** (Legacy): User trägt Credentials → Validation
|
||||
- **Windows-Client** (KWP): User lädt `kwpsync.exe` aus Setup-Wizard, konfiguriert lokal Server-DB-Connection-String, kwpsync.exe registriert sich beim Cloud-API mit Token
|
||||
|
||||
|
||||
@@ -348,7 +348,7 @@ tenant-export-{tenantSlug}-{YYYY-MM-DD}.zip
|
||||
- Nach 30 Tagen Hard-Delete aller Tenant-Daten inkl. Files
|
||||
- Ab Hard-Delete: nicht wiederherstellbar
|
||||
3. **Step 2 — Datensicherung-Hinweis:** *„Vor Lösch-Bestätigung empfehlen wir: Tenant-Daten-Export starten. [Export jetzt starten] [Habe ich bereits] [Daten brauche ich nicht]"*
|
||||
4. **Step 3 — Stripe-Hinweis:** Klartext über Restbetrag, Pro-rata-Erstattung, letzte Rechnung
|
||||
4. **Step 3 — Legacy-Provider-Hinweis:** Klartext über Restbetrag, Pro-rata-Erstattung, letzte Rechnung
|
||||
5. **Step 4 — Identitäts-Bestätigung:** Pwd + 2FA falls aktiv
|
||||
6. **Step 5 — Final-Klick** mit Tenant-Slug-Eingabe als Confirm-Phrase (User muss `geerkens-gmbh` eintippen, nicht nur einen Knopf drücken)
|
||||
7. `TenantDeletionRequest` mit `reason=voluntary`, `grace_period_ends_at = now + 30 Tage` wird angelegt
|
||||
@@ -360,7 +360,7 @@ tenant-export-{tenantSlug}-{YYYY-MM-DD}.zip
|
||||
|
||||
- Jeder Tenant-Admin kann mit einem Klick rückgängig machen → Status zurück auf `active` (oder vorherigen Status)
|
||||
- Audit-Eintrag: wer hat gekündigt, wer hat zurückgezogen
|
||||
- Stripe-Subscription wird bei Cancel reaktiviert (siehe Modul 28)
|
||||
- Legacy-Provider-Subscription wird bei Cancel reaktiviert (siehe Modul 28)
|
||||
|
||||
### Hard-Delete-Cron (nach 30 Tagen)
|
||||
|
||||
@@ -385,13 +385,13 @@ tenant-export-{tenantSlug}-{YYYY-MM-DD}.zip
|
||||
### Was bleibt nach Hard-Delete
|
||||
|
||||
- Audit-Metadata in `AdminAuditLog` (Modul 37): Tenant-ID, Slug, Lösch-Datum, Reason, Akteur
|
||||
- Stripe-Records (von Stripe-Seite, gemäß deren Aufbewahrungs-Pflichten)
|
||||
- Legacy-Provider-Records (von Legacy-Provider-Seite, gemäß deren Aufbewahrungs-Pflichten)
|
||||
- Email-Logs vom Email-Provider (gemäß deren Retention)
|
||||
- **Keine** PII, **keine** User-Inhalte
|
||||
|
||||
### Reasons außer `voluntary`
|
||||
|
||||
- `non_payment` — automatisch nach 30 Tagen `past_due` (Trigger: Stripe-Webhook-Logik in Modul 28); `TenantDeletionRequest` wird automatisch angelegt
|
||||
- `non_payment` — automatisch nach 30 Tagen `past_due` (Trigger: Legacy-Provider-Webhook-Logik in Modul 28); `TenantDeletionRequest` wird automatisch angelegt
|
||||
- `suspended_violation` — Plattform-Admin kündigt manuell wegen AGB-Verstoß; ggf. verkürzte Grace-Period
|
||||
- `admin_initiated` — Plattform-Admin kündigt im Auftrag des Tenant-Admins (z.B. Email-Anfrage); Tenant-Admin bekommt Bestätigungs-Email mit Cancel-Link
|
||||
|
||||
@@ -399,7 +399,7 @@ tenant-export-{tenantSlug}-{YYYY-MM-DD}.zip
|
||||
|
||||
- Hard-Delete-Cron schlägt mittendrin fehl: Status `failed`, Resume-fähig (idempotente Lösch-Aktionen)
|
||||
- Tenant-Daten-Export läuft noch beim Hard-Delete: Export-Job wird abgebrochen, ZIP gelöscht, Klartext im Audit
|
||||
- Tenant-Admin kündigt während aktiver Subscription: Stripe-Cancel wird beim Hard-Delete-Cron getriggert (nicht beim Anlegen der `TenantDeletionRequest` — User soll noch zurückziehen können ohne Stripe-Doppel-Abbuchung)
|
||||
- Tenant-Admin kündigt während aktiver Subscription: Legacy-Provider-Cancel wird beim Hard-Delete-Cron getriggert (nicht beim Anlegen der `TenantDeletionRequest` — User soll noch zurückziehen können ohne Legacy-Provider-Doppel-Abbuchung)
|
||||
- Last-Tenant-Admin kündigt Tenant: erlaubt (anders als bei User-Löschung — Tenant-Kündigung ist explizit das Ende)
|
||||
|
||||
---
|
||||
|
||||
+11
-11
@@ -385,7 +385,7 @@ admin.hivegrid.de/settings/security → 2FA, Sessions
|
||||
- Kontakt-Info (Email, Telefon, Adresse aus Signup)
|
||||
- Tenant-Admins-Liste (welche User haben `tenant.admin`)
|
||||
- Activity-Indikatoren: letzte 7/30 Tage, MAU, Speicher-Nutzung, KWP-Sync-Status
|
||||
- Subscription-Detail: Plan, Seats, MRR, nächste Rechnung, Stripe-Customer-ID (mit Link zu Stripe-Dashboard)
|
||||
- Subscription-Detail: Plan, Seats, MRR, nächste Rechnung, Legacy-Provider-Customer-ID (mit Link zu Legacy-Provider-Dashboard)
|
||||
- Trial-Info (falls Trial): Restdauer, manuelle Verlängerung möglich
|
||||
- Feature-Flag-Auswertungen für diesen Tenant (siehe Modul 32)
|
||||
- Subprozessoren-Status (welche AVV-Version akzeptiert)
|
||||
@@ -498,7 +498,7 @@ admin.hivegrid.de/settings/security → 2FA, Sessions
|
||||
### Liste (`admin.hivegrid.de/subscriptions`)
|
||||
|
||||
**Zu zeigende Daten pro Eintrag:**
|
||||
- Tenant-Name, Plan, MRR, Status (active, trialing, past_due, canceled), Renewal-Datum, Stripe-Sync-Status
|
||||
- Tenant-Name, Plan, MRR, Status (active, trialing, past_due, canceled), Renewal-Datum, Legacy-Provider-Sync-Status
|
||||
|
||||
**Benötigte UI-Elemente:**
|
||||
- Tabellarische Liste mit Filter (Plan, Status, MRR-Range)
|
||||
@@ -508,14 +508,14 @@ admin.hivegrid.de/settings/security → 2FA, Sessions
|
||||
### Detail (`admin.hivegrid.de/subscriptions/:id`)
|
||||
|
||||
**Zu zeigende Daten:**
|
||||
- Stripe-Customer-ID, Subscription-ID (mit Link zu Stripe-Dashboard)
|
||||
- Legacy-Provider-Customer-ID, Subscription-ID (mit Link zu Legacy-Provider-Dashboard)
|
||||
- Aktueller Plan, Seats (Office + Field), MRR
|
||||
- Trial-Status, Trial-Ende
|
||||
- Rechnungs-History
|
||||
- Override-Vermerke (manueller Plan / Sonderpreis)
|
||||
|
||||
**Operationen:**
|
||||
- **Stripe-Sync forcieren** (zieht aktuellen Stripe-Stand und gleicht ab)
|
||||
- **Legacy-Provider-Sync forcieren** (zieht aktuellen Legacy-Provider-Stand und gleicht ab)
|
||||
- **Manuelle Override** für Enterprise-Kunden:
|
||||
- Plan überschreiben
|
||||
- Seats-Limit überschreiben
|
||||
@@ -525,14 +525,14 @@ admin.hivegrid.de/settings/security → 2FA, Sessions
|
||||
- Klartext-Hinweis im Tenant-Detail: *„Manuelle Konditionen aktiv — siehe Override-Vermerk"*
|
||||
- **Trial verlängern** (analog Block G)
|
||||
- **Manuelle Rechnung anstoßen** (für Setup-Fees, Custom-Onboarding)
|
||||
- **Abo kündigen** (Stripe-Cancel + Tenant-Lösch-Workflow-Trigger)
|
||||
- **Refund anstoßen** (mit Reason-Text + Stripe-Sync)
|
||||
- **Abo kündigen** (Legacy-Provider-Cancel + Tenant-Lösch-Workflow-Trigger)
|
||||
- **Refund anstoßen** (mit Reason-Text + Legacy-Provider-Sync)
|
||||
|
||||
**Permissions:** Lese `admin.subscriptions.read`, Schreib-Aktionen `admin.subscriptions.admin`.
|
||||
|
||||
### Stripe-Webhook-Sync
|
||||
### Legacy-Provider-Webhook-Sync
|
||||
|
||||
- Events von Stripe (Subscription-Update, Payment-Failed, Invoice-Paid) werden automatisch in Tenant-Daten gespiegelt (Modul 28)
|
||||
- Events von Legacy-Provider (Subscription-Update, Payment-Failed, Invoice-Paid) werden automatisch in Tenant-Daten gespiegelt (Modul 28)
|
||||
- Manuelle Re-Sync-Funktion in diesem Bereich, falls Webhook ausgefallen war
|
||||
|
||||
---
|
||||
@@ -814,12 +814,12 @@ admin.hivegrid.de/settings/security → 2FA, Sessions
|
||||
|
||||
- Tenant-Status-Wechsel ohne Reason-Text: Block mit Klartext *„Bitte Reason-Text angeben — wird im Audit-Log dauerhaft gespeichert."*
|
||||
- Impersonate ohne Reason: Block analog
|
||||
- Subscription-Override ohne Bestätigung: Modal *„Diese Konditionen weichen vom Standard-Plan ab. Stripe wird nicht angepasst — manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]"*
|
||||
- Subscription-Override ohne Bestätigung: Modal *„Diese Konditionen weichen vom Standard-Plan ab. Legacy-Provider wird nicht angepasst — manuelle Rechnungs-Erstellung erforderlich. [Verstanden, fortfahren]"*
|
||||
- AdminUser-Anlegen mit existierender Email: Klartext *„Diese Email gehört bereits zu einem AdminUser ‚X' — bitte direkt diesen verwalten."*
|
||||
- Self-Permission-Schutz: *„Du bist der einzige Super-Admin. Permission-Entzug nicht möglich. Bitte zuerst weiteren Super-Admin anlegen."*
|
||||
- AdminUser-Lockout durch zu viele Fehlversuche: Klartext *„Account gesperrt nach 10 Fehlversuchen. Bitte anderen Super-Admin um Reaktivierung bitten."*
|
||||
- Tenant-Lösch-Anstoß im Auftrag: *„Du startest die Kündigung für Tenant ‚X' im Auftrag. Bestätigung-Email geht an alle Tenant-Admins mit Cancel-Link."*
|
||||
- Stripe-Sync-Konflikt: *„Stripe-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Stripe-Wert] vs. [HiveGrid-Wert]."*
|
||||
- Legacy-Provider-Sync-Konflikt: *„Legacy-Provider-Stand und HiveGrid-Stand weichen ab. Bitte manuell prüfen: [Legacy-Provider-Wert] vs. [HiveGrid-Wert]."*
|
||||
- Worker-Queue-Pause: *„Queue ‚X' pausiert. Neue Jobs werden eingereiht aber nicht verarbeitet. Vergiss nicht zu reaktivieren!"*
|
||||
- Cross-Tenant-Email-Bulk: *„Diese Email geht an X Tenant-Admins. Bitte nochmal Subject + Body prüfen. [Senden]"*
|
||||
- Lead-Promote-to-Tenant: *„Tenant wird angelegt mit Initial-Admin [Email]. Bitte Subscription + Trial-Dauer wählen vor Anlage."*
|
||||
@@ -862,7 +862,7 @@ Erste vollständige Detail-Spec für Modul 37. Bewusst breit, da Modul ein Hub f
|
||||
- Konkrete AdminPermission-IDs final mit Modulen 32 und 35 abstimmen
|
||||
- Impersonate-Mechanik technisch ausarbeiten (Cookie-Scope, Banner-Anzeige im App-Workspace)
|
||||
- Inbound-Email-Parser für Support-Tickets (Provider-Wahl)
|
||||
- Stripe-Webhook-Sync-Detail in Modul 28
|
||||
- Legacy-Provider-Webhook-Sync-Detail in Modul 28
|
||||
- Worker-Queue-Steuerungs-API (BullMQ-spezifisch)
|
||||
- AVV-PDF-Templating (Template-Engine-Wahl)
|
||||
- Subframe-UI-Designs separat
|
||||
|
||||
@@ -101,7 +101,7 @@ Index wird im Build geprüft (jede Kategorie-Referenz aus Frontmatter muss exist
|
||||
**Mitarbeiter:** HR-Hub-Übersicht, Krankmeldung/Urlaubsantrag stellen
|
||||
**Integrationen:** KWP-Setup, Google-Kalender verbinden, AirCall-Setup, Email-Integration (Gmail/Outlook)
|
||||
**Mobile:** Mobile-App-Setup, Offline-Modus auf Baustelle
|
||||
**Abrechnung:** Stripe-Setup, Plan wechseln, Rechnungen einsehen
|
||||
**Abrechnung:** Legacy-Provider-Setup, Plan wechseln, Rechnungen einsehen
|
||||
**Tutorials:** Form-Builder-Tutorial, Automation-Builder-Tutorial
|
||||
|
||||
(Konkrete Liste wird mit Plattform-Team beim Bau finalisiert.)
|
||||
|
||||
Reference in new issue
Block a user