Erste Schritte

Letzte Aktualisierung: 2026-04-01

Ziel

Diese Seite bringt neue Entwickler in unter 45 Minuten zu einem lauffähigen lokalen Setup inklusive erstem Smoke-Test.

Voraussetzungen

Docker + Docker Compose
Git
Zugriff auf dieses Repository

1) Projekt lokal starten

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:

App: http://localhost:8080
phpMyAdmin: http://localhost:8081

Standard-Demo-User (aus db/init/init.sql):

E-Mail: demo@user.com
Passwort: Demo123

Wichtig:

Der Seed-User wird nur beim initialen DB-Setup angelegt.
Wenn bereits ein bestehendes Docker-Volume (db_data) vorhanden ist, kann der lokale Datenstand abweichen.
Für einen sauberen Fresh-Stand kannst du lokal neu initialisieren (Achtung: löscht lokale DB-Daten):

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

3) Schneller Funktionscheck

Login funktioniert
Admin-Navigation ist sichtbar
Admin -> Benutzer lädt
Admin -> Einstellungen lädt
Admin -> API docs lädt (mit entsprechender Permission)

4) API-Schnelltest

In der Admin-UI einen API-Token erstellen (oder vorhandenen nutzen)
Beispiel-Call:

curl -H "Authorization: Bearer <TOKEN>" \
  http://localhost:8080/api/v1/me

5) Qualitätschecks ausführen

docker compose exec php vendor/bin/phpunit
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress

Bei JS-Änderungen zusätzlich Browser-Smoke mit DevTools-Console (keine JS-Errors).

6) Nächste Doku-Schritte

Täglicher Workflow: /docs/howto-lokale-entwicklung.md
Erster kleiner Change: /docs/howto-erste-aenderung.md
Architekturüberblick: /docs/explanation-architektur.md
Sicherheitsmodell: /docs/explanation-sicherheitsmodell.md

2.2 KiB Raw Blame History