Documentazione Tecnica

Architettura del Sistema

Frontend: HTML, CSS, JavaScript
Backend: PHP 8.0+ con PDO
Database: MariaDB / MySQL
Worker: Script CLI PHP per processare comande
Stampa: Integrazione CUPS via comando lp

Struttura del Database

Tabelle Principali

CATEGORIE

Categorie di prodotti (Pizze, Bevande, ecc.)

ID_Categoria (INT, PRIMARY KEY)
Nome_Categoria (VARCHAR)

REPARTI

Reparti di produzione (Cucina, Bar, Pizzeria)

ID_Reparto (INT, PRIMARY KEY)
Nome_Reparto (VARCHAR)
Nome_Stampante_LAN (VARCHAR) - Coda CUPS

PRODOTTI

Catalogo prodotti

ID_Prodotto (INT, PRIMARY KEY)
Descrizione (VARCHAR)
Prezzo (DECIMAL)
Codice_Prodotto (VARCHAR, UNIQUE)
ID_Categoria (FK → CATEGORIE)
ID_Reparto (FK → REPARTI)

TAVOLI

Tavoli e opzioni servizio

ID_Tavolo (INT, PRIMARY KEY)
Nome_Tavolo (VARCHAR)
Tipo_Servizio (ENUM: 'tavolo', 'asporto')

ORDINI

Ordini effettuati

ID_Ordine (INT, PRIMARY KEY)
ID_Tavolo (FK → TAVOLI)
Nome_Cliente (VARCHAR)
Numero_Coperti (INT)
Totale_Ordine (DECIMAL)
Staff (BOOLEAN) - Flag ordine staff
Sconto (DECIMAL) - Importo sconto
Data_Ora (DATETIME)

DETTAGLI_ORDINE

Righe ordine (prodotti ordinati)

ID_Dettaglio (INT, PRIMARY KEY)
ID_Ordine (FK → ORDINI)
ID_Prodotto (FK → PRODOTTI)
Quantita (INT)
Prezzo_Bloccato (DECIMAL)

COMANDE

Comande da stampare per i reparti

ID_Comanda (INT, PRIMARY KEY)
ID_Ordine (FK → ORDINI)
Nome_Stampante_LAN (VARCHAR)
Testo_Comanda (TEXT)
Stato (ENUM: 'pending', 'sent', 'error')
Tentativi (INT)
Data_Creazione (DATETIME)
Data_Invio (DATETIME, NULL)

Flusso Ordine

Utente crea ordine tramite public/cassa.php
Frontend chiama api/salva_ordine.php con dati ordine
Backend:
- Salva record in ORDINI
- Salva righe in DETTAGLI_ORDINE
- Crea comande per reparto in COMANDE
- Tenta stampa immediata (se lp disponibile)
Worker CLI (scripts/worker_process_comande.php):
- Eseguito periodicamente (cron/systemd)
- Trova comande con stato 'pending' o 'error'
- Tenta stampa tramite lp -d queue file
- Aggiorna stato a 'sent' o 'error'

Organizzazione File

RICEVUTE/
├── api/                  # Endpoint API REST
├── config/               # Configurazione e autenticazione
├── docs/                 # Documentazione
│   └── site/            # Sito documentazione HTML
├── public/              # File web-accessible
│   ├── assets/          # CSS e JavaScript
│   ├── cassa.php        # Creazione ordini
│   ├── report.php       # Report vendite
│   └── admin.php        # Pannello admin
├── scripts/             # Script CLI e worker
├── sql/                 # Schema database
└── src/                 # Classi PHP

Worker Process Comande

Lo script scripts/worker_process_comande.php processa le comande in coda:

Parametri CLI

--limit=N: Numero massimo comande da processare (default: 20)
--max-tries=N: Tentativi massimi per comanda (default: 5)

Stati Comanda

pending: In attesa di stampa
sent: Stampata con successo
error: Errore stampa (verrà ritentata se Tentativi < max)

Esecuzione Periodica

Opzione 1 - Cron (ogni minuto):

* * * * * /usr/bin/php /path/worker_process_comande.php --limit=20

Opzione 2 - Systemd timer (raccomandato):

sudo systemctl enable --now worker_comande.timer

Sicurezza

SQL Injection: Prepared statements con PDO
XSS: Sanificazione input e output escaping
CSRF: Token per azioni critiche
Sessioni: Flag secure, httponly, samesite
Password: Hash con password_hash()
HTTPS: Raccomandato in produzione

Feature Speciali

Ordini Staff

Flag Staff = true in tabella ORDINI:

Totale automaticamente a €0.00
Esclusi da report ricavi
Comande comunque stampate per preparazione

Sconti

Campo Sconto in tabella ORDINI:

Importo sottratto dal totale
Mostrato su ricevuta cliente
Incluso in report ricavi

Coperti

Gestione automatica costo coperto:

Basato su numero coperti e tariffa configurata
Automaticamente 0 per ordini asporto

🛠️ Documentazione Tecnica