04 — Internal Tooling

Portale Operativo

Digitalizzazione del manuale operativo di Non Solo Sport in un portale web interno costruito con MkDocs: 274 pagine su tecniche di vendita, product knowledge (9 brand di calzature, 8 discipline sportive, materiali tessili) e visual merchandising, navigabili tramite sidebar gerarchica, card ad accesso rapido e ricerca full-text in italiano.

MkDocs Python Markdown HTML / CSS Lunr.js MkDocs Material Information Architecture Internal Tooling Technical Writing

Obiettivo del progetto

Il manuale operativo di Non Solo Sport esisteva in forma frammentata: procedure di vendita, schede tecniche di prodotto, linee guida di visual merchandising e istruzioni di magazzino erano distribuiti tra documenti Word, PDF e fogli cartacei — inaccessibili al personale durante il lavoro quotidiano in negozio.

L'obiettivo era centralizzare tutto in un portale web interno consultabile da qualsiasi dispositivo, aggiornabile senza competenze tecniche e strutturato attorno ai reali flussi di lavoro del personale — non alla logica organizzativa dell'archivio originale.

274
Pagine
Contenuti pubblicati
8
Sezioni
Macro-aree tematiche
9
Brand
Con schede tecniche calzature
8
Sport
Con guide calzature dedicate

Architettura dei contenuti

Il lavoro è partito dalla mappatura dei contenuti esistenti e dalla definizione di una struttura che rispecchiasse i reali bisogni del personale — non la logica dei documenti originali. Il risultato sono 8 sezioni principali, ciascuna con profondità e granularità calibrate sul volume e sulla frequenza d'uso delle informazioni.

Azienda 10 pagine
Storia, identità, valori, brand, format di negozio (NSS e GFC Gallery) e strategia omnicanale ed e-commerce.
Storia & Mission Format negozio Omnicanalità
Metodo di vendita 59 pagine
La sezione più ampia: tecniche di vendita, approccio al cliente, sondaggio, gestione obiezioni (prezzo, articolo, tempo), gioco di squadra e upselling.
Accoglienza Sondaggio Obiezioni Upselling Team selling
Manuale Visual 2023 29 pagine
Criteri espositivi per pareti (2–5 moduli), tavoli, vetrine e zona zaini. Procedure di prezzatura, taccheggio, gestione saldi e ultimi numeri calzature.
Layout pareti Vetrine Prezzatura Taccheggio Saldi
Gestione Magazzino 7 pagine
Struttura generale, suddivisione per categoria, organizzazione abbigliamento, accessori e calzature. Gestione fine serie e cuscinetti.
Struttura Abbigliamento Calzature Fine serie
Prodotto — Abbigliamento 39 pagine
Conoscenza tecnica di fibre e materiali: naturali (cotone, lana, lino, seta), sintetiche (poliestere, poliammide, elastomeri), microfibre, modal, viscosa.
Fibre naturali Fibre sintetiche Microfibre Lana & Modal
Etichettatura Tessile 10 pagine
Normative di etichettatura, nomenclatura dei capi in italiano e inglese, simboli di manutenzione e composizione.
Normative Simboli cura Nomenclatura EN/IT
Prodotto — Calzature 52 pagine
Schede tecniche per 9 brand: storia, tecnologie di tomaia, intersuola e suola esterna. Include biomeccanica del piede, tipologie di appoggio e fasi del passo.
Nike · Adidas · Asics Puma · Reebok · Mizuno New Balance · Lotto · Fila Biomeccanica
Sport 26 pagine
Guide per disciplina sportiva: calzature specifiche per terreno/ruolo, caratteristiche tecniche rilevanti e criteri di consiglio al cliente.
Running Calcio · Basket · Volley Tennis · Padel Outdoor · Training

Sviluppo — MkDocs & Customizzazione

Il portale è costruito su MkDocs Material come base, con un tema completamente personalizzato per rispecchiare l'identità visiva di Non Solo Sport e ottimizzato per la consultazione da dispositivi mobili in reparto.

Configurazione principale

Il file di configurazione MkDocs definisce il tema Material come base, abilita la navigazione a tab e sezioni espandibili, il pulsante "torna in cima" e il suggerimento automatico nella barra di ricerca. Il plugin Search è configurato esplicitamente in italiano per gestire correttamente la morfologia della lingua, mentre il plugin Minify comprime l'HTML in output per ridurre i tempi di caricamento.

CSS personalizzato — scelte principali

Il tema è stato sovrascritto in più punti per adattarlo all'identità visiva aziendale. La palette colori è stata impostata sul blu istituzionale del brand. L'header è stato ridisegnato con CSS Grid per centrare il logo e allineare la barra di ricerca a destra, eliminando il titolo testuale del sito. Nella sidebar, il comportamento di default di MkDocs che tronca le voci lunghe con puntini di sospensione è stato rimosso — i titoli delle procedure operative sono spesso lunghi e devono essere leggibili per intero. Le card della homepage hanno ricevuto un bordo superiore colorato e un effetto hover con sollevamento. Il pannello laterale destro con l'indice della pagina è stato nascosto per lasciare più spazio al contenuto, e la larghezza massima della griglia è stata portata a 1400px per sfruttare monitor da scrivania e tablet in orizzontale.

Anteprima del portale

Anteprima del portale
Homepage del portale — card di accesso rapido alle 8 sezioni principali

Sistema di Navigazione Trimodale

Il portale è progettato per tre profili d'uso distinti: chi esplora la struttura, chi vuole raggiungere rapidamente una sezione frequente, e chi cerca qualcosa di specifico senza sapere dove trovarlo.


Cosa ha risolto il progetto

01

274 pagine in un portale unico

Procedure di vendita, schede tecniche di 9 brand di calzature, guide per 8 discipline sportive, manuale visual e normative tessili — tutto accessibile da un unico punto, da qualsiasi dispositivo in negozio.

Da archivio frammentato a portale consultabile
02

Product knowledge sempre disponibile

Il venditore può consultare in tempo reale la tecnologia Air Unit di Nike, il Wave System di Mizuno o i tipi di appoggio plantare durante una conversazione con il cliente — senza cercare tra fogli cartacei.

Sezione calzature · 52 pagine brand + biomeccanica
03

Metodo di vendita strutturato e consultabile

59 pagine traducono le tecniche di vendita in una guida consultabile per singolo argomento: dall'accoglienza del cliente alla gestione dell'obiezione di prezzo, fino al gioco di squadra tra colleghi.

Onboarding nuovo personale accelerato
04

Aggiornamenti senza competenze tecniche

Ogni modifica al manuale corrisponde a editare un file Markdown e rieseguire il build. Nessun CMS, nessun database — chiunque sappia aprire un file di testo può aggiornare il contenuto.

Markdown + MkDocs build pipeline
05

Zero dipendenze server lato runtime

Il sito statico è deployabile su qualsiasi file server o intranet aziendale senza backend, database o configurazioni complesse. La ricerca full-text gira interamente lato client con Lunr.js.

Deploy su intranet · Nessun backend richiesto
06

Identità visiva coerente col brand

Header con logo centrato tramite CSS Grid, palette aziendale personalizzata, sidebar con separatori tra sezioni, cards con top-border brand e max-width a 1400px per sfruttare monitor da scrivania e tablet orizzontale.

CSS custom completo su MkDocs Material

Takeaway

Il progetto dimostra come una scelta tecnologica deliberatamente semplice — sito statico, Markdown, build automatico — possa risolvere un problema operativo reale in modo più efficace di soluzioni più complesse. La chiave non è la tecnologia scelta, ma la cura nell'architettura dei contenuti: strutturare 274 pagine in modo che il personale trovi quello che cerca in pochi secondi, sia durante un riassortimento in magazzino, sia spiegando a un cliente la differenza tra le tecnologie proprietarie dei brand (Boost, Gel, Wave…).


Contesto & Riservatezza

Il portale è uno strumento interno aziendale. La struttura delle sezioni, le scelte tecniche e il sistema di navigazione sono descritti integralmente; i contenuti operativi sensibili (procedure di cassa, politiche commerciali, dati di magazzino) non sono pubblicati per ragioni di riservatezza aziendale.