How tuckerbrewer12/birdieeyeview works
BirdieEyeView is a golf scorecard capture and performance-tracking app. Its central workflow is to photograph a scorecard, review and correct extracted details, save a hole-by-hole round, then use accumulated rounds for analytics and improvement insights. The graph includes the documented OCR/LLM and goal capabilities, but some backend routes and extraction internals were not sampled; those links rely on the README. Optional report storage is shown separately.
Main entry points: main.py API entry · scan_service.py Scan extraction · db_manager.py Data manager · stats.py Round analytics
Components 25
App experience
- Web app
frontend/src/App.tsx - Scan review
frontend/src/pages/scan/useScanReviewViewModel.ts - Scan client
frontend/src/data/scanRepository.ts
API workflows
- API entry
api/main.py - Scan routes
api/routers/scan.py - Round routes
api/routers/rounds.py - Analytics routes
api/routers/stats.py - AI insights
api/routers/ai_insights.py - Scan extraction
services/scan_service.py - Account access
api/routers/auth.py - AI analysis
services/ai_service.py
Golf data
- Round model
models/round.py - Data manager
database/db_manager.py - Data repositories
database/repositories - PostgreSQL
Analytics and insights
- Round analytics
analytics/stats.py - Handicap
analytics/handicap.py - Round eligibility
analytics/eligibility.py
External services
- Scorecard OCR
services/mistral_ocr_service.py - Course lookup
services/golfcourse_api_service.py - Mistral
- Gemini
- Scan report storage
services/scan_report_storage.py - S3-compatible store
Other components
- Golfer
Connections 28
- Golfer → Web app: uses
- Web app → Scan review: routes to
frontend/src/App.tsx - Scan review → Scan client: saves through
frontend/src/pages/scan/useScanReviewViewModel.ts - Scan client → Scan routes: submits scan
- API entry → Scan routes: registers
api/main.py - API entry → Round routes: registers
api/main.py - API entry → Analytics routes: registers
api/main.py - API entry → AI insights: registers
api/main.py - API entry → Account access: registers
api/main.py - Scan routes → Scan extraction: extracts with
- Scan extraction → Scorecard OCR: prefetches OCR
- Scorecard OCR → Mistral: calls
- Scan extraction → Gemini: uses extraction
- Scan extraction → Course lookup: looks up courses
services/scan_service.py - Scan extraction → Data manager: saves round
services/scan_service.py - Scan extraction → Round model: builds round
- Round routes → Data manager: reads and saves
- Data manager → Data repositories: delegates to
database/db_manager.py - Data repositories → PostgreSQL: queries
- Analytics routes → Round analytics: requests metrics
- AI insights → AI analysis: requests insights
- AI analysis → Round analytics: uses analytics
services/ai_service.py - AI analysis → Data manager: loads data
services/ai_service.py - Round analytics → Round eligibility: filters rounds
analytics/stats.py - Round analytics → Handicap: uses handicap
analytics/stats.py - Account access → Data manager: uses accounts
api/routers/auth.py - API entry → Scan report storage: configures optionally
api/main.py - Scan report storage → S3-compatible store: stores reports
services/scan_report_storage.py