Foire Aux Questions

Que faire si l'application affiche « Hors ligne » et que je ne peux pas enregistrer ma visite ?

Vous pouvez tout de même enregistrer votre visite normalement — toutes les données de visite sont stockées localement sur votre appareil. Lorsque vous retrouvez une connexion, vos données se synchronisent automatiquement en arrière-plan. Aucune action manuelle n'est requise. Vous recevrez une notification de confirmation de synchronisation une fois le téléversement terminé.

Pourquoi ma tournée d'aujourd'hui affiche-t-elle « Aucune tournée disponible » ?

Votre manager n'a pas encore approuvé un plan de tournée pour aujourd'hui. Les plans de tournée sont générés et approuvés par votre manager avant de devenir visibles sur votre appareil. Contactez votre manager pour réviser et approuver la tournée. Une fois approuvée, effectuez un glissement vers le bas pour actualiser l'application et la tournée apparaîtra.

Puis-je enregistrer une visite si je ne suis pas physiquement près de l'emplacement du PS ?

Le système nécessite une confirmation de proximité GPS pour l'enregistrement standard. Si vous êtes au bon endroit mais que le système indique que vous êtes hors de portée — ce qui peut arriver dans les zones urbaines denses ou en cas d'interférence de signal dans les bâtiments — appuyez sur « Remplacer ». La visite sera enregistrée normalement mais signalée avec une note de remplacement de proximité à des fins d'audit. Cet indicateur est visible par votre manager et l'équipe de conformité.

Comment changer la langue de l'application ?

Accédez au menu mobile (icône hamburger, en haut à gauche) → Profil → Langue. Sélectionnez Anglais ou Français. Le changement s'applique immédiatement sur tous les écrans — aucun redémarrage n'est nécessaire.

Puis-je ajouter une visite PS qui ne figure pas dans ma tournée planifiée ?

Les visites ad hoc en dehors de votre tournée approuvée ne sont pas prises en charge par l'application mobile. Il s'agit d'une décision de conception liée à la conformité — les visites non planifiées ne peuvent pas être vérifiées par GPS et confirmées par check-in de la même manière que les visites planifiées. Si vous devez rendre visite à un PS qui ne figure pas dans votre tournée, contactez votre manager, qui peut mettre à jour ou ré-optimiser votre tournée pour inclure l'arrêt supplémentaire. La tournée mise à jour est envoyée sur votre appareil dans les secondes suivant l'approbation.

Que signifie l'indicateur de remplacement de proximité sur ma fiche de visite ?

L'enregistrement GPS standard requiert que vous soyez à moins de 200 mètres de l'adresse enregistrée du PS. Si le système détecte que vous êtes en dehors de ce rayon de 200 m — ce qui peut se produire dans des zones urbaines denses avec un mauvais signal satellite, à l'intérieur de grands bâtiments hospitaliers, ou lorsque l'adresse d'un PS est légèrement inexacte — vous pouvez appuyer sur « Remplacer » pour effectuer l'enregistrement. Le remplacement crée un indicateur d'audit sur la fiche de visite qui est visible par votre manager et l'équipe de conformité. Ce n'est pas une pénalité et cela n'affecte pas votre nombre de visites ni vos métriques de conformité — cela enregistre simplement que l'enregistrement a été effectué en dehors du rayon de proximité standard, permettant à l'équipe de conformité de distinguer les visites terrain réelles des potentiels problèmes de qualité des données.

Pourquoi une tournée n'a-t-elle pas été générée pour l'un de mes délégués ?

La génération de tournée nécessite que deux conditions soient remplies : (1) le délégué doit avoir une affectation de territoire approuvée, et (2) il doit y avoir au moins un PS éligible dans le territoire — c'est-à-dire un PS qui n'a pas été visité plus récemment que l'intervalle de visite minimum configuré. Vérifiez l'affectation de territoire du délégué dans Paramètres → Utilisateurs → [Délégué] et consultez l'historique des visites PS pour le territoire afin de confirmer l'éligibilité.

Comment modifier les heures de journée de travail pour l'optimisation des tournées ?

Accédez à Territoires → [Nom du territoire] → Paramètres → Planification. Depuis cet écran, vous pouvez configurer les heures de début et de fin de journée de travail, la durée de la pause déjeuner et les hypothèses de vitesse de déplacement pour le territoire. Les modifications s'appliquent au prochain cycle de génération de tournée. Les tournées précédemment approuvées ne sont pas rétroactivement affectées.

La tournée d'un délégué est déjà ACTIVE — puis-je encore la modifier ?

Oui. Cliquez sur la tournée dans la vue Tournées → Ré-optimiser. Le système recalcule les arrêts restants en utilisant la position actuelle du délégué comme nouveau point de départ. Les visites terminées sont entièrement conservées. La tournée mise à jour est envoyée sur l'appareil du délégué dans les secondes suivant l'approbation. Ceci est utile si une visite a été annulée ou si un PS urgent doit être ajouté.

Comment le score d'équité est-il calculé ?

Le score d'équité mesure l'équilibre de la charge de travail entre les territoires en utilisant une combinaison pondérée du nombre de PS et de la valeur stratégique (pondération par tier). Un score de 90 ou plus indique un excellent équilibre — aucune action immédiate n'est nécessaire. Les scores entre 75 et 89 sont acceptables mais méritent un suivi trimestriel. Les scores inférieurs à 75 indiquent qu'une session de rééquilibrage est bénéfique. Les scores inférieurs à 60 indiquent un déséquilibre critique nécessitant une attention rapide. Le score est recalculé automatiquement chaque fois que les affectations de territoire ou les fiches PS sont modifiées.

Comment approuver plusieurs tournées à la fois ?

Depuis la section Tournées, basculez sur la vue Calendrier. Sélectionnez plusieurs tournées BROUILLON en cochant la case à côté de chaque carte de tournée. Une fois votre sélection effectuée, cliquez sur « Approuver la sélection » dans la barre d'actions qui apparaît en bas de l'écran. Toutes les tournées sélectionnées sont approuvées simultanément et envoyées sur les appareils des délégués correspondants.

Que signifie la note de qualité des données Visit Impact Score d'un PS (A/B/C/D/FAIL) ?

La note de qualité des données Visit Impact Score reflète la fiabilité statistique du score ROI pour un PS donné. La note A signifie que le score est basé sur des preuves solides — 10 visites ou plus avec un groupe de contrôle apparié complet et des données de saisonnalité produit — et peut être utilisé avec confiance pour les décisions de ciblage et de tournée. La note B (6–9 visites, données partielles) est fiable directionnellement pour la planification. La note C (3–5 visites) fournit un signal mais ne doit pas être l'unique base de changements de ciblage majeurs. La note D (1–2 visites) est préliminaire — à traiter avec beaucoup de prudence. La note FAIL signifie qu'aucun score statistiquement valide n'a pu être calculé — ce PS n'a pas encore de corrélation de vente mesurable. Les notes s'améliorent automatiquement à mesure que davantage de données de visite et de sell-out s'accumulent ; un territoire nouvellement intégré atteint généralement la note B dans les 2 à 3 mois suivant une ingestion active des données de sell-out.

Comment les contraintes d'accès PS affectent-elles la génération de tournées pour un territoire ?

Les contraintes d'accès PS sont appliquées comme contraintes dures lors de la génération des tournées. Si un PS dispose d'heures de consultation configurées — par exemple, disponible uniquement le lundi 09h00–12h00 et le mercredi 14h00–17h00 — l'optimiseur de tournées n'inclura l'arrêt de ce PS que les jours et dans les créneaux horaires correspondant à ces fenêtres. Les arrêts qui ne peuvent pas s'inscrire dans une fenêtre disponible à la date demandée sont différés et signalés dans le rapport de génération. Si un PS est marqué comme nécessitant un rendez-vous avec un délai minimum (ex. 48 heures), l'optimiseur ne le planifiera pas à moins que la date de planification ne fournisse un délai suffisant. Pour configurer les contraintes d'accès d'un PS : ouvrez la fiche PS → onglet Contraintes d'Accès → ajoutez des règles par jour de la semaine avec fenêtres horaires, exigences de rendez-vous et délais. Les modifications prennent effet au prochain cycle de génération de tournée pour ce territoire.

Un utilisateur a été désactivé par erreur — comment le réactiver ?

Accédez à Paramètres → Utilisateurs, trouvez l'utilisateur à l'aide du champ de recherche, ouvrez son profil et basculez l'interrupteur « Actif » sur Activé. Le compte est immédiatement restauré — l'utilisateur peut se reconnecter sans aucune étape supplémentaire. Si le jeton de session de l'utilisateur a expiré, il devra simplement se reconnecter avec ses identifiants existants.

Combien de temps les données de visite sont-elles conservées ?

La fenêtre de rétention par défaut est de 36 mois à compter de la date de visite. Les enregistrements en dehors de la fenêtre de rétention sont automatiquement purgés lors du cycle de maintenance nocturne. La fenêtre de rétention peut être ajustée dans Paramètres → Conformité → Conservation des Données. Notez que les gels légaux RGPD remplacent le cycle de purge — les enregistrements sous gel légal ne sont pas purgés indépendamment du paramètre de fenêtre de rétention.

Comment exécuter un effacement RGPD ?

Accédez à Administration → Conformité → Effacement RGPD. Soumettez la demande d'effacement en saisissant l'identifiant du PS et la base légale de l'effacement. Un deuxième administrateur autorisé doit ensuite approuver la demande. Un troisième utilisateur autorisé exécute l'effacement final. Les trois étapes génèrent des enregistrements d'audit immuables avec horodatages et identités des utilisateurs. Si le PS est sous un gel légal, la demande d'effacement sera bloquée jusqu'à ce que le gel soit explicitement levé par un administrateur.

Puis-je exporter le journal d'audit ?

Oui. Accédez à Administration → Journal d'Audit. Utilisez les filtres pour affiner l'export par plage de dates, utilisateur et type d'action. Cliquez sur Exporter et sélectionnez CSV ou XLSX. Le fichier exporté contient tous les évènements d'audit correspondants avec horodatages, identités des utilisateurs, identifiants des enregistrements affectés et descriptions des actions. Les exports du journal d'audit sont eux-mêmes enregistrés comme évènements d'audit.

Comment intégrer un nouveau délégué commercial ?

Suivez ces étapes : (1) Accédez à Paramètres → Utilisateurs → Inviter un Utilisateur. Saisissez l'adresse e-mail, sélectionnez le rôle REP et assignez le territoire. (2) Cliquez sur Envoyer l'Invitation — le délégué reçoit un e-mail avec un lien de mot de passe temporaire. (3) Le délégué installe l'application Web Progressive (PWA) mobile en ouvrant l'URL de la plateforme dans son navigateur mobile et en suivant l'invite « Ajouter à l'écran d'accueil » du navigateur. (4) Après la première connexion, le délégué peut immédiatement commencer à recevoir des plans de tournée et à enregistrer ses visites.

Quelles connexions réseau sortantes l'installation sur site nécessite-t-elle ?

Exactement une : HTTPS (port 443) sortant vers engine.fieldorchestrator.symbiowave.com. Il s'agit du point de terminaison API du moteur FieldOrchestrator. Aucune connexion entrante de SymbioWave n'est requise. Tout transfert de données est initié par l'installation sur site. Votre politique de pare-feu doit uniquement autoriser cette unique destination HTTPS sortante.

Comment les mises à jour logicielles sont-elles appliquées ?

Exécutez ./update.sh depuis le répertoire d'installation. Le script effectue automatiquement les étapes suivantes : extrait la dernière image Docker du registre SymbioWave, applique toutes les migrations de schéma de base de données en attente et effectue un redémarrage progressif des conteneurs d'application pour assurer une disponibilité sans interruption. Exécutez toujours ./backup.sh avant de mettre à jour pour avoir un point de récupération. La planification automatique des mises à jour est prévue pour la version 1.1.

De quels identifiants l'installation sur site a-t-elle besoin ?

Uniquement le FIELDORCHESTRATOR_ENGINE_API_KEY, fourni par SymbioWave lors de l'intégration. Aucun compte de fournisseur cloud, clé API de service IA, identifiant de service cartographique ou autre compte de service externe n'est requis. Cette clé unique accorde l'accès à toutes les capacités du moteur (optimisation des tournées, intelligence IA, traitement analytique) via l'API du moteur FieldOrchestrator.

Comment les données sont-elles sauvegardées ?

Exécutez ./backup.sh pour créer un dump de base de données horodaté dans votre répertoire de sauvegarde configuré. Le script peut être planifié via cron pour des sauvegardes quotidiennes automatisées. Pour la sauvegarde hors site, vous pouvez configurer une destination de stockage cloud dans le fichier de configuration d'environnement de votre installation. Consultez votre package d'installation sur site pour la référence complète de configuration des sauvegardes.

Quelle est la configuration matérielle minimale ?

Pour les déploiements desservant jusqu'à 50 utilisateurs simultanés : 4 vCPU, 8 Go de RAM et 100 Go de stockage SSD (NVMe recommandé). Pour les déploiements plus importants — plus de 50 utilisateurs, plusieurs territoires ou imports fréquents de données de sell-out — consultez votre ingénieur d'implémentation SymbioWave pour une recommandation dimensionnée. Les spécifications complètes sont documentées dans HARDWARE_REQUIREMENTS.md inclus dans votre package d'installation sur site.

Qu'est-ce que le Visit Impact Score et comment mesure-t-il l'impact d'une visite ?

Le Visit Impact Score — Intelligence en Boucle Fermée — quantifie le gain de prescription incrémental attribuable à la visite d'un délégué en appliquant la méthode des Doubles Différences (DiD), une approche largement utilisée en recherche académique et politique pour isoler des effets causaux dans des contextes non expérimentaux (Ashenfelter & Card, 1985 ; Card & Krueger, 1994). Pour chaque PS, la plateforme compare la trajectoire de sell-out au niveau de la brique avant et après une visite (le groupe traité) par rapport à un groupe de contrôle de PS de la même classe d'urbanisation n'ayant pas reçu de visite pendant la même fenêtre. La différence entre les deux trajectoires isole la contribution de la visite des tendances de marché sous-jacentes. Les gains bruts en pourcentage sont ensuite compressés logarithmiquement (Box & Cox, 1964) pour éviter que des valeurs aberrantes extrêmes ne déforment les classements, et un facteur de dépréciation décroissante est appliqué — reflétant la relation concave bien documentée entre la fréquence des visites et la réponse prescriptive (Szilagyi, 1991 ; Nair, Manchanda & Bhatia, 2010). Le Score Visit Impact Score résultant (0–100) représente la réactivité commerciale relative du PS aux visites terrain.

Qu'est-ce que l'Priority Score et comment classe-t-il les PS pour un délégué ?

L'Priority Score — le Moteur de Scoring d'Engagement — est un modèle multidimensionnel de priorisation des PS qui estime la valeur commerciale attendue d'une visite chez chaque médecin. Il s'appuie sur la littérature de ciblage des médecins et d'allocation des ressources développée par Zoltners, Sinha & Lorimer (« Building a Winning Sales Force », 2009) et les référentiels SFE pharmaceutiques publiés par IQVIA (anciennement IMS Health). Le score agrège sept composantes pondérées : (1) Potentiel de Volume Rx — le volume de prescription du PS par rapport aux pairs du territoire, dérivé des données IMS universe ou des indices de part de marché ; (2) Qualité de la Réceptivité aux Visites — taux de completion historique, profondeur du détail produit et comportement de planification des suivis ; (3) Corrélation Ventes-Lift — le lien mesuré par Visit Impact Score entre les visites passées et les ventes aval, directement issu du module Visit Impact Score ; (4) Multiplicateur de Stade d'Adoption — la position du PS sur la courbe de diffusion de l'innovation (Rogers, 1962), d'Ignorant à Champion ; (5) Urgence du Déficit de Couverture — déficit de fréquence de visite par rapport à la cible ; (6) Dépréciation par Récence — pénalité exponentielle pour le temps écoulé depuis le dernier contact, calibrée par tier ; et (7) Bonus Stratégique — statut KOL, convention CNAM et pondération IMS de la brique par rapport à la moyenne territoriale. Le score final (0–100) détermine à la fois la priorisation des tournées et la liste des tâches quotidiennes du délégué.

Comment fonctionne la génération automatique de tournées ? Quel algorithme est utilisé ?

La génération de tournées résout une variante du Problème de Tournée de Véhicules avec Fenêtres Temporelles (VRPTW) — une classe de problèmes d'optimisation combinatoire formalisée pour la première fois par Dantzig & Ramser (1959) et étendue aux variantes avec contraintes temporelles par Solomon (1987). La plateforme alimente le solveur avec la liste de priorité PS de chaque délégué (ordonnée par score Priority Score), la géographie de leur territoire, les contraintes de fenêtre temporelle de visite, les heures de journée de travail et les données historiques de temps de trajet, dans un solveur en deux phases. La Phase 1 construit une solution initiale réalisable en utilisant un algorithme d'économies de Clark-Wright (Clarke & Wright, 1964). La Phase 2 applique des métaheuristiques de recherche locale pour améliorer la solution dans le budget de temps disponible. Les temps de trajet routier réels sont calculés en utilisant l'Open Source Routing Machine (OSRM), qui applique un algorithme de Hiérarchies de Contraction sur les données OpenStreetMap pour un routage en temps sous-seconde (Luxen & Vetter, 2011). La qualité de tournée est exprimée par un Score de Plan (0–100) combinant conformité des visites (40%), couverture PS (35%) et régularité de fréquence de visite (25%).

Qu'est-ce que l'ajustement de saisonnalité et pourquoi le Visit Impact Score l'applique-t-il ?

La demande de prescription pharmaceutique n'est pas uniforme d'un mois à l'autre — les produits respiratoires culminent en janvier-février en raison de la saison grippale, tandis que certaines catégories thérapeutiques chroniques suivent des tendances de rentrée scolaire et pré-hivernales (benchmarks saisonniers IQVIA Q-MAT). Sans contrôler ces patterns, une visite effectuée en janvier semblerait générer plus de lift qu'une visite identique en juillet simplement parce que la demande globale du marché est plus élevée en hiver — ce qui serait une fausse attribution. Le Visit Impact Score applique un facteur de normalisation de saisonnalité dérivé de la base SeasonalityPattern (spécifique au produit et à la brique lorsque disponible, sinon basé sur les benchmarks de l'industrie pharmaceutique) au lift du groupe de contrôle avant de calculer l'estimation DiD. Cela garantit que le contrefactuel reflète « quelle aurait été la croissance au niveau du marché pendant le même mois que la visite de traitement » plutôt que pendant le mois où les données de contrôle ont été collectées. Cette méthodologie reflète les techniques d'ajustement saisonnier utilisées en économétrie pour les séries temporelles macroéconomiques (X-12-ARIMA, décomposition STL) adaptées aux données individuelles au niveau du PS.

Qu'est-ce qu'un Délégué à la Protection des Données (DPO) et en faut-il un pour les déploiements FieldOrchestrator ?

En vertu du Règlement Général sur la Protection des Données de l'UE (RGPD, Règlement 2016/679), l'Article 37 impose la désignation d'un Délégué à la Protection des Données (DPO) pour les organisations dont les activités principales impliquent une surveillance systématique à grande échelle des individus ou un traitement à grande échelle de catégories spéciales de données. Les entreprises pharmaceutiques traitant des données PS — notamment le comportement prescriptif, l'historique des visites et les données d'interaction patient — satisfont généralement à ce seuil et doivent désigner un DPO. Le DPO doit être notifié à l'autorité de contrôle nationale compétente (ex. la CNIL en France, l'INPDP en Tunisie). FieldOrchestrator est conçu pour soutenir les obligations de votre DPO : toutes les activités de traitement de données personnelles sont consignées dans l'AuditLog, les demandes d'effacement des personnes concernées suivent un flux de double contrôle (RGPD Article 17), les durées de conservation des données sont configurables et appliquées automatiquement, et la plateforme génère des preuves de conformité adaptées aux Registres des Activités de Traitement (RoPA) de l'Article 30 du RGPD.

Comment la note de qualité des données Visit Impact Score est-elle déterminée, et quand doit-on faire confiance à un score ?

Chaque score Visit Impact Score est accompagné d'une note de qualité des données (A à FAIL) qui reflète la fiabilité statistique de l'estimation DiD sous-jacente. Cela suit le cadre de confiance des données utilisé par des fournisseurs d'analyses commerciales comme IQVIA dans leurs rapports au niveau du médecin. La note A (haute confiance) requiert au moins six observations de traitement — visites individuelles avec des fenêtres de sell-out mesurables — et au moins trois pairs de contrôle appariés. La note B (confiance moyenne) requiert trois observations ou plus et au moins un pair de contrôle. La note C (faible confiance, directionnelle) dispose d'au moins une observation mais avec des données éparses. La note D signifie qu'aucun groupe de contrôle n'était disponible, rendant l'estimation du lift non contrôlée et peu fiable. La note FAIL signifie qu'il n'existe aucune observation valide — ne pas agir sur ce score. En pratique, les notes A et B sont adaptées aux décisions de planification territoriale et d'allocation des ressources. Les scores de note C doivent être traités comme des signaux directionnels qui s'améliorent avec le temps à mesure que davantage de données de visite et de sell-out s'accumulent.