fs
545bcc789b
Most German docs were written with `ue`/`ae`/`oe`/`ss` ASCII fallbacks (`fuer`, `aenderung`, `koennen`, `gemaess`) — relic from older toolchain constraints. Replaced 237 occurrences across 38 .md files with proper umlauts and ß so the docs read naturally. Substitutions are constrained to plain prose: fenced code blocks (```...```), inline code spans (`...`), markdown link targets `[..](..)`, and HTML comments are preserved verbatim. Path references like `docs/howto-erste-aenderung.md` keep their original (umlaut-replaced) filenames — only the surrounding prose is normalised. Tool: bin/fix-md-umlauts.py (idempotent — no-op on already-clean files). Re-runnable if ASCII fallbacks creep back in via copy-paste. Doc-link-check + doc-drift-check stay green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
99 lines
2.4 KiB
Markdown
99 lines
2.4 KiB
Markdown
# Lokale Entwicklung
|
|
|
|
Letzte Aktualisierung: 2026-04-01
|
|
|
|
## Ziel
|
|
|
|
Kompakter Tagesworkflow für Entwicklung, Tests und schema-nahe Änderungen.
|
|
|
|
## First-Time Workflow
|
|
|
|
```bash
|
|
bin/dev init
|
|
```
|
|
|
|
`bin/dev init` ist nicht-destruktiv und führt aus:
|
|
|
|
1. `.env` aus `.env.example` erstellen (falls fehlend)
|
|
2. `docker compose up --build -d`
|
|
3. `module:sync`
|
|
4. `doctor`
|
|
|
|
## Start/Stop
|
|
|
|
```bash
|
|
bin/dev up
|
|
bin/dev down
|
|
```
|
|
|
|
Hinweis: `up -d` startet auch den Scheduler-Service.
|
|
|
|
Bei inkonsistentem Laufzeitverhalten:
|
|
|
|
```bash
|
|
docker compose restart php nginx
|
|
```
|
|
|
|
## Module-Sync
|
|
|
|
Nach Änderungen an Modulen, Manifesten oder `APP_ENABLED_MODULES`:
|
|
|
|
```bash
|
|
docker compose exec php php bin/console module:sync
|
|
```
|
|
|
|
Dieser Befehl führt automatisch aus: `migrate` → `permissions-sync` → `build` → `assets-sync`.
|
|
|
|
Falls `web/index.php` den Fehler "Module runtime is stale" wirft, ist der Sync nötig.
|
|
|
|
Alle verfügbaren CLI-Kommandos: `php bin/console list` (siehe `/docs/reference-cli-commands.md`).
|
|
Alle Dev-Orchestrator-Kommandos: `bin/dev --help`.
|
|
|
|
## Schema-Stand
|
|
|
|
- Basis-Schema + Seeds: `db/init/init.sql`
|
|
- Für Bestandsumgebungen: idempotente SQL-Updates in `db/updates/*.sql`
|
|
|
|
## Umsetzungsablauf
|
|
|
|
1. Requirement klären
|
|
2. Repository anpassen (SQL)
|
|
3. Service anpassen (Business-Regeln)
|
|
4. Action/Page anpassen
|
|
5. i18n ergänzen
|
|
6. Doku aktualisieren
|
|
|
|
## Pflichtchecks vor Commit
|
|
|
|
```bash
|
|
docker compose exec php vendor/bin/phpunit
|
|
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
|
|
```
|
|
|
|
Bei Modul-/Manifest-Änderungen zusaetzlich:
|
|
|
|
```bash
|
|
docker compose exec php php bin/console module:sync
|
|
```
|
|
|
|
Bei JS-Änderungen zusätzlich Browser-Smoke mit DevTools-Console (keine JS-Errors).
|
|
|
|
## Struktur-Gates (empfohlen)
|
|
|
|
```bash
|
|
(rg 'new\s+[^\s(]+Factory\(' core/Service || true) | wc -l
|
|
(rg --glob '!**/*Factory.php' 'new\s+[^\s(]+(Service|Gateway|Repository)\(' core/Service || true) | wc -l
|
|
(rg "\b(accessServicesFactory|directoryServicesFactory|userServicesFactory|authServicesFactory|tenantServicesFactory|settingServicesFactory|userRepositoryFactory|authRepositoryFactory|authGatewayFactory)\(" pages lib templates web || true) | wc -l
|
|
```
|
|
|
|
## API-spezifisch
|
|
|
|
- `docs/openapi.yaml` aktualisieren
|
|
- bei Bedarf `/docs/reference-api.md` ergänzen
|
|
- bei Security-Änderungen `/docs/explanation-sicherheitsmodell.md` aktualisieren
|
|
|
|
## Vertiefung
|
|
|
|
- `/docs/reference-entwickler-checkliste.md`
|
|
- `/docs/tutorial-04-architektur-request-flow.md`
|