Gestionale · Colmac gestionale e interfaccia documentazione tecnica

Colmac doc

Portale di documentazione tecnica multilingua per Colmac Medio Italia. Un QR code stampato su ogni macchina porta l'operatore direttamente alla scheda del modello, con manuali, esplosi e certificazioni in 5-8 lingue. Plugin WordPress custom con REST API, front-end React e importatore massivo dei PDF: l'ufficio tecnico aggiorna il catalogo in autonomia, senza intervento tecnico.

  • WordPress headless
  • Plugin PHP custom
  • Custom Post Type
  • REST API custom
  • React 18
  • React Router 7
  • Vite
  • Meta Box
  • Media Library
  • Import massivo
  • QR code
Anteprima desktop di Colmac doc
Anteprima mobile di Colmac doc
Il progetto

Descrizione

Colmac Medio Italia distribuisce macchinari per l'edilizia in tutta Italia. Il problema: reperire il manuale corretto di un modello, nella lingua giusta, richiedeva passare dall'assistenza. Abbiamo progettato e sviluppato un portale di documentazione tecnica accessibile direttamente dal campo: l'operatore inquadra il QR code stampato sulla macchina e atterra sulla scheda del modello, con tutti i documenti disponibili — catalogo, libretto di assistenza, esploso ricambi, dichiarazione CE, scheda tecnica — in 5-8 lingue.

Il portale vive su un sottodominio dedicato, completamente isolato dall'e-commerce WooCommerce esistente, così da non introdurre rischi sul sito di vendita. Il cuore è un plugin WordPress su misura che espone una REST API pubblica, consumata da un'applicazione React con ricerca istantanea e filtri per linea prodotto e tipo di macchina. Per il caricamento massivo abbiamo realizzato un importatore che riconosce modello, tipo di documento e lingua dal nome del file: l'ufficio tecnico trascina i PDF e il catalogo si popola da solo. Gli URL dei QR sono un contratto stabile: i codici già stampati restano validi per sempre.

Il progetto

Sfida e soluzione

La sfida

Colmac Medio Italia gestisce un catalogo di oltre 50 modelli di macchinari per l'edilizia, ognuno con più documenti tecnici — catalogo, libretto di assistenza, esploso ricambi, dichiarazione CE, scheda tecnica — in 5-8 lingue diverse. La documentazione era dispersa tra cartelle interne, allegati email e richieste all'ufficio tecnico. Chi lavorava in cantiere, davanti alla macchina, non aveva modo di recuperare in autonomia il manuale corretto: doveva chiamare, aspettare, sperare che gli arrivasse la versione giusta nella lingua giusta. Ogni richiesta consumava tempo dell'assistenza per un'informazione che avrebbe dovuto essere immediata. Serviva un accesso diretto dal campo, ma senza toccare l'e-commerce WooCommerce già in produzione, dove ogni intervento è un rischio commerciale.

La soluzione

Abbiamo realizzato un portale di documentazione dedicato, su un sottodominio isolato dal sito di vendita. Su ogni macchina viene stampato un QR code univoco per modello: l'operatore lo inquadra e atterra sulla scheda del prodotto, con tutti i documenti disponibili e il selettore di lingua. Niente login, niente ricerca a tentoni. Sotto il cofano abbiamo costruito un plugin WordPress su misura che espone una REST API pubblica, consumata da un'app React con ricerca istantanea e filtri per linea prodotto e tipo di macchina. Per l'ufficio tecnico abbiamo sviluppato un importatore massivo: i PDF vengono rinominati secondo una convenzione e trascinati in blocco, il sistema riconosce modello, tipo di documento e lingua e popola il catalogo da solo. Aggiornare la documentazione non richiede competenze tecniche né il nostro intervento. Gli URL dei QR sono un contratto stabile e permanente: i codici già stampati sulle macchine in circolazione restano validi per sempre, anche in caso di future evoluzioni del portale.

Hai un progetto simile?

Raccontacelo: ti diciamo come lo affronteremmo e cosa aspettarti.

Richiedi informazioni