Prodotti

La pagina Prodotti gestisce il catalogo degli articoli che il tuo internet cafe o gaming center vende. Include cibo, bevande, snack, accessori e qualsiasi altro bene fisico offerto ai clienti. Ogni prodotto ha un prezzo definito, una categoria, un'aliquota fiscale e un livello di scorta. I prodotti si integrano con il sistema ordini, permettendo ai cassieri di creare ordini, tracciare le vendite e gestire l'inventario.

Campi del Prodotto

Ogni record prodotto contiene le seguenti informazioni:

Campo	Descrizione
`name`	Il nome del prodotto visualizzato nell'interfaccia ordini. Deve essere univoco (senza distinzione maiuscole/minuscole).
`category`	Un'etichetta di testo che raggruppa prodotti correlati (ad esempio "Bevande", "Snack", "Accessori"). Utilizzata per filtraggio e reportistica.
`unit`	L'unita di misura per il tracciamento scorte (ad esempio "pezzo", "kg", "litro", "lattina", "bottiglia").
`barcode`	Un valore di codice a barre opzionale per l'integrazione con scanner. I cassieri possono scansionare il codice a barre di un prodotto per aggiungerlo rapidamente a un ordine.
`sale_price`	Il prezzo di vendita in unita minori di valuta (ad esempio centesimi). L'importo addebitato al cliente per unita.
`vat_rate`	La percentuale IVA (Imposta sul Valore Aggiunto) applicata a questo prodotto (ad esempio 18 per IVA al 18%). Utilizzata per calcolare la componente fiscale di ogni vendita.
`stock`	Il livello di scorta corrente come quantita decimale. Aggiornato automaticamente quando vengono effettuati ordini e quando vengono registrati acquisti di inventario.
`active`	Un interruttore che controlla se il prodotto appare nell'interfaccia ordini. I prodotti inattivi sono nascosti ai cassieri ma conservati nel database per la reportistica storica.
`description`	Una descrizione testuale opzionale per dettagli aggiuntivi sul prodotto.

Attivazione / Disattivazione

I prodotti possono essere alternati tra stati attivo e inattivo:

I prodotti attivi appaiono nell'interfaccia ordini e possono essere aggiunti a nuovi ordini.
I prodotti inattivi sono nascosti dall'interfaccia ordini ma restano nel database. Gli ordini passati che includevano il prodotto mantengono i loro riferimenti cosi i dati storici di vendita vengono conservati.

Questo e utile per articoli stagionali, prodotti dismessi o articoli temporaneamente esauriti che non dovrebbero essere offerti ai clienti.

Tracciamento Scorte

HandyCafe mantiene un conteggio corrente delle scorte per ogni prodotto. Questo valore viene aggiornato automaticamente dal sistema in risposta a:

Vendite: Quando un prodotto viene venduto tramite un ordine, le scorte diminuiscono della quantita ordinata.
Acquisti di inventario: Quando nuove scorte vengono ricevute e registrate nella pagina Inventario, le scorte aumentano di conseguenza.
Rettifiche manuali: I cassieri o gli amministratori possono regolare manualmente il livello di scorta per contabilizzare deperimento, rottura, errori di conteggio o altre discrepanze.

Registro Scorte Prodotto

Ogni variazione del livello di scorta di un prodotto viene registrata nel registro scorte prodotto, creando una traccia di controllo completa:

Motivo	Descrizione
`sale`	Scorte diminuite a causa di un ordine cliente. Collegato al record dell'ordine specifico.
`purchase`	Scorte aumentate a causa di un acquisto di inventario. Collegato alla voce di inventario specifica.
`adjustment`	Scorte rettificate manualmente da un cassiere o amministratore.
`waste`	Scorte diminuite a causa di deperimento, rottura o svalutazione.
`return`	Scorte aumentate a causa di un reso cliente o annullamento ordine.

Ogni voce del registro registra la variazione di quantita (positiva per gli aumenti, negativa per le diminuzioni), il nuovo livello di scorta dopo la variazione, chi ha effettuato la variazione e una nota opzionale che spiega il motivo.

Categorie Prodotto

I prodotti sono raggruppati per categoria utilizzando un campo di testo libero. Le categorie comuni includono:

Bevande (bibite, acqua, bevande energetiche)
Bevande Calde (caffe, te, cioccolata calda)
Snack (patatine, caramelle, barrette di cioccolato)
Cibo (panini, wrap, pasti caldi)
Accessori (cuffie, chiavette USB, tappetini per mouse)

Le categorie sono utilizzate per il filtraggio nell'interfaccia ordini. I cassieri possono passare rapidamente tra le categorie per trovare il prodotto giusto. Le categorie servono anche per il raggruppamento nei report di vendita.

Non esiste un'interfaccia separata di gestione categorie. Le categorie vengono create implicitamente quando assegni un nome di categoria a un prodotto. Per rinominare una categoria, aggiorna il campo categoria su tutti i prodotti che usano il vecchio nome.

Creare un Prodotto

Per aggiungere un nuovo prodotto al catalogo:

Vai alla pagina Prodotti dalla barra laterale.
Clicca il pulsante Aggiungi Prodotto nella barra degli strumenti.
Inserisci il nome (deve essere univoco).
Seleziona o digita una categoria.
Scegli l'unita di misura.
Imposta il prezzo di vendita (l'importo addebitato ai clienti, in unita minori di valuta).
Imposta l'aliquota IVA (come decimale, ad esempio 0,08 per l'8%).
Opzionalmente inserisci un codice a barre per il supporto scanner.
Imposta il livello di scorta iniziale se applicabile.
Clicca Salva.

Modificare un Prodotto

Seleziona un prodotto dall'elenco per aprire la vista dettagli. Puoi aggiornare qualsiasi campo inclusi nome, prezzo, categoria, aliquota IVA, livello scorte e stato attivo. Le modifiche hanno effetto immediato. Se aggiorni il prezzo, il nuovo prezzo si applica a tutti gli ordini futuri.

Gli ordini passati non sono influenzati dalle variazioni di prezzo. Ogni articolo dell'ordine conserva il unit_price al momento della vendita come snapshot.

Integrazione con gli Ordini

Quando un cassiere crea un ordine e aggiunge un prodotto:

Il prezzo di vendita corrente del prodotto e l'aliquota IVA vengono copiati nell'articolo dell'ordine come snapshot.
Il totale riga viene calcolato come prezzo_unitario * quantita.
Quando l'ordine viene completato, il livello di scorta del prodotto viene decrementato della quantita ordinata.
Viene creata una voce nel registro scorte con motivo = 'sale' collegata all'ordine.

Se l'ordine viene successivamente annullato o rimborsato, le scorte possono essere ripristinate tramite una voce di reso nel registro scorte.