Document reverse proxy deployment and JSON status

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

@@ -0,0 +1,57 @@
+# 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.