Full-Stack Developer

Chi siamo

Music Republic porta nei locali commerciali — bar, ristoranti, negozi, parrucchieri, palestre e centri benessere — musica originale creata con l'intelligenza artificiale e con licenza d'uso inclusa: niente SIAE né SCF, un certificato di copertura per ogni locale, playlist pensate per ogni attività e brani personalizzati che portano il nome del locale. Accanto alla piattaforma vive il Registro Pubblico, che documenta artisti e brani.

Music Republic è sviluppata da P49 Società Benefit S.r.l., hub di ricerca e sviluppo per sistemi complessi di intelligenza artificiale in contesti regolati e mission-critical.

Il ruolo

Cerchiamo uno sviluppatore o una sviluppatrice full-stack che diventi il riferimento tecnico della piattaforma. Music Republic è un prodotto in produzione, con clienti paganti che lo usano ogni giorno: lavorerai su tutto lo stack — interfaccia, database, pagamenti, email, pipeline di AI generativa — con un metodo di sviluppo AI-assisted basato su Claude Code, in cui conta saper guidare l'AI e verificarne il lavoro prima che arrivi ai clienti.

Cosa farai

• Sviluppare nuove funzionalità e mantenere l'app web: il player e lo Studio usati dai locali, il sito pubblico e il blog, il pannello di amministrazione.
• Far evolvere il backend: oltre 140 API route, 12 job pianificati, i webhook di Stripe e dei fornitori AI, un database PostgreSQL su Supabase con oltre 100 migrazioni e policy di sicurezza a livello di riga.
• Curare le pipeline di AI generativa: generazione musicale asincrona (Suno tramite EvoLink, con webhook e polling), copertine e immagini (Google Gemini, Higgsfield), testi e traduzioni (Claude, OpenAI), ascolto e analisi audio per la curatela delle playlist.
• Gestire abbonamenti e pagamenti con Stripe — prove gratuite, piani mensili e annuali, codici sconto, rinnovi, fatture — e i flussi email con Resend: messaggi transazionali in sei lingue, campagne, sequenze automatiche di recupero clienti.
• Mantenere la generazione dei documenti in PDF: Welcome Kit, certificati di copertura, documenti fiscali.
• Portare le modifiche in produzione su Vercel con metodo: controllo dei tipi, lint, build, migrazioni prima del rilascio, verifica dopo il deploy, commit e push su GitHub.
• Fare da supporto tecnico di secondo livello per i locali — per esempio la riproduzione in background su iPhone — e tenere sotto controllo avvisi, costi dei fornitori e integrità dei dati.

Lo stack

Frontend

Next.js 16 (App Router, Route Handlers, Proxy, next/og) · React 19 · TypeScript in modalità strict · Tailwind CSS 4 · shadcn/ui e Base UI · PWA

Dati e accessi

Supabase: PostgreSQL, Auth (conferma email, magic link, hook email personalizzato), Row Level Security, Realtime, Storage, funzioni SQL e RPC · migrazioni SQL versionate

Infrastruttura

Vercel: funzioni serverless, Cron Jobs, variabili d'ambiente, CLI · GitHub · Upstash Redis per il rate limiting

Pagamenti

Stripe: Subscriptions, Checkout, Customer Portal, coupon, Stripe Tax, webhook idempotenti

Email

Resend: template HTML localizzati (it, en, es, fr, de, pt), campagne, gestione di disiscrizioni e rimbalzi

AI generativa

Suno via EvoLink (musica) · Google Gemini (immagini e analisi audio) · Higgsfield (immagini e video) · Anthropic Claude e OpenAI (testi)

Documenti e media

@react-pdf/renderer · Puppeteer con Chromium serverless · sharp · music-metadata e tag ID3 · QR code · ffmpeg

Metodo

Claude Code (istruzioni di progetto in CLAUDE.md e AGENTS.md, git worktree) · ESLint · revisione di ogni modifica prima del rilascio

Requisiti obbligatori

• Esperienza professionale nello sviluppo web full-stack (indicativamente almeno 2 anni), con almeno un'applicazione portata e mantenuta in produzione.
• TypeScript solido e JavaScript moderno: tipi, async/await, moduli, gestione degli errori.
• React e Next.js con App Router: componenti server e client, routing, Route Handlers, middleware.
• SQL e PostgreSQL: query, join, indici, vincoli, migrazioni; comprensione della Row Level Security.
• Supabase, o un backend Postgres gestito equivalente: autenticazione, client JavaScript, differenza tra chiave pubblica e service role.
• Integrazione di API REST e webhook: verifica delle firme, idempotenza, retry, job asincroni.
• Deploy e gestione di un'app in produzione su Vercel o piattaforma serverless analoga: variabili d'ambiente, log, cron.
• Git e GitHub nel lavoro quotidiano.
• Uso quotidiano di Claude Code o di strumenti di coding AI equivalenti, con la capacità di guidarli con istruzioni precise e di rileggere, verificare e correggere il codice che producono.
• HTML e CSS solidi, Tailwind CSS.
• Cura per sicurezza e dati: gestione dei segreti, protezione dei dati personali, prudenza con le operazioni irreversibili.
• Italiano fluente e inglese tecnico: prodotto, clienti e documentazione interna sono in italiano; API e documentazione dei fornitori in inglese.

Competenze gradite

• Stripe Billing: abbonamenti con prova gratuita, coupon, Stripe Tax, portale clienti, riconciliazione dei dati.
• Email transazionali: HTML compatibile con i client di posta (tabelle, stili inline), deliverability (SPF, DKIM, DMARC), gestione di rimbalzi e disiscrizioni.
• API di AI generativa per testi, immagini, audio e musica: prompt, costi, quote, gestione degli errori dei fornitori.
• Riproduzione audio sul web: HTMLAudioElement, Media Session API, limiti di autoplay e riproduzione in background su iOS Safari, PWA.
• Supabase avanzato: Realtime, Storage, funzioni PL/pgSQL, trigger, RPC.
• Generazione di PDF (React PDF, Puppeteer e Chromium headless) ed elaborazione di immagini con sharp.
• ffmpeg per audio e video, metadati audio (ID3).
• Rate limiting e caching con Redis (Upstash).
• Test automatici (Vitest, Playwright) e integrazione continua.
• SEO tecnica in Next.js: metadata, sitemap, immagini Open Graph.
• Contesto italiano: fatturazione elettronica e codice SDI, IVA, GDPR; diritto d'autore e diritti connessi in ambito musicale (SIAE, SCF).
• Bash e scripting per operazioni sui dati.
• Passione per la musica e familiarità con il mondo dei locali; esperienza in startup o prodotti SaaS B2B.

Cosa offriamo

• 1 mese iniziale di prova;
• successivo contratto a tempo determinato di 12 mesi;
• possibilità di trasformazione in contratto a tempo indeterminato alla scadenza;
• compenso indicativo: €1.800–€2.400 al mese, da definire in base all'esperienza e alle competenze del candidato.

Un prodotto vero, in produzione, con clienti che lo usano ogni giorno: quello che costruisci arriva ai locali in tempi brevi, con autonomia e responsabilità diretta sulla piattaforma.