# 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
```