till/managarten
1
0
Fork 0
mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-15 17:19:40 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
managarten/uload/docs/stripe/Monetization_Overview.md
Till-JS c712a2504a feat: integrate uload and picture, unify package naming 
- Add uload project with apps/web structure
  - Reorganize from flat to monorepo structure
  - Remove PocketBase binary and local data
  - Update to pnpm and @uload/web namespace

- Add picture project to monorepo
  - Remove embedded git repository

- Unify all package names to @{project}/{app} schema:
  - @maerchenzauber/* (was @storyteller/*)
  - @manacore/* (was manacore-*, manacore)
  - @manadeck/* (was web, backend, manadeck)
  - @memoro/* (was memoro-web, landing, memoro)
  - @picture/* (already unified)
  - @uload/web

- Add convenient dev scripts for all apps:
  - pnpm dev:{project}:web
  - pnpm dev:{project}:landing
  - pnpm dev:{project}:mobile
  - pnpm dev:{project}:backend

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-25 04:00:36 +01:00

2.5 KiB
Raw Blame History

Hier ist eine Übersicht eures Stripe-Setups und wie es mit der Datenbank zusammenarbeitet:

Stripe-Setup Architektur

  1. Stripe-Konfiguration ( src/lib/server/stripe.ts)
  • Initialisiert Stripe mit API-Schlüssel aus Umgebungsvariablen
  • Definiert drei Preismodelle: Monthly, Yearly, Lifetime
  • Unterstützt mehrere Währungen (USD/EUR) basierend auf Locale
  1. Pricing-Struktur
  • Monthly: $4.99/Monat (4,99€)
  • Yearly: $39.99/Jahr (39,99€) - spart $20
  • Lifetime: $129.99 einmalig (129,99€)
  1. Checkout-Flow (src/routes/api/stripe/ch eckout/+server.ts)

Prozess:

  1. User muss eingeloggt sein

  2. System prüft bestehende Subscription

  3. Erstellt/findet Stripe Customer mit Metadaten (pocketbase_id, username)

  4. Erstellt Checkout Session mit:

    • Lokalisation

(DE/EN/IT/FR/ES) - Zahlungsmethoden (Karte + SEPA) - Promotion Codes erlaubt - Metadaten für User-Zuordnung

  1. Datenbank-Integration (PocketBase users Collection)

Stripe-relevante Felder:

  • subscription_status: free|pro|team|team_plus|c ancelled|past_due
  • stripe_customer_id: Verknüpfung zum Stripe Customer
  • stripe_subscription_id: Verknüpfung zur Stripe Subscription
  • current_period_end: Ablaufdatum der aktuellen Periode
  • links_created_this_month: Limitierung für Free Users
  1. Webhook-Handler (src/routes/api/stripe/we bhook/+server.ts)

Behandelte Events:

  • checkout.session.comple ted: Aktiviert Pro-Status nach erfolgreicher Zahlung
  • customer.subscription.u pdated: Aktualisiert Subscription-Status
  • customer.subscription.d eleted: Downgrade zu Free
  • invoice.payment_failed: Setzt Status auf past_due
  • invoice.payment_succeed ed: Reaktiviert nach erfolgreicher Zahlung

Besonderheiten:

  • Lifetime-Käufe: Erhalten subscriptionid: "lifetime" + session.id und Ablaufdatum 2099
  • Admin-Authentifizierung: Webhooks verwenden Admin-Credentials für Datenbank-Updates
  1. Mehrsprachigkeit
  • Vollständige Übersetzungen (DE/EN/IT/FR/ES) in stripe-translations.ts
  • Automatische Währungsauswahl (EUR für EU, USD für Rest)
  • Stripe Checkout in Benutzersprache
  1. Sicherheit & Fehlerbehandlung
  • Webhook-Signatur-Verifi zierung
  • Fallback für Entwicklungsumgebung ohne Webhook-Secret
  • Umfassende Fehlerbehandlung mit benutzerfreundlichen Meldungen
  • Admin-Authentifizierung für kritische Operationen

Das System ermöglicht nahtlose Übergänge zwischen Free- und Pro-Status basierend auf Stripe-Events und hält die PocketBase-Datenbank automatisch synchron.