La piattaforma consente di creare eventi, definire tipologie di biglietti con prezzi, inventario e date, gestire ordini e clienti, e processare pagamenti in modo sicuro. L'admin panel Payload offre controllo completo su contenuti e transazioni. L'architettura è modulare, con feature separate (checkout, events) e API tipizzate.
Funzionalità principali
- Eventi: anagrafica con nome, descrizione (rich text localizzato), location, date leggibili e stato attivo/inattivo.
- Biglietti: collegati a un evento, con nome, descrizione, schedule opzionale, prezzo in centesimi, valuta, inventario (
capacity, soldCount, soldOut), stato attivo e ordinamento. - Ordini: tracciamento acquisti con
orderId, cliente, evento, biglietto, status (pending, paid, failed, canceled), importo, quantità, dati fatturazione e coupon. - Checkout Stripe: sessione di pagamento, webhooks per
checkout.session.completed, checkout.session.expired, payment_intent.failed. - Inventario automatico: hook che aggiorna
soldCount e soldOut sul ticket quando un ordine passa a paid. - Multilingua: next-intl con messaggi IT/EN e routing per locale.
Data layer e integrazioni
- Payload CMS 3 con adapter MongoDB per collezioni (events, tickets, orders, customers, users, media).
- Stripe per pagamenti e gestione webhooks.
- tRPC + React Query per chiamate tipizzate (
checkoutRouter, eventsRouter). - Zod per validazioni coerenti.
- Vercel Blob per media.
Sicurezza e accessi
- Ruoli
admin e user con permessi granulari (es. ordini visibili solo al cliente proprietario o all'admin). - Webhooks Stripe con verifica firma e idempotenza.
- Cookie e sessioni sicure.
UI/UX e performance
- Tailwind CSS 4 + Radix UI per componenti accessibili.
- Sonner per toasts, Lucide per icone.
- Dark mode, layout responsive, attenzione a LCP/CLS.
- Biome per linting/formatting.
Highlight tecnico
- Next.js 16 + React 19 + TypeScript.
- Payload 3 (MongoDB), Vercel Blob per media.
- Stripe (checkout, webhooks, inventario automatico).
- tRPC 11 +
superjson + React Query. - next-intl per i18n (IT/EN).
- Zod, Tailwind 4, Radix UI, Biome.
- Docker Compose per MongoDB locale in sviluppo.