feat(live): allerta sul salto di equity — conferma il versamento, segnala un prelievo

La verifica "il cap si adegua?" esisteva solo come sorveglianza di sessione, e il
versamento slitta di giorni: una verifica che vive in una chat non e' una verifica. Resa
permanente e generalizzata.

`write_equity_watermark` ora ritorna {prev, new, pct} quando il salto fra due letture
consecutive supera EQUITY_JUMP_ALERT = 10%; `book_report` lo espone come `equity_jump` e
`book_execute` manda un Telegram con il NUOVO DIMENSIONAMENTO accanto (cap/asset, nozionale
lordo, leva), cosi' il messaggio si legge senza aprire il repo.

Il book ha vol ~0.4%/giorno: un salto del 10% fra due giri orari non puo' venire dal
trading. Quindi l'allerta copre DUE casi con un meccanismo solo:
  - VERSAMENTO: conferma che e' atterrato e che il sizing lo ha seguito;
  - USCITA DI FONDI: un prelievo che non hai chiesto, o una perdita anomala. E' questo il
    caso che conta di piu', ed e' il motivo per cui la soglia e' a due code.

Prima lettura in assoluto -> nessun allarme (senza un "prima" non c'e' un salto).
Il watermark si aggiorna ANCHE quando allerta, o il cap resterebbe indietro (test cablato).

411 test verdi (+7). Strategia, pesi, cron, config INVARIATI.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Adriano Dal Pastro
2026-07-26 21:23:28 +00:00
parent e320e3c2ba
commit 95caeb87da
3 changed files with 88 additions and 4 deletions
+45
View File
@@ -118,3 +118,48 @@ def test_la_frazione_di_config_tiene_la_leva_a_1x():
"""2 asset x frac <= 1.0: e' l'ipotesi su cui poggia 'la liquidation fee non ci tocca' (26/07)."""
cfg = json.loads((ROOT / "config" / "live.json").read_text())
assert float(cfg["max_notional_per_asset_frac"]) * 2 <= 1.0
# ===========================================================================
# allerta sul SALTO di equity — conferma un versamento, segnala un prelievo
# ===========================================================================
def test_nessun_allarme_su_variazione_normale(wm):
B.write_equity_watermark(600.0)
assert B.write_equity_watermark(605.0) is None, "una variazione da trading non deve allertare"
def test_un_versamento_produce_l_allarme_col_segno_giusto(wm):
B.write_equity_watermark(596.92)
j = B.write_equity_watermark(6047.0)
assert j is not None
assert j["prev"] == pytest.approx(596.92) and j["new"] == pytest.approx(6047.0)
assert j["pct"] > 0
def test_un_prelievo_non_richiesto_produce_l_allarme(wm):
"""Il caso che conta piu' del versamento: fondi che escono senza che tu li abbia chiesti."""
B.write_equity_watermark(6047.0)
j = B.write_equity_watermark(3000.0)
assert j is not None and j["pct"] < -B.EQUITY_JUMP_ALERT
def test_la_prima_lettura_in_assoluto_non_allerta(wm):
"""Senza un 'prima' non c'e' un salto: allertare al primo avvio sarebbe rumore."""
assert B.write_equity_watermark(6047.0) is None
def test_il_watermark_si_aggiorna_anche_quando_allerta(wm):
"""L'allarme non deve impedire l'aggiornamento, o il cap resterebbe indietro."""
B.write_equity_watermark(596.92)
B.write_equity_watermark(6047.0)
assert B._read_watermark() == pytest.approx(6047.0)
assert B._cap(equity=6047.0, real_equity=6047.0, eq_fallback=None) == pytest.approx(3023.5)
def test_la_soglia_di_salto_e_congelata():
assert B.EQUITY_JUMP_ALERT == 0.10
def test_book_execute_avvisa_sul_salto():
src = (ROOT / "scripts" / "live" / "book_execute.py").read_text()
assert "equity_jump" in src and "VERSAMENTO" in src