feat: implement API versioning and health check endpoints

Cargo.toml

@@ -1,11 +1,13 @@
 [package]
 name = "digitaler-frieden"
-version = "0.1.0"
+version = "0.1.1"
-edition = "2021"
+edition = "2024"
 
 [dependencies]
 axum = "0.8.1"
-shuttle-axum = "0.52.0"
+serde_json = "1.0.140"
-shuttle-runtime = "0.52.0"
+shuttle-axum = "0.53.0"
+shuttle-runtime = "0.53.0"
 tokio = "1.28.2"
 tower-http = { version = "0.6.2", features = ["fs"] }
+tracing = "0.1.41"

src/api.rs

@@ -0,0 +1,13 @@
+use crate::api::v1::{get_version, health_check};
+use axum::{routing, Router};
+
+pub mod v1;
+
+pub fn new() -> Router {
+    Router::new().nest(
+        "/v1",
+        Router::new()
+            .route("/version", routing::get(get_version))
+            .route("/health", routing::get(health_check)),
+    )
+}

src/api/v1.rs

@@ -0,0 +1,5 @@
+mod health;
+mod version;
+
+pub use health::health_check;
+pub use version::get_version;

src/api/v1/health.rs

@@ -0,0 +1,5 @@
+use axum::response::IntoResponse;
+
+pub async fn health_check() -> impl IntoResponse {
+    "OK"
+}

src/api/v1/version.rs

@@ -0,0 +1,10 @@
+use crate::VERSION;
+use axum::response::IntoResponse;
+use axum::Json;
+use serde_json;
+use tracing::instrument;
+
+#[instrument()]
+pub async fn get_version() -> impl IntoResponse {
+    Json(serde_json::json!({ "version": VERSION }))
+}

src/lib.rs

@@ -0,0 +1,13 @@
+mod api;
+
+use axum::Router;
+use tower_http::services::{ServeDir, ServeFile};
+
+const VERSION: &str = env!("CARGO_PKG_VERSION");
+
+pub fn new() -> Router {
+    Router::new().nest("/api", api::new()).fallback_service(
+        ServeDir::new("frontend/dist/frontend/browser")
+            .not_found_service(ServeFile::new("frontend/dist/frontend/browser/index.html")),
+    )
+}

src/main.rs

@@ -1,13 +1,6 @@
-use axum::Router;
-use tower_http::services::{ServeDir, ServeFile};
-
 #[shuttle_runtime::main]
 #[allow(clippy::unused_async)]
 async fn main() -> shuttle_axum::ShuttleAxum {
-    let router = Router::new().fallback_service(
+    let router = digitaler_frieden::new();
-        ServeDir::new("frontend/dist/frontend/browser")
-            .not_found_service(ServeFile::new("frontend/dist/frontend/browser/index.html")),
-    );
-
     Ok(router.into())
 }