"""Query serializers for organization analytics endpoints.""" from apps.organization.models import CorporationScope from apps.organization.scope_utils import SCOPE_ALIASES from rest_framework import serializers class AliasChoiceField(serializers.ChoiceField): def __init__(self, *args, aliases: dict[str, str] | None = None, **kwargs): self.aliases = aliases or {} super().__init__(*args, **kwargs) def to_internal_value(self, data): normalized = str(data).strip().lower() if normalized in self.aliases: data = self.aliases[normalized] return super().to_internal_value(data) class DashboardQuerySerializer(serializers.Serializer): corporation_scope = AliasChoiceField( choices=CorporationScope.choices, aliases=SCOPE_ALIASES, required=False ) class FinancialSummaryQuerySerializer(serializers.Serializer): report_year = serializers.IntegerField(min_value=2000) report_quarter = serializers.IntegerField( min_value=1, max_value=4, required=False, allow_null=True, ) class EconomicsQuerySerializer(serializers.Serializer): group = serializers.ChoiceField( choices=( ("efficiency", "efficiency"), ("profitability", "profitability"), ("debt", "debt"), ("investment", "investment"), ) ) from_year = serializers.IntegerField(min_value=2000) to_year = serializers.IntegerField(min_value=2000) def validate(self, attrs): if attrs["from_year"] > attrs["to_year"]: raise serializers.ValidationError( "`from_year` must be less than or equal to `to_year`" ) return attrs class PersonnelQuerySerializer(serializers.Serializer): report_year = serializers.IntegerField(min_value=2000) history_years = serializers.IntegerField(min_value=1, max_value=10, default=3) class EquipmentQuerySerializer(serializers.Serializer): report_year = serializers.IntegerField(min_value=2000) class ProductsQuerySerializer(serializers.Serializer): report_year = serializers.IntegerField(min_value=2000) frequency = AliasChoiceField( choices=( ("quarterly", "quarterly"), ("annual", "annual"), ("semiannual", "semiannual"), ("monthly", "monthly"), ), aliases={ "semi-annual": "semiannual", "half-year": "semiannual", "half_year": "semiannual", "halfyear": "semiannual", "halfyearly": "semiannual", "half_yearly": "semiannual", "month": "monthly", }, ) price_mode = serializers.ChoiceField( choices=(("actual", "actual"), ("fixed", "fixed")) ) class ForecastQuerySerializer(serializers.Serializer): scenario = serializers.ChoiceField( choices=( ("base", "base"), ("optimistic", "optimistic"), ("conservative", "conservative"), ), default="base", ) horizon_years = serializers.IntegerField(min_value=1, max_value=10, default=3)