Powrót do projektów

Produkt · Aukcje sztuki online

Heirwell

EZCLOUD

Stack
  • Next.js 16
  • React 19
  • TypeScript
  • TanStack Query
  • Orval
  • NestJS
  • PostgreSQL
  • Prisma
  • Redis
  • BullMQ
  • Elasticsearch
  • Stripe

Heirwell prowadzi aukcje online z zegarem dla amerykańskiego marszanda. Każdy lot ma własny zegar, oferty przychodzą na żywo, a zwycięzca opłaca fakturę online. Właściciele mogą też wystawiać dzieła na sprzedaż.

Wyzwanie

Ostatnie sekundy decydują o sprzedaży. Oferty spływają jednocześnie, późna oferta przedłuża czas, a zegar każdego odwiedzającego trochę się różni. Wynik musi zostać spójny pod takim obciążeniem, a strona ma szybko się ładować, dobrze pozycjonować w wyszukiwarce i wyglądać jak renomowany dom aukcyjny.

Podejście

  • Oferty w ostatnich sekundach przechodzą przez blokadę w Redisie i transakcję Postgres, więc dwie oferty nie mogą wygrać jednocześnie. Późna oferta przedłuża lot, a po upływie czasu lot jest ponownie odczytywany z serwera.
  • API oparte na kontrakcie: Orval generuje ze specyfikacji OpenAPI typy, hooki TanStack Query, schematy Zod i mocki MSW. Frontend wyprzedza backend, a zmiana kontraktu od razu wychodzi jako błąd typów.
  • Next.js Cache Components: domyślnie renderowanie na serwerze, a dane z cache i dynamiczne części strumieniowane przez Suspense, więc pierwszy ekran jest szybki i indeksowalny.
  • Importy katalogu lotów na dziesiątki tysięcy wierszy są strumieniowane i przetwarzane w workerach BullMQ, więc duży plik nigdy nie wyczerpuje pamięci API.
  • Webhooki Stripe i PayPal przechodzą przez tabelę idempotencji, więc zduplikowany webhook nie zapisze płatności dwa razy.

Rezultat

24

testów end-to-end na desktopowym Chrome i mobilnym Safari, każdy ze sprawdzeniem dostępności

3

sposoby płatności (Stripe, PayPal, przelew) z webhookami, które nigdy nie zapisują płatności dwa razy

Strona główna: bieżąca aukcja z odliczaniem na żywo
Lot: licytacja, estymacja i zegar, który wydłuża się po późnych ofertach
Aukcje: nadchodzące, trwające i zakończone
Katalog z filtrami zapisanymi w URL
Sprzedaj: właściciel wystawia dzieło ze zdjęciami