E5-F3: Queue Progressive Notifications

Epic: E5: Waiting Queue System

Size: S (Small)

Problem / Outcome

Push notifications at key queue milestones.

Scope

In-Scope:

• Push for significant position changes
• Push at position ~50 ("almost at front")
• Push when it's user's turn
• Firebase integration

Out-of-Scope:

• In-app popups (client-side implementation)

Acceptance Criteria

• AC1: Push sent when position significantly changes
• AC2: Push sent when user reaches position ~50: "You're almost at the front!"
• AC3: Push sent when it's user's turn: "It's your turn! Buy tickets for [Match]"

Data Model Impact

NotificationLog table:
- id (UUID, PK)
- user_id (UUID, FK)
- type (ENUM: queue_update, queue_near_front, queue_your_turn)
- match_id (UUID, FK)
- message (VARCHAR)
- sent_at (TIMESTAMP)
- delivery_status (ENUM: sent, delivered, failed)

Permissions/Roles

• System (triggered by queue advancement)

How to Verify

npm test -- --grep "queue notifications"

Expected: Pushes sent at correct milestones.

Dependencies

• E5-F1: Queue Join and Position Assignment
• E15-F2: Push Notification Service

Implementation Tasks

See E5: Waiting Queue Tasks

Doc References

• Waiting Queue Flow

---

Last Updated: January 2026