breadcrumb-the-shire/docs/tutorial-05-erste-aenderung-ui.md

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

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