À quoi ça sert ?
Le projet permet de transformer n’importe quel document Grist en plateforme de collecte de données via des formulaires dynamiques. Il est au coeur du dispositif de recensement : c’est grâce à lui que les tiers-lieux remplissent leurs enquêtes, et que les réseaux régionaux suivent puis republient les réponses.
Ce n’est plus un simple widget : c’est désormais un serveur d’enquêtes auto-hébergé, qui sert les formulaires publics, accompagné de cinq widgets Grist d’administration. Les répondants remplissent un formulaire web public, sans compte ni accès à Grist ; les gestionnaires conçoivent et pilotent les enquêtes depuis Grist.
Principe de fonctionnement
Le formulaire public (côté répondant) est servi directement par le serveur, à une adresse de la forme enquetes.tiers-lieux.fr/{instance}/{document}/{numéro}. Il peut aussi être intégré en iframe dans un autre site :
- Formulaire SurveyJS alimenté par la configuration JSON stockée dans Grist
- Reprise d’une réponse existante via un lien signé et à durée limitée (celui que l’Espace tiers-lieux remet à chaque lieu), ce qui pré-remplit le formulaire
- Sauvegarde continue des réponses au fil de la saisie
- Gestion des pièces jointes et recherche d’adresses via l’API BAN (la ville enregistrée est celle de l’adresse postale, comme dans le widget BAN de Grist)
- Deux formulaires peuvent partager les mêmes questions, par exemple la fiche d’identité (lien signé, modification) et « Ajouter un lieu » (formulaire public) : on les modifie à un seul endroit, et chacun garde son mode, son lien et son « actif »
Le serveur est aussi la frontière de sécurité : c’est lui qui dialogue avec Grist (la clé d’API ne quitte jamais le serveur), n’ouvre une réponse qu’avec un lien signé ou une clé, limite les abus et la taille des envois, et reçoit les pièces jointes. Sur le formulaire public, le code glissé dans un élément HTML n’est pas exécuté : la mise en forme s’affiche, les scripts non. La conversion entre les questions SurveyJS et les colonnes Grist est entièrement gérée côté serveur.
Les cinq widgets d’administration (côté gestionnaire), à intégrer comme widgets personnalisés dans Grist :
- Éditeur et correspondance : éditeur visuel SurveyJS pour concevoir le formulaire, créer ou compléter les colonnes de la table associée, générer un formulaire depuis une table existante, ou importer un formulaire depuis le lien d’une autre enquête.
- Visualiseur : affiche une réponse en lecture seule, telle qu’elle a été saisie.
- Lien formulaire public : génère le lien public de la ligne sélectionnée (pour reprendre ou compléter une réponse) et un lien « nouvelle réponse ».
- Open data : publie la table sous forme d’un flux JSON public, en choisissant les colonnes à exposer (ou les colonnes d’une vue Grist).
- Synchronisation open data : recopie un flux open data publié vers une table Grist, à sens unique, pour alimenter un réseau régional sans toucher aux lignes saisies à la main.
Stack technique
Le serveur d’enquête est construit avec FastAPI (Python) et dialogue avec Grist via son API REST. Les cinq widgets sont construits avec SurveyJS et Vite, et s’appuient sur l’API Plugin de Grist. L’ensemble est auto-hébergé (Docker, derrière Traefik) : le serveur sert à la fois les formulaires publics et les widgets, sur la même origine.