tactical-docs/install-notes/013-reverse-proxy-deployment-json-status.md

RUVNOX Tactical – Installationsnotiz 013

Reverse Proxy, Deployment-Flow und JSON-Status-Endpunkt

Status

Abgeschlossen.

Kurzfassung

• Nginx Proxy Manager leitet https://tactical.ruvnox.de auf den internen Ktor-Server weiter.
• SSL funktioniert.
• / liefert: RUVNOX Tactical API.
• /health liefert: RUVNOX Tactical server online.
• /api/v1/status liefert JSON.
• Deployment-Skript funktioniert.
• Kotlin Serialization Plugin wurde ergänzt, weil ohne Plugin der JSON-Endpunkt mit HTTP 500 fehlschlug.

Öffentliche Endpunkte

• GET / -> RUVNOX Tactical API
• GET /health -> RUVNOX Tactical server online
• GET /api/v1/status -> JSON-Service-Status

Erfolgreicher JSON-Test

Befehl:

curl -i https://tactical.ruvnox.de/api/v1/status

Antwort:

{"service":"ruvnox-tactical-server","status":"online","version":"0.1.0-SNAPSHOT"}

Fehler und Fix

Fehler:

Serializer for class 'ServiceStatusResponse' is not found.

Ursache:

Kotlin Serialization Compiler Plugin fehlte.

Fix in build.gradle.kts:

kotlin("plugin.serialization") version "2.2.0"

Relevante Commits

• 241a674 Add root API route
• 3af85cc Add JSON status endpoint
• 317734e Enable Kotlin serialization plugin
• 51063fd Add server deployment script

Nächster Schritt

PostgreSQL-Grundanschluss vorbereiten.