forked from fa/breadcrumb-the-shire
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
This commit is contained in:
35
docs/tutorial-05-erste-aenderung-ui.md
Normal file
35
docs/tutorial-05-erste-aenderung-ui.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user