Avvio specifiche FlyWMS Core

docs/specs/03_modello_concettuale.md

@@ -0,0 +1,104 @@
+# Modello concettuale iniziale
+
+Il modello deve essere abbastanza generale da non ripetere i limiti del legacy, ma non cosi' astratto da bloccare lo sviluppo.
+
+## Entita' principali
+
+### LogisticUnit
+
+Rappresenta una qualsiasi unita' fisica movimentabile.
+
+Esempi:
+
+- pallet;
+- cassa;
+- cartone;
+- bobina;
+- contenitore;
+- roll;
+- collo;
+- unita' specifica del cliente.
+
+Attributi iniziali:
+
+- codice barcode;
+- tipo unita';
+- stato logico;
+- peso lordo;
+- peso netto;
+- tara;
+- dimensioni;
+- volume;
+- data creazione;
+- origine dati;
+- riferimento ERP.
+
+### LogisticUnitContent
+
+Descrive il contenuto di una unita' logistica.
+
+Serve per gestire:
+
+- una UDC con un solo lotto;
+- una UDC con piu' lotti;
+- una UDC con piu' articoli;
+- quantita' parziali.
+
+### Location
+
+Rappresenta una posizione logica o fisica.
+
+Tipi iniziali:
+
+- magazzino;
+- area;
+- corsia;
+- scaffale;
+- livello;
+- cella;
+- location virtuale.
+
+Le location virtuali sostituiscono i codici convenzionali legacy.
+
+Esempi:
+
+- NON_SHELVED;
+- SHIPPED;
+- RECEIVING;
+- QUALITY_HOLD;
+- DAMAGED;
+- STAGING.
+
+### InventoryMovement
+
+Registra ogni movimento.
+
+Campi concettuali:
+
+- unita' logistica;
+- location sorgente;
+- location destinazione;
+- operatore;
+- timestamp;
+- causale;
+- documento sorgente;
+- origine del movimento;
+- transazione.
+
+### CurrentInventory
+
+Rappresenta la giacenza corrente materializzata.
+
+Puo' essere calcolata dai movimenti oppure mantenuta come tabella aggiornata per performance.
+
+## Stati logici iniziali
+
+- PRODUCED_BY_ERP;
+- RECEIVED;
+- NON_SHELVED;
+- SHELVED;
+- RESERVED_FOR_PICKING;
+- SHIPPED;
+- BLOCKED;
+- UNKNOWN.
+