fix production issues

apps/api/src/swagger/openapi.ts

@@ -185,7 +185,7 @@ export const openApiDocument: JsonObject = {
     '/health': {
       get: {
         tags: ['Health'],
-        summary: 'Health check',
+        summary: 'Liveness health check',
         security: [],
         servers: [{ url: '/' }],
         responses: {
@@ -193,6 +193,29 @@ export const openApiDocument: JsonObject = {
         },
       },
     },
+    '/ready': {
+      get: {
+        tags: ['Health'],
+        summary: 'Readiness probe (database, redis, storage)',
+        security: [],
+        servers: [{ url: '/' }],
+        responses: {
+          '200': { description: 'Ready' },
+          '503': { description: 'Not ready' },
+        },
+      },
+    },
+    '/metrics': {
+      get: {
+        tags: ['Health'],
+        summary: 'Prometheus-style ops metrics',
+        security: [],
+        servers: [{ url: '/' }],
+        responses: {
+          '200': { description: 'Prometheus text exposition format' },
+        },
+      },
+    },
 
     // ════════════════════════════════════════════════════════════════
     // AUTH — COMPANY