Refresh invite operations workspace

backend/tests/test_backend_quality.py

@@ -17,6 +17,7 @@ from backend.app.config import settings
 from backend.app.network_security import request_trusts_forwarded_headers, validate_notification_target_url
 from backend.app.models import ActionOption, NormalizedState, RequestType, Snapshot, TimelineHop
 from backend.app.routers import auth as auth_router
+from backend.app.routers import admin as admin_router
 from backend.app.routers import portal as portal_router
 from backend.app.routers import requests as requests_router
 from backend.app.routers import site as site_router
@@ -1604,6 +1605,37 @@ class PortalMediaStatusTests(unittest.IsolatedAsyncioTestCase):
         self.assertNotIn("secret upstream failure", str(result))
 
 
+class InviteOperationalStateTests(TempDatabaseMixin, unittest.IsolatedAsyncioTestCase):
+    async def test_invite_list_reports_automatic_operational_states(self) -> None:
+        ready = db.create_signup_invite(code="READY", recipient_email="ready@example.com")
+        db.create_signup_invite(code="DISABLED", enabled=False, recipient_email="off@example.com")
+        used = db.create_signup_invite(code="USED", max_uses=1, recipient_email="used@example.com")
+        db.increment_signup_invite_use(int(used["id"]))
+        db.create_signup_invite(
+            code="EXPIRED",
+            expires_at="2000-01-01T00:00:00+00:00",
+            recipient_email="expired@example.com",
+        )
+        db.create_signup_invite(
+            code="NO-PROFILE",
+            profile_id=999,
+            recipient_email="profile@example.com",
+        )
+
+        payload = await admin_router.get_invites()
+        states = {invite["code"]: invite["operational_state"] for invite in payload["invites"]}
+
+        self.assertEqual(states[ready["code"]], "ready")
+        self.assertEqual(states["DISABLED"], "disabled")
+        self.assertEqual(states["USED"], "exhausted")
+        self.assertEqual(states["EXPIRED"], "expired")
+        self.assertEqual(states["NO-PROFILE"], "profile_unavailable")
+        self.assertEqual(payload["summary"]["total"], 5)
+        self.assertEqual(payload["summary"]["ready"], 1)
+        self.assertEqual(payload["summary"]["attention"], 4)
+        self.assertEqual(payload["summary"]["used_signups"], 1)
+
+
 class PortalWorkflowTests(TempDatabaseMixin, unittest.TestCase):
     def test_legacy_request_status_maps_to_workflow(self) -> None:
         item = {"kind": "request", "status": "in_progress"}