Configuration

Variables d'environnement

Configurez PnlTracker via le fichier .env à la racine du projet.

Toutes les options disponibles

# === PostgreSQL ===
POSTGRES_USER=pnltracker
POSTGRES_PASSWORD=CHANGE_ME_TO_STRONG_PASSWORD
POSTGRES_DB=pnltracker
POSTGRES_EXTERNAL_PORT=5432

# === Application ===
EXTERNAL_PORT=3000            # Port externe de l'application
APP_VERSION="prod_w_1.1.0"    # Version de l'application
DEBUG_MODE=false              # Mode debug (logs détaillés)
SHOW_LOG_VIEW=false           # Afficher le bouton de console (LogView)

# === Sécurité ===
JWT_SECRET=CHANGE_ME_TO_RANDOM_SECRET       # openssl rand -base64 32
ADMIN_API_TOKEN=CHANGE_ME_TO_RANDOM_SECRET

# === Fonctionnalités ===
QUANTOWER_ENABLE=true         # Activer l'import Quantower
PLUGINS_ENABLED=false         # Activer le système de plugins
POLYGON_API_KEY=              # Clé API Polygon.io (optionnel)

# === Serveur de stockage externe (optionnel) ===
STORAGE_SERVER_PORT=5000
STORAGE_SERVER_DEBUG=false
CLEANUP_DAYS_OLD=2

Configurer le port

Par défaut, PnlTracker utilise le port 3000. Pour changer :

EXTERNAL_PORT=8080

Redémarrez ensuite l'application.

Activer le système de plugins

Les plugins sont désactivés par défaut. Pour afficher l'onglet Plugins dans les paramètres :

PLUGINS_ENABLED=true

Activer le mode debug

Pour afficher les logs détaillés lors du développement ou du débogage :

DEBUG_MODE=true
SHOW_LOG_VIEW=true

Fuseau horaire par compte

Pour gérer des fuseaux horaires différents selon les comptes :

1. Allez dans Paramètres → Comptes
2. Éditez un compte
3. Activez Gérer le fuseau horaire au niveau du compte
4. Sélectionnez le fuseau horaire approprié

Structure des données

PnlTracker stocke ses données à deux endroits :

• Base de données PostgreSQL : tous les trades, comptes, tags et notes. Chaque base que vous créez dans l'application correspond à un schéma PostgreSQL isolé.
• Fichiers sur disque (dossier upload/) : les screenshots des trades et les plugins.

upload/
└── user_1_data/
    ├── database_test/
    │   ├── screenshots/   # Screenshots des trades
    │   └── plugins/       # Plugins installés
    └── database_db2/
        └── screenshots/

Avec Docker, ces données sont persistées dans deux volumes : pnltracker_pg_data (PostgreSQL) et pnltracker_uploads (fichiers).

Mise à jour

Avec Docker

# Sauvegardez d'abord vos données (voir la page Backup)
docker compose down
git pull origin master
docker compose up -d --build

Les volumes PostgreSQL et fichiers sont conservés entre les mises à jour.

Sans Docker

En mode développement :

git pull origin master
npm install
npm run dev

Accès mobile

PnlTracker est responsive et accessible depuis un mobile sur le même réseau :

1. Trouvez l'IP de votre machine : ip addr ou ifconfig
2. Accédez depuis mobile : http://192.168.1.X:3001

Pour un accès permanent, configurez un nom de domaine, ou un outil comme Ngrok qui pointe sur votre machine.