Claude/kind ptolemy 9 mvh0

.claude/hooks/doc-guard.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# doc-guard — pilnuje, żeby dokumentacja w docs/ nie rozjechała się z kodem.
+#
+#   start  (SessionStart) — mówi, gdzie leży dokumentacja
+#   record (PostToolUse)  — po zmianie kodu wskazuje KONKRETNY plik do aktualizacji
+#
+# To jest PRZYPOMNIENIE, nie bramka. Hook nigdy nie blokuje — kończy się exit 0
+# w każdej ścieżce, a jego wyjście to tylko kontekst dla modelu. Odpowiedzialność
+# za aktualizację zostaje po stronie piszącego.
+#
+# Żeby nie hałasować: dla danej kategorii zmian odzywa się raz na sesję, a edycja
+# czegokolwiek w docs/ wycisza wszystkie kategorie do końca sesji.
+set -uo pipefail
+
+MODE="${1:-record}"
+payload="$(cat 2>/dev/null || true)"
+
+sid="$(printf '%s' "$payload" | jq -r '.session_id // "nosession"' 2>/dev/null || echo nosession)"
+state="${TMPDIR:-/tmp}/bojo-doc-guard/${sid}"
+mkdir -p "$state" 2>/dev/null || exit 0
+
+case "$MODE" in
+  start)
+    jq -nc '{hookSpecificOutput:{hookEventName:"SessionStart",
+      additionalContext:"Dokumentacja projektu leży w docs/ (indeks: docs/README.md), zasady pracy w AGENTS.md. Zmiana kodu pociąga za sobą aktualizację odpowiedniego pliku w docs/ — mapowanie w AGENTS.md, sekcja \"Aktualizacja dokumentacji\". Walidator spójności: npm run check:docs. docs/wizja.md jest dokumentem nadrzędnym: jego sekcji 1 nie parafrazować."}}' 2>/dev/null
+    ;;
+
+  record)
+    f="$(printf '%s' "$payload" | jq -r '.tool_input.file_path // .tool_response.filePath // ""' 2>/dev/null)"
+    [ -n "$f" ] || exit 0
+
+    # Edycja dokumentacji wycisza hook do końca sesji.
+    case "$f" in
+      */docs/*|*/frontend/public/llms.txt|*/frontend/public/llm-context.md|*/AGENTS.md)
+        : > "$state/docs"
+        exit 0 ;;
+    esac
+    [ -e "$state/docs" ] && exit 0
+
+    # Klasyfikacja zmienionego pliku → kategoria + sugerowany plik dokumentacji.
+    # Flagi sprawdzane przed ogólnym lib/, bo mają węższe i ważniejsze mapowanie.
+    case "$f" in
+      */frontend/src/lib/features.ts|*/frontend/src/config/features.ts)
+        kat="flagi"
+        cel="docs/funkcje.md (sekcja \"Flagi funkcji\") — tabela flag jest jedynym miejscem poza kodem, gdzie widać, co jest ukryte" ;;
+      */supabase/migrations/*)
+        kat="migracje"
+        cel="docs/baza-danych.md — mapa tabela → migracja" ;;
+      */frontend/src/lib/*)
+        kat="lib"
+        cel="docs/domena.md (jeśli zmieniły się reguły domenowe) lub docs/funkcje.md (jeśli doszła/zniknęła funkcja); jeśli zmiana jest widoczna dla użytkownika — także docs/llm-context.md (RAG INJECTION, patrz AGENTS.md)" ;;
+      */frontend/src/app/*)
+        kat="trasy"
+        cel="docs/funkcje.md — a jeśli doszła lub zniknęła trasa użytkownika, także frontend/public/llms.txt oraz docs/llm-context.md (RAG INJECTION, patrz AGENTS.md)" ;;
+      *)
+        exit 0 ;;
+    esac
+
+    # Raz na sesję dla danej kategorii.
+    [ -e "$state/seen-$kat" ] && exit 0
+    : > "$state/seen-$kat"
+
+    jq -nc --arg plik "${f##*/bojo-app/}" --arg cel "$cel" \
+      '{hookSpecificOutput:{hookEventName:"PostToolUse",
+        additionalContext:("Zmieniłeś " + $plik + ". Przed końcem zadania sprawdź: " + $cel + ". Po zmianach uruchom: npm run check:docs. (Przypomnienie doc-guard — nie blokuje.)")}}' 2>/dev/null
+    ;;
+esac
+
+exit 0

.claude/settings.json

@@ -0,0 +1,27 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/doc-guard.sh start",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/doc-guard.sh record",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

.env.example

@@ -0,0 +1,78 @@
+# ============================================================
+# 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, robots.txt, JSON-LD
+# i znacznikach SEO. Domena kanoniczna: https://bojo.pl
+# Opcjonalny — bez niego kod używa https://bojo.pl (NIE localhost), więc przy
+# pracy lokalnej ustaw http://localhost:3000, jeśli testujesz linki absolutne.
+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/dopisz-wzorce.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# Odsyła wzorce zrzutów na gałąź PR-a. Uruchamiany z katalogu `frontend`.
+#
+# JEDNA ZASADA: nic nie trafia do repo bez świadomego zatwierdzenia —
+# komentarza `/zrzuty ok` w PR-ze albo etykiety `zrzuty:zaakceptuj`.
+#
+# Dotyczy to tak samo widoków ZMIENIONYCH, jak i CAŁKIEM NOWYCH. Przez chwilę
+# nowe wzorce dopisywały się same — z rozumowaniem „nowy zrzut nie ma z czym
+# się różnić, więc nie ma czego przeglądać". To rozumowanie jest błędne:
+# pierwszy zrzut widoku jest właśnie tym, który warto obejrzeć, bo to on
+# staje się wzorcem na zawsze. Jeśli nowy ekran wyszedł krzywo, ciche
+# dopisanie utrwala krzywy stan i nikt się o tym nie dowie.
+#
+# Zrzuty nowych widoków oglądasz w artefakcie (`zrzuty-raport` /
+# `scenariusze-raport`), zanim nadasz etykietę.
+#
+# Argument: dopełniacz do wiadomości commita („zrzutów", „scenariuszy").
+set -euo pipefail
+
+CO="${1:-zrzutów}"
+AKCEPTUJ="${AKCEPTUJ:-0}"
+GALAZ="${GALAZ:?brak nazwy gałęzi w GALAZ}"
+
+NOWE="$(git ls-files --others --exclude-standard e2e/wzorce)"
+ZMIENIONE="$(git diff --name-only -- e2e/wzorce)"
+
+if [[ "$AKCEPTUJ" != "1" ]]; then
+  if [[ -n "$NOWE$ZMIENIONE" ]]; then
+    echo "Są wzorce do zatwierdzenia, ale nikt ich jeszcze nie zatwierdził."
+    echo "Nowe:      $(echo "$NOWE" | grep -c . || true)"
+    echo "Zmienione: $(echo "$ZMIENIONE" | grep -c . || true)"
+    echo "Obejrzyj obrazki w komentarzu do PR-a i odpisz /zrzuty ok, jeśli są w porządku."
+  else
+    echo "Wzorce bez zmian."
+  fi
+  exit 0
+fi
+
+if [[ -z "$NOWE$ZMIENIONE" ]]; then
+  echo "Wzorce bez zmian — nie ma czego dopisywać."
+  exit 0
+fi
+
+git config user.name  "github-actions[bot]"
+git config user.email "github-actions[bot]@users.noreply.github.com"
+git add e2e/wzorce
+git commit -m "test: zaakceptowane wzorce $CO"
+
+# Oba zadania tego workflow potrafią dopisywać wzorce równocześnie, więc
+# odrzucony push nie jest błędem, tylko wyścigiem — po prostu próbujemy jeszcze
+# raz na świeżej gałęzi.
+for PROBA in 1 2 3; do
+  if git push origin "HEAD:$GALAZ"; then
+    echo "✓ Wzorce dopisane do $GALAZ"
+    exit 0
+  fi
+  echo "Push odrzucony (próba $PROBA) — pobieram gałąź i próbuję ponownie."
+  git pull --rebase origin "$GALAZ"
+done
+
+echo "✗ Nie udało się dopisać wzorców po trzech próbach." >&2
+exit 1

.github/komentarz-zrzutow.js

@@ -0,0 +1,77 @@
+// Jeden komentarz na zestaw zrzutów, aktualizowany w miejscu.
+//
+// Osobny plik, a nie `script:` wklejony w YAML-u, bo ta sama treść obsługuje
+// dwa zadania (widoki publiczne i scenariusze za logowaniem) — a skopiowany
+// kod w dwóch miejscach rozjeżdża się przy pierwszej poprawce.
+//
+// Komentarz rozpoznajemy po znaczniku (🖼️ / 🎬) w treści, żeby przy każdym
+// kolejnym przebiegu nadpisać ten sam wpis zamiast zasypywać wątek.
+//
+// Zadaniem komentarza jest JEDNO: dać odnośnik do raportu. Niczego nie trzeba
+// pisać w odpowiedzi — raport jest do obejrzenia, nie do zatwierdzania.
+
+module.exports = async ({ github, context, znacznik, tytul, udane, akceptacja, obrazki, numer }) => {
+  const { owner, repo } = context.repo;
+
+  const naglowek = `### ${znacznik} ${tytul}`;
+  let tresc;
+
+  if (akceptacja) {
+    tresc = [
+      naglowek,
+      '',
+      '**Wzorce zaktualizowane.** Nowe obrazki trafiły na gałąź tego PR-a —',
+      'zobaczysz je w zakładce *Files changed*.',
+      '',
+      '**Zdejmij etykietę** `zrzuty:zaakceptuj`, żeby kolejne przebiegi znowu',
+      'porównywały, zamiast nadpisywać.',
+    ].join('\n');
+  } else if (udane) {
+    tresc = [
+      naglowek,
+      '',
+      'Wszystkie zrzuty zgadzają się ze wzorcami — nic się wizualnie nie ruszyło.',
+    ].join('\n');
+  } else if (obrazki) {
+    tresc = [
+      naglowek,
+      '',
+      'Widoki się zmieniły. To **nie jest** błąd sam w sobie — zmiana może być',
+      'dokładnie tym, co chciałeś zrobić.',
+      obrazki,
+      '',
+      '---',
+      '',
+      'Nowe wzorce wejdą do repo dopiero po nadaniu etykiety `zrzuty:zaakceptuj`',
+      '(w aplikacji GitHuba: **ⓘ** w prawym dolnym rogu → *Labels*).',
+      '',
+      '_To zadanie nie blokuje merge\'a ani deployu._',
+    ].join('\n');
+  } else {
+    // Brak obrazków przy nieudanym przebiegu znaczy coś innego niż zmiana
+    // wyglądu: test padł zanim doszło do porównania — na asercji zachowania,
+    // na braku przycisku, na wywróconym logowaniu. Mówienie wtedy „widoki się
+    // zmieniły" wysyła w złą stronę.
+    tresc = [
+      naglowek,
+      '',
+      'Testy nie doszły do porównania widoków — coś padło wcześniej',
+      '(asercja zachowania, brak elementu, logowanie). **Nie chodzi o wygląd.**',
+      '',
+      'Szczegóły są w logu przebiegu i w artefakcie z raportem.',
+      '',
+      '_To zadanie nie blokuje merge\'a ani deployu._',
+    ].join('\n');
+  }
+
+  const { data: komentarze } = await github.rest.issues.listComments({
+    owner, repo, issue_number: numer, per_page: 100,
+  });
+  const moj = komentarze.find((k) => k.user.type === 'Bot' && k.body.includes(znacznik));
+
+  if (moj) {
+    await github.rest.issues.updateComment({ owner, repo, comment_id: moj.id, body: tresc });
+  } else {
+    await github.rest.issues.createComment({ owner, repo, issue_number: numer, body: tresc });
+  }
+};