Clover Japan

Kollaborativer Reiseplaner für eine Japan-Reise: Login/Registrierung, gemeinsame Reise (Trip) mit eingeladenen Mitgliedern. Tools (in Tab-Bereiche gebündelt): Reiseplaner (Karte, Route, Zugverbindungen, Konbini-Radar, Regenradar), Flüge (Auto-Abruf, Live-Status, Sitzplätze), Geld (Ausgaben Yen→Euro mit KI-Beleg-Scan, Abrechnung, Zollrechner, Wunschliste), Programm (Reiseablauf, Tagesplaner, Buchungen, Checkliste), Info (Übersicht, Wetter, Eki-Stamp-Album, QR-Kofferretter, Notfall) sowie ein Start-Dashboard (Countdown, Live-Flug, Aktivitäts-Feed, Japan-Uhr). Rollen: EMPLOYEE, MANAGER, ADMIN (Admin = Nutzerverwaltung).

Tech-Stack

• Next.js 15 (App Router — REST-API via Route Handlers) + TypeScript
• Prisma + PostgreSQL
• Auth.js (NextAuth v5), Credentials + bcrypt (JWT-Sessions), Passkeys/WebAuthn
• E-Mail via SMTP (Einladungen, Verifikation, Passwort-Reset)
• Tailwind CSS v4, Zod, date-fns
• Karten: Leaflet + OSM/CARTO, Nominatim, OSRM, Overpass (Konbini), RainViewer (Regenradar) — alle keyfrei; Wetter: Open-Meteo; Kurs: open.er-api.com
• Flüge: AeroDataBox (optional); Beleg-Scan: Claude Vision (optional); QR: qrcode
• Läuft vollständig in Docker (kein Node auf dem Host); Deploy: Vercel + Neon (Migrationen laufen via vercel.json automatisch — siehe VERCEL.md)

Start (Docker)

docker compose up -d db                                 # 1. Datenbank
docker compose run --rm app npm install                 # 2. Deps (Container-Volume)
docker compose run --rm app npx prisma migrate dev       # 3. Schema + Client
docker compose run --rm app npx prisma db seed          # 4. Demo-Nutzer
docker compose up -d app                                # 5. App

App: http://localhost:3000

Nach npm run build den Dev-Server neu starten (docker compose restart app) — der Prod-Build überschreibt sonst den .next-Ordner des laufenden Dev-Servers.

Demo-Zugänge (Passwort: password123)

Rolle	E-Mail
Admin	[email protected]
Manager	[email protected]
Employee	[email protected]

Architektur

• REST-API (/api/v1/*) als kanonische Schnittstelle: alle Mutationen über die API (lib/api/client.ts → fetch → router.refresh()).
• Reads bleiben SSR (Server Components → lib/services/* → Prisma) — dieselbe Service-Schicht wie die API (eine Quelle für Datenlogik).
• Geteilte Reise: alle Japan-Tools gehören einem Trip; Nutzer sind über TripMember (genau eine aktive Reise) Mitglied.
• Auth: NextAuth-Flow (/api/auth/*) + offene Selbst-Registrierung mit E-Mail-Verifikation, Passwort-Reset, Einladungen (mit Zustimmung). Route-/Rollen- Schutz doppelt (Middleware + je Page/Handler, requireUser/requireAdmin).
• Sicherheit: Rate-Limiting (Postgres), Security-Header/CSP, SSRF-Schutz, Einmal-Token. Details: CLAUDE.md.

Nützliche Befehle

docker compose logs -f app                    # Logs
docker compose run --rm app npm run build     # Produktions-Build prüfen (danach restart)
docker compose down                           # Stoppen (Daten bleiben)
docker compose down -v                        # Stoppen + Daten löschen