docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001

This commit is contained in:
2026-03-06 12:25:18 +01:00
parent 9caa0a4f75
commit 72886f4784
49 changed files with 564 additions and 180 deletions

View File

@@ -0,0 +1,34 @@
# 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 `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/reference-lib-standards.md`
- API-Prozess: `/docs/tutorial-08-api-erweitern.md`