Skip to main content

Troubleshooting

Common issues and fixes in Tee Time.

Enrichment missing on slots​

  • Cause: nearest hourly record > 30 minutes away or forecast fetch failed.
  • Fix: verify OPENMETEO_* env; check geocoding fallback; see logs from WeatherService.

Bridge errors / partial tee sheets​

  • Cause: upstream payload missing courses or parsing failures.
  • Fix: logs indicate skipped courses; inspect LongDesc/ShortDesc formats.

Pricing unexpected​

  • Cause: visibility filters (phone‑booking flags), holiday fallback, or ball count.
  • Fix: use rules‑engine helpers to list applicable rules; check club config flags.

Idempotency lock busy​

  • Cause: concurrent booking with same externalRef.
  • Fix: retry after TTL; always set externalRef for idempotent clients.

GeoIP errors​

  • Cause: MaxMind DB path missing or web API credentials invalid.
  • Fix: set MAXMIND_MODE and either MAXMIND_DB_PATH or MAXMIND_ACCOUNT_ID/ LICENSE_KEY.