feat: Create reports for tracked private projects

Relates to #81 (closed)

spec/openapi.yaml

@@ -93,6 +93,47 @@ paths:
         500:
           description: Error while processing data
 
+  /reports/gitlab/private-projects:
+    parameters:
+      - name: status
+        in: query
+        description: the project's current status - active/deleted
+        required: false
+        schema:
+          type: string
+      - name: since
+        in: query
+        description: Starting date range for project creation date - yyyy-MM-dd
+        required: false
+        schema:
+          type: string
+      - name: until
+        in: query
+        description: Ending date range for project creation date - yyyy-MM-dd
+        required: false
+        schema:
+          type: string
+    get:
+      tags:
+        - Private project event report
+      summary: Gitlab private project event report
+      description: Returns list of private project events using desired filters
+      responses:
+        200:
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PrivateProjectEvents"
+        400:
+          description: Bad Request - invalid non-null prams
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        500:
+          description: Error while processing request
+
 components:
   schemas:
     NullableString:
@@ -334,3 +375,55 @@ components:
             - 'null'
             - string
           description: The old path with namespace, only used in 'project_rename' hooks
+
+    PrivateProjectEvents:
+      type: array
+      items:  
+        $ref: "#/components/schemas/PrivateProjectEvent"
+
+    PrivateProjectEvent:
+      type: object
+      properties:
+        composite_id:
+          $ref: "#/components/schemas/EventCompositeId"
+        parent_project:
+          type: 
+            - integer
+            - "null"
+          description: the parent project if it exists. Indicates this project is a fork
+        creation_date:
+          type: string
+          description: The project creation date
+        deletion_date:
+          type: 
+            - string
+            - "null"
+          description: the project deletion date if it was deleted
+
+    EventCompositeId:
+      type: object
+      properties:
+        user_id:
+          type: integer
+          description: the project creator's GitLab id
+        project_id: 
+          type: integer
+          description: The project GitLab id
+        project_path:
+          type: string
+          description: the project's path with namespace
+
+    Error:
+      type: object
+      properties:
+        status_code:
+          type: integer
+          description: HTTP response code
+        message:
+          type: string
+          description: Message containing error information
+        url:
+          type:
+            - string
+            - "null"
+          description: The URL