zou 0.20.83__py3-none-any.whl → 0.20.84__py3-none-any.whl

zou/app/blueprints/crud/project_status.py

@@ -1,3 +1,5 @@
+from flask_jwt_extended import jwt_required
+
 from zou.app.models.project_status import ProjectStatus
 from zou.app.blueprints.crud.base import BaseModelResource, BaseModelsResource
 
@@ -9,6 +11,130 @@ class ProjectStatussResource(BaseModelsResource):
     def check_read_permissions(self, options=None):
         return True
 
+    @jwt_required()
+    def get(self):
+        """
+        Get project statuses
+        ---
+        tags:
+          - Crud
+        description: Retrieve all project statuses. Supports filtering
+          via query parameters and pagination.
+        parameters:
+          - in: query
+            name: page
+            required: false
+            schema:
+              type: integer
+            example: 1
+            description: Page number for pagination
+          - in: query
+            name: limit
+            required: false
+            schema:
+              type: integer
+            example: 50
+            description: Number of results per page
+          - in: query
+            name: relations
+            required: false
+            schema:
+              type: boolean
+            default: false
+            example: false
+            description: Whether to include relations
+        responses:
+            200:
+              description: Project statuses retrieved successfully
+              content:
+                application/json:
+                  schema:
+                    oneOf:
+                      - type: array
+                        items:
+                          type: object
+                      - type: object
+                        properties:
+                          data:
+                            type: array
+                            items:
+                              type: object
+                            example: []
+                          total:
+                            type: integer
+                            example: 100
+                          nb_pages:
+                            type: integer
+                            example: 2
+                          limit:
+                            type: integer
+                            example: 50
+                          offset:
+                            type: integer
+                            example: 0
+                          page:
+                            type: integer
+                            example: 1
+            400:
+              description: Invalid filter format or query error
+        """
+        return super().get()
+
+    @jwt_required()
+    def post(self):
+        """
+        Create project status
+        ---
+        tags:
+          - Crud
+        description: Create a new project status with data provided in
+          the request body. JSON format is expected.
+        requestBody:
+          required: true
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - name
+                properties:
+                  name:
+                    type: string
+                    example: Open
+                  color:
+                    type: string
+                    example: "#00FF00"
+        responses:
+            201:
+              description: Project status created successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      name:
+                        type: string
+                        example: Open
+                      color:
+                        type: string
+                        example: "#00FF00"
+                      created_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+                      updated_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+            400:
+              description: Invalid data format or validation error
+        """
+        return super().post()
+
 
 class ProjectStatusResource(BaseModelResource):
     def __init__(self):
@@ -16,3 +142,145 @@ class ProjectStatusResource(BaseModelResource):
 
     def check_read_permissions(self, instance):
         return True
+
+    @jwt_required()
+    def get(self, instance_id):
+        """
+        Get project status
+        ---
+        tags:
+          - Crud
+        description: Retrieve a project status by its ID and return it
+          as a JSON object. Supports including relations.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+          - in: query
+            name: relations
+            required: false
+            schema:
+              type: boolean
+            default: true
+            example: true
+            description: Whether to include relations
+        responses:
+            200:
+              description: Project status retrieved successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      name:
+                        type: string
+                        example: Open
+                      color:
+                        type: string
+                        example: "#00FF00"
+                      created_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+                      updated_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+            400:
+              description: Invalid ID format or query error
+        """
+        return super().get(instance_id)
+
+    @jwt_required()
+    def put(self, instance_id):
+        """
+        Update project status
+        ---
+        tags:
+          - Crud
+        description: Update a project status with data provided in the
+          request body. JSON format is expected.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+        requestBody:
+          required: true
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  name:
+                    type: string
+                    example: Closed
+                  color:
+                    type: string
+                    example: "#FF0000"
+        responses:
+            200:
+              description: Project status updated successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      name:
+                        type: string
+                        example: Closed
+                      color:
+                        type: string
+                        example: "#FF0000"
+                      created_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+                      updated_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T11:00:00Z"
+            400:
+              description: Invalid data format or validation error
+        """
+        return super().put(instance_id)
+
+    @jwt_required()
+    def delete(self, instance_id):
+        """
+        Delete project status
+        ---
+        tags:
+          - Crud
+        description: Delete a project status by its ID. Returns empty
+          response on success.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+        responses:
+            204:
+              description: Project status deleted successfully
+            400:
+              description: Integrity error or cannot delete
+        """
+        return super().delete(instance_id)

zou/app/blueprints/crud/salary_scale.py

@@ -21,16 +21,42 @@ class SalaryScalesResource(BaseModelsResource):
     @jwt_required()
     def get(self):
         """
-        Retrieve all salary scale entries.
+        Get salary scales
         ---
         tags:
           - Crud
-        description: Retrieve all salary scale entries.
+        description: Retrieve all salary scale entries. Automatically
+          creates missing combinations of department, position, and
+          seniority.
         responses:
             200:
-                description: All salary scale entries
-            403:
-                description: Permission denied
+              description: Salary scales retrieved successfully
+              content:
+                application/json:
+                  schema:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                          format: uuid
+                          example: a24a6ea4-ce75-4665-a070-57453082c25
+                        department_id:
+                          type: string
+                          format: uuid
+                          example: b24a6ea4-ce75-4665-a070-57453082c25
+                        position:
+                          type: string
+                          example: artist
+                        seniority:
+                          type: string
+                          example: junior
+                        rate:
+                          type: number
+                          example: 50.0
+            400:
+              description: Query error
         """
         self.check_read_permissions()
         query = self.model.query
@@ -71,3 +97,157 @@ class SalaryScaleResource(BaseModelResource):
 
     def __init__(self):
         BaseModelResource.__init__(self, SalaryScale)
+
+    @jwt_required()
+    def get(self, instance_id):
+        """
+        Get salary scale
+        ---
+        tags:
+          - Crud
+        description: Retrieve a salary scale by its ID and return it as
+          a JSON object. Supports including relations.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+          - in: query
+            name: relations
+            required: false
+            schema:
+              type: boolean
+            default: true
+            example: true
+            description: Whether to include relations
+        responses:
+            200:
+              description: Salary scale retrieved successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      department_id:
+                        type: string
+                        format: uuid
+                        example: b24a6ea4-ce75-4665-a070-57453082c25
+                      position:
+                        type: string
+                        example: artist
+                      seniority:
+                        type: string
+                        example: junior
+                      rate:
+                        type: number
+                        example: 50.0
+                      created_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+                      updated_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+            400:
+              description: Invalid ID format or query error
+        """
+        return super().get(instance_id)
+
+    @jwt_required()
+    def put(self, instance_id):
+        """
+        Update salary scale
+        ---
+        tags:
+          - Crud
+        description: Update a salary scale with data provided in the
+          request body. JSON format is expected. Department ID cannot
+          be changed.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+        requestBody:
+          required: true
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  rate:
+                    type: number
+                    example: 55.0
+        responses:
+            200:
+              description: Salary scale updated successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      department_id:
+                        type: string
+                        format: uuid
+                        example: b24a6ea4-ce75-4665-a070-57453082c25
+                      position:
+                        type: string
+                        example: artist
+                      seniority:
+                        type: string
+                        example: junior
+                      rate:
+                        type: number
+                        example: 55.0
+                      created_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T10:30:00Z"
+                      updated_at:
+                        type: string
+                        format: date-time
+                        example: "2024-01-15T11:00:00Z"
+            400:
+              description: Invalid data format or validation error
+        """
+        return super().put(instance_id)
+
+    @jwt_required()
+    def delete(self, instance_id):
+        """
+        Delete salary scale
+        ---
+        tags:
+          - Crud
+        description: Delete a salary scale by its ID. Returns empty
+          response on success.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+        responses:
+            204:
+              description: Salary scale deleted successfully
+            400:
+              description: Integrity error or cannot delete
+        """
+        return super().delete(instance_id)