feat(search): refresh global search UI and align qa/docs updates

docs/howto-docker-lokal.md

@@ -1,6 +1,6 @@
 # Docker lokal
 
-Letzte Aktualisierung: 2026-03-06
+Letzte Aktualisierung: 2026-04-01
 
 ## Ziel
 
@@ -11,7 +11,7 @@ Diese Anleitung bringt die Anwendung lokal schnell und stabil zum Laufen.
 - Docker Desktop (oder Docker Engine + Compose)
 - Port `8080` (App) und `8081` (phpMyAdmin) sind frei
 
-## Start in 4 Schritten
+## Start in 5 Schritten
 
 1. ENV-Datei anlegen:
 
@@ -19,17 +19,23 @@ Diese Anleitung bringt die Anwendung lokal schnell und stabil zum Laufen.
 cp .env.example .env
 ```
 
-2. Container bauen und starten:
+2. Config-Template fuer den App-Bootstrap anlegen:
+
+```bash
+cp config/config.php.example config/config.php
+```
+
+3. Container bauen und starten:
 
 ```bash
 docker compose up --build -d
 ```
 
-3. Anwendung öffnen:
+4. Anwendung öffnen:
    - App: `http://localhost:8080`
    - phpMyAdmin: `http://localhost:8081`
 
-4. Logs prüfen (optional):
+5. Logs prüfen (optional):
 
 ```bash
 docker compose logs -f nginx php

docs/howto-gitea-required-checks.md

@@ -20,7 +20,7 @@ QA-Pflichtchecks fuer CoreCore in Gitea vorbereiten, ohne sie sofort als Merge-B
 - `QG-002` PHPStan
 - `QG-003` Architecture Core Contract
 - `QG-006` PHP Style Check
-- `QG-008` Docs link integrity
+- `QG-008` Docs link integrity + Drift-Contract (`docs-link-check` + `docs-drift-check`)
 - `QG-009` Codex skills sync
 
 ## Phase-1 Setup (noch nicht blockend)

docs/howto-globale-suche.md

@@ -1,6 +1,6 @@
 # Globale Suche erweitern
 
-Letzte Aktualisierung: 2026-03-06
+Letzte Aktualisierung: 2026-04-01
 
 ## Ziel
 
@@ -25,6 +25,7 @@ Provider:
 - UI-Meta (Icons/URLs): `SearchUiMetaProvider`
 - Mapping: `SearchItemMapperProvider`
 - Spezialquellen (`docs`, `hotkeys`): `SearchSpecialResourceProvider`
+- Modul-Erweiterungen: `SearchResourceProvider` via Modul-Manifest `search_resources`
 
 ## Laufzeitpfad
 
@@ -45,8 +46,8 @@ Provider:
 4. Mapping ergänzen:
    - `mapPreviewItem()`
    - `mapResultItem()`
-5. Aside-Eintrag in `templates/partials/app-main-aside.phtml` ergänzen (`data-search-key`).
-6. i18n-Labels prüfen.
+5. Bei Modul-Resources: Provider-Klasse in `module.php` unter `search_resources` registrieren.
+6. i18n-Labels pruefen.
 
 ## Wichtige Regeln
 

docs/howto-lokale-entwicklung.md

@@ -8,6 +8,14 @@ Kompakter Tagesworkflow für Entwicklung, Tests und schema-nahe Änderungen.
 
 ## First-Time Workflow
 
+Einmalig vor dem ersten Start:
+
+```bash
+cp config/config.php.example config/config.php
+```
+
+Dann:
+
 ```bash
 bin/dev init
 ```
@@ -19,6 +27,8 @@ bin/dev init
 3. `module:sync`
 4. `doctor`
 
+Hinweis: `bin/dev init` erzeugt aktuell **nicht** automatisch `config/config.php`.
+
 ## Start/Stop
 
 ```bash

docs/reference-cli-commands.md

@@ -147,6 +147,8 @@ bin/dev qa-required
 bin/dev qa-extended
 ```
 
+Voraussetzung fuer den ersten App-Start: `config/config.php` muss vorhanden sein (einmalig aus `config/config.php.example` kopieren).
+
 `bin/dev console ...` delegiert intern auf `docker compose exec -T php php bin/console ...`.
 `bin/dev qa` ist ein Alias fuer `bin/dev qa-required`.
 

docs/reference-entwickler-checkliste.md

@@ -1,6 +1,6 @@
 # Entwickler-Checkliste
 
-Letzte Aktualisierung: 2026-03-24
+Letzte Aktualisierung: 2026-04-01
 
 ## Ziel
 
@@ -79,6 +79,7 @@ Kurze Definition of Done vor Merge.
 - [ ] Keine First-party CLI-Warnings/Notices/Deprecations im Runtime-Sync (Vendor-Warnings sind nur temporaer toleriert und muessen gezaehlt sichtbar sein)
 - [ ] bei Docs-/Skills-Aenderungen: `docker compose exec php vendor/bin/phpunit tests/Architecture/CodexSkillReferenceContractTest.php`
 - [ ] `bin/docs-link-check.sh` (QG-008, scannt standardmaessig ohne `.agents/runs/**`)
+- [ ] `bin/docs-drift-check.sh` (QG-008-Zusatz, blockt Legacy-Referenzen + fehlenden Setup-Vertrag)
 - [ ] `bin/codex-skills-sync.sh --check` (QG-009)
 - [ ] bei JS-Änderungen: Browser-Smoke mit DevTools-Console (keine JS-Errors)
 - [ ] bei API-Änderungen: `docs/openapi.yaml` aktualisiert

docs/reference-konfiguration.md

@@ -1,10 +1,12 @@
 # Konfiguration (ENV-Variablen)
 
-Letzte Aktualisierung: 2026-03-25
+Letzte Aktualisierung: 2026-04-01
 
 Alle Konfiguration erfolgt über Umgebungsvariablen in der `.env`-Datei.
 Vorlage: `.env.example` — niemals echte Credentials committen.
 
+Setup-Vertrag (Source of Truth): Fuer den Boot wird `config/config.php` benoetigt; die Datei wird aus `config/config.php.example` abgeleitet. Diese Seite und `web/index.php` sind die massgeblichen Referenzen dafuer.
+
 ---
 
 ## App

docs/tutorial-01-erste-schritte.md

@@ -1,6 +1,6 @@
 # Erste Schritte
 
-Letzte Aktualisierung: 2026-03-06
+Letzte Aktualisierung: 2026-04-01
 
 ## Ziel
 
@@ -16,10 +16,12 @@ Diese Seite bringt neue Entwickler in unter 45 Minuten zu einem lauffähigen lok
 
 ```bash
 cp .env.example .env
+cp config/config.php.example config/config.php
 docker compose up --build -d
 ```
 
 > Alle ENV-Variablen sind dokumentiert in /docs/reference-konfiguration.md.
+> `config/config.php` ist Pflicht fuer den App-Bootstrap und wird einmalig aus `config/config.php.example` erzeugt.
 > docker compose up startet auch den globalen Scheduler-Runner (Service scheduler) im Hintergrund.
 
 Danach erreichbar:

docs/tutorial-03-setup-und-erster-login.md

@@ -1,6 +1,6 @@
 # Setup und erster Login
 
-Letzte Aktualisierung: 2026-03-06
+Letzte Aktualisierung: 2026-04-01
 
 ## Ziel
 
@@ -17,6 +17,7 @@ Lokal starten, einloggen, Basisfunktion prüfen.
 
 ```bash
 cp .env.example .env
+cp config/config.php.example config/config.php
 docker compose up --build -d
 ```