Home > Development > Guides > Working With > ---

Tournament UI Implementation Plan

Overview

This document outlines the complete UI implementation plan for tournament features in the Archery Apprentice app. The plan is organized by implementation phases and priority levels based on our established repository layer and database foundation.

Implementation Foundation ✅

Completed Infrastructure

Database Layer: Migration 27→28 completed with tournament integration fields
Repository Layer: Three tournament repository implementations completed
- FirebaseTournamentRepository - Online tournament operations with Firestore
- OfflineTournamentRepository - Full offline tournament functionality
- HybridTournamentRepository - Offline-first with automatic sync
Data Models: Complete tournament domain models with security, privacy, and anti-cheating
Authentication Foundation: Firebase Auth integration with account linking ready

Phase 1: Core Tournament Discovery & Creation (Priority: HIGH)

1.1 Tournament Discovery Screen

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentDiscoveryScreen.kt

Features:

Real-time tournament search and filtering
Location-based tournament discovery (within radius)
Tournament category filtering (Indoor, Outdoor, Field, 3D)
Distance and skill level filters
Tournament status indicators (Open, Full, In Progress, Completed)

UI Components:

@Composable
fun TournamentDiscoveryScreen(
    navController: NavHostController,
    tournamentRepository: TournamentRepository,
    viewModel: TournamentDiscoveryViewModel
)
 
// Key composables:
- TournamentSearchBar()
- TournamentFilterChips()
- TournamentListItem()
- LocationPermissionHandler()
- EmptyDiscoveryState()

1.2 Tournament Creation Screen

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentCreationScreen.kt

Features:

Multi-step tournament creation wizard
Basic info: name, description, location, dates
Format configuration: category, division, scoring system
Participant settings: capacity, skill requirements, registration deadline
Privacy controls: public/private, invite-only options
Anti-cheating settings: witness requirements, verification rules

UI Components:

@Composable
fun TournamentCreationScreen(
    navController: NavHostController,
    tournamentRepository: TournamentRepository,
    viewModel: TournamentCreationViewModel
)
 
// Key composables:
- CreationWizardStepper()
- BasicInfoForm()
- FormatConfigurationForm()
- ParticipantSettingsForm()
- PrivacyControlsForm()
- AntiCheatSettingsForm()
- TournamentPreview()

1.3 Tournament Details Screen

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentDetailsScreen.kt

Features:

Complete tournament information display
Participant list and registration status
Round schedule and format details
Leaderboard preview (if tournament started)
Registration/withdrawal actions
Tournament sharing capabilities

UI Components:

@Composable
fun TournamentDetailsScreen(
    navController: NavHostController,
    tournamentId: String,
    tournamentRepository: TournamentRepository,
    viewModel: TournamentDetailsViewModel
)
 
// Key composables:
- TournamentHeader()
- ParticipantList()
- RoundSchedule()
- RegistrationActions()
- LeaderboardPreview()
- ShareTournamentButton()

Phase 2: Tournament Registration & Management (Priority: HIGH)

2.1 Tournament Registration Flow

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentRegistrationScreen.kt

Features:

Division and category selection
Equipment verification and declaration
Witness designation (for verification requirements)
Terms and conditions acceptance
Registration confirmation

2.2 My Tournaments Screen

File: app/src/main/java/com/archeryapprentice/ui/tournament/MyTournamentsScreen.kt

Features:

Organized tournament views: Registered, Hosting, Completed
Tournament status tracking and notifications
Quick actions: view details, withdraw, manage
Tournament history and statistics

2.3 Tournament Management Screen (Host View)

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentManagementScreen.kt

Features (Host Only):

Participant management: approve/reject registrations
Tournament settings modification
Round schedule management
Communication tools: announcements, messages
Tournament control: start, pause, end

Phase 3: Tournament Scoring Integration (Priority: HIGH)

3.1 Tournament Round Selection

Integration: Extend existing RoundScoringScreen.kt

Features:

Tournament round selection during round creation
Automatic tournament format application
Participant verification for tournament rounds
Round synchronization indicators

UI Changes:

// Add to existing RoundCreationScreen:
- TournamentRoundSelector()
- TournamentFormatApplier()
- ParticipantVerificationStep()
- SyncStatusIndicator()

3.2 Tournament Scoring Enhancements

Integration: Extend existing ActiveScoringScreen.kt

Features:

Tournament mode indicator and constraints
Real-time leaderboard position tracking
Witness verification prompts (when required)
Tournament sync status and conflict resolution

UI Enhancements:

// Add to existing ActiveScoringScreen:
- TournamentModeHeader()
- LeaderboardPositionIndicator()
- WitnessVerificationDialog()
- SyncConflictResolver()

3.3 Tournament Round Details

Integration: Extend existing RoundDetailsScreen.kt

Features:

Tournament context display
Leaderboard position and ranking
Tournament-specific statistics
Score verification status
Sync history and status

Phase 4: Leaderboards & Results (Priority: MEDIUM)

4.1 Tournament Leaderboard Screen

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentLeaderboardScreen.kt

Features:

Real-time tournament standings
Division and category filtering
Round-by-round score progression
Participant performance analytics
Export and sharing capabilities

4.2 Tournament Results Screen

File: app/src/main/java/com/archeryapprentice/ui/tournament/TournamentResultsScreen.kt

Features:

Final tournament results and awards
Performance analytics and insights
Comparison with historical performance
Certificate and achievement generation
Social sharing capabilities

Phase 5: Advanced Features (Priority: LOW)

5.1 Tournament Analytics Dashboard

Features:

Tournament hosting analytics (for organizers)
Participation history and trends
Performance metrics across tournaments
Comparative analysis tools

Features:

Tournament chat and communication
Photo sharing and gallery
Participant profiles and connections
Tournament reviews and ratings

5.3 Tournament Notifications

Integration: Extend existing notification system

Features:

Tournament registration confirmations
Round start notifications
Leaderboard position updates
Tournament announcements
Score verification requests

ViewModel Architecture

Core ViewModels to Implement

// Discovery and browsing
class TournamentDiscoveryViewModel(
    private val tournamentRepository: TournamentRepository,
    private val locationService: LocationService
)
 
// Tournament lifecycle management
class TournamentCreationViewModel(
    private val tournamentRepository: TournamentRepository,
    private val authRepository: AuthenticationRepository
)
 
class TournamentDetailsViewModel(
    private val tournamentRepository: TournamentRepository
)
 
// Tournament participation
class MyTournamentsViewModel(
    private val tournamentRepository: TournamentRepository,
    private val authRepository: AuthenticationRepository
)
 
// Tournament scoring integration
class TournamentScoringViewModel(
    private val tournamentRepository: TournamentRepository,
    private val roundRepository: RoundRepository
)
 
// Results and analytics
class TournamentLeaderboardViewModel(
    private val tournamentRepository: TournamentRepository
)
 
// Management (host features)
class TournamentManagementViewModel(
    private val tournamentRepository: TournamentRepository,
    private val authRepository: AuthenticationRepository
)

File: app/src/main/java/com/archeryapprentice/ui/tournament/navigation/TournamentNavGraph.kt

@Composable
fun TournamentNavGraph(
    navController: NavHostController,
    repositoryFactory: RepositoryFactory
) {
    navigation(
        startDestination = "tournament_discovery",
        route = "tournament"
    ) {
        composable("tournament_discovery") { /* TournamentDiscoveryScreen */ }
        composable("tournament_creation") { /* TournamentCreationScreen */ }
        composable("tournament_details/{tournamentId}") { /* TournamentDetailsScreen */ }
        composable("tournament_registration/{tournamentId}") { /* TournamentRegistrationScreen */ }
        composable("my_tournaments") { /* MyTournamentsScreen */ }
        composable("tournament_management/{tournamentId}") { /* TournamentManagementScreen */ }
        composable("tournament_leaderboard/{tournamentId}") { /* TournamentLeaderboardScreen */ }
        composable("tournament_results/{tournamentId}") { /* TournamentResultsScreen */ }
    }
}

Implementation Timeline

Week 1-2: Foundation & Discovery

TournamentDiscoveryScreen implementation
TournamentDetailsScreen implementation
Basic navigation setup

Week 3-4: Creation & Registration

TournamentCreationScreen implementation
TournamentRegistrationScreen implementation
MyTournamentsScreen implementation

Week 5-6: Scoring Integration

Tournament mode integration with existing scoring screens
Tournament round creation and management
Sync status and conflict resolution UI

Week 7-8: Leaderboards & Results

TournamentLeaderboardScreen implementation
TournamentResultsScreen implementation
Analytics and reporting features

Week 9-10: Advanced Features & Polish

Tournament management features (host view)
Social features and communications
Performance optimization and testing

Success Criteria

Phase 1 Success Metrics

Users can discover and view tournament details
Tournament creation flow completes successfully
Registration process works end-to-end
Tournament data syncs correctly between online/offline modes

Phase 2 Success Metrics

Tournament rounds integrate seamlessly with existing scoring
Real-time leaderboards update correctly
Offline tournament functionality works without network
Score verification and anti-cheating measures function properly

Phase 3 Success Metrics

Complete tournament lifecycle supported (creation → participation → results)
Tournament host management tools functional
Tournament analytics and reporting available
Social features and community engagement working

Firebase-Integration-Plan - Complete Firebase integration strategy
Tournament-Discovery - Phase 2 tournament discovery implementation
Firebase-Setup - Firebase configuration guide
System-Architecture - Overall system architecture

Last Updated: 2025 Source: docs/tournament/TOURNAMENT_UI_IMPLEMENTATION_PLAN.md

Archery Apprentice Documentation

Explorer

Tournament UI Implementation Plan

Tournament UI Implementation Plan

Overview

Implementation Foundation ✅

Completed Infrastructure

Phase 1: Core Tournament Discovery & Creation (Priority: HIGH)

1.1 Tournament Discovery Screen

1.2 Tournament Creation Screen

1.3 Tournament Details Screen

Phase 2: Tournament Registration & Management (Priority: HIGH)

2.1 Tournament Registration Flow

2.2 My Tournaments Screen

2.3 Tournament Management Screen (Host View)

Phase 3: Tournament Scoring Integration (Priority: HIGH)

3.1 Tournament Round Selection

3.2 Tournament Scoring Enhancements

3.3 Tournament Round Details

Phase 4: Leaderboards & Results (Priority: MEDIUM)

4.1 Tournament Leaderboard Screen

4.2 Tournament Results Screen

Phase 5: Advanced Features (Priority: LOW)

5.1 Tournament Analytics Dashboard

5.2 Tournament Social Features

5.3 Tournament Notifications

ViewModel Architecture

Core ViewModels to Implement

Navigation Integration

Tournament Navigation Graph

Implementation Timeline

Week 1-2: Foundation & Discovery

Week 3-4: Creation & Registration

Week 5-6: Scoring Integration

Week 7-8: Leaderboards & Results

Week 9-10: Advanced Features & Polish

Success Criteria

Phase 1 Success Metrics

Phase 2 Success Metrics

Phase 3 Success Metrics

Related Documentation

Graph View

Table of Contents