Gestione Installazioni e Punti Vendita
Panoramica
Le installazioni rappresentano i punti vendita gestiti dal distributore. Ogni installazione corrisponde a un tenant sulla piattaforma e contiene dispositivi POS, accessori e configurazioni specifiche. La gestione avviene dalla console reseller, che opera sul database reseller-scoped (r_{resellerCode}).
Creazione di un Nuovo Punto Vendita
Per attivare un nuovo cliente sulla piattaforma:
Step 1: Creazione Tenant
- Accedere alla console reseller, sezione Installazioni > Nuova Installazione
- Compilare i dati del punto vendita:
- Nome: denominazione del locale (es. "Pizzeria Da Mario - Sede Centro")
- Indirizzo: indirizzo completo del punto vendita
- Contatto: nome e email dell'amministratore del locale
- Il sistema crea automaticamente il tenant (
t_{tenantId}) e il database dedicato - Viene generato un codice di attivazione per il primo dispositivo
Step 2: Configurazione Iniziale
Dopo la creazione del tenant, configurare:
- Moduli attivi: selezionare i moduli abilitati dalla licenza (cassa, cameriere, kiosk, etc.)
- Dati fiscali: partita IVA, ragione sociale, indirizzo per lo scontrino
- Parametri operativi: valuta, aliquote IVA, fasce orarie di servizio
Step 3: Registrazione Dispositivi
Ogni dispositivo fisico (tablet, PC, totem) deve essere registrato:
- Dalla scheda dell'installazione, cliccare Aggiungi Dispositivo
- Selezionare il tipo: cassa, cameriere, kiosk, KDS
- Il sistema genera un codice OTP di attivazione
- Inserire il codice OTP nell'app sul dispositivo per completare la registrazione
Gestione Dispositivi
Ogni installazione mostra l'elenco dei posDevices (dispositivi POS) sincronizzati dal servizio devices:
| Campo | Descrizione |
|---|---|
| Tipo | Cassa, cameriere, kiosk, KDS |
| Stato | Online, offline, ultimo heartbeat |
| Versione app | Versione dell'applicazione installata |
| Licenza | Moduli attivati per il dispositivo |
| Ultimo sync | Timestamp dell'ultima sincronizzazione |
Da questa vista e possibile:
- Monitorare lo stato di connessione in tempo reale
- Revocare l'accesso di un dispositivo (disattivazione licenza)
- Visualizzare la cronologia delle attivita
Accessori
Oltre ai dispositivi POS, ogni installazione puo registrare gli accessori associati:
- Stampanti fiscali (modello, numero di serie, ultimo intervento)
- Stampanti di servizio (comande, preconto)
- Lettori barcode
- Cassetti portamonete
- Display cliente
Questa anagrafica facilita la pianificazione della manutenzione e il supporto remoto.
Import Tenant da Portafoglio
Per distributori che migrano clienti da altre piattaforme, la funzione importTenants permette di:
- Caricare un file CSV con l'elenco dei clienti (nome, contatto, dati fiscali)
- Creare in blocco i tenant e i database corrispondenti
- Generare automaticamente i codici di attivazione dispositivo
- Associare ogni installazione al reseller corrente
Monitoraggio
La dashboard reseller offre una vista aggregata di tutte le installazioni:
- Stato dispositivi: conteggio online/offline per punto vendita
- Alert attivi: varianze di cassa, sessioni supporto, errori di sync
- Scadenze licenze: dispositivi con licenza in scadenza nei prossimi 30 giorni
- Versioni app: distribuzione delle versioni installate, evidenziando quelle obsolete
FAQ
D: Posso spostare un'installazione da un reseller a un altro?
R: Si, la riassegnazione del tenant avviene tramite il supporto piattaforma. I dati del cliente restano invariati nel database t_{tenantId}.
D: Cosa succede quando disattivo un dispositivo? R: Il dispositivo perde l'accesso al backend e non puo piu sincronizzarsi. I dati locali rimangono sul dispositivo ma non vengono inviati al server. La licenza viene liberata per un nuovo dispositivo.
D: Come monitoro lo stato di tutti i miei clienti? R: La dashboard reseller mostra una mappa di tutti i punti vendita con indicatori di stato. Gli alert vengono notificati via email e sono visibili nella sezione dedicata.
Vedi Anche
- Guida Distributore -- Panoramica piattaforma per reseller
- Modello Licensing -- Piani e configurazione licenze
- Manutenzione Programmata -- Gestione interventi tecnici