📋 Règles de 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.

Les règles de trading sont des conditions prédéfinies qui vous aident à trader de manière disciplinée. Le système surveille automatiquement vos positions et envoie des alertes lorsqu'une règle est déclenchée. Ainsi, vous ne risquez jamais d'oublier une action importante.

Le Système de Règles de Trading :
• Vous rappelle automatiquement les règles importantes
• Avertit des violations des limites de risque
• Aide à documenter et analyser la conformité aux règles
• Supporte différents styles de trading (options, actions, etc.)

Le système de règles est basé sur deux dimensions fondamentales :

┌─────────────────────────────────────────────────────────────────┐
│                    DIMENSIONS DES RÈGLES                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  SOURCE                        PORTÉE (Applicabilité)           │
│  ┌──────────────┐              ┌──────────────────────────┐    │
│  │ Système      │              │ 🎯 Position              │    │
│  │ (Présets)    │              │    Une position          │    │
│  ├──────────────┤              │    spécifique            │    │
│  │ Utilisateur  │              ├──────────────────────────┤    │
│  │ (Personnalisé)│             │ 🏦 Compte                │    │
│  └──────────────┘              │    Un compte courtier    │    │
│                                ├──────────────────────────┤    │
│                                │ 💼 Portefeuille          │    │
│                                │    Tous les comptes      │    │
│                                └──────────────────────────┘    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

🔧 Présets Système
Les règles prédéfinies du système que vous pouvez activer en un clic. Celles-ci sont basées sur des pratiques de trading éprouvées et sont maintenues par l'équipe Singularity Trader.

Exemples :
• "50% Profit Take" - Fermer à 50 % du profit maximum
• "21 DTE Management" - Avertissement à 21 jours restants
• "200% Stop Loss" - Fermer à 2x perte de prime

✏️ Personnalisé (Défini par l'Utilisateur)
Vos propres règles que vous créez pour correspondre exactement à votre style de trading. Vous définissez le nom, la condition et l'action.

Chaque règle a une portée qui détermine à quelles positions elle s'applique :

Portée	Exemple de Règle	Cas d'Utilisation
🎯 Position	"Vendre cette position AAPL à +20%"	Plan commercial individuel
🏦 Compte	"Max 30% pouvoir d'achat dans ce compte"	Compte IRA conservateur
💼 Portefeuille	"Jamais plus de 5% dans une position"	Règle générale de risque

Les règles de position s'appliquent à une position spécifique. Elles vous permettent de définir un plan individuel pour chaque transaction.

Règles de Position Typiques :
• Prix Stop-Loss - par exemple, "Vendre si le prix tombe en dessous de $150"
• Cible de Profit - par exemple, "Fermer à +20%"
• Basé sur DTE - par exemple, "Fermer à 14 DTE"
• Avertissement ITM - par exemple, "Roll si l'option devient ITM"
• Plan commercial individuel

Cas d'Utilisation : Vous ouvrez une transaction et définissez immédiatement quand la fermer ou l'ajuster. Le système vous rappelle quand la condition est remplie.

Les règles de compte s'appliquent à un compte courtier. Elles vous aident à exécuter différentes stratégies par compte.

Règles de Compte Typiques :
• Max % Utilisation du Pouvoir d'Achat - par exemple, "Jamais plus de 50%"
• Max Positions Ouvertes - par exemple, "Max 10 positions"
• Classes d'Actifs Autorisées - par exemple, "Actions uniquement, pas d'options"
• Taille de Position Max dans ce compte
• Règles de marge spécifiques au compte

Cas d'Utilisation : Vous avez un compte IRA conservateur et un compte de trading agressif. Les règles de compte assurent que vous suivez des profils de risque différents.

Les règles de portefeuille s'appliquent à tous les comptes. Elles protègent votre richesse totale.

Règles de Portefeuille Typiques :
• Limite d'Exposition Totale - par exemple, "Max 200% du capital"
• Diversification Sectorielle - par exemple, "Max 20% en Tech"
• Taille de Position Max (total) - par exemple, "Max 5% dans une action"
• Limites de Corrélation - par exemple, "Avertissement si trop de transactions similaires"
• Règles de risque global

Cas d'Utilisation : Peu importe le nombre de comptes que vous avez, ces règles assurent que votre portefeuille total reste en sécurité.

Les règles sont organisées par catégorie selon quand elles s'appliquent :

📥 Règles d'Entrée (avant d'ouvrir)
Vérifications avant d'ouvrir une position :
• 45 DTE Entry - Options avec ~45 jours restants
• Delta 0.30 - Short puts à delta 0.30
• IV Rank > 50 - Vendre uniquement quand IV est élevé
• Éviter les Bénéfices - Pas de transactions sur les bénéfices

📤 Règles de Sortie/Gestion
Quand fermer ou ajuster les positions :
• 50% Profit Take - Fermer à 50% du gain maximum
• 21 DTE Management - Avertissement à 21 jours restants
• 200% Stop Loss - Fermer à 2x perte de prime
• Roll at ITM

⚠️ Règles de Risque
Limites à l'échelle du portefeuille :
• Règle 1-2% - Risque maximum par transaction
• Taille de Position 5% - Maximum par position
• 50% Pouvoir d'Achat - Ne jamais dépasser

🧠 Règles de Psychologie
Protection contre le trading émotionnel :
• 3 Perdants = Break
• Pas de Trading de Vengeance
• Plan Avant le Trading

Le moteur de règles est le cœur du système. Il surveille continuellement toutes vos positions et vérifie si les règles sont déclenchées :

┌─────────────────────────────────────────────────────────────────┐
│                       MOTEUR DE RÈGLES                          │
├─────────────────────────────────────────────────────────────────┤
│  Définition de la Règle (Admin/Utilisateur)                     │
│  • Nom, Description                                             │
│  • Type : Entrée / Sortie / Gestion / Risque                    │
│  • Condition (par exemple, DTE <= 21)                            │
│  • Action : Alerte / Avertissement / Blocage                    │
│  • Type d'Actif : Option / Action / Tous                        │
│  • Portée : Position / Compte / Portefeuille                    │
├─────────────────────────────────────────────────────────────────┤
│                              ↓                                  │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐    │
│  │ Tableau   │  │ Signaux   │  │ Vérification│  │ Système  │    │
│  │ de Bord   │  │ Surveillance│ │ Entrée    │  │ d'Alertes│    │
│  │ Widget    │  │           │  │           │  │           │    │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘    │
└─────────────────────────────────────────────────────────────────┘

Le moteur vérifie régulièrement toutes les règles actives et déclenche l'action appropriée lorsque les conditions sont remplies.

Les règles de trading sont intégrées à plusieurs endroits sur la plateforme :

Page	Intégration
Tableau de Bord	Widget "Action Needed" avec alertes de règles actives
Détail de la Position	Afficher les règles actives pour cette position
Entrée de Transaction	Vérification avant d'ouvrir (règles de risque)
Liste de Surveillance	Colonne Signaux basée sur les règles d'entrée
Notifications	Push/Email quand une règle se déclenche
Journal de Trading	Score de conformité aux règles par transaction

Ces types de conditions sont disponibles pour les règles :

Type	Description	Actif
PROFIT_PCT	Profit en %	Tous
LOSS_PCT	Perte en %	Tous
DTE	Jours d'Expiration	Options
DELTA	Valeur Delta	Options
IV_RANK	IV Rank/Percentile	Options
POSITION_SIZE_PCT	Position > X% portefeuille	Risque
BUYING_POWER_PCT	Utilisation PA > X%	Risque
EARNINGS_DTE	Bénéfices en X jours	Tous

⚠️ Remarque : Le système de Règles de Trading est actuellement en phase de concept. Les fonctionnalités décrites ici seront implémentées dans les versions futures.

Vos retours sont les bienvenus pour aider à façonner les fonctionnalités de manière optimale ! La documentation technique détaillée peut être trouvée à docs/concepts/TRADING-RULES.md.

Voici comment créer votre propre règle individuelle :

┌─────────────────────────────────────────────────────────┐
│ ➕ Nouvelle Règle                                        │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ Nom : [Ma Règle Stop-Loss____________________]          │
│                                                         │
│ Portée :                                                │
│ ○ 💼 Portefeuille (tous les comptes)                   │
│ ● 🏦 Compte : [Interactive Brokers ▼]                  │
│ ○ 🎯 Position : [Sélectionner une position...]         │
│                                                         │
│ Quand :                                                 │
│ [Perte %_____▼] [>=] [15__] [%]                        │
│                                                         │
│ Alors :                                                 │
│ [🔔 Envoyer une Alerte___▼]                            │
│                                                         │
│ Type d'actif : ○ Tous  ● Actions  ○ Options           │
│                                                         │
│              [Annuler]  [💾 Enregistrer]               │
└─────────────────────────────────────────────────────────┘

Vous définissez : Nom, Portée, Condition (Quand…), Action (Alors…) et Type d'actif.

Sur le tableau de bord, vous voyez toutes les positions pour lesquelles une règle a été déclenchée :

┌─────────────────────────────────────────────────────────┐
│ ⚠️ Action Requise (3)                                   │
├─────────────────────────────────────────────────────────┤
│                                                         │
│ 🟡 AAPL 180 PUT         50% profit atteint (52%)       │
│    Règle : Prise de profit 50%                          │
│    [Fermer] [Ignorer]                                   │
│                                                         │
│ 🔴 MSFT 400 CALL        21 DTE atteint (18 jours)      │
│    Règle : Gestion 21 DTE                               │
│    [Roller] [Fermer] [Ignorer]                          │
│                                                         │
│ 🟡 TSLA Stock           Stop-Loss presque atteint (-9%)│
│    Règle : Stop-Loss 10%                                │
│    [Vendre] [Ajuster Stop] [Ignorer]                    │
│                                                         │
└─────────────────────────────────────────────────────────┘

Chaque alerte affiche : Symbole, nom de la règle, valeur actuelle et boutons d'action. La couleur (🟡 jaune, 🔴 rouge) indique l'urgence.

Dans la vue détaillée d'une position, vous voyez quelles règles sont actives :

┌─────────────────────────────────────────────────────────┐
│ AAPL 180 PUT 2025-01-17                                 │
├─────────────────────────────────────────────────────────┤
│ ...Détails de la Position...                            │
│                                                         │
│ 📋 RÈGLES POUR CETTE POSITION                          │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ ✅ Portefeuille : Prise de profit 50% (active)     │ │
│ │ ✅ Portefeuille : Gestion 21 DTE (active)          │ │
│ │ ➕ Ajouter une règle pour cette position...         │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

Vous voyez toutes les règles qui s'appliquent à cette position (à l'échelle du portefeuille, du compte ou de la position). Avec ➕ vous pouvez directement créer une nouvelle règle pour cette position.

Les types de conditions suivants sont disponibles pour les règles :

Type	Description	Actif
PROFIT_PCT	Profit en %	Tous
LOSS_PCT	Perte en %	Tous
DTE	Jours avant Expiration	Options
DELTA	Valeur Delta	Options
IV_RANK	IV Rank/Percentile	Options
POSITION_SIZE_PCT	Position > X% du portefeuille	Risque
BUYING_POWER_PCT	Utilisation PA > X%	Risque
EARNINGS_DTE	Résultats en X jours	Tous

Pour les curieux de technique : le système stocke les règles dans trois tables :

1. trading_rule_presets (Préréglages Système)
Règles définies par l'admin que tous les utilisateurs peuvent activer.

2. user_trading_rules (Règles Utilisateur)
Contient les préréglages activés et les règles personnalisées pour chaque utilisateur, avec attribution de portée.

3. trading_rule_triggers (Journal de Déclenchement)
Enregistre quand quelle règle a été déclenchée et comment l'utilisateur a répondu (clôturé, ignoré, etc.).

Cette structure permet :
• La vérification rapide de toutes les règles actives
• L'analyse de la conformité aux règles dans le temps
• Le reporting de conformité dans le journal de trading

Pour la populaire Wheel Strategy, des règles spéciales existent :

Règle	Description
Uniquement des Actions que Vous Voulez Détenir	N'appliquez la Wheel qu'aux actions que vous détiendriez à long terme
Cash-Secured	Gardez toujours assez de cash pour l'assignation
CC à la Résistance	Placez les Covered Calls aux résistances techniques
CC Pas en Dessous du Prix de Revient	Ne vendez jamais de Covered Calls en dessous de votre prix d'achat

Le système de Trading Rules sera développé en phases :

Phase 1 : Fondation
• Créer les tables de base de données
• Définir les préréglages système
• Page admin pour la gestion des préréglages

Phase 2 : Règles Utilisateur
• UI des règles utilisateur
• Activation des préréglages système
• Créer des règles personnalisées

Phase 3 : Rules Engine
• Vérification automatique de toutes les règles
• Détection des déclenchements
• Journalisation de toutes les activations

Phase 4 : Alerts & Notifications
• Widget tableau de bord "Action Requise"
• Notifications par email
• Notifications push (optionnel)

Phase 5 : Intégration
• Détail de position : afficher les règles actives
• Saisie de trade : vérifications de risque
• Journal de trading : analyse de conformité

⚠️ Remarque : Le système de Trading Rules est actuellement en phase de concept. Les fonctionnalités décrites ici seront implémentées dans les versions futures.

Vos retours sont les bienvenus pour aider à façonner les fonctionnalités de manière optimale ! La documentation technique détaillée peut être trouvée à docs/concepts/TRADING-RULES.md.

Trading Lights est votre tableau de bord de statut de marché en vert/jaune/rouge. Vous le trouverez sur le tableau de bord et comme widget de barre latérale. Il montre d'un coup d'œil si les conditions de marché actuelles sont favorables pour de nouveaux trades.

Ce qui est affiché ?
Trois catégories, chacune avec son propre feu tricolore (vert/jaune/rouge) :

• Environnement Macro — Fear & Greed Index, VIX, et Largeur de Marché NYSE comme troisième indicateur (voir section suivante).
• Contexte Sectoriel — le secteur de votre sous-jacent comparé au marché global (RSI, statut SMA200).
• Statut du Sous-jacent — le marché spécifique que vous regardez (tendance, volatilité, mouvements récents).

Logique majoritaire plutôt que "le pire indicateur l'emporte" : Chaque catégorie résume ses indicateurs par majorité — si 2 sur 3 sont verts, la catégorie est verte. Cela empêche un seul indicateur rouge d'annuler une catégorie entière.

Cliquer sur un feu tricolore ouvre un modal avec des explications adaptées aux débutants pour chaque indicateur — ce que signifie la valeur, comment elle se compare historiquement, et quelles actions sont suggérées.

La largeur de marché mesure si un mouvement de marché est porté par de nombreuses actions ou seulement quelques poids lourds. Un S&P 500 qui monte parce que 7 méga-caps sont en hausse est moins sain qu'un qui monte parce que 400 actions sont en hausse.

Singularity Trader calcule automatiquement quatre indicateurs de largeur NYSE toutes les 3 heures :

• Ratio A/D (Advance/Decline) — ratio des actions en hausse par rapport aux actions en baisse sur le NYSE. Valeurs > 2,0 = rallye largement soutenu ; < 0,5 = vente massive généralisée.
• McClellan Oscillator — indicateur de momentum de largeur lissé. Positif = poussée haussière générale, négatif = poussée baissière générale. Les croisements de la ligne zéro sont des Signals classiques.
• NYSE > MA 50j — pourcentage des actions NYSE au-dessus de leur moyenne de 50 jours. > 70% = chaud (risque de surchauffe), < 30% = froid (environnement de setup potentiel).
• Ratio Hauts/Bas — ratio des nouveaux plus hauts sur 52 semaines par rapport aux plus bas. Les divergences avec l'indice sont souvent des Signaux d'alerte précoce.

Où vous voyez cela :
• Dans le modal Trading Lights comme troisième indicateur macro
• Dans l'onglet Marchés comme ligne de métrique propre
• Sur le tableau de bord sous « Contexte de Marché »
• Comme heatmap de détail sur la page d'analyse de marché

En une phrase : Largeur verte = « Le marché vous porte » ; largeur rouge = « Vous nagez à contre-courant ».