World Cup Tournament Backend

Overview

A Spring Boot backend service for managing virtual World Cup tournaments in a mobile game, including user participation, leaderboards, and rewards.

This project implements a robust backend service for a mobile game that simulates World Cup tournaments. Users from different countries (Turkey, United States, United Kingdom, France, or Germany) can join tournaments if they meet level and coin requirements. The system creates balanced tournament groups with 5 users each from different countries, maintains real-time leaderboards, and handles reward distribution based on user rankings. The architecture follows clean design principles with distinct layers for entities, repositories, services, and controllers.

Features

• User eligibility validation for tournament participation
• Balanced tournament group creation with country diversity
• Real-time group and country leaderboards
• Automated reward distribution based on tournament rankings
• Scheduled tournament creation using Spring's @Scheduled
• Transactional data consistency with @Transactional
• Clean architecture with separation of concerns
• Comprehensive exception handling for business rule violations