recreate project

2026-02-10 22:11:06 -05:00
commit 663c0cdbda
10149 changed files with 1379710 additions and 0 deletions
@@ -0,0 +1,79 @@
+openapi: 3.0.3
+info: { title: Communication API, version: 1.0.0 }
+servers: [ { url: https://your-domain.com/api/v1 } ]
+tags: [ { name: Communications } ]
+security: [ { bearerAuth: [] } ]
+
+paths:
+  /communications:
+    get:
+      tags: [Communications]
+      summary: List all communications
+      parameters:
+        - in: query
+          name: page
+          schema: { type: integer, default: 1 }
+        - in: query
+          name: per_page
+          schema: { type: integer, default: 20 }
+        - in: query
+          name: sender_id
+          schema: { type: integer }
+        - in: query
+          name: receiver_id
+          schema: { type: integer }
+      responses:
+        "200": { description: Communications retrieved successfully }
+
+  /communications/send:
+    post:
+      tags: [Communications]
+      summary: Send a new message
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: '#/components/schemas/CommunicationSend' }
+      responses:
+        "201": { description: Message sent successfully }
+        "422": { description: Validation error }
+
+  /communications/conversation:
+    get:
+      tags: [Communications]
+      summary: Get conversation between two users
+      parameters:
+        - in: query
+          name: sender_id
+          required: true
+          schema: { type: integer }
+        - in: query
+          name: receiver_id
+          required: true
+          schema: { type: integer }
+      responses:
+        "200": { description: Conversation retrieved }
+
+  /communications/{id}:
+    delete:
+      tags: [Communications]
+      summary: Delete a message
+      parameters:
+        - in: path
+          name: id
+          required: true
+          schema: { type: integer }
+      responses:
+        "200": { description: Message deleted successfully }
+        "404": { description: Message not found }
+
+components:
+  schemas:
+    CommunicationSend:
+      type: object
+      required: [sender_id, receiver_id, subject, message]
+      properties:
+        sender_id: { type: integer }
+        receiver_id: { type: integer }
+        subject: { type: string }
+        message: { type: string }