HACCP Trace

01  Introduzione

HACCP Trace è un'applicazione desktop per la gestione della tracciabilità alimentare e dell'igiene secondo i principi HACCP. Tutti i dati vengono salvati in un database locale (SQLite) sul dispositivo; nulla viene trasmesso all'esterno, ad eccezione di quanto necessario per l'attivazione della licenza.

Come funziona in sintesi

Il cuore del sistema sono i lotti:

1. registri le materie prime in arrivo dai fornitori (lotti in ingresso, con controlli all'accettazione);
2. le conservi nelle unità di conservazione (frigoriferi, celle, ecc.);
3. le trasformi attraverso le ricette in alimenti o semilavorati interni (produzione);
4. le vendi ai clienti;
5. in ogni momento puoi tracciare un lotto in avanti (dove è finito) e rintracciarlo all'indietro (da dove viene).

Il sistema affianca inoltre i registri richiesti dalla normativa HACCP: temperatura, manutenzioni, sanificazioni, controlli all'ingresso, non conformità e richiami.

02  Primo avvio, licenza e login

Installazione e prima apertura

1. Avvia l'applicazione seguendo le istruzioni di installazione della tua piattaforma (Windows/macOS/Linux).
2. Alla prima apertura compare il testo delle Condizioni di licenza.
3. Scegli ACCETTO per proseguire verso il login oppure NON ACCETTO per uscire dall'applicazione.

Login

1. Inserisci il nome utente (al primo avvio è admin).
2. Premi Invio per passare al campo password.
3. Inserisci la password (al primo avvio è admin) e premi Invio oppure fai clic su LOGIN.

03  Interfaccia e navigazione

La finestra principale

• Barra superiore: titolo della pagina, pulsante del tema (☀️/🌙, scuro/chiaro, la scelta viene ricordata) e icona utente (menu con nome, ruolo, ultimo accesso e pulsanti EDIT/EXIT).
• Menu laterale: icone delle aree funzionali; posa il mouse su un'icona per vedere il nome completo.
• Area contenuti: la pagina selezionata, organizzata in schede (tabs).

Le voci di menu visibili dipendono dal settore aziendale scelto in CONFIGURAZIONI (Gelateria/Pasticceria, Panificio/Forno, Ristorazione/Gastronomia, Altro): ad esempio il Registro Temperature è proposto per i settori alimentari e la pagina MENÙ per la ristorazione/gastronomia.

Convenzioni ricorrenti

• Pulsante SALVA (verde): salva il modulo; prima di ogni salvataggio, modifica o eliminazione il programma chiede sempre conferma.
• Pulsanti ANNULLA (contorno): azzerano il modulo; compaiono quando sei in modalità modifica.
• Tabella di elenco: colonna con cestino (elimina, con conferma) e matita (modifica).
• PRINT: stampa la tabella corrente dal browser (Ctrl+P).
• I messaggi di esito (verde = ok, rosso = errore, arancio = avviso) compaiono nell'angolo in alto a destra.
• I campi contrassegnati da * sono obbligatori.

04  Dashboard

La pagina iniziale (che si apre al login) è la DASHBOARD, con un saluto personalizzato e la data odierna.

Azioni rapide

Sei pulsanti aprono direttamente la pagina e la scheda giusta:

Avvisi "da fare oggi"

Il banner mostra le attività da completare (lotti da gestire, scadenze imminenti…). Un clic su un avviso porta alla pagina/scheda di competenza. Se non c'è nulla di urgente compare il messaggio "Nessuna attività urgente — tutto in regola ✓".

Indicatori (KPI) e grafici

• KPI: lotti in giacenza, giacenza totale (unità), consegne del mese, vendite del mese, produzioni del mese, lotti da gestire.
• Grafici: vendite per mese, consegne in ingresso per mese, produzioni per mese, magazzino per categoria, compliance temperature (letture nel range / fuori range).

05  Fornitori (AZIENDE)

La pagina FORNITORI gestisce le anagrafiche delle aziende da cui acquisti materie prime. Due schede: NUOVA AZIENDA e ELENCO AZIENDE.

Registrare un fornitore

1. Vai su NUOVA AZIENDA.
2. Scegli il tipo: Fornitore / Produttore / Corriere.
3. Compila almeno i campi obbligatori: Partita IVA e Denominazione.
4. Inserisci gli altri dati (indirizzo, CAP solo numeri, città, provincia, nazione, email, PEC, telefono, note).
5. Premi SALVA e conferma la richiesta.

Elenco, modifica ed eliminazione

• Nella tabella, il cestino elimina (con conferma). L'eliminazione è bloccata se hai acquistato lotti da quel fornitore: cancella prima i lotti.
• La matita carica l'azienda nel modulo NUOVA AZIENDA; correggi e premi SALVA.
• Usa CERCA NELLA TABELLA per filtrare l'elenco.

Importazione ed esportazione

1. Premi IMPORTA DA JSON o IMPORTA DA CSV e scegli il file.
2. Nella schermata "MAPPA I CAMPI PRIMA DI IMPORTARE" associa le colonne del file ai campi HACCP.
3. Devi mappare obbligatoriamente Partita IVA (vat_number) e Denominazione (legal_name).
4. Premi Conferma e Importa e leggi i RISULTATI IMPORTAZIONE.

Dalla scheda ELENCO AZIENDE puoi esportare l'elenco in JSON o CSV (icone in alto) e stamparlo con PRINT.

06  Clienti

La pagina CLIENTI segue la stessa logica dei fornitori: scheda NUOVO CLIENTE ed ELENCO CLIENTI.

1. Compila Partita IVA e Denominazione (obbligatorie).
2. Inserisci gli altri dati e premi SALVA.

• Eliminazione: bloccata se al cliente hai venduto almeno un prodotto; elimina prima le vendite relative.
• Anche qui sono disponibili import JSON/CSV (con mappatura), export, stampa e ricerca.

07  Reparti, attrezzature e conservazione

La pagina REPARTI, ATTREZZATURE E CONSERVAZIONE (icona magazzino) definisce la struttura fisica dell'azienda. Otto schede:

Reparti

Crea i reparti dell'attività (es. laboratorio, cucina, banco vendita): occorrono un codice e una denominazione.

Attrezzature

Registra ogni attrezzatura: codice, denominazione, tipo (Forno, Impastatrice, Affettatrice, Macinatore, Cottore, Friggitrice, Confezionatrice, Bilancia, Altro), reparto di appartenenza, marca, modello, numero di serie, ubicazione, data di acquisto e giorni di intervallo per la manutenzione periodica.

Tipologie di conservazione (STORAGE TYPES)

Definisci le tipologie ambientali (es. refrigerato, congelato, ambiente) con un nome. Servono per classificare le unità di conservazione.

Unità di conservazione

Registra i dispositivi reali (frigoriferi, celle, abbattitori…): identificatore e denominazione, posizione, almeno una tipologia, e le temperature minima/massima di esercizio. Queste unità vengono poi richiamate da stoccaggio, produzione e registro temperature.

08  Manutenzione

Piani di manutenzione (scheda MANUTENZIONE)

1. In Riferito a scegli Attrezzatura o Conservazione.
2. Seleziona l'elemento (l'elenco si adegua alla scelta precedente).
3. Scegli il tipo (Preventiva, Correttiva, Taratura, Verifica, Straordinaria).
4. Indica l'intervallo in giorni e il responsabile.
5. Premi AGGIUNGI (diventa AGGIORNA in modifica).

La tabella mostra riferimento, tipo, intervallo, responsabile, note e lo stato ATTIVO.

Log manutenzioni

Registra ogni intervento effettivamente eseguito: riferimento (attrezzatura o unità di conservazione), tipo, eseguita da, data di esecuzione, costo (€), descrizione (obbligatoria), ricambi sostituiti e note. Questo è il registro che documenta la manutenzione per la verifica HACCP.

09  Sanificazione

Piani di sanificazione (scheda SANIFICAZIONI)

1. Dai un nome al piano (es. "Sanificazione giornaliera laboratorio").
2. In Riferito a scegli Attrezzatura, Conservazione o Area.
3. Scegli il tipo (Giornaliera, Settimanale, Mensile, Pulizia profonda, Cambio turno, Straordinaria).
4. Indica intervallo in giorni e responsabile.
5. Premi AGGIUNGI.

Log sanificazioni (con esito e non conformità)

1. In LOG SANIFICAZIONI scegli il piano (se presente) e il riferimento.
2. Indica eseguita da, data di esecuzione, prodotti usati, note e la prossima scadenza.
3. Nel blocco problemi, premi + AGGIUNGI PROBLEMA per ogni non conformità riscontrata: Tipo (obbligatorio), Descrizione del problema (obbligatoria), Azione correttiva, spunta Risolto quando la chiudi.
4. Completa la verifica: "Verificata da", "Data verifica" ed Esito (Conforme / Non conforme).
5. Premi SALVA.

Nell'elenco, la colonna VERIFICA mostra un badge Conforme / Non conforme / Da verificare e la colonna PROBLEMI indica ad esempio "2 (1 aperti)": un clic sulla cella apre il Dettaglio sanificazione con i problemi e le azioni correttive.

10  Lotti e alimenti in ingresso

La pagina INGREDIENTI/LOTTI IN INGRESSO (icona freccia in giù) è il cuore operativo del magazzino in entrata.

Registrare una nuova consegna (DDT)

Scheda NUOVA CONSEGNA:

1. Data e operatore: il protocollo è generato in automatico (P + data/ora), la data di accettazione e l'operatore sono precompilati.
2. Documento di trasporto: seleziona Corriere e Fornitore dall'elenco, inserisci data e numero del DDT.
3. Lotti e alimenti nel DDT: seleziona il Produttore e compila numero lotto, data di produzione, temperature rilevata/previste, codice a barre (o spunta "NON dotato di codice a barre": il sistema genera un codice automatico), scadenza, best before, denominazione alimento, unità di misura, quantità, paese di origine e allergeni.
4. Premi AGGIUNGI LOTTO/ALIMENTO: la riga compare nella tabella della consegna. Puoi ripetere per più lotti.

Esito dei controlli all'ingresso

Per ogni alimento compare un blocco "CONTROLLO ALIMENTO '…'":

• Q.tà ricevuta e Q.tà accettata sono calcolate (accettata = ricevuta − non conforme).
• Indica la Q.tà controllata e la Q.tà non conforme.
• Se la quantità non conforme è maggiore di zero, devi indicare categoria problema, tipo di problema e le motivazioni.

Se tutta la merce risulta non conforme, il sistema propone RIFIUTA LA CONSEGNA: la consegna non crea giacenze e compare in LOTTI RIFIUTATI. Altrimenti premi SALVA per registrare consegna, lotti e controlli.

Elenco consegne

La scheda ELENCO CONSEGNE mostra tutti i carichi, con ricerca libera, stampa, modifica (matita → la consegna viene ricaricata in NUOVA CONSEGNA) ed eliminazione (cestino: cancella il carico con i relativi controlli e DDT). Le righe con accettata ≠ ricevuta sono evidenziate in ambra.

Bloccare/ritirare/sospendere un lotto del fornitore

Quando un produttore/fornitore comunica che un suo lotto è avariato, puoi bloccarlo direttamente dall'elenco consegne:

1. In ogni riga dell'elenco trova l'icona di azione lotto:
   • lotto attivo → icona triangolo (sospendi/ritira/blocca);
   • lotto non attivo → icona freccia circolare (riattiva).
2. Se il lotto è attivo, nella modale scegli la conseguenza (Sospendi / Ritira / Blocca), inserisci motivo (obbligatorio), note e Autorità notificate.
3. Se scegli RITIRA compare un avviso chiaro e irreversibile: la giacenza del lotto esterno e di tutti i lotti interni collegati verrà azzerata (movimento waste) e tali lotti non potranno più essere riattivati.
4. Conferma: il lotto cambia stato e non è più utilizzabile nella produzione interna (non compare più tra gli ingredienti disponibili).

Per riattivare un lotto sospeso o bloccato usa l'icona freccia circolare sulla stessa riga (inserendo il motivo): il lotto torna attivo e vengono ripristinati anche i lotti interni collegati che erano sospesi/bloccati. Per i lotti ritirati non compare alcuna icona di riattivazione: non sono più recuperabili.

Lettura del codice a barre con la webcam

Nel campo Codice a barre alimento della nuova consegna è disponibile l'icona fotocamera: consente di scansionare il codice a barre con la webcam del dispositivo invece di digitarlo a mano.

1. Premi l'icona fotocamera accanto al campo codice a barre.
2. Se richiesto, consenti l'accesso alla videocamera.
3. Inquadra il codice a barre (EAN/UPC) tenendolo fermo: appena viene letto, il valore compare automaticamente nel campo.
4. Chiudi la finestra di scansione: la lettura è già stata inserita.

Lotti rifiutati

Elenco delle consegne rifiutate con ricerca, stampa ed eliminazione (cancellazione fisica del record).

11  Controlli all'ingresso

La scheda CONTROLLI raccoglie i controlli eseguiti sulle consegne e consente di correggerne l'esito e di stamparne il registro.

Registro stampabile e filtrabile

• Filtri: dal / al (date), esito (Tutti, Solo conformi, Solo non conformi) e ricerca libera.
• Stampabile: il pulsante PRINT genera un solo foglio per ogni controllo, con una colonna per alimento/lotto (quantità ricevuta, controllata, accettata, non conforme, esito, note).

Modificare l'esito di un controllo

1. Nella scheda CONTROLLI, seleziona il controllo da correggere.
2. Modifica quantità controllata, non conforme e le annotazioni.
3. Se la non conformità è maggiore di zero, spunta almeno una delle motivazioni proposte.
4. Premi SALVA.

Ogni controllo è mostrato come scheda con badge esito: Accettato / Parzialmente accettato / Scartato.

12  Stoccaggio e magazzino

STOCCAGGIO — allocare i lotti nelle unità di conservazione

1. Nella scheda STOCCAGGIO individua la riga dell'alimento/lotto e premi la matita.
2. Nel pannello "ALLOCAZIONE DEL LOTTO n. …" è indicata la quantità ricevuta e quella già allocata.
3. Scegli la Storage Unit e la quantità da allocare (non superiore al residuo), quindi AGGIUNGI.
4. Puoi distribuire il lotto su più unità (una riga per unità). Premi SALVA.

La tabella mostra per ogni gruppo alimento/fornitore/lotto la barra % STOCCAGGIO (quota allocata rispetto al ricevuto).

MAGAZZINO — movimenti delle giacenze

• Ricerca libera e filtri per produttore, fornitore e intervallo di date.
• Per ogni alimento: quantità entrata (Qt. IN), uscita (Qt. OUT) e disponibile (Qt. Disp.).
• Il pulsante info apre il dettaglio dei movimenti per lotto (fornitore, lotto, data, tipo, quantità con segno + verde/− rosso). Il filtro date applicato si riflette sul dettaglio.

Nuovo ingrediente in / elenco ingredienti

La scheda INGREDIENTE IN crea la scheda dell'alimento "esterno" che poi usi nelle consegne: codice a barre (o generazione automatica), produttore, denominazione, unità di misura, origine e allergeni. ELENCO INGREDIENTI consente ricerca, stampa, esportazione JSON/CSV, modifica ed eliminazione.

13  Registro temperature

La pagina REGISTRO TEMPERATURE tiene il registro delle temperature rilevate e gestisce le anomalie. Quattro schede.

Nuova registrazione

1. Scegli il dispositivo (frigorifero, cella…) dall'elenco.
2. Inserisci la temperatura rilevata (la data/ora e l'operatore sono precompilati).
3. Premi SALVA.

Le temperature minime e massime del dispositivo, derivate dalla scheda dell'unità di conservazione, sono mostrate nell'elenco.

Nuova anomalia e azioni correttive

1. In NUOVA ANOMALIA scegli il dispositivo (min/max si compilano da soli) e inserisci la temperatura rilevata fuori range.
2. Scegli l'azione correttiva: "Trasferisci o elimina gli alimenti" oppure "Altro…".
3. Se trasferisci, premi TRASFERISCI O ELIMINA GLI ALIMENTI: compare la tabella degli alimenti presenti nel dispositivo. Per ogni alimento: cestino = elimina/rifiuta; freccia = trasferisci in un'altra unità (quantità da spostare + destinazione).
4. Puoi anche usare TRASFERISCI TUTTO IN ALTRA UNITÀ.
5. Premi SALVA.

La scheda ELENCO ANOMALIE mostra lo stato APERTA/RISOLTA; il pulsante info apre il Dettaglio anomalia con gli alimenti coinvolti e le azioni eseguite, e offre la stampa dedicata. L'icona matita non è al momento disponibile per gli incidenti; l'eliminazione è invece permessa: il sistema ripristina le giacenze alla situazione precedente l'anomalia.

14  Produzione interna (ALIMENTI INTERNI)

La pagina PRODUZIONE INTERNA gestisce ricette, produzione e controllo qualità dei prodotti realizzati in casa.

Creare una ricetta

1. In NUOVA RICETTA inserisci nome, unità di misura, shelf-life (giorni), temperature di conservazione e descrizione. L'identificativo (R + data/ora) è automatico.
2. Nella tabella degli ingredienti disponibili seleziona un ingrediente (gli scaduti non sono selezionabili), indica la quantità (non superiore alla disponibilità in magazzino) e premi AGGIUNGI. Ripeti per tutti gli ingredienti.
3. Gli allergeni degli ingredienti vengono aggiunti automaticamente alla ricetta; puoi aggiungerne anche manualmente.
4. Se la tua attività lo richiede, compila i parametri di processo del settore (maturazione/pastorizzazione per gelateria-pasticceria; idratazione, lievitazione, temperatura/forno e tipo cottura per panificio-forno; porzioni, categoria menu e tecnica di cottura per ristorazione-gastronomia).
5. Premi SALVA RICETTA.

Eseguire una produzione

1. In PRODUZIONE scegli il tipo di derrata (alimento o semilavorato — determina il prefisso del lotto generato) e la ricetta.
2. Indica quantità da produrre, data di produzione, data di scadenza e unità di stoccaggio di destinazione.
3. Premi CALCOLA FABBISOGNO: il sistema elenca gli ingredienti necessari, la quantità disponibile e il lotto scelto (automatico FEFO — scade prima, esce prima — oppure scelta manuale).
4. Se la disponibilità è insufficiente il programma lo segnala: completa il magazzino prima di produrre.
5. Premi PRODUCI e conferma: il sistema genera un batch e un lotto interno, aggiornando magazzino e cronologia.

Elenco produzioni

• Icona occhio (dettaglio): apre la modale con i dati del batch e l'elenco degli ingredienti consumati; il pulsante STAMPA permette di stamparla.
• Icona frecce incrociate (movimenti): apre la modale con tutti i movimenti di magazzino del lotto prodotto (carico da produzione, vendite, waste, rettifiche…), con riepilogo di carichi/scarichi/disponibile e origine di ogni movimento.
• Icona etichetta: apre la finestra di stampa etichette per il lotto prodotto (vedi Etichette).
• Icona cestino: elimina la produzione registrata (con conferma).

Controllo qualità interno

1. In CONTROLLO QUALITÀ scegli l'alimento/semilavorato e il lotto da controllare.
2. La quantità accettata è precompilata con la disponibilità: premi AGGIUNGI LOTTO.
3. Modifica quantità controllata e accettata: l'esito è calcolato (Accettato / Parziale / Respinto) e lo scarto è la differenza.
4. Per esiti non accettati seleziona il problema (obbligatorio).
5. Premi SALVA CONTROLLO.

ELENCO CONTR. QLTÀ e MAGAZZINO completano la pagina: il magazzino interno ha filtri per tipo (tutti/alimenti/semilavorati) e disponibilità. Il dettaglio lotto mostra lo stato (Disponibile, Scaduto, Esaurito, Bloccato, Richiamato).

15  Gastronomia

La pagina GASTRONOMIA (voce MENU, proposta per la ristorazione/gastronomia) gestisce menù, prezzi e produzione di cucina.

Menù

1. Scheda MENÙ: crea un nuovo menù con nome e tipo (Carta, Fisso, Degustazione, Stagionale, Evento), validità (dal/al), descrizione e note.
2. Nella sezione PORTATE DEL MENÙ seleziona una portata (una ricetta esistente) e la sua categoria, l'ordine e l'eventuale prezzo porzione, poi + AGGIUNGI.
3. Premi AGGIUNGI per salvare il menù con le portate; da ELENCO puoi vedere il dettaglio, modificare o eliminare.

Portate con costi

• Nella sezione PREZZI INGREDIENTI imposta per ogni ingrediente il prezzo di acquisto (€/unità di misura) e premi SALVA.
• La tabella PORTATE mostra per ciascuna: costo piatto (somma degli ingredienti), costo per porzione, prezzo di vendita, margine (prezzo − costo/porzione). I margini negativi sono mostrati in rosso.
• + NUOVA PORTATA apre la creazione ricetta della Produzione Interna.

Produzione di cucina

1. Scheda PRODUZIONE: aggiungi più portate al piano di produzione (portata, tipo alimento/semilavorato, quantità, scadenza).
2. Premi PRODUCI TUTTE: ogni portata genera il proprio lotto.
3. La cronologia produzioni e le scorte (con scadenza FEFO) si aggiornano automaticamente.

16  Imballaggi GS1-128

La pagina IMBALLAGGI genera i codici a barre GS1-128 per gli imballaggi logistici destinati alla vendita o al trasporto.

Tipi di imballaggio

• OMOGENEO: uno o più lotti dello stesso alimento. Il GTIN del prodotto viene impostato automaticamente; scegli il lotto (le date si compilano da sole), l' indicatore (6, 12, 24, 48, 60, 100 unità o "Altro"), la quantità e gli elementi da includere nel codice (AI 02 GTIN contenuto, AI 37 quantità, AI 10 lotto, AI 11 produzione, AI 17 scadenza).
• MISTO: due o più alimenti diversi nello stesso imballaggio; il sistema genera un GTIN-13 dedicato.
• PESO VARIABILE: alimento con numero pezzi e peso netto (esattamente 6 cifre, es. 012500 = 12,5 kg); genera un identificativo SSCC progressivo (indicatore 9).

1. Compila i campi della scheda scelta e premi AGGIUNGI (aggiunge alimento/lotto alla tabella).
2. Premi Genera GS1-128: compare l'anteprima del codice a barre (SVG).
3. Stampa GS1-128 apre il codice in una finestra di stampa; SALVA GS1-128 lo archivia.

La scheda ELENCO GS1-128 IMBALLAGGI consente ricerca, ristampa (icona codice) ed eliminazione. Il salvataggio è bloccato se esiste già un imballaggio con stesso alimento, quantità e lotto.

17  Vendite

La pagina VENDITE registra le vendite dei prodotti (solo la produzione interna classificata come vendibile).

Nuova vendita

1. Scegli il canale di vendita (es. banco, laboratorio, punto vendita).
2. Inserisci la data del documento e l'eventuale numero documento.
3. Seleziona il cliente dall'elenco (scelta obbligatoria, non testo libero).
4. Scegli l'alimento (il codice a barre si compila da solo), quindi il lotto e la quantità (la disponibilità è mostrata e non puoi superarla).
5. Premi AGGIUNGI per aggiungere la riga, ripeti quante volte serve e premi SALVA.

La scheda ELENCO VENDITE è leggibile con ricerca libera (per nome, barcode o lotto) e stampabile; la modifica/eliminazione di una vendita non è al momento disponibile.

18  Etichette

Le etichette si stampano per i lotti interni prodotti. La pagina si apre come finestra separata partendo da PRODUZIONE INTERNA → ELENCO PRODUZIONI e premendo l'icona etichetta sulla riga del lotto.

1. La finestra si apre con i dati del lotto già caricati e l'anteprima mostrata (l'anteprima si aggiorna automaticamente a ogni cambio di formato o copie).
2. Scegli il formato (etichetta 60×40 predefinita; disponibili anche 50×30, 100×100, 100×150 a seconda dei template configurati).
3. Imposta il numero di copie (da 1 a 50).
4. Premi STAMPA per inviare alla stampante.

L'etichetta riporta: denominazione azienda, nome alimento, allergeni, conservazione (temp. min÷max °C o "Conservare refrigerato"), LOTTO, PREP (data di produzione), SCAD (scadenza).

19  Richiami e ritiri

La pagina RICHIAMI E RITIRI gestisce il ritiro dal mercato di lotti con problemi, con la ricostruzione automatica di tutti i lotti coinvolti e dei clienti da avvisare.

Nuovo richiamo

1. Scegli il controllo qualità con esito negativo (sono elencati solo i QC non accettati).
2. Scegli il lotto colpito tra quelli del QC.
3. Definisci la conseguenza: Sospendi (in attesa esiti), Ritira (ritiro definitivo) o Blocca (non utilizzabile).
4. Inserisci il motivo (obbligatorio), eventuali note e spunta "Autorità notificate" se hai informato le autorità.
5. Premi ANTEPRIMA: il sistema calcola dal lotto radice tutti i discendenti (ricorsivamente) fino ai clienti, mostrando quantità disponibili e vendute.
6. Dopo aver verificato l'anteprima premi CONFERMA RICHIAMO.

Elenco richiami e notifiche ai clienti

• L'icona utenti apre la modale "Clienti da notificare" con email cliccabile (mailto:) e quantità venduta.
• L'eliminazione di un richiamo riattiva i lotti coinvolti, a meno che non siano parte di altri richiami.

Riattivazione

La scheda RIATTIVAZIONE elenca i lotti sospesi o bloccati: premi RIATTIVA, inserisci il motivo e conferma. Il lotto torna disponibile per produzione e vendita e vengono ripristinati anche i lotti interni collegati che erano sospesi/bloccati. Se un richiamo resta senza lotti (perché tutti quelli che lo componevano sono stati riattivati), la sua riga sparisce da ELENCO RICHIAMI.

20  Rintracciabilità

La pagina RINTRACCIABILITÀ risponde alle due domande della normativa (Reg. CE 178/2002): dove è andato? e da dove viene?

TRACCIABILITÀ (percorso in avanti)

1. Scegli il produttore/fornitore.
2. Scegli il lotto da tracciare.
3. Premi TRACCIA: il sistema mostra gli alimenti che hai creato usando quel lotto e, sotto ciascuno, le vendite (cliente, data, documento, quantità).

Azioni sui lotti trovati (lotto fornitore avariato)

Quando un fornitore comunica che un suo lotto è avariato, puoi agire direttamente sui tuoi lotti che lo hanno utilizzato:

1. La tabella dei risultati della tracciabilità ora include una colonna STATO (badge: attivo, sospeso, ritirato, bloccato, scaduto) e una colonna con le caselle di selezione.
2. Spunta le caselle dei lotti da trattare (in testa alla colonna puoi selezionare/deselezionare tutti). I lotti già non-attivi hanno la casella disabilitata.
3. Premi APPLICA AZIONE: nella modale scegli la conseguenza (Sospendi / Ritira / Blocca), inserisci motivo (obbligatorio), eventuali note e spunta Autorità notificate.
4. Premi CONFERMA: i lotti selezionati cambiano stato, vengono registrati nel registro richiami (tipo "fornitore") e — se scegli Ritira — la giacenza viene azzerata e il ritiro è irreversibile.
5. Al termine la tabella si ricarica: i lotti trattati mostrano il nuovo stato e non sono più selezionabili.

RINTRACCIABILITÀ (percorso all'indietro)

1. Scegli il tuo lotto di produzione o semilavorato.
2. Premi RINTRACCIA: il sistema risale agli ingredienti utilizzati e ai lotti e fornitori di origine.

I risultati sono stampabili ("Tracciabilità" e "Rintracciabilità" nel menù di stampa).

21  Documenti e allegati

La pagina DOCUMENTI E ALLEGATI archivia certificati e documenti normativi collegandoli anche a problemi interni.

Categorie documenti

Scheda CATEGORIA DOCUMENTI: codice e denominazione (obbligatori), descrizione e ordine di visualizzazione. Le categorie marcate ATTIVO compaiono nella scelta dei documenti.

Documenti

1. Inserisci titolo e categoria.
2. Premi SFOGLIA… e seleziona il file da allegare (formato libero: PDF, DOCX, immagini, ecc.).
3. Compila eventualmente data di emissione/scadenza, ente emittente e note.
4. Se il documento riguarda un problema interno, spunta "Documento riferito a un problema interno" e scegli il tipo (Non conformità, Lotto, Anomalia temperatura) e il record specifico.
5. Premi SALVA.

Nell'elenco, il percorso del file è cliccabile e apre il documento con il programma di sistema; la colonna FILE mostra OK (presente) o MANCANTE (file non trovato).

22  Configurazioni

La pagina CONFIGURAZIONI (icona sliders) contiene le impostazioni generali. Per gli utenti non amministratori alcune sezioni sono nascoste.

Dati aziendali (solo owner)

Identità dell'azienda: settore (Gelateria/Pasticceria, Panificio/Forno, Ristorazione/Gastronomia, Altro — determina le voci del menu), prefisso GS1 (7 o 9 cifre, necessario per gli imballaggi), Partita IVA e denominazione (obbligatorie) e i dati di contatto.

Utenti (solo owner)

• Ogni utente ha nick (unico), nome, cognome, ruolo, email, telefono e password.
• La password richiede almeno 8 caratteri e va inserita due volte; esiste un solo utente owner (non eliminabile).

Database

• Backup: scegli la cartella di destinazione e premi Esegui il backup. Il programma crea una copia del database con data/ora. Consigliato almeno una volta al mese.
• Ripristino: seleziona un file .db e premi Esegui il ripristino. Avviso: operazione irreversibile, sostituisce il database corrente e l'applicazione si riavvia.

Aggiornamento automatico

La sezione AGGIORNAMENTO verifica e installa le versioni più recenti del software in modo automatico, senza scaricare nulla a mano:

1. Premi VERIFICA AGGIORNAMENTI: il programma contatta il server ufficiale.
2. Se è disponibile una nuova versione, mostra il numero e le note e chiede conferma.
3. Confermando, il file viene scaricato (una barra mostra l'avanzamento) e installato.
4. L'applicazione si riavvia automaticamente per completare l'aggiornamento.

Misure

Unità di misura personalizzate: denominazione, simbolo e tipo (Area, Count, Lunghezza, Temperatura, Tempo, Volume, Peso).

Allergeni

Elenco allergeni con denominazione (obbligatoria), categoria e note; sono usati nelle schede ricetta e nelle etichette.

Problemi (categorie e tipi)

Definisci le categorie (es. "Problemi merce") e i tipi (es. "Danno da freddo") collegati a una categoria. Sono gli stessi elenchi usati nei controlli all'ingresso e nel controllo qualità.

HELP

Contiene una guida in linea essenziale (nozioni, produzione, controlli, imballaggi, vendite, tracciabilità) con pulsante di stampa GUIDA IN LINEA e link al sito haccp.alessandrostella.it. Questo manuale la integra con il dettaglio completo.

Licenza (solo owner)

Mostra lo stato della licenza (valida/errore) e consente di SCARICA LICENZA per attivare o rinnovare la versione PAY; sotto è riportato il testo contrattuale completo.

23  Accesso in rete LAN (multi-dispositivo)

Haccp Trace può essere usato non solo sul PC dove è installato, ma anche da altri dispositivi collegati alla stessa rete locale (altri computer, tablet, smartphone). Rientra nella versione PAY RETE LAN: i dati restano sempre sul tuo PC, ma l'interfaccia è raggiungibile anche dagli altri device dell'azienda.

Requisiti

• PC con Haccp Trace in esecuzione e collegato alla rete LAN.
• Licenza PAY RETE LAN per abilitare l'accesso multi-dispositivo.
• Gli altri dispositivi devono trovarsi sulla stessa rete (stesso Wi-Fi/switch).

Come attivare l'accesso da altri dispositivi

1. Avvia Haccp Trace sul PC principale.
2. Attiva il server LAN dalla pagina CONFIGURAZIONI → Accesso in rete (o dalla voce dedicata), scegliendo la porta (default 8787).
3. Appunta l'indirizzo mostrato dal programma, nella forma https://192.168.x.x:8787 (oppure il nome host del PC).
4. Sul PC o sul telefono da usare, apri il browser e digita quell'indirizzo.
5. Alla prima connessione il browser avvisa che il certificato è autofirmato (non rilasciato da un'autorità): procedi per continuare. È previsto e sicuro: è il tuo stesso PC.
6. Accedi con il token personale associato al tuo utente (creato in CONFIGURAZIONI → Utenti / Token), non con la password del desktop.

Cosa puoi fare da un altro dispositivo

Dalla web app LAN puoi svolgere le operazioni quotidiane come sui menù desktop: registrare ingressi, fare controlli, registrare temperature, gestire vendite, richiami, documenti, tracciabilità. Le schermate rispettano i ruoli: il sistema ricava l'operatore direttamente dal token, mai da parametri del client.

Privacy e sicurezza

• L'accesso è protetto da token (non da password riutilizzate) e ogni azione resta associata all'utente che l'ha compiuta.
• I dati non lasciano mai la rete locale: nessun cloud, nessun server terzo.
• Puoi spegnere il server LAN quando non ti serve: il programma continua a funzionare in locale sul PC.

Appendici

In questa sezione: guida rapida, note HACCP e normativa, problemi frequenti e glossario.

24  Guida rapida ai flussi

25  Note HACCP e normativa

HACCP Trace è costruito attorno ai principi del "pacchetto igiene" europeo. Di seguito i riferimenti principali (finalità informative, non sostitutivi della consulenza legale).

Registri che l'app ti aiuta a tenere

• Registro fornitori e schede degli alimenti in ingresso;
• Registro controlli all'ingresso (con non conformità e motivazioni);
• Registro temperature e degli incidenti con azioni correttive;
• Registro manutenzioni e registro sanificazioni (piani, log, esiti, problemi e azioni correttive);
• Registro produzioni e controllo qualità interno;
• Registro vendite e richiami/ritiri con notifica ai clienti;
• Rintracciabilità completa dei lotti, con report stampabili.

26  Problemi comuni (FAQ)

27  Glossario