ShuttleHero Knowledge Hub

Your complete guide to tournament management, live scoring, and player identity. Follow the visual workflows below to master the platform.

Role Hierarchy Entity Map Organizer Workflow Referee Workflow Player Profiles Player Stats General FAQ
← Back to Home

1. User Role Hierarchy

ShuttleHero uses a tiered permission system to ensure data integrity and operational security.

graph TD SuperAdmin[Super Admin] --> OrgOwner[Organization Owner] OrgOwner --> Admin[Tournament Admin / Organizer] Admin --> TeamMember[Team Member / Scorer] Admin --> Referee[Referee / Umpire] Admin --> Player[Player] TeamMember --> OrgMgmt[Assist Org Ops] Referee --> Match[Live Match Management] Player --> Profile[Personal Profile & Stats] Fan[Fan / Spectator] -.-> PublicView[Browse & Follow Live]

Super Admin

  • Platform-wide oversight
  • Manages all users & orgs
  • Handles account suspensions

Org Owner

  • Owns the business entity
  • Manages subscriptions & billing
  • Invites Team Members

Team Member

  • Assists in organization ops
  • Can manage tournaments/players
  • Role-based access (Admin/Scorer)

2. Core Relationships

Understanding how Organizations, Tournaments, and Players connect is key to efficient setup.

erDiagram ORGANIZATION ||--o{ TOURNAMENT : "owns & manages" ORGANIZATION ||--o{ ORG_MEMBER : "has team" APP_USER ||--o{ ORG_MEMBER : "belongs to" TOURNAMENT ||--o{ CATEGORY : "defines rules" TOURNAMENT ||--o{ MATCH : "schedules" CATEGORY ||--o{ MATCH : "groups by skill/age" CATEGORY }o--o{ PLAYER : "registers" MATCH }o--|| PLAYER : "singles participants" MATCH }o--|| TEAM : "doubles participants" TEAM }o--|| PLAYER : "consists of 2 players"
Pro Tip: An Organization can host multiple Tournaments simultaneously, each with its own set of categories (e.g., Open, Under-19, Masters).

3. Tournament Organizer Workflow

ShuttleHero is organization-centric. All tournaments must belong to an Organization. Follow this end-to-end flow to move from a new event to a completed tournament.

flowchart TD Start((Start)) --> SelectOrg[Select Organization] SelectOrg --> CreateTourney[Create Tournament] CreateTourney --> SetupCats[Setup Categories
Age/Gender/Skill] SetupCats --> IntakePlayers[Add/Import Players] IntakePlayers --> AssignCats[Assign Players to Categories] AssignCats --> GenDraws[Generate Bracket Draws] GenDraws --> ReviewDraws{Review Draws?} ReviewDraws -- Needs Adjust --> GenDraws ReviewDraws -- Verified --> LockDraws[Lock Draws] LockDraws --> LivePlay[Monitor Live Play] LivePlay --> ExportResults[Export PDF/Excel Results] ExportResults --> End((End))
1
Category Setup: Define age bands (U15, U17) and skill levels. Use suggest-logic to match player DOBs to correct categories.
2
Draw Generation: ShuttleHero automatically handles BYEs and seeding for up to 512 participants using BWF standard single-elimination logic.
3
Review & Confirm: Before finalizing registration, Organizers see a clear summary of their new Organization details to ensure accuracy.
4
Draw Locking: CRITICAL Once a draw is locked, it cannot be regenerated. This protects the integrity of the live tournament.

4. Referee Live Scoring Workflow

Referees use the mobile-optimized interface to track every point of the match.

flowchart TD MatchReady((Match Ready)) --> OpenMatch[Open Match Dashboard] OpenMatch --> StartMatch[Click Start Match] StartMatch --> RecordPoint[Record Point Scored] RecordPoint --> Mistake{Mis-click?} Mistake -- Yes --> Undo[Click Undo] Undo --> RecordPoint Mistake -- No --> SetEnd{Set Finished?} SetEnd -- No --> RecordPoint SetEnd -- Yes --> CompleteSet[Complete Set] CompleteSet --> MatchEnd{Match Finished?} MatchEnd -- No --> RecordPoint MatchEnd -- Yes --> CompleteMatch[Finalize Match Result] CompleteMatch --> LiveSync((Live Updates Synced))
Exceptions: If a player is injured or fails to show up, use the Exception menu to mark "No Show", "Injured", or "DQ". The system will automatically forfeit the match and advance the opponent.

5. Player Identity & Profiles

Your ShuttleHero Profile is your digital passport in the world of racket sports. It tracks your history across different tournaments and organizations.

flowchart TD SignUp[Sign Up as Player] --> OnboardStep1[Profile Setup
Bio, Style, Visibility] OnboardStep1 --> OnboardStep2[Search Past Results
by Name + Mobile] OnboardStep2 --> ResultsFound{Results Found?} ResultsFound -- Yes --> ClaimResults[Claim Profile & History] ResultsFound -- No --> SkipClaim[Skip / New Profile] ClaimResults --> OnboardStep3[Aadhaar & Verification] SkipClaim --> OnboardStep3 OnboardStep3 --> Done((Ready to Play!))

Permanent Registration ID (SH-ID)

Every player is assigned a permanent ID (e.g., SH-B2026000042). This ID ensures your match history is unified, regardless of which club or city you play in.

Aadhaar Verification

For secure check-ins, we store only the last 4 digits of your Aadhaar (e.g., XXXX XXXX 1234). This helps organizers verify your identity at the venue while keeping your full data private.

Privacy & Visibility

Manage your presence with simplified visibility controls: Public (visible in directory/leaderboards) or Private (visible only to you and tournament organizers).

Profile Claiming: If you've played as a guest in past tournaments, you can "Claim" those records during onboarding to instantly populate your stats and history.

6. Performance Tracking & Stats

ShuttleHero uses an advanced (yet simple) rating engine to track your progress and award milestones.

The Rating Formula

Your base rating starts at 1,000. It gains +15 per win, -8 per loss, and a massive +50 bonus for every Tournament Title you win.

Match Form & Streaks

View your Recent Form strip (last 10 matches) to see your current momentum. Earn "Win Streak" badges for hitting 5 or 10 consecutive victories.

Achievement Badges

Earn digital badges for milestones like "First Win", "Comeback King", or "Category Champion". These are displayed prominently on your public profile.

Asynchronous Computation: To ensure a fast experience, your stats and achievements are computed in the background immediately after a match is finalized by the referee.

7. General FAQ

How do Organizations work?

Every tournament is owned by an Organization. You can be a member of multiple organizations and switch between them using the selector in your Admin Dashboard.

Can I invite team members?

Yes. Organization Owners can go to the "Team" tab to invite members. We've added a Type-ahead Search to easily find existing users by name or email. If the user isn't on ShuttleHero yet, just type their mobile number or email to send an invite.

What is a Super Admin?

Super Admins are platform-level moderators who can manage all users, organizations, and audit logs to ensure platform safety and integrity.

How do I export results?

Admins can go to the Tournament Dashboard and click "Export PDF" for visual brackets or "Export Excel" for raw data processing.

Can players see their stats?

Yes. Once a player claims their profile, they can see win/loss ratios, computed ratings, and full tournament history on their dashboard.

Is doubles scoring supported?

Absolutely. The system tracks partner names, team names, and server rotation for both singles and doubles matches.