Chi fa analisi tecnica e opera sui mercati sa bene che individuare un buon setup sul grafico è solo metà del lavoro. L’altra metà — spesso la più difficile — sta nella gestione della posizione, nel rispetto del piano operativo e nella capacità di rivedere a freddo ciò che ha funzionato e ciò che invece ha eroso il capitale.
Per molto tempo ho cercato uno strumento che mi permettesse di tenere traccia dell’operatività in modo rigoroso. Le alternative sul mercato, però, ricadono quasi sempre in due categorie: fogli di calcolo artigianali che diventano ingestibili dopo poche decine di operazioni, oppure piattaforme SaaS chiuse, costose e spesso poco trasparenti su come vengono trattati i dati storici del proprio portafoglio.
Da questa esigenza è nato TradingJournal, un progetto open-source pensato per chi vuole un ambiente di lavoro pulito, estensibile e sotto il proprio totale controllo. Ma anche pronto per la fiscalità italiana, con il calcolo del capital gain o delle minusvalenze.

Questo articolo inaugura una serie di approfondimenti su trading.tosolini.info: qui vediamo l’architettura logica e le peculiarità di base del software, mentre nei prossimi post entreremo nel dettaglio delle singole funzionalità, dei flussi operativi e delle novità in sviluppo.
I pilastri del progetto
TradingJournal non nasce per sostituire la piattaforma grafica su cui si tracciano supporti, resistenze o indicatori, ma per affiancarla come centro di controllo operativo e statistico. L’intero sistema poggia su quattro scelte precise.
1. Sovranità totale sui propri dati
Lo storico delle operazioni, la size delle posizioni, le note psicologiche e l’andamento del capitale sono informazioni sensibili. TradingJournal è progettato per essere self-hosted (distribuibile facilmente tramite Docker o eseguibile in locale): il database resta sulle proprie macchine, senza abbonamenti mensili, senza limiti arbitrari sul numero di trade registrati e senza dover affidare il proprio track record a server di terze parti.
2. Dall’idea di trading all’analisi dei risultati
Un buon diario non serve solo a registrare il passato, ma a preparare le operazioni future. Per questo il software copre l’intero ciclo operativo:
- Area di Scouting: uno spazio dedicato all’osservazione dei titoli e alla pianificazione pre-trade, utile per separare l’analisi fatta a mercati chiusi dall’impulsività dell’esecuzione.
- Registro operativo e portafoglio: tracciamento puntuale degli ingressi, delle uscite e delle diverse asset class (azioni, ETF e comparto obbligazionario), con calcolo automatico di P&L e metriche di rendimento.
- Equity curve e statistiche: visualizzazione chiara della curva dei profitti e delle perdite per valutare la reale tenuta della propria strategia nel tempo, al di là del singolo trade andato bene o male.
3. Dati di mercato integrati senza attrito
Inserire a mano ogni singolo aggiornamento di prezzo rende qualsiasi journal destinato all’abbandono nel giro di poche settimane. Il backend dialoga direttamente con feed di mercato (tramite yfinance) per recuperare quotazioni e serie storiche in autonomia, riducendo al minimo la manutenzione manuale e mantenendo aggiornata la valutazione delle posizioni aperte.
4. L’Intelligenza Artificiale come analista terzo e imparziale
Quando si rivede la propria operatività, il nemico principale è il bias di conferma: tendiamo a giustificare gli errori di disciplina e ad attribuire i successi alla sola bravura tecnica. TradingJournal integra un layer di analisi basato su Intelligenza Artificiale pensato proprio per agire come un revisore esterno: interroga lo storico delle operazioni, sintetizza i pattern ricorrenti e aiuta a far emergere criticità — come uscite anticipate, sovraesposizione o deroghe allo stop loss — che nella routine quotidiana passano inosservate.
Sotto il cofano (in breve)
Pur essendo uno strumento pensato per l’operatività finanziaria, il progetto mantiene un’impostazione ingegneristica moderna e ispezionabile:
- Backend in Python (FastAPI): veloce, modulare e facile da estendere con nuovi script di analisi o importatori.
- Frontend in React e TypeScript: un’interfaccia reattiva, progettata per andare dritta ai numeri e ai grafici senza distrazioni visive.
- Persistenza flessibile: supporto a database relazionali standard (SQLite per partire subito in locale, PostgreSQL per installazioni più strutturate).
Il codice è interamente disponibile su GitHub all’indirizzo github.com/tosolini/tradingjournal, aperto a chiunque voglia testarlo, adattarlo al proprio stile di trading o contribuire allo sviluppo.
Cosa vedremo nei prossimi articoli
Nei prossimi appuntamenti su trading.tosolini.info smonteremo il software pezzo per pezzo, concentrandoci sull’uso pratico:
- Installazione e configurazione iniziale.
- Setup del broker, indici e assett.
- Setup di un provider LLM.
- Come strutturare il flusso di Scouting per passare dall’analisi tecnica sul grafico al piano operativo.
- Come leggere metriche ed Equity Curve all’interno del journal per valutare l’aspettativa matematica delle proprie strategie.
- Come sfruttare l’analista AI per fare post-mortem periodici sulle operazioni chiuse.
- Le nuove funzionalità che verranno rilasciate man mano sul repository.
Se nel frattempo vuoi dare un’occhiata al codice o provarlo sulla tua macchina, il punto di partenza è il repository ufficiale su GitHub.