Repository navigation
Aligner la page API sur le Go et la lecture des programmations #418
Description
Contexte
Epic : #14
API › Favoris et programmation · Ecrans › E-07 · Ecrans › E-08 · E-07 · E-08 · D-029 · D-033
Maquette : sans objet — contrat d'API
Découvertes de CODE pendant #40 (PR #401, Inbox, 2026-10-14 : Go, lecture) :
PATCH /me/planned/:idne liste passtoppedparmi les statuts, alors que « Arrêter le parcours » (E-07) n'a pas d'autre route ; la PR feat(api): programmer un parcours, timeline, checklist et Go #401 l'accepte.- Aucune route n'est prévue pour « J'y suis » (
planned_steps.arrived_at) ni pour « Passer cette étape » (skipped_at, avec « Annuler » du toast) : les colonnes existent (Migration parcours en cours : statut stopped, closed_by, planned_steps.arrived_at, steps.highlights, media.owner_type step, retrait de planned_routes.personal_note #129), l'app en aura besoin (Construire le parcours en cours et le lien Google Maps (E-07) #42). - Le corps
{ signal }dePOST .../steps/:stepId/doneattendplace_signals: la PR feat(api): programmer un parcours, timeline, checklist et Go #401 le refuse en 422 en attendant. - La PR feat(api): programmer un parcours, timeline, checklist et Go #401 ajoute
GET /me/planned/:id(absente du wiki, nécessaire pour relire une sortie dont le parcours est dépublié) et trieGET /me/plannedpar départ croissant, puis id, avec curseur. Pour les parcours passés (E-08), un tri décroissant serait peut-être attendu.
Comportement attendu (DESIGN)
- API › Favoris et programmation décrit :
stoppeddansPATCH /me/planned/:id; les routes de « J'y suis » et de « Passer cette étape » (et de son annulation) ; le sort de{ signal }en attendantplace_signals;GET /me/planned/:id; l'ordre deGET /me/plannedpour À venir et pour Passés. EntréeD-xxx. - Ensuite, MANAGER crée le ticket de code des routes manquantes et reporte l'ordre de la liste sur Construire Mes parcours : À venir, Favoris, Passés, Créés (E-08) #43, et la dépendance sur Construire le parcours en cours et le lien Google Maps (E-07) #42.
Critères d'acceptation
- La page API couvre les cinq points ci-dessus
- Entrée
D-xxxau Design-Changelog - Ticket de code des routes « J'y suis » et « Passer » créé et lié à Construire le parcours en cours et le lien Google Maps (E-07) #42 ; ordre reporté sur Construire Mes parcours : À venir, Favoris, Passés, Créés (E-08) #43
Activity
PaulThiberville commentedon Oct 16, 2026
📋 MANAGER, 2026-10-16 — le ticket de code des routes « J'y suis » et « Passer » est créé : #503 (
needs-design, bloqué par ce ticket), suivi de l'app par #504 ; tous deux liés à #42. Il passestatus:readydès que la page API porte le contrat.Trois points de plus pour la page API, découverts sur #42 (PR #502) :
GET /me/planned/:id/maps-urlest décrit « à pied », alors que D-052 (Ecrans › E-07, report de l'éditeur) veut le mode du trajet ; la ligne « Commandes » et la ligne « Google Maps » de E-07 disent encore « à pied ». Ticket de code : Ouvrir « Itinéraire » dans le mode du trajet vers l'étape #510 (étape 1 à pied, faute de trajet du parcours qui y mène : à confirmer)./me/plannedetRouteDetailvont porterhighlightset les photos d'étape avec leur crédit (Servir « À ne pas manquer » et les photos d'étape avec leur crédit (snapshot du Go, fiche) #508) : à résumer dans la page.GET /go/:stepIdest servi sous/v1comme toute l'API (préfixe dit en tête de page) : rien à changer, c'est le ticket Passer « Réserver » par /go/:stepId pour compter les clics #345 qui l'écrivait sans le préfixe.IlanAMG commentedon Oct 16, 2026
Chef de projet (16/10/2026) : backlog → v0.4, à la demande d'Ilan (P1 sans jalon) : il bloque #503 et #504 (P1, v0.4). Le ticket reste needs-design jusqu'à la décision d'Ilan.
IlanAMG commentedon Oct 16, 2026
Chef de projet (16/10/2026, décisions d'Ilan en séance) : Ilan valide l'alignement de la page API tel que décrit :
stoppeddansPATCH /me/planned/:id, routes « J'y suis » et « Passer cette étape » (avec son annulation),{ signal }refusé en 422 en attendantplace_signals,GET /me/planned/:id, et l'ordre : À venir par départ croissant, Passés par départ décroissant (plus récentes en premier). Reste : DESIGN écrit la page et D-xxx, puis #503 passe status:ready.PaulThiberville commentedon Oct 19, 2026
📋 MANAGER, 2026-10-19 — décision écrite par D-095 dans API › Favoris et programmation. Report fait : #503 porte les chemins écrits (
arrived,skipenPOSTetDELETE), passestatus:ready(dépendance retirée) et entre au Sprint 1 ; #504 le suit (bloqué par #503) ; l'ordre deGET /me/planned(segment=upcoming|past) et sa lecture dans E-08 sont portés par un ticket à part, #533 (#43 étant fermé). #510 et #529 inchangés, comme le dit l'entrée.Points que D-095 dit « pris seule, à confirmer par Ilan » : les chemins des routes, « J'y suis » qui garde la première heure, 409 sur « Passer » une étape faite, l'état rendu par l'annulation,
segment, à pied vers la première étape. Ils sont reportés tels quels ; si Ilan en change un, MANAGER amende #503 ou #533 avant leur départ en développement.needs-designretiré : la décision est écrite. Ticket laissé ouvert, sans étiquette de statut (aucune tâche de code, CODE ne le prend pas) : le harnais ne fait pas fermer un ticket de décision par MANAGER, et les précédents ont été fermés par le chef de projet. À fermer par Ilan ou Paul.IlanAMG commentedon Oct 19, 2026
Chef de projet (point du 19/10/2026) : la page du wiki est écrite et validée (https://github.com/Inprogress-Agency/widoo-app/wiki/Design-Changelog#d-095--2026-10-16), poussée sur le wiki ce jour (commit 901ddaa, D-093 à D-097, restées non commitées depuis le 16/10). Ticket de spécification fermé selon le circuit design ; les tickets de code qui en dépendent sont libérés par l'action des étiquettes.