chore: define an initial InitConfig model

Author: jgravois

benefits/enrollment_init/admin.py

@@ -1,3 +1,14 @@
-# from django.contrib import admin
+from django.contrib import admin
+from django.db import models
+from django.forms import TextInput
 
-# Register your models here.
+from benefits.core.admin.mixins import StaffPermissionMixin
+from benefits.enrollment_init import models as benefitsModels
+
+
+@admin.register(benefitsModels.InitConfig)
+class InitConfigAdmin(StaffPermissionMixin, admin.ModelAdmin):
+    # use a TextInput for inherited fields instead of a Textarea
+    formfield_overrides = {
+        models.TextField: {"widget": TextInput(attrs={"size": "80"})},
+    }

benefits/enrollment_init/migrations/0001_initial.py

@@ -0,0 +1,66 @@
+# Generated by Django 5.2.17 on 2026-09-04 18:29
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+import benefits.core.models.common
+import benefits.secrets
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ("core", "0008_alter_enrollmentflow_system_name"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="InitConfig",
+            fields=[
+                (
+                    "transitprocessorconfig_ptr",
+                    models.OneToOneField(
+                        auto_created=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        parent_link=True,
+                        primary_key=True,
+                        serialize=False,
+                        to="core.transitprocessorconfig",
+                    ),
+                ),
+                (
+                    "tokenization_api_key",
+                    models.CharField(blank=True, default="", help_text="The Collect.js API key used for tokenization."),
+                ),
+                (
+                    "registration_base_url",
+                    models.URLField(
+                        blank=True, default="", help_text="The absolute base url of the MOBILEvario API instance."
+                    ),
+                ),
+                (
+                    "registration_username",
+                    models.CharField(
+                        blank=True, default="", help_text="The username used to authenticate with MOBILEvario.", max_length=50
+                    ),
+                ),
+                (
+                    "registration_password_secret_name",
+                    benefits.core.models.common.SecretNameField(
+                        blank=True,
+                        default="",
+                        help_text="The name of the secret containing the password used to authenticate with MOBILEvario, "
+                        "typically: [agency]-init-registration-password",
+                        max_length=127,
+                        validators=[benefits.secrets.SecretNameValidator()],
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "INIT Config",
+            },
+            bases=("core.transitprocessorconfig",),
+        ),
+    ]

benefits/enrollment_init/models.py

@@ -1,3 +1,54 @@
-# from django.db import models
+import logging
 
-# Create your models here.
+from django.core.exceptions import ValidationError
+from django.db import models
+
+from benefits.core.models import SecretNameField, TransitProcessorConfig
+
+logger = logging.getLogger(__name__)
+
+
+class InitConfig(TransitProcessorConfig):
+    """Configuration for connecting to INIT, an entity that applies transit agency fare rules to rider transactions."""
+
+    tokenization_api_key = models.CharField(help_text="The Collect.js API key used for tokenization.", default="", blank=True)
+
+    registration_base_url = models.URLField(
+        help_text="The absolute base url of the MOBILEvario API instance.", default="", blank=True
+    )
+
+    registration_username = models.CharField(
+        help_text="The username used to authenticate with MOBILEvario.",
+        default="",
+        blank=True,
+        max_length=50,
+    )
+
+    registration_password_secret_name = SecretNameField(
+        help_text="The name of the secret containing the password used to authenticate with MOBILEvario, "
+        "typically: [agency]-init-registration-password",
+        default="",
+        blank=True,
+        max_length=50,
+    )
+
+    @property
+    def registration_password(self):
+        secret_field = self._meta.get_field("registration_password_secret_name")
+        return secret_field.secret_value(self)
+
+    def clean(self):
+        field_errors = {}
+
+        if self.pk and self.transitagency_set and any([agency.active for agency in self.transitagency_set.all()]):
+            message = "This field is required when this configuration is referenced by an active transit agency."
+            needed = dict(
+                tokenization_api_key=self.tokenization_api_key,
+            )
+            field_errors.update({k: ValidationError(message) for k, v in needed.items() if not v})
+
+        if field_errors:
+            raise ValidationError(field_errors)
+
+    class Meta:
+        verbose_name = "INIT Config"