update

.planer/features/bedienung-und-schnittstellen.md

@@ -0,0 +1,20 @@
+# Bereich: Bedienung und Schnittstellen
+beschreibung: Macht die Simulation und das Modell von außen ansprechbar — als Kommandozeilen-Werkzeug und als Dienst.
+
+## Feature: Partien über eine Schnittstelle anbieten [rand]
+beschreibung: Erlaubt es, neue Partien zu starten, Aktionen auszuführen und Spielzustände abzurufen.
+
+### Nimmt Spielzüge entgegen und leitet sie an die Simulation weiter
+einheiten: backend/tft/api/app.py::ActionRequest, backend/tft/api/app.py::action, backend/tft/api/app.py::_load_game_deps
+
+### Verwaltet laufende Partien und meldet deren Zustand
+einheiten: backend/tft/api/app.py::new_game, backend/tft/api/app.py::state, backend/tft/api/app.py::serialize, backend/tft/api/app.py::unit_view, backend/tft/api/app.py::upgrade_hint
+
+### Meldet den Betriebszustand des Dienstes
+einheiten: backend/tft/api/app.py::health
+
+## Feature: Werkzeuge über die Kommandozeile bedienen [rand]
+beschreibung: Bündelt die wichtigsten Arbeitsschritte in einem Kommandozeilen-Werkzeug mit Unterbefehlen.
+
+### Verteilt eingegebene Befehle an die passenden Arbeitsschritte
+einheiten: backend/tft/cli.py::main

.planer/features/partie-simulation.md

@@ -0,0 +1,32 @@
+# Bereich: Partie-Simulation
+beschreibung: Spielt komplette TFT-Partien automatisch nach und liefert Platzierungen als Ergebnis.
+
+## Feature: Einzelne Aktionen eines Spielers ausführen [kern]
+beschreibung: Bildet alle Spielzüge eines Spielers — Kauf, Verkauf, Aufstellen, Kombinieren, Würfeln — originalgetreu ab.
+
+### Verwaltet das Vermögen, das Leveln und den Einkauf von Einheiten
+einheiten: backend/tft/sim/economy.py::apply_xp, backend/tft/sim/economy.py::xp_to_next, backend/tft/sim/economy.py::round_income, backend/tft/sim/economy.py::interest, backend/tft/sim/economy.py::streak_gold, backend/tft/sim/player.py::buy, backend/tft/sim/player.py::buy_xp, backend/tft/sim/player.py::sell
+
+### Bewegt Einheiten zwischen Bank und Brett und rüstet sie mit Items aus
+einheiten: backend/tft/sim/player.py::move, backend/tft/sim/player.py::fill_board, backend/tft/sim/player.py::merge, backend/tft/sim/player.py::equip, backend/tft/sim/player.py::unit_worth, backend/tft/sim/player.py::score
+
+### Frischt den Shop auf, würfelt neu und vergibt Belohnungen
+einheiten: backend/tft/sim/shop.py::roll, backend/tft/sim/player.py::refresh_shop, backend/tft/sim/player.py::reroll, backend/tft/sim/player.py::grant_loot, backend/tft/sim/player.py::grab_carousel_unit, backend/tft/sim/player.py::pick_augment, backend/tft/sim/player.py::InvalidAction
+
+### Hält den Gesamtzustand eines Spielers über die ganze Partie vor
+einheiten: backend/tft/sim/player.py::PlayerState, backend/tft/sim/player.py::new_player, backend/tft/sim/pool.py::Pool
+
+## Feature: Komplette Partien durchspielen [kern]
+beschreibung: Steuert eine ganze Partie über alle Runden, Kämpfe und Platzierungen hinweg.
+
+### Legt den Rundenplan fest und paart Gegner für den Kampf
+einheiten: backend/tft/sim/rounds.py::schedule, backend/tft/sim/game.py::pair_players, backend/tft/sim/game.py::Game, backend/tft/sim/game.py::_delegate
+
+### Simuliert den Kampf zwischen zwei Teams
+einheiten: backend/tft/sim/combat.py::FightResult, backend/tft/sim/combat.py::fight, backend/tft/sim/combat.py::_queue, backend/tft/sim/combat.py::_suffix_off, backend/tft/sim/combat.py::player_damage
+
+## Feature: Partien automatisch ausführen und auswerten [kern]
+beschreibung: Lässt viele Partien automatisch durchlaufen und fasst ihre Platzierungen zusammen.
+
+### Spielt ganze Partien nach festen Spielstilen zu Ende
+einheiten: backend/tft/sim/autoplay.py::play_afk, backend/tft/sim/autoplay.py::play_econ, backend/tft/sim/autoplay.py::run

.planer/features/spieldaten-beschaffung.md

@@ -0,0 +1,23 @@
+# Bereich: Spieldaten-Beschaffung
+beschreibung: Stellt die statischen Spiel- und Live-Daten bereit, auf denen alles Weitere aufbaut.
+
+## Feature: Aktuelle Spieldaten automatisch laden [kern]
+beschreibung: Holt die jeweils gültigen Konfigurations-, Einheiten-, Item- und Augment-Daten und hält sie versioniert vor.
+
+### Lädt den offiziellen Datenstand versioniert herunter und macht ihn abrufbar
+einheiten: backend/tft/staticdata/fetch.py::fetch_static, backend/tft/staticdata/fetch.py::load_static, backend/tft/paths.py::latest_static_pointer, backend/tft/paths.py::static_dir
+
+### Bereitet Rohdaten in flache, einheitliche Tabellen auf
+einheiten: backend/tft/staticdata/parse.py::parse, backend/tft/staticdata/parse.py::detect_set, backend/tft/staticdata/parse.py::augment_tier, backend/tft/staticdata/parse.py::icon_url, backend/tft/staticdata/parse.py::render_desc, backend/tft/staticdata/parse.py::resolve_spell
+
+### Liefert Set-spezifische Konfigurationswerte und Spielkonstanten
+einheiten: backend/tft/constants/loader.py::load_constants, backend/tft/constants/loader.py::validate, backend/tft/cli.py::current_set
+
+## Feature: Profi-Matches für die Analyse sammeln [kern]
+beschreibung: Bezieht gewertete Partien von Top-Spielern, prüft sie gegen die statischen Daten und speichert ihre End-Aufstellungen.
+
+### Ruft gewertete Partien ab und schreibt sie in eine lokale Datenbank
+einheiten: backend/tft/matches/riot.py::RiotClient, backend/tft/matches/riot.py::api_key, backend/tft/matches/riot.py::_load_env, backend/tft/matches/crawl.py::crawl, backend/tft/db.py::connect
+
+### Überführt rohe Match-Daten in geprüfte Endaufstellungen
+einheiten: backend/tft/matches/extract.py::extract_match, backend/tft/matches/extract.py::extract_all, backend/tft/matches/extract.py::validate_ids, backend/tft/matches/extract.py::patch_of

.planer/features/stärkemodell-aus-daten-lernen.md

@@ -0,0 +1,32 @@
+# Bereich: Stärkemodell aus Daten lernen
+beschreibung: Leitet aus gesammelten Profi-Aufstellungen belastbare Stärke-Werte für jede Spielfigur ab.
+
+## Feature: Datenbasiertes Stärkemodell erzeugen [kern]
+beschreibung: Lernt aus historischen Platzierungen, wie stark Einheiten, Eigenschaften, Items und Augments wirklich sind.
+
+### Aggregiert Endaufstellungen zu platzierungsabhängigen Stärkewerten
+einheiten: backend/tft/model/learn.py::learn, backend/tft/model/learn.py::learn_from_db, backend/tft/model/learn.py::_multiplier
+
+### Kalibriert das Modell gegen reale Platzierungen und prüft seine Aussagekraft
+einheiten: backend/tft/model/calibrate.py::calibrate, backend/tft/model/calibrate.py::_holdout_scores, backend/tft/model/calibrate.py::_ranks, backend/tft/model/calibrate.py::spearman, backend/tft/model/calibrate.py::board_from_row
+
+## Feature: Spielstärke einer Aufstellung messen [kern]
+beschreibung: Bewertet eine konkrete Brett-Aufstellung mit einer reproduzierbaren Gesamtstärke.
+
+### Berechnet das Kampfprofil jeder Einheit auf dem Brett
+einheiten: backend/tft/model/score.py::unit_profile, backend/tft/model/score.py::board_profiles, backend/tft/model/statsheet.py::unit_stats, backend/tft/model/statsheet.py::_apply_item_effects, backend/tft/model/statsheet.py::_empty_acc, backend/tft/model/statsheet.py::_fraction, backend/tft/model/statsheet.py::item_is_modeled, backend/tft/model/statsheet.py::trait_buffs
+
+### Ermittelt aktive Eigenschafts-Stufen und einen Gesamt-Score
+einheiten: backend/tft/model/score.py::active_trait_tiers, backend/tft/model/score.py::score_board, backend/tft/model/baseline.py::classify_role, backend/tft/model/baseline.py::unit_value
+
+## Feature: Analyse-Bausteine versioniert bereitstellen [kern]
+beschreibung: Bündelt das gelernte Modell mit allen Spiel-Bausteinen zu einem versionierten Paket für Simulation und Auswertung.
+
+### Stellt die kombinierbaren Items und ihre Komponenten-Pools bereit
+einheiten: backend/tft/model/artifact.py::craftable_items, backend/tft/model/artifact.py::component_pool, backend/tft/model/artifact.py::recipes
+
+### Zerlegt Augments in maschinenlesbare Effekte
+einheiten: backend/tft/model/augments.py::build_spec, backend/tft/model/augments.py::build_specs, backend/tft/model/augments.py::_num, backend/tft/model/artifact.py::_augment_specs
+
+### Setzt einen Deckelwert für Fähigkeits-Schaden und verwaltet Artefakt-Versionen
+einheiten: backend/tft/model/artifact.py::spell_dps_cap, backend/tft/model/artifact.py::build, backend/tft/model/artifact.py::load, backend/tft/model/artifact.py::save, backend/tft/paths.py::artifact_dir, backend/tft/paths.py::latest_artifact_pointer