fs
c7b8fd516a
Completes the generic module platform that enables modules to contribute
UI elements, runtime JS components, and search resources without any
core hardcoding.
New generic UI slot types:
- topbar.right_item: module-contributed topbar buttons
- layout.body_end_template: module-contributed dialog/overlay templates
- layout.head_style: module-contributed global CSS
- runtime.component: declarative JS component registration with phase ordering
New infrastructure:
- ModuleAutoloader: PSR-4 autoloading for module-local PHP classes
- ModuleRuntimePageBuilder: symlinks module pages into runtime directory
- ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/
- ModulePermissionSynchronizer: syncs module permissions to DB
- CLI scripts: module-runtime-sync, module-build, module-migrate,
module-permissions-sync, module-assets-sync
- {{userId}} placeholder in SearchDataService for user-scoped search queries
- Component runtime with phased initialization (early/default/late)
- AppContainer.protectExistingBindings() to prevent module→core overwrites
- Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest,
FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.8 KiB
2.8 KiB
Konventionen (kurz und verbindlich)
Letzte Aktualisierung: 2026-03-17
1) Code
- Kleine, fokussierte Änderungen statt Misch-Commits.
- Kein toter Code, keine ungenutzten Helpers.
- ASCII als Standard, Unicode nur wenn Datei es bereits nutzt.
2) Schichten
- SQL nur in
lib/Repository/**. - Fachlogik nur in
lib/Service/**. pages/**bleibt dünn: Input, Auth/AuthZ, Service-Aufruf, Response.- Neue Domain-Logik als Instanz-Service mit Factory-Verdrahtung.
- Service-Instanzen in Actions/Helpern nur via
app(Foo::class). new ...Factory()nur im Composition Root (web/index.php+lib/App/registerContainer.php) oder in*Factory.php.- In
lib/Service/**außerhalb von*Factory.phpkeine direktennew ...Factory(),new ...Service(),new ...Gateway()odernew ...Repository(). - Alte Service-Helper (
accessServicesFactory(),userServicesFactory()usw.) nicht mehr verwenden. pages/**/data().phpnur GET (gridRequireGetRequest()), Query-Normalisierung ausschließlich übergridParseFilters(...).- Für jede Liste ein
filter-schema.phpim selben Verzeichnis;data().php,index().phpundindex(default).phtmlverwenden dieses Schema. - Filter-Toolbar nur über
renderGridFilterToolbar(...), keine manuellen Filter-Inputs/-Selects. - Client-Filterbindung nur über
gridFiltersFromSchema(...)(kein inlinefilters: [...]). - Für Listen gilt Filter UX 2.0: Quick Search sichtbar, restliche Filter im Drawer, aktive Filter-Chips.
- Search-only-Listen (nur Quick Search) verwenden keinen Drawer und bleiben im Live-Modus.
data-filter-overflow,data-filter-toggleunddata-toolbar-togglesind Legacy und in Listen-Templates nicht mehr erlaubt.- Listen-IDs nur als CSV-Parameter mit pluralem Key (
*_ids), keine Alias-Fallbacks.
3) Autorisierung
- Nur zentrale Policy-Abilities nutzen.
- Keine verteilten
userHas(...)-Checks als Hauptlogik. - Tenant-Scope nicht in Templates oder JavaScript nachbauen.
4) API
- UUID-first für externe Ressourcen.
- Interne IDs nicht nach außen geben.
- Fehlerantworten einheitlich halten (
error, optionalerrors). - OpenAPI bei jeder API-Änderung im selben Merge aktualisieren.
5) Frontend
- Templates nur für Rendering.
- UI-Texte über
t('...'). - Strukturregeln in
/docs/reference-frontend-css.mdund/docs/reference-frontend-javascript.md. - Runtime-Komponenten nur über Lifecycle-Contract (
init(root, config)+destroy()), ohne komponenteneigenen Auto-Init. - Host-gebundene Runtime-Komponenten über
data-app-componentmarkieren; nur echte Global-Utilities ohne Host als runtime-global registrieren.
6) Mindestchecks vor Merge
docker compose exec php vendor/bin/phpunitdocker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress- bei JS-Änderungen: Browser-Smoke mit DevTools-Console (keine JS-Errors)