managarten/apps-archived/uload/docs/stripe/Monetization_Overview.md
Till-JS 61d181fbc2 chore: archive inactive projects to apps-archived/
Move inactive projects out of active workspace:
- bauntown (community website)
- maerchenzauber (AI story generation)
- memoro (voice memo app)
- news (news aggregation)
- nutriphi (nutrition tracking)
- reader (reading app)
- uload (URL shortener)
- wisekeep (AI wisdom extraction)

Update CLAUDE.md documentation:
- Add presi to active projects
- Document archived projects section
- Update workspace configuration

Archived apps can be re-activated by moving back to apps/

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 07:03:59 +01:00

2.5 KiB

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.