# Erste Änderung (Backend)

Letzte Aktualisierung: 2026-03-06

## 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 `core/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

- `core/**`-Regeln: `/docs/reference-core-standards.md`
- API-Prozess: `/docs/tutorial-08-api-erweitern.md`
