riccardo / dev

// Piacenza, Italia · sempre curioso

Sono Riccardo.Scrivo codice.
Creo mondi.

Logica nelle API.
Fantasia nel playground.

Di lavoro collego interfacce, API e dati. Per curiosità mi perdo fra giochi, shader, 3D e motion design. Questo è il posto dove le due cose si incontrano.

creative coding3D / WebGLgamesmotion / futurism
cv.pdf ↓
RF / CREATIVE UNIVERSE
CODE / 01Collegare le cose.
MOTION / 02Dare forma alle idee.
ARCADE / 03Imparare giocando.

API, eventi, dati. Il mio lato pratico.

Segui un evento

Three.js, shader, motion design. Il mio lato visivo.

Entra nel 3D

Canvas, collisioni, multiplayer. Il mio lato curioso.

Vai al playground
developer.tsUn altro modo di presentarmi
developer.tsread-only
01const developer = {
02  name: "Riccardo Ferri",
03  role: "Full Stack Developer",
04  focus: [
05    "backend",
06    "web interfaces",
07    "automation"
08  ],
09  stack: ["JS/TS", "Python"],
10  lookingFor: "progetti + un buon team"
11};
Nuovi incarichi e opportunità in teamRemoto · Ibrido · In sede
Node.jsExpressAstroSvelteReactMongoDBGit+ curiosità
Percorso di esplorazione

Comitato Eventi Sportivi Oltrepò · Presidente Emanuele Bombini

  • Scuola di Ciclismo Oltrepò A.S.D.
  • ASD Scuola di MTB Il Branco

Un sito per lo sport.
Un sistema per gli eventi.

Dal sito creato nel 2025 al redesign pubblicato a inizio novembre 2026 su Vercel: interfaccia responsive, contenuti IT/EN, pagine evento, archivio, storico e una sezione Progetti dedicata.

Redesign pubblicato · Inizio novembre 2026

Esplora il caso studio CESO

Prima e dopo, pagine navigabili e scelte di progetto in un unico approfondimento.

Sito attuale ↗ · Versione precedente ↗

CESO / case studyDesktop, mobile e UX ↗

// backend & automazioni

Collegare servizi.
Organizzare dati.

Quattro casi professionali: automazioni nel browser, riconciliazione dati e un backend evoluto da Zapier. Qui trovi flussi, scelte tecniche e limiti.

01 / Recruiting / CRM

Recruiting e integrazione CRM

Riferimento 2024/2025

Interazione con le pagine di recruiting tramite Selenium, raccolta dei dati e dei CV, archivio JSON e inserimento in noCRM. Il flusso comprende contatti, allegati, tag e assegnazione alla pipeline.

RisultatoEsecuzione autonoma del flusso, dalla raccolta dei candidati al CRM.

Flusso e scelte tecniche
  1. Dati e CV
  2. JSON + controlli
  3. noCRM
Schema illustrativo del processo

Browser e attese

Selenium gestisce le interfacce, i selettori e le attese fra le operazioni di raccolta e inserimento. I cambiamenti alle pagine richiedono manutenzione.

Candidature e allegati

Controllo delle candidature già presenti, gestione e rinomina dei CV, compilazione dei contatti e delle opportunità nel CRM.

Messaggi opzionali

Il codice comprende anche un passaggio opzionale di messaggistica, con condizioni e controllo dei messaggi già presenti.

Il confronto storico

Il tempo manuale indicato dall’autore è circa 2 minuti per candidato: circa 200 minuti per 100 candidati. I circa 40 minuti del bot comprendono raccolta e inserimento nel CRM, con esecuzione autonoma. È un confronto operativo storico, non un benchmark su ogni esecuzione.

  • Python
  • Selenium
  • JSON
  • noCRM

02 / Prospecting / liste

Prospecting e liste con Lusha

Riferimento 2024/2025

Uno script Python e Selenium legge le ricerche salvate in Lusha, scorre le pagine e raccoglie nominativi, con controlli su aziende e località. Preparazione delle liste e confronto degli export completano il lavoro.

RisultatoTempo risparmiato sulla raccolta ripetitiva dei nominativi affidata al bot.

Flusso e scelte tecniche
  1. Ricerche Lusha
  2. Nominativi / JSON
  3. Confronto liste
Schema illustrativo del processo

Raccolta automatizzata

La funzione getLushaNames gestisce la raccolta nel browser e salva i risultati in JSON. Le attività ripetitive affidate al bot richiedevano prima passaggi manuali.

Aziende già presenti

Normalizzazione di nomi e URL, preparazione degli elenchi e confronto con esportazioni ClickUp per individuare aziende già presenti. Il confronto usa file esportati.

Un processo con più passaggi

Il lavoro comprende anche preparazione e attività manuali. Il risparmio di tempo riguarda la raccolta automatizzata; non è attribuita una percentuale all’intero processo.

  • Python
  • Selenium
  • Lusha
  • JSON

03 / Dati / riconciliazione

Dati e Google Sheets

Riferimento 2024/2025

Un lavoro di gestione dati in più fasi e varianti: lettura di Excel, CSV e Google Sheets, conversione in JSON, aggregazione e riconciliazione, quindi aggiornamento e formattazione degli output.

RisultatoOutput riconciliati e fogli aggiornati, con controlli sui dati mancanti.

Flusso e scelte tecniche
  1. Excel / CSV / Sheets
  2. Normalizza e confronta
  3. Output / Sheets API
Schema illustrativo del processo

Formati e aggregazione

Lettura ed esportazione dei dati da file e fogli diversi, conversione in JSON ed estrazione delle informazioni su corsi e iscritti.

Confronto e riconciliazione

Normalizzazione, confronto di contatti e iscrizioni, individuazione di duplicati e campi mancanti, preparazione degli output aggiornati.

API e varianti del flusso

Aggiornamento di colonne e formattazione dei fogli tramite API Google. Gli script coprono più varianti; alcuni helper per le liste sono condivisi con il prospecting. Non c’è un unico avvio che orchestri ogni script.

  • Python
  • Excel / CSV
  • JSON
  • Google Sheets API

04 / Backend / integrazioni

Da Zapier al webhook server

Riferimento 2025

Prima, snippet JavaScript in Zapier per gestire registrazioni, pagamenti, scadenze e passaggio da prospect a cliente su Notion. Poi, un backend Node.js ed Express in un repository autonomo, con Dockerfile e Docker Compose.

RisultatoUn backend custom containerizzato con Docker, con log e recupero dei task falliti.

Flusso e scelte tecniche
  1. Zapier / Notion
  2. Node.js / Express
  3. Docker / Compose
Schema illustrativo del processo

Il workflow Zapier legacy

Gli snippet ricevono i valori da inputData e inviano richieste HTTP a Notion. Gestiscono aggiornamenti dopo registrazione e pagamento, scadenze e conversione del prospect in cliente.

Route, servizi e job

Route, servizi e integrazioni sono moduli distinti. I job pianificati con cron usano la stessa coda; Notion viene letto con paginazione a cursore, con integrazioni Google Calendar ed email.

Docker nel progetto

Dockerfile e configurazione Docker Compose descrivono l’esecuzione del backend nel container. La containerizzazione fa parte di questo progetto concreto.

Errori e limiti della coda

Log e pannello amministrativo consentono di riprovare i task falliti. La coda è in memoria: non offre persistenza al riavvio né garanzie di consegna durevole. HTTP 202 indica accettazione, non completamento.

  1. 01 / RECEIVEWebhook

    Ricezione evento e risposta HTTP 202.

  2. 02 / PROCESSCoda in memoria

    Le funzioni vengono eseguite in sequenza.

  3. 03 / INTEGRATEServizi esterni

    Aggiornamenti su Notion, calendario e email.

  • Node.js
  • Express
  • Docker / Compose
  • Notion API

// webhook-server · dal codice al comportamento

Un evento.
Un flusso da seguire.

Demo locale · dati fittizi

Un record cambia, il server accetta l’evento e il lavoro entra in coda. Questa simulazione rende visibili attesa, completamento e recupero di un errore. Puoi inviare più eventi e farli avanzare uno alla volta.

La demo interattiva richiede JavaScript. Il flusso e le scelte tecniche sono descritti anche qui sotto.

Registro degli eventi
  1. In attesa di eventi.
Scelte, limiti e codice della demo

Cosa riprende dal progetto

Risposta 202 delle route specifiche, esecuzione sequenziale e possibilità di rimettere manualmente i task falliti in fondo alla coda. Il sorgente separa route, coda e servizi esterni.

Il limite che conta

La coda vive in memoria: al riavvio lo stato si perde. Il nuovo tentativo riesegue il task e non garantisce assenza di duplicati. Persistenza e idempotenza sarebbero evoluzioni da progettare.

Come leggere questa prova

È una simulazione autonoma scritta per il portfolio, con massimo sei eventi. Il servizio fittizio torna disponibile al secondo tentativo. Il codice del backend privato non viene eseguito né distribuito.

Leggi il codice della demo ↓

// laboratorio personale

Codice per
curiosità.

Automazioni personali, AI visiva, giochi e mondi 3D.
Un bot Python, un laboratorio ComfyUI e dodici esperimenti da tutorial, con rielaborazioni personali. Due piccoli pezzi da provare qui.

Laboratorio personale / GenAI · 2024

ComfyUI / visual lab

FLUX / Stable Diffusion

Studio, ricerca e testing di AI generativa visiva: configurazione di ambienti locali, confronto di modelli e adattamento di workflow per generare e modificare immagini.

Schema illustrativo · GenAI

Workflow da tutorial, adattati e combinati con prove personali su parametri, riferimenti e composizione.

Ambiente e risorse

Python, CUDA e custom node. Prove con FLUX quantizzato in GGUF e Stable Diffusion, gestendo compatibilità dei componenti e memoria GPU disponibile.

Controllo dell'immagine

LoRA esistenti in inferenza, ControlNet e IPAdapter: pesi, pose, profondità, immagini di riferimento e maschere per orientare soggetti e composizione.

Editing e confronto

Inpainting, outpainting e upscaling, con esperimenti su profondità e parallax. Confronto dei risultati e adattamento dei workflow; output di due PC raccolti su Google Drive.

Laboratorio personale / Python

universita_helpbot.py

Python / Selenium

Un progetto di studio personale prima del freelance: automazione del browser con Python e Selenium, anche in modalità headless. Raccolta e organizzazione di domande e risposte, salvataggio in JSON e creazione di flashcard attraverso interfacce web.

Pagine webSelenium + PythonJSON / flashcard
  • Python
  • Selenium WebDriver
  • DOM
  • JSON
Cosa c'è nel progetto

Cosa c'è nel progetto

Interazione con le pagine

WebDriver, selettori DOM e attese esplicite per leggere contenuti e interagire con le interfacce.

Dati riutilizzabili

Raccolta e raggruppamento delle informazioni in file JSON, poi riutilizzate nei flussi dedicati alle flashcard.

Dipendenza dall'interfaccia

Un'automazione del browser segue la struttura delle pagine. Modifiche a selettori e flussi richiedono manutenzione: è uno dei limiti del progetto.

Live fragment / Three.js

Dal mio portfolio 3D.

Una superficie che si muove e cambia colore al passaggio del puntatore. Ripresa da my-portfolio, adattata a questo piccolo spazio.

Si anima solo quando la attivi.
01Giochi & interazioneMovimento, collisioni e sistemi di gioco6 progetti
Schermata reale di fight: due combattenti pixel art in un'arena, con barre della salute e timer.

In evidenza / JavaScript + Canvas

Fight.

fight · due giocatori, tastiera o touch

Un picchiaduro nato dal tutorial di Chris Courses, che ho poi continuato a migliorare.

In questa versione
Doppio salto, salto sulle pareti, attrito e reazione ai colpi.
Dentro il codice
Stati dei combattenti, sprite animati e collisioni degli attacchi.
Round da 60 secondi · 2 giocatori locali
Base di Chris Courses ↗

JavaScript / Canvas / Camera

js_vertical_platformer

Platformer con gravità, collisioni, piattaforme e camera che segue il personaggio sui due assi. Un prototipo per studiare il rapporto tra coordinate del mondo, movimento e inquadratura.

Tutorial ↗

Three.js / JavaScript

js_threejs_game

Movimento da tastiera, gravità, collisioni e comparsa progressiva dei nemici. Un prototipo per esplorare il ciclo di aggiornamento di un gioco 3D.

Tutorial ↗
02Grafica 3D & shaderGeometria, luce e interazioni con il mouse5 progetti

Three.js / Raycaster / GSAP

my-portfolio

Primo esperimento di portfolio 3D: una superficie triangolata animata, colori dei vertici che reagiscono al mouse e parametri regolabili con dat.GUI. Un laboratorio di geometria e interazione.

Tutorial ↗

GLSL / Uniforms / Varyings

intro_to_GLSL

Esperimenti con vertex e fragment shader, tempo passato tramite uniform e deformazioni a onde. Il sorgente contiene anche prove personali delle formule.

Tutorial ↗

Three.js / OrbitControls / GSAP

three_crash_course_n12

Scena, camera e luci; controllo orbitale, gestione del ridimensionamento e variazione del colore con il mouse.

Tutorial ↗
03Multiplayer & reteStato condiviso, sincronizzazione e latenza1 progetto

Node.js / Express / Socket.IO

multiplayer_game

Stato dei giocatori gestito dal server, sincronizzazione dei movimenti, interpolazione sul client, proiettili e classifica. Un esercizio per studiare il rapporto tra rete e gameplay.

Tutorial ↗
Input del clientStato sul serverInterpolazione sul client

Schermate reali delle copie locali; nella preview i font remoti sono sostituiti da font locali. Le basi sono attribuite nei link, le rielaborazioni personali nelle schede. Gli asset dei tutorial appartengono ai rispettivi autori.

// CESO / validazione dei contenuti

Validare i dati di un evento.

Una demo delle regole di CESO per collegare le edizioni di un evento: riferimenti validi, contenuti incompleti e dati da correggere. Dati dimostrativi, esecuzione nel browser.

Architettura del caso CESO ↗
event.demo.jsoninput
{
  "slug": "evento-2026",
  "lastEdition": "evento-2025",
  "previousCover": "cover.jpg"
}
OK / RIFERIMENTO VALIDO

L'edizione precedente c'è.

Il catalogo risolve titolo, anno e copertina. La pagina può essere generata.

→ scheda con titolo + anno + copertina

Un altro modo
di conoscermi.

Prova help, whoami o coffee.
La shell vive soltanto in questa pagina.

visitor@riccardo:~portfolio-shell

Benvenuto nel lato developer.

Digita help per la lista dei comandi. Tab e Invio funzionano come ti aspetti.

// niente ticket per dire ciao

Apriamo una
conversazione.

Freelance con partita IVA, disponibile per nuovi incarichi.
Interessato a entrare in un team: da remoto, in modalità ibrida o in sede.

rikiferri999@gmail.com ↗

Playground / demo giocabile

Fight.

Due giocatori sulla stessa tastiera, oppure usa i pulsanti qui sotto. Premi di nuovo salto mentre sei in aria per il doppio salto. Esc per uscire.

01 / SamuraiA · D · Spazio · J
02 / Kenji← · → · ↑ · Canc

Dal mio repository fight · base di Chris Courses ↗, proseguita con le mie modifiche.

Vai a…

Tab per scegliere · Invio per aprire · Esc per chiudere