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

zou/app/blueprints/crud/task_type.py

@@ -1,3 +1,5 @@
+from flask_jwt_extended import jwt_required
+
 from zou.app.models.task_type import TaskType
 from zou.app.services.exception import WrongParameterException
 from zou.app.services import tasks_service
@@ -12,6 +14,138 @@ class TaskTypesResource(BaseModelsResource):
     def check_read_permissions(self, options=None):
         return True
 
+    @jwt_required()
+    def get(self):
+        """
+        Get task types
+        ---
+        tags:
+          - Crud
+        description: Retrieve all task types. 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: Task types 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 task type
+        ---
+        tags:
+          - Crud
+        description: Create a new task type with data provided in the
+          request body. JSON format is expected. Task type names must
+          be unique.
+        requestBody:
+          required: true
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - name
+                  - for_entity
+                properties:
+                  name:
+                    type: string
+                    example: Animation
+                  for_entity:
+                    type: string
+                    example: Shot
+                  color:
+                    type: string
+                    example: "#FF5733"
+        responses:
+            201:
+              description: Task type created successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      name:
+                        type: string
+                        example: Animation
+                      for_entity:
+                        type: string
+                        example: Shot
+                      color:
+                        type: string
+                        example: "#FF5733"
+                      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 task type name already exists
+        """
+        return super().post()
+
     def update_data(self, data):
         data = super().update_data(data)
         name = data.get("name", None)
@@ -34,6 +168,155 @@ class TaskTypeResource(BaseModelResource):
     def check_read_permissions(self, instance):
         return True
 
+    @jwt_required()
+    def get(self, instance_id):
+        """
+        Get task type
+        ---
+        tags:
+          - Crud
+        description: Retrieve a task type 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: Task type retrieved successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      name:
+                        type: string
+                        example: Animation
+                      for_entity:
+                        type: string
+                        example: Shot
+                      color:
+                        type: string
+                        example: "#FF5733"
+                      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 task type
+        ---
+        tags:
+          - Crud
+        description: Update a task type with data provided in the
+          request body. JSON format is expected. Task type names must
+          be unique.
+        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: Updated Animation
+                  color:
+                    type: string
+                    example: "#FF5734"
+        responses:
+            200:
+              description: Task type updated successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      name:
+                        type: string
+                        example: Updated Animation
+                      for_entity:
+                        type: string
+                        example: Shot
+                      color:
+                        type: string
+                        example: "#FF5734"
+                      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 task type name already exists
+        """
+        return super().put(instance_id)
+
+    @jwt_required()
+    def delete(self, instance_id):
+        """
+        Delete task type
+        ---
+        tags:
+          - Crud
+        description: Delete a task type 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: Task type deleted successfully
+            400:
+              description: Integrity error or cannot delete
+        """
+        return super().delete(instance_id)
+
     def update_data(self, data, instance_id):
         data = super().update_data(data, instance_id)
         name = data.get("name", None)

zou/app/blueprints/crud/time_spent.py

@@ -1,4 +1,5 @@
 from flask import abort
+from flask_jwt_extended import jwt_required
 
 from sqlalchemy import func
 
@@ -15,6 +16,169 @@ class TimeSpentsResource(BaseModelsResource):
     def __init__(self):
         BaseModelsResource.__init__(self, TimeSpent)
 
+    @jwt_required()
+    def get(self):
+        """
+        Get time spents
+        ---
+        tags:
+          - Crud
+        description: Retrieve all time spent records. Supports filtering
+          via query parameters and pagination. Supports date range
+          filtering with start_date and end_date.
+        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
+          - in: query
+            name: start_date
+            required: false
+            schema:
+              type: string
+              format: date
+            example: "2024-01-01"
+            description: Start date for date range filter
+          - in: query
+            name: end_date
+            required: false
+            schema:
+              type: string
+              format: date
+            example: "2024-01-31"
+            description: End date for date range filter
+        responses:
+            200:
+              description: Time spent records 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 time spent
+        ---
+        tags:
+          - Crud
+        description: Create a new time spent record with data provided
+          in the request body. JSON format is expected. Updates task
+          duration automatically.
+        requestBody:
+          required: true
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - task_id
+                  - person_id
+                  - date
+                  - duration
+                properties:
+                  task_id:
+                    type: string
+                    format: uuid
+                    example: a24a6ea4-ce75-4665-a070-57453082c25
+                  person_id:
+                    type: string
+                    format: uuid
+                    example: b24a6ea4-ce75-4665-a070-57453082c25
+                  date:
+                    type: string
+                    format: date
+                    example: "2024-01-15"
+                  duration:
+                    type: number
+                    example: 8.5
+        responses:
+            201:
+              description: Time spent record created successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      task_id:
+                        type: string
+                        format: uuid
+                        example: b24a6ea4-ce75-4665-a070-57453082c25
+                      person_id:
+                        type: string
+                        format: uuid
+                        example: c24a6ea4-ce75-4665-a070-57453082c25
+                      date:
+                        type: string
+                        format: date
+                        example: "2024-01-15"
+                      duration:
+                        type: number
+                        example: 8.5
+                      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()
+
     def apply_filters(self, query, options):
         query = super(TimeSpentsResource, self).apply_filters(query, options)
         start_date = options.get("start_date", None)
@@ -62,6 +226,169 @@ class TimeSpentResource(BaseModelResource):
             instance_dict["task_id"], instance_dict["person_id"]
         )
 
+    @jwt_required()
+    def get(self, instance_id):
+        """
+        Get time spent
+        ---
+        tags:
+          - Crud
+        description: Retrieve a time spent record 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: Time spent record retrieved successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      task_id:
+                        type: string
+                        format: uuid
+                        example: b24a6ea4-ce75-4665-a070-57453082c25
+                      person_id:
+                        type: string
+                        format: uuid
+                        example: c24a6ea4-ce75-4665-a070-57453082c25
+                      date:
+                        type: string
+                        format: date
+                        example: "2024-01-15"
+                      duration:
+                        type: number
+                        example: 8.5
+                      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 time spent
+        ---
+        tags:
+          - Crud
+        description: Update a time spent record with data provided in
+          the request body. JSON format is expected. Updates task
+          duration automatically.
+        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:
+                  date:
+                    type: string
+                    format: date
+                    example: "2024-01-16"
+                  duration:
+                    type: number
+                    example: 7.5
+        responses:
+            200:
+              description: Time spent record updated successfully
+              content:
+                application/json:
+                  schema:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        format: uuid
+                        example: a24a6ea4-ce75-4665-a070-57453082c25
+                      task_id:
+                        type: string
+                        format: uuid
+                        example: b24a6ea4-ce75-4665-a070-57453082c25
+                      person_id:
+                        type: string
+                        format: uuid
+                        example: c24a6ea4-ce75-4665-a070-57453082c25
+                      date:
+                        type: string
+                        format: date
+                        example: "2024-01-16"
+                      duration:
+                        type: number
+                        example: 7.5
+                      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 time spent
+        ---
+        tags:
+          - Crud
+        description: Delete a time spent record by its ID. Returns
+          empty response on success. Updates task duration
+          automatically.
+        parameters:
+          - in: path
+            name: instance_id
+            required: true
+            schema:
+              type: string
+              format: uuid
+            example: a24a6ea4-ce75-4665-a070-57453082c25
+        responses:
+            204:
+              description: Time spent record deleted successfully
+            400:
+              description: Integrity error or cannot delete
+        """
+        return super().delete(instance_id)
+
     def post_update(self, instance_dict, data):
         task = Task.get(instance_dict["task_id"])
         task.duration = sum(