External observer with OpenCV UI baseline

aggiornamento-2026-05-29-16-38.md

@@ -0,0 +1,86 @@
+# Aggiornamento 2026-05-29 16:38
+
+## Step 1 - Core / Observer
+
+Completati:
+
+- documento di progetto Step 1 in [step1_core_observer_design.md](/C:/devel/flywms/step1_core_observer_design.md)
+- separazione iniziale tra core runtime e observer esterno
+- configurazione observer aggiunta in [flywms_navigation.ini](/C:/devel/flywms/flywms_navigation.ini)
+- nuovo entrypoint observer in [flywms_navigation_observer.py](/C:/devel/flywms/flywms_navigation_observer.py)
+
+## Modifiche implementate
+
+In [flywms_navigation.py](/C:/devel/flywms/flywms_navigation.py):
+
+- aggiunto `ObserverPublisher`
+- il core puo' pubblicare su `localhost`:
+  - telemetria strutturata
+  - preview JPEG a bassa frequenza
+- quando `observer_enabled = true`:
+  - la UI locale integrata viene disattivata
+  - il core non aspetta l'observer
+  - l'observer puo' essere assente o disconnettersi senza bloccare la pipeline
+- la sequenza snapshot headless e' stata resa osservabile per fasi:
+  - `move`
+  - `stabilize`
+  - `capture`
+  - `return`
+  - `wait_wms`
+
+In [flywms_navigation_observer.py](/C:/devel/flywms/flywms_navigation_observer.py):
+
+- processo separato
+- connessione TCP locale al core
+- visualizzazione di:
+  - preview navigazione
+  - pannello comandi/stato
+  - snapshot
+  - crop etichetta
+
+## Verifiche eseguite
+
+1. Compilazione Python:
+
+```bash
+python -m py_compile flywms_navigation.py flywms_navigation_observer.py
+```
+
+Esito: ok.
+
+2. Smoke test core con observer attivo ma non collegato:
+
+```bash
+python flywms_navigation.py --video testhd2_edit.mp4 --observer-enabled --max-frames 30
+```
+
+Esito:
+
+- il core parte regolarmente
+- la UI locale viene disattivata come previsto
+- il publisher si mette in ascolto su `127.0.0.1:8765`
+- il run chiude senza blocchi anche senza observer collegato
+
+## Stato attuale
+
+Lo Step 1 e' implementato nella sua forma iniziale e il lato critico del core e' verificato.
+
+Resta da fare una verifica manuale della GUI observer in esecuzione reale, cioe':
+
+1. avviare `flywms_navigation_observer.py`
+2. avviare il core con `--observer-enabled`
+3. controllare fluidita', frequenza preview e correttezza dei pannelli
+
+## Comandi di avvio previsti
+
+Observer:
+
+```bash
+python flywms_navigation_observer.py
+```
+
+Core:
+
+```bash
+python flywms_navigation.py --video testhd2_edit.mp4 --observer-enabled
+```