Files

Matthias Meister 456b910532 feat(docs): update LemonSpace manifest and PRD for v2.0 release

- Updated version from v1.5 to v2.0 in both the LemonSpace Manifest and PRD documents.
- Expanded Phase 1 scope to include video and asset nodes, and integrated non-destructive image editing capabilities.
- Enhanced node taxonomy to reflect 6 categories with 27 node types.
- Added details on offline sync features and optimistic updates in the documentation.
- Improved clarity and structure of the product vision and problem statement sections.

2026-04-06 22:27:21 +02:00

2.6 KiB

Raw Blame History

components/billing/ — Billing & Subscription UI

UI-Komponenten für Credit-Anzeige, Subscription-Management und Top-Up.

Dateien

Datei	Zweck
`pricing-cards.tsx`	Tier-Vergleich (Free / Starter / Pro / Max)
`manage-subscription.tsx`	Aktuelle Subscription verwalten (Upgrade, Kündigung)
`topup-panel.tsx`	Credit-Nachkauf-UI (fixe Pakete + Custom-Betrag)

Tier-Struktur

Tiers und ihre Credit-Mengen sind in convex/credits.ts → TIER_CONFIG definiert. Die Billing-UI liest diese Werte über Convex-Queries — keine doppelte Konfiguration hier.

Free:    50 Cr/Monat  (€0)
Starter: 400 Cr/Monat (€8)
Pro:     3.300 Cr/Monat (€59)
Max:     6.700 Cr/Monat (€119)

1 Credit = €0,01 — Diese Umrechnung überall konsistent verwenden.

Payment-Integration

Polar.sh ist der aktuelle Payment-Provider (MoR, VAT-Handling). Webhooks landen in convex/http.ts → convex/polar.ts.

Hinweis: convex/schema.ts enthält noch lemonSqueezySubscriptionId-Felder — Überbleibsel einer früheren Integration. Lemon Squeezy ist nicht mehr aktiv. Polar-Felder (polarSubscriptionId) sind maßgeblich.

Credit-Balance im Dashboard

Die Credit-Balance wird auch in components/dashboard/credit-overview.tsx angezeigt. Beide Komponenten nutzen dieselbe Convex-Query (api.credits.getBalance).

Konventionen

Tier-Upgrades immer über Polar-Checkout (kein direktes Schreiben in subscriptions-Tabelle)
topUp Mutation (convex/credits.ts) für Credit-Nachkauf aufrufen
Monatliches Top-Up-Limit pro Tier beachten (siehe TIER_CONFIG.topUpLimit)

Features

Pricing Cards

Zeigt alle verfügbaren Tiers mit:

Beschreibung
Credits pro Monat
Preise (Euro)
Feature-Checkmarks
Aktives Tier hervorheben

Manage Subscription

UI für:

Aktuelles Tier anzeigen
Upgrade zum nächsthöheren Tier
Abonnement verwalten (Stornierung, Abo verwalten)
Webhook-Feedback-Feedback

Top-Up Panel

Bietet:

Feste Pakete (z.B. 100 Credits, 500 Credits)
Custom-Betrag
Bonus-Staffel-Berechnung (topup-calculator.ts)
Direkter Checkout über Polar

Best Practices

UI-Updates: Änderungen an Tiers/Kosten immer in convex/credits.ts zuerst ändern, dann in UI-Dateien anpassen
Mock-Mode: Für Development kann ALLOW_TEST_CREDIT_GRANT=true verwendet werden, um Test-Credits zu generieren
Error Handling: Webhook-Fehler und Payment-Fehler müssen im Dashboard transparent dargestellt werden
Audit Trail: Alle Credit-Transaktionen (subscriptions, topups, usage) müssen im Backend persistiert werden

2.6 KiB Raw Blame History