Pagine Prodotto & Schede Tecniche: Assemblaggio Dinamico da Fonti Multiple

Questo articolo spiega come generiamo pagine prodotto e schede tecniche PDF combinando dati da più sistemi.

Il Problema: i Dati Prodotto sono Sparpagliati

Una pagina prodotto necessita di:

  • Info prodotto: Nome, descrizione, caratteristiche

  • Immagini: Foto multiple del prodotto (da S3)

  • Prezzi: Prezzi correnti in più valute (dal motore di prezzi)

  • Stock: Conteggi di inventario in tempo reale

  • Specifiche: Specifiche tecniche raggruppate per categoria (dalla struttura SKU)

Assemblare questi dati da fonti multiple per ogni caricamento di pagina è complesso.

La Soluzione: Assemblaggio Dinamico con Cache

Assembliamo le pagine prodotto su richiesta:

  1. Carica dati prodotto dal database prodotto (in memoria)
  2. Recupera immagini da S3 tramite manifesto immagini
  3. Calcola prezzi con conversione valuta
  4. Interroga stock dal database (in cache in Valkey)
  5. Genera scheda tecnica su richiesta o dalla cache

Database Prodotto

Utilizziamo un database prodotto che contiene:

  • Descrizioni prodotto: Nomi e caratteristiche del prodotto

  • Informazioni parti: Dettagli dei componenti

  • Dati BOM: Distinta Base per prodotti assemblati

  • Prezzi: Prezzi web e conversioni di valuta

Assemblaggio Pagina Prodotto

Le pagine prodotto sono assemblate da più fonti:

  1. Database prodotto: Nome prodotto, caratteristiche, prezzi
  2. Archiviazione S3: Immagini prodotto dal manifesto immagini
  3. Database: Conteggi stock (prodotti finiti + parti)
  4. Valkey: Conteggi stock in cache per le prestazioni

Sorgenti Immagini

Le immagini prodotto provengono da S3:

  1. Manifesto immagini: Registro centrale delle posizioni delle immagini
  2. Bucket S3: Immagini prodotto archiviate in object storage
  3. Formato WebP: Immagini ottimizzate per un caricamento veloce
  4. Fallback: Immagini segnaposto quando le immagini reali non sono disponibili

Generazione Schede Tecniche

Le schede tecniche sono generate come PDF utilizzando pdfkit:

  1. Template: Template HTML con informazioni prodotto
  2. Caratteristiche: Estratte dal database prodotto
  3. Immagini: Immagini prodotto da S3
  4. Conversione PDF: Da HTML a PDF utilizzando wkhtmltopdf

Il layout della scheda tecnica utilizza un formato a 2 colonne con intestazioni in grassetto per i nomi delle caratteristiche.

Calcolo Inventario

Calcoliamo l'inventario da più livelli:

  1. Livello 1: Pronto per la spedizione (Stock prodotti finiti)
  2. Livello 2: Pronto in 3 giorni (stock minimo componenti)
  3. Livello 3: Pronto in 15 giorni (stock scheda + RAM)

Calcolo Prezzi

I prezzi sono calcolati utilizzando:

  1. Prezzo web: Dal database prodotto
  2. Conversione valuta: Converti nella valuta dell'utente
  3. IVA: Aggiungi l'imposta applicabile
  4. Importo netto: Totale comprensivo di imposta

Descrizione Potenziate dall'IA

Utilizziamo DeepSeek per generare descrizioni prodotto:

  1. Costruisci nome prodotto: Da SKU
  2. Estrai caratteristiche: Dal database prodotto
  3. Invia a DeepSeek: Con prompt di sistema per la cache
  4. Analizza risposta: Slogan e corpo
  5. Memorizza per supporto multilingua

Riepilogo

Le pagine prodotto e le schede tecniche forniscono:

  • Informazioni complete: Da fonti multiple

  • Immagini ottimizzate: Formato WebP da S3

  • Caricamento veloce: Cache Valkey per i conteggi stock

  • Contenuti IA: DeepSeek per le descrizioni

  • Multilingua: Supporto per più lingue