forked from fa/breadcrumb-the-shire
35 lines
874 B
Markdown
35 lines
874 B
Markdown
|
# Erste Änderung (Backend)
|
||
|
|
|
||
|
|
Letzte Aktualisierung: 2026-02-24
|
||
|
|
|
||
|
|
## Ziel
|
||
|
|
|
||
|
|
Eine kleine Backend-Änderung korrekt über Repository und Service umsetzen.
|
||
|
|
|
||
|
|
## Standardablauf
|
||
|
|
|
||
|
|
1. SQL/Leselogik im Repository erweitern.
|
||
|
|
2. Business-Regel im Service ergänzen.
|
||
|
|
3. Action anpassen und Response stabil halten.
|
||
|
|
4. Bei API-Änderungen OpenAPI aktualisieren.
|
||
|
|
|
||
|
|
## Regeln
|
||
|
|
|
||
|
|
- Repository kennt keine HTTP-/Session-Logik.
|
||
|
|
- Service kennt keine Superglobals/Redirects.
|
||
|
|
- Externe API bleibt UUID-first.
|
||
|
|
- Service-Auflösung in `pages/**` via `app(Foo::class)`.
|
||
|
|
- Keine direkten `new ...Factory()` in `lib/Service/**` außerhalb `*Factory.php`.
|
||
|
|
|
||
|
|
## Checks
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker compose exec php vendor/bin/phpunit
|
||
|
|
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
|
||
|
|
```
|
||
|
|
|
||
|
|
## Vertiefung
|
||
|
|
|
||
|
|
- `lib/**`-Regeln: `/docs/lib-standards.md`
|
||
|
|
- API-Prozess: `/docs/07-api-erweitern.md`
|