Manzo Ricambi WebSite 2.0

Ricostruzione completa dell’e-commerce di un’attività storica di ricambi elettrodomestici (dal 1950)

Stack: WordPress / WooCommerce, PHP, MySQL, REST API, JavaScript
Tipo di progetto: E-commerce B2C + area B2B, tema custom sviluppato da zero
URL: manzoricambi.it

Il Problema

Manzo Ricambi vende ricambi per elettrodomestici dal 1950, con un catalogo che oggi supera i 20.491 codici e 239 marche compatibili. Un catalogo di queste dimensioni pone due problemi molto concreti in un e-commerce:

1. Trovare il pezzo giusto è difficile. Un cliente spesso non conosce il codice esatto del ricambio, ma solo il modello o la matricola del proprio elettrodomestico — e lo stesso ricambio può avere più codici (originale, multicodice, varianti) a seconda del produttore.
2. Il sito serve due pubblici molto diversi: il cliente finale che compra un pezzo occasionale, e i rivenditori/riparatori (B2B) che lavorano con listini dedicati, ordini ricorrenti e hanno bisogno di strumenti gestionali propri (carrelli assegnati, fatture, ricontatto clienti inattivi).

Il vecchio sito non reggeva più né la scala del catalogo né la complessità di questi due flussi.

La Soluzione

Il sito è stato ricostruito da zero su WordPress/WooCommerce con un tema custom, progettato attorno a un motore di ricerca e verifica compatibilità pensato apposta per chi deve trovare un ricambio senza sapere esattamente cosa cercare, e a un’area B2B con strumenti gestionali dedicati per staff e rivenditori.

Funzionalità Principali

Verifica modello & compatibilità Una tabella di compatibilità importata dal gestionale via REST API alimenta la verifica del modello: inserendo matricola o codice si ottiene il riscontro con match per prefisso, suggerimenti e l’etichetta “modello verificato”, su migliaia di combinazioni codice/modello/matricola consultabili e filtrabili su ogni prodotto. Il confronto dei codici ignora automaticamente i separatori (es. formati PNC Electrolux), così varianti di scrittura dello stesso codice vengono comunque riconosciute.

Motore di ricerca Un dispatcher di ricerca unico gestisce tutti gli ambiti (codici, modelli, matricole) con sinonimi, varianti singolare/plurale in stile Amazon e normalizzazione degli accenti; i codici originali vengono sempre mostrati in cima ai risultati. Quando una ricerca non produce risultati, il sistema propone suggerimenti “forse cercavi” e registra la query in un log per capire cosa i clienti non riescono a trovare. A completare l’esperienza, landing page di “ricerche semplificate” per categorie molto cercate: filtri metallici, griglie piano cottura, balconcini frigo, cinghie.

Area B2B & gestione ordini Lo staff gestisce i carrelli dei clienti rivenditori direttamente da wp-admin (visualizza, modifica, invia, e da qui può anche generare direttamente l’ordine), con badge “già acquistato” su schede e ricerca, inserimento di ricambi in omaggio/sostituzione e retrocessione automatica dei clienti inattivi via cron. Un sistema di email di ricontatto, con anteprima destinatari e invio a ondate, riattiva i clienti che non ordinano da tempo. L’area B2B include anche fatture scaricabili, gestione carrello con prezzi di listino personalizzati e uno strumento di caricamento prodotti con controllo automatico dei doppioni sul codice.

Checkout & spedizioni Checkout WooCommerce a 3 step con dati fiscali completi (CF, P.IVA, SDI, PEC), scelta fattura/ricevuta, supplemento per il pagamento alla consegna e spedizione calcolata a peso con tariffario per corriere e zona, sincronizzabile dal gestionale con un solo invio. Il tracciamento spedizioni si integra direttamente con GLS (stato, città e provincia di destinazione, numero colli, peso), e un riquadro “consegna prevista” calcola la data stimata escludendo automaticamente chiusure festive, ferie e lutti.

Chat live e assistenza Un assistente automatico risponde in tempo reale su ordini, tracciamento, compatibilità e orari; se il cliente chiede di parlare con un operatore, la conversazione passa allo staff — che può rispondere anche da Telegram, tramite un ponte che porta ogni messaggio in una chat dedicata, senza dover aprire il pannello di amministrazione. Il sistema gestisce coda, valutazioni post-chat, notifiche sonore e traduzione automatica dei testi del bot nelle lingue del sito.

Resi e-commerce Pratica di reso online con finestra di recesso a 30 giorni, scambio di messaggi con foto tra cliente e assistenza e timeline di avanzamento della pratica.

Design system & performance Design system con token OKLCH, tipografia Inter / IBM Plex Mono, icone Lucide + Simple Icons e moduli CSS condizionali per shop, prodotto e account. Sotto il cofano: indice range sulle matricole, caching di faccette, miniature e conteggi categoria pre-calcolati, query dirette via $wpdb per i prodotti in evidenza — ottimizzazioni che, secondo i log delle release, hanno portato pagine da 200ms a caricamento pressoché istantaneo e pagine categoria da 163ms a 21ms.

Scala e Continuità del Progetto

Il changelog pubblico del sito racconta bene la portata del lavoro: partito come concept alpha nel 2020, passato per due anni di beta, arrivato alla prima release pubblica nel 2024 e completamente riscritto con il major redesign 2.0 nel 2026, il progetto conta oggi 20 release, oltre 1.170 commit registrati e una cadenza di rilascio quasi giornaliera nelle fasi più attive — un ritmo di manutenzione ed evoluzione continua tipico di un e-commerce realmente in produzione, non di un progetto “una tantum”.

Architettura Tecnica

• CMS/E-commerce: WordPress con WooCommerce, tema custom (non da marketplace)
• Backend: PHP con architettura modulare (setup → i18n → config → assets → helpers → woocommerce), query dirette $wpdb dove le performance lo richiedono
• Integrazioni: REST API con il gestionale interno per compatibilità modelli, giacenze e corrieri; integrazione diretta con l’API di tracciamento GLS; bridge con l’API di Telegram per la chat live
• SEO: dati strutturati (JSON-LD) su prodotto con modelli e codici compatibili, redirect 301 dagli URL legacy, sitemap ottimizzata
• i18n: sito multilingua con traduzione automatica di contenuti e testi dinamici (bot chat incluso)
• Sicurezza: protezione anti-spam e anti-abuso su form pubblici e accessi, conformità GPSR con tab dedicato alla sicurezza prodotto

Il Mio Contributo

Ho lavorato all’interno del team di sviluppo del progetto, occupandomi di sviluppo e coding lato frontend e backend a supporto dell’architettura complessiva, affiancando il programmatore principale nella realizzazione di funzionalità del sito e nelle attività di ottimizzazione.

Numeri

• +20.491 codici a catalogo
• 239 marche compatibili
• 24/48h tempo medio di spedizione in Italia
• 20 release pubblicate, +1.170 commit

Caratteristiche Distintive

• Motore di ricerca e compatibilità pensato per chi non conosce il codice esatto del ricambio
• Doppio flusso B2C / B2B gestito nativamente, non come plugin aggiuntivo
• Automazioni gestionali (ricontatto clienti, retrocessione inattivi, sync gestionale) che riducono il lavoro manuale dello staff
• Attenzione sistematica alle performance, documentata release dopo release con numeri concreti
• Sviluppo continuo e misurabile: 20 release e oltre 1.170 commit in un progetto tuttora in produzione