feat(eap): add email recipient from admin panel

- used on email notification
- add test cases

Author: susilnem

eap/admin.py

@@ -5,6 +5,7 @@
     EAPFile,
     EAPRegistration,
     EAPType,
+    EmailRecipient,
     FullEAP,
     KeyActor,
     SimplifiedEAP,
@@ -21,6 +22,26 @@ class EAPFileAdmin(admin.ModelAdmin):
     )
 
 
+@admin.register(EmailRecipient)
+class EmailRecipientAdmin(admin.ModelAdmin):
+    list_select_related = True
+    search_fields = ("email",)
+    list_display = (
+        "type",
+        "title",
+        "region",
+        "email",
+    )
+    list_filter = (
+        "type",
+        "region",
+    )
+    autocomplete_fields = ("region",)
+
+    def has_module_permission(self, request):
+        return request.user.is_superuser
+
+
 @admin.register(EAPRegistration)
 class DevelopmentRegistrationEAPAdmin(admin.ModelAdmin):
     list_select_related = True

eap/factories.py

@@ -10,6 +10,7 @@
     EAPRegistration,
     EAPStatus,
     EAPType,
+    EmailRecipient,
     EnablingApproach,
     FullEAP,
     KeyActor,
@@ -238,3 +239,12 @@ def key_actors(self, create, extracted, **kwargs):
         if extracted:
             for actor in extracted:
                 self.key_actors.add(actor)
+
+
+class EmailRecipientFactory(factory.django.DjangoModelFactory):
+    class Meta:
+        model = EmailRecipient
+
+    type = fuzzy.FuzzyChoice(EAPType)
+    email = factory.LazyAttribute(lambda obj: f"{obj.type.lower()}@example.com")
+    title = fuzzy.FuzzyText(length=10, prefix="Title-")

eap/migrations/0004_emailrecipient_and_more.py

@@ -0,0 +1,73 @@
+# Generated by Django 4.2.30 on 2026-04-30 11:21
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("api", "0231_alter_export_export_type"),
+        ("eap", "0003_eapaction_eapcontact_eapfile_eapimpact_and_more"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="EmailRecipient",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("title", models.CharField(max_length=255, verbose_name="Title")),
+                (
+                    "type",
+                    models.IntegerField(
+                        choices=[
+                            (10, "DREF Anticipatory Pillar"),
+                            (20, "DREF AA Global Team"),
+                            (30, "Regional Coordinator"),
+                        ],
+                        verbose_name="Email Type",
+                    ),
+                ),
+                ("email", models.EmailField(max_length=254)),
+                (
+                    "region",
+                    models.ForeignKey(
+                        blank=True,
+                        help_text="Only assign region for Regional Coordinator email type.",
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to="api.region",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Email Recipient",
+                "verbose_name_plural": "Email Recipients",
+            },
+        ),
+        migrations.AddConstraint(
+            model_name="emailrecipient",
+            constraint=models.UniqueConstraint(
+                condition=models.Q(("region__isnull", True)),
+                fields=("type", "email"),
+                name="unique_email_type_no_region",
+                violation_error_message="Email must be unique for the given type when no region is assigned.",
+            ),
+        ),
+        migrations.AddConstraint(
+            model_name="emailrecipient",
+            constraint=models.UniqueConstraint(
+                condition=models.Q(("region__isnull", False)),
+                fields=("type", "region", "email"),
+                name="unique_email_type_region",
+                violation_error_message="Email must be unique for the given type and region.",
+            ),
+        ),
+    ]

eap/models.py

@@ -1,10 +1,12 @@
 from django.conf import settings
 from django.contrib.postgres.fields import ArrayField
+from django.core.exceptions import ValidationError
 from django.db import models, transaction
+from django.db.models import Q
 from django.utils import timezone
 from django.utils.translation import gettext_lazy as _
 
-from api.models import Admin2, Country, DisasterType, District
+from api.models import Admin2, Country, DisasterType, District, Region
 from main.fields import SecureFileField
 
 
@@ -248,6 +250,64 @@ def __str__(self):
         return f"{self.name}"
 
 
+# NOTE: Managed through admin panel for now, used for email notification
+class EmailRecipient(models.Model):
+    class EmailType(models.IntegerChoices):
+        DREF_ANTICIPATORY = 10, "DREF Anticipatory Pillar"
+        DREF_AA_GLOBAL_TEAM = 20, "DREF AA Global Team"
+        REGIONAL_COORDINATOR = 30, "Regional Coordinator"
+
+    title = models.CharField(max_length=255, verbose_name=_("Title"))
+    type = models.IntegerField(choices=EmailType.choices, verbose_name=_("Email Type"))
+    region = models.ForeignKey(
+        Region,
+        null=True,
+        blank=True,
+        on_delete=models.CASCADE,
+        help_text=_("Only assign region for Regional Coordinator email type."),
+    )
+    email = models.EmailField()
+
+    # TYPING
+    id: int
+    region_id: int | None
+
+    class Meta:
+        verbose_name = _("Email Recipient")
+        verbose_name_plural = _("Email Recipients")
+        constraints = [
+            models.UniqueConstraint(
+                fields=["type", "email"],
+                condition=Q(region__isnull=True),
+                name="unique_email_type_no_region",
+                violation_error_message=_("Email must be unique for the given type when no region is assigned."),
+            ),
+            models.UniqueConstraint(
+                fields=["type", "region", "email"],
+                condition=Q(region__isnull=False),
+                name="unique_email_type_region",
+                violation_error_message=_("Email must be unique for the given type and region."),
+            ),
+        ]
+
+    def __str__(self):
+        return f"{self.get_type_display()} - {self.email}"
+
+    def clean(self):
+        if (
+            self.type
+            in [
+                self.EmailType.DREF_ANTICIPATORY,
+                self.EmailType.DREF_AA_GLOBAL_TEAM,
+            ]
+            and self.region is not None
+        ):
+            raise ValidationError(f"{self.get_type_display()} should not have a region assigned.")
+
+        if self.type == self.EmailType.REGIONAL_COORDINATOR and self.region is None:
+            raise ValidationError("Regional coordinator must have a region.")
+
+
 class TimeFrame(models.IntegerChoices):
     YEARS = 10, _("Years")
     MONTHS = 20, _("Months")