# Einheiten: backend/tft/model/augments.py
stand: f41ac76b5789

## backend/tft/model/augments.py::_num
beschreibung: Liest einen numerischen Effekt-Wert aus einem Dict über eine Liste bevorzugter Schlüssel.
input: ein `effects`-Dict und ein Tupel von Schlüsselnamen
output: den ersten positiven Zahlenwert oder `None`, falls keiner passt
entscheidungen:
- Nur der erste positive Treffer zählt; Null und negative Werte werden übersprungen.
  beleg: "if isinstance(val, (int, float)) and val > 0:"
- Es wird strikt zwischen echten Zahlen und Nicht-Zahlen gefiltert, bevor der Wert gilt.
  beleg: "if isinstance(val, (int, float)) and val > 0:"
- Fehlt jeder passende Schlüssel, signalisiert die Funktion das durch `None`.
  beleg: "return None"
kanten:
- wird-genutzt-von: backend/tft/model/augments.py::build_spec

## backend/tft/model/augments.py::build_spec
beschreibung: Zerlegt ein einzelnes Augment in mechanisch anwendbare Atome aus Beschreibung und Effects-Block.
input: ein Augment-Dict (`api`, `desc`, `effects`) und das `static_units`-Verzeichnis
output: ein Dict mit `atoms`-Liste und `offerable`-Flag
entscheidungen:
- Ein Augment gilt nur dann als „offerable", wenn die Beschreibung lang genug und frei von Platzhaltern ist.
  beleg: "offerable = len(desc) >= 10 and \"_Desc\" not in desc and \"@\" not in desc"
- Beim Spieler-HP-Atom wird der Effects-Wert bevorzugt, sonst der Regex-Treffer aus der Beschreibung.
  beleg: "\"amount\": int(_num(effects, PLAYER_HP_KEYS) or m.group(1))"
- Team-Stat-Buffs werden nur übernommen, wenn die Beschreibung unkonditional ist.
  beleg: "if TEAM_RE.search(desc) and not CONDITIONAL_RE.search(desc):"
- Fraktionswerte werden zur Vergleichbarkeit mit `statsheet` über `_fraction` normalisiert.
  beleg: "value = _fraction(val)"
kanten:
- ruft-auf: backend/tft/model/augments.py::_num
- nutzt: backend/tft/model/statsheet.py::_fraction
- wird-genutzt-von: backend/tft/model/augments.py::build_specs

## backend/tft/model/augments.py::build_specs
beschreibung: Wendet `build_spec` auf alle Augmente eines Katalogs an und indiziert das Ergebnis nach API.
input: ein `static_augments`-Dict und das `static_units`-Verzeichnis
output: ein Dict, das jeder API ihr `build_spec`-Ergebnis zuordnet
entscheidungen:
- Die Funktion ist eine reine Dictionary-Komprehension über den gesamten Katalog.
  beleg: "return {api: build_spec(aug, static_units) for api, aug in static_augments.items()}"
- Die Schlüssel des Eingabe-Dicts werden unverändert als API-Schlüssel übernommen.
  beleg: "for api, aug in static_augments.items()"
kanten:
- ruft-auf: backend/tft/model/augments.py::build_spec