hermes-skills/skills/devops/python-web-service-deployment/references/shark-game-session.md

Shark Attack Fantasy Game (Feeding Frenzy) — Session Notes

Overview

Built Jul 8, 2026. A fantasy sports-style game where players draft coastal regions and score points from real shark incidents classified by AI.

Current State — Frontend Connected to API

Built

• Three frontend pages at /var/www/shark-game/ connected to real API:
  • index.html — Registration/login with JWT storage, league creation/join, auto-redirect
  • draft-room.html — Full draft board with turn enforcement, 4 tabs (draft, team, leaderboard, league info), commissioner start-draft, invite copy, live scores
  • league.html — Standalone league settings page
• Caddy config: shark.iamgmb.com → serves static files + proxies /api/* to :8083
• DNS: A record shark.iamgmb.com → 152.53.192.33 (Cloudflare, proxied)
• FastAPI backend at /root/shark-game/backend/server.py (SQLite, auth, draft, snake scoring)
• All 30+ API endpoints verified — auth, leagues, join, draft snake-order, score events, leaderboard

Building (subagents in progress)

• AI scraper at /root/shark-game/scraper/scrape.py (Firecrawl + admin-ai classification)

Still Needed

• Daily summary + scoring notifications
• Postseason wrap-up
• Live draft polling (auto-refresh every 5s during active draft)

Design Notes

• 12 regions, pre-populated with prior-year stats
• Scoring: sighting=1pt, bite=5pts, fatality=10pts
• Snake draft: 2-3 rounds, order reverses each round
• Regions lock on selection — no duplicate picks
• Post-draft AI analysis with letter grades
• Mobile-first PWA