TOOLS · FAQ 14

// FAQ générale GhostfellahCorp — édition via commit sur data/faq.json

QUESTIONS 14
Alertes
Comment recevoir les alertes Forex Pulse sur Telegram ?
Réutilise les variables `TG_TOKEN` et `TG_CHAT_ID` déjà présentes dans `.env` (pas de configuration supplémentaire). Les conditions sont strictes : |score| ≥ 0.65, ≥ 4 familles alignées, ≥ 1 famille leading (flow/volatilité/positionnement) + cooldown 48h par paire/direction. Cible : 1–5 alertes/semaine sur tout l'univers.
Architecture
Comment mettre à jour les dépendances ?
Bump une dep : `uv lock --upgrade-package <nom>`. Réinstaller depuis le nouveau lock : `uv sync --extra dev`. Le `uv.lock` est commit et la CI valide qu'il est à jour avec `uv sync --frozen`.
Quelles sub-apps sont actuellement montées ?
/iw (InsidersWatch — Form 4 SEC), /fi (Financial Intelligence — régime, thèses), /onchain (OnchainVision), /corp (CorpXray — radiographie société + verdict d'allocation), /lighthouse (screener short squeeze), /commodities (monitoring multi-commodities), /forex (Forex Pulse — 24 paires), /tools (hub d'outils annexes).
Démarrage
Comment configurer le démarrage automatique au login Windows ?
Lancer `powershell -File scripts\install-tasks.ps1 -Cadence dashboard`. Cela crée la tâche planifiée `GFC_Dashboard` qui exécute `start-dashboard.ps1` à l'ouverture de session. Idempotent : si un dashboard tourne déjà sur le port, le script skip. Pour stopper : `powershell -File scripts\stop-dashboard.ps1`.
Comment lancer le dashboard en local ?
Option recommandée : `uv sync --extra dev` puis `uv run python -m ghostfellah`. Le dashboard est alors disponible sur http://localhost:8000. Option legacy : `python -m venv .venv` puis `pip install -r requirements-dev.txt` et `python -m ghostfellah`. Voir README.md à la racine.
LLM & Briefings
Comment l'authentification LLM est-elle gérée ?
Pas besoin de mettre une clé API dans `.env`. Le module détecte automatiquement les credentials Claude Code (`claude login`) ou bascule sur `ANTHROPIC_API_KEY` si la variable est présente. Le brief par défaut utilise Haiku 4.5 — coût < $0.005 par appel.
Légal
Forex Pulse est-il un robot de trading ?
Non. C'est un outil d'aide à la décision, pas un robot d'exécution. Le tick_volume Yahoo est un proxy du vrai volume interbancaire. Les paires EM peuvent gap sur événements politiques — aucun indicateur technique ne protège contre ça. Toute décision de trading reste sous ta responsabilité.
Puis-je redistribuer les données récupérées ?
Non. EDGAR / AMF / ECB / GDELT / Open Sanctions sont publiques mais non-redistribuables commercialement. Usage personnel et recherche uniquement. Pour la diffusion publique, il faut souscrire aux contrats de redistribution avec chaque source.
Migration
Qu'est devenu l'ancien dashboard Financial_Intelligence / InsidersWatch ?
Les dashboards `Financial_Intelligence/financial-intelligence/` et `InsidersWatch/` sont archivés en `../Financial_Intelligence.old/` et `../InsidersWatch.old/`. Le rationale est documenté dans `docs/superpowers/specs/2026-05-05-ghostfellahcorp-design.md`.
Sources de données
Quelles sont les sources utilisées par CorpXray ?
100% open : SEC EDGAR (XBRL + Form 4), yfinance + Stooq en fallback, GDELT v2 pour les news, Open Sanctions, et AMF/BaFin via Yahoo. Les données sont publiques mais non-redistribuables commercialement — usage personnel/recherche uniquement.
Quelles sont les sources utilisées par Forex Pulse ?
yfinance pour OHLC + tick_volume (proxy du vrai volume interbancaire), CFTC TFF pour le COT hebdo, FRED pour les yields 2Y G10. Seule FRED nécessite une clé gratuite (`FRED_KEY` ou `FRED_API_KEY` dans `.env`).
Tests & Qualité
Comment lancer la suite de tests ?
Tous les tests : `python -m pytest`. Par sub-app : `python -m pytest ghostfellah/apps/corp_xray/tests/ -v` (remplace `corp_xray` par la sub-app voulue). État au 2026-05-10 : 729 fonctions `test_*` réparties sur 62 fichiers, suite verte sur CI (matrice ubuntu + windows).
Tools
Que fait /tools/monitoring exactement ?
Affiche l'état des tâches planifiées Windows préfixées GFC_* (statut, fréquence, dernier/prochain run, dernier exit code), l'état des DB locales, et les 30 derniers runs avec coût USD/EUR. Boutons Run/Stop pour déclencher ou interrompre une tâche manuellement (schtasks /Run et /End).
À quoi sert la sub-app /tools ?
C'est le hub des utilitaires annexes : /tools/liens pour gérer les bookmarks et liens externes (CRUD SQLite), /tools/monitoring pour visualiser l'état des tâches planifiées GFC_*, /tools/faq pour cette FAQ. D'autres outils sont prévus (watchlist exporter, Notion sync, backtester, alert center).