Files
state-corp-backend/src/apps/organization/analytics_views.py
Aleksandr Meshchriakov 9eb41f6fd4
All checks were successful
CI/CD Pipeline / Run Tests (push) Successful in 2m26s
CI/CD Pipeline / Code Quality Checks (push) Successful in 5m3s
CI/CD Pipeline / Build and Push Dev Images (push) Successful in 32s
CI/CD Pipeline / Deploy Dev via Compose (push) Successful in 31s
feat: address QA analytics and report upload feedback
2026-07-19 13:32:56 +02:00

181 lines
6.8 KiB
Python

"""API views for organization analytics endpoints."""
from __future__ import annotations
from apps.organization.analytics_services import (
DashboardAnalyticsService,
OrganizationAnalyticsService,
)
from apps.organization.contract_serializers import (
DashboardResponseSerializer,
EconomicsResponseSerializer,
EquipmentResponseSerializer,
FinancialSummaryResponseSerializer,
ForecastResponseSerializer,
PersonnelResponseSerializer,
ProductsResponseSerializer,
RiskProfileResponseSerializer,
)
from apps.organization.models import Organization
from apps.organization.query_serializers import (
DashboardQuerySerializer,
EconomicsQuerySerializer,
EquipmentQuerySerializer,
FinancialSummaryQuerySerializer,
ForecastQuerySerializer,
PersonnelQuerySerializer,
ProductsQuerySerializer,
)
from django.shortcuts import get_object_or_404
from drf_yasg.utils import swagger_auto_schema
from rest_framework.permissions import IsAuthenticated
from rest_framework.response import Response
from rest_framework.views import APIView
class OrganizationAnalyticsBaseView(APIView):
"""Base view for endpoints bound to a single organization."""
permission_classes = [IsAuthenticated]
def get_organization(self, organization_id) -> Organization:
return get_object_or_404(
Organization.objects.filter(mostovik_uid__isnull=False),
id=organization_id,
)
class AnalyticsDashboardView(APIView):
"""Dashboard analytics grouped by organization cluster."""
permission_classes = [IsAuthenticated]
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Сводная аналитика по корпорации",
query_serializer=DashboardQuerySerializer,
responses={200: DashboardResponseSerializer},
)
def get(self, request):
serializer = DashboardQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = DashboardAnalyticsService.get_dashboard(
corporation_scope=serializer.validated_data.get("corporation_scope")
)
return Response(payload)
class OrganizationFinancialSummaryView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Финансовая сводка организации",
query_serializer=FinancialSummaryQuerySerializer,
responses={200: FinancialSummaryResponseSerializer},
)
def get(self, request, organization_id):
serializer = FinancialSummaryQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = OrganizationAnalyticsService.get_financial_summary(
organization=self.get_organization(organization_id),
**serializer.validated_data,
)
return Response(payload)
class OrganizationEconomicsView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Экономическая аналитика организации",
query_serializer=EconomicsQuerySerializer,
responses={200: EconomicsResponseSerializer},
)
def get(self, request, organization_id):
serializer = EconomicsQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = OrganizationAnalyticsService.get_economics(
organization=self.get_organization(organization_id),
**serializer.validated_data,
)
return Response(payload)
class OrganizationPersonnelView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Кадровая аналитика организации",
query_serializer=PersonnelQuerySerializer,
responses={200: PersonnelResponseSerializer},
)
def get(self, request, organization_id):
serializer = PersonnelQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = OrganizationAnalyticsService.get_personnel(
organization=self.get_organization(organization_id),
**serializer.validated_data,
)
return Response(payload)
class OrganizationEquipmentView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Аналитика по оборудованию",
query_serializer=EquipmentQuerySerializer,
responses={200: EquipmentResponseSerializer},
)
def get(self, request, organization_id):
serializer = EquipmentQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = OrganizationAnalyticsService.get_equipment(
organization=self.get_organization(organization_id),
**serializer.validated_data,
)
return Response(payload)
class OrganizationProductsView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Аналитика по продукции",
query_serializer=ProductsQuerySerializer,
responses={200: ProductsResponseSerializer},
)
def get(self, request, organization_id):
serializer = ProductsQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = OrganizationAnalyticsService.get_products(
organization=self.get_organization(organization_id),
**serializer.validated_data,
)
return Response(payload)
class OrganizationRiskProfileView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Риск-профиль организации",
responses={200: RiskProfileResponseSerializer},
)
def get(self, request, organization_id):
payload = OrganizationAnalyticsService.get_risk_profile(
organization=self.get_organization(organization_id)
)
return Response(payload)
class OrganizationForecastView(OrganizationAnalyticsBaseView):
@swagger_auto_schema(
tags=["Аналитика"],
operation_summary="Прогнозная аналитика организации",
query_serializer=ForecastQuerySerializer,
responses={200: ForecastResponseSerializer},
)
def get(self, request, organization_id):
serializer = ForecastQuerySerializer(data=request.query_params)
serializer.is_valid(raise_exception=True)
payload = OrganizationAnalyticsService.get_forecast(
organization=self.get_organization(organization_id),
**serializer.validated_data,
)
return Response(payload)