📋 Regole di trading

Trading rules are a powerful tool — but without a starting point, they can feel overwhelming. If you're just getting started, these three rules are all you need:

1. Max 2% risk per trade. Set a hard stop at 2% of your current account value in the rule settings. The app warns you as soon as you cross this limit. Math background: Chapter 6.0 — The 1R Rule.
2. No adding to losers. If a trade is red, you do NOT double down (no "averaging down"). Turn the rule on → the app warns you on violation. Background on this trap: Ch. 6 Losing Streak.
3. A journal entry is mandatory for every trade. Entry reason + emotion + rationale. No journal, no trade. No review, no learning. Template: Mindset Ch. Module 3.

After 3 months, you can expand your rule set with the advanced rules from the sections below — earnings filters, correlation limits, max positions per day. But first: these three, and nothing else.

Le regole di trading sono condizioni predefinite che ti aiutano a fare trading in modo disciplinato. Il sistema monitora automaticamente le tue posizioni e invia avvisi quando una regola viene attivata. Così non dimentichi mai un'azione importante.

Il sistema delle regole di trading:
• Ti ricorda automaticamente le regole importanti
• Avvisa sulle violazioni dei limiti di rischio
• Aiuta a documentare e analizzare il rispetto delle regole
• Supporta diversi stili di trading (opzioni, azioni, ecc.)

Il sistema delle regole si basa su due dimensioni fondamentali:

┌─────────────────────────────────────────────────────────────────┐
│                        RULE DIMENSIONS                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  SOURCE                        SCOPE (Applicability)            │
│  ┌──────────────┐              ┌──────────────────────────┐    │
│  │ System       │              │ 🎯 Position              │    │
│  │ (Presets)    │              │    A specific            │    │
│  ├──────────────┤              │    position              │    │
│  │ User         │              ├──────────────────────────┤    │
│  │ (Custom)     │              │ 🏦 Account               │    │
│  └──────────────┘              │    A broker account      │    │
│                                ├──────────────────────────┤    │
│                                │ 💼 Portfolio             │    │
│                                │    All accounts          │    │
│                                └──────────────────────────┘    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

🔧 Preset di sistema
Regole predefinite dal sistema che puoi attivare con un clic. Si basano su pratiche di trading consolidate e sono mantenute dal team di Singularity Trader.

Esempi:
• "50% Profit Take" - Chiudi al 50% del profitto massimo
• "21 DTE Management" - Avvisa a 21 giorni rimanenti
• "200% Stop Loss" - Chiudi a 2x perdita del premio

✏️ Definite dall'utente (Custom)
Le tue regole personali che crei per adattarle esattamente al tuo stile di trading. Definisci tu stesso nome, condizione e azione.

Ogni regola ha uno scope che determina a quali posizioni si applica:

Scope	Regola di esempio	Caso d'uso
🎯 Posizione	"Vendi questa posizione AAPL al +20%"	Piano di trade individuale
🏦 Conto	"Max 30% di buying power in questo conto"	Conto IRA conservativo
💼 Portafoglio	"Mai più del 5% in una posizione"	Regola generale di rischio

Le regole di posizione si applicano a una posizione specifica. Ti permettono di definire un piano individuale per ogni trade.

Regole di posizione tipiche:
• Prezzo stop-loss - es. "Vendi se il prezzo scende sotto $150"
• Target take-profit - es. "Chiudi al +20%"
• Basate su DTE - es. "Chiudi a 14 DTE"
• Avviso ITM - es. "Fai il roll se l'opzione va ITM"
• Piano di trade individuale

Caso d'uso: Apri un trade e imposti immediatamente quando chiuderlo o aggiustarlo. Il sistema ti avvisa quando la condizione è soddisfatta.

Le regole di conto si applicano a un conto broker. Ti aiutano a gestire strategie diverse per conto.

Regole di conto tipiche:
• Utilizzo massimo buying power % - es. "Mai sopra il 50%"
• Max posizioni aperte - es. "Max 10 posizioni"
• Classi di asset consentite - es. "Solo azioni, nessuna opzione"
• Dimensione massima posizione in questo conto
• Regole di margine specifiche per il conto

Caso d'uso: Hai un conto IRA conservativo e un conto di trading aggressivo. Le regole di conto assicurano che tu segua profili di rischio diversi.

Le regole di portafoglio si applicano a tutti i conti. Proteggono la tua ricchezza totale.

Regole di portafoglio tipiche:
• Limite di esposizione totale - es. "Max 200% del capitale"
• Diversificazione settoriale - es. "Max 20% in Tech"
• Dimensione massima posizione (totale) - es. "Max 5% in un'azione"
• Limiti di correlazione - es. "Avviso se troppi trade simili"
• Regole di rischio generale

Caso d'uso: Indipendentemente da quanti conti hai, queste regole assicurano che il tuo portafoglio totale rimanga sicuro.

Le regole sono organizzate per categoria in base a quando si applicano:

📥 Regole di ingresso (prima dell'apertura)
Verifiche prima di aprire una posizione:
• 45 DTE Entry - Opzioni con ~45 giorni rimanenti
• Delta 0.30 - Short put a delta 0.30
• IV Rank > 50 - Vendi solo quando la IV è alta
• Evita earnings - Nessun trade sugli earnings

📤 Regole di uscita/gestione
Quando chiudere o aggiustare le posizioni:
• 50% Profit Take - Chiudi al 50% del guadagno massimo
• 21 DTE Management - Avvisa a 21 giorni rimanenti
• 200% Stop Loss - Chiudi a 2x perdita del premio
• Roll a ITM

⚠️ Regole di rischio
Limiti a livello di portafoglio:
• Regola 1-2% - Rischio massimo per trade
• 5% Dimensione posizione - Max per posizione
• 50% Buying Power - Non superare mai

🧠 Regole psicologiche
Protezione dal trading emotivo:
• 3 perdite = Pausa
• Niente revenge trading
• Pianifica prima del trade

Il rule engine è il cuore del sistema. Monitora continuamente tutte le tue posizioni e verifica se le regole vengono attivate:

┌─────────────────────────────────────────────────────────────────┐
│                        RULE ENGINE                              │
├─────────────────────────────────────────────────────────────────┤
│  Rule Definition (Admin/User)                                   │
│  • Name, Description                                            │
│  • Type: Entry / Exit / Management / Risk                       │
│  • Condition (e.g., DTE <= 21)                                  │
│  • Action: Alert / Warning / Block                              │
│  • Asset Type: Option / Stock / All                             │
│  • Scope: Position / Account / Portfolio                        │
├─────────────────────────────────────────────────────────────────┤
│                              ↓                                  │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐    │
│  │ Dashboard │  │ Watchlist │  │  Entry    │  │  Alerts   │    │
│  │  Widget   │  │  Signals  │  │  Check    │  │  System   │    │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘    │
└─────────────────────────────────────────────────────────────────┘

Il motore verifica regolarmente tutte le regole attive e attiva l'azione appropriata quando le condizioni sono soddisfatte.

Le regole di trading sono integrate in vari punti della piattaforma:

Pagina	Integrazione
Dashboard	Widget "Azione richiesta" con avvisi di regole attive
Dettaglio posizione	Mostra regole attive per questa posizione
Apertura trade	Verifica prima dell'apertura (regole di rischio)
Watchlist	Colonna segnali basata sulle regole di ingresso
Notifiche	Push/Email quando una regola si attiva
Trading Journal	Punteggio di conformità alle regole per trade

Questi tipi di condizione sono disponibili per le regole:

Tipo	Descrizione	Asset
PROFIT_PCT	Profitto in %	Tutti
LOSS_PCT	Perdita in %	Tutti
DTE	Giorni alla scadenza	Opzioni
DELTA	Valore delta	Opzioni
IV_RANK	IV Rank/Percentile	Opzioni
POSITION_SIZE_PCT	Posizione > X% del portafoglio	Rischio
BUYING_POWER_PCT	Utilizzo BP > X%	Rischio
EARNINGS_DTE	Earnings tra X giorni	Tutti

⚠️ Nota: Il sistema delle regole di trading è attualmente in fase di concetto. Le funzionalità descritte qui verranno implementate nelle versioni future.

Il tuo feedback è benvenuto per aiutare a modellare le funzionalità in modo ottimale! La documentazione tecnica dettagliata si trova in docs/concepts/TRADING-RULES.md.

Ecco come creare la tua regola individuale:

┌─────────────────────────────────────────────────────────┐
│ ➕ Nuova regola                                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ Nome: [La mia regola Stop-Loss__________________]       │
│                                                         │
│ Ambito:                                                 │
│ ○ 💼 Portafoglio (tutti gli account)                   │
│ ● 🏦 Account: [Interactive Brokers ▼]                  │
│ ○ 🎯 Posizione: [Seleziona posizione...]               │
│                                                         │
│ Quando:                                                 │
│ [Perdita %___▼] [>=] [15__] [%]                        │
│                                                         │
│ Allora:                                                 │
│ [🔔 Invia avviso___▼]                                  │
│                                                         │
│ Tipo di asset: ○ Tutti  ● Azioni  ○ Opzioni            │
│                                                         │
│              [Annulla]  [💾 Salva]                     │
└─────────────────────────────────────────────────────────┘

Definisci: Nome, Ambito, Condizione (Quando…), Azione (Allora…) e Tipo di asset.

Nel dashboard vedi tutte le posizioni in cui è stata attivata una regola:

┌─────────────────────────────────────────────────────────┐
│ ⚠️ Azione richiesta (3)                                 │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ 🟡 AAPL 180 PUT         Profitto 50% raggiunto (52%)   │
│    Regola: Presa profitto 50%                           │
│    [Chiudi] [Ignora]                                    │
│                                                         │
│ 🔴 MSFT 400 CALL        21 DTE raggiunto (18 giorni)   │
│    Regola: Gestione 21 DTE                              │
│    [Roll] [Chiudi] [Ignora]                             │
│                                                         │
│ 🟡 TSLA Stock           Stop-loss quasi raggiunto (-9%)│
│    Regola: Stop-Loss 10%                                │
│    [Vendi] [Aggiusta stop] [Ignora]                    │
│                                                         │
└─────────────────────────────────────────────────────────┘

Ogni avviso mostra: simbolo, nome regola, valore corrente e pulsanti di azione. Il colore (🟡 giallo, 🔴 rosso) indica l'urgenza.

Nella vista dettaglio di una posizione vedi quali regole sono attive:

┌─────────────────────────────────────────────────────────┐
│ AAPL 180 PUT 2025-01-17                                 │
├─────────────────────────────────────────────────────────┤
│ ...Dettagli posizione...                                │
│                                                         │
│ 📋 REGOLE PER QUESTA POSIZIONE                         │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ✅ Portafoglio: Presa profitto 50% (attiva)        │ │
│ │ ✅ Portafoglio: Gestione 21 DTE (attiva)           │ │
│ │ ➕ Aggiungi regola per questa posizione...          │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

Vedi tutte le regole che si applicano a questa posizione (a livello di portafoglio, account o posizione). Con ➕ puoi creare direttamente una nuova regola per questa posizione.

Per le regole sono disponibili i seguenti tipi di condizione:

Tipo	Descrizione	Asset
PROFIT_PCT	Profitto in %	Tutti
LOSS_PCT	Perdita in %	Tutti
DTE	Giorni alla scadenza	Opzioni
DELTA	Valore Delta	Opzioni
IV_RANK	IV Rank/Percentile	Opzioni
POSITION_SIZE_PCT	Posizione > X% del portafoglio	Rischio
BUYING_POWER_PCT	Utilizzo BP > X%	Rischio
EARNINGS_DTE	Utili tra X giorni	Tutti

Per i curiosi dal punto di vista tecnico: il sistema memorizza le regole in tre tabelle:

1. trading_rule_presets (Preset di sistema)
Regole definite dall'admin che tutti gli utenti possono abilitare.

2. user_trading_rules (Regole utente)
Contiene preset attivati e regole personalizzate per ogni utente, con assegnazione dell'ambito.

3. trading_rule_triggers (Log attivazioni)
Registra quando e quale regola è stata attivata e come l'utente ha risposto (chiuso, ignorato, ecc.).

Questa struttura consente:
• Verifica rapida di tutte le regole attive
• Analisi della conformità alle regole nel tempo
• Report di conformità nel diario di trading

Per la popolare Wheel Strategy esistono regole speciali:

Regola	Descrizione
Solo azioni che vuoi possedere	Esegui la Wheel solo su azioni che terresti a lungo termine
Cash-Secured	Mantieni sempre liquidità sufficiente per l'assegnazione
CC alla resistenza	Piazza le Covered Call alla resistenza tecnica
CC non sotto il prezzo di carico	Non vendere mai Covered Call sotto il tuo prezzo di acquisto

Il sistema Trading Rules sarà sviluppato in fasi:

Fase 1: Fondamenta
• Creare tabelle del database
• Definire i preset di sistema
• Pagina admin per la gestione dei preset

Fase 2: Regole utente
• UI regole utente
• Attivazione dei preset di sistema
• Creare regole personalizzate

Fase 3: Motore regole
• Verifica automatica di tutte le regole
• Rilevamento attivazioni
• Registrazione di tutte le attivazioni

Fase 4: Avvisi & Notifiche
• Widget dashboard "Azione richiesta"
• Notifiche email
• Notifiche push (opzionale)

Fase 5: Integrazione
• Dettaglio posizione: mostra regole attive
• Inserimento trade: verifica rischio
• Diario di trading: analisi di conformità

⚠️ Nota: Il sistema Trading Rules è attualmente in fase concettuale. Le funzionalità descritte qui saranno implementate nelle versioni future.

Il tuo feedback è benvenuto per contribuire a modellare le funzionalità in modo ottimale! La documentazione tecnica dettagliata si trova in docs/concepts/TRADING-RULES.md.

Trading Lights è il tuo dashboard di stato del mercato in verde/giallo/rosso. Lo trovi nel dashboard e come widget della barra laterale. Mostra a colpo d'occhio se le condizioni di mercato attuali sono favorevoli per nuovi trade.

Cosa viene visualizzato?
Tre categorie, ciascuna con il proprio semaforo (verde/giallo/rosso):

• Ambiente macro — Indice Fear & Greed, VIX e Ampiezza del mercato NYSE come terzo indicatore (vedi sezione successiva).
• Contesto settoriale — il settore del tuo sottostante rispetto al mercato generale (RSI, stato SMA200).
• Stato del sottostante — il mercato specifico che stai osservando (tendenza, volatilità, movimenti recenti).

Logica di maggioranza invece di "vince l'indicatore peggiore": Ogni categoria riassume i suoi indicatori per maggioranza — se 2 su 3 sono verdi, la categoria è verde. Questo impedisce a un singolo outlier rosso di negare un'intera categoria.

Cliccando su un semaforo si apre un modale con spiegazioni adatte ai principianti per ogni indicatore — cosa significa il valore, come si confronta storicamente e quali azioni vengono suggerite.

L'ampiezza del mercato misura se un movimento di mercato è guidato da molte azioni o solo da pochi titoli a grande capitalizzazione. Un S&P 500 che sale perché 7 mega-cap sono in rialzo è meno sano di uno che sale perché 400 azioni sono in rialzo.

Singularity Trader calcola automaticamente quattro indicatori di ampiezza NYSE ogni 3 ore:

• Rapporto A/D (Advance/Decline) — rapporto tra azioni in rialzo e in ribasso sul NYSE. Valori > 2,0 = rally ampiamente supportato; < 0,5 = vendita generalizzata.
• McClellan Oscillator — indicatore di momentum dell'ampiezza livellato. Positivo = ampio slancio al rialzo, negativo = ampio slancio al ribasso. I crossover della linea zero sono segnali classici.
• NYSE > MA 50d — percentuale di azioni NYSE sopra la loro media a 50 giorni. > 70% = caldo (rischio di surriscaldamento), < 30% = freddo (potenziale ambiente di setup).
• Rapporto High/Low — rapporto tra nuovi massimi e minimi a 52 settimane. Le divergenze dall'indice sono spesso segnali di avvertimento precoci.

Dove lo vedi:
• Nel modale Trading Lights come terzo indicatore macro
• Nel tab Mercati come propria riga di metriche
• Nel dashboard sotto "Contesto di mercato"
• Come heatmap di dettaglio nella pagina di analisi del mercato

In una frase: Ampiezza verde = "Il mercato ti porta"; ampiezza rossa = "Stai nuotando controcorrente".