A Flask-based web application for managing golf trip scoring, including individual and team leaderboards, scorecards, and certificate generation. Designed for multi-day golf events with persistent data storage and containerized deployment.

• Player Management: Track players and their handicap indexes.
• Course Management: Supports multiple courses with hole-by-hole par and stroke index.
• Scorecard Input: Enter and save strokes per player per hole for each day.
• Stableford Scoring: Automatic calculation of Stableford points based on net scores.
• Leaderboards: Live leaderboards for individuals, doubles, and four-player teams.
• PDF Certificates: Generate and download achievement certificates for players and teams.
• Authentication: Simple password-protected login.
• Data Persistence: All data stored in a SQLite database.
• Responsive UI: Mobile-friendly HTML/CSS templates.
• Containerized: Ready for deployment with Podman or Docker.

• Backend: Python 3, Flask, Flask-SQLAlchemy, Flask-Migrate
• Frontend: HTML, CSS, JavaScript (with jsPDF and html2canvas for PDF export)
• Database: SQLite
• Containerization: Podman (or Docker) with podman-compose
• PDF Generation: reportlab (for backend), jsPDF/html2canvas (for frontend)

git clone https://github.com/yourusername/golf.git
cd golf

pip install -r requirements.txt

flask db upgrade

flask run

Or with Gunicorn (recommended for production):

gunicorn --bind 0.0.0.0:8585 app:app

Open your browser to http://localhost:5000 or the port you specified.

• Use the provided Dockerfile and podman-compose.yml for containerized deployment.

podman-compose build --no-cache
podman-compose up -d

• The app will be available on port 8585 by default.
• Data is persisted in the golf_data volume.

• Players, teams, and courses: Update via the database or admin scripts.
• Course schedule: Edit COURSE_MAP in app.py.
• Team assignments: Edit doubles_teams and four_teams in templates/leaderboard.html.
• Course/hole data: Seeded via entrypoint.sh and migrations.
• App password: Set APP_PASSWORD env variable (default: golfer123).
• Secret key: Set SECRET_KEY env variable (default: devkey).

See Documentation/input.md for details on updating players, teams, and course details.

MIT License

• For requirements and implementation details, see Documentation/golf_trip_requirements.md.