chore(setup): track config.php directly, slim README to setup checklist

config/config.php was gitignored and devs had to copy it from
config/config.php.example on every fresh clone. Since the bootstrap
config reads everything from .env via $envString() / $envInt() /
$envBool() defaults, there is nothing developer-specific in the file —
the cp step was dead ceremony.

- Remove config/config.php from .gitignore and track it directly
- Delete config/config.php.example
- Drop the example-existence + per-doc reference checks from
  bin/docs-drift-check.sh; add a legacy-pattern check that flags
  any new mention of the removed example file
- Update ConfigContractsTest to require config.php and forbid the
  example
- Clean stale references in CLAUDE.md, README.md, six docs files,
  and the core-guardrails skill

Same commit slims README down from 294 to 47 lines: one setup
checklist (now 3 commands instead of 4), the seeded login table,
the three quality-gate commands, and pointers to CLAUDE.md and
docs/index.md for everything else.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-29 08:37:45 +02:00
parent f36b169f67
commit 0c78dc4355
13 changed files with 47 additions and 331 deletions

View File

@@ -20,23 +20,17 @@ Diese Anleitung bringt die Anwendung lokal schnell und stabil zum Laufen.
cp .env.example .env
```
2. Config-Template fuer den App-Bootstrap anlegen:
```bash
cp config/config.php.example config/config.php
```
3. Container bauen und starten:
2. Container bauen und starten:
```bash
docker compose up --build -d
```
4. Anwendung öffnen:
3. Anwendung öffnen:
- App: `http://localhost:8080`
- phpMyAdmin: `http://localhost:8081`
5. Logs prüfen (optional):
4. Logs prüfen (optional):
```bash
docker compose logs -f nginx php

View File

@@ -8,14 +8,6 @@ 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
```
@@ -27,8 +19,6 @@ bin/dev init
3. `module:sync`
4. `doctor`
Hinweis: `bin/dev init` erzeugt aktuell **nicht** automatisch `config/config.php`.
## Start/Stop
```bash

View File

@@ -147,8 +147,6 @@ 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`.

View File

@@ -5,7 +5,7 @@ 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.
Setup-Vertrag (Source of Truth): `config/config.php` ist im Repository getrackt und liest alle Werte über `$envString()`/`$envInt()`/`$envBool()` aus den ENV-Variablen. Diese Seite und `web/index.php` sind die massgeblichen Referenzen dafuer.
---

View File

@@ -16,12 +16,10 @@ 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:

View File

@@ -17,7 +17,6 @@ Lokal starten, einloggen, Basisfunktion prüfen.
```bash
cp .env.example .env
cp config/config.php.example config/config.php
docker compose up --build -d
```