JSM DocsMarkdown aus /home/ag/codex

pomodoro/README.md

pomodoro/README

JSM Portal

Web Timer

Monorepo mit getrenntem Frontend und Backend.

Struktur

  • frontend/: bestehende Nuxt-Anwendung
  • backend/: Laravel-Anwendung mit Backpack CRUD

Hinweise

  • Das Root-Verzeichnis enthaelt nur Repo-Doku.
  • Persistenz laeuft jetzt ueber das Laravel-Backend.
  • Backpack ist im Backend installiert. Der optionale Basset-Check am Ende der Installation konnte ohne laufenden lokalen Server nicht erfolgreich pruefen.

Start

Frontend:

cd frontend
npm run dev

Backend:

cd backend
php artisan serve

Backpack Admin:

http://127.0.0.1:8000/admin

Deployment auf pomodoro.mct-net.com

Empfohlenes Setup:

  • Nuxt-Frontend intern auf 127.0.0.1:4003
  • Laravel-Backend intern auf 127.0.0.1:8003
  • Nginx als Reverse Proxy fuer https://pomodoro.mct-net.com

Vorbereitete Dateien:

  • Frontend-Env-Vorlage: frontend/.env.example
  • Backend-Env-Vorlage: backend/.env.example
  • Nginx-VHost: deploy/nginx/pomodoro.mct-net.com.conf

Wichtige Punkte:

  • Das Frontend nutzt standardmaessig /api, damit die Domain ohne separate CORS-Loesung funktioniert.
  • APP_URL und FRONTEND_URL muessen in Produktion auf https://pomodoro.mct-net.com gesetzt sein.
  • Fuer die Domain muss ein DNS-Record auf den Zielserver zeigen.
  • Fuer HTTPS wird ein Zertifikat benoetigt, z. B. via Let’s Encrypt.