Persönlicher Notenüberblick für ein Gymnasium in Baden-Württemberg. Zugang erhält ein freigeschaltetes GitHub-Konto.
Die Bun-Version steht in package.json. Von der Repo-Wurzel aus:
bun install
just dev-env-generate
just dev-db-start
bun run --filter @punktlandung/web db:migrate
bun run devÖffentliche Entwicklungswerte stehen in config/dev.yaml, Secrets in secrets/dev.yaml mit Beispielen in secrets/dev.example.yaml. Maschinenlokale Überschreibungen gehören in config/dev.local.yaml; just dev-env-generate erzeugt daraus die .env.local-Dateien.
Die GitHub-OAuth-App benötigt den Callback http://localhost:3000/api/auth/callback/github. Der erlaubte Account wird über seine numerische ID konfiguriert.
bun run check:fix führt die Qualitätsprüfungen aus. Die Datenbanktests benötigen PostgreSQL und einen Benutzer mit CREATE DATABASE; sie erstellen und entfernen temporäre Datenbanken. Die Browserprüfungen decken derzeit die nicht angemeldete Oberfläche ab.
Aufnahme und Veröffentlichung folgen dem Screenshot-Skill. Die Repository-Konfiguration steht in config/screenshots.yaml, die Zugangsdaten in secrets/assets.yaml. Das eigene Zugangspaar für den gemeinsamen Bucket wird so angelegt oder ersetzt:
bun standards creds add cloudflare --account 831f91724ea62b0cb0215829eb001f66 --dest assets:assets.screenshots_rw --bucket personal-pr-screenshots --jurisdiction eu --s3 --permissions "Workers R2 Storage Bucket Item Write"personal-infra betreibt den Host für https://punktlandung.vornholt.online und verwaltet Produktionskonfiguration und Secrets. Ein Merge nach main ist ein Deployment: Sobald Standards auf dem Merge-Commit bestanden hat, gibt der Workflow Publish container genau dieses Image für die Produktion frei. Der Workflow Roll back kehrt zum vorherigen Release zurück; ein zweiter Lauf kehrt zum neueren Release zurück.
An open, non-draft pull request from this repository to main can request a preview with the pr-preview label. The exact head must pass the repository gate and the container's migration, sample-data and health checks. A trusted workflow publishes its image and deploys it at https://<number>.pr.punktlandung.vornholt.online; the pull request comment records the current state. Workflow changes must merge before they can run in this preview lane.
The host permits one preview at a time. Each preview has an isolated PostgreSQL database and an ephemeral session key; data is discarded on teardown. After migrations the host runs bun run db:seed:preview from apps/web, which fills an empty database with invented sample data dated around the current day. It leaves a database that already holds app data unchanged. None of the data belongs to a user, so whoever signs in sees it. Updates replace the running image. Removing the label, converting to draft, retargeting away from main, closing the pull request, or a failed build/deployment removes the preview. Infrastructure and DNS are owned by davidvornholt/personal-infra.
Previews sign in through a GitHub OAuth app used only by previews, which accepts every preview host as a callback, and only the GitHub account allowed in production can sign in. A preview never receives production OAuth credentials, and it can reach only github.com and api.github.com, through a proxy on the host. The image check verifies that the provider redirect uses the preview's HTTPS callback URL. The pr-preview GitHub environment is restricted to main and holds only the age identity for the dedicated, forced-command preview SSH key in secrets/pr-preview.yaml.