Files
PythagorasGoal/src/live/tradesdb.py
T
Adriano Dal Pastro 10c373075c libro di bordo: DB dei trade allineato col tempo + giornale giornaliero
I trade erano salvati, ma non allineati col tempo: book_execute.py scriveva
ts_utc = pd.Timestamp(r['last_data']), cioe' la data della BARRA DI SEGNALE.
19 righe su 19 a 00:00:00, e un trade (ETH 0.04 @ 1869.74) registrato SEI
GIORNI prima di essere eseguito — fill vero 2026-07-14T14:00, scritto 08/07.
L'ora vera esisteva solo in logs/cron_book.log, che e' gitignored, fuori dal
backup e ruotabile: la cronologia reale del libro live viveva in un file che
una rotazione avrebbe cancellato senza che nessuno se ne accorgesse.

- src/live/tradesdb.py: parser del cron log (ora vera + contesto del segnale),
  FIFO con fee pro-quota, riconciliazione a tre fonti, sqlite in data/live/
  (dentro il perimetro del backup). Le tre fonti si INCROCIANO e non si
  sovrascrivono: reconcile() riporta le divergenze e non ripara niente da solo.
  Il venue e' autorevole ma TRONCA (1 trade su BTC, 0 su ETH): dichiarato.
- scripts/live/trades_db.py: --sync (idempotente, in cron_book ogni ora),
  --report, --reconcile.
- src/live/journal.py + scripts/live/journal.py: una voce al giorno in
  docs/journal/YYYY-MM-DD.md — mercato (ritorni, RV30, TSMOM sugli orizzonti
  di produzione, DVOL con eta'), libro (TP01/SKH01, target, posizione, leva),
  P&L (equity del venue come autorita', scomposizione locale), salute.
  NIENTE narrativa automatica: il campo `nota` e' l'unico posto per il testo
  libero ed e' dell'operatore, mai riscritto da un ricalcolo.
- book_execute.py: ts_utc = ora vera del fill, bar_ts = barra. Test di
  regressione sulla sorgente: se qualcuno rimette last_data, il test lo dice.
- 62 voci di giornale ricostruite dall'arming a oggi.

Tre difetti trovati dai test mentre scrivevo, non a occhio: il renderer cadeva
in KeyError se mancava il blocco mercato (un giornale che non si scrive non e'
un giornale); "24 giri attesi" su un giorno IN CORSO produceva un allarme a
ogni esecuzione; e libro e P&L leggevano due istanti diversi, quindi la stessa
pagina mostrava due equity.

Strategia, pesi, config INVARIATI. Nessun ordine. 659 test passano.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-23 13:13:02 +00:00

352 lines
14 KiB
Python

"""Libro di bordo del book live: DB dei trade ALLINEATO COL TEMPO + serie di equity.
PERCHE' ESISTE
--------------
`data/live/book_executions.jsonl` registra i fill, ma il suo `ts_utc` e' la data della
**barra di segnale** (`book_execute.py`: `pd.Timestamp(r['last_data'])`), non l'ora del fill:
19 righe su 19 a `00:00:00`. L'ora vera sta solo in `logs/cron_book.log` — che e' **gitignored,
non nel backup e ruotabile**. Quindi oggi la cronologia reale del libro live vive in un file
che una rotazione cancella, e nessuno se ne accorgerebbe.
Questo modulo MATERIALIZZA quella cronologia in `data/live/trades.db` (sqlite), che sta dentro
il perimetro gia' coperto dal backup rotativo della VPS.
FONTI, in ordine di autorita' — e nessuna delle tre e' completa da sola
----------------------------------------------------------------------
1. `logs/cron_book.log` -> ORA VERA del giro + contesto (equity, tp_frac, skh, target, posizione)
e la riga di fill `-> BUY 0.0008 @ $78,094.2 fee 0.02187 (OK)`.
2. `data/live/book_executions.jsonl` -> gli stessi fill con piu' cifre, ma senza ora.
3. venue (`DeribitRead.trade_history`) -> autorevole su `order_id` e timestamp in ms,
**ma tronca**: al 2026-08-23 ritorna 1 trade su BTC e 0 su ETH.
Le tre si INCROCIANO, non si sovrascrivono: `reconcile()` riporta le divergenze e non ripara
niente da solo (una riparazione silenziosa fra due fonti che non concordano e' un'invenzione).
TRE STATI, non due: un fill puo' essere `ok` (le fonti concordano), `solo-log`, `solo-jsonl`.
"Non lo vedo" non e' "non c'e'".
"""
from __future__ import annotations
import hashlib
import json
import re
import sqlite3
from dataclasses import dataclass, field
from datetime import datetime, timezone
from pathlib import Path
PROJECT_ROOT = Path(__file__).resolve().parents[2]
DB_PATH = PROJECT_ROOT / "data" / "live" / "trades.db"
CRON_LOG = PROJECT_ROOT / "logs" / "cron_book.log"
EXEC_JSONL = PROJECT_ROOT / "data" / "live" / "book_executions.jsonl"
# Data di armamento dell'esecuzione reale (CLAUDE.md, 2026-06-20).
ARMING = "2026-06-20"
SCHEMA = """
CREATE TABLE IF NOT EXISTS fills (
fill_id TEXT PRIMARY KEY,
ts_utc TEXT NOT NULL,
ts_source TEXT NOT NULL,
bar_ts TEXT,
asset TEXT NOT NULL,
side TEXT NOT NULL,
qty REAL NOT NULL,
price REAL NOT NULL,
fee REAL NOT NULL,
action TEXT,
net_target REAL,
pos_before REAL,
pos_after REAL,
tp_frac REAL,
skh_sign INTEGER,
skh_entry REAL,
equity REAL,
order_id TEXT,
verified INTEGER,
stato TEXT NOT NULL DEFAULT 'ok'
);
CREATE INDEX IF NOT EXISTS ix_fills_ts ON fills(ts_utc);
CREATE TABLE IF NOT EXISTS roundtrips (
rt_id INTEGER PRIMARY KEY AUTOINCREMENT,
asset TEXT NOT NULL,
qty REAL NOT NULL,
ts_in TEXT NOT NULL,
px_in REAL NOT NULL,
ts_out TEXT NOT NULL,
px_out REAL NOT NULL,
ore_tenuta REAL,
pnl_lordo REAL NOT NULL,
fee_quota REAL NOT NULL,
pnl_netto REAL NOT NULL
);
CREATE TABLE IF NOT EXISTS equity (
ts_utc TEXT PRIMARY KEY,
equity REAL NOT NULL,
src TEXT NOT NULL
);
CREATE TABLE IF NOT EXISTS journal (
giorno TEXT PRIMARY KEY,
ts_scritto TEXT NOT NULL,
mercato TEXT,
libro TEXT,
pnl TEXT,
salute TEXT,
nota TEXT NOT NULL DEFAULT ''
);
CREATE TABLE IF NOT EXISTS meta (k TEXT PRIMARY KEY, v TEXT);
"""
# =============================================================================================
# parsing — puro, nessun I/O: prende testo, ritorna dati
# =============================================================================================
@dataclass
class Fill:
ts_utc: str
asset: str
side: str
qty: float
price: float
fee: float
ts_source: str = "cron_log"
bar_ts: str | None = None
action: str | None = None
net_target: float | None = None
pos_before: float | None = None
pos_after: float | None = None
tp_frac: float | None = None
skh_sign: int | None = None
skh_entry: float | None = None
equity: float | None = None
order_id: str | None = None
verified: int = 1
@property
def fill_id(self) -> str:
raw = f"{self.ts_utc}|{self.asset}|{self.side}|{self.qty:.10f}|{self.price:.6f}"
return hashlib.sha1(raw.encode()).hexdigest()[:16]
@dataclass
class Run:
"""Un giro orario di `book_execute`."""
ts_utc: str
equity: float | None = None
last_bar: str | None = None
feed_min: int | None = None
fills: list[Fill] = field(default_factory=list)
stato_asset: dict = field(default_factory=dict)
_RE_HEAD = re.compile(r"^===== (\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z) cron_book =====$")
_RE_EQ = re.compile(r"conto reale\s*:\s*\$([\d,\.]+)")
_RE_BAR = re.compile(r"ultima barra\s*:\s*(\S+)")
_RE_FEED = re.compile(r"feed SKH\s*:\s*\w+ \((\d+) min\)")
_RE_SIG = re.compile(
r"^\s*(BTC|ETH) TP ([+-][\d\.]+) · SKH ([+-]\d+)\(([^)]*)\) -> net \$([+-][\d,]+) "
r"\| pos \$([+-][\d,]+) -> (.+?)\s*$")
_RE_FILL = re.compile(
r"^\s*-> (BUY|SELL) ([\d\.]+) @ \$([\d,\.]+) fee ([\d\.]+) \((OK|NON VERIFICATO[^)]*)\)")
def _num(s: str) -> float:
return float(s.replace(",", "").replace("$", ""))
def parse_cron_log(text: str) -> list[Run]:
"""Estrae i giri da `cron_book.log`. L'ORA del blocco e' l'ora vera del fill."""
runs: list[Run] = []
cur: Run | None = None
ultimo_asset: str | None = None
for line in text.splitlines():
m = _RE_HEAD.match(line)
if m:
cur = Run(ts_utc=m.group(1).replace("Z", "+00:00"))
runs.append(cur)
ultimo_asset = None
continue
if cur is None:
continue
if (m := _RE_EQ.search(line)) and cur.equity is None:
cur.equity = _num(m.group(1)); continue
if (m := _RE_BAR.search(line)) and cur.last_bar is None:
cur.last_bar = m.group(1); continue
if (m := _RE_FEED.search(line)) and cur.feed_min is None:
cur.feed_min = int(m.group(1)); continue
if (m := _RE_SIG.match(line)):
asset = m.group(1)
entry = None
sk = m.group(4)
if "@" in sk:
try:
entry = float(sk.split("@", 1)[1])
except ValueError:
entry = None
cur.stato_asset[asset] = dict(
tp_frac=float(m.group(2)), skh_sign=int(m.group(3)), skh_entry=entry,
net=_num(m.group(5)), pos=_num(m.group(6)), azione=m.group(7).strip())
ultimo_asset = asset
continue
if (m := _RE_FILL.match(line)) and ultimo_asset:
st = cur.stato_asset.get(ultimo_asset, {})
cur.fills.append(Fill(
ts_utc=cur.ts_utc, asset=ultimo_asset, side=m.group(1).lower(),
qty=float(m.group(2)), price=_num(m.group(3)), fee=float(m.group(4)),
bar_ts=cur.last_bar, action=st.get("azione"), net_target=st.get("net"),
pos_before=st.get("pos"), tp_frac=st.get("tp_frac"),
skh_sign=st.get("skh_sign"), skh_entry=st.get("skh_entry"),
equity=cur.equity, verified=1 if m.group(5) == "OK" else 0))
return runs
def parse_executions_jsonl(text: str) -> list[dict]:
return [json.loads(l) for l in text.splitlines() if l.strip()]
def reconcile(fills_log: list[Fill], righe_jsonl: list[dict], tol_px: float = 0.51) -> dict:
"""Incrocia le due fonti su (data, asset, side, qty). NON ripara: riporta.
`tol_px`: i prezzi del log sono arrotondati a 1 decimale in stampa -> confronto con
tolleranza, e la divergenza sopra tolleranza si REGISTRA invece di essere assorbita.
"""
def chiave(g, a, s, q):
return (g, a, s, round(float(q), 8))
ix_log: dict = {}
for f in fills_log:
ix_log.setdefault(chiave(f.ts_utc[:10], f.asset, f.side, f.qty), []).append(f)
ix_js: dict = {}
for r in righe_jsonl:
ix_js.setdefault(chiave(r["ts_utc"][:10], r["asset"], r["side"], r["filled"]), []).append(r)
ok, solo_log, solo_js, px_diversi = [], [], [], []
for k, gl in ix_log.items():
gj = ix_js.get(k, [])
for i, f in enumerate(gl):
if i < len(gj):
r = gj[i]
if abs(float(r["price"]) - f.price) > tol_px:
px_diversi.append((f, r))
ok.append((f, r))
else:
solo_log.append(f)
for k, gj in ix_js.items():
extra = len(gj) - len(ix_log.get(k, []))
for r in gj[max(0, len(gj) - extra):] if extra > 0 else []:
solo_js.append(r)
return dict(ok=ok, solo_log=solo_log, solo_jsonl=solo_js, prezzi_divergenti=px_diversi)
def fifo_roundtrips(fills: list[Fill]) -> tuple[list[dict], dict]:
"""Round-trip chiusi per FIFO + lotti residui. Le fee si allocano PRO-QUOTA sulla qty."""
from collections import deque, defaultdict
lotti: dict[str, deque] = defaultdict(deque)
rts: list[dict] = []
for f in sorted(fills, key=lambda x: (x.ts_utc, x.asset)):
fee_u = f.fee / f.qty if f.qty else 0.0
if f.side == "buy":
lotti[f.asset].append([f.qty, f.price, f.ts_utc, fee_u])
else:
resto = f.qty
while resto > 1e-12 and lotti[f.asset]:
lq, lp, lts, lfee_u = lotti[f.asset][0]
usa = min(resto, lq)
lordo = usa * (f.price - lp)
quota_fee = usa * (lfee_u + fee_u)
ore = (datetime.fromisoformat(f.ts_utc) - datetime.fromisoformat(lts)).total_seconds() / 3600
rts.append(dict(asset=f.asset, qty=usa, ts_in=lts, px_in=lp, ts_out=f.ts_utc,
px_out=f.price, ore_tenuta=ore, pnl_lordo=lordo,
fee_quota=quota_fee, pnl_netto=lordo - quota_fee))
lq -= usa; resto -= usa
if lq <= 1e-12:
lotti[f.asset].popleft()
else:
lotti[f.asset][0][0] = lq
aperti = {a: [dict(qty=q, price=p, ts=t) for q, p, t, _ in dq] for a, dq in lotti.items() if dq}
return rts, aperti
# =============================================================================================
# persistenza
# =============================================================================================
def connect(path: Path | str = DB_PATH) -> sqlite3.Connection:
path = Path(path)
path.parent.mkdir(parents=True, exist_ok=True)
con = sqlite3.connect(path)
con.row_factory = sqlite3.Row
con.executescript(SCHEMA)
return con
def upsert_fills(con: sqlite3.Connection, fills: list[Fill]) -> int:
n = 0
for f in fills:
cur = con.execute(
"""INSERT INTO fills (fill_id, ts_utc, ts_source, bar_ts, asset, side, qty, price, fee,
action, net_target, pos_before, pos_after, tp_frac, skh_sign,
skh_entry, equity, order_id, verified, stato)
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)
ON CONFLICT(fill_id) DO NOTHING""",
(f.fill_id, f.ts_utc, f.ts_source, f.bar_ts, f.asset, f.side, f.qty, f.price, f.fee,
f.action, f.net_target, f.pos_before, f.pos_after, f.tp_frac, f.skh_sign,
f.skh_entry, f.equity, f.order_id, f.verified, "ok"))
n += cur.rowcount
con.commit()
return n
def upsert_equity(con: sqlite3.Connection, punti: list[tuple[str, float, str]]) -> int:
n = 0
for ts, v, src in punti:
cur = con.execute("INSERT INTO equity (ts_utc, equity, src) VALUES (?,?,?) "
"ON CONFLICT(ts_utc) DO NOTHING", (ts, v, src))
n += cur.rowcount
con.commit()
return n
def rebuild_roundtrips(con: sqlite3.Connection) -> int:
"""Ricalcola da zero: i round-trip sono DERIVATI, mai inseriti a mano."""
righe = con.execute("SELECT * FROM fills ORDER BY ts_utc, asset").fetchall()
fills = [Fill(ts_utc=r["ts_utc"], asset=r["asset"], side=r["side"], qty=r["qty"],
price=r["price"], fee=r["fee"]) for r in righe]
rts, _ = fifo_roundtrips(fills)
con.execute("DELETE FROM roundtrips")
con.executemany(
"""INSERT INTO roundtrips (asset, qty, ts_in, px_in, ts_out, px_out, ore_tenuta,
pnl_lordo, fee_quota, pnl_netto)
VALUES (:asset,:qty,:ts_in,:px_in,:ts_out,:px_out,:ore_tenuta,
:pnl_lordo,:fee_quota,:pnl_netto)""", rts)
con.commit()
return len(rts)
def set_meta(con: sqlite3.Connection, k: str, v: str) -> None:
con.execute("INSERT INTO meta (k,v) VALUES (?,?) ON CONFLICT(k) DO UPDATE SET v=excluded.v", (k, v))
con.commit()
def get_meta(con: sqlite3.Connection, k: str, default=None):
r = con.execute("SELECT v FROM meta WHERE k=?", (k,)).fetchone()
return r["v"] if r else default
def stato_aperto(con: sqlite3.Connection) -> dict:
righe = con.execute("SELECT * FROM fills ORDER BY ts_utc, asset").fetchall()
fills = [Fill(ts_utc=r["ts_utc"], asset=r["asset"], side=r["side"], qty=r["qty"],
price=r["price"], fee=r["fee"]) for r in righe]
_, aperti = fifo_roundtrips(fills)
out = {}
for a, lotti in aperti.items():
q = sum(x["qty"] for x in lotti)
costo = sum(x["qty"] * x["price"] for x in lotti)
out[a] = dict(qty=q, prezzo_medio=costo / q if q else 0.0, dal=min(x["ts"] for x in lotti))
return out
def ora() -> str:
return datetime.now(timezone.utc).isoformat(timespec="seconds")