WMS Agile — Enterprise Warehouse Management

Funzionalità principali

Copertura completa del ciclo di vita del magazzino: dal ricevimento merce alla spedizione, con tracking in tempo reale e analytics avanzati.

Dashboard

KPI real-time, widget configurabili per ruolo, grafici Chart.js, alert live, panoramica operativa

Missioni

Missioni AGV e operatore, assegnazione automatica, priorità, stato real-time, tracking completamento

Magazzino

Zone, corsie, scaffali, bin, mappa SVG interattiva, yard management, struttura multi-facility

Anagrafica Prodotti

Catalogo SKU, categorie, classe ABC, UOM packaging, import CSV, punto riordino ROP/ROQ, searchProducts con debounce

Giacenze & Stock

Stock per bin, lotti FEFO, recordMovement (registrazione movimento stock), inventario ciclico, varianze, slotting ABC

Packaging

Unità di misura, packaging multilivello, pallet, colli, etichettatura, gestione imballi

Ricezione (Inbound)

ASN, receiveOrder (workflow ricevimento con QC pass/fail), put-away automatico, EDI X12/EDIFACT, webhook e-commerce

Spedizioni (Outbound)

newWave (wave planning con selezione ordini), FIFO/FEFO picking, packing, spedizione multicarrier BRT/NCR

TMS

Integrazione corrieri BRT/NCR, tariffe, tracking spedizioni, gestione vettori, label automatiche

Tracking

Tracking pubblico spedizioni, pagina cliente real-time, notifiche stato, link condivisibile

Conformità & NCR

Non-Conformity Report, severity 4 livelli, workflow completo, rettifiche stock, quality hold

Risorse

Gestione operatori, turni, badge, dispositivi, labour management, produttività per operatore

Report & Analisi

KPI operativi, analisi ABC, forecast ROP, dashboard OEE, SLA compliance, export CSV/PDF, i18n 16 lingue

4PL / Billing

5 facility, 3 tenant indipendenti, SLA tracking, OEE equipment, billing cycle automatico

Calendario

Disponibilità risorse, festività, pianificazione turni, token prenotazione, vista settimanale

Simulatore

Scenario enterprise 60 SKU, race condition detection, SimRecorder event-driven, AI analysis

Utenti

Gestione utenti, ruoli (admin/supervisor/operator), permessi, multi-tenant, sessioni JWT

Notifiche

Alert real-time, severity 4 livelli, notifiche in-app, Glossario WMS integrato nell'help

AI / RAG

Claude Sonnet integrato, 20+ tool specializzati WMS, SSE streaming, knowledge base RAG, analisi inventario

Clienti

Anagrafica clienti con tipo (GDO, HORECA, Pharma, Hospital), SLA, priorita, corriere default, contatti

Fornitori

Anagrafica fornitori con lead time, affidabilita, associazione SKU, integrazione inbound e forecast

Corrieri

Anagrafica corrieri con tariffe (base + €/kg), SLA, certificazioni GDP e Cold Chain, tracking URL

Vincoli Stoccaggio

Restrizioni prodotto-locazione, SKU dedicato per bin, temperature zone, FIFO/FEFO, regole putaway

Architettura

10 microservizi PHP/Slim 4 orchestrati da Nginx gateway, con MySQL 8, Redis e RabbitMQ.

infrastruttura.sh

┌──────────────────────────────────────────────────────────────┐ │ Apache2 host → https://wms.agile.software │ │ ↓ │ │ Nginx gateway :3080 (SPA + API proxy) │ ├────────────┬─────────────┬────────────┬────────────┬──────────┤ │ auth-ms │ inventory │ warehouse │ inbound │ outbound │ │ :3081 │ :3082 │ :3083 │ :3084 │ :3085 │ ├────────────┬─────────────┬────────────┬────────────┬──────────┤ │ report-ms │ ai-ms │ calendar │ wcs-ms │ network │ │ :3086 │ :3087 │ :3088 │ :3089 │ :3090 │ ├────────────┴─────────────┴────────────┴────────────┴──────────┤ │ MySQL:3326 │ Redis:6399 │ RabbitMQ:5692 │ └──────────────────────────────────────────────────────────────┘

Microservizi

14 container in produzione. Tutti con health check, JWT auth, multi-tenancy e soft delete.

:3081

auth-ms

Login JWT, utenti, ruoli, tenant

:3082

inventory-ms

Prodotti, stock, lotti FEFO, ubicazioni

:3083

warehouse-ms

Zone, bin, missioni AGV, mappa

:3084

inbound-ms

Ricevimento, QC, put-away, EDI

:3085

outbound-ms

Wave, picking, packing, TMS

:3086

report-ms

KPI, analytics, SLA, OEE, PDF

:3087

ai-ms

Chat Claude, SSE, 20+ tool

:3088

calendar-ms

Disponibilità, festività, token

:3089

wcs-ms

WCS/Robotics bridge, MQTT

:3090

network-ms

Rete Filiera™ Procure-to-Pay

Quick Start

Avvio locale in 4 passi. Per la guida completa vedi docs-admin.html.

1

Clone & configura

bash

git clone https://git.certisource.it/AdminGit2026/wms-agile.git
for svc in auth inventory warehouse inbound outbound report ai calendar wcs network; do
    cp services/${svc}-ms/.env services/${svc}-ms/.env.production
done
# ⚠ Inserire ANTHROPIC_API_KEY in services/ai-ms/.env.production

2

Avvia i container Docker

bash

cd infrastructure
COMPOSE_PROJECT_NAME=wms-agile docker compose -f docker-compose.yml \
    -f docker-compose.production.yml up -d --build

3

Prima installazione

bash

./infrastructure/first-install.sh http://localhost:3080 \
    "La Mia Azienda" admin@mycompany.it MyPass2026!

4

Accedi e verifica

bash

# Verifica health check tutti i servizi (auth, inventory, warehouse, inbound, outbound, report, ai, calendar, wcs, network)
for port in 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090; do
    echo "Porta $port: $(curl -sk -o /dev/null -w '%{http_code}' http://127.0.0.1:$port/health)"
done

Test Infrastructure

5 livelli di test + stress test con race condition detection. Master script: test-master.sh

Livello	Script	Cosa testa	Durata	Stato
L1 Smoke	`test-smoke.sh`	Health check tutti i servizi	~10s	✅
L2 E2E	`test-e2e.sh`	Flussi end-to-end multi-servizio	~30s	✅
L3 PHPUnit	`test-phpunit.sh`	Business logic PHP — 51 test	~20s	✅ 51/51
L4 SimAPIs	`test-simulator-apis.sh`	API simulatore 4PL, SLA, OEE	~25s	✅
L5 Playwright	`test-ui.sh`	UI browser Chrome — 19 test	~45s	✅ 19/19
Stress	`test-stress.sh`	Race conditions 10× concurrent	~2min	✅ 8/9