Gestion de Session et Profils

Ce guide explique comment vous connecter à votre ERP Dolibarr depuis HtkDoli, et comment gérer vos différents profils en toute sécurité.

Connexion à votre instance Dolibarr

Pour vous connecter, l’application HtkDoli nécessite deux informations principales de votre instance Dolibarr :

1. L’URL de l’instance : L’adresse web de votre serveur Dolibarr (par exemple : https://mon-erp.exemple.com/api/index.php).
2. Vos identifiants ou une clé API : Vous pouvez vous connecter soit en utilisant votre identifiant et mot de passe habituels, soit directement avec une clé API générée dans Dolibarr.

Interface utilisateur

1. À l’ouverture de l’application, l’écran de connexion s’affiche.
2. Saisissez l’URL de votre instance Dolibarr.
3. Saisissez votre identifiant et votre mot de passe (ou votre clé API).
4. Appuyez sur le bouton de connexion.

L’application va vérifier vos informations auprès du serveur. En cas de succès, vous serez redirigé vers le tableau de bord de l’application.

Gestion Multi-Comptes et Profils

HtkDoli est conçu pour les utilisateurs gérant plusieurs entreprises ou travaillant avec plusieurs instances de Dolibarr.

Interface utilisateur

• Changer de profil : Dans le menu principal (ou les paramètres), vous trouverez un gestionnaire de profils. Il vous permet de basculer facilement d’un compte à un autre.
• Ajouter un profil : Vous pouvez ajouter un nouveau profil en cliquant sur le bouton d’ajout (+), ce qui vous ramènera à l’écran de connexion pour saisir les informations de la nouvelle instance.
• Supprimer un profil : Vous pouvez supprimer un profil existant s’il n’est plus nécessaire.

Isolation stricte des données

La sécurité et la confidentialité sont au cœur de l’architecture de HtkDoli :

• Bases de données séparées : Chaque profil possède sa propre base de données SQLite locale (Profile_{UUID}.store).
• Aucune fuite d’information : Le cache, les sessions et les préférences (UserDefaults) sont strictement liés au profil actif.
• Clôture de session propre : Lors du changement de profil ou de la déconnexion, les processus en arrière-plan (comme la synchronisation ou les Live Activities) liés au profil précédent sont explicitement arrêtés pour prévenir toute interférence.

Permissions Dolibarr requises

Pour que la connexion et la synchronisation fonctionnent correctement, il est impératif que certaines permissions et configurations soient actives côté Dolibarr.

1. Activation de l’API REST

Votre instance Dolibarr doit avoir le module API/Web services REST activé.

• Configuration : Connectez-vous à Dolibarr via un navigateur web, allez dans Configuration > Modules/Applications et activez le module “API REST”.

2. Droits de l’utilisateur

L’utilisateur avec lequel vous vous connectez doit disposer des permissions appropriées dans Dolibarr pour interagir avec les modules.

• Accès API : L’utilisateur doit avoir l’autorisation de consulter et d’utiliser les API.
• Droits par module : Si vous n’avez pas le droit de voir les “Tiers” ou les “Factures” dans la configuration web de Dolibarr, l’API refusera l’accès, et ces données n’apparaîtront pas dans HtkDoli.
• Création/Modification : Les actions de création, d’édition ou de suppression via l’application requièrent également les droits correspondants pour votre utilisateur dans Dolibarr.