Erste Schritte - krt-profit/basetool GitHub Wiki

Erste Schritte

Anmeldung (SSO via Keycloak)

Die App hat kein eigenes Passwort-Login. Klick auf der Einstiegsseite oder in der Sidebar auf „Anmelden" — du landest auf der Keycloak-Anmeldeseite im KRT-Look und meldest dich dort mit deinem persönlichen Account an. Danach wirst du zurück auf die App geleitet.

  • Erste Anmeldung? Falls dein Account noch nicht in Keycloak liegt, wende dich an die Administration.
  • Freigabe nötig: Neu angelegte Accounts durchlaufen eine einmalige Freigabe durch die Administration und sehen bis dahin die Seite „Freigabe ausstehend". Das betrifft auch Discord-Anmeldungen; bestehende Accounts bleiben aktiv.
  • „Angemeldet bleiben" ist nicht vorausgewählt: Wer länger angemeldet bleiben möchte, setzt den Haken auf der Anmeldeseite selbst — auf gemeinsam genutzten Rechnern besser nicht. Dein Passwortmanager erkennt die Anmeldeseite und kann Benutzername und Passwort ausfüllen und speichern.
  • Session abgelaufen? Die App versucht einen stillen Re-Login (prompt=none). Wenn das fehlschlägt, siehst du wieder den Login-Screen — einfach erneut anmelden.
  • Höchstens zehn Sitzungen gleichzeitig: Pro Account darfst du auf bis zu zehn Geräten bzw. Browsern parallel angemeldet sein (z. B. Desktop, Handy und Tablet). Meldest du dich ein elftes Mal an, wird deine älteste Sitzung verdrängt — die neue Anmeldung wird also nie abgewiesen.
  • Verdächtige URLs (z. B. /wp-admin/) beantwortet die App direkt mit 404 — das ist Bot-Schutz und kein Defekt.

Anmeldung mit Discord

Zusätzlich zum Passwort-Login kannst du dich mit Discord anmelden — aber nur, wer im das-kartell-Discord ist und dort die Rolle „KRT-Mitglied" trägt. Auf der Einstiegsseite und in der Sidebar findest du dafür „Mit Discord anmelden" (auch auf der Keycloak-Anmeldeseite selbst gibt es einen Discord-Button). Hast du bereits einen Account und möchtest Discord nachträglich damit verbinden, läuft das über die Kontoverwaltung — alle Details stehen auf Discord-Anmeldung.

Seite „Freigabe ausstehend"

Wurde dein Account neu angelegt und ist noch nicht freigeschaltet, landest du nach dem Anmelden auf der Seite „Freigabe ausstehend". Sie erklärt, dass dein Account erstellt wurde und auf die Freigabe durch einen Administrator wartet; die Freigabe erfolgt von Hand und kann 1 bis 2 Tage dauern. Die einzige Aktion dort ist „Abmelden". Bis zur Freigabe hast du keinerlei Rechte und siehst nichts anderes. Ab- und wieder anmelden musst du dich nicht: Sobald du freigeschaltet bist, leitet die Seite von selbst ins Tool weiter — spätestens ein paar Sekunden später. Auch wenn du die Seite zwischenzeitlich geschlossen hast, kommst du beim nächsten Aufruf direkt hinein.

Wurde deine Registrierung dagegen abgelehnt, zeigt dieselbe Seite das jetzt auch so an: „Registrierung abgelehnt", mit dem Hinweis, dass keine automatische Freischaltung erfolgt. Sie wartet also nicht länger auf eine Entscheidung, die bereits gefallen ist. Eine Ablehnung wird nicht von selbst rückgängig — hältst du sie für einen Irrtum, wende dich an einen Administrator im DAS-KARTELL-Discord.

Ein dritter Fall: Ist dein Zugang zwar freigegeben, dir aber noch keine Rolle zugewiesen, zeigt die Seite „Keine Rolle vergeben". Ohne Rolle bleibt das Tool gesperrt, und erneutes Anmelden hilft nicht weiter — die Rolle vergibt die Administration, wende dich also an einen Administrator im DAS-KARTELL-Discord.

Nutzungsbedingungen bestätigen

Beim ersten Öffnen des Basetool wirst du gebeten, die Nutzungsbedingungen zu bestätigen. Ohne Zustimmung ist keine Nutzung möglich — das gilt auch für die Übertragung aus dem Desktop-Extractor.

Auf der Seite steht der vollständige Text in einem scrollbaren Feld, darunter zwei Knöpfe:

  • „Ich stimme zu" — du landest direkt auf der Startseite und wirst nicht wieder gefragt.
  • „Ablehnen und abmelden" — du wirst abgemeldet. Es passiert sonst nichts: du kannst dich jederzeit erneut anmelden und dann zustimmen.

Erreichbar bleiben in jedem Fall die Nutzungsbedingungen selbst, die Datenschutzerklärung, das Impressum und die Open-Source-Lizenzen. Niemand soll etwas bestätigen müssen, das er nicht vorher lesen kann.

Ändern sich die Nutzungsbedingungen, erscheint die Seite erneut, sobald du das Basetool das nächste Mal öffnest. Das Tool erkennt eine Änderung selbst am Text; es muss also niemand daran denken, das zu melden. Meldet der Extractor „Die Nutzungsbedingungen müssen bestätigt werden", ist genau das der Grund — einmal im Browser anmelden, zustimmen, danach sendet er wieder. Hattest du das Basetool zu diesem Zeitpunkt bereits offen, wechselt der Tab von selbst auf die Zustimmungsseite — du musst ihn nicht neu laden.

Was sich zuletzt geändert hat und was das für dich heißt, steht unter Nutzungsbedingungen.

Die Startseite nach dem Login

Bist du angemeldet, landest du auf der Startseite. Oben steht deine aktive Org-Einheit mit dem heutigen Datum und darunter „Willkommen, ". Darunter ist die Seite zweigeteilt (auf dem Smartphone und Tablet untereinander):

  • „Nächste 7 Tage" (links) — alle anstehenden Einsätze der kommenden Woche, der nächstgelegene Start zuerst. Jede Zeile zeigt das Datum, den Namen, darunter TS-Zeit, Join-Zeit, falls gepflegt den Treffpunkt und die verantwortliche Einheit, rechts den Status; Einsätze, für die du dich angemeldet hast, tragen darunter „Angemeldet", Einsätze deiner eigenen Einheit sind mit „Meine Einheit" markiert. Ein Klick auf die Zeile öffnet den Einsatz, „Alle Einsätze →" die Liste. Steht in den nächsten 7 Tagen nichts an, erscheint ein Hinweis.
  • „Information" (rechts) — die Ankündigung der Administration, sobald eine hinterlegt ist. Eine ungelesene ist mit einem Punkt markiert und trägt den Knopf „Gelesen". Der Text ist auf drei Zeilen gekürzt; „Weiterlesen" klappt ihn ganz auf.
  • „Benachrichtigungen" (rechts darunter) — deine drei neuesten Benachrichtigungen; „Alle anzeigen →" öffnet die ganze Liste.

Ohne Anmeldung

Ohne Anmeldung siehst du nur eine schlichte Einstiegsseite mit den Knöpfen „Anmelden" und „Mit Discord anmelden" sowie die Rechtsseiten (Impressum, Datenschutz, Nutzungsbedingungen, Open-Source-Lizenzen). Jeder Link in eine Ansicht führt zur Anmeldung und danach zurück auf die Seite, die du aufrufen wolltest.

Das Basetool ist seit dem 06.09.2026 ein reines Mitglieder-Werkzeug: Einsätze, Operationen, Aufträge und Spieldaten sind nur nach der Anmeldung lesbar, und eine Selbstanmeldung als Gast zu einem Einsatz gibt es nicht.

Wer keinen Account hat, kann trotzdem mitfliegen: Ein Mitglied — meist die Einsatzleitung — trägt die Person als externen Teilnehmer ein. Was entfällt, ist die Selbstanmeldung ohne Konto — nicht die Teilnahme.

Sprache wechseln

Unten im Menü, in deiner Nutzerzeile, sitzt der DE/EN-Umschalter. Öffne ihn und wähle die gewünschte Sprache — die aktuelle Seite lädt mit dem neuen ?lang= neu. Die Auswahl bleibt über ein Cookie bestehen.

Orientierung im Fenster

  • Menü (Sidebar) — der Knopf mit den drei Strichen oben links öffnet das Menü. Ganz oben stehen das Auswahlfeld „Aktive Org-Einheit" (nur wenn du mehreren angehörst) und ein Menüfilter: Tipp ein paar Buchstaben, und das Menü zeigt nur noch passende Einträge. Darunter folgen Startseite, Benachrichtigungen und die Gruppen Einsatzplanung, Flotte & Logistik, Handel, Organisation, Beförderung, Kartellbank und Ressourcen — je nach deinen Rechten. Gruppen klappst du per Klick auf die Überschrift zu und auf; der Zustand bleibt im Browser gespeichert, die Gruppe mit der aktuellen Seite ist immer offen. Escape oder ein Klick daneben schließt das Menü.
  • Deine Nutzerzeile — unten im Menü stehen dein Name, deine aktive Org-Einheit und deine Rolle. Ein Klick darauf öffnet „Persönlich" mit Mein Inventar, Meine Blueprints, Profil und Verbundene Anwendungen. Daneben sitzen die Sprache und Abmelden.
  • Schnellzugriff — das Suchfeld „Seite oder Aktion suchen …" oben rechts, oder Strg + K (am Mac ⌘ + K) auf jeder Seite, auch mitten in einem Eingabefeld. Er findet jede Seite, die du sehen darfst, dazu die Aktionen „Neuen Auftrag anlegen", „Org-Einheit wechseln" und „Abmelden". Ohne Eingabe zeigt er die bis zu vier zuletzt besuchten Seiten. Mit ↑/↓ wählst du, Enter öffnet, Escape schließt. Findet der Menüfilter nichts, reicht „Im Schnellzugriff suchen" deine Eingabe direkt weiter.
  • Auf dem Smartphone — unten sitzt eine feste Tab-Leiste mit Einsätze, Lager, Aufträge, Meldungen (mit Zähler) und Menü. „Menü" öffnet dasselbe Menü als Blatt von unten; die Gruppen klappen dort einzeln auf, und am Ende stehen die Rechtsseiten, das Handbuch und die Version. Die Lupe oben rechts öffnet den Schnellzugriff als Vollbild.
  • Benachrichtigungs-Glocke — oben rechts im Header (auf jeder Seite, sobald du angemeldet bist) sitzt ein Glocken-Symbol; auf dem Smartphone ist es der Tab „Meldungen". Ein kleines Zähl-Abzeichen zeigt deine ungelesenen Benachrichtigungen an; ein Klick öffnet eine Liste mit „Alle als gelesen markieren" und einem Link zur vollständigen Übersicht. Mehr dazu: Benachrichtigungen.
  • Dialoge sehen überall gleich aus und verhalten sich gleich: Jeder hat denselben Kopf mit Titel und Schließen-Kreuz (✕). Das ✕ und Escape schließen den obersten Dialog — außer bei Rückfragen, die du ausdrücklich beantworten musst. Das gilt auch für die Dialoge im Auftrag (Eintragung, Notiz, Übergabe, Item-Übergabe, Produktion), bei denen ✕ und Escape bis zum 23.09.2026 nichts taten. Beim Öffnen steht der Cursor im ersten Eingabefeld, beim Schließen springt der Fokus auf den Knopf zurück, der den Dialog geöffnet hat. Solange ein Dialog offen ist, lässt sich die Seite dahinter nicht bedienen. Farbige Beschriftungen (etwa das „Item“-Kennzeichen in der Auftragsliste, negative Preise in der Materialübersicht, rote Löschen-Knöpfe, Fehlermeldungen und Hinweise) sind seit dem 25.09.2026 besser lesbar.
  • Abmelden — der Knopf mit dem Pfeil-Symbol unten im Menü, ganz rechts in deiner Nutzerzeile, beendet deine Sitzung. Im Schnellzugriff gibt es dafür auch die Aktion „Abmelden".
  • Rechtsseiten — die Fußleiste (auf dem Smartphone das Ende des Menüs) verlinkt Impressum, Datenschutz, Nutzungsbedingungen und Open-Source-Lizenzen. Sie enthalten die rechtlichen Pflichtangaben (Anbieterkennzeichnung, Datenschutzerklärung mit Cookie-Hinweisen sowie die Nutzungsbedingungen) und sind auch ohne Anmeldung lesbar.
  • Open-Source-Lizenzen — das Basetool steht selbst unter der GNU GPL v3.0 und enthält Bausteine anderer Open-Source-Projekte. Die Seite Open-Source-Lizenzen nennt jeden davon mit Version und Lizenz, nach Lizenz gruppiert — ein Klick auf eine Lizenz klappt ihre Liste auf, „Lizenztext“ öffnet den vollständigen Text. Die Liste entsteht bei jeder neuen Version automatisch und passt deshalb immer genau zur laufenden Version. Bietet ein Baustein mehrere Lizenzen zur Wahl an, steht er unter jeder davon.

Bereich / aktiver Kontext

Daten im Basetool gehören jeweils einer Org-Einheit — das ist entweder eine Staffel oder ein Spezialkommando (SK). Über ihnen steht die Hierarchie Organisationsleitung → Bereich → Staffeln/SKs. Mehr dazu: Organisation.

Welcher Bereich gerade aktiv ist, zeigt dir der App-Titel (die Marke oben im Header sowie der Browser-Tab) — er trägt das Kürzel deiner aktiven Org-Einheit. Einen separaten Chip oben rechts gibt es nicht mehr.

Wer Was kann man umschalten?
KRT-Mitglieder / Offiziere / Logistiker Du siehst die Daten deiner eigenen Org-Einheit(en). Bist du Mitglied in mehreren (Staffel + Spezialkommandos), erscheint oben im Menü das Auswahlfeld „Aktive Org-Einheit", mit dem du zwischen ihnen wechselst. Mit „Alle meine Org-Einheiten" siehst du alle eigenen Mitgliedschaften zusammen. Die Auswahl wird gegen deine echten Mitgliedschaften geprüft — ein manipulierter Wechsel kann deine Sicht nicht erweitern.
Über die eigene Org-Einheit hinaus sichtbar sind außerdem:
  • nicht als intern markierte Einsätze — staffelübergreifend einsehbar,
  • Warenaufträge eines Spezialkommandos — die zentrale SK-Warteschlange ist ein gemeinsamer Arbeitsraum aller Profit-Staffeln (Aufträge einer Staffel bleiben dagegen privat).

Die Auswahl bleibt für deine Sitzung gespeichert und übersteht auch ein Neuladen der Seite.

Dein Profil

Menü → deine Nutzerzeile → Persönlich → Profil (Seitentitel „Benutzerprofil"). Oben stehen deine schreibgeschützten Identitätsdaten — Anzeigename, Rang und deine Staffel(n) (bis zu zwei) sowie E-Mail, Beitrittsdatum und Monate bei der Staffel. Darunter findest du die Einstellungen, je eine eigene Karte mit genau einer Aktion:

  • Benutzerdefinierte Daten — Anzeigename und Beschreibung bearbeiten,
  • Standard-Auszahlungsart — Auszahlen oder Spenden wählen; sie ist bei jeder Einsatz-Anmeldung vorausgewählt, pro Einsatz aber änderbar,
  • Blaupausen-Verfügbarkeit — den Schalter „Meine Blaupausen allen zur Verfügung stellen" setzen; dann zählen deine Baupläne in der Blueprint-Verfügbarkeit und bei der Verfügbarkeit in Aufträgen für jede Org-Einheit mit, nicht nur für deine eigene (Default aus),
  • Verbundene Anwendungen — den Schalter „Meinen Namen nicht an verbundene Anwendungen weitergeben" setzen; dann sehen Logistiker deiner Einheiten in ihren verbundenen Anwendungen weder deinen Namen noch deine Notiz an euren gemeinsamen Lagerposten (Default aus),
  • RSI-Handle — optional dein RSI-Handle (3 bis 60 Zeichen: Buchstaben, Ziffern, Unterstrich und Bindestrich). Andere Mitglieder sehen es nicht, und ein Handle gehört immer nur zu einem Konto. Verbundene Anwendungen können damit prüfen, ob ein Spiel-Log zu deinem Konto gehört — das Handle selbst erfahren sie dabei nie. Feld leeren und „Speichern" entfernt es wieder,
  • Zugang & Sicherheit — Passwort, E-Mail-Adresse und Zwei-Faktor-Anmeldung änderst du über die Schaltfläche „Daten in Keycloak bearbeiten" (öffnet die Keycloak-Kontoverwaltung). Dort verbindest du auch nachträglich einen Discord-Account mit deinem Account.
  • Meine Daten exportieren — eine vollständige Kopie aller Daten, die das Tool zu dir gespeichert hat, über „Als PDF" (lesbare Zusammenfassung) oder „Als JSON" (Vollauskunft),
  • Konto löschen — über „Löschung beantragen" die Löschung deines Kontos beantragen. Mit dem Absenden wird nichts gelöscht: ein Administrator entscheidet den Antrag, und du kannst ihn bis dahin zurückziehen.

Was der Export enthält, was bei einer Löschung genau passiert und wie lange welche Daten gespeichert bleiben: Meine Daten & Datenschutz.

Was du als Nächstes lesen solltest