WMS Agile — Test Strategy & Quality Assurance

Overview & Filosofia

La test infrastructure del WMS Agile è progettata su tre principi fondamentali:

Feedback rapido — L1/L3/L4 in parallelo, risultati in <30s per il ciclo base
Copertura reale — non solo unit test ma flussi end-to-end multi-microservizio
Simulatore come test avanzato — 7 scenari industriali, 365 giorni simulati, race condition reali

Ogni livello è indipendente ma orchestrato da infrastructure/test-master.sh. La pipeline CI Gitea esegue L1→L3→L4→L5 ad ogni push su main.

Piramide dei Test

SIMBOT v3 — Browser-Native (200+ entita, 26 fasi, voce + bug detection)

STRESS — Race Condition & Load (10–50× concurrent)

L7 — Simulator Data Integrity (15+ check, S2–S7)

~3m

L6 — Super Coverage (12 sezioni, 42 check)

~4m

L5 — Playwright UI (41 test, 7 spec, Chrome)

~5m

L4 — Simulator APIs (30+ endpoint, latency)

~3m

L2 — E2E Integration (12 step multi-servizio)

~3m

L3 — PHPUnit Unit (51 test, 137 assert)

~2m

L1 — Smoke Health (14 check, 7 microservizi)

~30s

L1 + L3 + L4 + L6 + L7 in parallelo (FASE 1). L2 sequenziale (FASE 2). L5 ultimo (FASE 3). SimBot & Stress indipendenti.

L1 — Smoke Test FASE 1 parallela

Health Check & API Routing

Verifica che tutti i microservizi siano in piedi e rispondano correttamente

test-smoke.sh ~10s parallela con L3, L4

Health /health su tutti e 7 i microservizi
Login API: POST /api/auth/login → JWT valido
GET /api/products — inventory-ms
GET /api/inbound/orders — inbound-ms
GET /api/outbound/orders — outbound-ms
GET /api/missions — warehouse-ms
Gateway Nginx: static assets + routing SPA
Redis: connessione rate-limiting attiva

Criterio di successo: tutti i servizi rispondono 2xx — se L1 fallisce, la pipeline si ferma.

L2 — E2E Integration FASE 2 sequenziale

Flussi End-to-End Multi-Microservizio

Verifica la coerenza dei dati attraverso il boundary tra servizi

test-e2e.sh ~30s dopo FASE 1

Inbound completo: create → receive → status
Outbound completo: create → confirm → ship
Stock management: inbound movement → level → outbound
Tenant isolation: dati tenant A non visibili a tenant B
inventory-ms ↔ warehouse-ms ↔ inbound-ms
Missioni AGV: create → assign → complete

Criterio di successo: ogni flusso senza errori 5xx, dati coerenti end-to-end tra DB diversi.

L3 — PHPUnit Unit Test FASE 1 parallela

Logica di Business — Service Layer PHP

Unit test dei service layer con mock DB, verifica state machine e race condition

test-phpunit.sh ~20s parallela con L1, L4

File	Servizio	Test	Assert
`OutboundServiceTest.php`	outbound-ms	16	42
`StockServiceTest.php`	inventory-ms	14	37
`InboundServiceTest.php`	inbound-ms	21	58
Totale		51	137

Validazione input (campi obbligatori, tipi, range)
State machine: transizioni lecite e illecite
Sequence generation: unicità order_number + retry
Tenant isolation: tutte le query filtrate per tenant_id
Soft delete: deleted_at filter in tutti i SELECT
Race condition: catch PDOException 23000 → 400

docker exec wms-{svc} vendor/bin/phpunit tests/ --testdox --colors

L4 — Simulator APIs FASE 1 parallela

API del Simulatore WMS 4PL

Testa le API specifiche dello scenario 4PL: facility, tenant, carrier, SLA, OEE, billing

test-simulator-apis.sh ~25s parallela con L1, L3

SimEngine: missioni, zone, dock schedules
Yard management: check-in/out veicoli
Scenario 4PL: 5 facility, 3 tenant, 4 carrier
SLA tracking: compliance %, breach detection
OEE equipment: breakdown → repair → resume
Billing cycle: accumulazione per tenant
Network/EDI: Rete Filiera™ Procure-to-Pay
FEFO violations: alert e gestione lotti scaduti

L5 — Playwright UI Test FASE 3

Test UI nel Browser Chrome Reale

41 test Playwright (7 spec) su interfaccia utente — login, navigazione, form, simulatore, billing, AI

test-ui.sh ~3-8 min dopo L1+L2+L3+L4

Spec	Test	Cosa testa
`auth.spec.js`	5	Login form, validazione, credenziali errate, redirect post-login
`dashboard.spec.js`	6	KPI dashboard, sezioni, JS errors, 401/500 check, logout
`navigation.spec.js`	4	Nav link click, topbar persistence, logout flow
`forms.spec.js`	4	Modal prodotto/ordine, form validation, required fields
`simulator.spec.js`	8	Scenario grid S2-S7, cockpit, speed, API check, no JS errors
`billing.spec.js`	6	Dashboard billing, invoice list, FatturaPA, state transitions
`ai-chat.spec.js`	8	Chat panel, messaggi, KB search, tools, streaming
Totale	41 ✅	7 spec file, tutti in produzione

Setup critico

Browser: /usr/bin/google-chrome (devenv), Playwright Chromium (CI)
Onboarding overlay: dismiss via page.evaluate() dopo ogni login
Navigation SPA: location.hash = 'section' (non link diretti)
Base URL: WMS_BASE_URL=https://wms.agile.software

L6 — Super Coverage FASE 1 parallela

Test Avanzati — 12 Sezioni, Tutti i Microservizi

Copertura completa dei servizi enterprise: billing, AI, calendar, WCS, network, labour, yard, slotting

test-super.sh ~3-5 min parallela con L1, L3, L4, L7

§	Sezione	Servizio	Check
0	Login	auth-ms	JWT token
1	Billing	billing-ms :3091	Fatture, FatturaPA XML, Revolut payment
2	AI	ai-ms :3087	Settings, tools, chat, KB stats, sim-datasets
3	Calendar	calendar-ms :3088	Holidays (16 paesi), settings, tokens
4	WCS	wcs-ms :3089	Status, adapters, robot dispatch
5	Network	network-ms :3090	Partners, PO, confirm, ship, receipt
6	Returns	warehouse-ms	NCR, stock adjustments, rettifiche
7	Multi-tenant	auth-ms	Supervisor login, tenant isolation, null check
8	Error Cases	all	400/422 validation, 401 auth, 404, JWT tampering
9	Labour	warehouse-ms	Shift reports, KPI operatori
10	Yard	warehouse-ms	Status, dock slots, trailer management
11	Slotting + Audit	warehouse-ms	Proposals, audit trail, notifications

Graceful degradation: test passano anche se un servizio esterno non e' configurato (Revolut, Anthropic). Skip per sezione: WMS_SKIP_BILLING=1, WMS_SKIP_AI=1, ecc.

L7 — Simulator Verification FASE 1 parallela

Integrita Dati Simulatore & Performance

Verifica scenari S2-S7, sim-log, anomalie, file JS, baseline performance

test-simulator.sh ~2-4 min parallela con L1, L3, L4, L6

§1 Dati S2: warehouse, zone, prodotti (prerequisiti)
§2 Sim-log API: batch write 10 eventi + read sessions
§3 Report anomalies: KPI, dashboard coerenza
§4 File scenari S3-S7: verifica JS presenti + sim-datasets API
§5 Performance: 5 call parallele tutte <2000ms
Verifica: missions, zones, products, stock, KPI p95 latency

SimBot v3 — Browser-Native UI Test + Formazione standalone

Robot Browser-Native che Configura, Forma e Testa il WMS

26 fasi · 23 sezioni · voce sincronizzata · bug detection · AI Q&A + microfono · osservazioni utente · dati reali nel DB

simbot/panel.html ~15-25 min (Full) on-demand · Lancia SimBot

Architettura v3 (Browser-Native)

A differenza della v2 (Playwright + Node.js headless), SimBot v3 gira interamente nel browser dell'utente:

Iframe same-origin: l'app WMS e' caricata in un iframe — l'utente vede ogni azione in diretta
JavaScript puro: automazione DOM via frame.contentDocument, zero dipendenze
Web Speech API: voce italiana sincronizzata con keepalive anti-Chrome-kill
AI Q&A in pausa: l'utente puo fare domande tramite /api/ai/chat + fallback locale (12+ risposte)
Input vocale: microfono per dettare domande e osservazioni (Speech Recognition API)
Osservazioni utente: tab dedicato per registrare suggerimenti e migliorie con report finale
Presentazione scenario: all'avvio la voce descrive l'azienda simulata (dimensioni, fatturato, clienti, siti)
Singolo file: panel.html (~2400 righe) contiene tutto: UI, engine, fasi, fixture, Q&A, voice recognition

Le 26 fasi del percorso

Fase	Cosa fa	Tipo	Verifica DB
00 Reset	Elimina dati SB- precedenti via API	Cleanup	—
01 Login	Accesso admin, verifica #app-screen	Auth	—
02 Dashboard Tour	KPI, health banner, risorse, alert	Tour	—
03 Warehouse	5 magazzini via form UI	CRUD	Batch
04 Zone	30 zone (6 tipi, 5 ambienti)	CRUD	Batch
05 Bin	27 bin (FEFO, FIFO, dedicated)	CRUD	Batch
06 Prodotti	61 SKU (cold/frozen/ambient)	CRUD	Batch
07 Packaging GS1	Tour EA>CASE>PALLET, EAN/GTIN	Tour	—
08 Clienti/Forn/Corr	15 fornitori, 20 clienti, 4 corrieri	CRUD	—
09 Operatori/Equip	8 mezzi (UI) + 6 operatori (API)	CRUD+API	—
10 Inventario	Lotti + stock (scadenze realistiche)	API	—
11 Inbound	3 ordini + receiving QC + putaway	API+UI	—
12 Outbound	3 ordini + confirm + wave + ship	UI+API	—
13 TMS	3 autisti + 1 giro consegna	UI+API	—
14 Tracking	3 colli + scan eventi	API	—
15 Missioni	5 missioni (pick/put/transfer/count)	API	—
16 Conformita NCR	4 NCR (danni, discrepanze, scadenze)	API	—
17 4PL & Billing	3 aziende multi-tenant	UI+API	—
18 Yard	3 trailer con stati banchina	API	—
19 Mappa	Tour planimetria SVG interattiva	Tour	—
20 Calendario	Tour disponibilita risorse	Tour	—
21 Notifiche	Test alert SSE real-time	Tour	—
22 AI Assistant	Claude + RAG, domanda live	Tour+API	—
23 Operativita	5 giorni simulati (ordini/missioni/alert)	API	—
24 Report KPI	6 tab report + stock + dashboard	Tour	—
25 Verifica	Conteggi API + navigazione 7 sezioni	Check	Full
Totale S2-Full		200+ entita	26 fasi

Bug Detection integrato

SimBot monitora automaticamente ogni operazione e segnala bug in tempo reale:

Form non si apre: DataLoader.newXxx() non esiste o il modale resta hidden
Campo mancante: un campo previsto non esiste nel DOM del form
Errore salvataggio: il modale resta aperto dopo Conferma (validazione fallita)
Dato non nel DB: verifica batch via API a fine fase (conteggio reale vs atteso)
Errore API: risposte 4xx/5xx dalle chiamate backend

A fine sessione il log mostra un Bug Report con fase, tipo di problema e dettaglio tecnico. Il contatore Bug nella barra KPI e' verde (0) o rosso (problemi rilevati).

Presentazione scenario aziendale

All'avvio la voce descrive l'azienda che stiamo simulando. Per lo scenario S2-Full:

"Simuliamo il gruppo Logitech 4PL Group, operatore logistico con 200 dipendenti e 45 milioni di fatturato"
3 clienti in outsourcing: FoodGroup (alimentari), PharmaNet (farmaci GDP), RetailDistrib (e-commerce)
5 siti nel nord Italia, 33.000 mq, 61 referenze, 20 clienti attivi

Formazione vocale campo-per-campo

La voce spiega il significato di ogni campo al primo inserimento di ogni tipo:

Warehouse: codice (convenzione), nome, tipologia (distribution/fulfillment/cold_chain/hazmat/bonded), citta, indirizzo, superficie, banchine di carico
Zone: 6 tipi funzionali (receiving, storage, picking, packing, shipping, quarantine) con esempi reali
Bin: 4 tipi (pallet 80x120, standard, pick face, bulk), FEFO ("se hai latte del 5 e del 10..."), FIFO, dedicato
Prodotti: SKU, categoria, storage type (con spiegazione cold chain), peso (per trasporti), lot tracking (obbligo legale)
Clienti: 6 canali (HORECA, GDO "Esselunga consegna 6-8", e-commerce, pharma, ospedale "mai ritardare")
Corrieri: 4 servizi (express, standard, premium GDP, FTL camion completo)

Interazione in pausa — AI Contestuale, Osservazioni e Microfono

Premendo PAUSA il bot si ferma e l'utente puo interagire in due modalita:

Tab Domanda (ciano): l'AI risponde solo su argomenti della fase corrente e quelle gia completate. Non inventa dati.
Tab Osservazione (giallo): registra suggerimenti, migliorie o note. Report completo a fine sessione.
Microfono (Speech Recognition API): l'utente preme il bottone mic e parla in italiano. Il testo viene trascritto e inviato automaticamente — sia per domande che per osservazioni.

A fine sessione: Bug Report + Report Osservazioni nel log.

Protezioni operative

Blocco interazione: overlay trasparente impedisce click utente durante esecuzione
Semaforo multi-utente: avviso se un altro utente sta usando SimBot, con durata stimata e "Forza Reset"
STOP + Rilancio: riconosce la stessa sessione (sessionStorage) e riparte senza blocco
Scroll automatico: scrolla l'iframe per mostrare l'elemento su cui opera. Tour con scroll graduale per sezioni lunghe
Reset via API: POST /api/simulator/reset cancella 30+ tabelle su 7 database

Durata stimata (senza pause)

Scenario	Veloce	Normale	Lento	Demo
S2 Fast	~2 min	~4 min	~7 min	~10 min
S2 Full	~8 min	~15 min	~25 min	~35 min

Indicatore ~Xmin sempre visibile nella barra viola, si aggiorna in tempo reale.

Come usarlo

https://app.wms.agile.software/simbot/panel.html    (SimBot)
https://app.wms.agile.software/simbot-guide.html     (Guida utente)
https://app.wms.agile.software/simbot-technical.html  (Specifica tecnica)

Stress Test — Race Condition & Load manuale

Comportamento sotto carico concorrente reale

10–50 worker paralleli, verifica race condition, no crash, no data corruption

test-stress.sh [URL] [CONCURRENCY] ~2-3 min manuale / notturno

#	Sezione	Worker	Verifica	Status
0	Login iniziale	1×	Setup token	OK
1	Concurrent Login	10×	JWT race condition	OK
2	Concurrent SKU	10×	Unique constraint, no 5xx	OK
3	Concurrent Inbound	10×	`order_number` unici	OK
4	Concurrent Outbound	10×	`order_number` unici	OK
5	Stock Movements	10×	No stock negativo (GREATEST guard)	OK
6	API Flood	50×	No crash, no rate 5xx	OK
7	Tenant Isolation	—	Tenant 99999 non visibile	OK
8	Qty verification	—	Campo JSON corretto	cosmetic

Fix race condition applicati: MAX()+1+random_int(1,20) + retry 5× con jitter su InboundService e OutboundService.

Il Simulatore come Strumento QA

Il Simulatore WMS non è solo una demo commerciale — è il livello di test più avanzato dell'intera suite. Simula fino a 365 giorni di operatività in pochi minuti, generando migliaia di eventi reali che testano il sistema in condizioni impossibili da riprodurre con test tradizionali.

SimEngine (Web Worker)

Motore asincrono in Web Worker separato. Genera eventi (inbound, outbound, missioni AGV, guasti, flash sale) senza bloccare la UI. Velocità 1×–100×.

SimRecorder (event-driven)

Registra ogni evento engine (non time-based). Un frame per evento con KPI snapshot. Replay slider, sparklines, istogramma frequenza. Max 5.000 frame con thinning automatico.

SimIDB (IndexedDB)

Logger API call via IndexedDB (fuori heap V8 → no OOM). Path normalizzati, latenza per chiamata, top endpoint, conteggio errori. Fino a 5.000 entries FIFO.

7 Scenari Industriali — Copertura Funzionale

Scenario	Verticale	Cosa testa in modo unico
S1 Logitech 4PL Group	Consumer Electronics	5 facility, 3 tenant 4PL, SLA multi-carrier, billing cycle
S2 +Layer Complexity	4PL Avanzato	Resi, guasti equipment (OEE), flash sale, stagionalità per SKU
S3 Pharma Cold Chain	Farmaceutico	GDP compliance, temperatura 2–8°C, lotti FEFO critici
S4 Automotive JIT	Automotive	Just-in-time, kanban, lead time rigido, zero stock tollerato
S5 Retail Omnichannel	Retail	E-commerce + punto vendita, webhook ordini, wave picking ad alto volume
S6 E-commerce Express	E-commerce	SLA 24h, alto volume, stress picking, cartonization automatica
S7 Food Distribution	Food & Beverage	FEFO obbligatorio, tracciabilità filiera, allerta scadenze

Wizard → Simulatore → SimRecorder: flusso QA

sim-wizard.html

→

CSV/JSON custom

→

Simulatore

→

SimRecorder REC

→

Replay + KPI

→

Snapshot AI Claude

Il Sim Wizard (/sim-wizard.html) guida la configurazione in 7 step (scenario, dati custom CSV/JSON, speed, health check) e lancia automaticamente il simulatore con i parametri scelti. Il SimRecorder cattura ogni evento per la revisione post-simulazione. Lo Snapshot AI invia la timeline a Claude per analisi automatica delle anomalie.

Anti-OOM — Protezione memoria in run lunghi

LOG_BUFFER_MAX=500 — buffer circolare log UI (shift() automatico)
MAX_BUG_ITEMS=200, MAX_EVENTS=500, UI_TICK_EVERY=3
SimIDB fuori heap V8 — IndexedDB non impatta RAM motore JS
SimRecorder thinning automatico a 5.000 frame — evita accumulo senza fine

Orchestrazione & CI/CD

test-master.sh — Esecuzione locale

FASE 1 (parallela — 5 test in background):
  L1 Smoke     ─┐
  L3 PHPUnit   ─┤
  L4 SimAPIs   ─┤ → tutti in background (&) → wait
  L6 Super     ─┤
  L7 Simulator ─┘

FASE 2 (sequenziale):
  L2 E2E Integration (12 step multi-microservizio)

FASE 3 (UI, saltabile con SKIP_L5=1):
  L5 Playwright (41 test, 7 spec, Chrome headless)

Standalone (manuali, non nel master):
  Stress Test      → ./infrastructure/test-stress.sh [URL] [CONCURRENCY]
  SimBot S2-Fast   → node simbot/simbot-runner.js --headless --scenario=s2
  SimBot S2-Full   → node simbot/simbot-runner.js --headless --scenario=s2-full

Output: /tmp/wms-test-report-YYYYMMDD.html (master)
        simbot/report/index.html (SimBot)

CI Pipeline — .gitea/workflows/wms-tests.yml

smoke

→

phpunit
needs: smoke

simulator-apis
needs: smoke

→

playwright-ui
needs: smoke + Node 20

→

summary
needs: all

Variabili d'ambiente

WMS_BASE_URLhttps://wms.agile.softwareURL base per i test WMS_EMAILadmin@logitech-wh.itCredenziale admin test WMS_PASSAdmin2026!Password — in SSH url-encode il ! → %21 WMS_SKIP_L[1-7]—Salta livello specifico (es. WMS_SKIP_L5=1) WMS_SKIP_BILLING—Skip sezione billing in L6 WMS_SKIP_AI—Skip sezione AI in L6 WMS_VERBOSE—Output dettagliato in test-master CONCURRENCY10Worker paralleli in test-stress.sh CHROME_PATH/usr/bin/google-chromePath Chrome per SimBot/Playwright

Bug Critici Trovati dai Test

Data	Livello	Bug	Severità	Fix applicato
2026-02-26	Stress	InboundService: `COUNT()+1` duplica `order_number` sotto carico	Critical	`MAX()+1+random_int(1,20)` + retry 5× jitter
2026-02-26	Stress	OutboundService: stesso problema (`+$attempt` insufficiente)	Critical	Jitter casuale su retry — rompe simmetria temporale
2026-02-26	Stress	ProductService TOCTOU: SELECT check + INSERT separati → 5xx su duplicate SKU	High	`catch PDOException 23000 → return 400`
2026-02-26	L1 Smoke	AuditLogger non nell'autoload inbound-ms → 500 su create order	High	Aggiunto `wms/audit-lib` a composer.json + rebuild
2026-02-26	L5 Playwright	Onboarding overlay blocca tutti i click post-login	Medium	Dismiss via `page.evaluate()` in ogni spec
2026-02-26	L5 Playwright	`text=credenziali` invalido come CSS selector	Medium	`.or(page.getByText(/regex/i))`
2026-03-02	L4 Simulator	`POST /api/ai/knowledge/search` restituiva 405 (route mancante)	High	Aggiunta route in ai-ms/public/index.php + docker cp

Roadmap QA

SimBot scenari S3-S7 — fixture per Pharma GDP, Automotive JIT, Retail Omnichannel
SimBot operator receiving — migliorare interazione con pulsante Ricevi ordine inbound
SimBot creazione operatori — debug modal operatore che non si apre
L3 per warehouse-ms — AlertService, ZoneService, CustomerService, SupplierService, CarrierService
Stress test nel CI — job notturno schedulato (on: schedule)
Lighthouse + CWV — Core Web Vitals su pagine pubbliche
SimBot report migliorato — confronto tra run, trend timing, screenshot lightbox