In questa pagina

Il modello di progetto map.army — Progetti, livelli, simboli

La maggior parte delle pagine di questo sito descrive un pezzo del flusso di lavoro — posizionare un simbolo, esportare un livello, creare una condivisione. Questa pagina fa un passo indietro e mostra come questi pezzi si incastrano. Conoscere il modello in anticipo rende la lettura del resto della documentazione più chiara.

Tre concetti, dall’alto verso il basso

map.army organizza una situazione tattica in tre concetti annidati:

Concetto	Cos’è	Dove vive
Progetto	La sessione di lavoro — la vista mappa corrente, l’insieme dei livelli aperti e le impostazioni dell’applicazione intorno ad essi.	Nel browser, mentre la scheda è aperta. L’app ospitata non memorizza nessuno stato per utente sul server.
Livello	Un contenitore nominato per simboli e grafici tattici. Un progetto di solito ha diversi livelli (forze blu, forze rosse, linee di fase, …).	Salvato come file MilX (`.milxlyz` o `.milxly`) quando si esporta.
Simbolo / Grafico tattico	Un singolo posizionamento MIL-STD-2525 su un livello: simbolo di unità, linea di fase, anello di portata, ecc., con la sua posizione, affiliazione, stato e modificatori.	All’interno del livello a cui appartiene.

La gerarchia è rigida: ogni simbolo appartiene esattamente a un livello; ogni livello appartiene al progetto corrente. Spostare un simbolo tra livelli è supportato (vedere Modificare i livelli — Spostare simboli tra livelli); un simbolo che non appartiene ad alcun livello non è uno stato che l’applicazione può rappresentare.

Il progetto è la scheda del browser aperta

Non esiste un menu “Nuovo progetto” o “Apri progetto”. Il progetto è implicito — è ciò che si ha sullo schermo in questo momento: la vista mappa, la mappa di base attiva, l’impostazione della griglia di coordinate, i livelli aperti e i simboli su di essi. Chiudere la scheda senza esportare e il progetto è perso.

Due conseguenze pratiche:

Salvare esportando. L’azione supportata “salva il tuo lavoro” è Esporta livelli → .milxlyz. Trattarla come un comando Salva con nome… in un’applicazione desktop. Vedere Esportare i livelli.
Le impostazioni persistono; i dati no. Le preferenze memorizzate nel browser (lingua, unità, formato simbolo predefinito) sopravvivono a un ricaricamento. I livelli memorizzati solo nella cache del browser potrebbero o meno sopravvivere a seconda dello stato della cache — vedere Persistenza della sessione di seguito.

I livelli sono MilX

Un livello in map.army è un livello MilX. L’applicazione li tratta in modo identico internamente ed esternamente — il file che si esporta (.milxlyz) è lo stesso contenuto che l’applicazione sta modificando. Per questo motivo la maggior parte delle pagine relative ai livelli parla di “livelli MilX” in modo intercambiabile con “livelli sovrapposti”.

Sono supportati anche due tipi di livelli non-MilX ma si comportano diversamente:

Tipo di livello	Porta simbologia MilX?	Salvato in `.milxlyz`?
Livello MilX	Sì	Sì
Immagine sovrapposta	No — è un file immagine fissato a coordinate	No — associare il file immagine a un file sidecar `config.json` (Importare livelli)
Livello vettoriale	No — è geometria GeoJSON / KML	No — reimportare dopo il ricaricamento
Livello da sorgente online	Dipende dalla sorgente	Recuperato nuovamente dall’URL ad ogni sessione

Quando la documentazione dice “salvare un livello” senza qualificazione, intende un livello MilX.

Una condivisione esternalizza un progetto

Una Condivisione MilX è l’equivalente lato server di un .milxlyz esportato: il backend di gs-soft mantiene il contenuto MilX sotto un URL pubblico in modo che altri utenti possano aprirlo (sola lettura o modifica, a seconda del tipo di condivisione). Le immagini sovrapposte e i livelli vettoriali non viaggiano con una condivisione — viaggia solo la simbologia MilX.

Una condivisione è un modo per pubblicare il progetto esternamente; non è “il progetto stesso”. È possibile:

Esportare un .milxlyz e non creare mai una condivisione — il lavoro rimane locale.
Creare una condivisione e non esportare mai — il lavoro vive sui server di gs-soft sotto l’URL della condivisione.
Fare entrambe le cose — la condivisione è una copia pubblicata; il file locale è l’archivio.

Vedere Come creare una condivisione per i tre modalità di condivisione (Sola lettura, Modifica e copia, Modifica e sovrascrivi).

Persistenza della sessione — cosa sopravvive a un ricaricamento

Un breve riepilogo di cosa sopravvive alla chiusura e alla riapertura della scheda:

Elemento	Sopravvive al ricaricamento?
Impostazioni dell’applicazione (lingua, unità, formato simbolo predefinito)	Sì — conservate nel browser storage.
Livelli MilX	Parzialmente — conservati nella cache del browser per il sito corrente. Persi se i dati del sito vengono cancellati.
Immagini sovrapposte	No, salvo reimportazione dallo stesso file sidecar `config.json`.
Livelli vettoriali	No — reimportare dopo il ricaricamento.
Livelli da sorgente online	Sì per l’URL; il contenuto viene recuperato nuovamente ad ogni sessione.
L’indicatore “matita” del livello attivo	No — passare alla 3D e tornare lo disattiva; riattivarlo prima di posizionare nuovi simboli.

Per un’analisi più completa vedere Modificare i livelli — Persistenza della sessione. La regola di sicurezza è: prima di chiudere la scheda, esportare i propri livelli MilX.

Cosa questo modello non è

Alcune cose che map.army deliberatamente non fa, poiché la versione ospitata non ha stato per utente:

Nessun elenco progetti / “apri recenti” — l’applicazione non ha memoria della sessione di ieri.
Nessun salvataggio automatico su un server. La cache del browser è best-effort.
Nessuno spazio di lavoro multi-progetto. Si lavora su un insieme di livelli alla volta. Per cambiare progetto, esportare il lavoro corrente, poi importare l’altro .milxlyz.

L’offerta professionale (Gratuito vs Pro) rimuove alcuni di questi vincoli — account utente, progetti lato server, accesso basato sui ruoli — ma si tratta di distribuzioni adattate a progetti, non parte della demo gratuita ospitata.