Files

fs 25370a1a55 add composer-unused, comprehensive docs, and project restructure

- Add icanhazstring/composer-unused as dev dependency for dependency hygiene checks
- Add German documentation (docs/) covering architecture, conventions, workflows, and developer checklists
- Add API layer (ApiAuth, ApiBootstrap, ApiResponse), audit, scheduler, custom fields, and SSO services
- Add Microsoft OIDC SSO, API token management, and user lifecycle features
- Add swagger-ui vendor integration and OpenAPI spec
- Add production Docker setup and bin/ scripts
- Update composer dependencies, config, templates, and frontend assets throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-02-22 15:27:35 +01:00

1.9 KiB

Raw Blame History

Erste Schritte

Letzte Aktualisierung: 2026-02-21

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
Node.js + npm (für ESLint)
Zugriff auf dieses Repository

1) Projekt lokal starten

cp .env.example .env
docker compose up --build -d

Alle ENV-Variablen sind dokumentiert in /docs/konfiguration.md. 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
npx eslint web/js

6) Nächste Doku-Schritte

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

1.9 KiB Raw Blame History