Update documentation

Author: jehousoh

backend/question/docs/question.plantuml

@@ -23,19 +23,21 @@ entity Pagination {
 interface IQuestionServiceAPI {
   + GET /
   + POST /create [createQuestion: EditQuestion]
-  + POST /all [pagination: Pagination]
+  + POST /all [pagination: Pagination, title: string, complexity: string[], category: string[]]
   + GET /{id}
   + POST /{id}/update [updateQuestion: EditQuestion]
   + POST /{id}/delete
+  + POST /pick-question [complexity: string[], category: string[]]
 }
 
 note right of IQuestionServiceAPI
   - GET /: Check service status
   - POST /create: Create a new question
-  - POST /all: Retrieve all questions with pagination
+  - POST /all: Retrieve all questions with pagination (Supports filtering by title, complexiy and category)
   - GET /{id}: Retrieve a specific question by ID
   - POST /{id}/update: Update a specific question by ID
   - POST /{id}/delete: Delete a specific question by ID
+  - POST /pick-question: Pick a random question given a list of complexities and categories
 end note
 
 class QuestionService {

backend/question/docs/question.yaml

@@ -66,10 +66,39 @@ paths:
                   type: integer
                   default: 1
                   description: Page number
+                  example: 1
                 page_size:
                   type: integer
                   default: 10
                   description: Number of questions per page
+                  example: 10
+                title:
+                  type: string
+                  default: ""
+                  description: Filter by title
+                  example: "Two Sum"
+                complexity:
+                  type: array
+                  items:
+                    type: string
+                  default: []
+                  description: Filter by complexities
+                  example: ["Easy", "Medium", "Hard"]
+                category:
+                  type: array
+                  items:
+                    type: string
+                  default: []
+                  description: Filter by categories
+                  example:
+                    [
+                      "Hash Table",
+                      "Array",
+                      "Linked List",
+                      "Dynamic Programming",
+                      "Math",
+                      "String",
+                    ]
       responses:
         "200":
           description: List of questions
@@ -155,6 +184,43 @@ paths:
           description: Question not found
         "500":
           description: Internal server error
+  /pick-question:
+    post:
+      summary: Pick a random question given a list of complexities and categories
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                complexity:
+                  type: array
+                  items:
+                    type: string
+                  default: []
+                  description: Filter by complexities
+                  example: ["Easy"]
+                category:
+                  type: array
+                  items:
+                    type: string
+                  default: []
+                  description: Filter by categories
+                  example: ["Hash Table"]
+
+      responses:
+        "200":
+          description: Question picked
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Question"
+        "400":
+          description: Bad Request (validation error)
+        "404":
+          description: No Question found
+        "500":
+          description: Internal server error
 
 components:
   schemas: