Paramètres et Configuration

Ce guide vous explique comment configurer et personnaliser votre expérience dans l'application HtkDoli. L'écran de paramètres vous permet de gérer les options d'apparence, les préférences de comportement, et la sécurité de votre session active.

Pour accéder aux paramètres, ouvrez le menu principal et sélectionnez la section Paramètres. Notez que les paramètres décrits ici s'appliquent de manière globale ou sont isolés selon le profil connecté.

Apparence

Cette section vous permet de modifier l'apparence visuelle de l'application :

• Thème : Vous pouvez forcer le mode Clair, Sombre, ou laisser l'application suivre le thème de votre Système.
  • Comportement métier : La modification est gérée par le ThemeManager (ThemeManager.shared.userTheme) et l'application ajuste instantanément les couleurs globales selon le mode sélectionné. Le choix est enregistré de manière isolée par profil : HtkDoli stocke la préférence dans UserDefaults en associant l'UUID unique de la session (clé userTheme_{profile_UUID}). Chaque compte Dolibarr conserve donc son propre thème.

Préférences

La section des préférences contrôle l'interaction de l'application avec le système et les données :

• Retour haptique : Activez ou désactivez les légères vibrations du téléphone lors d'interactions spécifiques (ex. succès d'une synchronisation).
• Notifications : Permet à l'application de vous envoyer des alertes système via le service de notifications d'Apple (NotificationService). La première activation demandera votre autorisation système. ⚠️ L'activation des notifications fait également apparaître la section Push Dolibarr décrite plus bas.
• Sync au premier plan : En activant cette option, l'application initiera automatiquement une synchronisation lorsque vous l'ouvrez ou la ramenez au premier plan.
  • Comportement métier et Isolation : Afin de garantir une sécurité et une confidentialité strictes (principe du multi-profils de HtkDoli), cette option est enregistrée de manière isolée pour le profil actif. HtkDoli stocke cette préférence dans UserDefaults en associant l'UUID unique de votre session (ex. syncOnForegroundEnabled_{profile_UUID}). Elle ne s'appliquera donc pas à vos autres comptes Dolibarr.

Push Dolibarr

⚠️ Cette section n'apparaît que sur iOS et uniquement lorsque les Notifications sont activées dans la section Préférences. Elle permet de recevoir une notification instantanée lorsqu'un événement se produit dans Dolibarr (facture validée, paiement reçu, nouveau ticket, etc.).

• Activer les push événements : Active ou désactive le mécanisme de push. La désactivation supprime également le webhook côté serveur Dolibarr.
• URL du serveur relay : Adresse du script relay PHP (par exemple https://monserveur.com/htk_push_relay.php) installé sur votre serveur. ⚠️ Le push nécessite ce script relay : sans lui, aucune notification ne peut être livrée.
• Événements surveillés : Liste des événements Dolibarr à surveiller, regroupés par catégorie. Vous pouvez activer ou désactiver chaque événement individuellement :
  • Facturation : Facture validée, Paiement reçu, Facture fournisseur validée.
  • Commercial : Devis validé, Commande validée, Commande fournisseur validée.
  • Support : Nouveau ticket.
• Filtres : Permettent de restreindre les notifications reçues :
  • Tiers autorisés uniquement : ne recevoir les push que pour une liste de tiers sélectionnés.
  • Seuil financier minimum : ne recevoir les push que pour les montants (TTC) supérieurs ou égaux au seuil saisi. ⚠️ Appliqué aux factures, commandes, devis et paiements ; les tickets ne sont jamais filtrés par montant.
• Enregistrer le webhook : Crée (ou recrée) le webhook dans Dolibarr pointant vers votre relay. Une fois enregistré, le statut affiche l'identifiant du webhook actif. ⚠️ Après toute modification de la liste des événements, un message vous invite à réenregistrer le webhook pour appliquer les changements.

Sécurité

La sécurité de votre session en cours peut être renforcée localement sur l'appareil.

• Verrouillage par code (PIN) : Vous pouvez protéger l'accès à ce profil spécifique par un code à 4 chiffres.
  • Comportement métier : Le code est géré par un service de protection dédié (PinProtectionService). S'il est activé, un écran de déverrouillage apparaîtra à chaque réouverture du profil. Si vous décidez de désactiver le code, l'application supprimera immédiatement la clé sécurisée associée à ce profil (pinProtectionService.removePin(for: profile.id)).

Administration

La section Administration ne s'affiche que si vous disposez des droits adéquats sur l'instance Dolibarr connectée. Elle regroupe les outils de configuration globale.

Société (paramètres)

Cette entrée est réservée aux administrateurs (admin = 1 dans Dolibarr). Elle ouvre la fiche complète des paramètres de la société utilisés sur tous les documents (devis, factures, expéditions, etc.) :

• Identité : raison sociale, capital social, devise de référence.
• Adresse : adresse postale, code postal, ville, état/région, pays (code ISO).
• Contact : email, téléphone, fax, site web.
• Identifiants légaux : SIREN (idprof1), SIRET (idprof2), NAF/APE (idprof3), RCS (idprof4), numéro de TVA intracommunautaire.
• Objet social : description libre de l'activité de la société.

L'écran s'ouvre en mode lecture par défaut. Si vous êtes administrateur, le menu ••• du header propose l'entrée Modifier : elle ouvre une feuille d'édition permettant de modifier tous les champs ci-dessus. La sauvegarde déclenche un appel PUT /setup/company puis recharge la vue avec les valeurs renvoyées par Dolibarr.

• Comportement métier : les utilisateurs non-admin ne voient pas du tout l'entrée Société dans la section Administration (filtrage côté UI sur Profile.isAdmin, qui lit le flag admin du JSON des permissions mises en cache). Le serveur applique également ce contrôle et refusera l'écriture avec un code 401/403 si la clé API utilisée ne possède pas les droits requis.

Gestion des catégories

Disponible si vous avez la permission Dolibarr categorie.creer. Permet de créer, modifier et supprimer les catégories Dolibarr utilisées pour classer les tiers, produits, projets, contacts, adhérents.

Utilisateurs

Réservée aux administrateurs Dolibarr. Ouvre l'annuaire en mode administration et permet de créer, modifier et supprimer des utilisateurs (login, identité, contact, statut actif, droits administrateur, mot de passe initial), ainsi que de gérer les groupes d'appartenance. Le retrait d'un utilisateur d'un groupe n'étant pas exposé de manière fiable par l'API REST Dolibarr, cette opération reste à faire depuis l'interface web. Voir le détail dans Paramètres avancés.

Numérotations automatiques

Réservée aux administrateurs Dolibarr. Affiche, pour chaque module Dolibarr (factures, devis, commandes, expéditions, contrats, etc.), le masque de numérotation actuellement actif (par exemple FA{yyyy}-{0000}). Lorsque l'API Dolibarr expose également la liste des masques disponibles pour un module, un tap sur la ligne permet de basculer le masque actif (édition best-effort — selon votre version de Dolibarr, l'écran peut rester en lecture seule). Voir le détail dans Paramètres avancés.

À propos

Cette section affiche des informations techniques sur l'application :

• Version : La version publique de l'application (ex. 1.0).
• Build : Le numéro de compilation de l'application. Ces informations sont utiles pour le support technique ou lors de remontées de bugs.

Captures d'écran

4 captures — cliquez pour agrandir

Fermer