Codenull — Shop System Module Planning

📊 V3 Status

Was existiert, was fehlt, was war kaputt

✅ Was funktioniert (V3)

Product CRUD (Digital, Physical, Subscription)
Varianten-System (Size, Color — auto-generiert)
Warenkorb + Stock-Reservierung
Stripe PaymentIntents + Subscriptions
PayPal Orders + Capture
Order Lifecycle (PENDING → PAID → SHIPPED → COMPLETED)
Digital Downloads (Token-basiert, Limit + Expiry)
Product Actions (ON_PURCHASE → Discord Role, Webhook etc)
Refund-Handling (Stock Rückbuchung)
Kategorien mit Hierarchie

❌ Was fehlt / kaputt (V3)

Coupon-System: Schema da, aber nicht im Checkout integriert
Invoice/PDF: Model da, keine PDF-Generierung
Shipment Tracking: Schema da, kein Carrier-API
Subscription Pause: Nur lokaler DB-Update, Stripe nicht synced
PayPal Subscriptions: Nur Cancel, kein Create
Review System: Komplett fehlend
Variant Stock: Rückbuchung fragil (String-Matching)
Shipping-Kosten: Hardcoded €5.99

📦 Produkt-Typen

💾 Digital

Sofort-Download nach Zahlung. Token-basierter Download-Link mit Limit + Ablauf. Kein Versand nötig.

Download URL + Max Downloads
Download Expiry (Tage)
Varianten möglich (z.B. Formate)
Product Actions: ON_PURCHASE, ON_DOWNLOAD

Beispiele: Presets, Overlays, Sound Packs, Emote Packs

📦 Physisch

Echte Produkte mit Versand. Lager-Tracking, Varianten (Größe/Farbe), Versand-Adresse im Checkout.

Stock per Variant
Shipping Address required
Shipment Tracking (DHL, DPD, etc)
Gewicht für Versandkosten

Beispiele: Merch (T-Shirts, Hoodies, Caps), Sticker, Poster

🔄 Subscription

Wiederkehrende Zahlungen über Stripe. Trial-Periode, Pause/Cancel, Auto-Renew.

Monatlich / Quartärlich / Halbjährlich / Jährlich
Trial Days
Stripe Billing Portal
ON_SUBSCRIPTION_START/RENEW/CANCEL Actions

Beispiele: VIP Membership, Premium Emotes, Ad-Free, Exclusive Content

🔄 Order Flow

Vom Warenkorb bis zur Lieferung

🛒 Cart

Items + Stock Check

→

📋 Checkout

Adresse + Coupon

→

💳 Payment

Stripe / PayPal

→

✅ Paid

Webhook confirms

→

⚡ Actions

Discord Role, Download, etc

→

📦 Ship / Deliver

Physical: Versand
Digital: Download

💳 Stripe Flow

Cart → createPaymentIntent()
Client-side: Stripe Elements / Checkout
Webhook: payment_intent.succeeded
Order Status: PENDING → PAID
Cart wird erst nach Webhook geleert

🅿️ PayPal Flow

Cart → createPayPalOrder()
Redirect zu PayPal Approval Page
Return → capturePayPalOrder()
Order Status: PENDING → PAID
Fallback wenn Stripe nicht geht

🟢 V4 Verbesserungen

Was wir fixen und neu bauen

🎟 Coupons: Richtig integrieren

Coupon-Code im Checkout eingeben → Rabatt wird berechnet → Im Order gespeichert. Percentage, Fixed, Free Shipping. Max Uses, Per-User Limit, Zeitraum.

🧾 Invoice PDF

Auto-generierte Rechnung nach Zahlung. Rechtskonform (DE): Rechnungsnummer, MwSt-Ausweis, Absender/Empfänger. PDF per Email + Download im Panel.

📦 Versandkosten-Berechnung

Nicht mehr hardcoded €5.99. Berechnung nach: Gewicht, Land (DE/EU/International), Carrier-Tarife. Free Shipping ab Betrag X oder per Coupon.

📬 Shipment Tracking

Tracking-Nummer eingeben → Status-Updates per Carrier-API (DHL, DPD). Kunde sieht Live-Status im Panel. Webhook bei Zustellung.

⭐ Review System

Produkt-Bewertungen (1-5 Sterne + Text). Nur nach Kauf möglich. Admin Moderation. Durchschnittsbewertung auf Produktseite.

🔗 Workflow Integration

Jeder Shop-Event ist ein Workflow Trigger: Kauf, Refund, Sub Start/Renew/Cancel, Download. Actions: Discord Role, Overlay Alert, Chat Message, Email.

🖥 Admin Panel — Mockup

codenull.de/admin/shop

Shop Dashboard

Umsatz und Bestellungen im Überblick

€2,847

Revenue (Month)

156

Orders (Month)

43

Active Subs

€18.25

Avg Order

Recent Orders

Order	Customer	Items	Total	Status	Date
#ORD-2026-0892	xXGamer42Xx	Premium Emote Pack	€9.99	Paid	18.03.2026
#ORD-2026-0891	DankDonator	Hoodie (L, Schwarz)	€49.99	Processing	17.03.2026
#ORD-2026-0890	NewViewer123	VIP Monthly Sub	€4.99/mo	Subscription	17.03.2026
#ORD-2026-0889	FriendlyStreamer	Sticker Pack + T-Shirt (M)	€24.98	Shipped	16.03.2026

⚡ Product Actions — Shop × Platform Integration

Automatische Aktionen bei Kauf, Abo-Start, Refund etc.

🎭 Discord Role

Bei Kauf: Discord Rolle zuweisen. Bei Refund/Abo-Ende: Rolle entfernen. Für VIP, Supporter, Premium Access.

Must Have

💬 Discord Message

Nachricht in Discord Channel bei Kauf. "xXGamerXx hat Hoodie gekauft! 🎉". Channel konfigurierbar.

Should Have

🔔 Stream Alert

Overlay Alert bei Kauf im Stream zeigen. Gleicher Alert-Designer wie für Twitch Events.

Should Have

🌐 Webhook

HTTP Webhook an externe URL. Für Fulfillment, Logistik, CRM Integration. JSON Payload mit Order-Daten.

Should Have

📧 Email

Bestätigungs-Email, Versand-Info, Download-Links. Templates konfigurierbar.

Should Have

⚡ Workflow Trigger

Jeder Shop-Event als Workflow Trigger. Dann: beliebige Action-Chains mit Conditions, Delays, Custom Logic.

Must Have

📋 Trigger-Typen

ON_PURCHASE — Einmalige Produkte

ON_COMPLETION — Wenn Order abgeschlossen

ON_REFUND — Bei Rückerstattung

ON_SUBSCRIPTION_START — Neues Abo

ON_SUBSCRIPTION_RENEW — Abo verlängert

ON_SUBSCRIPTION_CANCEL — Abo gekündigt

ON_SUBSCRIPTION_PAUSE — Abo pausiert

ON_DOWNLOAD — Datei heruntergeladen

ON_REVIEW — Bewertung abgegeben

🗄 Datenmodell V4

Bereinigt, Coupons integriert, Reviews neu

V3	V4	Änderung
Product (30+ fields)	product (cleaned, typed settings JSON)	Bereinigt
ProductVariant	productVariant (price not nullable)	Vereinfacht
ProductAttributeType + ProductAttribute	productAttributeType (attribute inline)	2→1
ProductCategory	productCategory	Behalten
Cart + CartItem	cart + cartItem	Behalten
Order + OrderItem + OrderItemVariant	order + orderItem (variant inline JSON)	3→2
Payment	payment	Behalten
Invoice (unused)	invoice (+ PDF generation)	Fertiggestellt
Subscription + SubscriptionItem	subscription (items inline JSON)	2→1
Shipment + ShipmentTracking	shipment + shipmentEvent	Renamed
Coupon + CouponUsage (unused)	coupon + couponUsage (integriert!)	Fertiggestellt
DownloadLog	downloadLog	Behalten
ProductAction	productAction	Behalten
—	productReview (NEU)	Neu
ProcessedWebhookEvent	processedWebhookEvent	Behalten

❓ Offene Fragen

1. Versand-Provider Integration

Direkte API-Integration mit DHL/DPD für Label-Erstellung + automatisches Tracking? Oder manuell Tracking-Nummer eingeben und per Link tracken?

2. MwSt-Handling

V3 hatte flat 19% DE MwSt. Soll V4 EU-VAT unterstützen (unterschiedliche Sätze pro Land)? Oder reicht DE-only?

3. Payment Provider Prio

Stripe als primär (Kreditkarte, SEPA, Klarna, etc) + PayPal als Fallback? Oder gleichwertig? Crypto als Option?

4. Shipping Zones

Nur DE? DE + EU? International? Verschiedene Preise pro Zone? Oder flat rate pro Zone?

5. Email Service

Welcher Email-Provider? Resend, Postmark, SES? Oder eigener SMTP? Für: Bestätigungen, Rechnungen, Versand-Updates.

6. Subscription Billing Portal

Eigenes Portal im Codenull Panel oder Stripe's hosted Billing Portal (einfacher, weniger Custom)? Oder beides als Fallback?

🛒 Shop System

✅ Was funktioniert (V3)

❌ Was fehlt / kaputt (V3)

💾 Digital

📦 Physisch

🔄 Subscription

💳 Stripe Flow

🅿️ PayPal Flow

🎟 Coupons: Richtig integrieren

🧾 Invoice PDF

📦 Versandkosten-Berechnung

📬 Shipment Tracking

⭐ Review System

🔗 Workflow Integration

Shop Dashboard

Recent Orders

🎭 Discord Role

💬 Discord Message

🔔 Stream Alert

🌐 Webhook

📧 Email

⚡ Workflow Trigger

📋 Trigger-Typen

1. Versand-Provider Integration

2. MwSt-Handling

3. Payment Provider Prio

4. Shipping Zones

5. Email Service

6. Subscription Billing Portal