1
0
Files
breadcrumb-the-shire/docs/tutorial-06-erste-aenderung-backend.md
fs 0e86925464 refactor: rename lib/ to core/ for clearer core-module separation
Rename the top-level lib/ directory to core/ so the project root
immediately communicates which code is core platform and which lives
in modules/. PHP namespaces (MintyPHP\*) are unchanged — only the
Composer PSR-4 path mapping moves from lib/ to core/.

Module-internal lib/ directories (modules/*/lib/) are untouched.

Updated across the full stack:
- composer.json PSR-4 mapping
- bootstrap entry points (web/index.php, bin/*, tests/bootstrap.php)
- tooling configs (phpstan.neon, phpunit.xml, php-cs-fixer)
- 26 architecture contract tests
- enforcement-policy, guard-catalog, quality-gates
- all documentation (CLAUDE.md, README, 25 docs/, .agents/skills/)
- bin/qa-extended.sh search paths
- .claude/settings.local.json permission paths

Workflow: .agents/runs/CORE-LIB-RENAME-001/ (Analyst → Planner →
Executor → Code Review (4 findings fixed) → Security Review →
Acceptance Test → Finalizer)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 23:20:42 +02:00

896 B

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

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