# GeoOptions Intelligence — Guide d'utilisation

## Démarrage

```powershell
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 0–100 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
