About This Golf App

A quick overview of what the app does and what each key screen is used for.

What the app does

Tuesday Thrash is a golf competition app that helps players and admins run weekly and season-long competitions. It covers account login, club and competition entry, handicap capture, hole-by-hole score submission, and leaderboard tracking.

  • Member signup/login and optional social login
  • Club-based competition discovery and entry
  • Handicap and playing handicap workflow
  • Hole-by-hole score entry with Stableford points
  • Weekly results, Top 10, Eclectic, and personal score history
  • Admin management for clubs, courses, competitions, and entries
  • PWA support with offline sync behaviour

Core member journey

  1. Sign up or log in
  2. Join one or more clubs
  3. Enter available competitions
  4. Enter handicap for the selected competition
  5. Submit hole-by-hole scores
  6. Review weekly leaderboard, Top 10, Eclectic, and your scores

Main screens

Public and account screens

  • Home (`/`) — landing page and navigation.
  • Login (`/login`) — sign in to your account.
  • Sign Up (`/signup`) — create a new account.
  • Forgotten Password (`/forgotten_password`) — request reset email.
  • Reset Password (`/reset_password/<token>`) — set a new password.
  • Rules / Privacy / Change Log — policy and guidance pages.

Member competition screens

  • Competitions Dashboard (`/profile`) — view clubs, competitions, and actions.
  • Add Club (`/profile_add_club`) — join additional clubs.
  • Enter Competition (`/enter_competition/<competition_id>`) — add yourself to an event.
  • Enter Handicap (`/enter_handicap/<user_id>/<competition_id>`) — capture handicap inputs.
  • Enter Scores (`/enter_scores/<user_id>/<competition_id>`) — submit weekly scorecard.
  • Edit Scores (`/edit_scores/<user_id>/<competition_id>/<score_id>`) — amend an existing card (permissions apply).

Leaderboard screens

  • Weekly Scores (`/competitions_scores/<competition_id>`) — per-week leaderboard and winners.
  • Your Scores (`/competitions_user_scores/<competition_id>`) — your submitted rounds.
  • Top 10 (`/competitions_best_scores/<competition_id>`) — best-score aggregate view.
  • Eclectic (`/competitions_eclectic/<competition_id>/<quarter>/<scoring>`) — best-hole composite view.

Admin screens

  • Admin Home (`/_admin`) — admin entry point.
  • Users / Countries / Clubs / Courses — manage master data.
  • Competitions (`/competitions`, `/competitions_manage`) — create and configure competitions.
  • Entries and Sub-Competitions — manage participants and subgroup membership.
  • Course Import (`/import_courses_search`) — import course data from external API.

Competition rules built into the app

  • Optional win-deduction competitions can carry a winner penalty into a player’s next played week.
  • Admins can finalize/reopen weeks to commit or reprocess deduction state.
  • Duplicate score protection helps prevent multiple entries for the same user/day/competition.
  • Score edits are permission-checked and time-limited for non-admin users.