Update hivegrid-cloud reference to latest main

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

No files matched your search

@@ -96,7 +96,7 @@ Note: C-15 spans both api-contract and protocol categories.
Count: 7 topics
Topics: Projekt-Überblick und Ziel, Phase-0-Pflichten, Delivery-Sequenzierung, SHK-Branchen-Kontext, Boilerplate-Reuse-Struktur, KWP-Recut-Entscheidung, Spec-Status
Topics: Projekt-Überblick und Ziel, Phase-0-Pflichten, Delivery-Sequenzierung, SHK-Branchen-Kontext, HiveGrid-Workspace-Struktur, KWP-Recut-Entscheidung, Spec-Status
---
@@ -18,7 +18,7 @@
"WebSocket",
"SSE",
"KWP integration",
"Stripe",
"Legacy-Provider",
"Automation Editor",
"Mobile Offline",
"Customer Portal",
@@ -29,8 +29,9 @@
],
"cross_refs": [
"AGENTS.md",
"docs/boilerplate-mapping/_SUMMARY.md",
"docs/boilerplate-mapping/M19-kwp-integration.md",
".planning/ENTITY-MODEL.md",
".planning/PHASE-SOURCES.md",
"docs/milestones/M19-KWP-API-RECUT.md",
"docs/INTEGRATION-CONTRACTS.md",
"PLAN.md"
],
@@ -4,7 +4,7 @@
"confidence": "high",
"manifest_override": true,
"title": "Modul 28 — Subscriptions / Billing",
"summary": "Technical specification for HiveGrid subscription engine, Stripe billing integration, seat model, trial/dunning lifecycle, AI credits, and service metering.",
"summary": "Technical specification for HiveGrid subscription engine, Legacy-Provider billing integration, seat model, trial/dunning lifecycle, AI credits, and service metering.",
"scope": [
"TenantSubscription",
"SubscriptionProduct",
@@ -14,9 +14,9 @@
"TenantSubscriptionUsageRecord",
"CheckoutSessionStatus",
"Credit",
"Stripe",
"Stripe-Checkout",
"Stripe-Webhooks",
"Legacy-Provider",
"Payment-Checkout",
"Legacy-Provider-Webhooks",
"Seat-Modell",
"Trial-Phase",
"Dunning",
@@ -22,7 +22,7 @@
"KWP",
"Gmail",
"AirCall",
"Stripe",
"Legacy-Provider",
"PandaDoc",
"Marketplace"
],
@@ -14,7 +14,7 @@
"ZIP export",
"Privacy-Hub routes",
"Capacitor app privacy manifest",
"Stripe subscription",
"Legacy-Provider subscription",
"pgvector embeddings",
"Redis cache",
"Scaleway storage"
@@ -63,7 +63,7 @@ source: docs/ARCHITECTURE-DECISIONS.md (AD-4)
type: nfr
source: docs/ARCHITECTURE-DECISIONS.md (AD-5), _bmad-output/specs/M24-globale-suche.md
- Meilisearch (self-hosted): Keyword-Suche; BP-Paket @toolctrl/search weitgehend 1:1 übernommen
- Meilisearch (self-hosted): Keyword-Suche; BP-Paket @hivegrid/search weitgehend 1:1 übernommen
- pgvector: Semantische Suche; Embedding-Dimension 1024 (Scaleway EU-Endpoint)
- Fusion: RRF (Reciprocal Rank Fusion) kombiniert beide Ergebnislisten
- SearchIndexEntry muss tenant_id enthalten; Abfragen stets permission-aware (RLS + Permission-Filter)
@@ -96,16 +96,16 @@ source: docs/ARCHITECTURE-DECISIONS.md (AD-9)
---
## C-08 — Paket-Naming: @toolctrl/* bleibt, @hivegrid/* nur für neue Querschnittsdienste
## C-08 — Paket-Naming: @hivegrid/* ohne Alt-Aliase
type: protocol
source: docs/ARCHITECTURE-DECISIONS.md (AD-10), docs/INTEGRATION-CONTRACTS.md
- @toolctrl/*: Boilerplate-Pakete, unveränderter Name (upstream-mergebar)
- @hivegrid/*: einheitlicher Scope fuer alle Workspace-Pakete
- packages/ui-app (nicht ui-hivegrid): HiveGrid-UI-Shell
- apps/web/app/application/sidebar/: Sidebar-Konfiguration (nicht sidebar.config.ts)
- packages/search/: Such-Index / indexedEntities (nicht packages/db/src/search/indexed-entities.ts)
- @hivegrid/*: nur neue, genuin HiveGrid-eigene Pakete (z.B. @hivegrid/activity, @hivegrid/audit, @hivegrid/notifications)
- keine Alt-Scope-Package-Aliase, kein altes CLI-Binary, keine parallelen technischen Produkt-Contracts
---
@@ -134,7 +134,8 @@ Verbindliche URL-Schemata (Abweichungen erfordern Change-Request):
- Public-Forms: app.hivegrid.de/f/{tenant}/{slug}
- Public-Booking: app.hivegrid.de/b/{tenant}/{slug}
- Public-Help: app.hivegrid.de/help/{lang}/{kategorie}/{slug}
- Public-API: app.hivegrid.de/api/v1/{resource}
- Public-API: api.hivegrid.de/v1/{resource}
- MCP-Server: mcp.hivegrid.de
---
@@ -11,7 +11,7 @@ source: docs/ARCHITECTURE-DECISIONS.md
HiveGrid 2.0 ist eine SaaS-Plattform für SHK-Handwerksbetriebe (Sanitär, Heizung, Klima). Erstkunde: Geerkens GmbH. Das Produkt löst ab: HubSpot (CRM + Sales-Pipeline), Quiply (Team-Chat), Zapier/n8n (Automation), sowie mehrere Excel-Prozesse.
Die Codebase ist ein Git-Downstream der ToolCTRL-Boilerplate (upstream-Remote bleibt erhalten). Boilerplate deckt ~35–45 % der Anforderungen ab (Fundament high, Fachdomäne greenfield).
Die Codebase wird als bespoke HiveGrid-Anwendung weitergeführt. Historisches Fundament wird genutzt, produktfremde Altlasten werden entfernt.
USP-Säulen (Day-1-Launch): Automation-Engine (visuell, KI-gestützt) + KI-Layer (EU-only) + KWP-Integration (Kern-ERP Geerkens).
@@ -22,8 +22,8 @@ USP-Säulen (Day-1-Launch): Automation-Engine (visuell, KI-gestützt) + KI-Layer
source: docs/ARCHITECTURE-DECISIONS.md
Die folgenden Voraussetzungen sind vor dem ersten Fachmodul-Bau abzuarbeiten:
1. Boilerplate einziehen (Repo ist aktuell Docs-only, keine echte Codebase)
2. Naming-Drift in Docs beheben (AD-10)
1. Codebase lauffähig halten
2. Naming-Drift in Code und Docs beheben (AD-10)
3. EU-Sterilisation: GitHub/Google-OAuth-Reste entfernen
4. M00 aktivieren + 4 Querschnitts-Neubauten (logActivity, Search-Registry, Subframe-Adapter, Mass-Action-Schutz)
5. Fehlende Dependencies eintragen (PLAN.md teils falsch)
@@ -59,18 +59,18 @@ SHK-Seeds (beim Tenant-Anlegen): 6 Standard-Rollen, 2 Sales-Pipelines, Custom-Fe
---
## Topic: Boilerplate-Reuse-Struktur
## Topic: HiveGrid-Workspace-Struktur
source: docs/ARCHITECTURE-DECISIONS.md (AD-10), docs/INTEGRATION-CONTRACTS.md
Boilerplate-Pakete (unveränderter Name, upstream-mergebar):
Workspace-Pakete im `@hivegrid/*`-Scope:
- packages/ui-app (UI-Shell)
- packages/ui-subframe (Subframe-Adapter)
- packages/ui-mock (Mock-UI für Hot-Swap-Tests)
- @toolctrl/search (Meilisearch-Paket)
- @toolctrl/foundation (Basis-Utilities)
- @hivegrid/search (Meilisearch-Paket)
- @hivegrid/foundation (Basis-Utilities)
Neue HiveGrid-Querschnittsdienste (zu bauen, @hivegrid/*-Namespace):
HiveGrid-Querschnittsdienste:
- @hivegrid/activity (logActivity-Service + zentrale Activity-Tabelle)
- @hivegrid/audit (auditEvent-Service)
- @hivegrid/notifications (notify-Service)
@@ -67,7 +67,7 @@ status: Accepted (locked)
scope: Globale Suche, Search-Infrastruktur
source: docs/ARCHITECTURE-DECISIONS.md
Entscheidung: Keyword-Suche über selbst gehostetes Meilisearch (BP-`@toolctrl/search` weitgehend 1:1), semantische Suche über pgvector + EU-Embeddings (Scaleway 1024-dim, BP 1:1), kombiniert via RRF-Fusion. Embedding-Pipeline + Outbox + Indexer-Worker aus der BP übernehmen.
Entscheidung: Keyword-Suche über selbst gehostetes Meilisearch (BP-`@hivegrid/search` weitgehend 1:1), semantische Suche über pgvector + EU-Embeddings (Scaleway 1024-dim, BP 1:1), kombiniert via RRF-Fusion. Embedding-Pipeline + Outbox + Indexer-Worker aus der BP übernehmen.
Hinweis: Weicht bewusst von M056 "Postgres-FTS, kein Extra-Service" ab → Change-Request gegen M056 nötig.
Betrifft: M24 / M056–M058
@@ -120,16 +120,18 @@ Betrifft: M13 (bidirektional WebSocket); SSE-Pfad: M03, M22
---
## AD-10 — Naming-Konvention: `@toolctrl/*` behalten, Docs anpassen
## AD-10 — Naming-Konvention: HiveGrid-Scope ohne Alt-Aliase
status: Accepted (locked)
scope: Paket-Naming, Mono-Repo-Struktur, alle Module
source: docs/ARCHITECTURE-DECISIONS.md
Entscheidung: Boilerplate-Pakete behalten ihre Namen (`@toolctrl/*`, `packages/ui-app`) — kein flächiger Rename zu `@hivegrid/*`/`ui-hivegrid`.
- `@toolctrl/*` + `ui-app`/`ui-subframe`/`ui-mock` = geteilte Boilerplate-Pakete (mergebar mit upstream)
- `@hivegrid/*` = nur für genuin neue HiveGrid-Pakete (z.B. Activity-Paket, Domänen-Pakete)
- Docs: wo "ui-hivegrid"/"@hivegrid/foundation"/"sidebar.config.ts" steht, ist `ui-app`/`@toolctrl/foundation`/`apps/web/app/application/sidebar/` gemeint
Entscheidung: Alle Workspace-Pakete und technischen Produkt-Contracts nutzen HiveGrid-Namen:
`@hivegrid/*`, `hivegrid-cli`, `HIVEGRID_*`, `hivegrid_*`-Cookies, `x-hivegrid-*`-Header und
`hivegrid.*`-Queue-Namen. Es gibt keine Alt-Aliase.
- `packages/ui-app`, `packages/ui-subframe`, `packages/ui-mock` behalten ihre realen Pfade
- Estate-Slugs bleiben externe Infrastruktur (`git.tool-ctrl.de`, `toolctrl-labs`, `toolctrl-ci`, Plane-Workspace `toolctrl`)
- Docs: wo "ui-hivegrid", Alt-Scopes oder alte Sidebar-Pfade stehen, ist das Doku-Drift
Betrifft: Querschnitt (alle Module), Phase 0
@@ -178,10 +180,10 @@ Entscheidung: Geerkens startet weitgehend leer; KWP-Sync bringt Auftrags-/Stammd
## AD-15 — Pricing/Billing: Engine bauen, Preise geparkt
status: Accepted (locked)
scope: Stripe, Billing-Engine, Pricing
scope: Legacy-Provider, Billing-Engine, Pricing
source: docs/ARCHITECTURE-DECISIONS.md
Entscheidung: Stripe-Integration + Seat-/Plan-Engine + Verbrauchs-Metering werden technisch gebaut, die konkreten Preis-Stufen bleiben geparkt. Geerkens läuft auf manueller Sonderkondition/Trial. Self-Service-Checkout-Preise = eigene spätere Pricing-Runde.
Entscheidung: Legacy-Provider-Integration + Seat-/Plan-Engine + Verbrauchs-Metering werden technisch gebaut, die konkreten Preis-Stufen bleiben geparkt. Geerkens läuft auf manueller Sonderkondition/Trial. Self-Service-Checkout-Preise = eigene spätere Pricing-Runde.
---
@@ -231,8 +233,8 @@ Bewusst akzeptiert: längste Zeit bis zum ersten echten Nutzer-Feedback, höchst
source: docs/ARCHITECTURE-DECISIONS.md
1. Boilerplate als Code-Basis einziehen (Repo ist heute Docs-only)
2. Naming-Drift beheben: `@toolctrl/*` → Docs anpassen, Sidebar-Konvention korrigieren
1. Codebase lauffähig halten
2. Naming-Drift beheben: HiveGrid-Contracts in Code und Docs, Sidebar-Konvention korrigieren
3. EU-Sterilisation: GitHub/Google-OAuth-Reste + `User.githubId/googleId` entfernen
4. M00 aktivieren + 4 echte Neubauten: `logActivity()`/Activity-Stream, Search-Registry, Subframe-Adapter-Code, Mass-Action-Schutz
5. Fehlende Dependencies ergänzen: `signature_pad`, `browser-image-compression`, `react-grid-layout`, `@dnd-kit`, `libphonenumber`, `ics`/`ical-generator`, `btree_gist`/`EXCLUDE`-Constraint u.a.
@@ -914,8 +914,8 @@ source: _bmad-output/specs/M28-subscriptions-billing.md
TenantSubscription, SubscriptionProduct, SubscriptionPrice, SubscriptionFeature, TenantSubscriptionUsageRecord, Credit.
Acceptance criteria:
- TenantSubscription: tenant_id, stripe_customer_id, stripe_subscription_id, product_id, status (active|trialing|frozen|cancelled), trial_ends_at, current_period_start/end, seat_count
- Stripe-Webhook-Verarbeitung: checkout.session.completed, invoice.payment_succeeded, invoice.payment_failed, customer.subscription.deleted
- TenantSubscription: tenant_id, legacyProvider_customer_id, legacyProvider_subscription_id, product_id, status (active|trialing|frozen|cancelled), trial_ends_at, current_period_start/end, seat_count
- Legacy-Provider-Webhook-Verarbeitung: checkout.session.completed, invoice.payment_succeeded, invoice.payment_failed, customer.subscription.deleted
- Frozen-Modus: Zugriff eingeschränkt (Read-Only-Middleware), Warnungen in App
- AI-Credits: Credit-Konto pro Tenant, verknüpft mit Subscription-Plan
@@ -925,7 +925,7 @@ Trial-Phase, Dunning-Workflow, Setup-Fee.
Acceptance criteria:
- Trial: 14 Tage Default, keine Kreditkarte erforderlich
- Dunning: bei fehlgeschlagener Zahlung → Email-Sequenz (Tag 1, 3, 7), dann Frozen-Modus
- Setup-Fee: einmalige Gebühr bei Enterprise-Buchung (Stripe-Checkout-Session)
- Setup-Fee: einmalige Gebühr bei Enterprise-Buchung (Payment-Checkout-Session)
- Preise selbst geparkt (AD-15); Engine muss aber bereit sein
---
@@ -1026,7 +1026,7 @@ source: _bmad-output/specs/M33a-apps-engine.md
DataConnection, AppSyncRun, AppSyncRunLog, AppSyncItem, Adapter-Registry.
Acceptance criteria:
- DataConnection: tenant_id, app_key (gmail|outlook|aircall|kwp|stripe|pandadoc|...), status (connected|disconnected|error), credentials_encrypted (AD-8), config (JSONB), last_synced_at
- DataConnection: tenant_id, app_key (gmail|outlook|aircall|kwp|legacyProvider|pandadoc|...), status (connected|disconnected|error), credentials_encrypted (AD-8), config (JSONB), last_synced_at
- AppSyncRun: connection_id, status (running|completed|failed), started_at, finished_at, items_processed
- AppSyncItem: run_id, external_id, action (create|update|delete), payload_hash, status
- Adapter-Registry: app_key → Adapter-Klasse (type-safe Registry)
@@ -1036,7 +1036,7 @@ App-Connect-Flow, Sync-Mechanik, Connection-Health-Monitoring.
Acceptance criteria:
- OAuth2-Connect-Flow für Gmail, Outlook, AirCall, PandaDoc
- API-Key-Connect für KWP (type=windows_client), Stripe
- API-Key-Connect für KWP (type=windows_client), Legacy-Provider
- Sync-Intervalle: konfiguierbar per App (Push-Webhook bevorzugt, Pull als Fallback)
- Connection-Health: Heartbeat-Check, Auto-Reconnect-Versuch, Tenant-Admin-Alert bei Fehler
- Settings-UI: /settings/integrationen/{app_key}; Einstiegspunkt für alle Integrations
@@ -1087,7 +1087,7 @@ Tenant-Account-Löschung mit Crypto-Shredding.
Acceptance criteria:
- TenantDeletionRequest: tenant_id, requested_by_user_id, reason, scheduled_for (14-Tage-Frist)
- Crypto-Shredding: Per-Tenant-DEK löschen → alle verschlüsselten Daten unlesbar (AD-8)
- Stripe-Subscription canceln vor Löschung
- Legacy-Provider-Subscription canceln vor Löschung
- pgvector-Embeddings, Redis-Cache, Scaleway-Storage-Objekte alle entfernen
- AvvAcceptance + Subprocessor-Liste in Privacy-Hub-Route anzeigbar
@@ -1211,7 +1211,8 @@ Acceptance criteria:
- Public-Forms: app.hivegrid.de/f/{tenant}/{slug}
- Public-Booking: app.hivegrid.de/b/{tenant}/{slug}
- Public-Help: app.hivegrid.de/help/{lang}/{kategorie}/{slug}
- Public-API: app.hivegrid.de/api/v1/{resource}
- Public-API: api.hivegrid.de/v1/{resource}
- MCP-Server: mcp.hivegrid.de
### REQ-integration-activity-wiring
Jede schreibende Aktion mit Entitäts-Bezug muss logActivity() aufrufen.