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

53 lines
876 B
Markdown

# 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:
```bash
cp .env.example .env
docker compose up --build -d
```
2. App öffnen:
- `http://localhost:8080`
- `http://localhost:8081` (phpMyAdmin)
3. Mit Seed-User einloggen (Fresh-Install):
- E-Mail: `demo@user.com`
- Passwort: `Demo123`
4. 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):
```bash
docker compose down -v
docker compose up --build -d
```
## Danach
- Begriffe: `/docs/reference-domain-glossar.md`
- Tagesworkflow: `/docs/howto-lokale-entwicklung.md`