📦 Smart Inventory API

Un sistema intelligente per la gestione del magazzino che va oltre il semplice CRUD. Il sistema monitora le giacenze in tempo reale e segnala automaticamente i prodotti "Sottoscorta" (Low Stock Alert).

🚀 Obiettivo del Progetto

Dimostrare la gestione di Logica di Business lato Backend, uscendo dallo schema classico di inserimento/lettura dati. Il sistema deve prendere decisioni autonome (es. generare allarmi) basandosi sui dati di input.

🛠️ Tecnologie Utilizzate

• Java 17
• Spring Boot 3 (Backend & REST API)
• Spring Data JPA (Persistenza Dati)
• PostgreSQL (Database tramite Docker)
• Docker Compose (Containerizzazione)
• Swagger/OpenAPI (Documentazione automatica API)

⚙️ Funzionalità Chiave

1. Gestione Prodotti: Inserimento, Modifica, Cancellazione.
2. Scarico Magazzino (Logica Business):
   • API specifica per decrementare la quantità (/api/products/{id}/sell).
   • Controllo automatico della disponibilità (non puoi vendere se quantità < richiesta).
3. Low Stock Alert:
   • Il sistema verifica se la quantità scende sotto la sogliaDiAllarme.
   • Restituisce uno status speciale nel JSON di risposta.

🐳 Avvio Rapido

1. Avvia il database:

   docker-compose up -d

2. Avvia l'applicazione Spring Boot.
3. Consulta la documentazione API su: http://localhost:8080/swagger-ui/index.html

🧪 Come testare le API (Postman)

Nel repository è presente il file api-docs.json.

1. Scarica il file api-docs.json.
2. Apri Postman.
3. Clicca su Import (in alto a sinistra).
4. Trascina il file all'interno.
5. Ora hai una "Collection" pronta con tutte le chiamate (Scarico merce, Allarmi, ecc.) già configurate.