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>
This commit is contained in:
OpenSquared
179
GUIDE.md
Normal file
179
GUIDE.md
Normal file
@@ -0,0 +1,179 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user