lat long

HEALTH_CHECK_API.md

@@ -0,0 +1,66 @@
+# Health Check API - Integration Guide
+
+## Endpoint
+
+```
+POST /api/health-check
+```
+
+## Request Body
+
+```json
+{
+  "text": "tôi bị đau mũi, có nổi mụt nhọt",
+  "image_url": "https://example.com/image.jpg",
+  "user_id": "user123",
+  "session_id": "optional-session-id",
+  "location": {
+    "lat": 10.762622,
+    "lng": 106.660172
+  }
+}
+```
+
+## Parameters
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `text` | string | No* | Mô tả triệu chứng (bắt buộc nếu không có image_url) |
+| `image_url` | string | No* | URL hình ảnh (bắt buộc nếu không có text) |
+| `user_id` | string | Yes | ID của người dùng |
+| `session_id` | string | No | Session ID để theo dõi lịch sử hội thoại |
+| `location` | object | No | Vị trí của người dùng (lat, lng) - **Cần thiết để tìm bệnh viện** |
+
+### Location Object
+
+```json
+{
+  "lat": 10.762622,  // Vĩ độ (latitude)
+  "lng": 106.660172   // Kinh độ (longitude)
+}
+```
+
+## Response
+
+```json
+{
+  "triage_level": "routine",
+  "symptom_summary": "tôi bị đau mũi, có nổi mụt nhọt",
+  "suspected_conditions": [...],
+  "recommendation": {...},
+  "nearest_clinic": {
+    "name": "Bệnh viện Da Liễu Trung ương",
+    "distance_km": 2.5,
+    "address": "123 Đường ABC, Quận XYZ",
+    "rating": 4.5
+  },
+  "message": "..."
+}
+```
+
+## Lưu ý
+
+- **Location là tùy chọn** nhưng **cần thiết** để tìm bệnh viện gần nhất
+- Khi user hỏi "tôi nên đi khám ở đâu" hoặc triage level là emergency/urgent, cần có location để gọi MCP hospital tool
+- Location được truyền trực tiếp vào MCP hospital tool khi cần
+

src/routes/triage.route.ts

@@ -75,10 +75,18 @@ export async function triageRoutes(
           },
           location: {
             type: 'object',
-            description: 'Vị trí của người dùng (tùy chọn)',
+            description: 'Vị trí của người dùng (tùy chọn, nhưng CẦN THIẾT để tìm bệnh viện gần nhất khi user hỏi "đi khám ở đâu" hoặc triage level là emergency/urgent). Sẽ được truyền vào MCP hospital tool nếu cần.',
             properties: {
-              lat: { type: 'number' },
-              lng: { type: 'number' }
+              lat: { 
+                type: 'number',
+                description: 'Vĩ độ (latitude)',
+                example: 10.762622
+              },
+              lng: { 
+                type: 'number',
+                description: 'Kinh độ (longitude)',
+                example: 106.660172
+              }
             }
           }
         }