feat(admin): tableau de bord, lieux, parcours et import CSV by Nascimento95 · Pull Request #376 · Inprogress-Agency/widoo-app

Nascimento95 · 2026-10-13T10:26:29Z

Résultat et problème

L'équipe n'avait ni tableau de bord ni moyen de gérer le catalogue. Cette PR ajoute le tableau de bord (A-05) et la section « Lieux et parcours » (A-04) : parcours, lieux et import CSV, côté API et côté admin.

Ce qui est fait :

Tableau de bord : GET /admin/counters et GET /admin/stats ; tuiles « à traiter » selon le rôle, chacune ouvre sa liste filtrée ; chiffres du catalogue et des utilisateurs ; liens vers PostHog et RevenueCat.
Parcours : GET /admin/routes (recherche, filtres, tri, pages) ; fiche en lecture ; Dépublier et Republier avec motif, Réassigner à l'équipe (admin), chaque action journalisée.
Lieux : GET/POST /admin/places, GET/PATCH /admin/places/:id ; liste, fiche dans le panneau de détail, création et édition dans un formulaire (éditeurs et admins ; un modérateur lit). La ville est déduite de la position.
Import CSV (admin) : POST /admin/places/import, avec aperçu (dryRun) puis création ; modèle à télécharger ; chaque ligne affichée avec son résultat (prêt, créé, invalide avec les champs à corriger, doublon, hors zone) ; doublon = même nom à moins de 50 m, dans le catalogue ou plus haut dans le fichier ; une ligne au journal par lieu créé.
Carte de position (mapbox-gl) : dans le formulaire d'un lieu, une épingle à déplacer ou un clic sur la carte renseigne la latitude et la longitude, et la saisie des champs déplace l'épingle. Sans jeton NEXT_PUBLIC_MAPBOX_TOKEN, le formulaire garde ses deux champs seuls.
Ouvrir dans l'app : l'écran du parcours de l'app est encore provisoire (Construire la fiche parcours (E-05) #37) ; le lien n'ouvre pas encore la fiche. Sur ordinateur il ne fait rien.
Accès : une page dont le rôle n'ouvre pas la section, le formulaire de lieu pour un modérateur et l'import pour un non-admin affichent un refus, même avec l'adresse tapée à la main ; l'API refuse de son côté (403).

Critères d'acceptation :

Import de 50 lieux avec 2 lignes invalides : 48 créés, 2 erreurs explicites (test d'API, et testé à l'écran).
Chaque tuile « à traiter » ouvre la liste filtrée. Les tuiles dont la liste n'existe pas encore (signalements, avis, support) affichent 0 et mènent à une page introuvable jusqu'à Admin : signalements de lieux et de parcours, avis (A-03) #54.

Limites, et le ticket qui les lève :

Lien partenaire d'un lieu : demandé par ce ticket, non fait ici, et porté par Admin : affiliation et clics de réservation (A-09) #344 (affiliation, A-09), qui n'est pas encore réalisé et reste bloqué par Admin : socle Next.js, coque, connexion, rôles et journal (A-01) #52. Ce ticket prévoit lui-même le champ (partner_booking_url, partner_program_id), les programmes d'affiliation et le comptage des clics : le faire ici créerait la colonne deux fois. Aucune colonne ni aucun champ n'existe pour l'instant. Le critère d'acceptation de ce ticket ne le couvre pas.
Ouvrir dans l'app : l'écran du parcours de l'app est encore provisoire (Construire la fiche parcours (E-05) #37) ; le lien n'ouvre pas encore la fiche. Sur ordinateur il ne fait rien.
Lieu hors de toute ville : refusé (création, édition, import) tant que les villes ne se créent pas depuis la position (Ouvrir la création à toutes les villes : ville déduite de la position, recherche sans filtre de ville #340).
Tuiles à zéro : signalements de parcours (Migration : table route_reports et notifications.kind report_resolved #184), avis et support (Admin : signalements de lieux et de parcours, avis (A-03) #54), révisions (Gérer PUT /routes/:id/steps, submit, statuts et lien privé #48) : l'API répond 0 depuis une seule expression par compteur.
Horaires saisonniers d'un lieu : gardés à l'édition, mais ni affichés dans le formulaire ni importables.
Import : 500 lignes au plus par fichier (choix de cette PR, le ticket ne fixe pas de limite) ; chaque lieu est créé dans sa propre transaction, donc un import interrompu garde les lieux déjà créés, et le relancer les signale en doublons.
Pas de suppression de lieu : non demandée par le ticket.
Jeton Mapbox web : à créer dans le compte Mapbox de Widoo, public (pk.), restreint aux adresses de l'admin ; à renseigner comme NEXT_PUBLIC_MAPBOX_TOKEN du build de staging et de production (argument de build de infra/admin.Dockerfile).

Questions pour Ilan :

Quand un membre de l'équipe n'a pas de prénom, l'historique d'un parcours affiche le début de son e-mail et la pastille du compte son e-mail entier : quel affichage veut-on ?
Le partage des rôles sur le catalogue (éditeur : écrit les lieux ; admin : import, Republier, Réassigner ; modérateur : lit les lieux, Dépublie) suit ma lecture du wiki : à confirmer.
Jeton Mapbox web de Widoo (voir Limites) : qui le crée et où il est stocké.

Fixes #55
Écrans : A-04, A-05
Dépendance : empilée sur #365 (modération, #53), elle-même sur #363.

Comment vérifier

Montage local de #363, base locale, comptes admin, editor et moderator.

Testé par Marco les 2026-10-12, 2026-10-13 et 2026-10-14, en local (base locale, Firebase de staging pour la connexion), face aux planches A-05 et aux modèles de Ecrans pour A-04 :

le tableau de bord, ses tuiles et leurs liens ;
la liste et la fiche des parcours, Dépublier, Republier, Réassigner ;
la liste des lieux, la fiche, la création et l'édition ; le refus du formulaire pour un modérateur ;
la carte de position, avec un jeton Mapbox public de test sur le compte de Marco : clic sur la carte (épingle posée, latitude et longitude remplies), saisie des coordonnées (épingle déplacée), création d'un lieu avec sa position ; le déplacement de l'épingle à la souris et la réouverture d'un lieu enregistré n'ont pas été confirmés ;
« Ouvrir dans l'app » : bouton affiché dans la carte « Actions » d'un parcours ; l'ouverture sur un téléphone n'a pas été testée ;
l'import : fichier de 50 lignes dont 2 invalides (aperçu « 48 lieux prêts, 2 lignes écartées », puis 48 créés) ; fichier avec doublons du catalogue, doublon dans le fichier et lieu hors zone ; fichier sans les colonnes obligatoires.

La carte n'a pas de planche : elle suit la phrase du wiki (« épingle déplaçable »). Rien n'a été testé contre un environnement déployé. Pas de test à 150 % de texte ni au lecteur d'écran sur ces écrans.

pnpm lint && pnpm typecheck && pnpm test verts en local
Testé sur iOS / Android (préciser) — sans objet

Formatage mécanique : non

Risque

Niveau : 2 — nouveaux endpoints authentifiés qui écrivent dans le catalogue (lieux, statut des parcours, import en lot) ; aucune migration.

Taille : deux commits au-dessus de 400 lignes. 9b37d88 (451) : la liste des parcours, ses filtres, son tableau, sa configuration et ses textes. b06b72e (427) : les composants du tableau de bord, son conteneur et ses textes.

Revue OWASP (Top 10) :

Contrôle d'accès : lecture par requireAdminSection('catalog') ; écriture d'un lieu par requireRole('editor') ; import, Republier et Réassigner par requireRole('admin'). Refus testés par rôle (403, rien d'écrit). Les gardes de l'admin ne sont qu'un confort : l'API décide.
Entrées non fiables : chaque ligne importée passe par le même schéma strict que la création à la main (texte brut borné, site en https, téléphone, coordonnées) ; le CSV est lu dans le navigateur, l'API ne reçoit que du JSON ; 500 lignes au plus par appel. Les textes s'affichent sans HTML.
Injection : requêtes paramétrées ; recherche échappée ; filtres et tri validés par schéma strict.
Intégrité : un lieu et ses horaires s'écrivent avec leur ligne de journal dans la même transaction ; les actions sur un parcours verrouillent sa ligne.
Journalisation : place.create, place.import, place.update et les actions de parcours gardent l'auteur et l'état.
Limites : un import fait au plus 500 créations ; pas de quota par admin.

Nouvelle dépendance : mapbox-gl 3.32, chargée avec le formulaire de lieu seulement ; choisie parce que le wiki fixe Mapbox pour les cartes de Widoo (Architecture-Technique). Écartée : maplibre-gl, qui aurait demandé un autre fournisseur de tuiles. CSP de l'admin : api.mapbox.com, events.mapbox.com et un worker blob: ne sont autorisés que lorsqu'un jeton est configuré ; un jeton secret (sk.) est refusé au démarrage.

Retour arrière

Le revert de la PR suffit pour le code, sans migration à annuler. Les lieux créés ou importés restent en base ; un import fait par erreur se retrouve par le journal (admin_actions, action place.import).

🤖 Generated with Claude Code