Il registro

Quaranta microservizi, e i prezzi dovevano restare identici al centesimo.

Una piattaforma consumer con pagamenti e abbonamenti

Piattaforma consumer · Microservizi PHP · Refactor in produzione · Catalogo e promozioni

Una piattaforma consumer con pagamenti, abbonamenti e contenuti moderati gira su oltre quaranta microservizi PHP, una ventina di pacchetti interni condivisi e un archivio SQL diviso in dodici sotto-progetti. Il catalogo e le promozioni dovevano passare a una nuova versione mantenendo i prezzi identici, al centesimo, a quelli del sistema in produzione.

In otto settimane siamo diventati il primo contributore su cinque repository del cliente. Il calcolo degli addon è passato da quattordici chiamate a una, con un tempo di risposta più basso del 30%.

40+
microservizi e 20 pacchetti interni in un unico ecosistema
14 → 1
chiamate per calcolare gli addon di un'offerta
-30%
tempo di risposta sul flusso catalogo

Il contesto

L'ecosistema è cresciuto per anni con un team interno affiatato e convenzioni proprie: microservizi Lumen e Laravel, librerie condivise pubblicate su un registro privato, SQL Server come base dati principale, Redis ovunque, RabbitMQ per i messaggi, storage e analisi su più cloud. Nessuno di questi pezzi era in discussione. Il compito era entrare in quel codice e portare avanti il lavoro con le regole della casa.

Il catalogo è il cuore commerciale della piattaforma: prodotti, livelli, funzionalità, addon, promozioni con regole per mercato e provincia, sconti con convenzioni di segno ereditate da versioni precedenti. Il servizio che orchestrava tutto questo aveva superato le quattromila righe in un solo file.

Il vincolo

Il vincolo era doppio. Da una parte, il risultato del nuovo catalogo doveva coincidere con quello vecchio: stesse promozioni, stessi prezzi, per ogni utente e ogni mercato, perché ogni differenza è un cliente che paga una cifra diversa. Dall'altra, il refactor doveva avvenire dentro il flusso di lavoro del team, con le sue pipeline, i suoi ambienti di QA e i suoi rilasci settimanali.

Il mandato sul servizio da quattromila righe era esplicito: input e output non cambiano di una virgola, cambia solo come è fatto dentro.

La decisione

Abbiamo scelto di non riscrivere. Il servizio monolitico è stato scomposto in una struttura a oggetti per categoria, con contenitori tipizzati per parametri e dati al posto di array mutabili passati di mano in mano. Ogni passaggio conservava il comportamento osservabile, verificato con i test del progetto e con confronti sui dati reali.

Per il calcolo delle offerte abbiamo deciso di spostare le regole di blocco dal servizio remoto al servizio che le usa: valutarle in locale toglie una chiamata di rete da ogni valutazione. E dove il codice chiamava la stessa preparazione dati quattordici volte in un ciclo, un registro di fatti la sostituisce con una sola query. Sono scelte da sviluppo software su misura dentro una piattaforma e-commerce già viva.

L'intervento

Le prime settimane sono servite a entrare: leggere i pacchetti condivisi, capire come i servizi si parlano attraverso eventi e code, prendere confidenza con lo schema SQL delle promozioni e con le sue migrazioni. Poi il refactor del servizio centrale, a piccoli commit, sempre con il branch di QA allineato.

La parità con il legacy è stata verificata sui dati veri. È così che è emerso il caso più delicato: per lo stesso utente il vecchio sistema restituiva undici promozioni e il nuovo quattordici, per una divergenza nel modo in cui i gruppi di promozione venivano collassati e nell'instradamento per provincia. Trovarlo prima del rilascio ha evitato prezzi diversi in produzione.

Nello stesso sprint sono stati chiusi i divari dell'API catalogo nella nuova versione: livelli, funzionalità dinamiche con un pattern a mutatori, addon aggregati, un equalizzatore geografico per il prezzo differenziale, il servizio di upsell come decoratore. Le dipendenze circolari tra carrello e acquisti sono state sciolte con inizializzazione differita, la soluzione più semplice che il team ha confermato.

APP → AGGREGATORE → CATALOGO / PROMOZIONI → PACCHETTI CONDIVISI → SQL · REDIS · CODE

Schema semplificato. Dettagli architetturali e integrazioni non pubblicati per riservatezza.

Il risultato

Il calcolo degli addon è passato da quattordici chiamate a una, con un caricamento in blocco delle promozioni al posto delle query una per una: circa 1,8 secondi in meno sul percorso più lento, e un tempo di risposta complessivo più basso del 30%. Le regole valutate in locale hanno tolto la latenza remota da ogni valutazione di offerta.

In otto settimane eravamo il primo contributore su cinque repository, tra cui il servizio degli eventi e l'aggregatore applicativo. Il codice è rimasto nello stile della casa, il team ha continuato a rilasciare ogni settimana e il catalogo nuovo espone gli identificativi delle promozioni legacy dove il resto del sistema ancora li cerca.

Dopo il rilascio

Il lavoro continua sullo stesso ecosistema: la proposta successiva è una risposta progressiva del catalogo, che mostra le prime offerte mentre le altre arrivano, per abbassare la latenza percepita senza toccare il calcolo. Entrare in un sistema di questa taglia è il caso tipico del nostro settore retail ed e-commerce.

Un gestionale nuovo per oltre 400 agenzie →

Descrivici il sistema. Ti diciamo cosa vediamo.

Dieci minuti, una domanda alla volta. Alla fine, la nostra lettura onesta del caso. È il filtro, prima ancora della call.