Customer Portal: Lizenz- und Abonnement-Verwaltung für Waldheim-Produkte

📋 Projektübersicht

Das Customer Portal ist eine zentrale Verwaltungsplattform für alle Waldheim-Produkte. Es ermöglicht die vollautomatische Verwaltung von Lizenzen, Abonnements, Support-Tickets und Produktstatus für Ecodrive (Fahrzeugkosten-Management), Socialverse (AI Social Media) und Silvacore (WEG-Verwaltung).

Kernfunktionen

• Lizenzverwaltung: Automatische Generierung, Validierung und Verwaltung von Produktlizenzen
• Stripe-Integration: Vollständige Zahlungs- und Abonnementverwaltung
• Ticket-System: Dialog-basierter Support mit E-Mail-Benachrichtigungen
• Multi-User-System: RBAC mit Admin, Kundenbetreuer und Kunden-Rollen
• Produktmonitoring: Status-Tracking und Limit-Überwachung
• Consulting: Stundenbuchungssystem für individuelle Dienstleistungen

🛠️ Technische Highlights

Backend-Architektur

• Go 1.23 für Performance und Typsicherheit
• Gin Framework für effizientes Routing
• GORM als elegante ORM-Lösung
• PostgreSQL 18 für zuverlässige Datenhaltung
• Valkey 8 (Redis-Fork) für Sessions und Caching

Frontend-Ansatz

• Server-Side Rendering mit Go Templates
• HTMX für moderne Interaktivität ohne JavaScript-Overhead
• TailwindCSS + DaisyUI für konsistentes Design
• Alpine.js für clientseitige Logik

Sicherheit & Authentifizierung

• Session-basierte Auth mit Secure Cookies
• 2FA mit TOTP (Google Authenticator)
• Passkey-Support via WebAuthn
• CSRF-Protection und Rate Limiting

DevOps & Testing

• Docker-basierte Containerisierung
• Traefik mit Let’s Encrypt SSL
• E2E-Tests mit Playwright
• Unit Tests mit 100% Coverage-Ziel
• GitLab CI/CD Pipeline

📊 Produktintegration

Das Portal verwaltet drei unterschiedliche Produkte mit jeweils eigenen Pricing-Modellen:

Ecodrive

Fahrzeugkosten-Management mit flexiblen Plänen von kostenlos bis Enterprise.

Socialverse

AI-gestütztes Social Media Management mit Pay-per-Use Option.

Silvacore

WEG-Verwaltungssoftware mit skalierbarem Storage-Modell.

🎯 Technische Herausforderungen & Lösungen

Challenge: Multi-Product-Lizenzierung

Lösung: UUID-basierte License Keys mit produktspezifischen Prefixes (z.B. ECODRIVE-XXXX-XXXX-XXXX-XXXX)

Challenge: Stripe-Synchronisation

Lösung: Webhook-basierte Event-Verarbeitung mit automatischer Lizenzverlängerung und Cron-Jobs für periodische Synchronisation

Challenge: Skalierbare Session-Verwaltung

Lösung: Valkey (Redis-Fork) als Session-Store mit automatischer Expiration

Challenge: E2E-Testing komplexer Flows

Lösung: Playwright-basierte Tests mit TypeScript für Payment-, Auth- und Ticket-Workflows

📈 Entwicklungsprozess

• Projektdauer: Kontinuierliche Entwicklung seit 2025
• Team: Solo-Entwicklung (Waldheim.dev)
• Methodik: Agile Entwicklung mit GitLab Issues
• Testing: Test-Driven Development mit 100% Coverage-Ziel
• Deployment: Automatisiert via Docker Compose und GitLab CI/CD

🚀 Deployment & Infrastruktur

• Production: Docker Compose mit Traefik Reverse Proxy
• SSL: Automatisches Let’s Encrypt
• Database: PostgreSQL 18 mit GORM Migrations
• Caching: Valkey 8 für Sessions und Performance
• Monitoring: Produktstatus-API für alle integrierten Produkte
• Email: SMTP mit Mailhog für lokale Entwicklung

🔗 API-Dokumentation

Das Portal bietet REST-APIs für:

• Lizenzvalidierung (für Produkt-Integration)
• Produktstatus-Updates
• Webhook-Verarbeitung (Stripe)
• Swagger-Dokumentation unter /api/docs

📚 Lessons Learned

• Go’s Typsicherheit reduziert Bugs erheblich im Vergleich zu dynamisch getypten Sprachen
• HTMX ermöglicht moderne UX ohne komplexe Frontend-Frameworks
• Server-Side Rendering vereinfacht Deployment und SEO
• Stripe Webhooks erfordern sorgfältiges Error Handling und Idempotenz
• E2E-Tests sind kritisch für Payment-Flows

🎓 Erkenntnisse & Best Practices

• Strikte Trennung von Business Logic (Services) und HTTP Handlern
• UUID-basierte Datenmodelle für bessere Skalierbarkeit
• Environment-basierte Konfiguration mit Viper
• Umfassendes Testing (Unit, Integration, E2E)
• Docker Multi-Stage Builds für kleinere Images
• Rate Limiting als First-Class Citizen

Status: In aktiver Entwicklung
Maintainer: Waldheim.dev Development
Lizenz: Proprietär
Kontakt: support@waldheim.dev