Skip to content

HNS Ticketing System Documentation

Welcome to the comprehensive documentation for the Croatian Football Federation (HNS) Ticketing System.

Overview

The HNS Ticketing System is a modern, comprehensive platform designed to manage ticket sales, distribution, and access control for Croatian national football team matches. The system launches in September 2026 and replaces the legacy ticketing infrastructure with a flexible, scalable solution.

Key Capabilities

Customer-Facing

  • Public Ticket Sales - Online ticket purchasing with zone selection, automatic seat assignment, and cart management
  • Mobile App Sales - Customer ticket purchasing exclusively through HNS mobile app
  • Digital Tickets - Integration with Apple Wallet and Google Pay with dynamic QR codes
  • Loyalty Program - Priority access for dedicated fans based on attendance history
  • Access Control - QR code-based entry validation with revolving security codes
  • Customer Support - Tools for transfers, refunds, and customer service

Administrative & Operations

  • Real-Time Capacity Dashboard - Interactive visual stadium maps with color-coded sections and live capacity statistics
  • Seat Inventory Lifecycle - Comprehensive seat status management with 10+ status types (sold, available, reserved, technical, official, etc.)
  • Event & Calendar Management - Multi-event scheduling, status workflows, and date range management
  • Quota Management - Sophisticated allocation system for partners, sponsors, and fan groups with bulk import
  • Stadium Management - Multi-venue support with custom layouts (Maksimir, Poljud, Opus Arena) and section configuration
  • Document & Invoice Management - Automated invoice generation, electronic signatures, and financial system integration
  • Multi-Channel Sales - Support for online, box office, mobile, and partner distribution channels
  • Admin Reporting - Real-time analytics, capacity metrics, and comprehensive administrative reports

Security & Compliance

  • Identity Verification - OIB-based verification integrated throughout purchase flow
  • Blacklist Management - Real-time purchase blocking with security monitoring and violation tracking
  • Audit Trails - Complete tracking of all transactions, status changes, and administrative actions

Payment & Financial

  • Flexible Payments - Card payments, deferred billing, and bank transfers
  • Invoice Management - Automated generation, preview, modification, and financial system integration

System Goals

  1. Prevent Ticket Resale - Personalized tickets tied to OIB (Croatian personal ID)
  2. Reward Loyalty - Priority access for regular attendees
  3. Flexible Distribution - Support multiple sales channels and quota systems
  4. Enhanced Security - Blacklist management and identity verification
  5. Better Experience - Digital tickets, faster checkout, waiting queues
  6. Operational Efficiency - Automated processes and comprehensive reporting

Documentation Structure

This documentation is organized into the following sections:

Overview

System introduction, vision, glossary, and context

Epics

High-level problem statements and major functional areas (15 epics covering all system capabilities)

Core Epics: - Ticket Sales Management - Access Control Validation - User Identity Verification - Loyalty Program - Payment Processing - Customer Support Operations

Administrative Epics: - Real-Time Capacity Dashboard (NEW - visual stadium management with live statistics) - Seat Inventory Lifecycle (NEW - 10+ status types with transaction locking) - Event & Calendar Management (NEW - multi-event scheduling and status workflows) - Document & Invoice Management (NEW - automated invoicing with electronic signatures) - Blacklist Management & Security Monitoring (NEW - real-time blocking and violation tracking) - Quota Management System - Stadium Venue Management - Physical Sales Channels - Admin Reporting

Features

Detailed functional specifications for each capability

User Stories

Atomic user requirements with acceptance criteria

Architecture

Technical design, data models, APIs, and integrations

UI/UX

User flows and interface specifications

Roadmap

Implementation phases and timeline

Quick Start

Key Statistics

  • Launch Date: September 2026
  • Stadium Coverage: Multiple venues across Croatia
  • Expected Quota Volume: 60-80% of stadium capacity
  • Supported Users: Croatian nationals (OIB required) + international guests
  • Ticket Limit: 4 tickets per transaction
  • Loyalty Window: 2 days early access for qualifying fans
  • Support Window: Transfers and refunds up to 48 hours before match

Contact & Support

For questions about this documentation or the HNS Ticketing System, please contact the project team.

This documentation is generated from meeting notes and represents the current understanding of system requirements. It will be updated as the project evolves.