Some updates

endpoints_documentation.py

@@ -1,28 +1,231 @@
+# endpoints_documentation = {
+#     "root": {
+#         "path": "/",
+#         "method": "GET",
+#         "description": "API root endpoint",
+#         "parameters": None,
+#         "request_body": None,
+#         "response": {"message": "Clinic Reservation API - Use /docs for documentation"}
+#     },
+#     "get_reservations": {
+#         "path": "/reservations",
+#         "method": "GET",
+#         "description": "Get all reservations",
+#         "parameters": None,
+#         "request_body": None,
+#         "response": {
+#             "description": "List of all reservations",
+#             "model": "List[Reservation]",
+#             "filters": "Only returns reservations with status 'scheduled'"
+#         }
+#     },
+#     "get_reservations_by_filters": {
+#         "path": "/reservations/",
+#         "method": "GET",
+#         "description": "Get reservations filtered by patient ID and/or doctor name (only scheduled)",
+#         "parameters": {
+#             "patient_id": {
+#                 "type": "str",
+#                 "required": False,
+#                 "description": "Filter by patient ID"
+#             },
+#             "doctor_name": {
+#                 "type": "str",
+#                 "required": False,
+#                 "description": "Filter by doctor name (case-insensitive partial match)"
+#             }
+#         },
+#         "request_body": None,
+#         "response": {
+#             "description": "List of matching scheduled reservations",
+#             "model": "List[Reservation]",
+#             "error": "404 if no scheduled reservations match criteria"
+#         }
+#     },
+#     "create_reservation": {
+#         "path": "/create-reservation",
+#         "method": "POST",
+#         "description": "Create a new reservation",
+#         "parameters": None,
+#         "request_body": {
+#             "model": "CreateReservation",
+#             "required_fields": {
+#                 "patient_id": "str",
+#                 "doctor_name": "str",
+#                 "date_time": "datetime like this 2023-10-16T19:00:00"
+#             },
+#             "optional_fields": {
+#                 "reason": "str (optional)"
+#             }
+#         },
+#         "response": {
+#             "description": "Created reservation with status 'scheduled'",
+#             "model": "Reservation",
+#             "error": "404 if doctor not found"
+#         }
+#     },
+#     "reschedule_reservation": {
+#         "path": "/reservations/reschedule",
+#         "method": "PUT",
+#         "description": "Reschedule an existing reservation",
+#         "parameters": {
+#             "doctor_name": {
+#                 "type": "str",
+#                 "required": True,
+#                 "description": "ID of the reservation to reschedule"
+#             },
+#             "new_date_time": {
+#                 "type": "str",
+#                 "required": True,
+#                 "description": "New date/time to reschedule to"
+#             }
+#         },
+#         "response": {
+#             "description": "Updated reservation with new date/time",
+#             "model": "Reservation",
+#             "error": "404 if reservation not found"
+#         }
+#     },
+#     "cancel_reservation": {
+#         "path": "/reservations/cancel",
+#         "method": "PUT",
+#         "description": "Cancel a reservation",
+#         "parameters": {
+#             "doctor_name": {
+#                 "type": "str",
+#                 "required": True,
+#                 "description": "ID of the reservation to cancel"
+#             }
+#         },
+#         "request_body": None,
+#         "response": {
+#             "description": "Canceled reservation (status changed to 'canceled')",
+#             "model": "Reservation",
+#             "error": "404 if reservation not found"
+#         }
+#     },
+#     "get_doctors": {
+#         "path": "/doctors",
+#         "method": "GET",
+#         "description": "Get list of all available doctors",
+#         "parameters": None,
+#         "request_body": None,
+#         "response": {
+#             "description": "List of doctors with their specialties",
+#             "model": "List[dict]",
+#             "example": [
+#                 {"id": 1, "name": "Dr. Smith", "specialty": "General Medicine"}
+#             ]
+#         }
+#     },
+#     "get_doctor_availability": {
+#         "path": "/doctors/{doctor_id}/availability",
+#         "method": "GET",
+#         "description": "Get doctor's fake availability slots (30-min intervals from 9am-5pm)",
+#         "parameters": {
+#             "doctor_id": {
+#                 "type": "int",
+#                 "required": True,
+#                 "description": "ID of the doctor"
+#             },
+#             "date": {
+#                 "type": "str (YYYY-MM-DD)",
+#                 "required": False,
+#                 "description": "Date to check availability (default: today)"
+#             }
+#         },
+#         "request_body": None,
+#         "response": {
+#             "description": "Doctor's availability slots with random availability",
+#             "model": "dict",
+#             "example": {
+#                 "doctor_id": 1,
+#                 "date": "2023-10-15",
+#                 "slots": [
+#                     {
+#                         "start": "2023-10-15T09:00:00",
+#                         "end": "2023-10-15T09:30:00",
+#                         "available": True
+#                     }
+#                 ]
+#             },
+#             "error": "404 if doctor not found"
+#         }
+#     },
+#     "get_patients": {
+#         "path": "/patients",
+#         "method": "GET",
+#         "description": "Get list of all patients",
+#         "parameters": None,
+#         "request_body": None,
+#         "response": {
+#             "description": "List of patients with contact information",
+#             "model": "List[Patient]",
+#             "example": [
+#                 {"id": "uuid-123", "name": "John Doe", "phone": "555-0101", "email": "john@example.com"}
+#             ]
+#         }
+#     },
+#     "get_patient_reservations": {
+#         "path": "/patients/reservations",
+#         "method": "GET",
+#         "description": "Get my all reservations",
+#         "parameters": {
+#             "patient_id": {
+#                 "type": "str",
+#                 "required": True,
+#                 "description": "ID of the patient"
+#             }
+#         },
+#         "request_body": None,
+#         "response": {
+#             "description": "List of patient's reservations (all statuses)",
+#             "model": "List[Reservation]",
+#             "note": "Returns empty list if no reservations found (no 404 error)"
+#         }
+#     },
+#     "get_hospitals": {
+#         "path": "/hospitals",
+#         "method": "GET",
+#         "description": "Get list of all hospitals and thier working hours (start time and end time) and location",
+#         "parameters": None,
+#     }
+# }
+
+
 endpoints_documentation = {
-    "root": {
-        "path": "/",
+    "get_my_reservations": {
+        "path": "/patients/reservations",
         "method": "GET",
-        "description": "API root endpoint",
-        "parameters": None,
-        "request_body": None,
-        "response": {"message": "Clinic Reservation API - Use /docs for documentation"}
+        "description": "Get my personal reservations/appointments (all statuses)",
+        "parameters": {
+            "patient_id": {
+                "type": "str",
+                "required": True,
+                "description": "ID of the patient"
+            }
+        },
+        "response": {
+            "description": "List of patient's reservations",
+            "model": "List[Reservation]"
+        },
+        "use_case": "When user asks: Tell me my reservations, Show my appointments, قولي حجوزاتي"
     },
-    "get_reservations": {
+    "get_all_reservations": {
         "path": "/reservations",
         "method": "GET",
-        "description": "Get all reservations",
+        "description": "Get all reservations in the system (admin view)",
         "parameters": None,
-        "request_body": None,
         "response": {
-            "description": "List of all reservations",
-            "model": "List[Reservation]",
-            "filters": "Only returns reservations with status 'scheduled'"
-        }
+            "description": "List of all scheduled reservations",
+            "model": "List[Reservation]"
+        },
+        "use_case": "When admin asks: Show all reservations, Get all appointments"
     },
-    "get_reservations_by_filters": {
+    "filter_reservations": {
         "path": "/reservations/",
         "method": "GET",
-        "description": "Get reservations filtered by patient ID and/or doctor name (only scheduled)",
+        "description": "Filter reservations by patient ID or doctor name",
         "parameters": {
             "patient_id": {
                 "type": "str",
@@ -32,162 +235,127 @@ endpoints_documentation = {
             "doctor_name": {
                 "type": "str",
                 "required": False,
-                "description": "Filter by doctor name (case-insensitive partial match)"
+                "description": "Filter by doctor name"
             }
         },
-        "request_body": None,
         "response": {
             "description": "List of matching scheduled reservations",
-            "model": "List[Reservation]",
-            "error": "404 if no scheduled reservations match criteria"
-        }
+            "model": "List[Reservation]"
+        },
+        "use_case": "When user asks: Show reservations with Dr. Smith, Find my reservations with specific doctor"
     },
     "create_reservation": {
         "path": "/create-reservation",
         "method": "POST",
-        "description": "Create a new reservation",
-        "parameters": None,
+        "description": "Book a new appointment/reservation",
         "request_body": {
-            "model": "CreateReservation",
             "required_fields": {
                 "patient_id": "str",
                 "doctor_name": "str",
-                "date_time": "datetime like this 2023-10-16T19:00:00"
+                "date_time": "datetime (2023-10-16T19:00:00)"
             },
             "optional_fields": {
-                "reason": "str (optional)"
+                "reason": "str"
             }
         },
         "response": {
-            "description": "Created reservation with status 'scheduled'",
-            "model": "Reservation",
-            "error": "404 if doctor not found"
-        }
+            "description": "Created reservation",
+            "model": "Reservation"
+        },
+        "use_case": "When user asks: Book appointment, Schedule meeting, احجز موعد, I want to book with Dr. Smith"
     },
     "reschedule_reservation": {
         "path": "/reservations/reschedule",
         "method": "PUT",
-        "description": "Reschedule an existing reservation",
+        "description": "Change appointment date/time",
         "parameters": {
             "doctor_name": {
                 "type": "str",
                 "required": True,
-                "description": "ID of the reservation to reschedule"
+                "description": "Doctor name for the reservation"
             },
             "new_date_time": {
                 "type": "str",
                 "required": True,
-                "description": "New date/time to reschedule to"
+                "description": "New date/time"
             }
         },
         "response": {
-            "description": "Updated reservation with new date/time",
-            "model": "Reservation",
-            "error": "404 if reservation not found"
-        }
+            "description": "Updated reservation",
+            "model": "Reservation"
+        },
+        "use_case": "When user asks: Reschedule appointment, Change my appointment time, غير موعدي"
     },
     "cancel_reservation": {
         "path": "/reservations/cancel",
         "method": "PUT",
-        "description": "Cancel a reservation",
+        "description": "Cancel an existing appointment",
         "parameters": {
             "doctor_name": {
                 "type": "str",
                 "required": True,
-                "description": "ID of the reservation to cancel"
+                "description": "Doctor name for the reservation to cancel"
             }
         },
-        "request_body": None,
         "response": {
-            "description": "Canceled reservation (status changed to 'canceled')",
-            "model": "Reservation",
-            "error": "404 if reservation not found"
-        }
+            "description": "Canceled reservation",
+            "model": "Reservation"
+        },
+        "use_case": "When user asks: Cancel appointment, Cancel my booking, الغي موعدي"
     },
     "get_doctors": {
         "path": "/doctors",
         "method": "GET",
-        "description": "Get list of all available doctors",
+        "description": "Get list of available doctors and their specialties",
         "parameters": None,
-        "request_body": None,
         "response": {
-            "description": "List of doctors with their specialties",
-            "model": "List[dict]",
-            "example": [
-                {"id": 1, "name": "Dr. Smith", "specialty": "General Medicine"}
-            ]
-        }
+            "description": "List of doctors",
+            "model": "List[Doctor]"
+        },
+        "use_case": "When user asks: Show doctors, List available doctors, اظهر الاطباء"
     },
     "get_doctor_availability": {
         "path": "/doctors/{doctor_id}/availability",
         "method": "GET",
-        "description": "Get doctor's fake availability slots (30-min intervals from 9am-5pm)",
+        "description": "Check doctor's available time slots",
         "parameters": {
             "doctor_id": {
                 "type": "int",
                 "required": True,
-                "description": "ID of the doctor"
+                "description": "Doctor ID"
             },
             "date": {
-                "type": "str (YYYY-MM-DD)",
+                "type": "str",
                 "required": False,
-                "description": "Date to check availability (default: today)"
+                "description": "Date (YYYY-MM-DD), default today"
             }
         },
-        "request_body": None,
         "response": {
-            "description": "Doctor's availability slots with random availability",
-            "model": "dict",
-            "example": {
-                "doctor_id": 1,
-                "date": "2023-10-15",
-                "slots": [
-                    {
-                        "start": "2023-10-15T09:00:00",
-                        "end": "2023-10-15T09:30:00",
-                        "available": True
-                    }
-                ]
-            },
-            "error": "404 if doctor not found"
-        }
+            "description": "Doctor's availability slots",
+            "model": "AvailabilitySlots"
+        },
+        "use_case": "When user asks: Is Dr. Smith available?, Check doctor availability, متى متاح الدكتور"
     },
     "get_patients": {
         "path": "/patients",
         "method": "GET",
-        "description": "Get list of all patients",
+        "description": "Get list of all patients (admin only)",
         "parameters": None,
-        "request_body": None,
         "response": {
-            "description": "List of patients with contact information",
-            "model": "List[Patient]",
-            "example": [
-                {"id": "uuid-123", "name": "John Doe", "phone": "555-0101", "email": "john@example.com"}
-            ]
-        }
-    },
-    "get_patient_reservations": {
-        "path": "/patients/reservations",
-        "method": "GET",
-        "description": "Get my all reservations",
-        "parameters": {
-            "patient_id": {
-                "type": "str",
-                "required": True,
-                "description": "ID of the patient"
-            }
+            "description": "List of patients",
+            "model": "List[Patient]"
         },
-        "request_body": None,
-        "response": {
-            "description": "List of patient's reservations (all statuses)",
-            "model": "List[Reservation]",
-            "note": "Returns empty list if no reservations found (no 404 error)"
-        }
+        "use_case": "When admin asks: Show all patients, List patients"
     },
     "get_hospitals": {
         "path": "/hospitals",
         "method": "GET",
-        "description": "Get list of all hospitals and thier working hours (start time and end time) and location",
+        "description": "Get list of hospitals with locations and working hours",
         "parameters": None,
+        "response": {
+            "description": "List of hospitals",
+            "model": "List[Hospital]"
+        },
+        "use_case": "When user asks: Show hospitals, Where are the clinics, اظهر المستشفيات"
     }
 }

main.py

@@ -172,21 +172,13 @@ class HealthcareChatbot:
 
             **STEP 1: What does the user want?**
             - If query is in Arabic, translate it to English first
-            - Identify the main action/request
-            - Examples:
-              * "قولي حجوزاتي" = "Tell me my appointments" = User wants to VIEW/GET their appointments
-              * "احجز موعد" = "Book an appointment" = User wants to CREATE/POST a new appointment
-              * "Hello" = Just greeting = User wants to chat
-              * "Cancel my appointment" = User wants to DELETE/CANCEL an appointment
-
-            **STEP 2: Can any endpoint fulfill this want?**
-            - Look at each endpoint in the documentation
-            - Check if the endpoint's purpose matches what the user wants
-            - Match the action type:
-              * User wants to VIEW/GET something → Look for GET endpoints
-              * User wants to CREATE/BOOK → Look for POST endpoints  
-              * User wants to UPDATE/CHANGE → Look for PUT/PATCH endpoints
-              * User wants to DELETE/CANCEL → Look for DELETE endpoints
+            - Identify the exact action or information the user is requesting
+            - Focus on understanding their underlying need, not just the words
+
+            **STEP 2: Find matching endpoint**
+            - Read each endpoint description in the documentation
+            - Check if any endpoint's purpose can fulfill what the user wants
+            - Match based on functionality, not keywords
 
             **STEP 3: Decision**
             - Found matching endpoint = "API_ACTION"
@@ -196,7 +188,7 @@ class HealthcareChatbot:
             {{
                 "intent": "CONVERSATION|API_ACTION",
                 "confidence": 0.8,
-                "reasoning": "User wants: [translated request]. Matching endpoint: [endpoint name] OR No matching endpoint found",
+                "reasoning": "User wants: [what user actually needs]. Found endpoint: [endpoint path and why it matches] OR No endpoint matches this need",
                 "endpoint": "/exact/endpoint/path",
                 "method": "GET|POST|PUT|DELETE",
                 "params": {{}},
@@ -208,7 +200,6 @@ class HealthcareChatbot:
                 input_variables=["user_query", "detected_language", "extracted_keywords", 
                                 "sentiment_analysis", "endpoints_documentation"]
             )
-        
         # CONVERSATION CHAIN - Handles conversational responses
         self.conversation_template = PromptTemplate(
             template="""