uprava toolu pro battery sizing

docs/04-modules/market-prices.md

@@ -127,6 +127,30 @@ Marže se konfigurují v `site_market_config`:
 
 Denní ekonomika v DB (`ems.fn_economics_daily_for_window`, repeatable `R__068_fn_economics_daily_month.sql`) musí používat stejnou kombinaci jako `fn_effective_buy_price` (komentář ve funkci).
 
+### Screening skript pro dimenzování baterie
+
+Analytický skript `scripts/analysis/battery_sizing_screen.py` umí pro nákup v režimu spot simulovat dva užitečné screening režimy bez vazby na konkrétní `site_market_config`:
+
+- `--buy-spot-add-fixed-kwh X`: základ nákupu = `raw_ote + X`
+- `--buy-spot-asym-pct P`: základ nákupu = `raw_ote × (1 + P/100)` pro `raw_ote >= 0`, resp. `raw_ote × (1 - P/100)` pro `raw_ote < 0`
+
+V obou případech skript ke každému importnímu slotu fixně přičte:
+
+- `--buy-distribution-kwh`
+- `--buy-other-fees-kwh`
+
+Volitelně pak na celý součet aplikuje:
+
+- `--buy-vat-multiplier` (např. `1.21`)
+
+Tato logika je implementovaná přímo ve `build_buy_prices_96()` v `scripts/analysis/battery_sizing_screen.py`. Účel je screening nové lokality nebo obchodního modelu ještě před seedem do DB; nejde o náhradu `ems.fn_effective_buy_price`.
+
+Ověření:
+
+- spusť skript nad krátkým vzorkem OTE (`--price-csv` nebo `--db`) a zkontroluj vypsané shrnutí režimu nákupu
+- pro asymetrickou variantu ověř, že záporné ceny používají faktor `1 - P/100`, nikoli `1 + P/100`
+- pro arbitráž bez FVE použij `--pv-daily-kwh-summer 0 --pv-daily-kwh-winter 0 --load-kw 0`
+
 **Zelený bonus** není součástí `fn_effective_sell_price` ani view efektivní prodejní ceny – jde o samostatný příjem z výroby, viz níže.
 
 ---