fix: aadded changes, doc is ssomewhat coherent still need to change some endpoint names in controller and some minor changes

documentation/openapi/src/adminApi.yaml

@@ -18,17 +18,6 @@ paths:
                 type: array
                 items:
                   $ref: "./main.yaml#/components/schemas/project"
-              examples:
-                projectList:
-                  value:
-                    - idProject: 12
-                      projectName: "MyInpulse Mobile App"
-                      creationDate: "2024-11-20"
-                      logo: "base64..."
-                    - idProject: 15
-                      projectName: "Data Analytics Dashboard"
-                      creationDate: "2025-01-10"
-                      logo: "base64..."
         "400":
           description: Bad Request - Invalid project data provided (e.g., missing required fields).
         "401":
@@ -49,11 +38,6 @@ paths:
           application/json:
             schema:
               $ref: "./main.yaml#/components/schemas/project"
-            examples:
-              newProjectData:
-                value:
-                  projectName: "New Initiative"
-                  logo: "base64encodedstring..."
       responses:
         "201": # Use 201 Created for successful creation
           description: Created - Project added successfully. Returns the created project.
@@ -114,17 +98,7 @@ paths:
         content:
           application/json:
             schema:
-              type: object
-              properties:
-                decision:
-                  type: boolean
-                  description: true to approve the project, false to reject it.
-              required: [decision]
-            example:
-              approve:
-                value: { "decision": true }
-              reject:
-                value: { "decision": false }
+              $ref: './main.yaml#/components/schemas/projectDecision'
       responses:
         "204": # Use 204 No Content for successful action with no body
           description: No Content - Decision processed successfully.
@@ -182,7 +156,7 @@ paths:
           description: Unauthorized.
 
   /admin/appointments/report/{appointmentId}:
-    post: # Changed to POST for creation
+    post:
       operationId: createAppointmentReport
       summary: Create a report for an appointment
       description: Creates and links a new report (e.g., meeting minutes) to the specified appointment using the provided content.
@@ -205,9 +179,6 @@ paths:
           application/json:
             schema:
               $ref: "./main.yaml#/components/schemas/report"
-            example:
-              value:
-                reportContent: "Discussed milestones. Action items assigned."
       responses:
         "201":
           description: Created - Report created and linked successfully. Returns the created report.
@@ -242,10 +213,6 @@ paths:
           application/json:
             schema:
               $ref: "./main.yaml#/components/schemas/report"
-            example:
-              value:
-                idReport: 987 # Optional, should match existing if known
-                reportContent: "Updated discussion points. Final decisions made."
       responses:
         "200":
           description: OK - Report updated successfully. Returns the updated report.