Dokumentationsportal betreiben

Das Dokumentationsportal ist die Astro-Starlight-App apps/docs. Diese Seite beschreibt den lokalen Betrieb und die Veröffentlichung über Dokploy. Das Portal ist unter https://docs.orbinaut.ccl-dev.com live.

Lokal entwickeln

Der Dev-Server von Astro lauscht auf Port 4321.

Aus dem Repository-Root:

npx turbo run dev --filter=docs

Gleichwertig im Paket:

npm run dev --workspace=docs

Erreichbar unter http://localhost:4321. Suche, Sidebar und Markdown-Seiten liegen unter apps/docs/src/content/docs/. Statische Dateien, einschließlich OpenAPI, liegen unter apps/docs/public/ und erscheinen unter demselben Pfad, zum Beispiel /openapi/public-v1.yaml.

Bauen und prüfen

npx turbo run build --filter=docs

Der Task erzeugt apps/docs/dist und führt anschließend node ./scripts/check-docs.mjs aus. Typprüfung:

npx turbo run check-types --filter=docs

Vorschau des Produktionsbuilds:

npm run preview --workspace=docs

Redaktionelle Definition of Done, Same-Change-Pflicht, Handoff und das E2E-Gate docs-portal stehen in Qualität und Prozess.

Produktionsveröffentlichung

docs/operations/dokploy.md ist die kanonische Statusquelle im Repository. Stand 7. September 2026 sind fünf Anwendungen live; nur admin bleibt geplant. Die eigenständige Waitlist-Anwendung wurde entfernt. Ihr bisheriger Host leitet auf die Orbinaut-Startseite weiter.

Anwendung	Status	Öffentlicher Einstieg
api	live	api.orbinaut.ccl-dev.com
landingpage-v4	live	orbinaut.ccl-dev.com
checkout	live	orbinaut.ccl-dev.com und booking.orbinaut.ccl-dev.com
dashboard	live	app.orbinaut.ccl-dev.com
admin	geplant	keine Anwendung oder Domain in Dokploy
docs	live	docs.orbinaut.ccl-dev.com

Zusätzliche Domain

Die Domain orbinaut.de kann dieselben Anwendungen zusätzlich bereitstellen: app.orbinaut.de für das Dashboard, api.orbinaut.de für die API und docs.orbinaut.de für dieses Portal. Buchungen und Teilnehmerkonten bleiben auf den entsprechenden Pfaden unter orbinaut.de; ein weiterer booking-Host ist nicht nötig. Die bisherigen Domains bleiben bestehen.

Accounts sind auf beiden Domains verfügbar. Die Anmeldung gilt jeweils für die verwendete Domain. Registrierungs- und Verifikationslinks sowie die Rückkehr von einer Kurszahlung verwenden die zugehörige Domain. Auf der zusätzlichen Domain ist Google-Anmeldung erst verfügbar, wenn deren Callback beim Google-OAuth-Client eingetragen und die Alias-Konfiguration aktiviert ist. Bis dahin erfolgt die Anmeldung dort per E-Mail und Passwort.

Die konkreten Dokploy-Router und die Variablen ORBINAUT_PUBLIC_ORIGIN_ALIASES und VITE_PUBLIC_ORIGIN_ALIASES sind in docs/operations/dokploy.md beschrieben.

Für das Dokumentationsportal gilt:

Feld	Wert
Dokploy-Anwendung	docs
Buildpfad	Repository-Root
Publish-Verzeichnis	apps/docs/dist
Domain	docs.orbinaut.ccl-dev.com
Ausgabe	statische Dateien aus dem Docs-Build

Nach einem Deployment sind DNS, TLS, die Startseite, eine tiefe Route (/rest-api/referenz/) und /openapi/public-v1.yaml per HTTPS zu prüfen. Die lokale Prüfung verwendet Port 4321, den Turbo-Filter docs und den Build unter apps/docs/dist.

Abgrenzung

• admin ist geplant und darf nicht als live beschrieben werden.
• Die öffentliche REST-API bleibt https://api.orbinaut.ccl-dev.com.
• Secrets der API gehören nicht in die Docs-App und nicht in dieses Portal.