QR-SaaS in Laravel bauen: Was kommt dabei auf einen zu?
Möchten Sie eine eigene QR-SaaS-Plattform in Laravel bauen? In diesem Artikel erkläre ich, welche Komponenten benötigt werden, welche Entscheidungen zu treffen sind und wo die Fallstricke liegen.
Laravel ist das perfekte Framework für eine QR-SaaS-Plattform. Es ist ausgereift, gut dokumentiert und hat ein reichhaltiges Ökosystem an Packages. Aber eine QR-SaaS zu bauen ist mehr als ein paar Routen und Controller zu erstellen.
In diesem Artikel gehe ich durch alle Komponenten, die für eine produktionsreife QR-SaaS-Plattform benötigt werden.
1. Der Kern: Redirect-Engine
Die Redirect-Engine ist das Herzstück des Systems. Jeder QR-Code verweist auf eine URL auf der eigenen Plattform — zum Beispiel qr.ihredomain.de/abc123. Diese URL muss so schnell wie möglich zum endgültigen Ziel auflösen.
In Laravel erstellt man dafür einen dedizierten Controller:
class QrRedirectController extends Controller
{
public function resolve(string $code)
{
$tag = Cache::remember("tag:{$code}", 300, fn() =>
Tag::where('code', $code)->with('activeRedirect')->firstOrFail()
);
dispatch(new TrackScan($tag, request()))->afterResponse();
return redirect($tag->activeRedirect->url, 301);
}
}
Beachten Sie den 301-Redirect — dieser ist wichtig für das SEO der Zielseite. Und der Cache verhindert einen Datenbankzugriff bei jedem Scan.
2. Multi-Tenant-Architektur
Eine SaaS-Plattform hat mehrere Kunden. Jeder Kunde hat seine eigenen Tags, Benutzer und Analytics. Der einfachste Ansatz ist eine tenant_id-Spalte in allen relevanten Tabellen.
In Laravel verwendet man einen Global Scope zum automatischen Filtern:
class TenantScope implements Scope
{
public function apply(Builder $builder, Model $model): void
{
$builder->where('tenant_id', auth()->user()->tenant_id);
}
}
Diesen Scope den Modellen hinzufügen und man muss nie wieder manuell filtern.
3. QR-Code-Generierung
Für die QR-Code-Generierung verwendet man ein Package wie simplesoftwareio/simple-qrcode oder endroid/qr-code. Der QR-Code verweist immer auf den eigenen Redirect-Endpunkt — nicht auf das endgültige Ziel.
$qr = QrCode::format('png')
->size(300)
->generate("https://qr.ihredomain.de/{$tag->code}");
Den generierten QR-Code im Storage speichern, damit er nicht bei jeder Anfrage neu generiert werden muss.
4. Analytics
Analytics ist der Bereich, in dem man den Unterschied zu einfachen Redirect-Diensten macht. Mindestens möchte man erfassen:
- Scans pro Tag pro Tag
- Eindeutige Scans vs. Gesamtscans
- Geräteaufteilung (Mobil / Desktop)
- Geografische Verteilung
- Spitzenzeiten
Das Queue-System von Laravel verwenden, um Scan-Daten asynchron zu verarbeiten. So wird der Redirect nicht verlangsamt.
Für das Frontend des Analytics-Dashboards ist eine Kombination aus Filament-Widgets und einer Charting-Library wie Chart.js oder ApexCharts ideal.
5. Admin-Dashboard
Filament ist die beste Wahl für das Admin-Dashboard einer Laravel-SaaS. Es bietet:
- CRUD-Interfaces für Tags, Kampagnen und Benutzer
- Ressourcen mit vollständigen Such-, Filter- und Sortieroptionen
- Widgets für Analytics-Übersichten
- Rollenbasierte Zugriffskontrolle über Filament Shield
6. Abonnement und Abrechnung
Für eine echte SaaS benötigt man Abonnementverwaltung. Laravel Cashier integriert sich nahtlos mit Stripe und bietet:
- Monatliche und jährliche Abonnements
- Nutzungsbasierte Abrechnung (pro Scan oder pro Tag)
- Automatische Rechnungen
- Webhook-Handling für Zahlungsereignisse
7. API
Eine REST-API macht die Plattform integrierbar mit externen Systemen. In Laravel verwendet man Laravel Sanctum für API-Authentifizierung und Laravel API Resources für konsistente Response-Formatierung.
Minimale API-Endpunkte:
- GET /api/tags — Liste der Tags
- POST /api/tags — neuen Tag erstellen
- PATCH /api/tags/{id} — Redirect-URL ändern
- GET /api/tags/{id}/scans — Scan-Statistiken
8. Infrastruktur
Eine QR-SaaS-Plattform hat spezifische Infrastrukturanforderungen:
- Queue-Worker: für asynchrone Scan-Verarbeitung
- Redis: für Caching und Queue-Management
- Storage: für QR-Code-Bilder
- SSL: obligatorisch, da QR-Codes auf Mobilgeräten gescannt werden
Auf einem VPS mit DirectAdmin und AlmaLinux läuft dies problemlos. Für die Redirect-Engine eine dedizierte Subdomain einrichten — qr.ihredomain.de — damit die Hauptdomain nicht belastet wird.
Fazit
Eine QR-SaaS-Plattform in Laravel zu bauen ist ein ernstes Projekt. Man benötigt eine durchdachte Architektur, Kenntnisse über Queues und Caching, eine solide Multi-Tenant-Struktur und ein gutes Admin-Dashboard.
Die gute Nachricht: Ich habe das bereits getan. Wenn Sie eine eigene QR-SaaS aufbauen möchten, oder wenn Sie eine bestehende Idee ausarbeiten lassen möchten, nehmen Sie Kontakt auf. Ich begleite Sie von Konzept bis Produktion.
Erzählen Sie mir von Ihrem Projekt. Ich gebe Ihnen innerhalb von 24 Stunden einen ehrlichen Rat — ob Maßentwicklung gerechtfertigt ist oder nicht.
Nachricht senden