breadcrumb-the-shire/docs/05-erste-aenderung-backend.md

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

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