feat: rsvp reminder route (#298)

* feat: rsvp reminder route

* fix: mypy types and docstring

* fix: application.first_name key access

* feat: add log message to rsvp-reminder route

Author: samderanova

apps/api/src/routers/admin.py

@@ -9,10 +9,12 @@
 from auth.authorization import require_role
 from auth.user_identity import User, utc_now
 from models.ApplicationData import Decision, Review
-from services import mongodb_handler
+from services import mongodb_handler, sendgrid_handler
 from services.mongodb_handler import BaseRecord, Collection
+from services.sendgrid_handler import ApplicationUpdatePersonalization, Template
 from utils import email_handler
 from utils.batched import batched
+from utils.email_handler import IH_SENDER, REPLY_TO_HACK_AT_UCI
 from utils.user_record import Applicant, Role, Status
 
 log = getLogger(__name__)
@@ -131,6 +133,33 @@ async def release_decisions() -> None:
         )
 
 
+@router.post("/rsvp-reminder", dependencies=[Depends(require_role([Role.DIRECTOR]))])
+async def rsvp_reminder() -> None:
+    """Send email to applicants who have a status of ACCEPTED or WAIVER_SIGNED
+    reminding them to RSVP."""
+    # TODO: Consider using Pydantic model validation instead of type annotations
+    not_yet_rsvpd: list[dict[str, Any]] = await mongodb_handler.retrieve(
+        Collection.USERS,
+        {"status": {"$in": [Decision.ACCEPTED, Status.WAIVER_SIGNED]}},
+        ["_id", "application_data.first_name"],
+    )
+    log.info(f"Sending RSVP reminder emails to {len(not_yet_rsvpd)} applicants")
+    personalizations = [
+        ApplicationUpdatePersonalization(
+            email=_recover_email_from_uid(record["_id"]),
+            first_name=record["application_data"]["first_name"],
+        )
+        for record in not_yet_rsvpd
+    ]
+    await sendgrid_handler.send_email(
+        Template.RSVP_REMINDER,
+        IH_SENDER,
+        personalizations,
+        True,
+        reply_to=REPLY_TO_HACK_AT_UCI,
+    )
+
+
 async def _process_batch(batch: tuple[dict[str, Any], ...], decision: Decision) -> None:
     uids: list[str] = [record["_id"] for record in batch]
     log.info(f"Setting {','.join(uids)} as {decision}")

apps/api/src/services/sendgrid_handler.py

@@ -21,6 +21,7 @@ class Template(str, Enum):
     WAITLISTED_EMAIL = "d-9178c043de134a71a4fdbe513d35f89f"
     REJECTED_EMAIL = "d-71ef30ac91a941e0893b7680928d80b7"
     WAITLIST_RELEASE_EMAIL = "d-19af50295ac14e82a7810791a175b8e9"
+    RSVP_REMINDER = "d-0c2642268c404c138359ac1b9d41e78c"
 
 
 class PersonalizationData(TypedDict):