E-commerce B2B/B2C con integrazione Mexal, blog AI-autopilot e schede PDF real-time

Contesto

Cliente del settore ferramenta con 5 marchi distinti, catalogo di 1.800 articoli attivi, presenza commerciale in 9 mercati linguistici, dealer in tutta Europa. Gestionale interno: Mexal/Passepartout con Docuvision per archivio documenti tecnici.

Prima del mio intervento: sito statico aggiornato a mano, copie parallele per le lingue, dealer che chiamavano per i prezzi reali, blog abbandonato da anni, schede tecniche mandate via email PDF per PDF quando un dealer le chiedeva.

Sfida

Costruire un ecommerce B2B+B2C che non fosse "l'ennesimo catalogo online", ma che integrasse nativamente il gestionale, automatizzasse le operazioni editoriali ricorrenti (blog, listini, schede), e sostenesse operativamente dealer, agenti e clienti finali in 9 lingue — senza un team IT interno a mantenerlo.

Approccio

Stack Next.js + TypeScript + Firebase, sviluppato con Claude Code come acceleratore. Di seguito le feature che fanno davvero la differenza — non le cose standard di ogni ecommerce.

DidiBot: blog in autopilot su VPS

Un agente AI che vive su VPS Hostinger (container OpenClaw) e gestisce da solo il ciclo editoriale del blog:

• Lunedì: analizza Google Search Console (skill ga4-analytics) e propone le keyword prioritarie della settimana
• Martedì: scrive bozze articolo in markdown, genera l'immagine di copertina, carica su /admin/api/upload-catalog-image.php, crea il post via POST /api/blog/posts con traduzioni in 6 lingue
• Giovedì: pubblica automaticamente su LinkedIn, Instagram, Facebook via upload-post, sottopone l'URL a Google Indexing API
• Comunicazione: WhatsApp come broker (dmPolicy ristretto a 2 numeri autorizzati), GitHub per commit automatici degli MDX

Il blog non è una pagina morta. Pubblica contenuti reali, a ritmo, senza intervento umano dopo il setup iniziale.

Schede tecniche PDF real-time da Mexal + Docuvision

L'endpoint /api/scheda-tecnica/[codice]/pdf genera una scheda tecnica A4 completa su richiesta:

• Legge in diretta da Mexal WebAPI (comando lista_docdv su classe Docuvision 1200) l'elenco degli allegati tecnici del prodotto
• Scarica i PDF allegati via get_allegato_archivio
• Compone la scheda con jsPDF: badge tipologia, codice + barcode via bwip-js, immagine prodotto, attributi tradotti, tabella misure con codici colorati per lettera (A/B/C/Ø)
• Con ?includeDrawings=true fa il merge via pdf-lib degli allegati Docuvision, gestendo automaticamente la rotazione landscape→portrait per i disegni quotati
• Parametri: ?lang=de per monolingua, ?all=true per tutte le varianti, default bilingue IT/EN

Zero tempo di attesa per dealer e commerciali: cliccano e hanno il PDF.

180 listini PDF multilingua pre-generati

5 brand × 9 lingue × 4 materiali base = 180 listini PDF, tutti pre-generati da uno script Python (generate_catalog_pdf.py con ReportLab, non viewer esterni). Dizionario di traduzione custom interno per tutti i termini tecnici e di navigazione (9 lingue + pattern matching sulle stringhe composte tipo "Pagina X di Y"). L'area B2B propone il PDF nella lingua del dealer con fallback automatico all'italiano se non esiste.

scheduled_export.py: l'orchestratore nascosto

Uno script Python di ~1100 righe che gira cron-schedulato ogni notte ed è il vero motore dell'ecommerce. Sette sync paralleli non bloccanti:

• V_B2B_EXPORT_CATALOGO_NEW da SQL Server → MySQL via pyodbc (con safety check: abort se meno di 100 righe, per non pubblicare un catalogo vuoto dopo un errore ERP)
• PDF articoli, prezzi dealer B2B, anagrafica agenti, KPI per nazione, metodi pagamento, inventario
• Export products_python.json con traduzioni Claude API (cache aggressivo), poi upload dual-target: FTP a SiteGround + push gzip a endpoint Vercel per bypassare CAPTCHA SiteGround su payload grandi
• Generazione feed Google Merchant Center XML
• Log giornaliero + storico JSON ultimi 30 giorni

È l'infrastruttura invisibile che rende tutto il resto "sempre aggiornato" senza intervento umano.

Email transazionali con tracking dettagliato

Invio via Brevo, con proxy PHP su SiteGround per aggirare restrizioni IP. Ogni email è loggata in Firestore (email_logs) con brevoMessageId, status aggiornato in tempo reale da webhook Brevo (sent → delivered → opened → clicked → eventuale bounce). Dashboard interna nell'admin panel: filtri per tipo, lingua, status, range date; metriche percentuali di consegna e apertura; azioni di resend per le email di benvenuto.

Risultato

Sistema in produzione usato quotidianamente da dealer B2B, clienti B2C e agenti di 5 marchi in 9 mercati linguistici. Il blog si popola da solo, i listini si aggiornano ogni notte, le schede tecniche si generano al volo. Il cliente gestisce l'ecommerce senza un team IT interno — la parte operativa è nelle mie mani, ma il 95% del sistema funziona senza mai doverci mettere le mani.

Quello che considero il risultato tecnico più interessante è che ogni automazione nascosta ha un controllo di sanità esplicito — safety check, fallback, logging, webhook status. Non è AI buttato sopra un ecommerce tradizionale: è un sistema in cui ogni pezzo sa cosa fare quando qualcosa va storto. È la disciplina che distingue un progetto che regge in produzione da uno che crolla al primo errore ERP.