story-kit: merge 71_bug_server_health_endpoint_missing

server/src/http/health.rs

@@ -1,4 +1,6 @@
 use poem::handler;
+use poem_openapi::{Object, OpenApi, Tags, payload::Json};
+use serde::Serialize;
 
 /// Health check endpoint.
 ///
@@ -7,3 +9,40 @@ use poem::handler;
 pub fn health() -> &'static str {
     "ok"
 }
+
+#[derive(Tags)]
+enum HealthTags {
+    Health,
+}
+
+#[derive(Serialize, Object)]
+pub struct HealthStatus {
+    status: String,
+}
+
+pub struct HealthApi;
+
+#[OpenApi(tag = "HealthTags::Health")]
+impl HealthApi {
+    /// Health check endpoint.
+    ///
+    /// Returns a JSON status object to confirm the server is running.
+    #[oai(path = "/health", method = "get")]
+    async fn health(&self) -> Json<HealthStatus> {
+        Json(HealthStatus {
+            status: "ok".to_string(),
+        })
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[tokio::test]
+    async fn api_health_returns_ok_status() {
+        let api = HealthApi;
+        let response = api.health().await;
+        assert_eq!(response.0.status, "ok");
+    }
+}