feat(overviews): Add API overview endpoints for findings and severity

.github/workflows/api-pull-request.yml

@@ -1,4 +1,4 @@
-name: "API - Pull Request" 
+name: "API - Pull Request"
 
 on:
   push:
@@ -148,7 +148,7 @@ jobs:
         working-directory: ./api
         if: steps.are-non-ignored-files-changed.outputs.any_changed == 'true'
         run: |
-          poetry run pytest -n auto --cov=./src/backend --cov-report=xml src/backend
+          poetry run pytest --cov=./src/backend --cov-report=xml src/backend
       - name: Upload coverage reports to Codecov
         if: steps.are-non-ignored-files-changed.outputs.any_changed == 'true'
         uses: codecov/codecov-action@v5

.gitignore

@@ -12,6 +12,7 @@ build/
 /dist/
 *.egg-info/
 */__pycache__/*.pyc
+.idea/
 
 # Session
 Session.vim

.pre-commit-config.yaml

@@ -97,12 +97,13 @@ repos:
       - id: safety
         name: safety
         description: "Safety is a tool that checks your installed dependencies for known security vulnerabilities"
-        entry: bash -c 'safety check --ignore 70612'
+        entry: bash -c 'safety check --ignore 70612,66963'
         language: system
 
       - id: vulture
         name: vulture
         description: "Vulture finds unused code in Python programs."
         entry: bash -c 'vulture --exclude "contrib" --min-confidence 100 .'
+        exclude: 'api/src/backend/'
         language: system
         files: '.*\.py'

api/src/backend/api/filters.py

@@ -4,47 +4,48 @@
 from django.db.models import Q
 from django_filters.rest_framework import (
     BaseInFilter,
-    FilterSet,
     BooleanFilter,
     CharFilter,
-    UUIDFilter,
-    DateFilter,
     ChoiceFilter,
+    DateFilter,
+    FilterSet,
+    UUIDFilter,
 )
 from rest_framework_json_api.django_filters.backends import DjangoFilterBackend
 from rest_framework_json_api.serializers import ValidationError
 
 from api.db_utils import (
-    ProviderEnumField,
     FindingDeltaEnumField,
-    StatusEnumField,
-    SeverityEnumField,
     InvitationStateEnumField,
+    ProviderEnumField,
+    SeverityEnumField,
+    StatusEnumField,
 )
 from api.models import (
-    User,
+    ComplianceOverview,
+    Finding,
+    Invitation,
     Membership,
     Provider,
     ProviderGroup,
+    ProviderSecret,
     Resource,
     ResourceTag,
     Scan,
-    Task,
-    StateChoices,
-    Finding,
+    ScanSummary,
     SeverityChoices,
+    StateChoices,
     StatusChoices,
-    ProviderSecret,
-    Invitation,
-    ComplianceOverview,
+    Task,
+    User,
 )
 from api.rls import Tenant
 from api.uuid_utils import (
     datetime_to_uuid7,
-    uuid7_start,
+    transform_into_uuid7,
     uuid7_end,
     uuid7_range,
-    transform_into_uuid7,
+    uuid7_start,
 )
 from api.v1.serializers import TaskBase
 
@@ -57,6 +58,13 @@
         """
         return None
 
+    def get_filterset_class(self, view, queryset=None):
+        # Check if the view has 'get_filterset_class' method
+        if hasattr(view, "get_filterset_class"):
+            return view.get_filterset_class()
+        # Fallback to the default implementation
+        return super().get_filterset_class(view, queryset)
+
 
 class UUIDInFilter(BaseInFilter, UUIDFilter):
     pass
@@ -482,3 +490,28 @@
             "version": ["exact", "icontains"],
             "region": ["exact", "icontains", "in"],
         }
+
+
+class ScanSummaryFilter(FilterSet):
+    inserted_at = DateFilter(field_name="inserted_at", lookup_expr="date")
+    provider_id = UUIDFilter(field_name="scan__provider__id", lookup_expr="exact")
+    provider_type = ChoiceFilter(
+        field_name="scan__provider__provider", choices=Provider.ProviderChoices.choices
+    )
+    provider_type__in = ChoiceInFilter(
+        field_name="scan__provider__provider", choices=Provider.ProviderChoices.choices
+    )
+    region = CharFilter(field_name="region")
+    muted_findings = BooleanFilter(method="filter_muted_findings")
+
+    def filter_muted_findings(self, queryset, name, value):
+        if not value:
+            return queryset.exclude(muted__gt=0)
+        return queryset
+
+    class Meta:
+        model = ScanSummary
+        fields = {
+            "inserted_at": ["date", "gte", "lte"],
+            "region": ["exact", "icontains", "in"],
+        }