Hetzner-Backup/JOURNAL.md

v2-Docker Projekt Journal

Projektübersicht

Lizenzmanagement-System für Social Media Account-Erstellungssoftware mit Docker-basierter Architektur.

Technische Anforderungen

• Lokaler Betrieb: Docker mit 4GB RAM und 40GB Speicher
• Internet-Zugriff:
  • Admin Panel: https://admin-panel-undso.z5m7q9dk3ah2v1plx6ju.com
  • API Server: https://api-software-undso.z5m7q9dk3ah2v1plx6ju.com
• Datenbank: PostgreSQL mit 2 Admin-Usern (rac00n, w@rh@mm3r)
• Ziel: PoC für spätere VPS-Migration

---

Aktueller Stand (2025-01-06)

✅ Implementiert

1. Docker-Infrastruktur

   • docker-compose.yaml mit 3 Services (PostgreSQL, Admin Panel, License Server)
   • Interne Bridge-Netzwerkkommunikation
   • Resource Limits konfiguriert (2 CPUs, 4GB RAM pro Service)

2. PostgreSQL Datenbank

   • Tabellen: customers, licenses
   • Init-Script vorhanden
   • Persistente Datenspeicherung

3. Admin Panel (Basis)

   • Flask-Anwendung mit Session-Management
   • Login-Funktionalität für 2 Admin-User
   • Lizenz-Erstellungsformular
   • Automatische Kundenerstellung
   • Läuft auf Port 443 mit selbstsigniertem SSL

❌ Noch nicht implementiert

1. License Server API

   • Nur Platzhalter-Container vorhanden
   • Keine API-Endpunkte
   • Keine Lizenzvalidierung
   • Kein Heartbeat/Session-Management

2. Admin Panel Erweiterungen

   • Keine Lizenzübersicht
   • Keine Bearbeitungs-/Löschfunktionen
   • Keine Kundenverwaltung
   • Kein UTF-8 Support für deutsche Umlaute

3. Internet-Zugriff

   • Kein Reverse Proxy
   • Keine gültigen SSL-Zertifikate
   • Subdomain-Routing nicht konfiguriert

---

Offene Aufgaben (Priorität)

🔴 Hoch

1. UTF-8 Support für deutsche Sonderzeichen (äöüß)
2. Reverse Proxy Setup (Nginx/Traefik) für Subdomain-Routing
3. SSL-Zertifikate (Let's Encrypt) für beide Subdomains
4. License Server API implementieren
   • /api/version - Versionscheck
   • /api/validate - Lizenzvalidierung
   • /api/heartbeat - Session-Management
5. Admin Panel: Lizenzübersicht

🟡 Mittel

1. Admin Panel: Lizenz bearbeiten/löschen
2. Admin Panel: Kundenverwaltung
3. Session-Tracking (nur eine aktive Session pro Lizenz)
4. Logging-System für Audit-Trail

🟢 Niedrig

1. Email-Benachrichtigungen
2. JWT-Authentifizierung für API
3. Backup-Strategie
4. VPS-Migrationsdokumentation

---

Bekannte Probleme

1. PostgreSQL Volume-Pfad wurde von absolutem Windows-Pfad auf Docker Volume geändert
2. Duplizierte .env Datei in templates/ Ordner
3. Credentials im Klartext in .env Dateien
4. Selbstsignierte SSL-Zertifikate verursachen Browser-Warnungen

---

Nächste Schritte

1. UTF-8 Support implementieren
2. Reverse Proxy mit SSL einrichten
3. Admin Panel Funktionalität erweitern
4. License Server API entwickeln

---

Änderungsprotokoll

2025-01-06 - Journal erstellt

• Initialer Projektstand dokumentiert
• Aufgabenliste priorisiert
• Technische Anforderungen festgehalten