Space Theme (Repository layout)

Ziel

Alles, was später auf den Webserver gehört, lebt unter web/. Die anderen Ordner dokumentieren Planung und Infos, die nicht direkt ausgeliefert werden.

Struktur

• web/desktop/: Desktop-geeigneter Build mit eigenem public/ (Entry-Point) und src/partials/.
• web/mobile/: Mobile-Version (aktuell ein Spiegel des Desktop-Builds; anpassbar für responsive Varianten).
• docs/: Projektdokumentation; siehe docs/README.md für Details zur Anwendung.
• docs/game_rulebook_v1_2.md: SSOT für Regeln, Generator, Blueprints und Permissions.
• planning/: Freifläche für Skizzen, Notizen oder Quelltext, der nicht ins Webroot gehört.
• server/: Slim-Backend (PSR-4/7/15/11), API-Endpunkte und Tests.
• config/: JSON-Konfigurationen (Planetklassen, Rassen, Gebäude-Blueprints).

Entwicklung

Schnellstart (Testumgebung, Worktree-Sandbox):

1. bash scripts/test-env-up.sh

Manueller Ablauf:

1. cp .env.example .env
2. docker compose up -d
3. psql -h 127.0.0.1 -U <DB_USER> -c \"CREATE DATABASE <DB_TEST_NAME>\" (nur einmalig)
4. cd server && composer install
5. php db/migrate.php
6. php db/seed.php
7. vendor/bin/phpunit
8. php -S localhost:8000 -t web/desktop/public
9. Öffne http://localhost:8000/index.php?s=overview&p=dashboard (für mobile Tests -t web/mobile/public).
10. Beim Start wird /api/state geladen; die Ressourcen in der Leiste aktualisieren sich automatisch.

Konfiguration (.env)

Die Datei .env.example enthält Platzhalter (change-me). Diese Werte müssen vor einem Produktivbetrieb ersetzt werden. Auch Default-Credentials im Seed (z.B. User dev mit Passwort change-me) sind nur Platzhalter und müssen vor Prod geändert werden.

Benötigte Variablen:

• APP_ENV
• DEV_MODE
• DEV_USER_ID
• DB_HOST
• DB_PORT
• DB_NAME
• DB_TEST_NAME
• DB_USER
• DB_PASS

Repo-Hygiene

Vor dem Commit prüfen: keine Secrets im Diff.

Weitere Infos

• Die ausführliche Demo-Beschreibung und Abläufe stehen in docs/README.md.
• Trage Planungsnotizen und zusätzliche Quellen in planning/ ein, damit sie nicht mit in web/ landen.
• Die Partial-Templates (main-nav.php, planet-switcher.php, alert-banner.php, footer-links.php, ressourcen.php, site.php) liegen jeweils unter web/desktop/src/partials/ und web/mobile/src/partials/.