Files
breadcrumb-the-shire/docs/tutorial-03-setup-und-erster-login.md
fs 0c78dc4355 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>
2026-04-29 08:37:45 +02:00

876 B

Setup und erster Login

Letzte Aktualisierung: 2026-04-01

Ziel

Lokal starten, einloggen, Basisfunktion prüfen.

Voraussetzungen

  • Docker + Docker Compose
  • Zugriff auf das Repository

Schritte

  1. Umgebung anlegen und Container starten:
cp .env.example .env
docker compose up --build -d
  1. App öffnen:
  • http://localhost:8080
  • http://localhost:8081 (phpMyAdmin)
  1. Mit Seed-User einloggen (Fresh-Install):
  • E-Mail: demo@user.com
  • Passwort: Demo123
  1. Schnellcheck:
  • Login funktioniert
  • Admin -> Benutzer lädt
  • Admin -> Einstellungen lädt

Typisches Problem

Bei altem DB-Volume weichen Seed-Daten ab. Fresh-Reset (löscht lokale DB-Daten):

docker compose down -v
docker compose up --build -d

Danach

  • Begriffe: /docs/reference-domain-glossar.md
  • Tagesworkflow: /docs/howto-lokale-entwicklung.md