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,32 @@
+# Generated by Django 4.2.30 on 2026-04-28 06:35
+
+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')),
+                ('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(fields=('type', 'region', 'email'), name='unique_eap_email_per_type_region', violation_error_message='This email is already assigned.'),
+        ),
+    ]

eap/migrations/0005_remove_emailrecipient_unique_eap_email_per_type_region_and_more.py

@@ -0,0 +1,42 @@
+# Generated by Django 4.2.30 on 2026-04-30 10:33
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("eap", "0004_emailrecipient_and_more"),
+    ]
+
+    operations = [
+        migrations.RemoveConstraint(
+            model_name="emailrecipient",
+            name="unique_eap_email_per_type_region",
+        ),
+        migrations.AddField(
+            model_name="emailrecipient",
+            name="title",
+            field=models.CharField(
+                default="test", max_length=255, verbose_name="Title"
+            ),
+            preserve_default=False,
+        ),
+        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")