pipeline in linea single thread

aggiornamento-2026-05-16-17-18.md

@@ -0,0 +1,75 @@
+# Aggiornamento 2026-05-16 17:18
+
+## Test supporto Tesseract
+
+## Stato
+
+E' stato installato il wrapper Python:
+
+```powershell
+python -m pip install pytesseract
+```
+
+Sul PC pero' non risulta installato il binario:
+
+```text
+tesseract.exe
+```
+
+`where tesseract` non trova nulla.
+
+## Modifiche implementate
+
+In `flywms_wms_server.py` e' stato aggiunto supporto opzionale a:
+
+```text
+wms_ocr_mode = tesseract
+```
+
+Il server ora:
+
+- usa `pytesseract` se disponibile;
+- usa whitelist numerica `0123456789`;
+- prova piu' preprocess OpenCV;
+- richiede consenso tra almeno due varianti;
+- se Tesseract non e' installato o il risultato e' ambiguo, restituisce `udc non determinato`.
+
+E' stato aggiunto un controllo preventivo:
+
+- se `wms_tesseract_cmd` e' configurato ma il file non esiste, fallback immediato;
+- se `tesseract` non e' nel PATH, fallback immediato.
+
+Questo evita che `pytesseract` resti appeso cercando un binario assente.
+
+## Verifica eseguita
+
+Sul crop:
+
+```text
+navigate_snapshots/snapshot_0002_track_003_label_payload.jpg
+```
+
+con OCR mode `tesseract`, senza tesseract installato:
+
+```text
+Tesseract fallback: tesseract.exe non trovato nel PATH
+OcrServerResult(text='udc non determinato', raw_text='', confidence=0.0, backend='tesseract-missing', fallback_used=True)
+```
+
+## Nota
+
+Il file `flywms_navigation.ini` al momento non e' stato aggiornato con `wms_tesseract_cmd` perche' il patch tool non e' riuscito a scriverlo in questa fase. I default del server contengono gia' `wms_tesseract_cmd = ""`, quindi il codice resta funzionante. Va aggiornato l'INI appena il file non risulta piu' bloccato.
+
+## Prossimo passo
+
+Installare Tesseract per Windows e poi testare:
+
+```powershell
+python flywms_wms_server.py --ocr-mode tesseract
+```
+
+Se `tesseract.exe` non e' nel PATH, avviare con:
+
+```powershell
+python flywms_wms_server.py --ocr-mode tesseract --tesseract-cmd "C:\Program Files\Tesseract-OCR\tesseract.exe"
+```