Skip to content

CTF-802: Real-Time Notifications

Statement

CTF events could deliver real-time in-app notifications using the platform's WebSocket infrastructure (PLAT-105). CTF-specific notification types include: new challenge released, announcement posted, scoreboard position change, and first blood achieved. Notifications shall be displayed as non-blocking toasts or a notification panel. Participants who are not connected shall receive notifications upon next connection.

Rationale

Real-time notification delivery is a platform capability. Mission Control already has WebSocket consumers. CTF registers its notification types with PLAT-105 rather than building a separate WebSocket layer.

Traceability

  • IMPLEMENTS → GITHUB_ISSUE Brad-Edwards/bigrae#665 (CTF-802: Real-Time Notifications)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/services/notification/live.py (Per-event live kinds, live-notice and position-reconcile tasks, nameless inbox notices (ADR-072))
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/services/notification/realtime.py (Closed socket projection and per-occurrence live hints on the PLAT-105 bus)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/ctf/models/_live_notifications.py (Event live notification kind default and validator)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/frontend/src/features/ctf/CtfWorkspaceLayout.tsx (Gated notification socket with bounded reconnect and fixed-text toasts)
  • IMPLEMENTS → CODE_FILE shifter/shifter_platform/frontend/src/features/ctf/admin/EventFormPage.tsx (Organizer live notification kind selection)
  • IMPLEMENTS → CONFIG platform/charts/shifter/templates/notification-prune-cronjob.yaml (Scheduled bounded prune of expired notification rows)
  • IMPLEMENTS → CODE_FILE scripts/gcp/render_runtime_env.py (GCP deployments turn on the live notification capability)
  • IMPLEMENTS → ADR docs/adr/072-live-ctf-notifications-per-event.md (Live CTF notifications are per-event and cost nothing when unused)
  • TESTS → TEST shifter/shifter_platform/tests/ctf/test_live_notifications.py (Zero-work gate, release and first-blood notices, position reconcile, projection, prune, API, scheduler execution)
  • TESTS → TEST shifter/shifter_platform/frontend/src/features/ctf/CtfWorkspaceLayout.test.tsx (Socket gating, hint toasts, reconnect and terminal close codes)