Portals Overview¶
The HNS Ticketing System includes two web-based portals built with Symfony (PHP), Twig templates, and Tailwind CSS. These portals provide administrative and quota management capabilities that complement the customer-facing mobile application.
Portal Architecture¶
┌─────────────────────────────────────────────────────────────────┐
│ HNS Backend (Symfony) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ Admin Portal │ │ Quota Portal │ │
│ │ (Twig + Tailwind) │ │ (Twig + Tailwind) │ │
│ │ │ │ │ │
│ │ - Match Management │ │ - Quota Dashboard │ │
│ │ - Seat Operations │ │ - Claim Tickets │ │
│ │ - Quota Admin │ │ - Subquota Mgmt │ │
│ │ - Blacklist Mgmt │ │ - Ticket History │ │
│ │ - Reports │ │ │ │
│ │ - Support Tools │ │ │ │
│ └─────────────────────┘ └─────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Admin Portal¶
The Admin Portal is the primary management interface for HNS staff. It provides comprehensive tools for managing matches, stadiums, ticket inventory, quotas, blacklists, and generating reports.
Primary Users:
- Match Managers (HNS Staff)
- Stadium Operators
- Security Administrators (BLACKADMIN)
- Customer Support Agents
- Finance Team
Key Capabilities:
- Match creation and lifecycle management
- Stadium configuration and seat operations
- Quota creation, assignment, and monitoring
- Blacklist management (CSV import, CRUD)
- Real-time sales dashboards
- Financial and operational reports
- Support tools (ticket lookup, transfers, refunds)
View Admin Portal Specification
Quota Portal¶
The Quota Portal enables quota holders (sponsors, partners, officials) to manage their ticket allocations. Users access the portal with the same credentials as the HNS mobile app.
Primary Users:
- Sponsors and corporate partners
- Officials and VIPs
- Club representatives
- Any quota recipient with delegation permissions
Key Capabilities:
- View allocated quotas across matches
- Claim tickets (3-step process)
- Create and manage subquotas (if permitted)
- Monitor claiming status in real-time
- Access ticket history
View Quota Portal Specification
Shared Components¶
Both portals share a common component library to ensure consistency and reduce development effort.
Shared UI Components:
- Data tables with sorting, filtering, pagination
- Form controls with validation
- Modal dialogs
- Navigation patterns
- Status badges and indicators
- Stadium visualization component
View Stadium Visualization Component
Tech Stack¶
| Layer | Technology |
|---|---|
| Backend Framework | Symfony (PHP) |
| Templating | Twig |
| CSS Framework | Tailwind CSS |
| JavaScript | Vanilla JS / Alpine.js (for interactivity) |
| Stadium Maps | SVG-based with JavaScript interaction |
| Authentication | Same auth system as mobile app |
Portal Access¶
| Portal | URL Pattern | Access Control |
|---|---|---|
| Admin Portal | admin.ulaznice.hns.family |
Role-based (staff accounts) |
| Quota Portal | quota.ulaznice.hns.family |
Email-based (active quota required) |
Related Documentation¶
- User Flows - Detailed workflow documentation
- E7 - Quota Management - Quota system epic
- E2 - Match & Stadium Management - Match management epic
- E14 - Reporting & Analytics - Reporting features
Last Updated: January 2026