JSM DocsMarkdown aus /home/ag/codex

agent.ruby24.de/README.md

agent.ruby24.de/README

JSM Portal

AxelsCodexUI

Schlankes Projekt- und Task-Board mit:

  • frontend/: Nuxt 3 UI
  • backend/: Laravel API

Die App ist auf Zusammenarbeit zwischen Menschen und KI-Agenten ausgelegt. Projekte haben einfache Tasks, Agent-Hints und eine kleine Agent-Info-Seite.

Starten

Empfohlen:

./start.sh

Das startet:

  • Frontend auf http://127.0.0.1:4001
  • Backend auf http://127.0.0.1:8001

start.sh prüft die Ports vor dem Start, bündelt die Ausgaben und schreibt Logs nach logs/. Wenn vorhanden, werden APP_URL und FRONTEND_URL aus backend/.env als URL-Defaults verwendet.

Struktur

frontend/   Nuxt-Oberfläche
backend/    Laravel-API
start.sh    gemeinsamer Start für beide Dienste

Wichtige Befehle

Frontend:

cd frontend
npm run dev
npm run build
npm run test:e2e

Backend:

cd backend
php artisan serve --host=127.0.0.1 --port=8001
php artisan test

Persistenz

  • lokale SQLite-Datenbank im Backend
  • Agent-Hints und Tasks werden über Laravel persistiert

Tests

  • Backend: php artisan test
  • Frontend E2E: cd frontend && npm run test:e2e

Playwright ist auf das lokale Dev-Setup 8001/4001 ausgerichtet.

Git

Haupt-Branches:

  • main
  • production

Lokale Laufzeitdateien wie .pids/, logs/, backup/ und codex.sh sind ignoriert.

Caddy

Fuer den Produktivbetrieb ist Caddy vor dem Projekt eingerichtet.

  • Domain: https://agent.ruby24.de
  • Preview: https://preview.agent.ruby24.de
  • Caddy-Konfiguration im Repo: ./Caddyfile
  • Live-Caddyfile: /etc/caddy/Caddyfile

Optional kann das lokale Startskript auch selbst Caddy mitstarten:

START_CADDY=1 ./start.sh

Dabei gilt weiterhin: Shell-Umgebungsvariablen wie SITE_URL, API_BASE oder CADDY_SITE_ADDRESS überschreiben die .env-Werte.

Fuer Preview gibt es zusaetzlich einen Nuxt-Dev-Service mit Hot Reload auf preview.agent.ruby24.de, der dasselbe Backend /api verwendet wie Produktion.

Backup

Die SQLite-Datenbank wird per Cron gesichert:

  • alle 5 Minuten Lauf
  • nur bei Aenderung wird ein Backup erzeugt
  • pro Stunde bei erster Aenderung ein Vollbackup
  • weitere Aenderungen derselben Stunde als inkrementelles Delta

Versionierte Dateien:

  • deploy/backup/agent-ruby24-backup.sh
  • deploy/backup/agent-ruby24-restore.sh
  • deploy/backup/agent-ruby24-backup.cron

Live installiert:

  • /usr/local/bin/agent-ruby24-backup
  • /usr/local/bin/agent-ruby24-restore
  • /etc/cron.d/agent-ruby24-backup
  • Backup-Verzeichnis: /var/backups/agent.ruby24.de