Operationen - krt-profit/basetool GitHub Wiki

Operationen

Sidebar → Einsatzplanung → Operationen — Operationen sind die Klammer über mehrere Einsätze (z. B. eine Kampagne, ein Verteidigungseinsatz, eine Industrie-Initiative) und der Ort für die gemeinsame Abrechnung: Profit-Verteilung und Auszahlungen laufen auf Operations-Ebene.

Eine Operation gehört einer Org-Einheit (Staffel oder Spezialkommando) — wer welche Operation sieht, klärt der Abschnitt Sichtbarkeit. Die aktive Org-Einheit schaltest du in der Sidebar unter „Aktive Org-Einheit" um; sie steht im Anwendungstitel (Kopfzeile + Browser-Tab).

Liste

Die Liste zeigt eine Tabelle mit Name, Status, Beschreibung (auf Smartphones ausgeblendet) und Aktionen.

Filtern

Suche — Freitext über den Operationsnamen, immer sichtbar.
Von / Bis — Datumsbereich; gerechnet wird über die verknüpften Einsätze (Operationen selbst haben keine eigene Startzeit): „Von" begrenzt den geplanten Start des frühesten, „Bis" das geplante Ende des spätesten verknüpften Einsatzes.
Kommend · Vergangen · Alle — „Kommend" (Standard) zeigt geplante und aktive, „Vergangen" abgeschlossene und abgebrochene Operationen. Die Auswahl wird pro Browser gemerkt; Suche und Datumsbereich (hinter dem Knopf „Filter") starten bewusst frisch.

Die Liste aktualisiert sich ohne Neuladen der Seite.

Operation anlegen / bearbeiten

„Operation anlegen" und bearbeiten dürfen Einsatz-Manager und Offiziere. KRT-Mitglieder können Operationen ansehen, aber nicht selbst anlegen oder ändern. Beim Anlegen/Bearbeiten setzt du Name, Status und Beschreibung; bearbeitet wird auf der Detailseite über „Bearbeiten" (siehe Bearbeiten).

Operation ohne Org-Einheit (Bereichsleitung). Eine Leitung ohne Staffel-/SK-Mitgliedschaft kann eine Operation ohne Org-Einheit anlegen. Sie ist für alle Mitglieder sichtbar. Bearbeiten darf sie jeder Einsatz-Manager.

Operation-Detail

Oben steht der Seitenkopf: der Zurück-Link „← Operationen", der Name und der Status (GEPLANT / AKTIV / ABGESCHLOSSEN / ABGEBROCHEN). Wer Operationen bearbeiten darf, findet rechts daneben „Bearbeiten".

Darunter vier Kennzahlen: Einsätze, Gesamtergebnis, Davon gespendet (Beträge in aUEC mit Tausenderpunkt; ein negatives Ergebnis steht in Rot) und Teilnehmende. Dann folgen vier Tabs: Übersicht, Einsätze, Auszahlung und Finanzen. Einen Tab „Verwaltung" gibt es nicht mehr.

Übersicht

Ergebnis je Einsatz zeigt für jeden verknüpften Einsatz seinen Namen, einen Balken und sein Ergebnis als Zahl. Die Balkenlänge misst sich am größten Einsatz-Ergebnis, sodass du auf einen Blick siehst, welcher Einsatz wie viel beigetragen hat; negative Ergebnisse werden rot ausgewiesen. Ein Klick auf die Zeile öffnet den Einsatz.

Daneben die Karte Auszahlung: wie viele Teilnehmende schon ausgezahlt sind („2 / 5 Teilnehmende ausgezahlt") mit Fortschrittsbalken, der noch offene Betrag, der Spenden-Wunsch (wie viele Personen spenden möchten) und der Knopf „Zur Auszahlung", der in den Auszahlung-Tab springt.

Die Beschreibung steht darunter, nur lesend, hinter dem Aufklapper „Detaillierte Beschreibung anzeigen" (formatiert dargestellt).

Einsätze

Seitenweise Liste der zur Operation gehörenden Einsätze mit Status und geplantem Start; ein Klick auf die Zeile öffnet den Einsatz. Ein Einsatz gehört höchstens zu einer Operation; eine Operation kann beliebig viele Einsätze klammern — zugeordnet wird ein Einsatz in seinem eigenen Bearbeiten-Modus. Über „Einsatz hinzufügen" öffnet sich die Einsatz-Erstellseite mit dieser Operation bereits vorausgewählt.

Auszahlung

Die zentrale Abrechnungstabelle. Pro Teilnehmer:

Anteil — aus der (tatsächlichen) Teilnahmezeit über alle Einsätze der Operation.
Auszahlungsart — Auszahlen oder Spenden (vom Teilnehmer gewählt), als Markierung.
Auszahlungsbetrag — errechnet aus Anteil × Operations-Profit; mit Unterzeilen für „davon Auslagen" (erstattete persönliche Ausgaben) und die „bereits abgezogene Überweisungsgebühr".
Bezahlt — Häkchen, das die erfolgte Auszahlung protokolliert (mit „bezahlt von" und Zeitstempel).
Gelöschte Konten: Ein zwischenzeitlich endgültig gelöschtes Mitglied bleibt mit seinem Anteil in der Tabelle und erscheint als „Gelöschter Nutzer“. Eine bereits abgerechnete Operation verändert sich dadurch nicht — weder die Prozente noch die Beträge der übrigen Teilnehmer verschieben sich, und seine Auslagen bleiben ihm zugerechnet.

Die letzte Zeile „Summe" zeigt den gesamten Auszahlungsbetrag, darunter „Spenden gesamt", und wie viele schon bezahlt sind; sie bleibt beim Scrollen am unteren Rand stehen. Gibt es noch keine Teilnehmenden, steht dort „Keine Teilnehmenden".

Vorläufige Werte: Solange nicht alle verknüpften Einsätze eine tatsächliche Start- und Endzeit haben, sind die Anteile vorläufig — ein Hinweis über der Tabelle sagt das.

Asymmetrie beim „Bezahlt"-Status: Jeder Einsatz-Manager darf eine Auszahlung als bezahlt markieren — aber ein bestätigtes „bezahlt" wieder zurückzunehmen dürfen nur Offiziere. Das verhindert versehentliches Zurücksetzen.

Finanzen

Je verknüpftem Einsatz eine aufklappbare Zeile mit seinem Ergebnis; aufgeklappt zeigt sie dessen Einnahmen/Ausgaben, auch verknüpfte Raffinerieaufträge als Ausgabe. Die Summen (Gesamtergebnis, Davon gespendet) stehen in den Kennzahlen oben. Den Finanzen-Tab sieht nur, wer die Operation über die eigene Org-Einheit (oder als Leitungs-Operation ohne Org-Einheit) sieht — nicht, wer sie nur über eine Teilnahme sieht (siehe Sichtbarkeit).

Bearbeiten

„Bearbeiten" öffnet den Dialog „Operation bearbeiten" mit Name, Status und Beschreibung — für Einsatz-Manager und Offiziere. Die Beschreibung bearbeitest du mit einem Markdown-Editor: ein Eingabefeld mit einer Formatierungs-Leiste (Fett, Kursiv, Überschrift, Liste, Link) und zwei Umschaltern Bearbeiten / Vorschau. Die Vorschau entspricht exakt der Darstellung, wie sie später in der Übersicht erscheint. „Änderungen speichern" speichert ohne Neuladen und schließt den Dialog; schließt du ihn ohne zu speichern, werden deine Eingaben verworfen.

Live-Aktualisierung

Änderungen anderer Nutzer an einer Operation erscheinen live, ohne die Seite neu zu laden — genau wie auf der Einsatz-Seite. Speichert jemand die Kern-Daten (Name, Status, Beschreibung) oder markiert er eine Auszahlung als bezahlt (bzw. nimmt das zurück), aktualisiert sich die Ansicht auf allen anderen geöffneten Operations-Seiten automatisch — Seitenkopf, Kennzahlen und die Auszahlung-Karte eingeschlossen. Bearbeitest du selbst gerade etwas (Dialog offen), wird die Aktualisierung über einen „Aktualisierungen verfügbar"-Hinweis aufgeschoben statt aufgedrängt.

Sichtbarkeit (wer sieht eine Operation?)

Für Mitglieder gibt es drei Sichtbarkeitspfade — es genügt einer:

Eigene Org-Einheit — die normale Sicht: du siehst die Operationen deiner eigenen Org-Einheit(en).
Leitungs-Operation ohne Org-Einheit — eine Operation ohne Org-Einheit (von der Bereichsleitung angelegt) ist für alle Mitglieder sichtbar.
Teilnahme — wer an einem der verknüpften Einsätze teilgenommen hat, sieht die Operation und nur seine eigene Zeile der Auszahlung — auch staffelübergreifend. Diese Sicht ist reine Lese-Sicht: kein Bearbeiten, keine Finanzen, keine Auszahlungszeilen anderer.

Operation vs. Einsatz

Operation = strategische Klammer plus gemeinsame Finanzen/Auszahlung über mehrere Einsätze.
Einsatz = ein konkreter, planbarer Einsatz mit Teilnehmern, Schiffen und Zeitfenster (eigene Finanz-Einträge, die in die Operation einfließen).

Benachrichtigungen zur Operation

Auszahlung ausgezahlt: Wird deine Auszahlung als ausgezahlt markiert, erfährst du es — mit Betrag, Spende und Gebühr. Nimmt jemand die Markierung zurück, verschwindet die Meldung wieder.
Operation abgeschlossen: Schließt jemand die Operation ab, erfahren die Einsatzmanager und Offiziere der Einheit, dass die Auszahlung fällig ist, mit Gesamt- und offenem Betrag; die Meldung verschwindet mit der letzten Auszahlung. Siehe Benachrichtigungen.

Wer darf was?

Aktion	Mitglied	Einsatz-Manager	Offizier
Operationen ansehen (Liste/Detail/Finanzen/Auszahlung)¹	x	x	x
Operation anlegen / bearbeiten		x	x
Auszahlung als „bezahlt" markieren		x	x
„bezahlt" zurücknehmen			x

¹ Ansehen setzt zusätzlich einen der drei Sichtbarkeitspfade voraus; über den Teilnahme-Pfad gibt es keine Finanzen und nur die eigene Auszahlungszeile. Den vollständigen, verbindlichen Stand findest du in der Rollen- und Rechte-Matrix bzw. in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.

Hinweise

Parallele Bearbeitung: Jede Schreiboperation trägt eine Version mit. Hat jemand zwischenzeitlich dieselbe Operation geändert, erhältst du den Hinweis „Konflikt: Jemand war schneller" — lade über „Aktuelle Werte laden" den aktuellen Stand und wiederhole deine Änderung.
Zeiten werden in UTC gespeichert und in deiner lokalen Zeit angezeigt.