Claude/kind ptolemy 9 mvh0

.env.example

@@ -0,0 +1,76 @@
+# ============================================================
+# Bojo (Boiska Poznań) — zmienne środowiskowe
+# Skopiuj ten plik do .env i uzupełnij wartości.
+# NIGDY nie commituj pliku .env do repozytorium.
+# ============================================================
+
+# ----- Frontend (Next.js) — zmienne publiczne, widoczne w przeglądarce -----
+
+# Supabase: URL projektu, np. https://abcdefghijkl.supabase.co
+NEXT_PUBLIC_SUPABASE_URL=
+
+# Supabase: klucz publiczny "anon" (bezpieczny dla frontendu — chroniony przez RLS)
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+
+# Mapbox: token publiczny — używany TYLKO do miniatur zdjęć boisk (opcjonalny).
+# Bez niego mapa nadal działa (Leaflet + OpenStreetMap), znikają tylko miniaturki.
+# https://account.mapbox.com/
+NEXT_PUBLIC_MAPBOX_TOKEN=
+
+# Adres produkcyjny aplikacji — używany w sitemap.xml i znacznikach SEO.
+# np. https://bojo.app   (opcjonalny, domyślnie localhost)
+NEXT_PUBLIC_SITE_URL=
+
+# Włącznik rezerwacji w aplikacji ("true" = pokaż UI rezerwacji globalnie).
+# Można też włączyć per-obiekt flagą booking_enabled w bazie. (opcjonalny)
+NEXT_PUBLIC_FEATURE_RESERVATIONS=false
+
+# ----- Scraper / wzbogacanie danych — TYLKO lokalnie / w GitHub Actions -----
+# Te wartości NIGDY nie trafiają do frontendu. W GitHub Actions trzymaj je w Secrets.
+
+# Supabase: URL projektu (ta sama wartość co NEXT_PUBLIC_SUPABASE_URL)
+SUPABASE_URL=
+
+# Supabase: klucz service_role — pełny dostęp do bazy, OMIJA RLS.
+# Settings → API → service_role. Trzymaj w sekrecie!
+SUPABASE_SERVICE_ROLE_KEY=
+
+# Google Places API — dla enrich_google.py (telefon/strona/godziny).
+# https://console.cloud.google.com/
+GOOGLE_PLACES_API_KEY=
+
+# Anthropic (Claude) API — dla enrich.py i enrich_booking.py.
+# https://console.anthropic.com/
+ANTHROPIC_API_KEY=
+
+# Domyślny model Claude dla scrapera (opcjonalny).
+ANTHROPIC_MODEL=claude-haiku-4-5-20251001
+
+# ----- Supabase Edge Functions — sekrety (ustawiane przez `supabase secrets set`) -----
+# To NIE są zmienne .env frontendu. Ustaw je w projekcie Supabase, np.:
+#   supabase secrets set RESEND_API_KEY=...
+# Używane przez funkcje: notify-game-alert, send-invites, send-event-sms.
+
+# Resend — wysyłka e-maili (powiadomienia o grach, zaproszenia).
+# https://resend.com/api-keys   Nadawca: noreply@bojo.app (zweryfikuj domenę w Resend).
+RESEND_API_KEY=
+
+# SMSAPI.pl — wysyłka SMS (preferowany dostawca dla PL).
+# https://ssl.smsapi.pl/  → Ustawienia → Tokeny API
+SMSAPI_TOKEN=
+
+# Twilio — zapasowy dostawca SMS (używany, gdy SMSAPI zawiedzie).
+# https://console.twilio.com/
+TWILIO_ACCOUNT_SID=
+TWILIO_AUTH_TOKEN=
+TWILIO_PHONE_FROM=
+
+# ----- Logowanie / Auth (konfiguracja w panelu Supabase, nie w .env) -----
+# Authentication → Providers:
+#   • Google OAuth — Client ID/Secret z Google Cloud Console.
+#   • Email — włącz "Email" provider dla logowania e-mailem + hasłem i magic-linków.
+# Authentication → URL Configuration:
+#   • Site URL: https://bojo.app
+#   • Redirect URLs: dodaj https://bojo.app/auth/callback i https://bojo.app/auth/reset
+# Authentication → Emails (SMTP): podłącz Resend jako custom SMTP, inaczej maile
+#   potwierdzające / magic-linki są mocno limitowane (kilka/godzinę) na darmowym planie.

.github/workflows/analyze-venues-satellite.yml

@@ -0,0 +1,105 @@
+name: Analiza satelitarna boisk (AI)
+
+# Wykrywa typ boiska, nawierzchnię, wymiary, infrastrukturę
+# na podstawie zdjęcia satelitarnego Mapbox (zoom 18).
+#
+# Koszt szacunkowy:
+#   • claude-sonnet-4-6  → ~$0.010–0.015 / boisko  (vision input ~1000 tok, output ~300 tok)
+#   • claude-haiku-4-5   → ~$0.002–0.003 / boisko  (tańszy, nieco gorszy przy skomplikowanych obiektach)
+#   • 400 "quality" boisk (powiat poznański, mają jakieś info) → ~$4–6 Sonnet / ~$1 Haiku
+#   • Ponowna analiza wszystkich co miesiąc: zalecaj Haiku, Sonnet tylko przy pierwszym przebiegu
+#
+# Wymagane sekrety:
+#   SUPABASE_URL
+#   SUPABASE_SERVICE_ROLE_KEY
+#   ANTHROPIC_API_KEY
+#   MAPBOX_TOKEN                  (publiczny token z uprawnieniami styles:tiles)
+
+on:
+  schedule:
+    # Pierwszy piątek miesiąca, 03:00 UTC (niski ruch, tani czas)
+    - cron: '0 3 1-7 * 5'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Tryb podglądu — nic nie zapisuje'
+        default: true
+        required: false
+        type: boolean
+      limit:
+        description: 'Maks. liczba boisk (0 = wszystkie kwalifikujące się)'
+        default: '0'
+        required: false
+        type: string
+      all:
+        description: 'Przetwórz też już przeanalizowane (--all)'
+        default: false
+        required: false
+        type: boolean
+      overwrite:
+        description: 'Nadpisz istniejące pola (surface, is_indoor, lit…) wartościami AI'
+        default: false
+        required: false
+        type: boolean
+      model:
+        description: 'Model Claude'
+        default: 'claude-sonnet-4-6'
+        required: false
+        type: choice
+        options:
+          - claude-sonnet-4-6
+          - claude-haiku-4-5-20251001
+          - claude-opus-4-8
+      concurrency:
+        description: 'Równoległe requesty do API (1–2 dla Haiku, max 3 dla Sonnet)'
+        default: '1'
+        required: false
+        type: string
+      save_images:
+        description: 'Zapisz zdjęcia satelitarne do Supabase Storage (bucket: venue-satellites)'
+        default: false
+        required: false
+        type: boolean
+
+jobs:
+  analyze:
+    name: "Analiza satelitarna ${{ inputs.dry_run == true && '(DRY RUN)' || '(ZAPIS)' }}"
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: scraper/requirements.txt
+
+      - name: Zainstaluj zależności
+        working-directory: scraper
+        run: pip install httpx anthropic python-dotenv
+
+      - name: Zbuduj argumenty
+        id: args
+        run: |
+          LIMIT="${{ inputs.limit || '0' }}"
+          MODEL="${{ inputs.model || 'claude-sonnet-4-6' }}"
+          CONCURRENCY="${{ inputs.concurrency || '3' }}"
+          ARGS="--model $MODEL --concurrency $CONCURRENCY"
+          [ "$LIMIT" != "0" ] && ARGS="$ARGS --limit $LIMIT"
+          [ "${{ inputs.dry_run }}"   = "true" ] && ARGS="$ARGS --dry-run"
+          [ "${{ inputs.all }}"       = "true" ] && ARGS="$ARGS --all"
+          [ "${{ inputs.overwrite }}"    = "true" ] && ARGS="$ARGS --overwrite"
+          [ "${{ inputs.save_images }}" = "true" ] && ARGS="$ARGS --save-images"
+          echo "args=$ARGS" >> $GITHUB_OUTPUT
+          echo "Argumenty: $ARGS"
+
+      - name: Uruchom analizę satelitarną
+        working-directory: scraper
+        env:
+          SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+          SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          MAPBOX_TOKEN: ${{ secrets.MAPBOX_TOKEN }}
+        run: python analyze_venues.py ${{ steps.args.outputs.args }}

.github/workflows/classify.yml

@@ -0,0 +1,63 @@
+name: Klasyfikacja obiektów (map_visibility)
+
+# Ustawia map_visibility na podstawie danych w bazie:
+#   public         — boisko do sportu zespołowego z rezerwacją lub dobrymi danymi
+#   organizer_only — wygląda na boisko ale mało danych (warto sprawdzić)
+#   hidden         — siłownia, bilard, brak danych itp.
+#
+# Wymagane sekrety:
+#   SUPABASE_URL
+#   SUPABASE_SERVICE_ROLE_KEY
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Tryb podglądu — nic nie zapisuje'
+        default: true
+        required: false
+        type: boolean
+      limit:
+        description: 'Maks. obiektów (0 = wszystkie)'
+        default: '0'
+        required: false
+        type: string
+      reset:
+        description: 'Nadpisz też obiekty z już ustawioną visibility (domyślnie: tylko public)'
+        default: false
+        required: false
+        type: boolean
+
+jobs:
+  classify:
+    name: Klasyfikacja (${{ inputs.dry_run == true && 'DRY RUN' || 'ZAPIS' }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: scraper/requirements.txt
+
+      - name: Install dependencies
+        working-directory: scraper
+        run: pip install httpx python-dotenv
+
+      - name: Build arguments
+        id: args
+        run: |
+          ARGS="--limit ${{ inputs.limit }}"
+          [ "${{ inputs.dry_run }}" = "true" ]  && ARGS="$ARGS --dry-run"
+          [ "${{ inputs.reset }}"   = "true" ]  && ARGS="$ARGS --reset"
+          echo "args=$ARGS" >> $GITHUB_OUTPUT
+
+      - name: Run classifier
+        working-directory: scraper
+        env:
+          SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+          SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+        run: python classify.py ${{ steps.args.outputs.args }}