Mission Planner

Il modulo Mission Planner permette di pianificare, gestire e monitorare missioni robotiche all’interno dei progetti.
Tutte le configurazioni di base sono preimpostate: l’utente non accede al Backoffice ma opera direttamente nel Frontoffice, dove può censire le risorse necessarie e pianificare le missioni robotiche.

Disponibile con il modulo modulo-mission-planner attivo nel progetto.

Configurazione iniziale (Global Lists)

Mission Unit: rappresenta il robot dog.
Add-on: accessori o sensori collegabili alla Mission Unit.
Profiles: insieme di Add-on assegnabili ad un robot dog compatibile.

Creare una Mission Unit

Apri la Global List → Mission Units.
Clicca Nuovo elemento.
Compila i campi richiesti:
- Nome e serial number della Mission Unit.
- Model: selezionabile da elenco preimpostato.
Salva la Mission Unit per renderla disponibile alla creazione dei profili.

💡 Il modello è già preconfigurato dal sistema e può essere scelto da un menu a tendina precompilato.

Censire Add-on

Apri la Global List → Add-on.
Clicca Nuovo elemento.
Inserisci i dati richiesti e seleziona il modello dell’Add-on dall’elenco preconfigurato da sistema.
Salva per completare la registrazione.

💡 Gli Add-on possono essere telecamere, sensori o moduli accessori compatibili con la Mission Unit che sono stati precedentemente configurati da sistema.

Creare un Profilo

Apri la Global List → Profiles.
Clicca Nuovo elemento.
Compila i campi richiesti:
- Nome del profilo
- Robot Dog Model compatibile
- Add-on da associare al profilo (uno o più)
Salva per completare la creazione.

💡 Un profilo rappresenta la configurazione tecnica di un robot dog, comprendente tutti gli Add-on necessari per portare a termine determinate azioni durante una missione.

Pianificare una nuova Missione

Entra nel progetto.
Dalla Nav Rail, apri la sezione Inventory.
Fai clic sulla classe oggetto Mission per aprire la lista delle missioni.
Crea una nuova missione cliccando su Nuovo oggetto.
Si apre il modale dettaglio attributi con i seguenti attributi da compilare per poter creare la missione:
- Mission Name (main attribute)
- Mission Type
- Mission Unit
- Profile
Clicca Salva per confermare la configurazione.
Clicca Go to Mission per accedere alla sezione Missions nel pannello laterale sinistro e iniziare la pianificazione.
In alternativa, clicca Edit per modificare nome e dettagli della missione.

💡 Il pulsante Go to Mission apre l’interfaccia dedicata alla pianificazione in mappa.

Inserire Home e Waypoint in mappa

Nella sezione Missions, clicca Mark on map per registrare la posizione della Casa (Home).
La Casa viene sempre rilevata automaticamente sulla base della posizione del Robot Dog, che deve trovarsi già sulla charging station.
Il punto viene salvato in mappa come posizione di partenza della missione.
Se la Home è già posizionata e hai la necessità di modificarne la posizione, elimina la posizione attuale ed esegui nuovamente il Mark on Map.
Per inserire Waypoint, utilizza lo strumento di disegno nella toolbar.
- Al primo click viene posizionato il punto in mappa, quindi ruota il mouse per definirne l’orientamento.
- Conferma con click destro per salvare il Waypoint.
- I Waypoint possono essere eliminati in due modi:
  - Posizionandosi con il cursore sulla card nel pannello laterale e cliccando il bottone Elimina.
  - In mappa, selezionando il Waypoint e cliccando Elimina nulla Toolbar.
- L'orientamento dei Waypoint può essere modificato selezionando quest'ultimo in mappa e cliccando sul tool Ruota nella Toolbar.
- Per individuare un Waypoint in mappa dal pannello laterale, clicca il bottone Go To sulla card del Waypoint corrispettivo.

💡 Nel pannello laterale, tutti i Waypoint disegnati vengono numerati automaticamente in ordine di inserimento. Possono comunque essere draggati in lista per modificarne l'ordinamento.

Impostare azioni sui Waypoint

Ogni Waypoint può contenere una o più azioni, scelte da un elenco pre-filtrato in base al modello del robot e agli Add-on collegati.
Le azioni disponibili includono:

Scatta foto
Inizia video
Ferma video
Aspetta (x secondi)

Clicca Salva per salvare tutte le azioni configurate all'interno dei Waypoint.
Se vuoi cancellare un'azione, clicca sul bottone Elimina sulla card dell'azione interessata.
Solo dopo il salvataggio sarà possibile avviare il Mission pre-check.

💡 Selezionando l’azione Wait, il campo Add-on diventa una casella di testo dove inserire il tempo in secondi (1–300).

Avviare la missione

Clicca Mission pre-check per verificare i requisiti della missione. Il pulsante resta disattivato finché non sono presenti la Home e almeno un Waypoint.
Se il controllo è superato, clicca Inizia Missione per avviare l’esecuzione.
In caso di errori non bloccanti, apparirà un alert con possibilità di forzare l’avvio spuntando “avvio con scarico di responsabilità”. La missione può essere avviata solo dopo aver spuntato il check dell'avviso.

💡 Tutte le missioni avviate vengono automaticamente storicizzate, creando un template pronto per la successiva esecuzione.

Monitorare una missione live

Durante la missione, la sezione Live Mission mostra:

Stato di connessione del cane
Streaming video della camera
Controlli per muovere il cane manualmente o interrompere la missione
Controlli per raccogliere media non programmati (esterni ai Waypoint)

Sono disponibili anche i comandi:

Pausa / Riprendi per sospendere o riprendere la missione
Return to Home per interrompere e far tornare il cane alla base

💡 Durante la missione, lo stato del cane è mostrato tramite chip:
Autonomous, Manual control, Returning to home, Pause.

Visualizzare missioni concluse e media raccolti

Tutte le Missioni storiche sono visibili da Inventory → Missions (Archived).

Aprendo il dettaglio di una missione archiviata, puoi visualizzare i media raccolti fuori dai Waypoint.

I video e le immagini registrate si salvano automaticamente nei Waypoint (Archived), raggruppati nei layer sotto il nome della missione, e sono visibili nel dettaglio del Waypoint corrispondente.

Ripristinare una missione storica

Apri la missione da Inventory → Missions (Archived).
Clicca Crea una copia per generare una nuova missione identica a quella selezionata.
Attendi il completamento della copia (indicata dal loader).
La nuova missione comparirà nell’elenco delle Missions (non archiviate) e potrà essere modificata prima dell’avvio.

Suggerimenti utili

💡 Disegno più preciso
Durante il posizionamento dei Waypoint, assicurati di non cliccare su aree nere della costmap: i punti inseriti in zone non valide non verranno salvati.

💡 Azioni multiple
Nelle versioni recenti, i Waypoint possono contenere più azioni consecutive, eseguite nell’ordine impostato.

💡 Organizza le missioni
Usa nomi coerenti e distintivi per facilitare la consultazione nel tab Inventory.

Problemi comuni

Problema	Soluzione
Non riesco a posizionare la Casa	Verifica che il robot sia acceso e connesso.
I Waypoint non vengono salvati	Assicurati di confermare con click destro.
Il pre-check non si attiva	Controlla di aver inserito la Home e almeno un Waypoint valido. Se ancora non funziona verifica di aver salvato le azioni inserite sul sul Waypoint.
La missione non parte	Verifica che tutti i controlli del pre-check siano andati a buon fine o forza l’avvio con scarico di responsabilità nel caso di errori che lo consentono.

Ultimo aggiornamento: 08 ottobre 2025