Files
BauIN/README.md
T
ChristophandClaude Opus 5.5 cdd2d5b676 CLAUDE.md und Tech-Stack-Dokumentation ergänzt
- CLAUDE.md: Befehle, harte Vorgaben (alles lokal, keine Kundendaten,
  Rechteprüfung), Entwicklungsgrundsätze und Konventionen; wird versioniert,
  damit alle Entwickler dieselben Regeln haben (aus .gitignore entfernt)
- docs/tech-stack.md: Stack auf Basis der Kollegen-Referenz mit bewussten
  Abweichungen und offenen Punkten
- README an TallStackUI und Wegfall von Redis angepasst

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 09:35:13 +02:00

1.9 KiB

KI-BauIN

KI-gestützte Prüfung von Mehrkostenanzeigen und Nachträgen im Bahnbau.

Laravel 13, Livewire 4, TallStackUI 4, Fortify, Spatie laravel-permission, Pest. Entwicklung mit Laravel Sail: PHP 8.5, MySQL 8.4, Meilisearch, Mailpit. Details und Begründungen in docs/tech-stack.md, Arbeitsregeln für Claude Code in CLAUDE.md.

Einrichten

Voraussetzungen: Linux bzw. WSL2 mit Docker, PHP ≥ 8.3 und Composer (nur für den ersten composer install), Node, gitleaks. Unter WSL2 das Projekt im Linux-Dateisystem ablegen (z. B. ~/code), nicht unter /mnt/c.

cp .env.example .env
composer install
./vendor/bin/sail up -d
./vendor/bin/sail artisan key:generate
./vendor/bin/sail artisan migrate
npm install && npm run dev
git config core.hooksPath .githooks   # gitleaks vor jedem Commit
Dienst Adresse
Anwendung http://localhost:8080
Mailpit (E-Mails) http://localhost:8025
Meilisearch http://localhost:7700
MySQL localhost:3307 (Benutzer sail, Passwort password)

Die Ports 80 und 3306 sind auf dem Entwicklungsrechner belegt, daher APP_PORT und FORWARD_DB_PORT in .env.

Täglich

./vendor/bin/sail up -d                 # starten
./vendor/bin/sail artisan test          # Tests
./vendor/bin/sail bin pint              # Code-Stil
./vendor/bin/sail bin phpstan analyse   # statische Analyse
./vendor/bin/sail composer require …    # Pakete immer im Container installieren (PHP 8.5)
./vendor/bin/sail down                  # stoppen

Festlegungen

  • Keine Selbstregistrierung: Benutzer legt ein Administrator an.
  • 2FA (Authenticator-App) und Passkeys sind verfügbar, 2FA ist noch nicht verpflichtend.
  • Meilisearch: Version fest eingestellt, Telemetrie aus (MEILISEARCH_NO_ANALYTICS=true).
  • Git: führend ist der lokale Gitea; der Gitea des Kunden folgt als Push-Mirror.