feat: add room management functionality

docs/swagger/swagger.yaml

@@ -1,5 +1,20 @@
 basePath: /api/v1
 definitions:
+  models.Room:
+    properties:
+      createdAt:
+        type: string
+      description:
+        type: string
+      id:
+        type: integer
+      name:
+        type: string
+      updatedAt:
+        type: string
+      warehouseId:
+        type: integer
+    type: object
   models.Warehouse:
     properties:
       address:
@@ -31,7 +46,19 @@ definitions:
     - password
     - username
     type: object
-  requests.CUWarehouseRequest:
+  requests.CreateRoomRequest:
+    properties:
+      description:
+        type: string
+      name:
+        type: string
+      warehouseId:
+        type: integer
+    required:
+    - name
+    - warehouseId
+    type: object
+  requests.CreateWarehouseRequest:
     properties:
       address:
         type: string
@@ -43,6 +70,22 @@ definitions:
     - address
     - name
     type: object
+  requests.UpdateRoomRequest:
+    properties:
+      description:
+        type: string
+      name:
+        type: string
+    type: object
+  requests.UpdateWarehouseRequest:
+    properties:
+      address:
+        type: string
+      description:
+        type: string
+      name:
+        type: string
+    type: object
   response.ErrorResponse:
     properties:
       code:
@@ -70,11 +113,27 @@ definitions:
       id:
         type: string
     type: object
+  responses.CreateRoomResponse:
+    properties:
+      id:
+        type: integer
+    type: object
   responses.CreateWarehouseResponse:
     properties:
       id:
         type: integer
     type: object
+  responses.UpdateRoomResponse:
+    properties:
+      description:
+        type: string
+      id:
+        type: integer
+      name:
+        type: string
+      warehouseId:
+        type: integer
+    type: object
   responses.UpdateWarehouseResponse:
     properties:
       address:
@@ -149,6 +208,176 @@ paths:
       summary: Health check
       tags:
       - health
+  /v1/rooms:
+    get:
+      consumes:
+      - application/json
+      description: Retrieve a list of all rooms ordered by creation date
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.SuccessResponse'
+            - properties:
+                data:
+                  items:
+                    $ref: '#/definitions/models.Room'
+                  type: array
+              type: object
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+      summary: List all rooms
+      tags:
+      - room
+    post:
+      consumes:
+      - application/json
+      description: Create a new room with the provided details
+      parameters:
+      - description: Room request body
+        in: body
+        name: body
+        required: true
+        schema:
+          $ref: '#/definitions/requests.CreateRoomRequest'
+      produces:
+      - application/json
+      responses:
+        "201":
+          description: Created
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.SuccessResponse'
+            - properties:
+                data:
+                  $ref: '#/definitions/responses.CreateRoomResponse'
+              type: object
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+      summary: Create a new room
+      tags:
+      - room
+  /v1/rooms/{id}:
+    delete:
+      consumes:
+      - application/json
+      description: Delete a room by its unique identifier
+      parameters:
+      - description: Room ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/response.SuccessResponse'
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+      summary: Delete room
+      tags:
+      - room
+    get:
+      consumes:
+      - application/json
+      description: Retrieve a single room using its unique identifier
+      parameters:
+      - description: Room ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.SuccessResponse'
+            - properties:
+                data:
+                  $ref: '#/definitions/models.Room'
+              type: object
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+        "404":
+          description: Not Found
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+      summary: Get room by ID
+      tags:
+      - room
+    put:
+      consumes:
+      - application/json
+      description: Update an existing room by its ID. Only non-empty fields will be
+        updated.
+      parameters:
+      - description: Room ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      - description: Room request body
+        in: body
+        name: body
+        required: true
+        schema:
+          $ref: '#/definitions/requests.UpdateRoomRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.SuccessResponse'
+            - properties:
+                data:
+                  $ref: '#/definitions/responses.UpdateRoomResponse'
+              type: object
+        "400":
+          description: Bad Request
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+        "404":
+          description: Not Found
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/response.ErrorResponse'
+      summary: Update room
+      tags:
+      - room
   /v1/warehouses:
     get:
       consumes:
@@ -185,7 +414,7 @@ paths:
         name: body
         required: true
         schema:
-          $ref: '#/definitions/requests.CUWarehouseRequest'
+          $ref: '#/definitions/requests.CreateWarehouseRequest'
       produces:
       - application/json
       responses:
@@ -290,7 +519,7 @@ paths:
         name: body
         required: true
         schema:
-          $ref: '#/definitions/requests.CUWarehouseRequest'
+          $ref: '#/definitions/requests.UpdateWarehouseRequest'
       produces:
       - application/json
       responses: