Processi operativi.

Ruoli

Ogni amministratore e agente opera esclusivamente sui dati del proprio panificio. Un agente non può autenticarsi nell’ambiente di un altro tenant.

Preparazione giornata

1. Configurazione stabile

Il panificio registra prodotti, punti vendita, prezzi personalizzati per cliente, furgoni e agenti abilitati all’app. Ogni cliente viene assegnato agli agenti che possono servirlo. Nelle impostazioni del panificio sceglie anche la modalità mobile: Turni e carichi, Tentata vendita oppure Mista.

2. Composizione giro

Un giro contiene le tappe GDO in sequenza e l’orario previsto. Per la giornata viene creato un turno associando giro, agente, furgone e intervallo di numeri DDT utilizzabili offline.

3. Ordini e carico

Gli ordini preventivi vengono inseriti per cliente e prodotto utilizzando il listino valido. Il backoffice raggruppa le sezioni in modo più chiaro tra operatività, anagrafiche, accessi e impostazioni; clienti e listini supportano ricerca, gli agenti dispongono di una scheda dedicata per assegnazioni e contesto operativo, gli ordini pianificati supportano più righe prodotto con resi per singola riga e l’amministratore tenant può aggiornare direttamente l’intestazione del panificio attivo usata nei documenti operativi. In `admin/catalog/customers` è ora disponibile anche l’email cliente, usata per l’invio dei tracciati Excel dei DDT. In `admin/operations/orders`, per gli ordini già consegnati con DDT generato, sono disponibili filtri per periodo, cliente, stato e ricerca libera, selezione singola o totale degli ordini esportabili filtrati, export Excel singolo o massivo, export TeamSystem singolo o massivo e invio/rinvio email singolo o massivo del tracciato Excel. L’export Excel riporta prima i prodotti consegnati e poi i prodotti resi, con colonne `cod.articolo`, `descrizione`, `quantità`, `prezzo` e `totale`, e i resi sono esposti in negativo. L’export TeamSystem produce un file testuale fixed-width con record `TESTA` e `CORPO`, usando righe da 400 caratteri come nel tracciato demo caricato in `tracciati/teamsystem`; negli ZIP massivi i file con stessa intestazione vengono rinominati con il riferimento DDT per non perdere documenti. L’area impostazioni tenant include ora anche `Notifiche push`: il panificio può comporre un messaggio, caricare direttamente un’immagine dal proprio dispositivo oppure usare un URL remoto, inviarlo a un singolo agente oppure a più agenti selezionati, consultare uno storico paginato degli invii, svuotare il log e mantenere al massimo 50 righe locali. Le chiavi OneSignal non vengono gestite dal tenant ma dal super admin in una configurazione piattaforma condivisa. La dashboard tenant del panificio supporta ora filtri per veduta, periodo, cliente, agente, mezzo e giro raccolti in un pannello a espansione, così su schermi piccoli il contenuto resta leggibile; mostra una cabina di regia più leggibile con volumi chiave, controlli su DDT non confermati e resi, classifica clienti top e accessi rapidi alle sezioni operative. L’esportazione in Excel resta coerente con veduta e filtri attivi e, nella veduta DDT, usa una riga per articolo con resi esposti sempre in negativo. Le anagrafiche clienti, prodotti, furgoni e giri restano in tabella compatta ma ora leggono meglio lo stato reale del catalogo con ordinamento più naturale, indicatori di completezza e avvisi rapidi su listini, assegnazioni, categorie, descrizioni e tappe mancanti. L’app agente è stata affinata con ricerca clienti, filtri rapidi, priorità di giro, stato sync più leggibile, visibilità immediata dei clienti filtrati, situazione del van con prodotti in esaurimento, metriche operative compatte in griglia 2x2, contenuto inferiore realmente scrollabile e composer ordine più rapido. Prima della partenza si registra la quantità di ciascun prodotto caricata sul furgone. L’app integra inoltre OneSignal: legge la configurazione pubblica dal backend, si identifica con l’account agente, mostra un’icona notifiche dedicata in alto a destra e conserva sul dispositivo uno storico consultabile delle notifiche ricevute. Le schermate principali mobile sono ora allineate alle Safe Area di sistema, così login, home giro, notifiche, composer ordine e storico ordini non vengono coperti dalle barre di stato o di navigazione Android. Su iOS il pacchetto include anche una Notification Service Extension dedicata, così le push con immagine possono essere rese come rich media dal sistema quando la firma Apple e le capability del target sono configurate.

Consegna sul campo

• L’agente accede all’app Consegne Panificio, distribuita negli store con bundle it.appteam.panificio, usando le credenziali del proprio panificio.
• Dalla home agente, l’icona notifiche in alto a destra apre lo storico locale delle push ricevute sul dispositivo, comprese eventuali immagini associate.
• Al mattino scarica in una chiamata giro, clienti assegnati, relativi listini, ordini e stock iniziale del furgone.
• Se il tenant usa la modalità Tentata vendita, l’app scarica clienti e listini assegnati senza richiedere turno, giro o carico furgone; in modalità Mista l’agente può scegliere tra giro pianificato e vendita libera.
• L’app conserva lo snapshot localmente e consente la lavorazione completa anche in assenza di rete.
• L’agente seleziona esclusivamente uno dei clienti assegnati e compone l’ordine usando i prodotti a listino per quel cliente.
• Durante la composizione del giro pianificato l’app confronta il consegnato con il carico residuo del furgone e impedisce di chiudere il DDT con quantità superiori allo stock disponibile; in tentata vendita non viene applicato il blocco sul carico perché il flusso non richiede un turno caricato.
• Prima della chiusura registra, prodotto per prodotto, la quantità consegnata e il pane reso recuperato dal cliente.
• L’agente seleziona dall’app la stampante termica Bluetooth da utilizzare; la scelta resta disponibile per le consegne successive e i permessi richiesti restano limitati a stampa BLE e notifiche push operative.
• Alla chiusura l’app salva subito il DDT e lo invia alla stampante, senza attendere la rete; l’invio al panificio viene completato appena la sincronizzazione è disponibile, anche al ritorno della connettività senza richiedere sempre il tasto manuale.
• La stampa DDT consegnata al cliente riporta numero documento, data ordine, intestazione del panificio e del cliente, prodotti, consegnato e reso valorizzati con il listino dedicato e totali venduto, reso e netto; le righe prodotto sono impaginate per la larghezza della stampante termica.
• In fondo al DDT viene riservato uno spazio per firma e timbro del cliente dopo la stampa.
• La pagina Ordini effettuati consente all’agente di verificare DDT, cliente, importo netto, stato di stampa e stato di sincronizzazione delle consegne già chiuse.

Sincronizzazione e controllo

Quando il dispositivo rileva connettività, invia la coda delle bolle generate offline. Nel giro pianificato il server verifica tenant, assegnazione cliente-agente, numero DDT, prodotto, listino e disponibilità del carico prima di contabilizzare vendita e reso; nella tentata vendita verifica tenant, agente, cliente assegnato, numerazione dedicata e listino, ma non richiede il turno. Se una bolla non è valida, l’app mostra il motivo operativo e continua a sincronizzare quelle sane.

Funzioni amministrative disponibili

• Console piattaforma con riepilogo tenant, contatti, stato operativo e volumi essenziali per ciascun panificio.
• Elenco panifici in tabella con azioni dedicate di creazione, modifica ed eliminazione; menu account superiore per profilo e logout.
• Sospensione di un panificio per impedire nuovi accessi ad amministratori e agenti senza eliminarne i dati.
• Eliminazione definitiva di un panificio con rimozione dei relativi account, cataloghi e dati operativi.
• Dashboard con DDT, agente, mezzo, conferma stampa, quantità e valore di venduto e resi, netto e riepilogo contabile per prodotto.
• Cataloghi di clienti, prodotti, furgoni e giri.
• Listino cliente/prodotto con validità temporale.
• Tappe ordinate per ciascun giro.
• Utenti agente con credenziali per app mobile e assegnazione dei clienti servibili.
• Turni del giorno, blocco DDT e carico prodotti sul mezzo.
• Scelta della modalità mobile da parte del panificio tra consegna con turni/carichi, tentata vendita o uso misto.
• Ordini da rendere disponibili al successivo download dell’agente, con quantità ordinata e reso pianificato, modificabili fino alla consegna e poi bloccati perché legati a un DDT contabilizzato.