📖 BOS-BOURSE — Guide d'utilisation

🚀 Bienvenue sur BOS-BOURSE

BOS-BOURSE est ton outil d'analyse boursière personnel. Tu es déjà connecté — cette page contient tout ce qu'il faut savoir pour bien l'utiliser.

Comment ça marche en 2 lignes : chaque soir après la fermeture des marchés, BOS analyse ~360 actions et ETF, leur attribue un verdict (RENFORCER / CONSERVER / ALLEGER / SORTIR) en fonction de leurs indicateurs techniques, fondamentaux et du contexte macro, puis t'affiche les meilleures opportunités du jour selon ton profil.

🗺️ Le tour du propriétaire — les 10 pages

BOS-BOURSE c'est une dizaine de pages reliées par la barre de navigation en haut. Voici à quoi sert chacune :

📅 Le flow quotidien recommandé

Pour profiter au mieux de BOS-BOURSE, voici la routine de 5 minutes :

1. Le matin, ouvre 🩺 Bilan et clique "Charger mon bilan". Tu vois en un coup d'œil : KPI cross-enveloppes, breakdown des actions proposées par enveloppe, et tableau "Actions concrètes à exécuter" (triées par urgence).
2. Pour chaque action proposée, BOS te dit exactement combien acheter/vendre, à quel prix et avec quel type d'ordre (LIMITE ou MEILLEURE LIMITE). Tu passes les ordres chez ton broker.
3. De retour sur BOS, clique "✅ J'ai exécuté" sur chaque mouvement passé. Modal pré-rempli, ajuste si tu n'as pas fait exactement la qty/prix proposé, et valide. BOS met à jour automatiquement ton portefeuille + ton cash + activera un "cooldown 7 jours" pour ne pas te reproposer le même mouvement.
4. Optionnel : ouvre 🔔 Activité pour voir ce qui bouge dans ton monde : annonces réglementaires sur tes positions, earnings à venir, état macro.
5. En fin de semaine : 📊 Performances pour le bilan, et 📜 Mes exécutions si tu veux exporter ton journal en CSV.

🎯 4 verdicts à connaître

Sur chaque titre, BOS affiche un verdict opérationnel :

• RENFORCER — opportunité d'achat. Pour les picks, c'est l'équivalent d'ACHETER. Pour tes positions actuelles, c'est AMPLIFIER.
• CONSERVER — rien à faire. Position à garder telle quelle.
• ALLEGER — réduire l'exposition. BOS te propose une qty à vendre.
• SORTIR — sortie complète. Liquider la position entièrement.

📥 Importer un portefeuille

Pour que BOS-BOURSE analyse tes positions et te donne des verdicts personnalisés (vs. les picks publics), tu dois lui indiquer ce que tu détiens. Trois voies, par ordre de simplicité :

1️⃣ Import CSV BForBank (le plus simple si tu es chez BForBank)

1. Sur ton espace BForBank, exporte les fichiers POSITIONS_*.csv de chacune de tes enveloppes (PEA, PEA-PME, CTO)
2. Optionnel mais utile : exporte aussi HISTORY_*.csv — BOS détectera tes dates d'acquisition (utile pour le suivi PEA 5 ans)
3. Sur la page Mes positions, déplie Import CSV et dépose tous les fichiers d'un coup
4. Les positions s'affichent, le cash espèces est détecté, tu cliques 💾 Enregistrer tout

2️⃣ Import par image / PDF (OCR Claude Vision)

Tu n'es pas chez BForBank ? Tu as une capture d'écran d'un autre courtier (Boursorama, Trade Republic, Degiro, etc.) ou un PDF d'extrait ? BOS-BOURSE peut lire ça.

1. Sur Mes positions, déplie 🖼️ Importer depuis une image (OCR)
2. Choisis ta méthode d'extraction :
   • 🎁 Clé Claude Vision admin — précision max, gratuit dans la limite de 10 appels/user. Recommandé.
   • 🔑 Ma propre clé Claude Vision — illimité, ~0,001 €/image à ta charge. Tu dois avoir stocké ta clé Anthropic au préalable via le bouton 💾 Stocker ma clé Anthropic perso qui apparaît juste à côté du radio (modal qui s'ouvre dans la page Mes positions).
   • 📖 Tesseract.js (gratuit, dans le navigateur) — gratuit illimité, qualité variable, aucune donnée envoyée. Ne fonctionne pas sur les PDF.
3. Upload une à trois images / PDF de ton portefeuille
4. Clique 🚀 Lancer l'extraction
5. BOS détecte l'enveloppe, le cash, et les positions. Tu valides → les lignes apparaissent dans le tableau
6. Pour chaque ligne, clique 🔄 Yahoo pour résoudre le ticker, puis 💾 Enregistrer tout

3️⃣ Saisie manuelle

Pour ajouter une ligne à la main : sur Mes positions, sélectionne l'enveloppe et clique ➕ Ajouter une ligne. Remplis ticker (ex. MC.PA) ou ISIN (ex. FR0000121014), quantité, PRU, date d'acquisition. Clique 🔄 Yahoo pour qu'il complète automatiquement nom, ISIN/ticker manquant, et historique des prix.

🎯 Comprendre les verdicts

Chaque analyse aboutit à un verdict d'action sur 4 niveaux :

D'où vient le verdict ?

BOS-BOURSE croise plusieurs signaux déterministes (pas de magie IA, des règles claires) :

• Tendance : position du prix vs. moyennes mobiles 50 et 200 jours
• Momentum : RSI, MACD, performance 1m/3m/6m
• Fondamentaux (sur les actions) : P/E, ROE, marge nette, dette, croissance
• Qualité : volatilité annualisée, drawdown max, stabilité
• Risque / horizon : classification automatique en risque (faible / modéré / élevé) et horizon (court / moyen / long)

📰 Picks du jour

La page d'accueil est ta newsletter quotidienne. Chaque jour vers 18h (fin de séance Europe), un cron tourne et produit la sélection.

Sections de la page

• Top 3 du jour — les 3 meilleures opportunités (clic = scroll automatique vers le pick correspondant)
• Picks par enveloppe — PEA, PEA-PME, CTO. Chaque pick a un verdict + une argumentation
• Modalité d'ordre vulgarisée — bouton 💡 sur chaque pick qui explique en clair le type d'ordre suggéré (limit/market/stop)
• Recommandation d'achat avec frais — bloc vert sur les picks "RENFORCER" : quantité conseillée, frais broker, total tout compris. Bouton 🔍 Comparer brokers en haut à droite de ce bloc — affiche un classement des frais sur ton ordre chez tous les brokers disponibles (BforBank, BoursoBank, CA Invest Store, Spuerkeess, BGL BNP, Keytrade Lux, DEGIRO, Interactive Brokers).
• Marquer pick exécuté — quand tu passes un ordre, clique sur le pick → modal pour enregistrer ta date d'exécution, ta quantité, ton prix

Sélecteur de date

Tu peux revenir voir n'importe quel pick passé via le sélecteur de date dans le header (à droite). Utile pour comprendre pourquoi un signal est passé, comparer à l'actualité du jour, etc.

📋 Mes positions

C'est ton inventaire personnel : ce que tu possèdes réellement aujourd'hui, par enveloppe.

Lecture du tableau

• Type — STOCK ou ETF, le tri trie STOCK avant ETF
• Date d'acq. — date du dernier ACHAT (récupérée du HISTORY BForBank si dispo)
• PRU — prix de revient unitaire pondéré
• Dernier — dernier prix EOD connu en base
• Valorisation — qté × dernier, avec plus/moins-value affichée

Filtres et recherche

En haut du tableau, une barre permet de filtrer par enveloppe (PEA / PEA-PME / CTO) et de chercher par ticker, ISIN ou nom. Les sous-totaux en bas de tableau s'adaptent au filtrage.

Actions par ligne

• 🔄 Yahoo — récupère / met à jour ticker, nom, ISIN, dernier prix depuis Yahoo Finance (avec fallback ISIN via OpenFIGI si nécessaire)
• 🗑 — supprimer la ligne

Actions globales

• 🔄 Récupérer les prix manquants — boucle sur les positions sans dernier prix EOD et lance une importation
• 🔍 Résoudre tous les tickers — pour les positions qui n'ont qu'un ISIN, cherche le ticker correspondant dans la watchlist
• 💾 Enregistrer tout — persiste tes modifications en base D1 chiffrée

📊 Vitrine

La vitrine présente 9 portefeuilles auto-pilotés, gérés mécaniquement par BOS-BOURSE selon une logique stable. C'est ce que ferait un investisseur qui suivrait strictement les signaux, sans biais émotionnel.

Vitrine globale

• Vue d'ensemble des 9 portefeuilles (perf cumulée, drawdown, sharpe)
• Sélection d'un benchmark de comparaison (MSCI World par défaut, ou un autre parmi les 7 indices proposés)
• Graphique base 100 avec forward-fill pour aligner les séries

Vue détail

Clique sur un portefeuille pour voir ses positions actuelles, son historique de mouvements, sa courbe vs. le benchmark choisi. Bouton 📄 Télécharger PDF qui génère un rapport similaire à ce qui se fait dans le secteur financier (le portefeuille + une page sommaire qui compare les 9 portefeuilles).

🔍 Analyse on-demand

Sur la page Analyser, tu peux entrer n'importe quel ticker (ex. MC.PA, AAPL) ou ISIN (ex. FR0000121014) pour obtenir une analyse complète immédiate.

Les 5 sections de l'analyse

1. Identification — nom officiel, ISIN, ticker, place de cotation, devise
2. Métriques publiques — fondamentaux (P/E, ROE, dette, croissance) si action ; structure (frais, encours, indice répliqué) si ETF
3. Historique skill — graphique de prix sur 180 jours avec les verdicts passés superposés
4. Classification recommandée par BOS — enveloppe conseillée (PEA / PEA-PME / CTO), profil de risque, horizon, plus une explication en clair
5. Verdict d'action BOS — ACHETER / RENFORCER / CONSERVER / ALLÉGER / SORTIR / AVOID avec argumentation transparente et alertes éventuelles

Ticker non trouvé ?

Si l'instrument n'est pas dans la watchlist BOS, ta recherche est enregistrée dans instruments_waiting. L'admin peut alors la valider et l'ajouter à la watchlist (le cron fetchera l'historique des prix à la prochaine exécution).

🔄 Rebalancing par enveloppe

Depuis la page Mes positions, 3 boutons en haut à droite — 🩺 Analyser PEA, 🩺 Analyser PEA-PME, 🩺 Analyser CTO — ouvrent la page dédiée /rebalance.html qui te dit position par position quoi faire concrètement sur cette enveloppe.

Comment ça marche

BOS lit ta composition actuelle (les positions chiffrées AES côté serveur), récupère pour chaque ligne le verdict skill du jour + le score de fit avec ton profil choisi (Low / Balanced / High), puis applique 4 règles dans cet ordre :

1. Cap concentration : si une position dépasse 20% du portefeuille → REDUIRE (peu importe le verdict skill)
2. Verdict ALLEGER du skill → REDUIRE 25%
3. Verdict RENFORCER + fit profil ≥ 50/100 → AMPLIFIER (+5% du portefeuille)
4. Fit profil < 30/100 → REDUIRE 15%
5. Sinon → CONSERVER (rien à faire)

Profils factoriels (Fama-French)

Les 5 facteurs académiques qui expliquent la performance long terme : Value, Quality, Momentum, Size, Low Vol. Chaque profil pondère ces facteurs différemment :

• LOW (défensif) : Quality 40% / Low Vol 30% / Value 20% / Momentum 10% / Size 0%
• BALANCED (équilibré) : Quality 25% / Low Vol 25% / Value 25% / Momentum 25% / Size 0%
• HIGH (offensif) : Momentum 30% / Size 25% / Value 20% / Quality 15% / Low Vol 10%

Le "fit score" d'une position est calculé comme la moyenne pondérée des scores facteurs de ce titre par les poids du profil cible. Plus le fit est haut, mieux la position colle à ce profil.

Mouvement chiffré

La colonne "Mouvement proposé" affiche directement VENDRE 50 parts ~290 € ou ACHETER 12 parts ~580 € avec la raison principale. Si tu n'as pas le cash pour l'achat proposé, un ⚠ apparaît à côté du montant.

🩺 Bilan global multi-enveloppes

La page Bilan agrège tes 3 enveloppes (PEA + PEA-PME + CTO) en une vue exécutive consolidée. Idéal pour avoir ta photo complète d'un coup avant de te connecter à ton broker.

Contenu

• KPI cross-enveloppes : total portefeuille, valeur investie, cash dispo total, nombre de positions
• 3 cards résumé (une par enveloppe) avec breakdown des actions (X AMPLIFIER / Y CONSERVER / Z REDUIRE) + top action affichée + lien vers le détail rebalancing
• Exposition factorielle globale pondérée par valeur cross-enveloppes
• Tableau "Actions concrètes à exécuter" agrégé toutes enveloppes, trié REDUIRE (urgence) en premier puis montant décroissant
• Export PDF style banque privée — fiche A4 que tu peux conserver ou envoyer

Sous le capot

Le frontend fait 3 appels parallèles à /api/rebalance?envelope=... via Promise.all, puis agrège côté client. Pas de calcul backend dédié — toute la logique est la même que sur la page Rebalancing détaillée. Tu peux changer profil/horizon dans la toolbar et tout se recalcule en temps réel.

📜 Annonces réglementaires Euronext

BOS télécharge chaque jour le flux RSS officiel d'Euronext (live.euronext.com/rss/company-pr-release) qui contient toutes les press releases réglementées des sociétés cotées sur Paris/Amsterdam/Bruxelles/Lisbonne/Milan/Oslo/Dublin.

Topics couverts

• Résultats financiers (semestriels, annuels, trimestriels)
• OPA / Tender offers / Mergers / Acquisitions
• Changes in Capital / Augmentations de capital
• Dividendes annoncés / Ex-dates
• Major shareholding notifications (BlackRock, Vanguard, etc.)
• Buyback programmes
• Convocations AG

Badge dans la newsletter

Sur chaque card pick, tu vois un badge à droite du verdict :

• 🔥 X annonces (rouge) — au moins une OPA/Merger/Tender annoncée dans les 7 derniers jours. Lis avant de prendre position.
• 💰 X annonces (orange) — résultats financiers, dividende ou changement de capital. Mouvement de cours probable.
• 📢 X annonces (bleu) — autres annonces réglementaires (gouvernance, info technique). Info contextuelle.

Détail dans la page Analyse

La Section 8 📜 Annonces réglementaires Euronext sur /analyse.html liste les 20 dernières annonces du ticker avec date, topic et titre cliquable (lien vers le communiqué officiel sur Euronext).

📊 Indicateurs avancés (skill v2.0f)

🌍 Macro overlay FRED

Le skill v2.0f intègre 3 indicateurs macro officiels FRED (Federal Reserve Economic Data) avant de donner son verdict :

• T10Y2Y — spread Treasury 10 ans − 2 ans. Si négatif (yield curve inversée) + volatilité du titre > 30% → BOS downgrade automatiquement RENFORCER en CONSERVER.
• VIX — indice de la peur. Si > 30 + vol titre > 30% → CONSERVER. Si > 40 + vol > 40% → ALLEGER forcé.
• DFF — Fed Funds Rate. Pour contexte (pas de règle directe).

Un bandeau coloré (vert / orange / rouge) en haut de la newsletter résume l'état macro courant. Sur la page Analyse, un badge "🌍 Macro" à côté du verdict indique si une règle macro s'applique au titre.

🎯 Factor Exposure (Fama-French)

Pour chaque action (pas les ETF), BOS calcule 5 scores [0-100] vs facteurs académiques : Value, Quality, Momentum, Size, Low Vol. Le facteur dominant (≥ 70) apparaît comme badge sur la card pick (ex : "📈 Momentum 78"). C'est utile pour comprendre pourquoi ce titre est dans tes picks et pour aligner avec ton profil (voir Rebalancing).

📅 Earnings Calendar

BOS récupère hebdomadairement les dates de prochains earnings via yfinance. Si une position détenue a un earnings dans les 30 prochains jours, badge sur la card :

• ⏰ Earnings AUJOURD'HUI / DEMAIN / dans Nj (rouge si ≤ 5j) — la volatilité est imprévisible autour de ces dates, BOS bloque les achats / amplifications en mode vitrine 5 jours avant earnings.

📰 News Sentiment (Claude Haiku)

Pour les picks RENFORCER de la newsletter, BOS analyse les news 48h via l'API Claude Haiku qui scrute le sentiment de chaque article (−1 à +1). Si moyenne ≤ −0.5 ET au moins 2 news négatives, le verdict est downgrade en CONSERVER (anti-piège news négative récente). Badge sur la card : 😊 sentiment positif / 😐 neutre / 😟 négatif / 🚨 très négatif.

🌙 Apparence

Le bouton 🌙 / ☀️ dans la nav-bar bascule entre mode clair et mode sombre. Le choix est mémorisé dans ton navigateur (localStorage).

❓ FAQ

C'est quoi un "profil" low / balanced / high ?

Un profil est une répartition des facteurs académiques qui va guider les recommandations BOS sur ton portefeuille :

• Low (défensif) : tu privilégies les boîtes solides et stables (Quality + Low Vol). Convient si tu es proche de la retraite ou si tu n'aimes pas voir ton portefeuille bouger.
• Balanced (équilibré) : tu mélanges toutes les approches à parts égales. Convient à la majorité.
• High (offensif) : tu cherches la croissance et tu acceptes de la volatilité (Momentum + Smallcaps + Value). Convient si tu as > 15 ans d'horizon et un appétit pour le risque.

Pourquoi le verdict skill dit CONSERVER et le mouvement proposé dit REDUIRE ?

Ce n'est pas une contradiction, c'est le cap concentration qui prime. Si une position fait plus de 20% de ton portefeuille (parce qu'elle a beaucoup monté), même si elle reste fondamentalement bonne, la prudence dit qu'il faut alléger pour ne pas avoir tous tes œufs dans le même panier. C'est une règle de risk management qui s'applique au-dessus du verdict skill fondamental.

C'est quoi un "facteur Fama-French" ?

Eugene Fama (Prix Nobel 2013) et Kenneth French ont identifié plusieurs facteurs qui expliquent statistiquement la performance long terme des actions : Value (boîtes sous-évaluées), Quality (rentables), Momentum (qui montent), Size (smallcaps), Low Vol (peu volatiles). Chaque facteur a tendance à surperformer le marché sur des décennies (avec variations de cycle). BOS calcule pour chaque action ton portefeuille un score sur ces 5 facteurs et te dit lesquels dominent.

Le badge "🔥 1 annonce" sur un pick, ça veut dire quoi ?

Une annonce réglementaire Euronext de type OPA / Merger / Tender Offer / Acquisition a été publiée dans les 7 derniers jours. Avant d'acheter ou vendre cette ligne, lis le communiqué officiel (clique sur le badge ou va sur la page Analyse section 8). Une opération corporate change la donne fondamentale d'un titre.

Mon ticker n'est pas trouvé dans la watchlist, que faire ?

Sur la page Analyser, tape ton ticker ou ISIN et lance l'analyse. Si l'instrument est inconnu, il est mis en attente et l'admin reçoit la demande. Tu peux aussi demander à l'admin directement de l'ajouter.

J'ai épuisé mes 10 appels OCR gratuits, comment continuer ?

Trois options :

• Demander à l'admin de revoir le quota de ton compte (c'est quand même lui qui paie chaque traitement)
• Stocker ta propre clé Anthropic via le bouton 💾 Stocker ma clé Anthropic perso qui apparaît dans le bloc OCR de la page Mes positions. Tu paieras alors ~0,001 €/image à ta charge.
• Utiliser Tesseract.js, gratuit illimité mais qualité moindre (pas de PDF).

Pourquoi BOS prend en compte tantôt 30 jours, tantôt 90, tantôt 180 ?

Les fenêtres de calcul varient selon l'usage : 30j pour le momentum court, 90j pour les graphiques de verdict historique, 180j pour l'analyse on-demand, plusieurs années pour la qualité (volatilité annualisée et drawdown max). Chaque fenêtre est choisie pour bien capter le signal sans trop de bruit.

Mon portefeuille personnel n'est-il pas exposé à d'autres users ?

Non. Chaque user voit uniquement ses propres positions. Les positions sont chiffrées AES-256-GCM en base, avec une clé dérivée par email — même un accès admin sur la base de donnée n'est pas possible. La base est totalement encryptée.

Quel est le coût de l'OCR ?

~0,001 € par image avec Claude Haiku 4.5 (le modèle utilisé). Les 10 appels gratuits par user et le quota global mensuel de 500 appels sont une enveloppe que l'admin a fixée pour partager sa clé sans surprise. Au-delà, soit l'admin t'attribue un quota illimité, soit tu paies avec ta propre clé, soit tu passes en Tesseract.

Le quota mensuel se réinitialise quand ?

Le compteur global mensuel se remet automatiquement à zéro le 1er de chaque mois (clef = mois ISO YYYY-MM en D1). Le compteur individuel par user, lui, cumule à vie sauf si l'admin le reset manuellement.

Comment savoir si une nouvelle version a été déployée ?

Recharge la page (Ctrl+F5 sur Windows / Cmd+Shift+R sur Mac) pour forcer un fetch frais. Les Pages Cloudflare propagent les changements en quelques secondes au monde entier.

⚙️ Aide technique

Si tu es admin, tu as accès à la documentation technique détaillée : architecture, tables D1, cron, scoring, etc. — voir Aide technique.