Befoerderungssystem - krt-profit/basetool GitHub Wiki

Beförderungssystem

Sidebar-Gruppe „Beförderung" — das Bewertungs- und Beförderungssystem der Staffel. Es zeigt, welche fachlichen Schwerpunkte („Themenbereiche") welche Stufen-Anforderungen pro Rang haben — und wie weit du selbst auf jeder Skala bist.

Nur Staffeln: Das Beförderungssystem gibt es ausschließlich für Staffeln. Spezialkommandos sind dauerhaft ausgeschlossen.

Pro Staffel ab-/zuschaltbar: Das Feature kann je Staffel deaktiviert sein. Ist es für deine Staffel aus, fehlt die Gruppe Beförderung in der Sidebar.

Streng staffel-bezogen

Das gesamte Beförderungssystem ist durchgängig staffelbezogen: jede Staffel führt ihr eigenes System (Themenbereiche, Kategorien, Level-Inhalte, Rangvoraussetzungen, Bewertungen) und sieht ausschließlich die eigenen Daten. Es gibt keine staffelübergreifende Vermischung.

  • Mitglied/Offizier sehen nur das System ihrer eigenen Staffel(n). Wer zwei Staffeln angehört, sieht beide; welche dabei als aktive Staffel gilt (für Anzeige und automatische Zuweisung), folgt der Auswahl „Aktive Org-Einheit" in der Sidebar, sonst der alphabetisch ersten Staffel.
  • Ein Nutzer ohne Staffelzugehörigkeit hat kein eigenes Beförderungssystem: die Gruppe ist ausgeblendet, und ein direkter Seitenaufruf wird abgewiesen.

Konzept

Das System hat drei Achsen:

  1. Themenbereiche — fachliche Schwerpunkte (z. B. „Bergbau", „Combat", „Logistik").
  2. Kategorien innerhalb eines Themenbereichs — Unterbereiche mit feinerer Granularität.
  3. Stufen / Levels — pro Kategorie definierte Kompetenz-Stufen mit Beschreibung.

Über die Rangvoraussetzungen wird pro Rang festgelegt, welche Mindeststufe je Kategorie erwartet wird.

Was du als Mitglied siehst

Beförderungssystem

Die Seite „Beförderungssystem" hat zwei Karten:

  • Rangvoraussetzungen — der Weg durch die Ränge als Schrittfolge, vom niedrigsten Rang aufwärts. Jeder Schritt ist ein Rangsprung (z. B. „Rang 20 → 19") und listet seine Voraussetzungen: Kategorie (bzw. Themenbereich oder „Alle Themen" bei einer globalen Regel), die geforderte Mindeststufe und die Anzahl passender Bewertungen (z. B. „2×"). Steht dein Rang fest, ist dein aktueller Schritt mit „Du bist hier" markiert, die Schritte darunter mit „Erreicht"; oben rechts steht „Dein Rang: …".
  • Bewertungskategorien — die offizielle Definition aller Themenbereiche, Kategorien und Stufen deiner Staffel.

Meine Bewertungen

Ganz oben steht die Karte „Fortschritt zum nächsten Rang" für deinen nächsten Rangsprung:

  • ein Status: Beförderbar (grün — alle Voraussetzungen erfüllt), Voraussetzungen offen (orange) oder Keine Regeln definiert (grau — für diesen Sprung gibt es noch keine Rangvoraussetzungen);
  • vier Kennzahlen: Dein Rang, Nächster Rang, Voraussetzungen erfüllt (z. B. „2 / 3") und Fortschritt in Prozent, dazu ein Fortschrittsbalken. Gezählt wird je Voraussetzung höchstens die geforderte Anzahl — wer eine Voraussetzung übererfüllt, gleicht damit keine andere aus.

Ist für deinen Rang kein nächster Sprung hinterlegt, sagt die Karte das.

Darunter die Tabelle Voraussetzungen, gruppiert nach Rangsprung — dein nächster Sprung steht oben und ist mit „Dein nächster Sprung" markiert. Jede Gruppe zeigt ihren Status und „x / y erfüllt"; jede Zeile die Voraussetzung, die geforderte Mindeststufe, deine Stufe und Erfüllt (deine erreichte Anzahl im Verhältnis zur geforderten, z. B. 1 / 3).

Mit der Auswahl „Alle · Offen" über der Tabelle blendest du bei „Offen" erfüllte Voraussetzungen aus und siehst nur noch das, woran du arbeiten musst; ist nichts mehr offen, steht dort „Alles erfüllt". Die Auswahl wird pro Browser gemerkt.

Ganz unten folgt Meine Stufen je Kategorie mit deiner Stufe je Kategorie:

  • Orange eingefärbte Stufe = deine Stufe liegt unter der höchsten Mindeststufe, die eine Rangvoraussetzung für diese Kategorie verlangt (daneben „max. benötigt: …"). Das markiert eine Lücke, an der du arbeiten kannst.
  • „Keine Stufe" (grau) = noch keine Bewertung gesetzt.

Was Offiziere zusätzlich sehen (in der Sidebar)

  • Bewertungsverwaltung — Mitglieder bewerten / Stufen setzen. Die Bewertungsmatrix führt ausschließlich die einfachen Mitglieder einer Staffel: Offiziere werden ausgeblendet, weil sie die Bewertung durchführen und nicht selbst bewertet werden.
    • Suche — ein Suchfeld („Mitglieder nach Name filtern…") filtert die Liste nach Mitgliedsname.
    • Filter — die Schalter Nur Beförderbare und Nur ohne Bewertung grenzen die Liste auf die Mitglieder ein, die gerade interessant sind. Suche und Filter wirken zusammen. Filter, Sortierung und der Auf-/Zuklapp-Zustand werden pro Browser gemerkt und bleiben auch über das Schließen des Browsers hinaus erhalten (die Suche startet bewusst leer).
    • Sortierung — ein Klick auf die Spaltenüberschrift Mitglied schaltet die Reihenfolge durch: Original → Name A–Z → Name Z–A → Rang aufsteigend → Rang absteigend.
    • „Alle ausklappen" / „Alle einklappen" — klappt alle Mitglieds-Zeilen auf einmal auf oder zu.
    • Bulk-Bearbeitung — über die Auswahl-Kästchen markierst du mehrere Mitglieder, wählst im eingeblendeten Bereich eine Kategorie und eine Stufe und setzt sie mit „Auf Auswahl anwenden" in einem Schritt für alle ausgewählten Mitglieder. Vor dem Speichern erscheint eine Rückfrage; „Auswahl aufheben" verwirft die Markierung wieder.
    • „CSV-Export" — exportiert die aktuelle Mitgliederliste (Name, Rang, Beförderbarkeit, zuletzt bewertet) als CSV-Datei zum Weiterverarbeiten.
  • Themenbereiche (Seite „Themenbereiche verwalten") — Themenbereiche, Kategorien und Stufen pflegen. Links steht die Liste der Themenbereiche (mit der Zahl ihrer Kategorien), rechts der ausgewählte Themenbereich. Ein Klick auf einen Eintrag links — oder die Pfeiltasten — wählt ihn aus; die Auswahl steht in der Adresse, ein Link führt also direkt zu diesem Themenbereich. „Neuer Themenbereich" steht oben rechts.
    • Im ausgewählten Themenbereich — Bearbeiten (Stift) und Löschen (Papierkorb) des Themenbereichs, „Neue Kategorie" und darunter seine Kategorien, jede mit eigenem Bearbeiten und Löschen.
    • Reihenfolge ändern — Themenbereiche und Kategorien lassen sich über Pfeil-Schaltflächen (hoch/runter) umsortieren; die Reihenfolge bestimmt, wie sie auf allen Seiten erscheinen.
    • Stufeninhalte bearbeiten — je Kategorie pflegst du direkt in Textfeldern die Beschreibung für Stufe A, B und C. Geänderte Felder werden als ungespeichert markiert und einzeln gespeichert — oder alle auf einmal über „Alle speichern" in der Leiste, die bei ungespeicherten Änderungen erscheint („Verwerfen" nimmt sie zurück).
  • Rangvoraussetzungen (Seite „Rangvoraussetzungen verwalten") — pro Rang die geforderte Mindeststufe je Kategorie definieren.
    • Übersicht „Rangsprung × Themenbereich" — eine Tabelle mit einer Zeile je Rangsprung und einer Spalte für „Alle Themen" und je Themenbereich. Ein gefülltes Feld zeigt die höchste geforderte Mindeststufe (A, B oder C); ein Klick darauf springt zu den passenden Voraussetzungen weiter unten und hebt sie hervor. Ein Klick auf ein leeres Feld öffnet „Neue Anforderung" mit Rangsprung und Themenbereich schon vorausgefüllt.
    • Suche — das Suchfeld filtert die Voraussetzungen nach Rang, Themenbereich, Kategorie oder Beschreibung.
    • Darunter steht je Rangsprung eine Karte mit seinen Voraussetzungen zum Bearbeiten und Löschen.
    • Anwendungsbereich — beim Anlegen/Bearbeiten legst du fest, worauf die Regel zielt: beide Felder leer = globale Regel; nur Themenbereich = gilt für den ganzen Themenbereich; Themenbereich + Kategorie = gilt nur für diese eine Kategorie.
    • Anzahl — gibt an, wie viele Bewertungen, die die geforderte Mindeststufe erreichen, im gewählten Anwendungsbereich vorliegen müssen, damit die Voraussetzung erfüllt ist (z. B. „2" = zwei passende Bewertungen nötig). Diese Anzahl steht in der Spalte Anzahl und taucht auf „Meine Bewertungen" als erreicht / gefordert in der Spalte Erfüllt wieder auf.
    • Alle löschen — der Papierkorb im Kopf einer Rangsprung-Karte entfernt mit einem Schritt sämtliche Voraussetzungen dieses Rangsprungs (Gruppen-Löschung), nach Rückfrage.

Offiziere pflegen die Einträge und Bewertungen ihrer eigenen Staffel(n) (staffel-gescopt). Gehört ein Offizier zwei Staffeln an, muss er vor dem Anlegen eines Themenbereichs oder einer Rangvoraussetzung zuerst die Ziel-Staffel unter „Aktive Org-Einheit" wählen, damit der neue Eintrag der richtigen Staffel zugeordnet wird.

Wer darf was?

Aktion Mitglied Offizier
Eigene Bewertungen sehen (eigene Staffel) x x
Beförderungssystem ansehen (eigene Staffel) x x
Mitglieder bewerten (eigene Staffel) x
Bewertungen anderer ansehen, Mitglieder-Liste (eigene Staffel) x
Themenbereiche / Rangvoraussetzungen pflegen (eigene Staffel) x

Mitglied = KRT-Mitglied; Logistiker-/Einsatz-Manager-Flags geben hier keine Zusatzrechte. Offiziere wirken nur auf ihre eigene Staffel.

Die maßgebliche Rechte-Matrix steht in Rollen und Berechtigungen sowie in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.

Hinweise

  • Alle Änderungen werden protokolliert. Anlegen, Bearbeiten und Löschen von Themenbereichen, Kategorien, Stufen-Inhalten und Rangvoraussetzungen sowie das Setzen und Entfernen von Bewertungen werden protokolliert.
  • Bei parallelen Änderungen kann ein Speichern mit dem Hinweis „Konflikt: Jemand war schneller" scheitern — lade über „Aktuelle Werte laden" den aktuellen Stand und übernimm deine Änderung erneut.
  • Mehr zur aktiven Org-Einheit und zur Org-Struktur: Organisation.