Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,117 @@
|
||||
# Plugin-Marketplace
|
||||
|
||||
**Status:** `backlog: Plugin-System (Phase 06) vollständig in Production + nachweisbarer Product-Market-Fit der Boilerplate + spürbarer Bedarf nach Drittentwickler-Ökosystem (mind. 3 externe Devs fragen aktiv nach Distributionskanal)`
|
||||
**Task-ID:** #24
|
||||
**Phase:** 11 (Backlog)
|
||||
**Estimated Effort:** 6-8 Wochen wenn aktiviert
|
||||
**Owner:** unassigned
|
||||
|
||||
## Problem
|
||||
|
||||
Sobald Phase 06 (WASM-Sandbox + Hooks-Lifecycle) live ist, können Tenants Plugins lokal installieren — aber es gibt keinen Weg, sie öffentlich anzubieten, zu entdecken, zu monetarisieren. Ohne Marketplace gibt es keinen Anreiz für Dritt-Entwickler, Plugins zu schreiben, und kein Discovery-Kanal für Tenants. Das Plugin-System bleibt damit nur eine interne Erweiterungs-Schicht statt ein Ökosystem-Hebel.
|
||||
|
||||
Aktivierung lohnt sich erst, wenn die Boilerplate genug Tenants hat, dass ein Plugin-Marketplace wirtschaftlich wird — sonst sind die ~6-8 Wochen Aufwand + die laufenden Review-/Moderation-Kosten verbrannt.
|
||||
|
||||
## Depends on
|
||||
|
||||
- `../06-plugin-system/wasm-sandbox.md` — Plugin-Runtime + Signaturprüfung müssen stehen
|
||||
- `../06-plugin-system/hooks-lifecycle.md` — Lifecycle-Events + Versions-Pinning müssen stehen
|
||||
- `../06-plugin-system/audit-docs.md` — Plugin-Manifest-Schema + Audit-Anforderungen müssen dokumentiert sein
|
||||
- `../05-business-features/feature-flags.md` — Marketplace-Listing-Flags pro Plugin (z.B. Beta-Phase)
|
||||
- `../05-business-features/ai-cost-phase-3.md` — Pricing-Backbone wird für Paid-Plugins wiederverwendet
|
||||
|
||||
## Blocks
|
||||
|
||||
- nichts (Backlog-Item, blockt keine aktive Roadmap)
|
||||
|
||||
## Approach
|
||||
|
||||
**Eigene Marketplace-Site als zweite App-Instanz (eigener Tenant auf eigener Plattform).** Begründung gegen Alternativen:
|
||||
|
||||
- *In-App-Marketplace innerhalb der Boilerplate*: würde die Tenant-Isolation verwässern (Publisher-Accounts wären cross-tenant) und Admin-Panel mit Marketplace-Verwaltung überfrachten. Verworfen.
|
||||
- *Externe SaaS-Marketplace (z.B. ähnlich Stripe Apps)*: zu viel Vendor-Lock-in für eine self-hosted-first Boilerplate. Verworfen.
|
||||
- *Eigener Tenant auf der gleichen Boilerplate-Plattform*: dogfooded das Tenant-System, nutzt Auth/Billing/Search/Audit-Infra die bereits da ist, klare Trennung zwischen Marketplace-Operator und Tenants.
|
||||
|
||||
**Publisher-Onboarding** generiert pro Publisher ein Ed25519-Keypair (Private-Key bleibt nur beim Publisher, Public-Key im Marketplace + jedem ausgelieferten Plugin-Manifest). Plugin-Signaturprüfung erfolgt offline beim Install ohne Marketplace-Roundtrip.
|
||||
|
||||
**Submission-Flow:** Publisher lädt signiertes `.wasm` + `manifest.json` hoch → Marketplace führt automatisierte Static-Analysis (Capability-Whitelist-Check, Manifest-Schema-Validation, AV-Scan via Phase-01-Layer-1+2) durch → manuelle Review-Pipeline (Marketplace-Operator) bevor Listing live geht. Spätere Iteration: mehr Auto-Approval bei verifizierten Publishern.
|
||||
|
||||
**Pricing:** Free, One-Time-Purchase, Subscription. Subscription-Plugins nutzen Stripe-Connect-Splits (Default 70/30 Publisher/Plattform, pro Plugin konfigurierbar). Tenant-Install pinnt Plugin-Version + öffnet Subscription bei Stripe-Connect-Account des Publishers.
|
||||
|
||||
**Update-Pipeline:** Publisher published neue Version → Marketplace-Backend prüft semver-Kompatibilität → Notifications an alle installierten Tenants (Email + In-App). Auto-Update nur für PATCH-Versions opt-in, MAJOR/MINOR immer manual-confirm pro Tenant.
|
||||
|
||||
## Implementation Steps
|
||||
|
||||
1. **Marketplace-Tenant-Setup** — eigene Subdomain `marketplace.<domain>`, Boilerplate-Stack mit eigener DB, Branding-Theme. Commit: `11-backlog/plugin-marketplace: bootstrap marketplace tenant`
|
||||
2. **Publisher-Onboarding + Ed25519-Keys** — Publisher-Account-Modell, Key-Generierung im Browser (WebCrypto), Public-Key-Storage. Commit: `11-backlog/plugin-marketplace: add publisher onboarding with ed25519`
|
||||
3. **Plugin-Submission-Flow** — Upload-UI, Static-Analysis-Pipeline (Capability-Check, Manifest-Validation, AV-Scan), Review-Queue für Marketplace-Operator. Commit: `11-backlog/plugin-marketplace: submission + review pipeline`
|
||||
4. **Public Listing-UI** — Such-Index (Meilisearch aus Phase 04), Ratings (1-5 Sterne + Review-Text), Screenshots, Pricing-Anzeige, Capability-Liste. Commit: `11-backlog/plugin-marketplace: public listing pages`
|
||||
5. **Stripe-Connect-Integration** — Connect-Account-Onboarding pro Publisher, application_fee_amount + transfer_data.destination für Splits, Subscription-Plugins als Stripe-Subscription mit Publisher als Destination-Account. Commit: `11-backlog/plugin-marketplace: stripe connect + revenue splits`
|
||||
6. **Tenant-Side Install-Flow** — von Marketplace via Deep-Link in Tenant-Admin → Signature-Verify → Subscription-Confirm → Plugin-Aktivierung mit Capability-Consent-Screen. Commit: `11-backlog/plugin-marketplace: tenant install flow with consent`
|
||||
7. **Update-Pipeline + Notifications** — Version-Diff-Anzeige, Notification via Email + Bell-Icon, opt-in Auto-Patch, Rollback-Button für Tenants. Commit: `11-backlog/plugin-marketplace: update pipeline + notifications`
|
||||
8. **Doku** — `docs/marketplace/publisher-guide.md`, `docs/marketplace/operator-runbook.md` (Review-Standards, Sperren von Plugins, Refund-Handling). Commit: `11-backlog/plugin-marketplace: documentation`
|
||||
|
||||
## Test Requirements
|
||||
|
||||
- **Unit-Tests:** Signaturprüfung (Ed25519 sign/verify mit bekannten Vektoren), Manifest-Schema-Validation, Revenue-Split-Berechnung, Semver-Diff-Logik
|
||||
- **Integration-Tests:** Submission-Flow End-to-End (Upload → Analysis → Approve → Listing), Install-Flow (Listing → Stripe-Checkout → Tenant-Aktivierung), Update-Notification-Fan-out
|
||||
- **E2E-Tests (Playwright):** Publisher-Onboarding, Submit-Plugin-Happy-Path, Tenant-Install + Capability-Consent, Subscription-Cancel mit Stripe-Webhook-Simulation
|
||||
- **Coverage-Target:** ≥75% für Marketplace-spezifische Pakete (`apps/marketplace/`, neue Module unter `app/modules/marketplace/`)
|
||||
- **Test-Files:** neben Source-Files (`*.test.ts`), E2E unter `apps/marketplace/playwright/`
|
||||
|
||||
**NICHT als completed markieren bevor alle Tests grün sind.**
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] Marketplace erreichbar unter eigener Subdomain mit eigener Tenant-Datenbank
|
||||
- [ ] Publisher kann sich registrieren, Ed25519-Keypair generieren und ein erstes Plugin submitten
|
||||
- [ ] Review-Queue im Marketplace-Admin-Panel funktional, mit Approve/Reject + Begründung
|
||||
- [ ] Stripe-Connect-Onboarding für Publisher abgeschlossen, KYC-Status sichtbar
|
||||
- [ ] Subscription-Plugin kann gekauft werden, Splits werden korrekt verbucht (70/30 default)
|
||||
- [ ] Tenant kann Plugin installieren, sieht Capability-Consent-Screen, Plugin läuft in WASM-Sandbox
|
||||
- [ ] Update-Notification erreicht Tenants binnen 5 Minuten nach Publish
|
||||
- [ ] Rollback eines aktualisierten Plugins pro Tenant funktioniert
|
||||
- [ ] Tests grün (lint, typecheck, unit, integration, e2e)
|
||||
- [ ] Docs `docs/marketplace/publisher-guide.md` + `docs/marketplace/operator-runbook.md` angelegt
|
||||
- [ ] Progress-Log + PROGRESS.md aktualisiert
|
||||
|
||||
## Rollback Strategy
|
||||
|
||||
- Marketplace ist eine eigene App-Instanz — Take-down ohne Auswirkung auf andere Tenants möglich
|
||||
- Feature-Flag `marketplace.public_listings_enabled` schaltet öffentliche Sichtbarkeit ab, ohne dass bereits installierte Plugins betroffen sind
|
||||
- Stripe-Connect-Onboarding kann pausiert werden, neue Subscriptions verhindert; bestehende laufen ungestört weiter
|
||||
- DB-Migration: alle Marketplace-Tables haben prefix `mp_`, einfacher Drop möglich
|
||||
|
||||
## Security Notes
|
||||
|
||||
- **Ed25519-Private-Keys verlassen nie den Publisher-Browser**, Storage-Empfehlung (Hardware-Token / Password-Manager) im Publisher-Guide
|
||||
- Plugin-Manifest muss Capabilities explizit listen — Marketplace-Review verifiziert, dass die deklarierten Capabilities dem WASM-Modul-Verhalten entsprechen (statische Analyse + Stichproben-Dynamic-Test)
|
||||
- AV-Scan (Phase 01) ist Pflicht für jeden Upload
|
||||
- Stripe-Connect: application_fee_amount und transfer_data.destination müssen serverseitig validiert sein (kein Client-Tampering)
|
||||
- Capability-Consent-Screen muss Capabilities in verständlicher Sprache erklären, nicht nur als Manifest-Keys
|
||||
- Plugin-Revocation: Marketplace kann signiertes Revocation-Statement broadcasten, das Tenants beim nächsten Plugin-Load durchsetzen (Kill-Switch für kompromittierte Plugins)
|
||||
|
||||
## Subagent Recommendations
|
||||
|
||||
- **Planning:** `Plan`-Subagent mit dieser MD + Phase-06-Outputs als Input
|
||||
- **Research:** `Explore`-Subagent für Stripe-Connect-Best-Practices und Plugin-Marketplace-Prior-Art (VSCode-Marketplace, Stripe-Apps, Shopify-Apps)
|
||||
- **Implementation:** ein `general-purpose`-Subagent pro Step (8 Subagents über die Phase)
|
||||
- **Tests:** separater `general-purpose`-Subagent pro Test-Block (unit/integration/e2e separat)
|
||||
- **Verification:** `gsd-verifier` für jede Acceptance-Criteria-Gruppe
|
||||
- **Code-Review:** `gsd-code-reviewer` nach jedem Step, finaler Phase-Review nach Schritt 8
|
||||
|
||||
## Staging-Deployment-Steps
|
||||
|
||||
1. Branch `agent/11-backlog-plugin-marketplace` pushen
|
||||
2. Coolify deployed Marketplace-App als zweite Stack-Instanz auf Hetzner
|
||||
3. Stripe-Connect im Test-Mode mit Test-Keys verkabeln
|
||||
4. Mit Test-Publisher-Account ein Test-Plugin durch den kompletten Flow schicken
|
||||
5. Tenant-Install + Subscription + Cancel verifizieren
|
||||
|
||||
## Deviations from Plan
|
||||
|
||||
_(Wird vom ausführenden Agent gefüllt.)_
|
||||
|
||||
## Progress Log
|
||||
|
||||
_(Wird vom ausführenden Agent gefüllt.)_
|
||||
Reference in new issue
Block a user