major update

README.md

@@ -106,6 +106,9 @@ Standard-Demo-User:
 - SQL bleibt in Repositories.
 - Geschaeftslogik bleibt in Services.
 - `pages/.../*.php` fungiert als Action-/Controller-Schicht.
+- Service-Aufloesung in Actions/Helpern ueber `app(Foo::class)`.
+- `new ...Factory()` nur im Composition Root (`web/index.php` + `lib/App/registerContainer.php`) oder in `*Factory.php`.
+- `pages/**/data().php` sind GET-only (`gridRequireGetRequest()`) und normalisieren `limit`/`offset`/`order`/`dir` ueber Grid-Helper.
 - Permissions + Tenant-Scope werden in Actions/Services erzwungen.
 - Wiederkehrende UI-Bloecke als Partials zentralisieren.
 
@@ -190,27 +193,21 @@ docker compose exec php vendor/bin/phpunit --bootstrap vendor/autoload.php tests
 docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
 ```
 
-### ESLint (Frontend-JS)
+### Frontend-JS Smoke-Check (ohne Node)
 
-```bash
-npx eslint web/js
-```
+- Browser-DevTools öffnen (Console + Preserve log)
+- Kernflows klicken: Users, Address-Book, Audit-Listen, Filter setzen/zurücksetzen
+- Keine JavaScript-Errors/Unhandled-Rejections in der Console
 
 ## Dokumentation
 
-- `/docs/index.md` Einstieg und Dokumentationsindex
-- `/docs/architektur.md` Request-Flow und Layering
-- `/docs/konventionen.md` Coding- und UI-Konventionen
-- `/docs/sicherheitsmodell.md` Auth/Permission/Tenant-Scope
-- `/docs/entwickler-checkliste.md` konkrete Checkliste fuer Aenderungen
-- `/docs/benutzerdefinierte-felder.md` Quick Reference fuer Tenant/User-Zusatzfelder
-- `/docs/api.md` API v1 Referenz (inkl. Self-Service Token-Endpunkte)
-- `/docs/einstellungen-speicherung.md` Globale Settings: DB als Quelle, `config/settings.php` als Teil-Cache
-- `/docs/frontend-javascript.md` Frontend-JS-Struktur
-- `/docs/frontend-css.md` Frontend-CSS-Struktur
-- `/docs/docker-lokal.md` Docker lokal (Entwicklung)
-- `/docs/docker-produktiv.md` Docker produktiv (Serverbetrieb)
-- `/docs/docker-betrieb.md` Dev/Prod Docker-Betrieb
+- `/docs/index.md` Dokumentationsstart mit chronologischem Lernpfad und Referenzbereichen
+- `/docs/00-systemueberblick.md` Einstieg in Produktbild und Kernprinzipien
+- `/docs/01-setup-und-erster-login.md` lokales Setup und erster Smoke-Test
+- `/docs/02-domain-glossar.md` zentrale Begriffe fuer Tenant/Role/Scope
+- `/docs/03-architektur-request-flow.md` Request-Flow und Schichtmodell
+- `/docs/06-security-tenant-scope.md` Security-Grundlagen vor Feature-Arbeit
+- `/docs/07-api-erweitern.md` verbindlicher API-Aenderungsablauf inkl. OpenAPI
 
 ## Troubleshooting