Forex Calculator Pro — Documentation

---

Sommaire

1. Comment utiliser l'application
2. Déployer sur Netlify
3. Comment l'application a été codée
4. Formules de calcul
5. Structure des fichiers

---

1. Comment utiliser l'application

Étape 1 — Entrer ton capital

Tape le montant de ton compte de trading en euros (ex : 1000).

Étape 2 — Choisir la paire

Sélectionne la paire Forex dans le menu déroulant. L'app affiche automatiquement :

• Le type (Majeure / Mineure)
• La valeur pip en €/lot (ex : 8.50 €/lot pour EUR/USD)
• La volatilité (Faible / Modérée / Haute / Très haute)
• Le spread habituel

Étape 3 — Choisir la direction

• BUY (▲) : tu penses que le prix va monter
• SELL (▼) : tu penses que le prix va baisser

Étape 4 — Entrer les prix

Champ	Exemple	Description
Prix d'entrée	1.35025	Ton prix d'entrée exact
Stop Loss	1.34250	Niveau auquel tu coupes la perte
Take Profit 1	1.36220	Ton premier objectif
Take Profit 2	1.37000	Deuxième objectif (optionnel)

Bouton Live : appuie sur ⟳ Live pour récupérer le prix actuel automatiquement via une API gratuite. Utilise-le comme point de départ, puis ajuste selon ton analyse.

Important : utilise toujours le point comme séparateur décimal (1.35025 et non 1,35025)

Étape 5 — Choisir ton risque

Appuie sur un des boutons de risque : 1% / 2% / 3% / 5% / 10% / 15% / 20% / 30%

L'app affiche en dessous le montant en euros correspondant.

Recommandation (règles du PDF Traders Pro) :

• Débutant : 1% à 2% maximum
• Maximum absolu : 5%
• 10%–30% = trading agressif, à éviter au départ

Étape 6 — Lire les résultats

Grand affichage : LOT RECOMMANDÉ

C'est la taille de position idéale pour ton risque. Exemple : 0.08 = ouvrir un trade de 0.08 lot

Grille de résultats

Case	Signification
Risque réel	Perte maximale si ton stop loss est touché
SL Distance	Distance en pips entre ton entrée et ton SL
Profit TP1	Gain si le prix atteint ton TP1
Profit TP2	Gain si le prix atteint ton TP2
Ratio R/R	Rapport Risque/Rendement (vert ≥1.5, orange ≥1.0, rouge <1.0)

Tableau comparatif

Montre le lot size recommandé pour chaque niveau de risque (1% à 30%) avec le même Stop Loss — la ligne en or = ton choix actuel.

---

2. Déployer sur Netlify

Option A — Glisser-déposer (le plus simple, 2 minutes)

1. Va sur https://app.netlify.com
2. Crée un compte gratuit (ou connecte-toi)
3. Sur la page d'accueil, glisse le dossier forex-calculator/ directement dans la page
4. Netlify déploie automatiquement → tu reçois une URL du type https://xxxx.netlify.app
5. Accède à l'app depuis ton téléphone avec cette URL

Option B — Via GitHub (pour les mises à jour automatiques)

# 1. Initialise un dépôt Git dans le dossier
cd /Users/charles/Documents/trading/forex-calculator
git init
git add .
git commit -m "Initial commit - Forex Calculator Pro"

# 2. Crée un repo sur GitHub (via le site ou gh CLI)
gh repo create forex-calculator --public --push --source=.

# 3. Sur Netlify → "New site from Git" → connecte ton repo GitHub
# → chaque git push met à jour l'app automatiquement

Accès mobile

Une fois déployé, va sur ton téléphone, ouvre l'URL dans Safari/Chrome, puis "Ajouter à l'écran d'accueil" → l'app s'ouvre comme une vraie application.

---

3. Comment l'application a été codée

Technologies utilisées

Technologie	Rôle	Pourquoi
HTML5	Structure de la page	Standard du web
CSS3	Design et mise en page	Dark theme, mobile-first, animations
JavaScript	Logique de calcul	Tout le cerveau de l'app
Google Fonts (Inter)	Police de caractères	Lisibilité sur mobile
Currency API (jsdelivr)	Prix live	Gratuit, sans clé API, CORS ok

Aucun framework (React, Vue...) n'a été utilisé — l'app est un seul fichier HTML, ce qui la rend ultra-légère et déployable instantanément sur Netlify sans build.

Architecture du code JavaScript

index.html
│
├── PIP_DATA (objet)          → Les 28 paires avec valeur pip, type, volatilité, spread
│                               (data extraite de ton fichier Excel, onglet PAIRES)
│
├── state (objet)             → L'état de l'app (capital, paire, direction, prix, risque%)
│
├── Fonctions de calcul
│   ├── pipMultiplier()       → Retourne 10000 (normal) ou 100 (paires JPY)
│   ├── toPips()              → Calcule la distance en pips entre 2 prix
│   ├── calcLots()            → Formule principale : Risque€ ÷ (Pips_SL × PipVal)
│   └── buildCompTable()      → Génère le tableau comparatif des 8 niveaux de risque
│
├── Fonctions UI
│   ├── setDir()              → Bascule BUY / SELL
│   ├── setRisk()             → Met à jour le % de risque sélectionné
│   ├── updatePairMeta()      → Affiche les infos de la paire sélectionnée
│   ├── updatePipHint()       → Affiche les pips sous chaque champ de prix
│   └── calculate()           → Recalcule tout et met à jour l'affichage
│
└── fetchLivePrice()          → Appel API pour récupérer le prix actuel

Logique du design (CSS)

• Variables CSS : toutes les couleurs sont définies en :root → facile à modifier
• Mobile-first : width max 480px, centrée sur desktop
• Dark theme : fond #0d0f14, cartes #161923
• Animation : le lot size "pulse" (scale) à chaque nouveau calcul
• Touch targets : tous les boutons font au minimum 44px de hauteur

---

4. Formules de calcul

Extraites directement de ton fichier Excel Forex_Calculator_V6.xlsx, onglet MEMO :

Lots = Risque(€) ÷ (Pips_SL × Valeur_pip_par_lot)

Risque(€)      = Capital × (Risque% / 100)
Pips_SL        = |Prix_entrée - Stop_Loss| × 10000   [JPY: × 100]
Pips_TP        = |Prix_entrée - Take_Profit| × 10000  [JPY: × 100]
Profit_TP      = Pips_TP × Valeur_pip × Lots
Ratio_R/R      = Pips_TP / Pips_SL

Exemple concret (du fichier Excel) :

Capital     = 500 €
Risque      = 10% → 50 €
Paire       = GBP/USD (pip = 8.50 €/lot)
Entrée      = 1.35025
Stop Loss   = 1.34250
Pips SL     = |1.35025 - 1.34250| × 10000 = 77.5 pips

Lots = 50 ÷ (77.5 × 8.50)
     = 50 ÷ 658.75
     = 0.0759
     → arrondi vers le bas = 0.07 lot

Risque réel = 77.5 × 8.50 × 0.07 = 46.08 €

Note : les lots sont toujours arrondis vers le bas (Math.floor) pour ne jamais dépasser le risque prévu.

---

5. Structure des fichiers

forex-calculator/
├── index.html       ← L'application complète (HTML + CSS + JS)
├── netlify.toml     ← Configuration Netlify (cache, headers de sécurité)
└── README.md        ← Ce fichier de documentation

---

Application créée à partir des données de Forex_Calculator_V6.xlsx et des principes du livre "Les secrets des traders particuliers qui gagnent" (Traders_Pro.pdf)