Badmiton Statistic

1. Description

This is a statistics tracker for doubles badminton. The app tracks players, records matches, and calculates their performance rating. It includes an interactive "Game" mode for scoring with gamepad and voice control support.

2. Data Management (JSON)

Load JSON: Completely replaces all current data with data from a selected badminton_db.json file.

Save JSON: Saves the entire current database to a badminton_db.json file in your "Downloads" folder.

3. Main Screens

Overall Stats: Main screen. Lists all players sorted by rating.

Daily Stats: Player ratings and stats calculated only for a single selected day.

Daily Report: A chronological list of all matches played on the selected day.

Game: Interactive screen for real-time scoring.

4. "Game" Screen (Interactive Scoring)

Player Setup

Select: Tap a player in the list on the left to "select" them (highlights).

Place: Tap an empty green quadrant to place the selected player.

Swap: Tap the first player (highlights red), then tap the second player. They will swap.

Remove: Press and hold (long tap) a quadrant with a player.

Temporary Players:

Add: Tap an empty quadrant (without a player selected) to get a name prompt.

Manage: Long tap an empty quadrant to toggle the list to "Temporary Players". In this mode, a long tap on a name allows renaming or deleting.

Game Management (Buttons)

Left / Right: Selects the first serving team.

Start: Begins the game with the 4 players placed.

Reset: (If unlocked) Clears all players from the court.

Lock / Unlock: Locks the court and keeps the screen awake.

+1 Left / +1 Right: Adds a point. The app automatically handles server rotation and side switches (at 11 points).

Undo: Undoes the last point added.

Save Game: Appears after the match is finished. Saves the game to stats.

🔊 (Long Tap): Activates voice control for player setup.

5. Gamepad Controls ("Game" Screen)

D-Pad UP: Point for the right team.

D-Pad DOWN: Point for the left team.

(Referee Mode: If active, UP is point for ref's opponent, DOWN is point for ref's team).

D-Pad LEFT / RIGHT: Adjusts volume (if toggled by "A").

Button A (Cross): Toggles D-Pad volume control.

Button B (Circle): Announce current score (TTS).

Button X (Square) (DOUBLE TAP): Rotates all players clockwise and starts a new game at 0-0.

Button Y (Triangle): Saves the game and suggests a new team composition.

Button START: Undo last point.

6. Voice Control

Player Setup ("Game" Screen): Long tap the 🔊 button. Say 4 names (e.g., "Max, Mark, Mike, Alex"). The app places them and starts the game.

Add Game ("Daily Report" Screen): Press 🎙️ Voice +. Say 4 names and 2 scores (e.g., "Alex and Max 21, Mark and Mike 15"). The game is added to the selected day's report.

7. Player & Report Management

Add Player: On the "Overall Stats" screen, enter a name and tap "Add".

View/Edit: Tap a player's name in "Overall Stats" to open their details page.

On Player Page:

You can "Rename" or "Delete" the player.

You can add a game manually.

Tapping a date in the list shows all games for that day (with "Edit" or "X" delete options).

Export Reports: "Export to JPG" (Save) and "Share" (Send) buttons are available on all three stats screens.

8. Rating Calculation

The Rating (WeightedScore) is calculated using two factors:

Average Points per Game (A 21-5 win is better than 21-19).

Experience (Total Games): Acts as a rating multiplier (log(TotalGames) + 1). The system rewards players who play often and consistently well.