Repository navigation
Entwicklung
GitHub Codespaces / Devcontainer: PHP 8.5, Node 22 und Docker-in-Docker. Beim Erstellen installiert .devcontainer/setup.sh die Abhängigkeiten, startet Postgres aus docker-compose.yml, legt die Datenbanken leafmark und leafmark_test an und migriert.
php artisan serve # App auf Port 8000
npm run dev # Vite mit Hot Reload
php artisan test # Tests gegen die Datenbank leafmark_test
docker compose up -d --build # Produktions-Image lokal auf Port 8080Lokal ohne Codespaces: PHP 8.5, Composer, Node 22 und Docker für Postgres; dann wie im README beschrieben.
| Einstellung | Wert |
|---|---|
| Host, Port |
127.0.0.1, 5432
|
| Datenbanken |
leafmark (App), leafmark_test (Tests) |
| Benutzer / Passwort |
leafmark / leafmark
|
Datenbank-Shell: docker compose exec db psql -U leafmark. Komplett zurücksetzen: docker compose down -v && docker compose up -d db, dann leafmark_test neu anlegen (docker compose exec db createdb -U leafmark leafmark_test) und php artisan migrate.
-
MAIL_MAILER=logschreibt Mails nachstorage/logs/laravel.log. Der E-Mail-Link erscheint auf der Anmeldeseite nur, wenn SMTP in Admin → Systemeinstellungen aktiviert ist. - Passkeys verlangen, dass die Seite unter der Adresse aus
APP_URLläuft. In CodespacesAPP_URLin.envauf die weitergeleitete Adresse von Port 8000 setzen (https://<codespace>-8000.app.github.dev).
Das kostenlose Kontingent sind 120 Core-Stunden im Monat (60 Stunden auf einer 2-Core-Maschine). Empfohlen: Idle-Timeout 30 Minuten, Aufbewahrung 7 Tage (GitHub → Settings → Codespaces).
- Die Tests laufen ausschließlich gegen Postgres, wie in Produktion. Die Zugangsdaten stehen in
phpunit.xml; lokal muss der Postgres-Container laufen. - Die GitHub Action
.github/workflows/build.ymltestet jeden Push und Pull Request, baut danach das Image und schiebt es bei Pushes aufmainnach GHCR. - Externe Dienste (Google Books usw.) werden in Tests mit
Http::fake()simuliert.
-
Nur Postgres.
LIKEunterscheidet dort Groß- und Kleinschreibung; für SuchenwhereLike()verwenden. -
Book-URLs nutzen den Zeitstempel von
added_at, nicht die ID. -
env()nur inconfig/, weil der Container die Konfiguration cacht. -
Neue Texte zuerst in
lang/en/app.php, dieselben Schlüssel inde,fr,it,pl,es. -
Keine persönlichen Daten des Maintainers im Repository: Platzhalter (
<owner>,example.com) und Umgebungsvariablen verwenden. - Ein Merge nach
maingeht direkt in Produktion.
Weitere technische Hinweise stehen in CLAUDE.md.
handbuch/ ist die Quelle des GitHub-Wikis. Das Wiki wird nie von Hand bearbeitet.
python3 scripts/build-wiki.py --out /tmp/wiki # nur erzeugen, zum Ansehen
python3 scripts/build-wiki.py --push # erzeugen und ins Wiki-Repository pushenDas Skript:
- übernimmt jede Datei
handbuch/<Seite>.mdals Wiki-Seite<Seite>, - wandelt Links wie
[Text](Seite#abschnitt)in Wiki-Links um, - erzeugt die Seitenleiste in der Reihenfolge der Links auf
Home.md, - ergänzt auf jeder Seite einen Hinweis, dass sie aus
handbuch/erzeugt wird, - entfernt Wiki-Seiten, die es in
handbuch/nicht mehr gibt.
Das Wiki-Repository wird aus der Git-Adresse origin abgeleitet (<repo>.wiki.git); --repo setzt es explizit.