feat(eap): add eap options endpoint

Author: susilnem

eap/enums.py

@@ -4,12 +4,10 @@
     "eap_status": models.EAPStatus,
     "eap_type": models.EAPType,
     "sector": models.PlannedOperation.Sector,
-    "sector_apcode": models.PlannedOperation.APCode,
     "timeframe": models.TimeFrame,
     "years_timeframe_value": models.YearsTimeFrameChoices,
     "months_timeframe_value": models.MonthsTimeFrameChoices,
     "days_timeframe_value": models.DaysTimeFrameChoices,
     "hours_timeframe_value": models.HoursTimeFrameChoices,
     "approach": models.EnablingApproach.Approach,
-    "approach_apcode": models.EnablingApproach.APCode,
 }

eap/models.py

@@ -391,19 +391,21 @@ class Sector(models.IntegerChoices):
         ENVIRONMENT_SUSTAINABILITY = 111, _("Environment Sustainability")
         COMMUNITY_ENGAGEMENT_AND_ACCOUNTABILITY = 112, _("Community Engagement And Accountability")
 
-    # NOTE: Use integer values directly in APCode rather than referencing `Sector` directly
-    class APCode(models.IntegerChoices):
-        SHELTER_SETTLEMENT_AND_HOUSING = 101, _("AP101, AP103, AP104")
-        LIVELIHOODS = 102, _("AP007")
-        PROTECTION_GENDER_AND_INCLUSION = 103, _("AP114, AP116, AP117")
-        HEALTH_AND_CARE = 104, _("AP107, AP108, AP109")
-        RISK_REDUCTION_CLIMATE_ADAPTATION_AND_RECOVERY = 105, _("AP101, AP103, AP104, AP105, AP106")
-        MULTIPURPOSE_CASH = 106, _("AP081")
-        WATER_SANITATION_AND_HYGIENE = 107, _("AP110, AP111")
-        EDUCATION = 109, _("AP115")
-        MIGRATION = 110, _("AP112, AP113")
-        ENVIRONMENT_SUSTAINABILITY = 111, _("AP102")
-        COMMUNITY_ENGAGEMENT_AND_ACCOUNTABILITY = 112, _("AP129")
+        @classmethod
+        def get_sector_ap_codes(cls) -> dict[int, list[str]]:
+            return {
+                cls.SHELTER_SETTLEMENT_AND_HOUSING: ["AP101", "AP103", "AP104"],
+                cls.LIVELIHOODS: ["AP007"],
+                cls.PROTECTION_GENDER_AND_INCLUSION: ["AP114", "AP116", "AP117"],
+                cls.HEALTH_AND_CARE: ["AP107", "AP108", "AP109"],
+                cls.RISK_REDUCTION_CLIMATE_ADAPTATION_AND_RECOVERY: ["AP101", "AP103", "AP104", "AP105", "AP106"],
+                cls.MULTIPURPOSE_CASH: ["AP081"],
+                cls.WATER_SANITATION_AND_HYGIENE: ["AP110", "AP111"],
+                cls.EDUCATION: ["AP115"],
+                cls.MIGRATION: ["AP112", "AP113"],
+                cls.ENVIRONMENT_SUSTAINABILITY: ["AP102"],
+                cls.COMMUNITY_ENGAGEMENT_AND_ACCOUNTABILITY: ["AP129"],
+            }
 
     sector = models.IntegerField(choices=Sector.choices, verbose_name=_("sector"))
     people_targeted = models.IntegerField(verbose_name=_("People Targeted"))
@@ -451,14 +453,21 @@ class Approach(models.IntegerChoices):
         NATIONAL_SOCIETY_STRENGTHENING = 20, _("National Society Strengthening")
         PARTNERSHIP_AND_COORDINATION = 30, _("Partnership And Coordination")
 
-    # NOTE: AP Codes are read only in EAP forms and passed through ENUMS for now.
-    # They are not stored in the database but are derived from the Approach field. Make sure to keep them in sync.
-    class APCode(models.IntegerChoices):
-        SECRETARIAT_SERVICES = 10, _("AP122")
-        NATIONAL_SOCIETY_STRENGTHENING = 20, _("AP124, AP125, AP126")
-        PARTNERSHIP_AND_COORDINATION = 30, _(
-            "AP049, AP118, AP119, AP120, AP121, AP127, AP128"
-        )
+        @classmethod
+        def get_approach_ap_codes(cls) -> dict[int, list[str]]:
+            return {
+                cls.SECRETARIAT_SERVICES: ["AP122"],
+                cls.NATIONAL_SOCIETY_STRENGTHENING: ["AP124", "AP125", "AP126"],
+                cls.PARTNERSHIP_AND_COORDINATION: [
+                    "AP049",
+                    "AP118",
+                    "AP119",
+                    "AP120",
+                    "AP121",
+                    "AP127",
+                    "AP128",
+                ],
+            }
 
     approach = models.IntegerField(choices=Approach.choices, verbose_name=_("Approach"))
     budget_per_approach = models.IntegerField(verbose_name=_("Budget per approach (CHF)"))

eap/serializers.py

@@ -1196,3 +1196,8 @@ def update(self, instance: EAPRegistration, validated_data: dict[str, typing.Any
             transaction.on_commit(lambda: send_approved_email.delay(eap_registration_id))
 
         return updated_instance
+
+
+class EAPOptionsSerializer(serializers.Serializer):
+    sector_ap_codes = serializers.DictField(child=serializers.ListField(child=serializers.CharField()))
+    approach_ap_codes = serializers.DictField(child=serializers.ListField(child=serializers.CharField()))

eap/views.py

@@ -5,6 +5,7 @@
 from drf_spectacular.utils import OpenApiParameter, extend_schema
 from rest_framework import mixins, permissions, response, status, viewsets
 from rest_framework.decorators import action
+from rest_framework.generics import GenericAPIView
 
 from eap.filter_set import (
     EAPRegistrationFilterSet,
@@ -32,6 +33,7 @@
     EAPFileInputSerializer,
     EAPFileSerializer,
     EAPGlobalFilesSerializer,
+    EAPOptionsSerializer,
     EAPRegistrationSerializer,
     EAPShareUserSerializer,
     EAPStatusSerializer,
@@ -512,3 +514,15 @@ def retrieve(self, request, *args, **kwargs):
             )
         serializer = EAPGlobalFilesSerializer({"url": request.build_absolute_uri(static(self.template_map[template_type]))})
         return response.Response(serializer.data)
+
+
+class EAPOptionsView(GenericAPIView):
+    permission_classes = [permissions.IsAuthenticated, DenyGuestUserPermission]
+    serializer_class = EAPOptionsSerializer
+
+    def get(self, request, *args, **kwargs):
+        data = {
+            "sector_ap_codes": PlannedOperation.Sector.get_sector_ap_codes(),
+            "approach_ap_codes": EnablingApproach.Approach.get_approach_ap_codes(),
+        }
+        return response.Response(self.get_serializer(data).data)

main/urls.py

@@ -222,6 +222,8 @@
     url(r"^api/v2/brief", Brief.as_view()),
     url(r"^api/v2/erutype", ERUTypes.as_view()),
     url(r"^api/v2/export-eru-readiness", deployment_views.ExportERUReadinessView.as_view()),
+    # EAP
+    url(r"^api/v2/eap/options/", eap_views.EAPOptionsView.as_view()),
     url(r"^api/v2/recentaffected", RecentAffecteds.as_view()),
     url(r"^api/v2/fieldreportstatus", FieldReportStatuses.as_view()),
     url(r"^api/v2/primarysector", ProjectPrimarySectors.as_view()),