docs: v4.3 — trade lifecycle, exit defaults, PostgreSQL migration note

- Page 8 Journal de Bord: réécriture complète pour les 5 onglets, badges 🎯/🛑, barre Cible/Stop, modal de fermeture, onglet Fermés avec stats - Table des pages: Page 8 description mise à jour (Ouverts/Fermés/1-clic), Page 14 Config mention exit defaults, 15+ tables architecture - Section 10 Décisions: 2 nouvelles entrées (3 modes de fermeture, confirmation humaine toujours requise), note migration PostgreSQL - Glossaire: 4 nouvelles entrées (Cycle de vie, Exit Defaults, P&L Réalisé vs Théorique, Alert Type) - Footer et titre: v4.2 → v4.3 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-19 14:23:34 +02:00
parent ee69f3cbd9
commit 8122bd019c
1 changed files with 30 additions and 8 deletions
--- a/GeoOptions_Documentation_Complete.html
+++ b/GeoOptions_Documentation_Complete.html
@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>GeoOptions Intelligence — Manuel Complet v4.2</title>
+<title>GeoOptions Intelligence — Manuel Complet v4.3</title>
 <style>
 *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
 body { font-family: 'Georgia', 'Times New Roman', serif; font-size: 10.5pt; line-height: 1.65; color: #1a1a2e; background: #fff; max-width: 960px; margin: 0 auto; padding: 40px 48px; }
@@ -210,7 +210,7 @@ li { margin-bottom: 4px; font-size: 9.5pt; }
 │  └──────┬───────┘  └──────┬───────┘  └──────────┬───────────┘  │
 │         │                 │                       │              │
 │  ┌──────▼─────────────────▼───────────────────────▼───────────┐ │
-│  │              SQLite Database (14+ tables)                   │ │
+│  │              SQLite Database (15+ tables)                   │ │
 │  └────────────────────────────────────────────────────────────┘ │
 └──────────────────────────────────────────────────────────────────┘
         │                    │                    │
@@ -239,13 +239,13 @@ li { margin-bottom: 4px; font-size: 9.5pt; }
    <tr><td>5</td><td><strong>Options Lab</strong></td><td>IV Rank, IV Percentile, Term Structure, Skew, Open Interest pour tous tickers</td><td>Avant chaque trade</td></tr>
    <tr><td>6</td><td><strong>Patterns IA</strong></td><td>Suggestions du cycle en cours avec scores, tailles Kelly, contre-thèses</td><td>À chaque cycle (6h)</td></tr>
    <tr><td>7</td><td><strong>Portefeuille</strong></td><td>Positions ouvertes, P&L, concentration, alertes risque cluster</td><td>Quotidien</td></tr>
-    <tr><td>8</td><td><strong>Journal de Bord</strong></td><td>Trades historiques, filtres par pattern/date/résultat, statistiques de performance</td><td>Hebdomadaire</td></tr>
+    <tr><td>8</td><td><strong>Journal de Bord</strong></td><td>Trades ouverts (MtM + alertes cible/stop) · Trades fermés (P&L réalisé, win rate) · Fermeture 1-clic avec motif</td><td>Quotidien</td></tr>
    <tr><td>9</td><td><strong>Rapport IA</strong></td><td>Texte complet de la dernière analyse GPT-4o, raisonnement visible</td><td>À chaque cycle</td></tr>
    <tr><td>10</td><td><strong>Super Contexte</strong></td><td>Texte narratif enrichi injecté dans le méga-prompt : patterns matures, historique récent</td><td>Lecture mensuelle</td></tr>
    <tr><td>11</td><td><strong>Analytics</strong></td><td>Win rate par pattern, PnL cumulé, distribution des scores, calibration Brier</td><td>Mensuel</td></tr>
    <tr><td>12</td><td><strong>Analytics Avancées</strong></td><td>Clustering K-Means, matrices de transition, embeddings, déduplications sémantiques</td><td>Mensuel</td></tr>
    <tr><td>13</td><td><strong>Risk Dashboard</strong></td><td>HHI, drawdown attendu, alertes concentration facteur, Kelly par position</td><td>Avant chaque trade</td></tr>
-    <tr><td>14</td><td><strong>Config</strong></td><td>Paramètres système : seuils Kelly, capital, intervalles cycle, clé API, tickers</td><td>Initial + rare</td></tr>
+    <tr><td>14</td><td><strong>Config</strong></td><td>Paramètres système : seuils Kelly, capital, intervalles cycle, clé API, tickers · Objectif de gain/stop-loss par défaut (exit defaults)</td><td>Initial + rare</td></tr>
    <tr><td>15</td><td><strong>Knowledge Base</strong></td><td>Base de patterns manuels, demi-vie, tags géopolitiques, édition directe</td><td>Mensuel</td></tr>
  </tbody>
 </table>
@@ -1385,8 +1385,24 @@ Seuil : confidence &gt; 0.75 → ALERTE INVALIDATION générée dans l'UI
 <p><strong>Quand agir :</strong> Position mature en profit +15% → prise de bénéfices partielle. Perte &gt;20% avec trigger d'invalidation détecté → fermer immédiatement.</p>

 <h3>Page 8 — Journal de Bord</h3>
-<p><strong>Regarder en premier :</strong> Win rate par régime macro. Si win rate en "Stagflation" = 42% mais global = 65% → problème structurel avec ce régime.</p>
-<p><strong>Quand agir :</strong> Revue mensuelle. Pattern répété &gt; 5 fois avec win rate &lt; 45% → exclure de la KB ou réduire le score fiabilité manuellement.</p>
+
+<p>Le Journal comporte 5 onglets : <strong>Cycles IA</strong> · <strong>Régimes Macro</strong> · <strong>Ouverts</strong> · <strong>Fermés</strong> · <strong>Alertes Géo</strong>.</p>
+
+<p><strong>Onglet Ouverts (Mark-to-Market) :</strong></p>
+<ul>
+  <li>Chaque trade logué par le cycle affiche le <strong>P&L théorique</strong> en temps réel (prix actuel vs prix d'entrée), avec une <strong>barre Cible/Stop</strong> qui visualise la distance à l'objectif et au stop-loss.</li>
+  <li>Badge <code>🎯</code> = objectif de gain atteint (ex. +30%). Badge <code>🛑</code> = stop-loss déclenché (ex. -50%). Ces seuils sont configurés dans Config → "Paramètres de sortie" et peuvent être surchargés trade par trade.</li>
+  <li>Bouton 🔒 (colonne de droite) → ouvre le modal de fermeture : saisir le prix de clôture, choisir le motif (Objectif / Stop-loss / Signal IA / Manuel), ajouter une note. Le P&L réalisé est calculé automatiquement.</li>
+</ul>
+
+<p><strong>Onglet Fermés :</strong></p>
+<ul>
+  <li>Banderole de statistiques : <strong>win rate</strong>, <strong>P&L moyen</strong>, <strong>P&L total</strong>, <strong>meilleur trade</strong>.</li>
+  <li>Table complète avec dates d'entrée/sortie, durée de détention, P&L réalisé coloré, motif de fermeture, note libre.</li>
+</ul>
+
+<p><strong>Regarder en premier :</strong> Onglet Fermés → win rate sur les 30/60/90 derniers jours. Si win rate en "Signal IA retourné" &lt; 45% → les signaux de retournement sont trop tardifs, abaisser le seuil dans Config.</p>
+<p><strong>Quand agir :</strong> Badge 🎯 ou 🛑 visible dans l'onglet Ouverts → décider manuellement de fermer ou de laisser courir. Le système n'agit jamais automatiquement — la confirmation humaine est toujours requise.</p>

 <h3>Page 9 — Rapport IA</h3>
 <p><strong>Regarder en premier :</strong> Section "Risques à Surveiller" — liste les catalyseurs à calendrier connu (réunions Fed, publications PMI, élections).</p>
@@ -1422,7 +1438,9 @@ Seuil : confidence &gt; 0.75 → ALERTE INVALIDATION générée dans l'UI
    <tr><td><strong>Kelly × 1/3</strong></td><td>Taille fixe, Kelly × 1/2, Kelly complet</td><td>Taille fixe ignore l'edge du pattern. Kelly complet = draws de 60%+ psychologiquement insoutenables. Kelly × 1/3 = consensus académique (Ed Thorp, Poundstone) : 75% de la croissance théorique pour 30% du risque.</td></tr>
    <tr><td><strong>Gate 6h Super Contexte</strong></td><td>Régénérer à chaque cycle</td><td>Coût : ~0.015$ à régénérer. Sur cycles 15min : ~1.44$/jour. Gate 6h → 0.06$/jour. Le contenu change rarement sur 6h (trades ouverts et patterns KB évoluent lentement).</td></tr>
    <tr><td><strong>Trades matures uniquement dans le Super Contexte</strong></td><td>Inclure tous les trades ouverts</td><td>Un trade à 3.3% de son horizon (3j/90j) n'a pas testé la thèse. L'inclure envoie un signal bruit. Les trades matures (&gt;40% horizon) ont subi l'épreuve du temps et sont véritablement informatifs.</td></tr>
-    <tr><td><strong>SQLite</strong></td><td>PostgreSQL, MySQL</td><td>Usage mono-utilisateur sur VPS. SQLite = sans serveur, portable (fichier unique), supporte des centaines de milliers de lignes sans problème pour ce cas d'usage. PostgreSQL est justifié pour multi-utilisateurs ou millions de lignes.</td></tr>
+    <tr><td><strong>SQLite</strong></td><td>PostgreSQL, MySQL</td><td>Usage mono-utilisateur sur VPS. SQLite = sans serveur, portable (fichier unique), supporte des centaines de milliers de lignes sans problème pour ce cas d'usage. PostgreSQL est justifié pour multi-utilisateurs ou millions de lignes. <em>Migration estimée : 2–3j de travail (voir Section 10 note).</em></td></tr>
+    <tr><td><strong>Fermeture de trades en 3 modes</strong></td><td>Un seul mode (manuel)</td><td>Les trois modes (objectif %, stop-loss %, signal IA) répondent à trois comportements distincts. Un seul mode force un compromis dégradé. Les seuils configurables par trade (avec valeurs par défaut globales) évitent un réglage unique inadapté à tous les patterns.</td></tr>
+    <tr><td><strong>Confirmation humaine toujours requise</strong></td><td>Fermeture automatique sur signal</td><td>Un stop-loss ou signal IA peut être faux-positif (nouvelles partielles, pic intraday). L'auto-fermeture sur signal a été rejetée : risque de fermer sur noise. Le badge d'alerte + modal 1-clic est un bon compromis vitesse/contrôle.</td></tr>
    <tr><td><strong>Prior neutre (α=β=1)</strong></td><td>Prior basé sur le score GPT</td><td>Si l'on utilise le score GPT comme prior et que GPT est surconfiant (&gt;65%), on initialise avec un biais. Le prior de Jeffreys (α=β=1) laisse les données réelles parler sans polluer avec la surconfiance GPT.</td></tr>
    <tr><td><strong>GPT-4o-mini pour prompts simples</strong></td><td>GPT-4o pour tout</td><td>Scoring RSS et surveillance triggers ne nécessitent pas le raisonnement avancé de GPT-4o. GPT-4o-mini = 5× moins cher et suffisant pour classification et correspondance. Économie : ~60% du coût IA total.</td></tr>
    <tr><td><strong>Demi-vie KB de 180 jours</strong></td><td>Poids constant, demi-vie 365j</td><td>Les événements géopolitiques ont des cycles de vie naturels. Une crise qui dure &gt; 6 mois soit se normalise soit évolue structurellement. 180 jours = délai médian empirique entre émergence d'un événement géopolitique et intégration dans les prix.</td></tr>
@@ -1462,6 +1480,10 @@ Seuil : confidence &gt; 0.75 → ALERTE INVALIDATION générée dans l'UI
    <tr><td><strong>Matrice de Transition</strong></td><td>Matrice K×K où l'entrée (i,j) = probabilité de passer du régime i au régime j. Permet d'anticiper les transitions et d'ajuster les horizons de trading.</td></tr>
    <tr><td><strong>Anomalie K-Means</strong></td><td>Point à plus de 3σ du centroïde de son cluster. Signale des conditions hors-norme sans précédent récent (ex: VIX=48 en mars 2020). Exclu du calcul des centroïdes.</td></tr>
    <tr><td><strong>Embedding Vectoriel</strong></td><td>Représentation d'un texte comme vecteur haute dimension (1536 dims pour text-embedding-ada-002). Textes sémantiquement similaires → vecteurs proches (angle faible).</td></tr>
+    <tr><td><strong>Cycle de vie du trade</strong></td><td>Séquence complète : log automatique à l'entrée (cycle IA) → suivi MtM quotidien → alerte cible/stop → fermeture manuelle avec motif → archivage dans "Fermés" avec P&L réalisé. Le système ne ferme jamais automatiquement.</td></tr>
+    <tr><td><strong>Exit Defaults</strong></td><td>Seuils globaux de sortie configurés dans Config : objectif de gain (défaut +30%) et stop-loss (défaut -50%) exprimés en % du sous-jacent. Chaque trade peut surcharger ces valeurs. Appliqués à la volée dans l'onglet Ouverts du Journal.</td></tr>
+    <tr><td><strong>P&L Réalisé vs Théorique</strong></td><td>P&L théorique = (prix_actuel - prix_entrée) / prix_entrée, calculé en temps réel. P&L réalisé = valeur enregistrée au moment de la fermeture, stockée en base. Seul le P&L réalisé entre dans les statistiques win rate / average PnL.</td></tr>
+    <tr><td><strong>Alert Type</strong></td><td>Statut calculé à la volée sur chaque trade ouvert : <code>target_reached</code> si P&L ≥ seuil objectif, <code>stop_loss</code> si P&L ≤ seuil stop, <code>null</code> sinon. Déclenche le badge 🎯 ou 🛑 dans le Journal.</td></tr>
    <tr><td><strong>Cosine Similarity</strong></td><td>cos(θ) = (A·B)/(|A|×|B|). De -1 (opposés) à +1 (identiques). Mesure la direction (le sens) indépendamment de la norme. Seuil GeoOptions : &gt;0.75 = doublon.</td></tr>
    <tr><td><strong>Jaccard Similarity</strong></td><td>|A∩B|/|A∪B|. Mesure les mots communs entre deux textes. Simple mais aveugle aux synonymes et au sens sémantique. Seuil GeoOptions : &gt;0.30 = doublon.</td></tr>
    <tr><td><strong>DBSCAN</strong></td><td>Algorithme de clustering alternatif qui découvre des clusters de forme arbitraire et identifie les outliers. Non utilisé dans GeoOptions (K-Means suffisant pour 4 régimes fixes).</td></tr>
@@ -1483,7 +1505,7 @@ Seuil : confidence &gt; 0.75 → ALERTE INVALIDATION générée dans l'UI
 <hr>

 <div class="footer-doc">
-  <p>Document généré le 19 juin 2026 · GeoOptions Intelligence v4.2</p>
+  <p>Document généré le 19 juin 2026 · GeoOptions Intelligence v4.3</p>
  <p>FastAPI + React + SQLite + GPT-4o · Usage interne trader · Confidentiel</p>
  <p>Sections : Architecture · Cycle complet simulé · Phase 1 IV/Structure · Phase 2 Fiabilité/Calibration · Phase 3 Risk Engine · Phase 4 IA Probabiliste · 6 Prompts IA · 14+ Tables DB · Guide 15 pages · 10 Décisions conception · Glossaire 35+ termes</p>
 </div>