Project: EAP Workflow

api/migrations/0227_alter_export_export_type.py

@@ -0,0 +1,18 @@
+# Generated by Django 4.2.19 on 2025-11-18 05:22
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('api', '0226_nsdinitiativescategory_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='export',
+            name='export_type',
+            field=models.CharField(choices=[('dref-applications', 'DREF Application'), ('dref-operational-updates', 'DREF Operational Update'), ('dref-final-reports', 'DREF Final Report'), ('old-dref-final-reports', 'Old DREF Final Report'), ('per', 'Per'), ('simplified-eap', 'Simplified EAP')], max_length=255, verbose_name='Export Type'),
+        ),
+    ]

api/migrations/0228_alter_export_export_type.py

@@ -0,0 +1,29 @@
+# Generated by Django 4.2.26 on 2025-11-26 10:03
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("api", "0227_alter_export_export_type"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="export",
+            name="export_type",
+            field=models.CharField(
+                choices=[
+                    ("dref-applications", "DREF Application"),
+                    ("dref-operational-updates", "DREF Operational Update"),
+                    ("dref-final-reports", "DREF Final Report"),
+                    ("old-dref-final-reports", "Old DREF Final Report"),
+                    ("per", "Per"),
+                    ("simplified-eap", "Simplified EAP"),
+                    ("full-eap", "Full EAP"),
+                ],
+                max_length=255,
+                verbose_name="Export Type",
+            ),
+        ),
+    ]

api/migrations/0229_alter_export_export_type.py

@@ -0,0 +1,29 @@
+# Generated by Django 4.2.26 on 2025-12-04 09:06
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("api", "0228_alter_export_export_type"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="export",
+            name="export_type",
+            field=models.CharField(
+                choices=[
+                    ("dref-applications", "DREF Application"),
+                    ("dref-operational-updates", "DREF Operational Update"),
+                    ("dref-final-reports", "DREF Final Report"),
+                    ("old-dref-final-reports", "Old DREF Final Report"),
+                    ("per", "Per"),
+                    ("simplified", "Simplified EAP"),
+                    ("full", "Full EAP"),
+                ],
+                max_length=255,
+                verbose_name="Export Type",
+            ),
+        ),
+    ]

api/models.py

@@ -2560,6 +2560,8 @@ class ExportType(models.TextChoices):
         FINAL_REPORT = "dref-final-reports", _("DREF Final Report")
         OLD_FINAL_REPORT = "old-dref-final-reports", _("Old DREF Final Report")
         PER = "per", _("Per")
+        SIMPLIFIED_EAP = "simplified", _("Simplified EAP")
+        FULL_EAP = "full", _("Full EAP")
 
     export_id = models.IntegerField(verbose_name=_("Export Id"))
     export_type = models.CharField(verbose_name=_("Export Type"), max_length=255, choices=ExportType.choices)

api/serializers.py

@@ -15,6 +15,7 @@
 from api.utils import CountryValidator, RegionValidator
 from deployments.models import EmergencyProject, Personnel, PersonnelDeployment
 from dref.models import Dref, DrefFinalReport, DrefOperationalUpdate
+from eap.models import EAPRegistration, FullEAP, SimplifiedEAP
 from lang.models import String
 from lang.serializers import ModelSerializer
 from local_units.models import DelegationOffice
@@ -2543,6 +2544,11 @@ class ExportSerializer(serializers.ModelSerializer):
     status_display = serializers.CharField(source="get_status_display", read_only=True)
     # NOTE: is_pga is used to determine if the export contains PGA or not
     is_pga = serializers.BooleanField(default=False, required=False, write_only=True)
+    # NOTE: diff is used to determine if the export is requested for diff view or not
+    # Currently only used for EAP exports
+    diff = serializers.BooleanField(default=False, required=False, write_only=True)
+    # NOTE: Version of a EAP export being requested, only applicable for full and simplified EAP exports
+    version = serializers.IntegerField(required=False, write_only=True)
 
     class Meta:
         model = Export
@@ -2558,6 +2564,7 @@ def create(self, validated_data):
         export_id = validated_data.get("export_id")
         export_type = validated_data.get("export_type")
         country_id = validated_data.get("per_country")
+        version = validated_data.pop("version", None)
         if export_type == Export.ExportType.DREF:
             title = Dref.objects.filter(id=export_id).first().title
         elif export_type == Export.ExportType.OPS_UPDATE:
@@ -2567,12 +2574,63 @@ def create(self, validated_data):
         elif export_type == Export.ExportType.PER:
             overview = Overview.objects.filter(id=export_id).first()
             title = f"{overview.country.name}-preparedness-{overview.get_phase_display()}"
+        elif export_type == Export.ExportType.SIMPLIFIED_EAP:
+            if version:
+                simplified_eap = SimplifiedEAP.objects.filter(
+                    eap_registration=export_id,
+                    version=version,
+                ).first()
+                if not simplified_eap:
+                    raise serializers.ValidationError("No Simplified EAP found for the given EAP Registration ID and version")
+            else:
+                eap_registration = EAPRegistration.objects.filter(id=export_id).first()
+                if not eap_registration:
+                    raise serializers.ValidationError("No EAP Registration found for the given ID")
+
+                simplified_eap = eap_registration.latest_simplified_eap
+                if not simplified_eap:
+                    serializers.ValidationError("No Simplified EAP found for the given EAP Registration ID")
+
+            title = (
+                f"{simplified_eap.eap_registration.national_society.name}-{simplified_eap.eap_registration.disaster_type.name}"
+            )
+        elif export_type == Export.ExportType.FULL_EAP:
+            if version:
+                full_eap = FullEAP.objects.filter(
+                    eap_registration=export_id,
+                    version=version,
+                ).first()
+                if not full_eap:
+                    raise serializers.ValidationError("No Full EAP found for the given EAP Registration ID and version")
+            else:
+                eap_registration = EAPRegistration.objects.filter(id=export_id).first()
+                if not eap_registration:
+                    raise serializers.ValidationError("No EAP Registration found for the given ID")
+
+                full_eap = eap_registration.latest_full_eap
+                if not full_eap:
+                    serializers.ValidationError("No Full EAP found for the given EAP Registration ID")
+
+            title = f"{full_eap.eap_registration.national_society.name}-{full_eap.eap_registration.disaster_type.name}"
         else:
             title = "Export"
         user = self.context["request"].user
 
         if export_type == Export.ExportType.PER:
             validated_data["url"] = f"{settings.GO_WEB_INTERNAL_URL}/countries/{country_id}/{export_type}/{export_id}/export/"
+
+        elif export_type in [
+            Export.ExportType.SIMPLIFIED_EAP,
+            Export.ExportType.FULL_EAP,
+        ]:
+            validated_data["url"] = f"{settings.GO_WEB_INTERNAL_URL}/eap/{export_id}/export/"
+            # NOTE: EAP exports with diff view only for EAPs exports
+            if version:
+                validated_data["url"] += f"?version={version}"
+            diff = validated_data.pop("diff")
+            if diff:
+                validated_data["url"] += "&diff=true" if version else "?diff=true"
+
         else:
             validated_data["url"] = f"{settings.GO_WEB_INTERNAL_URL}/{export_type}/{export_id}/export/"
 

api/tasks.py

@@ -118,6 +118,10 @@ def generate_url(url, export_id, user, title, language):
                 page.wait_for_selector("#pdf-preview-ready", state="attached", timeout=timeout)
                 if export.export_type == Export.ExportType.PER:
                     file_name = f'PER {title} ({datetime.now().strftime("%Y-%m-%d %H-%M-%S")}).pdf'
+                elif export.export_type == Export.ExportType.SIMPLIFIED_EAP:
+                    file_name = f'SIMPLIFIED EAP {title} ({datetime.now().strftime("%Y-%m-%d %H-%M-%S")}).pdf'
+                elif export.export_type == Export.ExportType.FULL_EAP:
+                    file_name = f'FULL EAP {title} ({datetime.now().strftime("%Y-%m-%d %H-%M-%S")}).pdf'
                 else:
                     file_name = f'DREF {title} ({datetime.now().strftime("%Y-%m-%d %H-%M-%S")}).pdf'
                 file = ContentFile(

docs/go-artifacts.md

@@ -27,7 +27,7 @@ This is a **GitHub repository** used to store and manage **build files**, **gene
 
 Command
 ```bash
-docker compose run --rm serve ./manage.py spectacular --file .assets/openapi-schema.yaml
+docker compose run --rm serve ./manage.py spectacular --file ./assets/openapi-schema.yaml
 ```
 
 ### 🚨 Manually added files

eap/admin.py

@@ -1 +1,168 @@
-# Register your models here.
+from django.contrib import admin
+
+from eap.models import EAPFile, EAPRegistration, FullEAP, KeyActor, SimplifiedEAP
+
+
+@admin.register(EAPFile)
+class EAPFileAdmin(admin.ModelAdmin):
+    search_fields = ("caption",)
+
+
+@admin.register(EAPRegistration)
+class DevelopmentRegistrationEAPAdmin(admin.ModelAdmin):
+    list_select_related = True
+    search_fields = (
+        "national_society__name",
+        "country__name",
+        "disaster_type__name",
+    )
+    list_filter = ("eap_type",)
+    list_display = (
+        "national_society_name",
+        "country",
+        "eap_type",
+        "disaster_type",
+    )
+    autocomplete_fields = (
+        "national_society",
+        "disaster_type",
+        "partners",
+        "created_by",
+        "modified_by",
+    )
+
+    def national_society_name(self, obj):
+        return obj.national_society.society_name
+
+    national_society_name.short_description = "National Society (NS)"
+
+    def get_queryset(self, request):
+        return (
+            super()
+            .get_queryset(request)
+            .select_related(
+                "national_society",
+                "country",
+                "disaster_type",
+                "created_by",
+                "modified_by",
+            )
+            .prefetch_related(
+                "partners",
+            )
+        )
+
+
+@admin.register(SimplifiedEAP)
+class SimplifiedEAPAdmin(admin.ModelAdmin):
+    list_select_related = True
+    search_fields = (
+        "eap_registration__country__name",
+        "eap_registration__disaster_type__name",
+    )
+    list_display = ("simplifed_eap_application", "version", "is_locked")
+    autocomplete_fields = (
+        "eap_registration",
+        "created_by",
+        "modified_by",
+        "admin2",
+    )
+    readonly_fields = (
+        "cover_image",
+        "hazard_impact_images",
+        "risk_selected_protocols_images",
+        "selected_early_actions_images",
+        "planned_operations",
+        "enable_approaches",
+        "parent",
+        "is_locked",
+        "version",
+    )
+
+    def simplifed_eap_application(self, obj):
+        return f"{obj.eap_registration.national_society.society_name} - {obj.eap_registration.disaster_type.name}"
+
+    simplifed_eap_application.short_description = "Simplified EAP Application"
+
+    def get_queryset(self, request):
+        return (
+            super()
+            .get_queryset(request)
+            .select_related(
+                "created_by",
+                "modified_by",
+                "eap_registration__country",
+                "eap_registration__national_society",
+                "eap_registration__disaster_type",
+            )
+            .prefetch_related(
+                "admin2",
+            )
+        )
+
+
+@admin.register(KeyActor)
+class KeyActorAdmin(admin.ModelAdmin):
+    list_display = ("national_society",)
+
+
+@admin.register(FullEAP)
+class FullEAPAdmin(admin.ModelAdmin):
+    list_select_related = True
+    search_fields = (
+        "eap_registration__country__name",
+        "eap_registration__disaster_type__name",
+    )
+    list_display = ("eap_registration",)
+    autocomplete_fields = (
+        "eap_registration",
+        "created_by",
+        "modified_by",
+        "admin2",
+    )
+    readonly_fields = (
+        "cover_image",
+        "planned_operations",
+        "enable_approaches",
+        "planned_operations",
+        "hazard_selection_images",
+        "theory_of_change_table_file",
+        "exposed_element_and_vulnerability_factor_images",
+        "prioritized_impact_images",
+        "risk_analysis_relevant_files",
+        "forecast_selection_images",
+        "definition_and_justification_impact_level_images",
+        "identification_of_the_intervention_area_images",
+        "trigger_model_relevant_files",
+        "early_action_selection_process_images",
+        "evidence_base_relevant_files",
+        "early_action_implementation_images",
+        "trigger_activation_system_images",
+        "activation_process_relevant_files",
+        "meal_relevant_files",
+        "capacity_relevant_files",
+        "forecast_table_file",
+    )
+
+    def get_queryset(self, request):
+        return (
+            super()
+            .get_queryset(request)
+            .select_related(
+                "created_by",
+                "modified_by",
+                "cover_image",
+                "eap_registration__country",
+                "eap_registration__national_society",
+                "eap_registration__disaster_type",
+            )
+            .prefetch_related(
+                "admin2",
+                "key_actors",
+                "risk_analysis_source_of_information",
+                "trigger_statement_source_of_information",
+                "trigger_model_source_of_information",
+                "evidence_base_source_of_information",
+                "activation_process_source_of_information",
+            )
+        )

eap/enums.py

@@ -0,0 +1,13 @@
+from . import models
+
+enum_register = {
+    "eap_status": models.EAPStatus,
+    "eap_type": models.EAPType,
+    "sector": models.PlannedOperation.Sector,
+    "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.EnableApproach.Approach,
+}