Je ne prompte pas mes agents.
J'écris un contrat avec eux.

---
title: Story — Distance & durée auto (Google Routes API)
status: ready-for-review
created: 2026-06-17
fr: FR-16                  # l'exigence du PRD que la story couvre
epic: E4 — Calculateur
author: John (PM)
dev_kit: ../layou-dev-kit  # l'archi que l'agent dev relit AVANT de coder
depends_on: story-address-autocomplete.md
---

## Story
As a **chauffeur VTC qui remplit un Transfert**,
I want **que la distance et la durée se remplissent toutes seules**,
so that **je ne les tape plus à la main et mon tarif colle au réel.**

## Décisions produit (figées avec Youcef — 2026-06-17)
| Sujet | Décision |
|---|---|
| API | Routes API (New) — CORS-compatible depuis Flutter web |
| Éditabilité | une AIDE, jamais un verrou : le chauffeur corrige |
| Aller-retour | 2 appels (A→B + B→A) puis somme. Pas de ×2 naïf |
| Échec API | on ne remplit rien. Champ vide, saisie manuelle |

## Hors scope
Proxy Cloud Function · polyline/carte · nouveau champ Firestore.

## Tâches
T0 vérifier la clé au curl · T1 domaine (entity + usecase)
T2 data (repo Routes API) · T3 calculateur · T4 les 3 forms
T5 recalcul du tarif · T6 tests · T7 analyze

// Flutter web rend dans un <canvas> : pas de DOM à cliquer.
// Donc chaque élément interactif porte un Semantics(identifier:)
// stable → dans le DOM : flt-semantics-identifier="nav_fab_create"
// C'est CE détail qui rend l'app pilotable par un agent.

const URL = process.env.UPDRIVE_URL || 'https://updrive-prod.web.app';

function bySemantics(page, identifier) {
  return page.locator(`[flt-semantics-identifier="${identifier}"]`).first();
}

async function fillField(page, identifier, value) {
  const node = bySemantics(page, identifier);
  await node.waitFor({ state: 'visible', timeout: 5000 });
  await node.click({ force: true });      // focus le VRAI champ
  await page.keyboard.press('End');
  for (let i = 0; i < 60; i++) await page.keyboard.press('Backspace');
  await page.keyboard.insertText(value);  // seul chemin fiable ici
}

// L'agent rejoue la story, écran par écran : inscription →
// dashboard → calculateur → facture → listing. En light ET dark.
// Screenshot à chaque étape.