Refactor: simplify Eligibility Start templates

benefits/core/admin/enrollment.py

@@ -161,7 +161,6 @@ def get_readonly_fields(self, request, obj=None):
                     "eligibility_api_url",
                     "eligibility_form_class",
                     "selection_label_template_override",
-                    "eligibility_start_template_override",
                     "eligibility_unverified_template_override",
                     "help_template",
                     "enrollment_index_template_override",

benefits/core/migrations/0038_remove_enrollmentflow_eligibility_start_template_override.py

@@ -0,0 +1,17 @@
+# Generated by Django 5.1.7 on 2025-03-13 18:22
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("core", "0037_remove_transitagency_eligibility_index_template_override"),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name="enrollmentflow",
+            name="eligibility_start_template_override",
+        ),
+    ]

benefits/core/models/enrollment.py

@@ -11,6 +11,7 @@
 from .claims import ClaimsProvider
 from .transit import TransitAgency
 from benefits.core import context as core_context
+from benefits.eligibility import context as eligibility_context
 from benefits.in_person import context as in_person_context
 
 logger = logging.getLogger(__name__)
@@ -119,11 +120,6 @@ class EnrollmentFlow(models.Model):
         default="",
         help_text="Override the default template that defines the end-user UI for selecting this flow among other options.",
     )
-    eligibility_start_template_override = models.TextField(
-        blank=True,
-        default="",
-        help_text="Override the default template for the informational page of this flow.",
-    )
     eligibility_unverified_template_override = models.TextField(
         blank=True,
         default="",
@@ -195,12 +191,8 @@ def selection_label_template(self):
             return self.selection_label_template_override or f"{prefix}--{self.system_name}.html"
 
     @property
-    def eligibility_start_template(self):
-        prefix = "eligibility/start"
-        if self.uses_api_verification:
-            return self.eligibility_start_template_override or f"{prefix}--{self.agency_card_name}.html"
-        else:
-            return self.eligibility_start_template_override or f"{prefix}--{self.system_name}.html"
+    def eligibility_start_context(self):
+        return eligibility_context.eligibility_start[self.system_name].dict()
 
     @property
     def eligibility_unverified_template(self):
@@ -268,7 +260,6 @@ def clean(self):
         if self.transit_agency:
             templates = [
                 self.selection_label_template,
-                self.eligibility_start_template,
                 self.eligibility_unverified_template,
                 self.enrollment_index_template,
                 self.enrollment_success_template,

benefits/eligibility/context/__init__.py

@@ -1,3 +1,4 @@
 from .agency import eligibility_index
+from .flow import eligibility_start
 
-__all__ = ["eligibility_index"]
+__all__ = ["eligibility_index", "eligibility_start"]

benefits/eligibility/context/flow.py

@@ -0,0 +1,80 @@
+from dataclasses import dataclass, asdict
+from typing import Optional
+
+from django.utils.translation import gettext_lazy as _
+
+from benefits.core.context import SystemName
+from benefits.routes import routes
+
+
+@dataclass
+class CTAButton:
+    text: str
+    route: str
+    fallback_text: Optional[str] = None
+    extra_classes: Optional[str] = None
+
+
+@dataclass
+class EligibilityStart:
+    page_title: str
+    headline_text: str
+    eligibility_item_template: str
+    call_to_action_button: CTAButton
+
+    def dict(self):
+        return asdict(self)
+
+
+class LoginGovEligibilityStart(EligibilityStart):
+    def __init__(self, page_title, headline_text):
+        super().__init__(
+            page_title=page_title,
+            headline_text=headline_text,
+            eligibility_item_template="eligibility/includes/eligibility-item--identification--start--login-gov.html",
+            call_to_action_button=CTAButton(
+                text=_("Get started with"), fallback_text="Login.gov", route=routes.OAUTH_LOGIN, extra_classes="login"
+            ),
+        )
+
+
+class AgencyCardEligibilityStart(EligibilityStart):
+    def __init__(self, headline_text, eligibility_item_template):
+        super().__init__(
+            page_title=_("Agency card overview"),
+            headline_text=headline_text,
+            eligibility_item_template=eligibility_item_template,
+            call_to_action_button=CTAButton(text=_("Continue"), route=routes.ELIGIBILITY_CONFIRM),
+        )
+
+
+eligibility_start = {
+    SystemName.AGENCY_CARD.value: AgencyCardEligibilityStart(
+        headline_text=_("You selected an Agency Card transit benefit."),
+        eligibility_item_template="eligibility/includes/eligibility-item--identification--start--cst-agency-card.html",
+    ),
+    SystemName.CALFRESH.value: LoginGovEligibilityStart(
+        page_title=_("CalFresh benefit overview"), headline_text=_("You selected a CalFresh Cardholder transit benefit.")
+    ),
+    SystemName.COURTESY_CARD.value: AgencyCardEligibilityStart(
+        headline_text=_("You selected a Courtesy Card transit benefit."),
+        eligibility_item_template="eligibility/includes/eligibility-item--identification--start--mst-agency-card.html",
+    ),
+    SystemName.MEDICARE.value: EligibilityStart(
+        page_title=_("Medicare benefit overview"),
+        headline_text=_("You selected a Medicare Cardholder transit benefit."),
+        eligibility_item_template="eligibility/includes/eligibility-item--identification--start--medicare.html",
+        call_to_action_button=CTAButton(text=_("Continue to Medicare.gov"), route=routes.OAUTH_LOGIN),
+    ),
+    SystemName.OLDER_ADULT.value: LoginGovEligibilityStart(
+        page_title=_("Older Adult benefit overview"),
+        headline_text=_("You selected an Older Adult transit benefit."),
+    ),
+    SystemName.REDUCED_FARE_MOBILITY_ID.value: AgencyCardEligibilityStart(
+        headline_text=_("You selected a Reduced Fare Mobility ID transit benefit."),
+        eligibility_item_template="eligibility/includes/eligibility-item--identification--start--sbmtd-agency-card.html",
+    ),
+    SystemName.VETERAN.value: LoginGovEligibilityStart(
+        page_title=_("Veterans benefit overview"), headline_text=_("You selected a Veteran transit benefit.")
+    ),
+}

benefits/eligibility/templates/eligibility/start.html

@@ -5,26 +5,34 @@
   {{ block.super | add:" eligibility-start" }}
 {% endblock classes %}
 
+{% block page-title %}
+  {% translate page_title %}
+{% endblock page-title %}
+
 {% block nav-buttons %}
   {% url routes.ELIGIBILITY_INDEX as url %}
   {% include "core/includes/button--previous-page.html" with url=url %}
 {% endblock nav-buttons %}
 
 {% block headline %}
-  <h1>
-    {% block headline-text %}
-    {% endblock headline-text %}
-  </h1>
+  <h1>{{ headline_text }}</h1>
 {% endblock headline %}
 
 {% block inner-content %}
   <p class="py-4">{% translate "You will need a few items to continue:" %}</p>
   <ul class="d-flex flex-column gap-4 list-unstyled ps-0 mb-0">
-    {% block eligibility-item %}
-    {% endblock eligibility-item %}
+    {% include eligibility_item_template %}
     {% include "eligibility/includes/eligibility-item--contactless-card--start.html" %}
   </ul>
 {% endblock inner-content %}
 
 {% block call-to-action-button %}
+  {% translate call_to_action_button.text as button_text %}
+  <a href="{% url call_to_action_button.route %}"
+     class="btn btn-lg btn-primary{% if call_to_action_button.extra_classes %} {{ call_to_action_button.extra_classes }}{% endif %}">
+    {{ button_text }}
+    {% if call_to_action_button.fallback_text %}
+      <span class="fallback-text white-logo">{{ call_to_action_button.fallback_text }}</span>
+    {% endif %}
+  </a>
 {% endblock call-to-action-button %}

benefits/eligibility/views.py

@@ -64,7 +64,7 @@ def start(request):
 
     flow = session.flow(request)
 
-    return TemplateResponse(request, flow.eligibility_start_template)
+    return TemplateResponse(request, "eligibility/start.html", flow.eligibility_start_context)
 
 
 @decorator_from_middleware(AgencySessionRequired)