Extension du navigateur

À quoi elle sert

Certaines plateformes (Nalo, Yomoni, Lendopolis…) n'offrent aucun export : pour mettre tes comptes à jour, il faudrait recopier les montants à la main. L'extension, installée dans Chrome ou Firefox, lit à ta place ce que tu vois sur le site, en lecture seule, et l'envoie à cette appli. Pour Nalo, Yomoni et Lendopolis, elle récupère aussi tout l'historique (valeur, versements) ; sur toute autre page, elle envoie les montants, tableaux et textes affichés.

Elle ne travaille que pendant que tu es toi-même connecté au site : elle ne saisit jamais d'identifiant, de mot de passe ni de code de double authentification, et ne se connecte jamais seule. Les données ne partent que vers l'adresse de ton appli.

Pas à pas

1. Installe l'extension (Chrome, Edge, Brave ou Firefox) : voir « Installer l'extension » plus bas, avec le fichier .zip d'une release ou le dossier extension/ du projet.
2. Règle-la : clique sur son icône, ouvre « Réglages », renseigne l'« Adresse de l'appli » (http://localhost:3000 par défaut, l'adresse de ton serveur si l'appli est hébergée) et colle la « Clé de l'extension » affichée plus bas, puis « Enregistrer ».
3. Connecte-toi toi-même sur le site de la plateforme (Nalo, Yomoni, Lendopolis…) et ouvre la page de tes contrats.
4. Envoie : clique sur l'icône de l'extension, puis sur « Envoyer cette page à l'appli ». L'extension affiche ce qu'elle a lu et les comptes mis à jour.
5. Associe les montants la première fois : s'il en reste à associer, le bouton « Associer les montants dans l'appli » ouvre cette page, où tu choisis le compte de chaque montant utile. Ensuite, chaque envoi met à jour la valeur et les versements du mois tout seul (annulable dans l'historique des imports).

En option

• Envoi automatique (désactivé par défaut) : case « Envoi automatique à l'ouverture de Nalo, Yomoni ou Lendopolis » dans les réglages de l'extension. La page est alors lue et envoyée sans clic, au plus une fois toutes les 12 heures par site ; un ✓ sur l'icône le confirme. Toujours en lecture seule, sur une session que tu as ouverte toi-même.
• Rappel de fin de mois (activé par défaut) : une notification, au plus une par jour, signale les comptes sans relevé pour le mois écoulé, ou à partir du 25 pour le mois en cours ; un clic ouvre la saisie du relevé. Se désactive dans les réglages de l'extension.
• Appli hébergée ou plusieurs utilisateurs : mets l'adresse de ton serveur dans « Adresse de l'appli » (l'extension demande alors l'accès à cette adresse), ajoute si besoin l'« En-tête d'accès » attendu par ton proxy d'authentification, ou l'« Utilisateur » dont tu as collé la clé.

Sans extension : le connecteur en ligne de commande

Pour un script ou une application séparée qui a déjà récupéré les données (un export bancaire lu sur ton ordinateur, par exemple), npm run connector:send -- capture.json envoie un fichier de capture à l'appli, avec la même clé (variables FINANCE_APP_URL et FINANCE_EXTENSION_KEY). Il n'ouvre aucune session bancaire ; détails dans le README, section « Envoyer des captures vers l'instance hébergée ».

Où trouver la clé

Sur une instance normale, cette page affiche ta vraie clé dans le champ « Clé à coller dans les réglages de l'extension » ci-dessous ; elle s'ouvre par le lien « Extension du navigateur » en bas de chaque page. Garde-la privée : elle autorise l'envoi de pages à ton appli. « Changer la clé » en crée une nouvelle et l'ancienne ne marche plus ; avec plusieurs utilisateurs, chacun a la sienne.