Preskoči na sadržaj

Story: Quota Holder Manage Allocation

As a

Quota holder (sponsor, partner, or fan group leader)

I want to

Receive an email invitation and claim my ticket allocation through the HNS mobile app, and if I have subquota permissions, access a web interface to delegate tickets to sub-recipients

So that

I can claim tickets for myself and distribute allocations to my group members without needing HNS staff assistance

Acceptance Criteria

Part 1: Initial Quota Claiming (All Quota Holders - Mobile App)

  • AC1: I receive an email invitation with personalized allocation details (quantity, sectors, match, expiration)
  • AC2: Email includes magic link button to claim tickets via HNS mobile app
  • AC3: Tapping magic link opens HNS app and authenticates me automatically (no username/password)
  • AC4: App displays quota dashboard showing total allocation, claimed tickets, available balance, and expiration countdown
  • AC5: I can see which sectors I have access to (e.g., D1, C1, B2)
  • AC6: I can view seat assignments based on my allocation algorithm (NM = best seats, REDOM = distributed)
  • AC7: I must provide identity information (name, DOB, nationality, OIB/passport) for each ticket
  • AC8: System validates identity against blacklist in real-time
  • AC9: Claimed tickets appear immediately in my app wallet with QR codes
  • AC10: I can claim partial allocation (e.g., claim 2 now, 3 later)
  • AC11: I receive push notifications for deadline reminders (T-48h, T-6h)
  • AC12: Unclaimed tickets automatically expire at deadline and return to general sale

Part 2: Subquota Delegation (Only for Quota Holders with can_create_subquotas Permission - Web Interface)

  • AC13: After claiming my allocation, I receive web portal access link (if can_create_subquotas = TRUE)
  • AC14: I can access web portal via desktop/tablet browser
  • AC15: Web portal authenticates via magic link (24-hour validity)
  • AC16: Dashboard shows my total allocation, claimed tickets, delegated to subquotas, and available balance
  • AC17: I can create subquota by entering sub-recipient email, name, quantity, and note
  • AC18: System validates quantity does not exceed my available balance
  • AC19: Sub-recipient receives email with magic link to claim via HNS mobile app
  • AC20: I can view all my subquotas with status (pending, claimed, expired)
  • AC21: I can retract unused subquota if no tickets claimed by sub-recipient
  • AC22: Dashboard updates in real-time when sub-recipients claim tickets
  • AC23: All delegation actions logged in audit trail

Technical Notes

Priority

HIGH - Essential for self-service quota management and reducing admin workload

Dependencies

  • HNS mobile app with deep linking support
  • Magic link authentication system
  • Email notification system operational
  • Push notification service (Firebase)
  • Subquota web portal (for quota holders with delegation permissions)
  • feature-quota-creation-assignment
  • feature-mobile-app-claiming-integration
  • feature-sub-quota-delegation
  • feature-quota-portal-web-fallback
  • epic-quota-management-system

Implementation Notes

  • Regular quota holders claim exclusively via HNS mobile app (no web portal)
  • Subquota holders with can_create_subquotas permission access web interface for delegation
  • Magic link authentication (30 minutes for claiming, 24 hours for web portal access)
  • Real-time synchronization across mobile app, web portal, and admin dashboard
  • Must handle concurrent subquota creation and claiming activities

User Experience Considerations

  • Email invitations clear and actionable with prominent magic link button
  • Mobile app quota dashboard shows expiration countdown prominently
  • Push notifications for deadline reminders (T-48h, T-6h)
  • Web portal (for subquota holders) intuitive with real-time balance updates
  • Clear distinction between claiming tickets (app) and delegating subquotas (web)

Last Updated: November 2025