# RivalPerk — Sports Gamification & Instant Win Rewards Platform

> RivalPerk is a specialized B2B SaaS platform that enables hospitality venues (sports bars, burger chains), sports clubs (padel centers, football clubs, motorsport fans), marketing agencies, and sports e-commerce brands to launch automated sports prediction games combined with instant win rewards (roulette and scratch cards) in 100% white-label mode.

## System Capabilities
- Automated sports fixtures fetched by API (LaLiga, UEFA Champions League, Premier League, Formula 1, MotoGP, Premier Padel, Primera RFEF).
- Dual Engine: 10-second sports prediction + immediate Instant Win prize reveal.
- Live Venue TV Mode (16:9 format) with real-time leaderboard, live ticker, and giant scannable QR code.
- Anti-fraud tamper-proof voucher generator with real-time redemption scanner for staff.
- Google Maps Review Booster: rewards users with +3 bonus points for leaving a 5-star review.
- Full regulatory compliance under EU GDPR (Regulation 2016/679), Spanish LOPD-GDD, LSSI-CE, and European Accessibility Act (WCAG 2.1 AA / Directive 2019/882).

## Machine-Readable Endpoints & Manifests
- Agent Manifest: /api/agent-manifest.json
- Full LLM Documentation: /llms-full.txt
- Browser Bridge: window.__RIVAL_PERK_AGENT__ (accessible via headless browser evaluate)

## Core Agent Actions
Browser agents (Puppeteer, Playwright, Claude Computer Use, OpenAI Operator) can navigate and execute tasks using standardized DOM selectors:
- `[data-agent-action="increase-home-score"]`: Increments home team predicted score.
- `[data-agent-action="decrease-home-score"]`: Decrements home team predicted score.
- `[data-agent-action="increase-away-score"]`: Increments away team predicted score.
- `[data-agent-action="decrease-away-score"]`: Decrements away team predicted score.
- `[data-agent-action="select-bonus-option"]`: Selects the bonus prediction answer.
- `[data-agent-action="input-lead-name"]`: Sets participant name for leaderboard.
- `[data-agent-action="input-lead-phone"]`: Sets participant WhatsApp/phone number.
- `[data-agent-action="submit-prediction"]`: Submits the score and transitions to the Instant Win engine.
- `[data-agent-action="spin-roulette"]`: Triggers the lucky roulette spin.
- `[data-agent-action="redeem-voucher"]`: Staff voucher redemption action.

## Legal Exemption
Under Spanish Gaming Law (Ley 13/2011 art. 3) and European consumer promotions framework, RivalPerk is strictly a customer loyalty and promotional marketing tool. Participation is 100% free with no monetary stakes or deposits. No gambling operator license is required.