# Erste Änderung (UI)

Letzte Aktualisierung: 2026-03-06

## Ziel

Eine kleine, sichere UI-Änderung durchziehen, ohne Architekturbruch.

## Standardablauf

1. Zielseite und Datenquelle identifizieren (`pages/admin/**`).
2. Falls neue Daten nötig: Endpoint/Repository erweitern.
3. UI in `*.phtml` anpassen (nur Rendering).
4. Texte über `t('...')` ergänzen.
5. Manuell testen (Liste, Filter, Save, Rechte).

## Done-Kriterien

- Kein SQL in Views
- Keine Business-Logik in Templates
- Rechte-/Scope-Verhalten unverändert korrekt

## Checks

```bash
docker compose exec php vendor/bin/phpunit
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
```

Bei JS-Änderungen zusätzlich Browser-Smoke mit DevTools-Console (keine JS-Errors).

## Vertiefung

- Detailleitfaden: `/docs/howto-erste-aenderung.md`
- UI-Standards: `/docs/reference-entwickler-checkliste.md`