Full-Stack Developer

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.

• 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.

• 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.

• 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.

• 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.