Solution / Digital Lab

KoboToolbox

KoboToolbox est une solution de conception de formulaires et collecte de données de terrain adaptée à des usages structurés et à un hébergement maîtrisé.

Statut
Bien public numérique officiellement reconnu
Licence
AGPL-3.0
Organisation amont
KoboToolbox

Ce qu’est KoboToolbox

KoboToolbox est une solution de conception de formulaires et collecte de données de terrain. Elle propose un constructeur de formulaires, la collecte web et mobile, la gestion des projets, les exports, une API et les formulaires Enketo. Son code ouvert permet de l’installer sur une infrastructure choisie, d’étudier son fonctionnement et de l’intégrer à d’autres outils.

Pourquoi ce type d’outil

Les organisations utilisent ce type de solution pour enquêtes, suivis de projets, évaluations, registres, observations géolocalisées et collecte hors connexion. L’enjeu n’est pas seulement de remplacer un fichier ou une application : il s’agit de clarifier qui crée l’information, qui peut la modifier, comment elle circule et à quel moment elle devient utile à une décision.

KoboToolbox réduit la distance entre conception d’un questionnaire, déploiement sur le terrain, contrôle et analyse. Son fonctionnement hors connexion est précieux lorsque la connectivité est intermittente.

Capacités principales

Un constructeur de formulaires, la collecte web et mobile, la gestion des projets, les exports, une api et les formulaires enketo. Une mise en œuvre commence par un périmètre métier précis, un vocabulaire partagé et des rôles d’accès. Les fonctions techniques prennent alors place dans un processus compréhensible par les utilisateurs, les administrateurs et les responsables des données.

Architecture générale

L’architecture réunit KPI pour la gestion, KoboCAT pour les flux OpenRosa, Enketo pour les formulaires web, PostgreSQL, MongoDB, plusieurs Redis, des workers et trois routes Nginx. Chaque composant répond à une responsabilité distincte : interface, logique métier, traitement différé, recherche ou état durable. Cette séparation guide la supervision, les mises à jour et la sauvegarde.

Intérêt pour les organisations de développement

Les programmes de développement travaillent avec des équipes distribuées, des processus qui évoluent et des données parfois sensibles. Une solution ouverte offre davantage de choix sur l’hébergement, l’intégration et la durée de conservation. Elle exige en retour des responsabilités explicites pour l’administration, la sécurité, les sauvegardes, l’assistance aux utilisateurs et l’évolution fonctionnelle. KoboToolbox organise tout le cycle d’une enquête : conception, déploiement, collecte web ou Android, réception, contrôle et export.

Le choix doit partir du besoin : nombre d’utilisateurs, connectivité, volume, sensibilité des informations, fréquence des changements et compétences disponibles. Un pilote limité aide à valider le vocabulaire, les droits et les parcours avant une généralisation. La collecte hors connexion rend possible le travail avec une connectivité intermittente, mais elle impose une préparation des appareils, un versionnement des formulaires, des règles de synchronisation et une procédure pour les soumissions restées en file locale.

Scénarios d’hébergement

Un service géré réduit la charge d’exploitation. Un hébergement autonome donne davantage de contrôle sur la localisation des données, le réseau et les intégrations. Entre les deux, une plateforme comme Coolify simplifie le déploiement Docker tout en laissant à l’organisation la responsabilité du serveur, des secrets, de la supervision et de la reprise. La topologie complète associe PostgreSQL/PostGIS, MongoDB, deux Redis, Enketo, KPI, KoboCAT, plusieurs workers Celery, beat et trois passerelles publiques.

Le profil retenu doit respecter l’architecture du logiciel. Une installation compacte peut convenir à un usage limité ; une topologie séparant application, travailleurs et stockage facilite l’évolution lorsque les charges et les responsabilités augmentent. Ces domaines ne sont pas interchangeables : ils participent aux liens de formulaires, aux callbacks, aux cookies et aux sessions.

Mettre la gouvernance avant l’outil

Avant l’ouverture aux utilisateurs, il faut définir les propriétaires fonctionnels et techniques, les catégories de données, les règles d’accès, la durée de conservation et la procédure de départ d’un collaborateur. Les sauvegardes doivent couvrir tous les états autoritatifs et leur restauration doit être exercée. Les URL publiques et les noms Docker internes sont donc configurés séparément.

Ressources GRIDAC

Le Digital Lab publie un déploiement Coolify versionné, un modèle Docker Compose téléchargeable, des guides d’exploitation et une étude de cas technique. Ensemble, ces ressources permettent de comprendre la solution, de reproduire l’architecture et d’adapter les contrôles au contexte de l’organisation. Le parcours décisif a traversé la vraie chaîne de collecte : connexion, création et aperçu d’un formulaire, déploiement, soumission anonyme, réception dans KPI et observation des workers.

Préparer l’adoption

Une adoption réussie commence par un petit nombre de parcours prioritaires. L’équipe décrit les rôles, construit un jeu d’essai, teste les imports et exports, puis observe le temps nécessaire aux utilisateurs. Les retours servent à simplifier les formulaires, les catégories et les règles d’accès avant l’ouverture à un groupe plus large. Les corrections ont porté sur les healthchecks, les substitutions Nginx et la cohérence des domaines couplés.

La formation doit couvrir les gestes courants, mais aussi les situations d’erreur : doublon, donnée mal classée, accès perdu, import incorrect ou synchronisation interrompue. Les administrateurs disposent ainsi d’une procédure d’assistance et les utilisateurs savent comment signaler un problème sans créer de nouveaux risques. Une base saine n’a jamais été réinitialisée pour résoudre un défaut de routage.

Interopérabilité et continuité

L’API, les exports et les connecteurs permettent d’inscrire la solution dans un système plus large. Chaque échange doit préciser l’identifiant utilisé, la fréquence, le sens de circulation, les contrôles et la conduite à tenir en cas d’échec. Cette carte évite les doubles saisies et les synchronisations silencieuses. Avant l’import, préparer les trois domaines, leurs variables canoniques et les identifiants de chaque magasin.

La continuité inclut la documentation des configurations, la disponibilité des compétences, la gestion des comptes et la possibilité d’extraire les informations dans un format exploitable. Ces dispositions facilitent également une migration future. Les volumes PostgreSQL, MongoDB et médias n’ont pas la même fonction mais doivent être inventoriés ensemble.

Décider si la solution convient

KoboToolbox organise tout le cycle d’une enquête : conception, déploiement, collecte web ou Android, réception, contrôle et export. La collecte hors connexion rend possible le travail avec une connectivité intermittente, mais elle impose une préparation des appareils, un versionnement des formulaires, des règles de synchronisation et une procédure pour les soumissions restées en file locale.