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. 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. 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. Music Republic porta nei locali commerciali
- bar, ristoranti, negozi, parrucchieri, palestre e centri benessere
- musica originale creata