Files
OpenFin/GUIDE.md
OpenSquared d256b65d30 Initial commit — GeoOptions Intelligence Cockpit v2.0
Stack: FastAPI + React/TypeScript + SQLite + GPT-4o
Features: Radar géopolitique, Marchés, Régime Macro, Journal de Bord MTM,
Rapport IA, Super Contexte (base de raisonnement évolutive), Boucle feedback IA.
Deploy: Docker + docker-compose + nginx pour openfin.open-squared.tech

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-16 20:29:59 +02:00

6.9 KiB
Raw Blame History

GeoOptions Intelligence — Guide d'utilisation

Démarrage

powershell -ExecutionPolicy Bypass -File c:\DataS\OpenFin\start.ps1

Le script tue les anciens processus, démarre le backend (port 8000) et le frontend (port 5173), puis ouvre automatiquement http://localhost:5173 dans le navigateur.


Les 9 pages

1. Cockpit (page d'accueil)

Vue centrale de pilotage. S'actualise toutes les minutes.

Zone Ce qu'elle montre
Risque Géopolitique Score 0100 calculé depuis les flux RSS en temps réel
Cartographie risques Radar par catégorie (énergie, métaux, agriculture…)
Patterns actifs Top 3 patterns déclenchés avec leur score de similarité
Catalyseurs Prochains événements économiques importants
Top 10 idées Idées de trades générées automatiquement (≈1000€, horizon 3 mois)
Marchés Prix en direct : énergie, métaux, indices, forex

Ajouter un trade depuis une idée : cliquer sur "+ Ajouter au portefeuille" sur une carte idée. La position est créée automatiquement avec le prix Black-Scholes du moment comme référence d'entrée.

Top 10 IA (bouton bleu, requiert clé OpenAI) : envoie le contexte géopolitique live à GPT-4o qui génère et classe les 10 meilleures opportunités du moment.


2. Radar Géopolitique

Analyse des flux d'information géopolitique.

  • Flux RSS : actualités classées par catégorie (conflit, énergie, santé, politique)
  • Patterns déclenchés : liste complète avec score, actif ciblé et direction suggérée
  • Score de risque détaillé : décomposition par sous-catégorie

3. Marchés & Prix

Cotations temps réel (délai 15 min via Yahoo Finance) pour les 28 instruments du watchlist :

  • Énergie : USO, XLE, UNG, BNO, OIL
  • Métaux : GLD, SLV, COPX, PPLT, GDX
  • Agriculture : WEAT, CORN, SOYB, JO, NIB
  • Indices : SPY, QQQ, IWM, EFA, EEM, VIX
  • Actions : XOM, CVX, LMT, MOS, AA
  • Forex : UUP, FXE, FXY, FXF, CYB

Graphiques historiques disponibles par instrument (1j à 5 ans).


4. Options Lab

Pricer Black-Scholes interactif.

  1. Choisir un sous-jacent (ou le taper manuellement)
  2. Sélectionner une stratégie : Long Call, Long Put, Bull Call Spread, Bear Put Spread, Long Straddle
  3. Régler strike, type, durée et quantité
  4. Cliquer "Calculer" → prix de l'option, Greeks (Δ Θ ν ρ), breakeven
  5. Courbe P&L : visualisation du gain/perte selon le prix du sous-jacent à expiration

La volatilité implicite (IV) est calculée automatiquement depuis l'historique de prix.


5. Patterns

Moteurs de détection géopolitique → signal de trade.

Patterns intégrés (8) : Middle East → Oil, US Tariffs → Agriculture, Geo Risk → Gold, Fed Hawkish → USD, China → Copper, Ukraine → Wheat, NG Disruption, Pandemic → VIX.

Créer un pattern personnalisé :

  1. Cliquer "Nouveau pattern"
  2. Remplir nom, description, mots-clés déclencheurs, actif ciblé, direction
  3. "Générer depuis un contexte" (IA) : décrire librement la situation géopolitique → GPT-4o-mini génère le pattern complet
  4. "Évaluer avec IA" : GPT-4o note le pattern sur 100 et indique ses forces/faiblesses
  5. Sauvegarder → le pattern est actif immédiatement dans le Cockpit

6. Portefeuille

Suivi mark-to-market en temps réel de toutes les positions.

Ajouter une position manuellement :

  1. Cliquer "Nouvelle position"
  2. Remplir : sous-jacent, stratégie, strike, type (call/put), prime payée, capital, durée
  3. Si la prime est renseignée → le P&L est calculé par rapport à cette prime réelle
  4. Si non → le prix Black-Scholes au moment de l'ajout sert de référence (P&L démarre à ~0€)

Lire une carte de position :

Champ Signification
Prime payée / Capital investi Référence d'entrée (BS au moment de l'achat si pas de prime réelle)
Valeur BS actuelle Prix Black-Scholes calculé avec le spot live
Spot sous-jacent Prix du sous-jacent récupéré en temps réel
Jours restants Temps avant expiration (rouge < 14j, orange < 30j)
Δ Θ ν Greeks nets de la position
Frais IB $0.65/contrat (min $1.00) simulés à l'entrée
P&L €/% (Valeur actuelle) (Référence entrée) (Frais IB entrée)

Clôturer une position : cliquer "Clôturer la position", entrer la valeur de revente → le P&L net (frais sortie inclus) est calculé et la position passe dans l'historique.

Supprimer une position : icône poubelle (positions ouvertes) ou hover sur la ligne (positions clôturées).

Courbe P&L : onglet "Courbe P&L" → equity curve cumulée de tous les trades clôturés.


7. Backtest

Simulation historique d'une stratégie sur une période passée.

  1. Choisir un sous-jacent, une stratégie, un strike et une durée
  2. Sélectionner la fenêtre historique (1 an, 2 ans…)
  3. Lancer le backtest → résultats : win rate, P&L moyen, max drawdown, sharpe ratio

8. Calendrier

Événements économiques à surveiller : Fed, BCE, NFP, CPI, OPEC, résultats trimestriels. Classés par importance (! moyen, !! élevé, !!! critique).


9. Configuration

Sources d'information : activer/désactiver les flux RSS et APIs externes (Reuters, AP, Al Jazeera, FT, Bloomberg, EIA, FRED, USDA, WHO…).

Clés API :

  • OpenAI : nécessaire pour le Top 10 IA, l'évaluation de patterns et l'analyse de discours
  • NewsAPI, EIA, FRED : sources optionnelles pour enrichir les données

Après avoir entré la clé OpenAI et cliqué Sauvegarder, le badge "IA GPT-4o active" apparaît dans la sidebar.


Workflow typique

1. Lancer start.ps1
2. Cockpit → lire le score de risque géopolitique
3. Patterns actifs → comprendre quels signaux sont déclenchés
4. Top 10 IA → générer les meilleures idées du moment
5. Options Lab → affiner le strike et visualiser la courbe P&L
6. "+ Ajouter au portefeuille" → position créée avec référence BS
7. Portefeuille → suivre l'évolution quotidienne
8. À terme → clôturer la position et voir la courbe P&L cumulée

Frais IB simulés

Nb contrats Frais entrée Frais sortie Total
1 $1.00 $1.00 $2.00
3 $1.95 $1.95 $3.90
5 $3.25 $3.25 $6.50
10 $6.50 $6.50 $13.00

1 contrat = 100 actions sous-jacentes. La prime s'exprime en $/share, la valeur totale en $/share × 100.


Notes importantes

  • Les prix sont en temps différé de 15 minutes (Yahoo Finance gratuit)
  • La volatilité implicite est calculée depuis l'historique de prix (pas le marché des options)
  • Les P&L sont en euros par convention d'affichage mais les sous-jacents sont cotés en dollars
  • Ce cockpit est un outil de simulation et d'aide à la décision — pas une interface de trading réel