Hangar - krt-profit/basetool GitHub Wiki
Hangar
Sidebar → Flotte & Logistik → Hangar — Verwaltung deiner Schiffe (Versicherung, Ort, Fitted-Status) und die Flotte aller für dich sichtbaren Org-Einheiten. Schiffe gehören immer dir persönlich und sind auf eine Org-Einheit (Staffel oder SK) gebucht.
Zwei Tabs
Der Hangar ist eine Seite mit zwei Tabs:
- „Meine Schiffe" — deine eigenen Schiffe. Die Zahl am Tab nennt, wie viele deiner Schiffe zur aktuellen Suche passen.
- „Org-Einheit IRI" (mit dem Kürzel deiner aktiven Org-Einheit; ohne aktive Org-Einheit nur „Org-Einheit") — die Schiffe aller sichtbaren Org-Einheiten, nach Schiffstyp zusammengefasst. Die Zahl am Tab nennt die Anzahl der Schiffstypen, nicht der Schiffe.
Beide Tabs haben eine eigene Adresse (/hangar und /hangar/squadron), alte Links und Lesezeichen funktionieren weiter. Früher war die Org-Einheitsübersicht eine eigene Seite hinter dem Button „Org-Einheitsübersicht"; diesen Button und „Zurück zum Hangar" gibt es nicht mehr.
Die Liste „Meine Schiffe"
Jede Zeile zeigt:
- Schiff — links ein Kästchen zum Markieren, daneben den Namen deines Schiffs, darunter Hersteller und Typ (ohne Namen steht oben „Hersteller Typ" und darunter „ohne Namen"),
- Standort,
- Versicherung als Chip: LTI, Keine oder die Laufzeit, z. B. „6 Mon.",
- Status als Punkt mit „Einsatzbereit" oder „Nicht bereit",
- Einheit — das Kürzel der Org-Einheit, auf die das Schiff gebucht ist, oder „—" ohne Einheit,
- rechts das Personen-Symbol „Einheit ändern" und das Stift-Symbol „Bearbeiten".
Auf dem Smartphone wird jede Zeile zu einem kompakten Listeneintrag.
Schiff anlegen / bearbeiten
Über „Schiff hinzufügen" öffnet sich ein Modal-Dialog mit diesen Feldern:
- Hersteller — filtert die Schiffstyp-Auswahl.
- Schiffstyp (Pflichtfeld) — aus den Stammdaten. Die Stammdaten kommen aus der UEX-Synchronisation; fehlt ein Schiffstyp, wende dich an die Administration.
- Name (optional) — z. B. ein selbst vergebener Schiffsname.
- Versicherung (Pflichtfeld) — Schalter Keine · Monate · LTI; bei „Monate" trägst du die Zahl der Monate ein (1 bis 120).
- Ort (optional) — eine Location aus den Stammdaten.
- Fitted (Einsatzbereit) — Haken für „einsatzbereit".
- Zuordnen zu (besitzende Org-Einheit) — nur beim Anlegen und nur, wenn du in mehreren Org-Einheiten bist; die aktive Org-Einheit aus der Sidebar ist dann schon ausgewählt, sonst steht dort „Bitte wählen". Bei genau einer Mitgliedschaft wird automatisch diese gestempelt; ohne jede Mitgliedschaft bleibt das Schiff ohne Org-Einheit.
Den Dialog öffnest du über „Schiff hinzufügen" oben rechts im Seitenkopf bzw. über das Stift-Symbol einer Zeile. Anlegen, Bearbeiten und Löschen passieren ohne Seiten-Reload (in-place). Beim Bearbeiten gibt es zusätzlich einen Löschen-Button mit Sicherheitsabfrage; die Auswahl „Zuordnen zu" fehlt dort – die Einheit änderst du über die eigene Zeilenaktion.
Einheit ändern
Über das Personen-Symbol „Einheit ändern" einer Zeile buchst du ein eigenes Schiff nachträglich auf eine andere Org-Einheit um. Zur Wahl stehen „Keine Einheit" und alle Org-Einheiten, in denen du direkt Mitglied bist (Staffel, Spezialkommando, Bereich, Organisationsleitung). Nach dem Speichern zeigt die Zeile sofort die neue Einheit, und das Schiff erscheint im Tab „Org-Einheit" dieser Einheit; mit „Keine Einheit" verschwindet es dort wieder. Das ist z. B. nötig, wenn eine verbundene Anwendung ein Schiff ohne Einheit angelegt hat, weil du mehreren Einheiten angehörst und sie keine gewählt hat.
Die Einheit wird getrennt vom übrigen Schiff gespeichert: Ändert jemand parallel Name, Ort oder Fitted-Status desselben Schiffs, gibt es keinen Konflikt. Nur zwei gleichzeitige Einheiten-Änderungen am selben Schiff melden einen Konflikt. Deine anderen geöffneten Hangar-Seiten aktualisieren sich ohne Reload.
Mehrere Schiffe auf einmal
Willst du viele Schiffe umbuchen – etwa nachdem eine verbundene Anwendung deine ganze Flotte ohne Einheit angelegt hat –, markierst du sie über die Kästchen links in den Zeilen. Das Kästchen im Tabellenkopf markiert alle Schiffe der angezeigten Seite. Sobald etwas markiert ist, erscheint unter der Liste eine Leiste mit der Anzahl, „Auswahl aufheben" und „Einheit ändern".
„Einheit ändern" öffnet denselben Dialog wie die Zeilenaktion und nennt die Zahl der markierten Schiffe. Haben alle dieselbe Einheit, ist sie schon ausgewählt, sonst „Keine Einheit". Nach dem Speichern zeigen alle Zeilen sofort ihre neue Einheit, und eine Meldung sagt, wie viele Schiffe umgebucht wurden und wie viele schon in dieser Einheit waren (die werden übersprungen).
- Markiert bleiben nur Schiffe, die du gerade siehst: Suchen, Filtern oder Blättern hebt die Markierung der übrigen auf.
- Gehört ein markiertes Schiff nicht (mehr) dir, wird die ganze Aktion abgelehnt und nichts geändert.
- Hast du ein Schiff schon vorher im Einzel-Dialog geöffnet, meldet dieser nach einer Mehrfach-Änderung einen Konflikt – lade dann die aktuellen Werte.
Suchen, Filtern, Sortieren und Blättern
„Meine Schiffe" lädt deine Schiffe seitenweise statt alle auf einmal. Die Werkzeugleiste über der Liste hat:
- Suchfeld („Nach Schiffstyp suchen..."): filtert schon beim Tippen serverseitig über die gesamte Flotte (nicht nur die gerade angezeigte Seite) nach Hersteller oder Schiffstyp.
- Schalter „Alle · Bereit · Nicht bereit": zeigt alle Schiffe, nur einsatzbereite oder nur nicht einsatzbereite.
- rechts die Zählung „5 von 7 einsatzbereit" — sie bezieht sich auf die aktuelle Suche, nicht auf den Schalter.
Passt nichts, erscheint „Keine Treffer für diese Suche." statt einer leeren Tabelle; „Filter zurücksetzen" hebt Suche und Schalter auf. Darunter wählst du die Seitengröße 10 / 50 / 100 (Standard 50) und blätterst. Die Sortierung ist fest: Hersteller, Typ, Versicherung, Ort und Name.
Suche, Schalter und Seite bleiben beim Hinzufügen, Bearbeiten, Löschen und Import erhalten, ohne dass die Seite neu lädt.
Weitere Aktionen (⋯)
Rechts neben „Schiff hinzufügen" öffnet das Drei-Punkte-Menü („Weitere Aktionen") zwei Einträge. Solange dein Hangar leer ist, sind beide ausgegraut („Keine Schiffe im Hangar.").
Home-Location für alle setzen
Mit „Home-Location für alle setzen" buchst du den Ort aller deiner Schiffe in einem Schritt auf eine der festgelegten Home-Locations um; der Dialog nennt vorher, wie viele Schiffe betroffen sind. Sind keine Home-Locations konfiguriert, weist der Dialog darauf hin („Keine Home-Locations konfiguriert. Bitte an einen Admin wenden.").
Hangar leeren …
„Hangar leeren …" entfernt alle deine eigenen Schiffe (nicht die fremder Mitglieder). Erfordert eine Bestätigung im Dialog („Ja, alle löschen") und lässt sich nicht rückgängig machen.
Schiffs-Import
Der Knopf „Fleetview importieren" oben im Seitenkopf öffnet direkt die Dateiauswahl: Du wählst eine JSON-Exportdatei, und der Import startet sofort; das Format wird automatisch erkannt (keine Auswahl nötig). Unterstützt werden:
- CCU Game Fleetview
- HangarXPLOR (Shiplist)
- Fleetyards
- StarJump FleetViewer („Hangar Link")
Die Exportdatei darf höchstens 8 MB groß sein. Größere Dateien lehnt der Hangar sofort mit einem Hinweis ab, noch bevor sie hochgeladen werden.
Schiffe werden über ihren Namen zugeordnet (mehrere tolerante Stufen, von exakt bis abgekürzt); für StarJump FleetViewer und Fleetyards dient zusätzlich ein Slug als Fallback. Mehrdeutige Treffer werden bewusst nicht geraten, sondern bleiben unzugeordnet. Bestehende Schiffe gehen nie verloren: pro Schiffstyp werden nur die fehlenden Schiffe angelegt — Versicherung kommt aus dem Export (HangarXPLOR LTI), sonst neutral „Keine".
Nach dem Import zeigt das Fenster „Import-Ergebnis" die Zahlen Importiert, Nicht erkannt und Duplikate übersprungen mit aufklappbaren Listen („Nicht erkannte Schiffe", „Übersprungene Duplikate").
Verbundene Anwendungen
Hast du eine verbundene Anwendung mit der Berechtigung „Schiffe im Hangar ändern", gleicht sie deine Schiffe ab. Beim ersten Abgleich ordnet sie ihre Schiffe zuerst deinen vorhandenen zu – auch denen aus einem Fleetview-Import – und legt erst danach an, was fehlt. So entstehen keine doppelten Schiffe. Kaufdaten (Preis, Paket, Warbond) übermittelt sie nie.
Tab „Org-Einheit"
Fasst die Schiffe nach Schiffstyp zusammen: eine Zeile je Schiffstyp mit Typ und Hersteller, der Anzahl und einem Balken „7 von 9" (einsatzbereit von gesamt). Eine Legende in der Werkzeugleiste erklärt die Farben („Einsatzbereit · Nicht bereit"). Offiziere klappen über den Pfeil vor dem Schiffstyp die Besitzer auf — eingerückte Zeilen mit Besitzer, Status-Punkt und Standort; Mitglieder sehen nur Anzahl und Balken.
Ohne aktiv gepinnte Org-Einheit spannt die Übersicht alle für dich sichtbaren Org-Einheiten:
- Als Mitglied siehst du die Schiffe aller deiner eigenen Staffeln und Spezialkommandos.
- Als Bereichsleitung zusätzlich die der untergeordneten Org-Einheiten deines Bereichs.
- Als Organisationsleitung jedes Schiff im System — auch die Schiffe von Mitgliedern, die keiner Org-Einheit angehören.
Wählst du in der Sidebar unter „Aktive Org-Einheit" eine einzelne Org-Einheit, schränkt sich die Übersicht wieder auf genau diese ein.
Die Übersicht aktualisiert sich von selbst: Legt jemand ein Schiff in einer der angezeigten Org-Einheiten an, ändert oder löscht es oder verschiebt es in eine andere Einheit, erscheint das ohne Neuladen – auch wenn eine verbundene Anwendung die Änderung geschrieben hat.
- Suchfeld über der Tabelle: filtert beim Tippen serverseitig über alle sichtbaren Org-Einheiten nach Schiffstyp oder Hersteller (kein stilles Abschneiden).
- Seitengröße 10 / 50 / 100 mit Blättern; Filter bleibt beim Blättern und Umstellen erhalten.
Cross-Org-Einheit
Du siehst nie den Hangar einer fremden Org-Einheit. Als Eigentümer siehst und bearbeitest du deine eigenen Schiffe aber immer — auch nach einem Wechsel der Org-Einheit oder ganz ohne Mitgliedschaft.
Protokoll
Jede Änderung am Hangar wird protokolliert: Schiff anlegen, bearbeiten, Einheit ändern, löschen, Hangar leeren, Import und Home-Location — egal ob über die Web-Oberfläche, die App oder eine verbundene Anwendung. Festgehalten werden der Schiffstyp, Anzahlen und welche Felder sich geändert haben – bei „Einheit ändern" die alte und die neue Einheit als Art und Kennung, nicht ihr Name –, nie der Schiffsname oder andere Freitexte. Löschst du ein Schiff, das einer Einsatz-Einheit zugeordnet war, vermerkt auch der Einsatz, dass die Einheit ihr Schiff verloren hat.
Konflikte beim Speichern
Bearbeitet jemand dasselbe Schiff parallel, meldet das Speichern einen Konflikt („Konflikt: Jemand war schneller"). Lade über „Aktuelle Werte laden" den aktuellen Stand und speichere erneut.
Benachrichtigungen
Wird eines deiner Schiffe einem Einsatz zugeteilt, bekommst du eine Meldung; zieht jemand es wieder ab, verschwindet sie. Werden die „Ausgerüstet“-Markierungen deiner Schiffe zurückgesetzt oder ändert jemand anderes deinen Hangar, erfährst du das ebenfalls – auch wenn dabei die Einheit eines deiner Schiffe geändert wird; bei mehreren Schiffen auf einmal bekommst du eine einzige Sammelmeldung mit der Anzahl. Alle Arten kannst du unter Profil → Benachrichtigungen abbestellen (siehe Benachrichtigungen).
Wer darf was?
| Aktion | Mitglied | Offizier |
|---|---|---|
| Eigenen Hangar ansehen & pflegen | x | x |
| Schiffs-Import / Home-Location setzen / eigene Schiffe löschen | x | x |
| Einheit eines eigenen Schiffs ändern (auf eine eigene Einheit oder keine) | x | x |
| Einheit mehrerer eigener Schiffe auf einmal ändern (Auswahlleiste) | x | x |
| Tab „Org-Einheit" (Anzahl und Balken) ansehen | x | x |
| Besitzer je Schiffstyp aufklappen | x |
Logistiker und Einsatz-Manager sind Mitglieder mit Zusatzrechten in anderen Bereichen; im Hangar haben sie keine über das Mitglied hinausgehenden Rechte. Maßgeblich ist immer der Code — die vollständige Matrix steht in Rollen und Berechtigungen und in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.
Zeiten werden in UTC gespeichert und in deiner lokalen Zeit angezeigt.