Einsätze - krt-profit/basetool GitHub Wiki
Einsätze
Einsätze sind das Herz der App: gemeinsame Operationen planen, briefen, durchführen und abrechnen. Du erreichst sie über Sidebar → Einsatzplanung → Einsätze; die Liste heißt „Einsatzverwaltung". Jeder Einsatz gehört zu einer Org-Einheit — einer Staffel oder einem Spezialkommando (SK). Alle Zeiten werden in UTC gespeichert und in deiner Lokalzeit angezeigt.
Liste
Die Liste zeigt alle Einsätze, die du sehen darfst:
- Eigene Org-Einheit — alle Einsätze deiner Staffel / deines SK.
- Organisationsweite Einsätze (nicht intern) — staffelübergreifend für jedes Mitglied sichtbar, auch aus anderen Org-Einheiten.
- Interne Einsätze — nur für die eigene Org-Einheit.
Einsätze gibt es nur nach der Anmeldung zu sehen (seit 06.09.2026). Was für Mitglieder untereinander ausgeblendet wird, steht unter Was Mitglieder voneinander sehen.
Filtern
- Suche — Freitext über den Einsatznamen, immer sichtbar über der Liste.
- Kommend · Vergangen · Alle — der Schalter neben der Suche: „Kommend" (Standard) zeigt geplante und aktive Einsätze, „Vergangen" abgeschlossene und abgebrochene, „Alle" beide. Die Auswahl wird pro Browser gemerkt.
- Von / Bis — Datumsbereich über den geplanten Start, hinter dem Knopf „Filter" (die Zahl daran zeigt, wie viele dieser Filter aktiv sind). Suche und Datumsbereich starten bewusst frisch.
Aktive Filter stehen als Chips unter der Werkzeugleiste; ein Klick auf einen Chip entfernt diesen Filter, „Alle zurücksetzen" entfernt alle. Jede Zeile ist ein Link zum Einsatz und zeigt Name, Treffpunkt, Status, geplanten Start mit „in 5 Tagen"/„heute"/„läuft" und die Zahl der Anmeldungen; auf dem Smartphone wird jede Zeile zu einem zweizeiligen Eintrag. Unter der Liste steht „1–20 von 54" mit der Seiten-Navigation, die Zahl im Seitenkopf zeigt alle Treffer.
Die Liste aktualisiert sich beim Filtern ohne Neuladen der Seite — und auch live bei Änderungen anderer: legt jemand einen Einsatz an, ändert Name, Status oder geplanten Start oder löscht einen Einsatz, aktualisiert sich deine offene Liste von selbst, mit deinem eigenen Filter und deiner eigenen Seite. Die aktive Org-Einheit schaltest du in der Sidebar unter „Aktive Org-Einheit" um; sie steht im Anwendungstitel (Kopfzeile + Browser-Tab).
Einsatz anlegen
Auf der Liste oben rechts → „Neuer Einsatz" (für jedes Mitglied). Die Seite „Neuer Einsatz" hat oben den Zurück-Link „← Einsätze" und gliedert das Formular in nummerierte Abschnitte:
- Einsatz — Name (Pflichtfeld), Status, optional die Zuordnung zu einer Operation, Treffpunkt (Ort), Beschreibung (Markdown, bis zu 20.000 Zeichen) und Link zum Kalendereintrag.
- Zeitplan — Treffen Teamspeak, geplanter Start und geplantes Ende.
- Sichtbarkeit — der Schalter Intern.
- Ziele · optional — einzelne Ziele mit Klassifizierung Haupt-/Neben-/Nicht-Ziel.
- Ablauf · optional — Ablauf-Schritte mit optionaler Zeit/Ort-Angabe.
Ziele und Ablauf sind freiwillig und lassen sich auch später im Bearbeiten-Modus pflegen. Unten bleibt eine Leiste mit „Abbrechen" und „Einsatz anlegen" stehen, während du scrollst. Nach dem Anlegen landest du direkt im Bearbeiten-Modus des neuen Einsatzes, um ihn weiter einzurichten.
Einsatz ohne Org-Einheit (Bereichsleitung/OL)
Ein Nutzer ohne Staffel-/SK-Mitgliedschaft (z. B. die Bereichsleitung oder Organisationsleitung) kann trotzdem einen Einsatz anlegen. Statt einer Ablehnung entsteht ein Einsatz ohne verantwortliche Einheit („Keine"), der weiterhin über den Ersteller zurechenbar bleibt:
- nicht intern → für jedes Mitglied der Organisation sichtbar,
- intern → nur für die eigene Einheit.
Bearbeiten dürfen die üblichen Verwalter (Besitzer, Co-Manager, Einsatz-Manager/Offizier) — ohne Einschränkung auf eine Staffel.
Einsatz-Status
GEPLANT → AKTIV → ABGESCHLOSSEN (oder ABGEBROCHEN). Den Status setzt du über „Bearbeiten" im Abschnitt „Einsatz" — die vier Werte stehen dort als Auswahlleiste nebeneinander. Sobald ein Einsatz tatsächliche Start-/Endzeiten hat, werden die Teilnahme-Anteile (für Auszahlungen) endgültig.
Einsatz-Detail
Klick auf einen Einsatz → Detailansicht. Oben steht der Seitenkopf: der Zurück-Link „← Einsätze", der Name, das Badge der Org-Einheit und der Status. Rechts daneben „Bearbeiten" (nur wenn du den Einsatz verwalten darfst) und „Anmelden". Darunter eine Faktenleiste mit Icon-Angaben (TS-Treffen, Server-Join, Ende, der Treffpunkt, falls gesetzt, der Leiter und Teilnehmer mit eingeklapptem „eingecheckt"-Zähler); die Zeiten erscheinen dort nur als Uhrzeit, das volle Datum steht in der Übersicht.
Darunter folgen drei Tabs: Übersicht, Teilnehmer & Einheiten und Finanzen & Auszahlung. Der aktive Tab steht in der Adresse — Links auf einen bestimmten Tab und der Zurück-Button des Browsers funktionieren also direkt. Einen Tab „Verwaltung" gibt es nicht mehr: Bearbeitet wird über „Bearbeiten" im Seitenkopf (siehe Bearbeiten).
Unter „Leiter" steht der Einsatzleiter, also der Teilnehmer mit der als Einsatzleiter markierten Rolle. Ist keiner eingetragen, steht dort der Besitzer des Einsatzes. (Bis zum Update vom 23.09.2026 stand dort wegen eines Fehlers immer der Besitzer.)
Übersicht
Schreibgeschützter Einstiegs-Tab, in kompakte Karten aufgeteilt: links Ziele, Ablauf, Teilnehmer-Fortschritt und Kalender, rechts Mission auf einen Blick, Weitere Leads und Funk — dazu das Briefing (die Beschreibung, formatiert) und dein persönlicher Teilnahme-Status. Die Detaillierte Beschreibung ist standardmäßig aufgeklappt, sodass das Briefing ohne Klick sichtbar ist.
- Ziele: Die Ziele eines Einsatzes werden im Bearbeiten-Modus als einzelne Punkte gepflegt und als Hauptziel, Nebenziel oder Nicht-Ziel klassifiziert; in der Übersicht erscheinen sie gruppiert in der Ziele-Karte. Sind keine Ziele hinterlegt, wird die Karte ganz ausgeblendet — sie taucht wieder auf, sobald das erste Ziel angelegt ist.
- Ablauf-Checkliste: Der Einsatz hat einen sortierbaren Ablauf aus Schritten (Titel und optional Zeit/Ort), den Bearbeiter im Bearbeiten-Modus pflegen. In der Übersicht erscheint er als Checkliste; die aktuelle Phase ist der erste noch offene Schritt. Bearbeiter setzen die Häkchen live für alle — der Fortschritt aktualisiert sich auf allen geöffneten Einsatz-Seiten ohne Neuladen. Sind keine Schritte hinterlegt, wird die Ablauf-Karte ausgeblendet; sie erscheint wieder, sobald der erste Schritt angelegt ist.
- Funk-Karte: Neben den zentralen, einheitslosen Frequenzen listet die Karte zusätzlich die Frequenz jeder Einheit, die eine hat (mit „Einheit"-Hinweis). Leere Einträge werden ausgeblendet — zentrale Frequenztypen ohne hinterlegten Wert und Einheiten ohne Frequenz erscheinen nicht; ist gar nichts eingetragen, verschwindet die Karte. Sie aktualisiert sich beim Setzen einer Frequenz oder beim Bearbeiten einer Einheit ohne Neuladen.
- Mission auf einen Blick: zeigt auch den Einsatzleiter — direkt über dem Partyleiter und nach derselben Logik wie das „Leiter"-Feld in der Faktenleiste (der Teilnehmer mit der zugewiesenen Einsatzleiter-Aufgabe, ersatzweise der Besitzer).
Teilnehmer & Einheiten
Das Crew-Board: Mitglieder melden sich hier an und werden Einheiten zugeordnet. Personen ohne Konto kann jedes Mitglied, das den Einsatz sieht, als externen Teilnehmer eintragen; eine Selbstanmeldung ohne Konto gibt es nicht.
- Mitgliedersuche: Beim Eintragen eines Mitglieds als Teilnehmer und beim Partyleiter zeigt die Suche höchstens 50 Treffer. Gibt es mehr, erscheint „Weiter tippen, um die Liste einzugrenzen…" — dann den Suchbegriff verfeinern.
- Anmeldung: Für Mitglieder werden die Org-Einheiten automatisch aus den Mitgliedschaften abgeleitet — die Auswahl entfällt. Wer einen externen Teilnehmer einträgt (freier Name, kein Konto), wählt dessen Org-Einheit(en) selbst; die Zeile eines anderen ändern oder entfernen darf danach nur, wer den Einsatz verwaltet. Im Bearbeiten-Dialog erscheint die Org-Einheiten-Auswahl deshalb nur bei externen Zeilen; bei Mitgliedern werden alle ihre Einheiten aus dem Account schreibgeschützt angezeigt.
- Je Teilnehmer: Aufgabenwunsch und vom Manager zugewiesener Job, zugeordnete Einheit (Schiff), Check-In/Check-Out (nur während der Einsatz läuft), errechneter Teilnahme-Anteil (%) und die Auszahlungsart (
AuszahlenoderSpenden). - Bemerkung (Kommentar): Beim Anmelden und im Bearbeiten-Dialog lässt sich je Teilnehmer eine freie Bemerkung eintragen. Sie erscheint an der Crew-Zeile als kleine Notiz-Markierung (Stift-Symbol); der Text steht im Tooltip, wenn du darauf zeigst. Sie ist für jedes Mitglied sichtbar, das den Einsatz sehen darf.
- Funktion an Bord: Drei Felder sind hier streng getrennt: der Aufgabenwunsch (was sich die Person wünscht), der vom Manager zugewiesene Job und die Funktion an Bord. Letztere setzt du als Bearbeiter direkt auf dem Crew-Board über einen Schnellauswahl-Chip an der Einheiten-Zeile — eine Funktion ist mit einem Klick gewählt. Über den Eintrag „Funktionen bearbeiten…" öffnet sich ein Dialog mit Mehrfachauswahl, falls eine Person an Bord mehrere Funktionen übernimmt (z. B. Pilot und Gunner); sind mehrere gesetzt, zeigt der Chip sie als zusammengefasste Liste.
- Auszahlungsart-Vorbelegung: Beim Anmelden ist die Auszahlungsart aus deiner Profil-Einstellung „Standard-Auszahlungsart" (im Profil gesetzt) vorbelegt — pro Einsatz aber weiter frei änderbar. Wer nie etwas einstellt, wird wie bisher als
Auszahlenangemeldet; eine spätere Änderung der Profil-Vorgabe wirkt nur vorwärts und ändert bestehende Teilnahmen nicht. Externe Teilnehmer haben kein Profil und werden immer alsAuszahleneingetragen. - Zuordnung zu einer Einheit läuft per Drag & Drop (am Handy und Tablet auch mit dem Finger), per Klick (Person wählen → Ziel klicken) oder per Tastatur; Ablegen im Pool „Ohne Einheit" hebt die Zuordnung auf. Zieht man einen Teilnehmer aus einer Einheit und lässt ihn im leeren Bereich (über keiner anderen Einheit) los, wird er ebenfalls aus der Einheit entfernt und wieder unter „Ohne Einheit" geführt — man muss bei langen Listen nicht bis zum Pool scrollen. Während des Ziehens scrollt die Seite automatisch, sobald man den oberen oder unteren Fensterrand erreicht, sodass auch gerade nicht sichtbare Einheiten als Ziel erreichbar sind.
- Gelöschte Konten: Wird ein Mitglied endgültig gelöscht, bleibt seine Teilnehmerzeile im Einsatz bestehen und wird als „Gelöschter Nutzer“ ausgewiesen — die Historie des Einsatzes bleibt damit vollständig. Solche Zeilen sind nicht extern: sie tragen kein „Extern"-Kennzeichen und lassen sich nur noch von Einsatzberechtigten bearbeiten.
- Versuchst du dich doppelt einzutragen, bekommst du eine klare Fehlermeldung.
- Einheiten = Schiffe im Einsatz: Anzeigename (Pflichtfeld, mit
*markiert — das einzige Pflichtfeld der Einheit), Schiffstyp/Schiff (optional), Verantwortlicher, High Value Unit-Marker, Frequenz und Notiz. Das Schiff-Dropdown bietet nur Schiffe an, deren Besitzer als Teilnehmer eingetragen ist (auch aus anderen Org-Einheiten); ein zugewiesenes Schiff bleibt erhalten, selbst wenn sein Besitzer den Einsatz verlässt.
Finanzen & Auszahlung
Oben stehen vier Kennzahlen: Gesamtergebnis, Einnahmen, Ausgaben (inklusive Raffinerie) und Je Anteil — was bei Gleichverteilung auf die angemeldeten Teilnehmer auf jeden käme. Darunter zwei Listen: Finanzen mit den Einnahmen/Ausgaben je Nutzer samt Notiz (oben rechts in dieser Karte der Knopf „Finanzeintrag hinzufügen") und Auszahlung mit Teilnahme-Anteil und Auszahlungsart je Teilnehmer. Ist eine Liste leer, steht dort ein kurzer Hinweis („Noch keine Finanzeinträge" bzw. „Noch keine Teilnehmer"). Verknüpfte Raffinerieaufträge und Lagereinträge folgen darunter als aufklappbare Abschnitte. Das Finanz-Ledger sieht jedes Mitglied, das den Einsatz sehen darf. Anlegen darf die Einsatzleitung (Owner, Co-Manager, Einsatzmanager und Offiziere der besitzenden Org-Einheit) für jeden Beteiligten — jedes andere Mitglied nur einen Eintrag auf den eigenen Namen und nur, solange es am Einsatz angemeldet ist. Einen Einsatz nur sehen zu dürfen genügt also nicht mehr zum Buchen. Bearbeiten/löschen darf nur der eigene Eintrag bzw. ein Offizier. Verknüpfte Raffinerieaufträge erscheinen automatisch als Ausgabe.
Bearbeiten
Der Knopf „Bearbeiten" im Seitenkopf ist nur da, wenn du den Einsatz verwalten darfst. Er öffnet den Bearbeiten-Modus „Einsatz bearbeiten" anstelle der Tabs; „Fertig" oder ein Klick auf einen Tab bringt dich zurück. Hast du ungespeicherte Eingaben, fragt die App vorher nach. (Alte Links mit ?tab=verw öffnen weiterhin den Bearbeiten-Modus.)
Links steht das Stammdaten-Formular in drei Abschnitten — 1 · Einsatz (Name, Status, Operation, Treffpunkt, Beschreibung, Kalender-Link), 2 · Zeitplan (Treffen Teamspeak, geplanter und tatsächlicher Start/Ende) und 3 · Sichtbarkeit (Intern) — mit „Änderungen speichern" in einer Leiste, die beim Scrollen unten stehen bleibt. Rechts stehen die Karten Ziele, Ablauf, Organisation (Partyleiter, Frequenzen) und Verwaltungsrechte (Owner & Co-Manager, Verantwortliche Einheit). Wer nur Co-Manager verwalten darf, sieht das Stammdaten-Formular gesperrt.
- Ablauf — die sortierbare Schrittliste (Titel und optional Zeit/Ort). Hier legst du Schritte an, sortierst sie um und entfernst sie; in der Übersicht erscheinen sie als Checkliste, deren Häkchen du live für alle setzt.
- Co-Manager — weitere Nutzer, die den Einsatz mitverwalten dürfen.
- Besitzer — Owner des Einsatzes (Standard: der Ersteller); übertragbar.
- Verantwortliche Einheit — die Org-Einheit (Staffel/SK/Bereich/OL), der der Einsatz zugeordnet ist, lässt sich hier nachträglich ändern oder auf Keine (herrenloser Leitungs-Einsatz) setzen. Die Auswahl bietet die dir zuweisbaren Einheiten; die Sichtbarkeit des Einsatzes richtet sich danach neu aus (siehe „Wer darf was?"), und die Änderung wird im Aktivitätsprotokoll erfasst. Wer den Besitzer wechseln darf, darf auch die Einheit ändern (zuständiger Offizier oder der Einsatz-Besitzer); zuweisen kannst du nur auf Einheiten, denen du angehörst oder die du verwaltest. Co-Manager können sie nicht ändern.
- Partyleiter — ein bestehendes Mitglied oder ein freier Name (eine Person ohne Konto). Eindeutige Eingaben werden auf das Mitglied aufgelöst, unbekannte bleiben Freitext.
- Tatsächlicher Start / tatsächliches Ende — neben den geplanten Zeiten trägst du im Stammdaten-Formular die tatsächlichen Start- und Endzeiten ein. Je Feld gibt es einen „Jetzt"-Knopf, der die aktuelle Uhrzeit übernimmt (er wird sofort gespeichert). Sobald ein tatsächlicher Start gesetzt ist, schaltet sich auf dem Crew-Board das Ein-/Auschecken frei; mit gesetztem tatsächlichem Ende werden die Teilnahme-Anteile für die Auszahlung endgültig.
Mehrere Einsätze klammert man über eine Operation — dort läuft auch die gemeinsame Auszahlung.
Live-Aktualisierung
Änderungen anderer Nutzer an einem Einsatz erscheinen live, ohne die Seite neu zu laden. Tritt jemand bei, wird die Crew umgestellt, ein Finanzeintrag erfasst oder eine Kern-/Termin-/Status-/Einsatzleiter-/Funk-/Ablauf-Änderung gemacht, aktualisiert sich die Ansicht auf allen anderen geöffneten Einsatz-Seiten automatisch. Bearbeitest du selbst gerade etwas (Dialog offen), wird die Aktualisierung über einen „Aktualisierungen verfügbar"-Hinweis aufgeschoben statt aufgedrängt.
Wer bearbeitet gerade? Bearbeitet jemand anderes gerade einen Abschnitt desselben Einsatzes, zeigt die Abschnittsüberschrift einen kleinen pulsierenden Hinweis „Wird gerade bearbeitet von …" mit dem Namen. Das ist nur ein Hinweis — nichts wird gesperrt, und du kannst trotzdem speichern.
Was Mitglieder voneinander sehen
Ein Mitglied unterhalb der Rolle „Logistiker" sieht den Einsatz mit bereinigten Personendaten:
- Entfernt: von allen Teilnehmern und Schiffsbesitzern alles außer dem Callsign (Benutzername, Anzeigename, Rang) — also z. B. E-Mail, Beschreibung, Rollen und Mitgliedschaften. Ebenfalls entfernt: Besitzer und Co-Manager — es sei denn, du darfst den Einsatz selbst verwalten.
- Sichtbar bleiben: Organisation, Teilnehmerliste, Einheiten und Schiff-Zuweisung, Funkfrequenzen, Ablauf, Ziele, Treffpunkt, dazu Name, Beschreibung, Zeitplan, Status, Kalenderlink, Teilnehmerzähler, Partyleiter — und die Auszahlungsart und Bemerkung der Teilnehmer.
- Welche Einsätze du überhaupt siehst, entscheidet die Einheit: die eigene komplett, fremde nur mit ihren organisationsweiten (nicht internen) Einsätzen.
Einsätze der nächsten 7 Tage (Startseite)
Auf der Startseite erscheinen alle Einsätze mit geplantem Start in den nächsten 7 Tagen in der Liste „Nächste 7 Tage" — der nächstgelegene Start zuerst, danach aufsteigend.
- Was angezeigt wird: Einsätze deiner eigenen Org-Einheit(en) — intern und organisationsweit — sowie alle organisationsweiten Einsätze anderer Einheiten. Interne Einsätze fremder Einheiten bleiben verborgen.
- Eigene Einheit hervorgehoben: Gehört die verantwortliche Einheit eines Einsatzes zu einer Einheit, der du direkt zugeordnet bist — Staffel, Spezialkommando, Bereich oder Organisationsleitung —, trägt die Zeile die Markierung „Meine Einheit". Die Kaskade der Führungsebenen zählt hier nicht: untergeordnete Einheiten einer Bereichs- oder OL-Leitung werden nicht automatisch markiert.
- Deine Anmeldungen markiert: Hast du dich für einen Einsatz angemeldet, trägt seine Zeile unter dem Status die Markierung „Angemeldet".
Jede Zeile zeigt links das Datum (Wochentag, Tag, Monat), dann Name, Treffen Teamspeak, Serverjoin, optional Treffpunkt und die verantwortliche Einheit, rechts den Status. Die ganze Zeile ist der Link zum Einsatz; einen eigenen Knopf je Einsatz gibt es nicht. „Alle Einsätze →" führt zur Liste.
Abgeschlossene/abgebrochene Einsätze tauchen nie auf, auch nicht mit Zukunfts-Startzeit. Steht in den nächsten 7 Tagen nichts an, zeigt der Bereich einen entsprechenden Hinweis.
Benachrichtigungen zum Einsatz
Das Tool meldet sich, wenn ein Einsatz dich betrifft — du kannst jede Art unter Profil → Benachrichtigungen abbestellen (siehe Benachrichtigungen):
- Verschoben, abgesagt, gelöscht: Teilnehmer erfahren es, wenn Treffzeit oder geplanter Start sich ändern, der Einsatz abgesagt oder gelöscht wird. Es bleibt immer nur die letzte Änderung stehen.
- Erinnerung: 24 Stunden und eine Stunde vor dem Treffen, mit Zeit, Treffpunkt und deiner geplanten Funktion.
- Check-in offen: Sobald der Einsatz auf „Aktiv“ geht, bekommen alle, die noch nicht eingecheckt sind, den Hinweis — ein später Check-in verringert deinen Auszahlungsanteil.
- Hinzugefügt / entfernt: Wer jemand anderen einträgt oder entfernt, benachrichtigt ihn.
- Verantwortung: Wirst du Besitzer, Co-Manager, Partyleiter oder Verantwortlicher einer Einheit, erfährst du es.
- Für die Einsatzleitung: Springt ein Teilnehmer mit Platz oder Funktion ab, oder ein Einsatz wird nie beendet, melden sich Besitzer und Co-Manager.
Wer darf was?
| Aktion | Mitglied | Einsatz-Manager | Offizier |
|---|---|---|---|
| Einsätze in Reichweite ansehen (Personendaten bereinigt) | x | x | x |
| Selbst beitreten / ein-/auschecken | x | x | x |
| Eigene Auszahlungsart wählen | x | x | x |
| Externen Teilnehmer eintragen | x | x | x |
| Fremde Teilnehmerzeile ändern oder entfernen | x | x | |
| Finanz-Ledger sehen | x | x | x |
| Finanz-Eintrag anlegen | x² | x³ | x³ |
| Eigenen Einsatz anlegen & verwalten | x | x | x |
| Fremde Einsätze der eigenen Org-Einheit verwalten | x | x | |
| Besitzer oder Verantwortliche Einheit ändern | x¹ | x¹ | x |
¹ Nur am eigenen Einsatz (als Besitzer). Offiziere dürfen es auch ohne Besitz, im eigenen Org-Einheit-Scope. Zuweisen lässt sich nur auf Einheiten, denen man angehört oder die man verwaltet. Co-Manager können den Besitzer/die Einheit nicht ändern.
² Nur auf den eigenen Namen und nur, solange man am Einsatz angemeldet ist.
³ Für jeden Beteiligten, aber nur an Einsätzen der eigenen Org-Einheit (bzw. als Besitzer oder Co-Manager des Einsatzes). Einen fremden Einsatz nur sehen zu dürfen, genügt zum Buchen nicht.
Einsatz-Manager/Offiziere verwalten Einsätze im eigenen Org-Einheit-Scope; Owner/Co-Manager verwalten ihren eigenen Einsatz unabhängig davon. Die vollständige, maßgebliche Rechte-Matrix steht in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.
Mehr zu Rollen und Berechtigungen: Rollen-und-Berechtigungen.