# 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`](docs/tech-stack.md), Arbeitsregeln für Claude Code in [`CLAUDE.md`](CLAUDE.md).

## Einrichten

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

```bash
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

```bash
./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 von ITM folgt als Push-Mirror.