Ajouter la photo du lieu aux étapes de la card de recherche (steps[].photoUrl) #219

Contexte

Epic : #8
Prérequis : #25 (recherche, fermé) ; #161 (card Premium réduite au départ, PR #208) ; #153 (tooltip d'une étape touchée, PR #216)
Maquette : E-04 · validée le 2026-09-28 (D-071)
API › Card de recherche · Ecrans › E-04 · E-04 · D-066

Réponse de DESIGN à #164, point 5 (D-066) : la tooltip de E-04 montre la photo du lieu de l'étape, que la card de recherche ne porte pas ; l'app affiche aujourd'hui coverUrl pour le départ (#26) comme pour une étape touchée (#153), dont le lieu n'est pas celui de la couverture. La card gagne steps[].photoUrl.

Question pour Ilan

@IlanAMG, D-066 note ce champ comme une décision prise seule par DESIGN, à relire. Ce ticket passe status:ready à ta confirmation (un « OK » en commentaire suffit), ou part en révision si tu préfères une autre source d'image. Point à préciser avec : la « photo principale du lieu » n'est pas définie dans Modele-de-Donnees › media (owner_type = place, plus petite position ?).

Comportement attendu

• API, GET /v1/routes/search : chaque étape d'une card de parcours gratuit porte photoUrl, l'URL de la photo principale de son lieu, null si le lieu n'en a pas. Parcours access = premium : card verrouillée, le départ, seule étape envoyée (D-014, Retirer les coordonnées des étapes d'un parcours Premium de la recherche #161), a photoUrl à null ; card déverrouillée (D-075), chaque étape porte photoUrl comme une card gratuite.
• packages/shared : RouteCard.steps[].photoUrl (URL ou null, champ toujours présent) ; api-client suit le type.
• Mobile, tooltip de E-04 (départ et étape touchée) : l'image est photoUrl de l'étape affichée, avec repli sur coverUrl du parcours quand elle est nulle.
• L'URL servie est celle du média en base ; les vignettes d'environ 200 px viennent avec le stockage des médias (Uploader et redimensionner les photos via URL signées #47), hors de ce ticket.
• Cache et droit d'accès selon D-075 (API › Conventions) : réponse anonyme Cache-Control: public (ETag), réponse avec jeton privée ; photoUrl suit les étapes que la card porte.

Critères d'acceptation

• Test d'intégration : card gratuite, chaque étape a photoUrl (photo principale du lieu, ou null sans photo) ; card Premium, départ à photoUrl: null et aucune URL de photo d'étape 2+ dans le JSON brut
• Test de schéma RouteCard : photoUrl URL ou null, obligatoire sur chaque étape
• Tooltip du départ et d'une étape touchée : photo du lieu de l'étape, coverUrl si elle est nulle (test du choix de l'image ; recette iOS et Android)
• Test à 150 % de texte système mentionné dans la PR
• Niveau de risque annoncé dans la PR (nouvelle donnée servie par un endpoint public)
• steps[].photoUrl suit les étapes que la card porte (D-075) : test d'intégration, card Premium déverrouillée (jeton d'un compte premium non expiré) → chaque étape porte photoUrl comme une card gratuite ; absente des étapes que la card verrouillée ne porte pas

Notes techniques

• À empiler en haut de la pile de l'epic Epic — Carte et découverte #8 (au-dessus de chore(shared): renvoyer le budget de la card en somme des coûts #218) tant qu'elle n'est pas fusionnée : la tooltip d'étape vient de feat(mobile): ouvrir la tooltip d'une étape au tap sur la carte #216.
• Aucune migration attendue : les photos de lieu existent déjà dans media.