WatchGenius: Pipeline obrazów v1 (bez hotlinku) — pobieranie pracownika→WebP→Supabase Storage + uzupełnienie

Budujemy stronę analityki zegarków (Next.js). Obecnie mamy zewnętrzne URL obrazków (z źródła/RTL, często Chrono24 CDN), ale NIE używamy hotlinków. Należy wdrożyć odpowiedni system obrazów, aby później nie trzeba było przerabiać przy skalowaniu do 1000+ modeli.

Stos technologiczny:

• Frontend: Next.js

• Backend/API: Node/Next API routes (lub osobna usługa)

• DB/Storage: Supabase (Postgres + Supabase Storage)

• Hosting: Vercel (FE), Render (API/worker)

Wymaganie (kontrakt na zawsze):

• UI pokazuje <img> tylko z naszego storage/CDN po image_key (żadne zewnętrzne URL).

• Jeśli obraz nie istnieje/nie jest gotowy: 1 schludny placeholder (nie 4–5 duplikatów).

Co należy zrobić (v1):
Etap 0 (C0) — kontrakt UI + schemat:

• dodać pola w modelach: image_key, image_status (missing|queued|ready|failed), image_updated_at

• API zwraca image_url (tworzone z storage) i image_status

• UI: jeśli ready → pokazujemy zdjęcie; w przeciwnym razie 1 placeholder

Etap 1 (C1) — worker obrazów:

• tabela kolejki image_jobs (kind, source_url, dest_key, status, tries, last_error)

• worker (Render): pobierz → zweryfikuj → konwertuj WebP (sharp) → załaduj do Supabase Storage → zaktualizuj image_key/status

• bezpieczeństwo: lista dozwolonych domen, zakaz prywatnych IP, limit rozmiaru, timeouty

• nagłówki cache: długi cache (max-age/immutable) na storage/CDN (jeśli dotyczy)

Etap 2 (C2) — backfill:

• przeprowadzić bieżącą partię (39/84 modeli): wziąć 1 główny obraz na model, wypełnić storage

• raport: % sukcesu, lista nieudanych + przyczyny

Dodatkowo (opcjonalnie):

• partie dla 1000+ (po 100–200, ograniczenie równoległości)

• retries/backoff + dead-letter

DoD (kryteria akceptacji):

• na stronie nie ma <img src="...chrono24..."> w ogóle

• w katalogu/PDP wyświetlane są rzeczywiste obrazy modeli z storage (lub 1 placeholder)

• brak duplikatów placeholder w galerii

• worker poprawnie ładuje WebP do /images/models/{slug}/main.webp i aktualizuje image_status

• jest log błędów i lista nieudanych załadunków

Ważne:

• Potrzebna jest wycena etapów (stała cena i ETA na każdy etap).

• Dostępy: najpierw tylko konsultacja/wycena. Kod/repozytorium dajemy po wyborze wykonawcy (NDA w razie potrzeby).

Prośba w odpowiedzi:

1. wycena kosztów/czasów według etapów C0/C1/C2 (i osobno opcjonalnie dla 1000+)

2. jakie ryzyka widzisz (3–5 punktów)

3. przykłady podobnych zadań (worker/media pipeline)

4. jaki format pracy: stała cena czy godzinowo z limitem