evoyo.la
CardLoop
Globaler und regionaler Marktplatz für Sammelkartenspiele: Laravel-API, React/TypeScript-Frontend, eigene Fee-, Risiko- und KI-Scan-Domänen — aktuell Phase-1-Fundament.
CardLoop ist als globale und regionale Handelsplattform für Trading Card Games konzipiert: internationale Reichweite für Listings kombiniert mit lokaler Übergabe, Trust Points und einem TCG-spezifischen Vertrauensmodell aus Zustandsbelegen, Versandqualität und Audit Trails. Das Projekt befindet sich in Phase 1 — Architektur, Domänenmodell und ein Teil der Kernflüsse stehen, eine produktionsreife Handelsplattform ist es ausdrücklich noch nicht.
Galerie
Case Study
Ausgangslage
Der TCG-Handel leidet unter uneinheitlichen Zustandsangaben, schwacher Beweisführung bei Streitfällen und Misstrauen bei hochpreisigen Einzeltransaktionen — verschärft, sobald globale Reichweite und lokale Übergabe im selben System koexistieren müssen. CardLoop verfolgt das bewusst als Solo-Vorhaben von Grund auf: erst Domänenmodell, Compliance- und Payment-Analyse, dann Implementierung, statt UI zuerst und Fachlogik hinterher.
Herausforderung
Marketplace-Zahlungen (Split Payments an Verkäufer) und SaaS-Billing (Premium-Abos, Scan-Credits) sind bewusst als zwei getrennte Domänen mit eigener Provider-Abstraktion modelliert, nicht als ein System — eine dokumentierte Bewertung von Adyen for Platforms, Stripe Connect und Stripe Billing entlang Split-Payments-Fähigkeit, KYC/KYB und Usage-Billing geht der Provider-Wahl voraus, bevor ein Vertrag oder eine Compliance-Freigabe überhaupt vorliegt. Ein realer Fund aus der laufenden Entwicklung: Scans, Auktionen, Premium/Billing und Protection liefen durch einen toten Feature-Flag-Mechanismus im lokalen Dev-Betrieb in einen NetworkError statt in einen funktionierenden Mock-Zustand — behoben durch je einen expliziten Mock-Flag pro Domäne statt eines einzelnen globalen Schalters. Bei der Identitätsanbindung gab es einen bewussten Kurswechsel: statt eines vollständigen Umzugs der bereits in Eloquent, Policies und Filament-Resources abgebildeten Marktplatzlogik nach Supabase/Appwrite bleibt Laravel alleiniges System of Record für Fachdaten — Appwrite liefert nur Identität und Browser-Session, ein serverseitig gegen Appwrite verifiziertes JWT synchronisiert die lokale users-Zeile.
Vorgehen
Laravel 12 mit PHP 8.4 als monolith-first API-Backbone mit klaren Domänengrenzen (Listings, Orders, Fees, Billing, Risk, Scans, Auktionen), PostgreSQL, Redis für Cache/Locks/Queues, Filament für das Admin-Panel. Frontend als React-18-/TypeScript-Anwendung mit Vite, Tailwind CSS und TanStack Query; eine dokumentierte Mock-Architektur kapselt sämtliche Datenzugriffe hinter src/lib/api/*, sodass der schrittweise Umstieg von Mock-Daten auf echte Endpunkte Seitenstruktur und Komponenten unverändert lässt. Ein Commit im Juni 2026 hat die Kernflüsse — Auth, Marktplatzsuche, Watchlist, Warenkorb, Checkout, Orders, Seller-Dashboard, Uploads — von diesem Mock-Zustand auf echte Laravel-API-Aufrufe umgestellt; Scans, Auktionen, Premium/Billing und Protection sind bewusst noch mock-only.
Entscheidungen
Marketplace-Zahlungen und Abo-Billing sind getrennte Interfaces mit dokumentierter Anbieter-Analyse (Adyen, Stripe Connect, Stripe Billing) — keine Festlegung, bevor Compliance-Freigabe und Vertrag stehen.
Nach einem realen Bug, bei dem ein toter Fallback-Mechanismus vier Bereiche in einen NetworkError statt einen funktionierenden Mock-Zustand laufen ließ, behoben durch dedizierte Flags je Feature.
Kein vollständiger Umzug der bereits modellierten Marktplatzlogik in Appwrite-Collections — ein serverseitig verifiziertes JWT synchronisiert stattdessen eine lokale User-Zeile.
Structured Outputs der Vision-Provider-Abstraktion werden serverseitig gegen ein JSON-Schema geprüft und nie als rechtsverbindliche Echtheits- oder Zustandsgarantie behandelt.
Pflichtnachweise, Payout-Holds und ein Moderations-Claim-Prozess statt eines Versicherungsversprechens, solange kein Partner und keine Rechtsprüfung dahinterstehen.
Eigenanteil
Alle Commits stammen von Felix Schattenberg, solo umgesetzt: Domänenmodell, Compliance- und Payment-Provider-Analyse, Laravel-Backend inklusive Filament-Admin, React/TypeScript-Frontend mit dokumentierter Mock-zu-API-Architektur, Appwrite-Identitätsanbindung.
Ergebnisse