Fix/force dynamic storefront

.deploy-trigger

@@ -0,0 +1 @@
+Deployment trigger: 2026-07-08T00:00:00+02:00

.env.example

@@ -1,7 +1,20 @@
 # Spree API Configuration (server-side only - not exposed to browser)
-SPREE_API_URL=http://localhost:3000
+# Development: http://localhost:3000
+# Production (Oracle): https://141.253.103.172
+SPREE_API_URL=https://141.253.103.172
 SPREE_PUBLISHABLE_KEY=your_publishable_api_key
 
+# Admin API secret key (sk_...) scoped to read_products/write_products.
+# Used only by the /api/cron/sync-eur-prices Vercel Cron job to fetch PLN
+# prices and write back computed EUR prices — never exposed to the browser.
+SPREE_ADMIN_SECRET_KEY=sk_your_admin_secret_key
+
+# Shared secret for Vercel Cron. Vercel automatically sends
+# "Authorization: Bearer $CRON_SECRET" when calling scheduled routes if
+# this env var is set — must match the same value set for the cron to
+# authenticate. Any random string works.
+CRON_SECRET=
+
 # Store defaults (should match your Spree store settings)
 # These are used by the middleware for initial redirects before API data is loaded
 # Set these to your store's default_country_iso and default_locale
@@ -43,6 +56,11 @@ SPREE_WEBHOOK_SECRET=your_webhook_endpoint_secret_key
 RESEND_API_KEY=
 EMAIL_FROM=Your Store <orders@your-domain.com>
 
+# Manual cache-busting for the product-list "use cache" entries.
+# POST /api/revalidate with `Authorization: Bearer <secret>` to force a
+# refresh instead of waiting out the 10-minute cacheLife.
+REVALIDATE_SECRET=
+
 # Stripe (optional - required for Stripe payment method)
 NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_your_stripe_publishable_key
 

AGENTS.md

@@ -0,0 +1,20 @@
+# sklepikFront — instrukcja dla agentów kodowania
+
+To repozytorium to **storefront projektu Kakałowy Sklepik**: Next.js 16 + React 19, doświadczenie klienta, branding, UX, SEO, deploy na Vercel. Rozmawia ze Store API backendu przez `@spree/sdk`.
+
+Backend, admin i API żyją w osobnym repo **`pawelekbyra/sklepik`** — tam też jest **kanon całego systemu**. Nie duplikujemy go tutaj:
+
+- `sklepik/docs/kierunek-projektu.md` — cel projektu, podział repo, **hierarchia decyzji**.
+- `sklepik/docs/architektura.md` — mapa systemu i hostingu.
+- `sklepik/docs/stan-projektu.md` — bieżący stan i znane problemy.
+- `sklepik/docs/roadmap.md` — backlog i priorytety.
+
+**Konwencje techniczne tego repo i protokół dokumentacji: [`CLAUDE.md`](CLAUDE.md).** Tematy frontowe: [`docs/README.md`](docs/README.md).
+
+Żelazne minimum:
+
+- Frontend nie zawiera logiki commerce — produkty, ceny, koszyk, zamówienia to zawsze Store API. Jeśli brakuje pola/endpointu, opisz wymaganie względem repo `sklepik`, nie hardcoduj.
+- Nie zmieniaj checkoutu/koszyka przy okazji zmian wizualnych; eksperymenty (quizy, VOD, AI) izoluj od krytycznej ścieżki zakupowej.
+- Nie commituj sekretów. Zmienne środowiskowe: [`docs/deployment-vercel.md`](docs/deployment-vercel.md).
+- Świadome skróty zapisuj w [`docs/technical-debt.md`](docs/technical-debt.md).
+- **Po każdym zadaniu zaktualizuj dotknięte dokumenty** (tu i — jeśli zmiana dotyczy całego systemu — `sklepik/docs/stan-projektu.md`), tak żeby dokumentacja odzwierciedlała rzeczywisty stan.

CLAUDE.md

@@ -1,8 +1,30 @@
-# Claude Code Rules for Next.js Spree Storefront
+# Kakałowy Sklepik — storefront: zasady dla agentów
 
-## Project Overview
+## Kontekst projektu (przeczytaj najpierw)
 
-This is a headless e-commerce storefront built with Next.js 16 and React 19, using the Spree Commerce API v3 via `@spree/sdk`.
+To repozytorium to **storefront projektu Kakałowy Sklepik** (sklep z produktami kakao) — headless frontend Next.js 16 + React 19, konsumujący Store API v3 backendu przez `@spree/sdk`. Backend, API i panel admina żyją w osobnym repo `pawelekbyra/sklepik` — tam jest też **kanon całego systemu**:
+
+- `sklepik/docs/kierunek-projektu.md` — cel, podział repo, hierarchia decyzji.
+- `sklepik/docs/stan-projektu.md` — bieżący stan i znane problemy.
+- `sklepik/docs/roadmap.md` — backlog i priorytety.
+- Lokalna dokumentacja frontu: [`docs/README.md`](docs/README.md) (kierunek marki, deploy Vercel, dług techniczny).
+
+Zasada nadrzędna: frontend nie zawiera logiki commerce. Produkty, ceny, koszyk, zamówienia — zawsze przez Store API. Brakuje pola/endpointu → wymaganie względem repo `sklepik`, nie hardcode.
+
+## Protokół dokumentacji (obowiązkowy)
+
+Po każdym zakończonym zadaniu, w tym samym PR/commicie:
+
+1. Zaktualizuj dotknięte dokumenty w `docs/` (deploy, kierunek frontu) tak, żeby opisywały rzeczywisty stan.
+2. Świadomy skrót → wpis w [`docs/technical-debt.md`](docs/technical-debt.md); spłacony dług → zmień status na `zamknięte`.
+3. Zmiana istotna dla całego systemu (API, architektura, nowa usługa) → zaktualizuj też `sklepik/docs/stan-projektu.md` w repo backendu albo jawnie to zgłoś.
+4. Nie twórz nowych plików-notatek — aktualizuj istniejące. Historia jest w gicie.
+
+---
+
+## Tech Overview
+
+Headless e-commerce storefront: Next.js 16 + React 19 + Spree Commerce API v3 via `@spree/sdk`.
 
 ## Tech Stack
 
@@ -17,16 +39,21 @@ This is a headless e-commerce storefront built with Next.js 16 and React 19, usi
 ```
 src/
 ├── app/                          # Next.js App Router
-│   └── [country]/[locale]/       # Internationalized routes
-│       ├── (checkout)/           # Checkout route group (minimal layout)
-│       └── (storefront)/         # Storefront route group (full layout)
+│   ├── [locale]/                 # pl = default, no URL prefix; other locales get /{locale}
+│   │   ├── (checkout)/           # Checkout route group (minimal layout)
+│   │   └── (storefront)/         # Storefront route group (full layout)
+│   └── api/webhooks/             # Webhooks from the backend (transactional emails)
 ├── components/                   # Reusable UI components
 ├── contexts/                     # React Context providers
 ├── lib/
-│   └── data/                     # Server Actions for data fetching
+│   ├── data/                     # Server Actions for data fetching
+│   ├── spree/                    # SDK client, middleware, config
+│   └── store.ts                  # Store name + default country/locale (env, defaults pl)
 └── types/                        # TypeScript type definitions
 ```
 
+Uwaga: segment `[country]` został usunięty z URL-i (sklep jednorynkowy — kraj do rozwiązania rynku/waluty jest stałym defaultem server-side). Przykłady niżej używające starych ścieżek traktuj jako wzorce kodu, nie jako mapę routingu.
+
 ## React 19 Best Practices
 
 ### Avoid Unnecessary useEffect