refactor: restructure

monorepo with apps/ and services/
  directories

uload/docs/reports/database-evaluation-pocketbase-vs-postgresql.md

@@ -1,159 +0,0 @@
-# Datenbankbewertung: PocketBase vs PostgreSQL für ulo.ad
-
-**Datum:** 18. Januar 2025  
-**Autor:** Claude Code  
-**Projekt:** ulo.ad - URL Shortener & Link-in-Bio Platform
-
-## Executive Summary
-
-Nach eingehender Analyse des aktuellen Projekts und dem erhaltenen Feedback bewerte ich die Empfehlung, von PocketBase zu PostgreSQL zu wechseln, als **teilweise berechtigt, aber nicht zwingend notwendig** für die aktuelle Projektphase.
-
-## Aktuelle Situation
-
-### Technologie-Stack
-- **Frontend:** SvelteKit v2.22 mit Svelte 5.0
-- **Styling:** Tailwind CSS v4.0
-- **Backend:** PocketBase (aktuell)
-- **Deployment:** Node.js Adapter
-- **Hosting:** Separate Instanzen für Dev (localhost:8090) und Prod (pb.ulo.ad)
-
-### Implementierte Features
-- URL-Shortening mit custom Short-Codes
-- User Authentication & Profile Management
-- Link-Management mit Tags
-- Click-Tracking & Analytics
-- Custom Usernames in URLs (`/u/username/shortcode`)
-- Link-in-Bio Pages (`/p/username`)
-- Team-Funktionalität
-- Stripe Integration für Monetarisierung
-
-## Bewertung des PostgreSQL-Feedbacks
-
-### Berechtigte Kritikpunkte
-
-1. **Performance bei hohem Traffic** ✅
-   - PostgreSQL mit Redis Cache wäre tatsächlich performanter
-   - Bei Millionen von Requests/Sekunde würde PocketBase an Grenzen stoßen
-   - **ABER:** Das Projekt ist noch nicht in dieser Größenordnung
-
-2. **Komplexe Analytics-Queries** ⚠️
-   - PostgreSQL bietet mehr Flexibilität für komplexe SQL-Queries
-   - Window Functions, CTEs, etc. sind in PocketBase limitiert
-   - **ABER:** Aktuelle Analytics-Anforderungen werden erfüllt
-
-3. **Skalierbarkeit** ✅
-   - PostgreSQL bietet bessere Skalierungsoptionen (Read-Replicas, Partitionierung)
-   - **ABER:** Premature Optimization für aktuellen Stand
-
-### Nicht zutreffende Kritikpunkte
-
-1. **"Quasi unmögliche" Features** ❌
-   - Die behaupteten "unmöglichen" Features sind bereits implementiert:
-     - Link-Shortening ✅ Funktioniert
-     - Click-Tracking ✅ Implementiert
-     - Analytics ✅ Vorhanden
-     - Custom Domains ✅ Möglich mit PocketBase
-     - Link-in-Bio Pages ✅ Bereits umgesetzt
-
-2. **Entwicklungsgeschwindigkeit** ❌
-   - PocketBase bietet schnellere Entwicklung durch:
-     - Eingebaute Auth
-     - Automatische REST API
-     - Realtime Subscriptions
-     - Admin UI
-
-## Vorteile des aktuellen PocketBase-Setups
-
-1. **Schnelle Entwicklung**
-   - Zero-Config Database
-   - Eingebaute User Authentication
-   - Automatische API-Generierung
-   - TypeScript-Support out-of-the-box
-
-2. **Einfaches Deployment**
-   - Single Binary
-   - Keine separate DB-Verwaltung
-   - Integriertes Backup-System
-   - Niedrige Betriebskosten
-
-3. **Feature-Complete für MVP**
-   - Alle Core-Features funktionieren
-   - Auth, Storage, Realtime inklusive
-   - MCP-Integration vorhanden
-
-4. **Developer Experience**
-   - Admin UI für Datenverwaltung
-   - Einfache lokale Entwicklung
-   - Konsistente API
-
-## Migrations-Strategie (falls notwendig)
-
-### Wann der Wechsel sinnvoll wäre:
-- ✅ Mehr als 10.000 aktive User
-- ✅ Mehr als 1 Million Clicks/Tag
-- ✅ Komplexe Business Intelligence Anforderungen
-- ✅ Multi-Tenancy auf Database-Level
-- ✅ Geografisch verteilte Deployments
-
-### Empfohlener Migrations-Pfad:
-1. **Phase 1:** Weiter mit PocketBase (JETZT)
-2. **Phase 2:** Redis-Cache für Hot-Links hinzufügen
-3. **Phase 3:** Analytics in separaten Service auslagern
-4. **Phase 4:** Bei Bedarf zu PostgreSQL migrieren
-
-## Konkrete Empfehlungen
-
-### Kurzfristig (0-3 Monate)
-1. **Bei PocketBase bleiben**
-   - Fokus auf Feature-Entwicklung
-   - User-Feedback sammeln
-   - Product-Market-Fit finden
-
-2. **Performance-Optimierungen**
-   - CDN für statische Assets
-   - Edge-Caching für populäre Links
-   - Lazy-Loading für Analytics
-
-### Mittelfristig (3-6 Monate)
-1. **Hybrid-Ansatz evaluieren**
-   - PocketBase für Auth & Core-Data
-   - Redis für Link-Resolution Cache
-   - ClickHouse/TimescaleDB für Analytics (optional)
-
-2. **Monitoring einführen**
-   - Performance-Metriken sammeln
-   - Bottlenecks identifizieren
-   - Datenbasierte Entscheidungen treffen
-
-### Langfristig (6+ Monate)
-1. **Bei nachgewiesenem Bedarf**
-   - Migration zu PostgreSQL planen
-   - Schrittweise Migration
-   - Feature-Parity sicherstellen
-
-## Fazit
-
-Die Kritik an PocketBase ist **teilweise berechtigt**, aber für die aktuelle Projektphase **übertrieben**. PocketBase erfüllt alle aktuellen Anforderungen und ermöglicht schnelle Iteration. Ein Wechsel zu PostgreSQL wäre zum jetzigen Zeitpunkt:
-
-- ⛔ **Premature Optimization**
-- ⛔ **Erhöhte Komplexität** ohne klaren Nutzen
-- ⛔ **Verlangsamte Entwicklung** in kritischer MVP-Phase
-
-**Empfehlung:** Bei PocketBase bleiben, bis konkrete Performance-Probleme auftreten oder spezifische PostgreSQL-Features zwingend benötigt werden. Die gesparte Entwicklungszeit in Feature-Entwicklung und User-Acquisition investieren.
-
-## Anhang: Feature-Vergleich
-
-| Feature | PocketBase | PostgreSQL + Stack | Bewertung |
-|---------|------------|-------------------|-----------|
-| Setup-Zeit | 5 Minuten | 2-3 Stunden | PocketBase ✅ |
-| Auth System | Eingebaut | Lucia/Auth.js nötig | PocketBase ✅ |
-| REST API | Automatisch | Prisma + tRPC/REST | PocketBase ✅ |
-| Realtime | WebSockets eingebaut | Separate Lösung | PocketBase ✅ |
-| File Storage | Eingebaut | S3/Cloudinary | PocketBase ✅ |
-| Admin UI | Eingebaut | Eigenbau/Forest Admin | PocketBase ✅ |
-| Complex Queries | Limitiert | Vollständig | PostgreSQL ✅ |
-| Skalierung | Vertikal | Horizontal | PostgreSQL ✅ |
-| Performance | Gut bis 100k Users | Exzellent | PostgreSQL ✅ |
-| Kosten | Niedrig | Mittel-Hoch | PocketBase ✅ |
-
-**Gesamtbewertung für aktuelles Projekt:** PocketBase 7:3 PostgreSQL