Datwyler Shooting Event System

Production-ready full-stack web app based on your original live score concept.

Stack

• Frontend: Vue 3 + Vite (pnpm)
• Backend: Go + Echo
• Database: SQLite
• Packaging: Single Docker image (frontend + backend)

Main Features

• Bilingual UI: Arabic and English
• Runtime RTL/LTR switching
• Admin avatar crop/fit tool (drag + zoom before saving)
• AI score advisor for proof images (Gemini-powered suggestion + optional apply)
• Two clean modes:
  • View Only screen for players/coaches/audience
  • Admin Control Panel (login required)
• Admin credentials (default):
  • Username: datwyler
  • Password: datwyler

Tournament Flow Implemented

1. Admin registers players and assigns groups (no hard 6-player limit).
2. View screen shows group assignment clearly.
3. Admin enters preliminary scores.
4. Overall ranking auto-calculates and highlights top 12 finalists.
5. If rank #12 cutoff is tied, qualification tie-break stage appears.
6. Top 12 split into final groups (1-6 and 7-12 seeds).
7. Admin enters final scores.
8. Podium is determined automatically.
9. If top-3 tie exists, podium tie-break stage appears.

API Documentation (OpenAPI)

Interactive docs are now built in:

• Swagger UI: GET /api/docs
• OpenAPI JSON: GET /api/openapi.json

Testing with Auth in Swagger UI

1. Open /api/docs.
2. Use the Login & Authorize form at the top:
   • Username: datwyler (default)
   • Password: datwyler (default)
3. The page calls POST /api/admin/login, retrieves the token, and auto-authorizes Swagger.
4. Use Try it out on any admin endpoint.

Stage Values

For score update/proof/advice endpoints (/api/admin/scores/{stage}/...), use:

• prelim_r1
• prelim_r2
• prelim_r3
• final_r1
• final_r2
• prelim_tiebreak
• final_tiebreak

For reset endpoint (POST /api/admin/scores/{stage}/reset), use:

• preliminary
• final
• prelim_tiebreak
• final_tiebreak

Local Development

Install dependencies:

make install

Run backend + frontend together:

make dev

Notes:

• Backend dev port is 18081.
• Frontend runs on 5173 (or next free port, e.g. 5174 if busy).
• Frontend proxy is configured so /api/* works from Vite dev server.

Run individually:

make dev-backend
make dev-frontend

Build

make build

This builds frontend assets, copies them into backend web/, and compiles backend binary.

Docker

Build image:

make docker-build ARCH=amd64
# or
make docker-build ARCH=arm64

Run image:

make docker-run ARCH=amd64
# or
make docker-run ARCH=arm64

Docker Compose (Production)

1. Copy environment template:

cp .env.example .env

2. Edit .env for production credentials/tag.

3. Start service:

docker compose up -d

4. Check health:

docker compose ps

5. View logs:

docker compose logs -f

Runtime Environment Variables

• PORT (default 8080)
• DB_PATH (default ./data/shooting.db)
• WEB_DIR (default ./web)
• ADMIN_USER (default datwyler)
• ADMIN_PASS (default datwyler)
• GEMINI_API_KEY (required for AI score advisor)
• GEMINI_MODEL (default gemini-2.0-flash)