Files
ChristophandClaude Opus 5.5 f62541ff13
tests / ci (push) Canceled after 0s
AP0 Schritte 0.4 und 0.6: Antworten vom 05.10. und Claude Design 0.3 eingearbeitet
- Fragenliste: erste Antworten von BauIn und ITM eingetragen, übrige Fragen auf „gestellt“
- Anmeldung mit eigenem Passwort, 2FA später Pflicht; keine E-Mails; Mehrfach-Upload ohne ZIP
- Nur Produktionsschlüssel: Tests rufen die echte API nie auf
- Stellungnahme BÜW und Österreich in Phase 2; „Vor dem Livegang zu klären“ in AP11
- Claude Design Stand 0.3 abgeglichen (AP13), Prüfmaske v4 in AP6
- Gitea von ITM als Push-Mirror eingetragen

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 15:54:18 +02:00

55 lines
2.0 KiB
Markdown

# 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 zunächst freiwillig und wird
später per Schalter Pflicht.
- Die Anwendung verschickt keine E-Mails.
- Meilisearch: Version fest eingestellt, Telemetrie aus (`MEILISEARCH_NO_ANALYTICS=true`).
- Git: führend ist der lokale Gitea; der Gitea von ITM
(`https://gitea.itm-technologies.de/ChristophGraf/BauIN`) folgt als Push-Mirror.