Aller au contenu

🚀 Guide de Démarrage

Bienvenue dans LibreFolio ! Ce guide vous accompagne dans l'enregistrement de votre compte, la connexion et l'importation de votre premier relevé de courtier pour alimenter instantanément votre tableau de bord.

📝 1. Enregistrez votre Compte

Naviguez vers l'URL de LibreFolio (par exemple, http://localhost:6040) et vous verrez la page de connexion. Cliquez sur Register pour créer un nouveau compte.

Registration Form

Remplissez vos coordonnées :

  • 👤 Username: Votre nom d'affichage (unique dans le système)
  • 📧 Email: Une adresse e-mail valide
  • 🔑 Password: Un mot de passe fort (l'indicateur de force vous aidera)
Registration with Password Strength

Premier Utilisateur = Admin

Le tout premier utilisateur à s'enregistrer devient automatiquement l'administrateur système (superutilisateur). Cet utilisateur peut gérer les paramètres globaux, promouvoir d'autres utilisateurs et accéder à toutes les fonctionnalités d'administration.

🔐 2. Connectez-vous

Après vous être enregistré, vous serez redirigé vers la page de connexion. Entrez vos identifiants pour accéder à votre tableau de bord.

Login Page

🏦 3. Importez votre Premier Relevé (Créez le Courtier et les Actifs à la Volée)

Lors de votre première connexion, vous serez accueilli par un tableau de bord vide.

Tableau de Bord Vide

Dans LibreFolio, le moyen le plus rapide de commencer est d'importer directement votre historique de transactions. Il n'est pas nécessaire de configurer au préalable des courtiers ou des actifs : le système les créera automatiquement lors du processus d'importation !

📋 Étapes

  1. Téléchargez votre Relevé : Accédez à la page des Transactions depuis le menu latéral. Cliquez sur le bouton "Importer" () ou glissez-déposez le fichier de relevé de votre courtier (CSV ou PDF) directement sur la page.

    Assistant Étape 1 : Télécharger

  2. Configuration de l'Analyseur : L'assistant détectera automatiquement le format du relevé. Vous pouvez vérifier les paramètres (tels que formats de date et délimiteurs) et configurer les options de secours (fallback) si vous importez un relevé CSV générique.

    Assistant Étape 2 : Configuration de l'Analyseur

    Re-traiter les relevés existants

    Vous pouvez également re-traiter (re-process) tout relevé précédemment téléchargé directement depuis la page Files & Uploads. C'est particulièrement utile après la mise à jour d'un plugin d'importation ou si vous avez accidentellement supprimé des transactions et souhaitez les restaurer.

  3. Analyse et Lecture : Le système lit, valide et traite les lignes du relevé. Vous verrez une barre de progression indiquant la vitesse et l'état de la lecture.

    Assistant Étape 3 : Analyse

  4. Résolution Courtier et Actifs : Si le rapport contient un compte de courtier ou des actifs (tels que des ETF, actions) qui n'existent pas encore dans votre instance LibreFolio, le système les signalera. Vous pouvez rechercher des éléments existants ou les créer à la volée (on-the-fly) directement dans l'assistant, avec les informations pré-remplies du relevé. Pour plus de détails, consultez la section Import from Broker - Asset Mapping.

    Assistant Étape 4 : Résolution

  5. Détection des Doublons : L'assistant compare les transactions du relevé avec votre historique existant. Il regroupe les correspondances potentielles dans deux badges de statut de l'interface utilisateur basés sur 4 niveaux de confiance :

    Assistant Étape 5 : Détection des Doublons

    Badge UI Niveau de Confiance Critères / Règles de Correspondance
    ⚠️ LIKELY LIKELY_WITH_ASSET Les champs de base et la description correspondent, et l'actif a été résolu automatiquement (doublon hautement probable).
    ⚠️ LIKELY LIKELY Les champs de base et la description correspondent, mais l'actif n'est pas résolu.
    ℹ️ POSSIBLE POSSIBLE_WITH_ASSET Les champs de base correspondent et l'actif a été résolu automatiquement (mais la description diffère ou est vide).
    ℹ️ POSSIBLE POSSIBLE Les champs de base (type, date, quantité, montant) correspondent, mais l'actif n'est pas résolu.
    ✅ UNIQUE — La transaction ne présente aucune correspondance dans la base de données et est considérée comme nouvelle (aucun doublon détecté).
    ❌ NON RÉSOLU — Le courtier ou l'instrument financier n'a pas été associé à une entité existante dans la base de données (nécessite une résolution à l'Étape 4 avant l'importation).

    Pour plus de détails sur les règles et la configuration des doublons, consultez la section Import from Broker - Duplicate Detection.

  6. Mise en attente et Révision Finale: Examinez la liste de toutes les transactions analysées. Une fois tout vérifié et correct, cliquez sur Importer pour enregistrer les transactions dans votre portefeuille.

    Assistant Étape 6 : Révision Finale

    Le tableau de révision affiche les colonnes suivantes :

    • Date: La data d'exécution de la transaction.
    • Type: Le type d'opération financière (ACHAT, VENTE, DIVIDENDE, DÉPÔT, etc.).
    • Asset: L'actif correspondant de votre bibliothèque.
    • Quantity: Le nombre d'unités ou d'actions négociées.
    • Price: Le prix unitaire de l'actif.
    • Net Amount: L'impact total de trésorerie (positif ou négatif) sur le compte.
    • Fees/Taxes: Les commissions de courtage ou taxes de transaction incluses.

    Pour les paramètres avancés ou erreurs de validation en staging, consultez la page Import from Broker.

📈 4. Retour au Tableau de Bord

Après avoir importé votre relevé avec succès, retournez sur le Tableau de Bord.

LibreFolio calcule toutes les métriques de votre portefeuille, l'allocation d'actifs (par type, secteur, zone géographique) et l'historique des performances en temps réel. Vous pouvez maintenant voir l'intégralité de votre situation financière magnifiquement représentée graphiquement !

Dashboard View

🔮 5. Et ensuite ?

Maintenant que votre portefeuille est alimenté, vous pouvez :