Sistema SmartBag

Introduzione

Il sistema SmartBag rappresenta una soluzione integrata per la gestione dei contenitori intelligenti nel contesto della conservazione del vino. Questa documentazione descrive i flussi operativi del sistema e le interazioni tra i suoi componenti.

Architettura del Sistema

Flusso Completo di Produzione

Il seguente diagramma illustra il ciclo completo di vita di una SmartBag, dall'importazione dei TAG fino alla gestione del prodotto finale:

Processo di Importazione TAG

Il processo di acquisizione e gestione dei TAG segue questo flusso:

1. Albi riceve via emil il file csv da fornitore dei tag
2. Operatore albicchiere verifica che il formato del csv sia corretto (prima colonna seriale, seconda colonna batch)
3. Import in database: Operatore albicchiere carica file csv su backoffice (TODO: link /nfc/tag add)

Ciclo di Produzione SmartBag

La creazione di una SmartBag segue questi passaggi:

API di Sistema

Gestione TAG

L'interfaccia per la gestione dei TAG prevede i seguenti endpoint principali:

Importazione TAG

POST /production_tags/upload
Content-Type: application/json
 
{
    "batchNumber": "BATCH2024-001",
    "model": "NFC-V2",
    "tags": ["SERIAL001", "SERIAL002"]
}

Recupero TAG Disponibili

GET /production_tags?status=inactive&page=1&limit=50
Accept: application/json

Attivazione TAG

POST /production_tags/report_activated
Content-Type: application/json
 
{
    "tags": ["SERIAL001"],
    "model": "SMARTBAG-2024",
    "batchNumber": "PROD-2024-001"
}

Gestione Produzione

Il sistema di produzione prevede diversi stati che devono essere gestiti attraverso le API:

Segnalazione TAG Cancellati

POST /production_tags/report_canceled
Content-Type: application/json
 
{
    "tags": ["SERIAL001"],
    "reason": "PRODUCTION_DEFECT"
}

Esportazione Dati Produzione

GET /production_tags/download-csv?status=active
Accept: text/csv

Processi di Controllo Qualità

Il sistema implementa diversi livelli di controllo durante la produzione:

Monitoraggio in Tempo Reale

Durante la produzione, il sistema monitora costantemente:

Stati del Sistema

Stati TAG

Stati SmartBag

Strutture Dati

TAG

{
    "serial": "string",
    "status": "inactive|active|canceled",
    "model": "string",
    "batchNumber": "string",
    "createdAt": "datetime",
    "updatedAt": "datetime"
}

SmartBag

{
    "serial": "string",
    "type": "EMPTY|BOTTLED",
    "expiryDate": "datetime",
    "batchNumber": "string",
    "createdAt": "datetime",
    "updatedAt": "datetime"
}

Procedure di Sicurezza

Verifiche di Sistema

Gestione Errori

Il sistema prevede procedure specifiche per ogni tipo di errore:

Questa documentazione fornisce una base solida per comprendere e implementare il sistema SmartBag, con particolare attenzione ai flussi operativi e alle interazioni tra i componenti. I diagrammi e le specifiche delle API permettono una chiara comprensione delle funzionalità e dei requisiti del sistema.