Auf dieser Seite

Das map.army-Datenmodell — Projekt, Layer, Symbol

Die meisten Seiten dieser Dokumentation beschreiben jeweils einen Teil des Arbeitsablaufs — ein Symbol platzieren, einen Layer exportieren, einen Share erstellen. Diese Seite tritt einen Schritt zurück und zeigt, wie diese Teile zusammenspielen. Wer das Modell kennt, liest die übrigen Seiten klarer.

Drei Begriffe, von oben nach unten

map.army gliedert eine taktische Lage in drei verschachtelte Begriffe:

Begriff	Was es ist	Wo es lebt
Projekt	Die Arbeitssitzung — Ihre aktuelle Kartenansicht, die geöffneten Layer und die Anwendungseinstellungen drumherum.	Im Browser, solange der Tab offen ist. Die gehostete Anwendung speichert keinen benutzerspezifischen Zustand auf dem Server.
Layer	Ein benannter Container für Symbole und taktische Grafiken. Ein Projekt hat in der Regel mehrere Layer (blaue Kräfte, rote Kräfte, Phasenlinien …).	Wird beim Export als MilX-Datei (`.milxlyz` oder `.milxly`) gespeichert.
Symbol / Taktische Grafik	Eine einzelne MIL-STD-2525-Platzierung auf einem Layer: ein Einheiten-Symbol, eine Phasenlinie, ein Wirkungskreis usw. — mit Position, Zugehörigkeit, Status und Modifiern.	Innerhalb des Layers, zu dem es gehört.

Die Hierarchie ist strikt: Jedes Symbol gehört zu genau einem Layer; jeder Layer gehört zum aktuellen Projekt. Symbole zwischen Layern zu verschieben ist möglich (siehe Layer bearbeiten — Symbole zwischen Layern verschieben); ein Symbol, das zu keinem Layer gehört, ist im Modell nicht abbildbar.

Das Projekt ist der offene Browser-Tab

Es gibt kein Menü “Neues Projekt” oder “Projekt öffnen”. Das Projekt ist implizit — es ist alles, was Sie gerade auf dem Bildschirm sehen: Kartenansicht, aktive Hintergrundkarte, eingestelltes Koordinatenraster, geöffnete Layer und deren Symbole. Schliessen Sie den Tab ohne Export, ist das Projekt weg.

Zwei praktische Konsequenzen:

Speichern bedeutet exportieren. Die unterstützte “Arbeit sichern”-Aktion ist Layer exportieren → .milxlyz. Behandeln Sie diese Aktion wie ein Speichern unter … einer Desktop-Anwendung. Siehe Layer exportieren.
Einstellungen bleiben, Daten nicht. Im Browser gespeicherte Einstellungen (Sprache, Einheiten, Standard-Symbolformat) überstehen einen Reload. Layer im Browser-Cache überstehen ihn nur eingeschränkt — siehe Sitzungspersistenz weiter unten.

Layer sind MilX

Ein Layer in map.army ist ein MilX-Layer. Die Anwendung behandelt sie intern und extern gleich — die Datei, die Sie exportieren (.milxlyz), enthält denselben Inhalt, den die Anwendung gerade bearbeitet. Deshalb sprechen die meisten Layer-Seiten austauschbar von “MilX-Layern” und “Overlays”.

Zwei nicht-MilX-Layertypen werden ebenfalls unterstützt, verhalten sich aber anders:

Layertyp	Trägt MilX-Symbolik?	Wird in `.milxlyz` gespeichert?
MilX-Layer	Ja	Ja
Bild-Overlay	Nein — eine an Koordinaten gepinnte Bilddatei	Nein — die Bilddatei muss mit einer Begleitdatei `config.json` gepaart werden (Layer importieren)
Vektor-Layer	Nein — GeoJSON- / KML-Geometrie	Nein — nach einem Reload neu importieren
Online-Quelle	Abhängig von der Quelle	Wird bei jeder Sitzung neu von der URL geholt

Wenn die Dokumentation ohne weitere Angabe von “Layer speichern” spricht, sind MilX-Layer gemeint.

Ein MilX-Share ist das serverseitige Äquivalent zu einem exportierten .milxlyz: das gs-soft-Backend hält den MilX-Inhalt unter einer öffentlichen URL bereit, damit andere ihn öffnen können (Read-Only oder mit Bearbeitung, je nach Share-Typ). Bild-Overlays und Vektor-Layer werden in einem Share nicht mitgeführt — nur MilX-Symbolik.

Ein Share ist eine Form, das Projekt extern zu veröffentlichen; er ist nicht “das Projekt selbst”. Mögliche Konstellationen:

Sie exportieren ein .milxlyz und legen keinen Share an — Ihre Arbeit bleibt lokal.
Sie legen einen Share an und exportieren nichts — Ihre Arbeit lebt auf gs-soft-Servern unter der Share-URL.
Sie tun beides — der Share ist die publizierte Kopie, die lokale Datei ist Ihr Archiv.

Siehe Wie man einen Share erstellt für die drei Share-Modi (Read Only, Edit & Copy, Edit & Overwrite).

Sitzungspersistenz — was einen Reload übersteht

Eine Kurzübersicht, was beim Schliessen und erneuten Öffnen des Tabs erhalten bleibt:

Element	Übersteht Reload?
Anwendungseinstellungen (Sprache, Einheiten, Standard-Symbolformat)	Ja — im Browser-Speicher abgelegt.
MilX-Layer	Teilweise — im Browser-Cache der aktuellen Site. Bei Cache-Bereinigung verloren.
Bild-Overlays	Nein, ausser sie werden mit derselben `config.json` neu importiert.
Vektor-Layer	Nein — nach Reload neu importieren.
Online-Quellen-Layer	Ja für die URL; der Inhalt wird bei jeder Sitzung neu geholt.
Stiftsymbol des aktiven Layers	Nein — auch ein Wechsel auf 3D und zurück deaktiviert ihn; vor dem Setzen neuer Symbole reaktivieren.

Eine ausführlichere Aufstellung steht unter Layer bearbeiten — Sitzungspersistenz. Die sichere Regel lautet: vor dem Schliessen des Tabs die MilX-Layer exportieren.

Was das Modell nicht ist

Einige Dinge tut map.army bewusst nicht, weil die gehostete Version keinen benutzerspezifischen Zustand hat:

Keine Projektliste / “Zuletzt geöffnet” — die Anwendung erinnert sich nicht an die Sitzung von gestern.
Kein Autosave auf einen Server. Browser-Caching ist Best-Effort.
Kein Mehrprojekt-Arbeitsbereich. Sie arbeiten an einem Layer-Set zur Zeit. Um zwischen Projekten zu wechseln, exportieren Sie das aktuelle und importieren danach das andere .milxlyz.

Das professionelle Angebot (Frei vs Pro) hebt einige dieser Einschränkungen auf — Benutzerkonten, serverseitige Projekte, rollenbasierte Zugriffe — die laufen jedoch als projektbezogene Bereitstellungen und sind nicht Teil der kostenlosen, gehosteten Demo.