Millesettecento prodotti in mezz'ora, e il problema vero era un altro
Brand2Brand è un e-commerce che non ha un magazzino proprio: i prodotti nascono dai cataloghi dei fornitori autorizzati. La domanda tecnica non è come importarli una volta, ma come tenerli allineati ogni giorno senza creare doppioni.
Risultati misurati
1.695
album scoperti alla prima sincronizzazione
1.693
prodotti creati, 2 esclusi da regola
0
errori, a una richiesta al secondo
30 min
per l'intera prima importazione
01 — Contesto
Il catalogo esterno è una sorgente, non il prodotto
Se si specchiano i cataloghi dei fornitori così come sono, il negozio eredita i loro problemi: titoli incoerenti, categorie che non esistono, lo stesso articolo presente due volte con nomi diversi. E a ogni sincronizzazione il disordine raddoppia.
La scelta di fondo del progetto è dichiarata fin dalla prima riga: il prodotto vero è il catalogo proprietario. Quello esterno è soltanto la materia prima.
02 — Approccio
Importare, riconoscere, e ammettere quando non si capisce
Il motore scopre gli album della sorgente, ne ricava i prodotti ed evita di rielaborare ciò che non è cambiato. La prima esecuzione reale su un catalogo autorizzato, il 21 agosto 2026, ha prodotto 1.693 prodotti da 1.695 album in trenta minuti, senza errori.
La parte interessante è come è finita la classificazione: 111 prodotti hanno ricevuto una categoria, 1.582 sono rimasti in attesa di revisione. Non per un difetto della cascata di regole, ma per la forma dei dati — su quella sorgente il titolo dell'album è quasi sempre solo un prezzo e un codice interno, e il tipo di prodotto non compare. Dove compare, la regola scatta e classifica correttamente.
Un motore che avesse indovinato una categoria per tutti avrebbe prodotto un catalogo pieno di errori silenziosi. Lasciarli in attesa di revisione è la scelta che rende il dato utilizzabile.
03 — Soluzione
Il motore, pezzo per pezzo
Gestione delle sorgenti
Fornitori autorizzati, credenziali e regole di inclusione ed esclusione per ciascuno.
Scoperta e importazione
Individuazione degli album, creazione dei prodotti e riconoscimento di ciò che è già noto.
Classificazione a cascata
Regole in ordine di affidabilità, con coda di revisione per i casi che non si decidono da soli.
Accessi e campi riservati
Autenticazione con rotazione dei token, ruoli e campi modificabili solo dall'amministratore.
04 — Risultato
Cosa dice la prima esecuzione vera
Le fondamenta del backend sono complete: modello dati, migrazioni, autenticazione con rotazione dei token, ruoli e protezione dei campi riservati. Il motore di importazione ha girato una volta contro un catalogo autorizzato reale e ha fatto quello che doveva — compreso dichiarare i 1.582 casi che nessuna regola poteva classificare con onestà.