# Inhaus – Hinweise für Coding-Agenten - Plan und Architektur: `docs/PLAN.md`; Hersteller-Vorgaben (wörtlich umzusetzen): `docs/specs/` - Entwicklungspakete liegen in `vendor-dev/` (`COMPOSER_VENDOR_DIR=vendor-dev`), `vendor/` ist das mitversionierte Produktions-Vendor. Nie Dev-Pakete nach `vendor/` installieren. - Browser-Tests: `npx playwright test` (`tests/Browser`, gegen laufendes Portal mit `migrate --seed`). - Tests: `vendor-dev/bin/phpunit` (PHPUnit, nicht Pest – Pest lädt fest `vendor/autoload.php`), gegen MySQL/MariaDB-Datenbank `inhaus_test`. Formatierung: `vendor-dev/bin/pint`. - Jede Änderung: `CHANGELOG.md` + `App\Version::VERSION` anheben, `bin/build`, Artefakte mitcommitten. - UI-Texte Deutsch mit Umlauten, Schlüssel/Routen ASCII. Kein Node/Shell auf dem Kundenserver voraussetzen. - Design: Tailwind + shadcn-vue (`resources/js/components/ui`), Lucide-Icons, Inter. Farben nur über Tokens (`brand`, `brand-text`, `card`, `muted-foreground` …); Markenfarbe kommt serverseitig als CSS-Variable. - Funktionen als Plugins: mitgeliefert in `plugins-core/` (Namespace `Inhaus\Plugins\…`), Kunden in `plugins/`. Kern stellt Registries bereit (Navigation, Dashboard\\Widgets, Abilities) – siehe `docs/PLUGINS.md`. - Rechte immer über `$user->can('ability', ['typ', id])` bzw. Policies; Sichtbarkeit über `Audiences::constrain`.