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
@@ -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
|
||||
|
||||
---
|
||||
|
||||
|
||||
+4
-3
@@ -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
-4
@@ -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",
|
||||
|
||||
+1
-1
@@ -22,7 +22,7 @@
|
||||
"KWP",
|
||||
"Gmail",
|
||||
"AirCall",
|
||||
"Stripe",
|
||||
"Legacy-Provider",
|
||||
"PandaDoc",
|
||||
"Marketplace"
|
||||
],
|
||||
|
||||
+1
-1
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user