From e02178c5962238f57d1297f6ebb425dec8cdb21f Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 14:11:53 -0300 Subject: [PATCH 1/3] =?UTF-8?q?feat(US-514):=20lieux=20de=20prise=20et=20d?= =?UTF-8?q?e=20retour=20=E2=80=94=20one-way=20refus=C3=A9,=20adresse=20bor?= =?UTF-8?q?n=C3=A9e=20=C3=A0=20fin=20+=20review=5Fwindow=5Fdays?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 0142 : core.booking_checkout_return_place (lecture seule, cmd_hold_owner) ; ONE_WAY_NOT_ALLOWED si le lieu de retour n'est pas le lieu de prise (16 BKG-016, 08 BR-BOOK-09) - catalog_guest_meeting_point et booking_guest_trips : adresse exacte jamais rendue au-delà de la fin prévue + review_window_days du pays (fail-closed), dans tout état - API : returnLocationId au checkout, 422 ONE_WAY_NOT_ALLOWED ; texte es/en/fr/pt-BR (catalogue v83) - preuves L0 PA / PY (l0-us514-meeting-place), contrat HTTP, intégration ; ADR-168, GL-45 Agent-Role: back-end Agent-Model: claude-opus-5-5 Co-Authored-By: Claude Opus 5.5 --- apps/api/openapi/openapi.json | 10 +- apps/api/src/modules/avl/README.md | 2 + .../checkout/checkout.service.test.ts | 2 +- .../avl/internal/checkout/checkout.service.ts | 11 + .../modules/avl/internal/checkout/errors.ts | 4 +- .../modules/avl/internal/checkout/model.ts | 14 +- .../internal/checkout/pg-checkout.int.test.ts | 10 + .../modules/avl/internal/checkout/store.ts | 39 ++ .../avl/testing/checkout.contract.test.ts | 49 +++ .../avl/testing/fake-checkout-store.ts | 14 + changelog.d/US-514-lieux.md | 6 + .../ADR-168-lieux-de-prise-et-de-retour.md | 23 ++ docs/architecture/api.md | 2 +- docs/ops/GO_LIVE_CHECKLIST.md | 1 + docs/team/COMME_TURO.md | 2 + docs/team/handoffs/US-514.md | 36 ++ packages/db/README.md | 9 + .../migrations/0142_booking_meeting_place.sql | 309 ++++++++++++++++ packages/db/security-definer-allowlist.json | 7 + ...9939_test_us514_meeting_place_fixtures.sql | 43 +++ .../db/test/l0/l0-us514-meeting-place.test.ts | 337 ++++++++++++++++++ packages/i18n/src/catalogs/en.ts | 1 + packages/i18n/src/catalogs/es.ts | 1 + packages/i18n/src/catalogs/fr.ts | 2 + packages/i18n/src/catalogs/index.ts | 5 +- packages/i18n/src/catalogs/pt.ts | 1 + 26 files changed, 932 insertions(+), 8 deletions(-) create mode 100644 changelog.d/US-514-lieux.md create mode 100644 docs/adr/ADR-168-lieux-de-prise-et-de-retour.md create mode 100644 docs/team/handoffs/US-514.md create mode 100644 packages/db/migrations/0142_booking_meeting_place.sql create mode 100644 packages/db/test-migrations/9939_test_us514_meeting_place_fixtures.sql create mode 100644 packages/db/test/l0/l0-us514-meeting-place.test.ts diff --git a/apps/api/openapi/openapi.json b/apps/api/openapi/openapi.json index 350d98748..fa45f19ac 100644 --- a/apps/api/openapi/openapi.json +++ b/apps/api/openapi/openapi.json @@ -7088,7 +7088,7 @@ } }, "422": { - "description": "Ligne non rejouée par la base, devis sans protection (PROTECTION_LEVEL_REQUIRED, 16 PRT-011), boîte manuelle non confirmée, conducteur différent du titulaire, conditions non acceptées, préavis du lieu", + "description": "Ligne non rejouée par la base, devis sans protection (PROTECTION_LEVEL_REQUIRED, 16 PRT-011), boîte manuelle non confirmée, conducteur différent du titulaire, conditions non acceptées, préavis du lieu, lieu de retour différent du lieu de prise (ONE_WAY_NOT_ALLOWED, US-514, 16 BKG-016 : one-way interdit)", "headers": { "Cache-Control": { "$ref": "#/components/headers/NoStore" @@ -7106,7 +7106,8 @@ "MANUAL_TRANSMISSION_NOT_CONFIRMED", "DRIVER_MUST_BE_ACCOUNT_HOLDER", "TERMS_NOT_ACCEPTED", - "DATES_NOTICE_TOO_SHORT" + "DATES_NOTICE_TOO_SHORT", + "ONE_WAY_NOT_ALLOWED" ] } } @@ -19093,6 +19094,11 @@ } } }, + "returnLocationId": { + "type": ["string", "null"], + "format": "uuid", + "description": "Lieu de retour demandé (US-514, 16 BKG-016) ; absent ou null : retour au lieu de prise. Tout autre lieu que celui de prise ⇒ 422 ONE_WAY_NOT_ALLOWED (one-way interdit au lancement). Le lieu de prise est celui de l'annonce, jamais choisi par le client en bêta." + }, "manualTransmissionConfirmed": { "type": "boolean" }, diff --git a/apps/api/src/modules/avl/README.md b/apps/api/src/modules/avl/README.md index 1bd3ae75a..6988211f6 100644 --- a/apps/api/src/modules/avl/README.md +++ b/apps/api/src/modules/avl/README.md @@ -64,6 +64,8 @@ Hors 17 §3.2.4 : `core.booking_disposition_repair_log` (migration 0041, essais | `POST /host/accounts/{orgId}/requests/{holdId}/accept` | session | acceptation : capture par jambes (clé stockée, référence de l'autorisation), affinage ; aucun connecteur ⇒ 503 avant la base | | `POST /host/accounts/{orgId}/requests/{holdId}/decline` | session | refus : RELEASED (`REQUEST_DECLINED`), créneau libéré, VOID par la boîte d'envoi, aucun débit | +**Lieu de retour (US-514, ADR-168)** : `POST /checkout/quotes/{quoteId}/hold` accepte `returnLocationId` (UUID, facultatif ; absent ou `null` ⇒ retour au lieu de prise). Présent, il est jugé par `core.booking_checkout_return_place` avant la pose : lieu de prise ⇒ checkout normal ; tout autre ⇒ `422 ONE_WAY_NOT_ALLOWED`, aucun hold, devis non engagé (16 BKG-016 : one-way interdit) ; devis d'un autre ⇒ `404 QUOTE_NOT_FOUND` ; mal formé ⇒ `400 REQUEST_INVALID`. L'adresse exacte rendue par `GET /trips/{tripId}` est bornée à la fin prévue + `review_window_days` (0142). + **Devis expiré (contrat, US-208b)** : `409 QUOTE_EXPIRED` ne porte aucun devis de remplacement. Le client redemande un devis (`POST /checkout/quotes`, même annonce, même période), affiche le nouveau total, fait accepter de nouveau les documents, puis pose le hold sur le nouveau devis (écran S05, ADR-134). Panne du magasin ou de la base : `503 BOOKING_UNAVAILABLE` et une ligne de journal `checkout.store_failed` (opération, nom de l'erreur, SQLSTATE ; jamais de message, de jeton ni de donnée personnelle). `SessionGuard` + `TermsGuard` sur la classe (N-43 : contrôle à l'exécution, `ctr/internal/terms-guard-runtime.test.ts`). Écart assumé de 17 §2.2 : AVL dépend d'IAM (ADR-133). Mode `REQUEST` : US-223c (ADR-146), fermé tant que `booking_request_mode_enabled` est faux (`REQUEST_MODE_UNAVAILABLE`) ; contrôles bloquants : US-209. diff --git a/apps/api/src/modules/avl/internal/checkout/checkout.service.test.ts b/apps/api/src/modules/avl/internal/checkout/checkout.service.test.ts index d2150ea6f..9f7bd49c2 100644 --- a/apps/api/src/modules/avl/internal/checkout/checkout.service.test.ts +++ b/apps/api/src/modules/avl/internal/checkout/checkout.service.test.ts @@ -27,7 +27,7 @@ class DbError extends Error { function failingStore(error: unknown): CheckoutStore { const fail = (): Promise => Promise.reject(error); - return { listing: fail, quote: fail, checkout: fail, hold: fail }; + return { listing: fail, quote: fail, returnPlace: fail, checkout: fail, hold: fail }; } const NO_QUOTES = {} as QuoteStore; diff --git a/apps/api/src/modules/avl/internal/checkout/checkout.service.ts b/apps/api/src/modules/avl/internal/checkout/checkout.service.ts index 0b5626573..56594037b 100644 --- a/apps/api/src/modules/avl/internal/checkout/checkout.service.ts +++ b/apps/api/src/modules/avl/internal/checkout/checkout.service.ts @@ -264,6 +264,17 @@ export class CheckoutService { if (!isUuid(quoteId)) throw new QuoteHttpError('QUOTE_NOT_FOUND'); const demand = parseCheckoutDemand(body); if (demand === null) throw new CheckoutHttpError('REQUEST_INVALID'); + // US-514 : lieu de retour demandé ⇒ jugé en base avant toute pose (one-way interdit) + const returnLocationId = demand.returnLocationId; + if (returnLocationId !== undefined) { + const place = await this.#safe('checkout', () => + this.store.returnPlace(proof, quoteId.toLowerCase(), returnLocationId), + ); + if (place === 'AUTH_REQUIRED' || place === 'QUOTE_NOT_FOUND') { + throw new QuoteHttpError(place); + } + if (place === 'ONE_WAY_NOT_ALLOWED') throw new CheckoutHttpError(place); + } const r = await this.#safe('checkout', () => this.store.checkout(proof, quoteId.toLowerCase(), demand), ); diff --git a/apps/api/src/modules/avl/internal/checkout/errors.ts b/apps/api/src/modules/avl/internal/checkout/errors.ts index 6dc69137f..55f26c7fd 100644 --- a/apps/api/src/modules/avl/internal/checkout/errors.ts +++ b/apps/api/src/modules/avl/internal/checkout/errors.ts @@ -17,7 +17,8 @@ * US-209 (ADR-135, 16 BKG-012) : `AGE_CLASS_MISMATCH` (08 BR-BOOK-11) ; * repris de KYC (ADR-102) : `KYC_NOT_APPROVED`, `KYC_BIOMETRIC_CONSENT_MISSING`, * `KYC_LICENSE_EXPIRED` (un consentement retiré rend `KYC_BIOMETRIC_CONSENT_MISSING`, N-122 ; - * l'ancien `KYC_CONSENT_WITHDRAWN` d'US-208 n'est plus rendu). Une réservation signalée (16 ADM-029) n'est pas un refus : le hold est + * l'ancien `KYC_CONSENT_WITHDRAWN` d'US-208 n'est plus rendu). US-514 (ADR-168, 16 BKG-016) : + * `ONE_WAY_NOT_ALLOWED` (lieu de retour différent du lieu de prise). Une réservation signalée (16 ADM-029) n'est pas un refus : le hold est * posé (en revue selon `flagged_booking_payment_order`). */ import { HttpException } from '@nestjs/common'; @@ -45,6 +46,7 @@ export const CHECKOUT_MESSAGES = { TERMS_UNAVAILABLE: { status: 503, messageKey: 'common.legal.unavailable' }, DATES_UNAVAILABLE: { status: 409, messageKey: 'common.listing.datesUnavailable' }, DATES_NOTICE_TOO_SHORT: { status: 422, messageKey: 'common.checkout.noticeTooShort' }, + ONE_WAY_NOT_ALLOWED: { status: 422, messageKey: 'common.checkout.oneWayNotAllowed' }, GUEST_OVERLAP: { status: 409, messageKey: 'common.checkout.guestOverlap' }, HOLD_ALREADY_LIVE: { status: 409, messageKey: 'common.checkout.holdAlreadyLive' }, HOLD_LIMIT_REACHED: { status: 409, messageKey: 'common.checkout.holdLimit' }, diff --git a/apps/api/src/modules/avl/internal/checkout/model.ts b/apps/api/src/modules/avl/internal/checkout/model.ts index 9020d3c54..3b0610abd 100644 --- a/apps/api/src/modules/avl/internal/checkout/model.ts +++ b/apps/api/src/modules/avl/internal/checkout/model.ts @@ -89,14 +89,19 @@ export interface CheckoutDemand { readonly manualTransmissionConfirmed: boolean; /** Versions affichées et acceptées (16 BKG-008) ; absentes : aucune (TERMS_NOT_ACCEPTED). */ readonly acceptedDocuments: readonly AcceptedDocument[]; + /** + * Lieu de retour demandé (US-514, 16 BKG-016) ; absent : retour au lieu de prise. La base juge + * qu'il est le lieu de prise (sinon `ONE_WAY_NOT_ALLOWED`, one-way interdit au lancement). + */ + readonly returnLocationId?: string; } const name = (value: unknown): string | null => typeof value === 'string' && value.length <= NAME_MAX ? value : null; /** - * Demande de checkout : forme seulement (la base juge le nom, la case et les versions) ; corps - * mal formé ⇒ `null`. + * Demande de checkout : forme seulement (la base juge le nom, la case, les versions et le lieu de + * retour) ; corps mal formé ⇒ `null`. */ export function parseCheckoutDemand(body: unknown): CheckoutDemand | null { if (!isRecord(body) || !isRecord(body['driver'])) return null; @@ -105,6 +110,10 @@ export function parseCheckoutDemand(body: unknown): CheckoutDemand | null { if (first === null || last === null) return null; const manual = body['manualTransmissionConfirmed']; if (manual !== undefined && typeof manual !== 'boolean') return null; + const returnLocation = body['returnLocationId']; + if (returnLocation !== undefined && returnLocation !== null && !isUuid(returnLocation)) { + return null; + } const raw = body['acceptedDocuments'] ?? []; if (!Array.isArray(raw) || raw.length > DOCUMENTS_MAX) return null; const documents: AcceptedDocument[] = []; @@ -121,5 +130,6 @@ export function parseCheckoutDemand(body: unknown): CheckoutDemand | null { driverLastName: last, manualTransmissionConfirmed: manual === true, acceptedDocuments: documents, + ...(isUuid(returnLocation) ? { returnLocationId: returnLocation.toLowerCase() } : {}), }; } diff --git a/apps/api/src/modules/avl/internal/checkout/pg-checkout.int.test.ts b/apps/api/src/modules/avl/internal/checkout/pg-checkout.int.test.ts index 12260d69e..acc4bfa42 100644 --- a/apps/api/src/modules/avl/internal/checkout/pg-checkout.int.test.ts +++ b/apps/api/src/modules/avl/internal/checkout/pg-checkout.int.test.ts @@ -271,6 +271,16 @@ describe.each(countryCases())( expect(card).toEqual({ totalMinor: want.total, billableDays: 3 }); expect(created.totalMinor).toBe(want.total); + // US-514 (0142) : un lieu de retour qui n'est pas le lieu de prise ⇒ ONE_WAY_NOT_ALLOWED, + // jugé par la vraie lecture de la base, sans engager le devis (le hold suivant est posé) + await expect( + checkout.checkout(guest, created.quoteId, { + driver: { firstName: 'Ana', lastName: 'Pérez' }, + acceptedDocuments: created.documents.map((d) => ({ kind: d.kind, version: d.version })), + returnLocationId: '00000000-0000-4000-8000-0000000514b2', + }), + ).rejects.toMatchObject({ code: 'ONE_WAY_NOT_ALLOWED' }); + const hold = await checkout.checkout(guest, created.quoteId, { driver: { firstName: 'Ana', lastName: 'Pérez' }, acceptedDocuments: created.documents.map((d) => ({ kind: d.kind, version: d.version })), diff --git a/apps/api/src/modules/avl/internal/checkout/store.ts b/apps/api/src/modules/avl/internal/checkout/store.ts index 6234909b1..50d037e63 100644 --- a/apps/api/src/modules/avl/internal/checkout/store.ts +++ b/apps/api/src/modules/avl/internal/checkout/store.ts @@ -199,11 +199,30 @@ export interface CheckoutResult { readonly expiresAt: string | null; } +/** Issues de `core.booking_checkout_return_place` (0142, US-514). */ +export const RETURN_PLACE_OUTCOMES = [ + 'DONE', + 'AUTH_REQUIRED', + 'QUOTE_NOT_FOUND', + 'ONE_WAY_NOT_ALLOWED', +] as const; +export type ReturnPlaceOutcome = (typeof RETURN_PLACE_OUTCOMES)[number]; +const RETURN_PLACE = new Set(RETURN_PLACE_OUTCOMES); + export interface CheckoutStore { /** Annonce LISTED et instant serveur ; `null` : inconnue ou non publiée. */ listing(listingId: string): Promise; /** Devis figé du voyageur ; `null` : inconnu ou d'un autre voyageur. */ quote(proof: Buffer, quoteId: string): Promise; + /** + * Lieu de retour demandé pour le devis du voyageur (US-514) : `DONE` s'il est le lieu de prise, + * `ONE_WAY_NOT_ALLOWED` sinon ; lecture seule. + */ + returnPlace( + proof: Buffer, + quoteId: string, + returnLocationId: string, + ): Promise; /** Contrôles, consentements et pose du hold, en une transaction (base). */ checkout(proof: Buffer, quoteId: string, demand: CheckoutDemand): Promise; /** Hold de checkout du voyageur ; `null` : inconnu ou d'un autre voyageur. */ @@ -220,6 +239,7 @@ export class UnavailableCheckoutStore implements CheckoutStore { Promise.reject(new CheckoutStoreError('magasin du checkout indisponible')); listing = (): Promise => this.#fail(); quote = (): Promise => this.#fail(); + returnPlace = (): Promise => this.#fail(); checkout = (): Promise => this.#fail(); hold = (): Promise => this.#fail(); } @@ -394,6 +414,25 @@ export class PgCheckoutStore implements CheckoutStore { }; } + async returnPlace( + proof: Buffer, + quoteId: string, + returnLocationId: string, + ): Promise { + const { rows } = await this.db.query( + 'SELECT outcome FROM core.booking_checkout_return_place($1, $2::uuid, $3::uuid)', + [proof, quoteId, returnLocationId], + ); + const outcome = rows[0] === undefined ? '' : String(rows[0]['outcome']); + // issue inconnue (version N de la base pendant un déploiement) : indisponible, fail-closed + if (!RETURN_PLACE.has(outcome)) { + throw new CheckoutStoreError( + `issue inattendue de booking_checkout_return_place : ${outcome}`, + ); + } + return outcome as ReturnPlaceOutcome; + } + async checkout(proof: Buffer, quoteId: string, d: CheckoutDemand): Promise { const { rows } = await this.db.query( 'SELECT * FROM core.booking_cmd_checkout($1, $2::uuid, $3, $4, $5, $6::jsonb)', diff --git a/apps/api/src/modules/avl/testing/checkout.contract.test.ts b/apps/api/src/modules/avl/testing/checkout.contract.test.ts index b45575f1f..641c6e048 100644 --- a/apps/api/src/modules/avl/testing/checkout.contract.test.ts +++ b/apps/api/src/modules/avl/testing/checkout.contract.test.ts @@ -466,6 +466,55 @@ describe('US-208 — contrat du checkout (partie back-end)', () => { expect((await hold(DEMAND)).status).toBe(503); }); + it('US-514 critère 1 : lieu de retour différent ⇒ 422 ONE_WAY_NOT_ALLOWED sans pose du hold ; absent ⇒ aucune lecture du lieu ; identique ⇒ hold posé ; devis d’autrui ⇒ 404 ; lieu mal formé ⇒ 400 ; panne ⇒ 503', async () => { + const { a, store } = await app(); + store.result = { outcome: 'DONE', holdId: HOLD, expiresAt: HOLD_VIEW.expiresAt }; + store.holds.set(`${a.hash('voyageur')}:${HOLD}`, HOLD_VIEW); + const place = '00000000-0000-4000-8000-0000000514a1'; + const hold = (body: unknown) => + a.api.request('POST', `/checkout/quotes/${QUOTE}/hold`, { + headers: a.cookie('voyageur'), + body, + }); + + // absent (ou null) : retour au lieu de prise, aucune lecture du lieu, hold posé + expect((await hold(DEMAND)).status).toBe(201); + expect((await hold({ ...DEMAND, returnLocationId: null })).status).toBe(201); + expect(store.returnPlaces).toEqual([]); + + // différent du lieu de prise (jugé en base) : refusé, aucune pose + store.returnPlaceOutcome = 'ONE_WAY_NOT_ALLOWED'; + const posed = store.demands.length; + const refused = await hold({ ...DEMAND, returnLocationId: place.toUpperCase() }); + expect(refused.status).toBe(422); + expect(refused.json).toEqual({ + code: 'ONE_WAY_NOT_ALLOWED', + messageKey: 'common.checkout.oneWayNotAllowed', + }); + expect(store.returnPlaces).toEqual([ + { proof: a.hash('voyageur'), quoteId: QUOTE, returnLocationId: place }, + ]); + expect(store.demands).toHaveLength(posed); + + // identique au lieu de prise : hold posé, lieu transmis tel quel + store.returnPlaceOutcome = 'DONE'; + const ok = await hold({ ...DEMAND, returnLocationId: place }); + expect(ok.status).toBe(201); + expect(store.demands.at(-1)?.demand).toMatchObject({ returnLocationId: place }); + + // devis d'un autre voyageur ou inconnu : même réponse qu'un devis absent + store.returnPlaceOutcome = 'QUOTE_NOT_FOUND'; + const foreign = await hold({ ...DEMAND, returnLocationId: place }); + expect(foreign.status).toBe(404); + expect(foreign.json).toEqual({ code: 'QUOTE_NOT_FOUND', messageKey: 'common.quote.notFound' }); + + for (const returnLocationId of ['pas-un-uuid', 42, { id: place }]) { + expect((await hold({ ...DEMAND, returnLocationId })).status).toBe(400); + } + store.down = true; + expect((await hold({ ...DEMAND, returnLocationId: place })).status).toBe(503); + }); + it('critère 3 : récapitulatif du hold (versions exactes acceptées) au seul voyageur ; autre ou inconnu ⇒ 404 ; sans session ⇒ 401 ; panne ⇒ 503', async () => { const { a, store } = await app(); store.holds.set(`${a.hash('voyageur')}:${HOLD}`, HOLD_VIEW); diff --git a/apps/api/src/modules/avl/testing/fake-checkout-store.ts b/apps/api/src/modules/avl/testing/fake-checkout-store.ts index cba2bab02..af157f914 100644 --- a/apps/api/src/modules/avl/testing/fake-checkout-store.ts +++ b/apps/api/src/modules/avl/testing/fake-checkout-store.ts @@ -13,6 +13,7 @@ import type { CheckoutQuoteRow, CheckoutResult, CheckoutStore, + ReturnPlaceOutcome, } from '../internal/checkout/store.js'; export class FakeQuoteStore implements QuoteStore { @@ -53,6 +54,9 @@ export class FakeCheckoutStore implements CheckoutStore { result: CheckoutResult = { outcome: 'DONE', holdId: null, expiresAt: null }; down = false; demands: { proof: string; quoteId: string; demand: CheckoutDemand }[] = []; + /** Issue imposée de la lecture du lieu de retour (US-514) et appels reçus. */ + returnPlaceOutcome: ReturnPlaceOutcome = 'DONE'; + returnPlaces: { proof: string; quoteId: string; returnLocationId: string }[] = []; #fail(): Promise { return Promise.reject(new Error('base indisponible (FAKE)')); @@ -78,6 +82,16 @@ export class FakeCheckoutStore implements CheckoutStore { }); } + returnPlace( + proof: Buffer, + quoteId: string, + returnLocationId: string, + ): Promise { + if (this.down) return this.#fail(); + this.returnPlaces.push({ proof: proof.toString('hex'), quoteId, returnLocationId }); + return Promise.resolve(this.returnPlaceOutcome); + } + checkout(proof: Buffer, quoteId: string, demand: CheckoutDemand): Promise { if (this.down) return this.#fail(); this.demands.push({ proof: proof.toString('hex'), quoteId, demand }); diff --git a/changelog.d/US-514-lieux.md b/changelog.d/US-514-lieux.md new file mode 100644 index 000000000..32c3fd076 --- /dev/null +++ b/changelog.d/US-514-lieux.md @@ -0,0 +1,6 @@ +lot: L2 +module: Réservation + +- Ajouté : au checkout, un lieu de retour différent du lieu de prise est refusé (`ONE_WAY_NOT_ALLOWED`, 422) sans poser de hold ; le retour au même lieu reste le défaut (US-514) +- Sécurité : l'adresse exacte du lieu de remise n'est plus rendue au voyageur au-delà de la fin prévue du trip + `review_window_days` du pays, même pour un trip resté en cours ou non rendu ; paramètre absent ⇒ jamais rendue (US-514) +- Ajouté : textes `common.checkout.oneWayNotAllowed` en es, en, fr et pt-BR (catalogue v83) (US-514) diff --git a/docs/adr/ADR-168-lieux-de-prise-et-de-retour.md b/docs/adr/ADR-168-lieux-de-prise-et-de-retour.md new file mode 100644 index 000000000..dd316914a --- /dev/null +++ b/docs/adr/ADR-168-lieux-de-prise-et-de-retour.md @@ -0,0 +1,23 @@ +# ADR-168 — Lieux de prise et de retour : one-way refusé, adresse bornée, lieu figé + +- **Statut** : PROPOSÉ (US-514, agent back-end, claude-opus-5-5, 2026-11-18). Revues exigées : celles de `check-story-reviews.mjs` ; `SECURITY DEFINER`, RLS et rôles sur un autre modèle que l'auteur. À reporter dans 17 §2.3 (lectures du voyageur) et 16 A.8 (`ONE_WAY_NOT_ALLOWED`, 422) par une PR revue. +- **Complète** : ADR-099 (lieux de l'hôte, fiche publique en zone), ADR-132 (lieu exact au voyageur d'un trip confirmé), ADR-133 (checkout), ADR-160 (« Mis viajes » et détail du trip). +- **Sources** : 19 US-514 (trois critères) ; 16 BKG-016 (retour au même lieu par défaut, one-way interdit, adresse exacte après confirmation, trip annulé ⇒ adresse retirée) ; 08 BR-BOOK-09 (pas de one-way à la réservation), BR-REVIEW-01 (`review_window_days`) ; 22 OQ-P2P-05 ; BOARD N-148. + +## Contexte + +L'existant couvre déjà l'essentiel de BKG-016 : la fiche publique ne rend que la zone (US-115), le voyageur d'un trip confirmé lit le lieu exact (US-204, `core.catalog_guest_meeting_point`) et le détail de ses trips (US-214, `core.booking_guest_trips`, adresse d'un trip à venir ou en cours). Trois manques : un corps de checkout qui demande un retour ailleurs était accepté en silence (champ ignoré) ; aucune borne de temps ne retirait l'adresse d'un trip resté « en cours » (retard, non-retour) ; rien ne disait que le lieu lu pour un trip est celui de sa réservation. + +## Décision + +1. **One-way refusé** (16 BKG-016, 08 BR-BOOK-09) : le corps de `POST /checkout/quotes/{quoteId}/hold` accepte `returnLocationId` (UUID, facultatif ; absent ou `null` = retour au lieu de prise). S'il est présent, l'API le fait juger par `core.booking_checkout_return_place(empreinte, devis, lieu)` (cmd_hold_owner, `SECURITY DEFINER`, EXECUTE app_api, lecture seule) **avant** la commande de checkout, inchangée : `DONE` (lieu de prise du véhicule du devis) ; `ONE_WAY_NOT_ALLOWED` (tout autre lieu ⇒ 422, aucun hold posé, devis non engagé) ; `QUOTE_NOT_FOUND` (devis d'un autre ou inconnu ⇒ 404, même réponse, aucun oracle sur le lieu) ; `AUTH_REQUIRED` ⇒ 401. Le lieu de prise n'est pas choisi par le client en bêta (un lieu par véhicule, `home_location_id`) ; le choix parmi plusieurs points de l'hôte est une suite. +2. **Adresse bornée dans le temps** (critère 3, PROPOSÉ, comme Turo) : les deux lectures du voyageur qui rendent l'adresse exacte ne la rendent plus au-delà de **fin prévue du trip + `review_window_days`** du pays du trip (horloge de la base) ; paramètre absent ou mal formé ⇒ jamais rendue (fail-closed). Les états qui la rendent ne changent pas (ADR-132, ADR-160 : à venir ou en cours) : la borne ne joue que pour un trip resté en cours, en retard ou non rendu. La « purge » du critère est cette borne, jugée à chaque lecture : l'adresse appartient au lieu de l'hôte, elle n'est **copiée nulle part** (ni trip, ni hold) ; il n'y a donc rien à effacer ni de travailleur de purge, et l'inventaire des données personnelles ne change pas. Libellé et ville restent rendus selon ADR-160. +3. **Lieu figé à la réservation** : aucun rôle applicatif ni propriétaire de commandes n'a de droit `UPDATE` sur les colonnes d'un lieu (`kind`, `place_label`, `address_line`, `city`, `area_label`, `geo`, `geo_public`) ni sur `catalog_vehicle.home_location_id` (seul `advance_notice_minutes` est modifiable, 0071) : le lieu lu pour un trip est celui de sa réservation, sans colonne nouvelle sur le trip. Toute story qui rendra un lieu ou le lieu d'un véhicule modifiable devra d'abord figer le lieu sur le trip (preuve L0 qui casse sinon). +4. **Droits** (0142, lecture seulement) : `SELECT (country_code, scheduled_end)` de `booking_trip` à catalog_cmd_owner ; politiques AJOUTÉES `catalog_cmd_meeting_read` et `cmd_hold_meeting_read` sur `config_param_value` (clé `review_window_days` seulement). +5. **Texte** (catalogue v83, es / en / fr / pt-BR) : `common.checkout.oneWayNotAllowed`. + +## Conséquences + +- Aucune route nouvelle, aucun écran changé (le client web n'envoie pas de lieu de retour ; S03 dit déjà « retour au même lieu », `web.listing.meet.sameReturn`). OpenAPI : `CheckoutHoldRequest.returnLocationId`, 422 `ONE_WAY_NOT_ALLOWED`. Liste blanche RLS-15 : une entrée. +- Preuves : `packages/db/test/l0/l0-us514-meeting-place.test.ts` (PA, PY), contrat HTTP `avl/testing/checkout.contract.test.ts`, intégration `pg-checkout.int.test.ts` (vraie lecture). +- Non couvert (suites) : choix du point par le voyageur parmi plusieurs points de l'hôte (16 BKG-016 « hôte avec plusieurs points ») ; consignes de rendez-vous dédiées saisies par l'hôte (N-148) ; vue de l'adresse dans le fil de messages (lot 3) ; livraison, aéroport, one-way en P1 (OQ-MK-08) ; le contrat de location (document figé, US-211) garde l'adresse : sa durée de conservation relève de la rétention des documents, pas de cette borne. diff --git a/docs/architecture/api.md b/docs/architecture/api.md index 48935f197..555a43cbc 100644 --- a/docs/architecture/api.md +++ b/docs/architecture/api.md @@ -35,7 +35,7 @@ Chaque statut ci-dessous est exercé par un test de contrat sur l’application | `POST` | `/checkout/holds/{holdId}/payment` | `checkoutPayHold` | Paiement du hold du checkout (US-223b ; 17 §2.5 étapes 3a à 3c ; 16 PAY-006, PAY-019 ; 08 E7 règle 1) : intention de paiement (T1), ordre chez le PSP avec le montant explicite de chaque jambe, enregistrement de l'ordre (T2) | **200** application/json
**201** application/json
**400** REQUEST_INVALID
**401** AUTH_REQUIRED
**403** ACCOUNT_RESTRICTED / KYC_NOT_APPROVED / KYC_BIOMETRIC_CONSENT_MISSING / KYC_LICENSE_EXPIRED / AGE_CLASS_MISMATCH
**404** HOLD_NOT_FOUND
**409** HOLD_EXPIRED / HOLD_NOT_PAYABLE / BOOKING_UNDER_REVIEW / START_PASSED / PAYMENT_ATTEMPTS_EXCEEDED / HOST_PAYOUT_RAIL_UNAVAILABLE
**422** PAYMENT_METHOD_UNAVAILABLE / QUOTE_UNAVAILABLE
**503** PAYMENT_UNAVAILABLE / BOOKING_UNAVAILABLE | | `POST` | `/checkout/quotes` | `checkoutCreateQuote` | Devis figé du voyageur pour une annonce et une période (US-208 ; 16 BKG-001, BKG-006, PRC-025) : lignes, taxes et total rejoués par la base, validité, documents à accepter | **201** application/json
**400** QUOTE_INPUT_INVALID
**401** AUTH_REQUIRED
**404** LISTING_NOT_FOUND
**409** QUOTE_MISMATCH / INSURER_CONTRACT_INACTIVE
**422** QUOTE_UNAVAILABLE / TAX_CONFIG_MISSING / LEG_AMOUNT_NEGATIVE / PROTECTION_LEVEL_REQUIRED / PROTECTION_LEVEL_NOT_ELIGIBLE
**429** QUOTE_RATE_LIMITED
**503** BOOKING_UNAVAILABLE | | `GET` | `/checkout/quotes/{quoteId}` | `checkoutQuote` | Devis figé du voyageur de la session (US-208) : lignes, total, validité (expired), boîte manuelle, mode de l'annonce, documents à accepter | **200** application/json
**401** AUTH_REQUIRED
**404** QUOTE_NOT_FOUND
**503** BOOKING_UNAVAILABLE | -| `POST` | `/checkout/quotes/{quoteId}/hold` | `checkoutPlaceHold` | Checkout du devis (US-208 ; 16 BKG-001, BKG-002, BKG-025, BKG-008, BKG-023) : contrôles, consentements et pose du hold CHECKOUT en une transaction ; aucun paiement | **201** application/json
**400** REQUEST_INVALID
**401** AUTH_REQUIRED
**403** SELF_BOOKING_FORBIDDEN / ACCOUNT_RESTRICTED / KYC_NOT_APPROVED / KYC_BIOMETRIC_CONSENT_MISSING / KYC_LICENSE_EXPIRED / AGE_CLASS_MISMATCH
**404** QUOTE_NOT_FOUND
**409** QUOTE_EXPIRED / QUOTE_ALREADY_USED / INSURER_CONTRACT_INACTIVE / LISTING_UNAVAILABLE / REQUEST_MODE_UNAVAILABLE / TERMS_VERSION_CHANGED / DATES_UNAVAILABLE / GUEST_OVERLAP / HOLD_ALREADY_LIVE / HOLD_LIMIT_REACHED
**422** QUOTE_LINE_NOT_SUPPORTED / PROTECTION_LEVEL_REQUIRED / MANUAL_TRANSMISSION_NOT_CONFIRMED / DRIVER_MUST_BE_ACCOUNT_HOLDER / TERMS_NOT_ACCEPTED / DATES_NOTICE_TOO_SHORT
**429** HOLD_RATE_LIMITED
**503** TERMS_UNAVAILABLE / BOOKING_UNAVAILABLE | +| `POST` | `/checkout/quotes/{quoteId}/hold` | `checkoutPlaceHold` | Checkout du devis (US-208 ; 16 BKG-001, BKG-002, BKG-025, BKG-008, BKG-023) : contrôles, consentements et pose du hold CHECKOUT en une transaction ; aucun paiement | **201** application/json
**400** REQUEST_INVALID
**401** AUTH_REQUIRED
**403** SELF_BOOKING_FORBIDDEN / ACCOUNT_RESTRICTED / KYC_NOT_APPROVED / KYC_BIOMETRIC_CONSENT_MISSING / KYC_LICENSE_EXPIRED / AGE_CLASS_MISMATCH
**404** QUOTE_NOT_FOUND
**409** QUOTE_EXPIRED / QUOTE_ALREADY_USED / INSURER_CONTRACT_INACTIVE / LISTING_UNAVAILABLE / REQUEST_MODE_UNAVAILABLE / TERMS_VERSION_CHANGED / DATES_UNAVAILABLE / GUEST_OVERLAP / HOLD_ALREADY_LIVE / HOLD_LIMIT_REACHED
**422** QUOTE_LINE_NOT_SUPPORTED / PROTECTION_LEVEL_REQUIRED / MANUAL_TRANSMISSION_NOT_CONFIRMED / DRIVER_MUST_BE_ACCOUNT_HOLDER / TERMS_NOT_ACCEPTED / DATES_NOTICE_TOO_SHORT / ONE_WAY_NOT_ALLOWED
**429** HOLD_RATE_LIMITED
**503** TERMS_UNAVAILABLE / BOOKING_UNAVAILABLE | ## `/console` diff --git a/docs/ops/GO_LIVE_CHECKLIST.md b/docs/ops/GO_LIVE_CHECKLIST.md index ce71dd9b0..bd5c0a582 100644 --- a/docs/ops/GO_LIVE_CHECKLIST.md +++ b/docs/ops/GO_LIVE_CHECKLIST.md @@ -68,6 +68,7 @@ | GL-39 | **Constancia, centre juridique et mention d'intermédiaire validés par l'avocat** (US-212, ADR-162 ; OQ-MK-01, OQ-BR-24, OQ-BR-19). **Existe** (bêta) : constancia d'arrendamiento rendue à la demande depuis le contrat figé (es fait foi + langue du lecteur, `ctr.constancia.*` version 1 **BROUILLON**), recherche de l'hôte par plaque et date, centre juridique `/legal` (`web.legalCenter.*` version 1 **BROUILLON** : intermédiaire entre particuliers, médiation puis voies externes, loi du lieu du trip). **À faire avant l'ouverture d'un pays** : textes validés par l'avocat et chargés (US-606 : `CONSTANCIA_TEMPLATE_DRAFT` et `LEGAL_CENTER_DRAFT` à `false`, nouvelle version) ; nom complet du conducteur sur la constancia si l'avocat l'exige ; voies externes nommées par pays ; contact du support (SUP-004) ; mention d'intermédiaire et hôte en prénom et initiale au checkout et sur le reçu (critère 3 d'US-212). | | GL-40 | **Créance de la règle 3 bis et hôte défaillant** (US-224 partie 224e, ADR-163). **Existe** (bêta, sur `FAKE`) : la créance de l'hôte née d'une avance de Kmino (`RELEASED_LEG_ADVANCE`) est écrite au `host_ledger` au report du remboursement ; l'ops annule en une action les trips à venir d'un hôte restreint (`CANCEL_HOST_TRIPS`, motif `HOST_ACCOUNT_CLOSED`, remboursement intégral). **Manque avant l'ouverture d'un pays** : recouvrement de la créance (GL-33) ; bouton de la fiche 360° de l'hôte et ses textes ; proposition de véhicules similaires au voyageur ; sanctions de l'hôte défaillant (BR-HP-05) décidées | annulation des trips d'un hôte restreint en préproduction, chaque voyageur remboursé du total payé ; créance d'une avance visible de FINANCE au solde de l'hôte ; preuves `l0-us224e-host-receivable`, `l0-us224e-defaulted-host` | US-709, console, fondateur (sanctions) | | GL-43 | **Remboursement réparti sur les moyens d'origine et choix d'un autre rail** (US-224 partie 224f, ADR-166). **Existe** (bêta, sur `FAKE`) : un trip encaissé en plusieurs fois est remboursé par moyen (08 E2, jambes en cascade, TJ16), jamais au-delà du payé d'un moyen ; un rejet confirmé met le remboursement en attente d'un autre rail (`PENDING_CUSTOMER_CHOICE`, `attempt_no` + 1). **Manque avant l'ouverture d'un pays** : choix du rail par le voyageur sur S10 et virement vers un compte vérifié à son nom (OQ-BR-12) ; relances et sort des sommes non réclamées (OQ-BR-44) ; refus d'un encaissement par crédit tant que les crédits n'existent pas ; crédit cash recréé (TJ16d) seulement après l'ouverture de `funds_holding_enabled` par décision écrite du fondateur | trip payé par deux cartes annulé en préproduction : deux remboursements aux jambes de l'oracle ; refus du PSP ⇒ attente d'un autre rail visible de FINANCE ; preuves `l0-us224f-multi-tender`, `trip-cancellation.test.ts` | US-224 (suite), lot C, fondateur (`funds_holding_enabled`) | +| GL-45 | **Lieux de prise et de retour complets avant l'ouverture d'un pays** (US-514, ADR-168 ; 16 BKG-016). **Existe** (bêta) : un lieu par véhicule, zone seule avant la réservation, adresse exacte au seul voyageur d'un trip à venir ou en cours jusqu'à la fin prévue + `review_window_days`, retour différent refusé (`ONE_WAY_NOT_ALLOWED`), lieu non modifiable une fois créé. **Manque avant l'ouverture d'un pays** : choix du point par le voyageur parmi plusieurs points de l'hôte ; consignes de rendez-vous saisies par l'hôte ; `review_window_days` du pays confirmé (J-ADM-031) ; durée de conservation du contrat de location qui porte l'adresse | trip réservé en préproduction : adresse visible au voyageur seulement, retirée après la fenêtre ; retour ailleurs refusé ; preuves `l0-us514-meeting-place`, `checkout.contract.test.ts` | US-514 (suite), lot 3 (messages), fondateur (`review_window_days`) | | # | Condition | Preuve exigée | Porteur | Coché (date, preuve) | | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | -------------------- | | GL-01 | **EXC-003 fermée** (F-RLS-03, au registre RT-RLS-03, `core.iam_cmd_open_session` ne laisse plus `app_api` choisir l'acteur) | PR fusionnée de la story **US-410** (BOARD, « Suites de la porte du lot 0 ») ; run CI vert sur `main` où **RT-RLS-18 est inversé** (`packages/db/test/l0/redteam-rls/rt-rls-actors.test.ts`, « RT-RLS-18 » exige le refus) ; EXC-003 passée à FERMÉE dans `docs/team/DECISIONS.md` §3 et RT-RLS-03 dans `docs/team/RISKS.md` | US-410 (lot 4, US-003) | | diff --git a/docs/team/COMME_TURO.md b/docs/team/COMME_TURO.md index cfd4eda63..21700fc5e 100644 --- a/docs/team/COMME_TURO.md +++ b/docs/team/COMME_TURO.md @@ -11,6 +11,8 @@ Règles : | Date | Story | Question | Solution de Turo | Source | Adaptation Kmino | Statut | | ---------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | +| 2026-11-18 | US-514 | Le voyageur peut-il rendre la voiture ailleurs qu'au lieu de prise ? | pas de one-way à la réservation : retour au lieu de prise ; un autre lieu seulement après la réservation, proposé par l'hôte, ou en option payante | 08 BR-BOOK-09 ; 16 BKG-016 ; 22 OQ-P2P-05 | retour au même lieu, toujours ; un lieu de retour différent au checkout ⇒ `ONE_WAY_NOT_ALLOWED`, aucun hold ; changement après la réservation, livraison et one-way : P1 (OQ-MK-08) ; ADR-168 | PROPOSÉ | +| 2026-11-18 | US-514 | Combien de temps le voyageur voit-il l'adresse exacte de l'hôte ? | adresse donnée après la réservation pour le trip ; l'historique du trip ne sert plus à retrouver le domicile de l'hôte | 16 BKG-016 ; 19 US-514 critère 3 ; 08 BR-REVIEW-01 | adresse au seul voyageur d'un trip à venir ou en cours (ADR-160), et jamais au-delà de la fin prévue + `review_window_days` du pays, même si le trip reste en cours ; paramètre absent ⇒ jamais ; aucune copie de l'adresse sur le trip ; ADR-168 | PROPOSÉ | | 2026-11-18 | US-224f | Trip payé avec plusieurs moyens et annulé : sur quel moyen, et combien sur chacun, rembourse-t-on ? | le remboursement revient sur les moyens d'origine ; ce qui avait été payé en crédit revient en crédit ; si le remboursement échoue, la plateforme convient d'un autre moyen avec le voyageur | 08 E2 (T33, T66), E3, SM-8, TJ16 | carte remboursée en priorité, chaque moyen au plus de ce qu'il a payé ; en bêta, seule la carte est remboursée automatiquement ; crédit jamais recréé tant que `funds_holding_enabled` = false ; refus du prestataire ⇒ attente d'un autre rail, l'équipe s'en occupe (ADR-166) | PROPOSÉ | | 2026-11-18 | US-224e | Kmino a avancé au voyageur la part d'un hôte déjà versé : quand et combien l'hôte doit-il ? | l'hôte doit exactement ce que la plateforme a avancé pour lui, retenu ensuite sur ses gains suivants | 08 E7 règle 3 bis, TJ18b / TJ18d | créance `RELEASED_LEG_ADVANCE` du montant de l'avance, écrite au `host_ledger` au moment où le remboursement est reporté (jamais avant la décision FINANCE), une par avance ; recouvrement : US-709 | PROPOSÉ | | 2026-11-18 | US-224e | Hôte défaillant : comment ses trips à venir sont-ils annulés et ses voyageurs remboursés ? | la plateforme suspend l'hôte, annule ses réservations à venir et rembourse chaque voyageur en entier ; l'hôte ne reçoit rien pour ces trips | 08 BR-TRUST-09, BR-CXL-14 (`HOST_ACCOUNT_CLOSED`, table n° 13) | action de console `CANCEL_HOST_TRIPS` sur un hôte déjà restreint : une annulation `HOST_ACCOUNT_CLOSED` par trip à venir, remboursement intégral par le règlement, sans pénalité (sanctions : fondateur) | PROPOSÉ | diff --git a/docs/team/handoffs/US-514.md b/docs/team/handoffs/US-514.md new file mode 100644 index 000000000..d4e57941e --- /dev/null +++ b/docs/team/handoffs/US-514.md @@ -0,0 +1,36 @@ +# Passation US-514 — Lieux de prise et de retour (2026-11-18, agent back-end, claude-opus-5-5) + +Branche `story/US-514-lieux`, worktree `../wt/US-514`, PR en brouillon. Décision : ADR-168 (PROPOSÉ). Revues exigées : celles de `check-story-reviews.mjs` (dont architecture et sécurité : `packages/db/`) ; `SECURITY DEFINER`, RLS et rôles sur un autre modèle que l'auteur ; revue design OUI dans 19 (aucun écran changé : ux à juger sur le texte d'erreur). + +## Fait (critères de 19 US-514) + +- **Critère 1 (one-way)** : `POST /checkout/quotes/{quoteId}/hold` accepte `returnLocationId` (facultatif). Présent, il est jugé en base par `core.booking_checkout_return_place` (0142, lecture seule) avant la commande de checkout, inchangée : lieu de prise du véhicule du devis ⇒ hold posé ; autre ⇒ `422 ONE_WAY_NOT_ALLOWED`, aucun hold ; devis d'un autre ⇒ `404 QUOTE_NOT_FOUND` ; mal formé ⇒ 400. Avant : le champ était ignoré en silence. +- **Critère 2 (adresse après confirmation)** : déjà livré par US-115 (fiche publique C0), US-204 (lieu exact) et US-214 (détail du trip) ; prouvé de nouveau en PA et PY (BOOKED ⇒ adresse au seul voyageur ; fiche publique sans adresse ; terminé ou annulé ⇒ retirée). +- **Critère 3 (purge)** : les deux lectures du voyageur ne rendent plus l'adresse au-delà de la fin prévue + `review_window_days` du pays, dans **tout** état (y compris OVERDUE, UNRETURNED) ; paramètre absent ⇒ jamais. Pas de travailleur : l'adresse n'est copiée nulle part, la borne est jugée à chaque lecture (ADR-168 point 2). +- **Lieu figé** (N-148) : prouvé par l'absence de tout droit UPDATE sur les colonnes d'un lieu et sur `home_location_id` (rôles applicatifs et propriétaires de commandes) ; aucune colonne ajoutée au trip. +- Texte `common.checkout.oneWayNotAllowed` (es, en, fr, pt-BR), catalogue **v83**. OpenAPI : `CheckoutHoldRequest.returnLocationId`, 422 `ONE_WAY_NOT_ALLOWED` ; `docs/architecture/api.md` régénéré. + +## Numéros + +Migration **0142** au moment de la poussée (0145 réservée ; contiguïté depuis `origin/main` : renuméroter à chaque fusion de `main`, après #236 0142, #237 0143, #240 0144 ⇒ 0145), catalogue **v83**, **ADR-168**, **GL-45**, fixture de test **9939**. + +## Données personnelles + +Aucune table ni colonne : inventaire inchangé. Minimisation renforcée (adresse bornée dans le temps, jamais copiée). La lecture du lieu de retour ne rend que son issue, jamais le lieu. + +## Reste (suites) + +1. Choix du point par le voyageur parmi plusieurs points de l'hôte (16 BKG-016, parcours alternatif) : modèle « points de l'annonce » et `pickupLocationId` au checkout. +2. Consignes de rendez-vous saisies par l'hôte (N-148) et adresse dans le fil de messages (lot 3). +3. Report dans `docs/specs/` (PR revue) : ADR-168 en 17 §2.3 ; `ONE_WAY_NOT_ALLOWED` (422) en 16 A.8. +4. Conservation du contrat de location (document figé qui porte l'adresse) : rétention des documents, hors de cette borne. + +## Pièges + +- `review_window_days` est lu par deux nouveaux rôles : politiques **ajoutées** (permissives) plutôt que la liste des clés de `cmd_hold_read` / `catalog_cmd_read` recopiée (aucune politique existante modifiée). +- Le corps de `core.booking_guest_trips` est recopié de 0136 : une story qui le remplace après celle-ci doit repartir de 0142 (BOARD N-181). +- Les sessions des preuves sont ouvertes à l'instant virtuel lu (une session ouverte en T0 serait échue des semaines plus tard). + +## Prochaine commande exacte + +`gh pr checks --repo Noamgitpty/rueda` diff --git a/packages/db/README.md b/packages/db/README.md index 369bfa166..aa83dc308 100644 --- a/packages/db/README.md +++ b/packages/db/README.md @@ -1029,3 +1029,12 @@ Migration `0141_payment_refund_multi_tender`. Aucune fixture nouvelle. - **Reprise après un échec confirmé** : `core.payment_cmd_refund_await_choice(uuid)` (cmd_money_owner, EXECUTE app_worker, travailleur `payment_command`) : instance `FAILED` dont l'ordre est `FAILED` ⇒ `PENDING_CUSTOMER_CHOICE`, `attempt_no` + 1 (`refund_instance_not_failed` sinon) ; garde de l'instance (corps de 0127) : `attempt_no` ne change que sur cette transition, `PENDING_CUSTOMER_CHOICE → SUPERSEDED` ; supersession étendue à `PENDING_CUSTOMER_CHOICE`. Droit de colonne `UPDATE (attempt_no)` à cmd_money_owner. - **Codes** : `refund_exceeds_tender` ⇒ `REFUND_EXCEEDS_COLLECTED` ; `refund_rail_not_native` ⇒ `PAYMENT_METHOD_UNAVAILABLE` ; `refund_instance_not_failed` ⇒ `INVALID_TRANSITION`. - **Preuves** : `test/l0/l0-us224f-multi-tender.test.ts` (PA USD : TJ16a / TJ16b, moyens de T33 ; PY PYG : TJ16c / TJ16d ; refus de TJ16b / TJ16d sur tout rail en bêta ; reprise après échec ; supersession ; droits). `test/support/pay.ts` : `recordOperation` accepte un moyen (`method`, défaut `CARD`). + +## Lieux de prise et de retour (US-514 ; 16 BKG-016 ; 08 BR-BOOK-09 ; ADR-168) + +Migration `0142_booking_meeting_place`. Fixture `9939_test_us514_meeting_place_fixtures` (annonce d'un trip ; fermeture de `review_window_days` d'un pays, transaction annulée). + +- **One-way refusé** : `core.booking_checkout_return_place(bytea, uuid, uuid)` (cmd_hold_owner, EXECUTE app_api, lecture seule) : lieu de retour absent ou égal au lieu du véhicule du devis du voyageur de la session ⇒ `DONE` ; autre ⇒ `ONE_WAY_NOT_ALLOWED` ; devis d'un autre ou inconnu ⇒ `QUOTE_NOT_FOUND` ; session invalide ⇒ `AUTH_REQUIRED`. Le checkout (`booking_cmd_checkout`) est inchangé. +- **Adresse bornée** : `core.catalog_guest_meeting_point` (0106) et `core.booking_guest_trips` (0136) remplacés à signature identique : l'adresse exacte n'est plus rendue au-delà de la fin prévue du trip + `review_window_days` du pays (paramètre absent ou mal formé ⇒ jamais). Aucune copie de l'adresse, rien à purger. +- **Droits** : `SELECT (country_code, scheduled_end)` de `booking_trip` à catalog_cmd_owner ; politiques ajoutées `catalog_cmd_meeting_read`, `cmd_hold_meeting_read` sur `config_param_value` (clé `review_window_days`). +- **Preuves** : `test/l0/l0-us514-meeting-place.test.ts` (PA USD, PY PYG : one-way, adresse après réservation seulement, borne de la fenêtre dans chaque état, paramètre absent, lieu non modifiable par aucun rôle, droits). diff --git a/packages/db/migrations/0142_booking_meeting_place.sql b/packages/db/migrations/0142_booking_meeting_place.sql new file mode 100644 index 000000000..9103f9349 --- /dev/null +++ b/packages/db/migrations/0142_booking_meeting_place.sql @@ -0,0 +1,309 @@ +-- 0142 — AVL / CAT : lieux de prise et de retour (US-514 ; 19 US-514 ; 16 BKG-016 ; 08 BR-BOOK-09 ; +-- 22 OQ-P2P-05 ; ADR-168). Appliquée sous `migrator`, en une transaction. +-- +-- Critères de 19 US-514 : +-- 1. « Given une demande avec retour différent, When elle est soumise, Then ONE_WAY_NOT_ALLOWED » : +-- lecture `core.booking_checkout_return_place(jeton, devis, lieu de retour)` (cmd_hold_owner, +-- SECURITY DEFINER, EXECUTE app_api). Le voyageur est celui de la SESSION ; le devis doit être +-- le sien (sinon QUOTE_NOT_FOUND, même réponse qu'un devis inconnu). Lieu de prise = lieu du +-- véhicule de l'annonce du devis (`catalog_vehicle.home_location_id`, un seul lieu en bêta) ; +-- lieu de retour absent ou identique ⇒ DONE ; tout autre ⇒ ONE_WAY_NOT_ALLOWED (one-way +-- interdit au lancement, 16 BKG-016, 08 BR-BOOK-09). Rien n'est écrit : le checkout reste la +-- commande `booking_cmd_checkout` (inchangée), appelée par l'API seulement après DONE. +-- 2. « Given un trip BOOKED, When le voyageur ouvre le détail, Then l'adresse exacte du lieu de +-- remise s'affiche ; avant confirmation, seule la zone est visible » : déjà vrai (US-115 fiche +-- publique C0, US-204 `catalog_guest_meeting_point`, US-214 `booking_guest_trips`) ; prouvé +-- de nouveau par l0-us514-meeting-place. +-- 3. « Given la fin du trip + review_window_days, When la purge tourne, Then l'adresse de l'hôte +-- disparaît de la vue du voyageur » : les deux lectures du voyageur qui rendent l'adresse +-- (`catalog_guest_meeting_point`, `booking_guest_trips`) ne la rendent plus au-delà de la fin +-- prévue du trip + `review_window_days` du pays (horloge de la base, `platform.now()`) ; +-- paramètre absent ou mal formé ⇒ jamais rendue (fail-closed). La « purge » est cette borne, +-- jugée à chaque lecture : l'adresse appartient au lieu de l'hôte (aucune copie sur le trip, +-- aucune donnée à effacer, minimisation). Les états qui la rendent restent ceux d'US-204 et +-- d'US-214 (à venir ou en cours, PROPOSÉ, comme Turo) : la borne ne joue que pour un trip resté +-- en cours ou en retard (OVERDUE, UNRETURNED) au-delà de la fenêtre. +-- Lieu figé à la réservation : un lieu (`catalog_location` : libellé, adresse, ville, zone, point) +-- et le lieu d'un véhicule (`catalog_vehicle.home_location_id`) ne sont modifiables par AUCUN rôle +-- applicatif ni propriétaire de commandes (aucun droit UPDATE sur ces colonnes, 0067, 0071) : +-- le lieu lu pour un trip est celui de sa réservation (prouvé par l0-us514-meeting-place). +-- +-- Droits ajoutés (lecture seulement) : +-- - catalog_cmd_owner : SELECT (country_code, scheduled_end) de booking_trip (politique +-- catalog_cmd_guest_read de 0106 inchangée : états confirmés non terminés) ; politique +-- catalog_cmd_meeting_read sur config_param_value (clé review_window_days seulement ; +-- colonnes déjà accordées par 0067) ; +-- - cmd_hold_owner : politique cmd_hold_meeting_read sur config_param_value (clé +-- review_window_days seulement ; colonnes déjà accordées par 0032). Les autres colonnes lues +-- sont déjà accordées (0032, 0067, 0097, 0108, 0122). +-- Politiques AJOUTÉES (permissives), aucune politique existante modifiée. +-- +-- Expand / contract : fonction AJOUTÉE ; deux fonctions REMPLACÉES à signature et colonnes +-- identiques (propriétaire, droits EXECUTE et search_path inchangés) ; droits et politiques +-- AJOUTÉS ; aucune table ni colonne. +-- +-- Retour arrière : +-- DROP FUNCTION core.booking_checkout_return_place(bytea, uuid, uuid) ; +-- réappliquer les corps de core.catalog_guest_meeting_point (0106) et de +-- core.booking_guest_trips (0136) ; +-- DROP POLICY catalog_cmd_meeting_read ON core.config_param_value ; +-- DROP POLICY cmd_hold_meeting_read ON core.config_param_value ; +-- REVOKE SELECT (country_code, scheduled_end) ON core.booking_trip FROM catalog_cmd_owner. + +-- 1. Droits de lecture (fenêtre de la vue de l'adresse) ---------------------------------------------- +GRANT SELECT (country_code, scheduled_end) ON core.booking_trip TO catalog_cmd_owner; +CREATE POLICY catalog_cmd_meeting_read ON core.config_param_value FOR SELECT TO catalog_cmd_owner + USING (key = 'review_window_days'); +CREATE POLICY cmd_hold_meeting_read ON core.config_param_value FOR SELECT TO cmd_hold_owner + USING (key = 'review_window_days'); + +-- 2. Lieu exact de la fiche (US-204), borné à fin prévue + review_window_days ---------------------- +GRANT CREATE ON SCHEMA core TO catalog_cmd_owner; +SET LOCAL ROLE catalog_cmd_owner; + +CREATE OR REPLACE FUNCTION core.catalog_guest_meeting_point(p_token_hash bytea, p_listing_id uuid) + RETURNS TABLE (place_label text, address_line text, city text, area_label text, + location_kind text) + LANGUAGE plpgsql + VOLATILE + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ +#variable_conflict use_column +DECLARE + v_user uuid; + v_now timestamptz := platform.now(); +BEGIN + SELECT s.user_id INTO v_user FROM core.iam_session_resolve(p_token_hash) AS s; + IF v_user IS NULL THEN + RETURN; + END IF; + RETURN QUERY + SELECT loc.place_label, loc.address_line, loc.city, loc.area_label, loc.kind + FROM core.catalog_listing AS l + JOIN core.catalog_vehicle AS v ON v.id = l.vehicle_id AND v.org_id = l.org_id + JOIN core.catalog_location AS loc ON loc.id = v.home_location_id + WHERE l.id = p_listing_id + AND EXISTS ( + SELECT 1 + FROM core.booking_trip AS t + -- fenêtre du pays du trip, en vigueur ; aucune ligne ou valeur mal formée : rien rendu + CROSS JOIN LATERAL ( + SELECT CASE WHEN pg_catalog.jsonb_typeof(pv.value) = 'number' + AND (pv.value #>> '{}') ~ '^[1-9][0-9]{0,2}$' + THEN pg_catalog.make_interval(days => (pv.value #>> '{}')::integer) + END AS span + FROM core.config_param_value AS pv + WHERE pv.key = 'review_window_days' + AND pv.country_code::text = t.country_code::text AND pv.scope_type = 'COUNTRY' + AND pv.valid_from <= v_now AND (pv.valid_to IS NULL OR pv.valid_to > v_now) + ORDER BY pv.valid_from DESC + LIMIT 1) AS rw + WHERE t.guest_user_id = v_user AND t.vehicle_id = v.id + AND t.status IN ('BOOKED', 'CHECKIN_OPEN', 'START_WINDOW_EXPIRED', 'IN_PROGRESS', + 'OVERDUE') + AND v_now <= t.scheduled_end + rw.span); +END +$fn$; +COMMENT ON FUNCTION core.catalog_guest_meeting_point(bytea, uuid) IS + 'Lieu de remise exact (libellé, adresse, ville, zone, type) du véhicule d''une annonce, rendu au ' + 'seul voyageur de la session ayant un trip confirmé non terminé de ce véhicule, jusqu''à la fin ' + 'prévue + review_window_days du pays (paramètre absent : rien) ; sinon 0 ligne. SECURITY ' + 'DEFINER, EXECUTE app_api. US-204 (ADR-132), borne US-514 (ADR-168).'; + +RESET ROLE; +REVOKE CREATE ON SCHEMA core FROM catalog_cmd_owner; + +-- 3. Lectures du voyageur (famille cmd_hold, EXECUTE app_api) -------------------------------------- +GRANT CREATE ON SCHEMA core TO cmd_hold_owner; +SET LOCAL ROLE cmd_hold_owner; + +-- 3.1 « Mis viajes » et détail du trip (US-214, 0136) : corps repris tel quel, seule l'adresse +-- exacte est bornée à fin prévue + review_window_days du pays. +CREATE OR REPLACE FUNCTION core.booking_guest_trips(p_token_hash bytea, p_tab text, p_trip_id uuid, + p_limit integer) + RETURNS TABLE (outcome text, kind text, item_id uuid, public_ref text, tab text, status text, + payment_status text, currency text, timezone text, starts_at timestamptz, + ends_at timestamptz, respond_by timestamptz, vehicle_make text, + vehicle_model text, vehicle_year integer, host_name text, place_label text, + place_address text, place_city text, total_minor bigint, contract_state text) + LANGUAGE plpgsql + STABLE + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ +#variable_conflict use_column +DECLARE + v_user uuid; + v_now timestamptz := platform.now(); +BEGIN + IF (p_tab IS NOT NULL + AND p_tab NOT IN ('REQUESTED', 'UPCOMING', 'IN_PROGRESS', 'DONE', 'CANCELLED')) + OR p_limit IS NULL OR p_limit < 1 OR p_limit > 200 THEN + RETURN QUERY SELECT 'REQUEST_INVALID'::text, NULL::text, NULL::uuid, NULL::text, NULL::text, + NULL::text, NULL::text, NULL::text, NULL::text, NULL::timestamptz, + NULL::timestamptz, NULL::timestamptz, NULL::text, NULL::text, + NULL::integer, NULL::text, NULL::text, NULL::text, NULL::text, + NULL::bigint, NULL::text; + RETURN; + END IF; + -- voyageur de la SESSION (IDOR : jamais un identifiant de personne reçu) + SELECT s.user_id INTO v_user FROM core.iam_session_resolve(p_token_hash) AS s; + IF v_user IS NULL THEN + RETURN QUERY SELECT 'AUTH_REQUIRED'::text, NULL::text, NULL::uuid, NULL::text, NULL::text, + NULL::text, NULL::text, NULL::text, NULL::text, NULL::timestamptz, + NULL::timestamptz, NULL::timestamptz, NULL::text, NULL::text, + NULL::integer, NULL::text, NULL::text, NULL::text, NULL::text, + NULL::bigint, NULL::text; + RETURN; + END IF; + RETURN QUERY + SELECT 'DONE'::text, i.kind, i.item_id, i.public_ref, i.tab, i.status, i.payment_status, + i.currency, i.timezone, i.starts_at, i.ends_at, i.respond_by, + COALESCE(cv.make_text, mk.name), COALESCE(cv.model_text, md.name), cv.year, + CASE WHEN hu.pseudonymized_at IS NULL AND hu.legal_first_name IS NOT NULL + THEN hu.legal_first_name + || CASE WHEN pg_catalog.btrim(COALESCE(hu.legal_last_name, '')) = '' THEN '' + ELSE ' ' || pg_catalog.left(pg_catalog.btrim(hu.legal_last_name), 1) + || '.' END + END, + CASE WHEN i.kind = 'TRIP' THEN cl.place_label END, + -- US-514 : adresse exacte bornée à fin prévue + review_window_days du pays (fail-closed) + CASE WHEN i.kind = 'TRIP' AND i.tab IN ('UPCOMING', 'IN_PROGRESS') + AND v_now <= i.ends_at + rw.span THEN cl.address_line + END, + CASE WHEN i.kind = 'REQUEST' OR i.tab IN ('UPCOMING', 'IN_PROGRESS') THEN cl.city END, + pq.total_minor, + CASE WHEN i.kind <> 'TRIP' THEN NULL + WHEN cd.id IS NULL THEN 'NONE' + WHEN cs.id IS NULL THEN 'TO_SIGN' + ELSE 'SIGNED' END + FROM ( + -- trips du voyageur de la session + SELECT 'TRIP'::text AS kind, t.id AS item_id, t.public_ref, x.tab, t.status, + t.payment_status, t.currency, t.timezone, t.scheduled_start AS starts_at, + t.scheduled_end AS ends_at, NULL::timestamptz AS respond_by, t.org_id, t.vehicle_id, + h.quote_id, t.guest_user_id + FROM core.booking_trip AS t + LEFT JOIN core.booking_checkout_hold AS h ON h.id = t.source_hold_id + CROSS JOIN LATERAL ( + SELECT CASE + WHEN t.status IN ('BOOKED', 'CHECKIN_OPEN') THEN 'UPCOMING' + WHEN t.status IN ('START_WINDOW_EXPIRED', 'IN_PROGRESS', 'OVERDUE', 'UNRETURNED') + THEN 'IN_PROGRESS' + WHEN t.status IN ('RETURNED', 'TERMINATED_EARLY', 'VEHICLE_LOST', 'POST_TRIP', + 'COMPLETED', 'IN_DISPUTE') THEN 'DONE' + ELSE 'CANCELLED' + END) AS x(tab) + WHERE t.guest_user_id = v_user + AND (p_trip_id IS NULL OR t.id = p_trip_id) + UNION ALL + -- demandes en attente de l'hôte (jamais lues par identifiant ici) + SELECT 'REQUEST'::text, h.id, NULL::text, 'REQUESTED'::text, h.status, NULL::text, + q.currency, v.timezone, pg_catalog.lower(q.period), pg_catalog.upper(q.period), + h.request_respond_by, h.org_id, h.vehicle_id, h.quote_id, h.guest_user_id + FROM core.booking_checkout_hold AS h + JOIN core.pricing_quote AS q ON q.id = h.quote_id + JOIN core.catalog_vehicle AS v ON v.id = h.vehicle_id AND v.org_id = h.org_id + WHERE h.guest_user_id = v_user + AND h.kind = 'REQUEST' + AND (h.status = 'AWAITING_HOST' + OR (h.status = 'PAYMENT_IN_FLIGHT' AND h.request_respond_by IS NOT NULL)) + AND p_trip_id IS NULL + ) AS i + LEFT JOIN core.pricing_quote AS pq ON pq.id = i.quote_id + LEFT JOIN core.catalog_vehicle AS cv ON cv.id = i.vehicle_id AND cv.org_id = i.org_id + LEFT JOIN core.catalog_vehicle_variant AS va ON va.id = cv.variant_id + LEFT JOIN core.catalog_vehicle_model AS md ON md.id = va.model_id + LEFT JOIN core.catalog_vehicle_make AS mk ON mk.id = md.make_id + LEFT JOIN core.catalog_location AS cl ON cl.id = cv.home_location_id + -- US-514 : fenêtre de la vue de l'adresse (paramètre du pays du véhicule, en vigueur ; absent ou + -- mal formé : NULL, adresse jamais rendue) + LEFT JOIN LATERAL ( + SELECT CASE WHEN pg_catalog.jsonb_typeof(pv.value) = 'number' + AND (pv.value #>> '{}') ~ '^[1-9][0-9]{0,2}$' + THEN pg_catalog.make_interval(days => (pv.value #>> '{}')::integer) END AS span + FROM core.config_param_value AS pv + WHERE i.kind = 'TRIP' AND pv.key = 'review_window_days' + AND pv.country_code::text = cv.country_code::text AND pv.scope_type = 'COUNTRY' + AND pv.valid_from <= v_now AND (pv.valid_to IS NULL OR pv.valid_to > v_now) + ORDER BY pv.valid_from DESC + LIMIT 1) AS rw ON true + LEFT JOIN core.iam_organization AS o ON o.id = i.org_id + LEFT JOIN core.iam_user_account AS hu ON hu.id = o.holder_user_id + LEFT JOIN LATERAL ( + SELECT d.id FROM core.contract_generated_document AS d + WHERE i.kind = 'TRIP' AND d.trip_id = i.item_id + ORDER BY d.version DESC + LIMIT 1) AS cd ON true + LEFT JOIN LATERAL ( + SELECT s.id FROM core.contract_signature AS s + WHERE s.document_id = cd.id AND s.signer_user_id = i.guest_user_id + AND s.signer_role = 'GUEST' + LIMIT 1) AS cs ON true + WHERE p_tab IS NULL OR i.tab = p_tab + ORDER BY CASE i.tab WHEN 'REQUESTED' THEN 0 WHEN 'UPCOMING' THEN 1 WHEN 'IN_PROGRESS' THEN 2 + WHEN 'DONE' THEN 3 ELSE 4 END, + CASE WHEN i.tab IN ('REQUESTED', 'UPCOMING') THEN i.starts_at + WHEN i.tab = 'IN_PROGRESS' THEN i.ends_at END ASC NULLS LAST, + i.starts_at DESC, i.item_id + LIMIT p_limit; +END +$fn$; + +COMMENT ON FUNCTION core.booking_guest_trips(bytea, text, uuid, integer) IS + 'Trips et demandes en attente du voyageur de la session (S08, S09) : onglet, statut, paiement, ' + 'période, auto (sans plaque), hôte en prénom et initiale, lieu de remise minimisé (adresse exacte ' + 'd''un trip à venir ou en cours, jusqu''à la fin prévue + review_window_days), total du devis ' + 'figé (jamais recalculé), état du contrat ; trip d''une autre personne ou inconnu : aucune ligne. ' + 'SECURITY DEFINER, EXECUTE app_api. US-214 (ADR-160), borne US-514 (ADR-168).'; + +-- 3.2 Lieu de retour demandé au checkout (16 BKG-016 : one-way interdit). Lecture seule, aucune +-- écriture : l'API l'appelle avant `booking_cmd_checkout` quand le corps porte un lieu de retour. +CREATE FUNCTION core.booking_checkout_return_place(p_token_hash bytea, p_quote_id uuid, + p_return_location_id uuid) + RETURNS TABLE (outcome text) + LANGUAGE plpgsql + VOLATILE + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ +#variable_conflict use_column +DECLARE + v_user uuid; + v_pickup uuid; +BEGIN + -- voyageur de la SESSION (IDOR : jamais un identifiant de personne reçu) + SELECT s.user_id INTO v_user FROM core.iam_session_resolve(p_token_hash) AS s; + IF v_user IS NULL THEN + outcome := 'AUTH_REQUIRED'; + RETURN NEXT; + RETURN; + END IF; + -- lieu de prise : celui du véhicule de l'annonce du devis du voyageur (même lecture que 0108) + SELECT v.home_location_id INTO v_pickup + FROM core.pricing_quote AS pq + JOIN core.catalog_listing AS l ON l.id = pq.listing_id + JOIN core.catalog_vehicle AS v ON v.id = l.vehicle_id + WHERE pq.id = p_quote_id AND pq.guest_user_id = v_user; + IF v_pickup IS NULL THEN + outcome := 'QUOTE_NOT_FOUND'; + ELSIF p_return_location_id IS NULL OR p_return_location_id = v_pickup THEN + outcome := 'DONE'; + ELSE + outcome := 'ONE_WAY_NOT_ALLOWED'; + END IF; + RETURN NEXT; +END +$fn$; +COMMENT ON FUNCTION core.booking_checkout_return_place(bytea, uuid, uuid) IS + 'Lieu de retour demandé au checkout (16 BKG-016) : DONE si absent ou égal au lieu du véhicule du ' + 'devis du voyageur de la session, ONE_WAY_NOT_ALLOWED sinon ; devis inconnu ou d''un autre : ' + 'QUOTE_NOT_FOUND ; session invalide : AUTH_REQUIRED. Aucune écriture. SECURITY DEFINER, EXECUTE ' + 'app_api. US-514 (ADR-168).'; + +REVOKE ALL ON FUNCTION core.booking_checkout_return_place(bytea, uuid, uuid) FROM PUBLIC; +GRANT EXECUTE ON FUNCTION core.booking_checkout_return_place(bytea, uuid, uuid) TO app_api; + +RESET ROLE; +REVOKE CREATE ON SCHEMA core FROM cmd_hold_owner; diff --git a/packages/db/security-definer-allowlist.json b/packages/db/security-definer-allowlist.json index b831d9140..a59decfcf 100644 --- a/packages/db/security-definer-allowlist.json +++ b/packages/db/security-definer-allowlist.json @@ -1925,6 +1925,13 @@ "execute": ["app_api"], "story": "US-214" }, + { + "signature": "core.booking_checkout_return_place(bytea,uuid,uuid)", + "family": "cmd_hold", + "owner": "cmd_hold_owner", + "execute": ["app_api"], + "story": "US-514" + }, { "signature": "core.booking_trip_refunds(bytea,uuid)", "family": "cmd_hold", diff --git a/packages/db/test-migrations/9939_test_us514_meeting_place_fixtures.sql b/packages/db/test-migrations/9939_test_us514_meeting_place_fixtures.sql new file mode 100644 index 000000000..9dc10dea6 --- /dev/null +++ b/packages/db/test-migrations/9939_test_us514_meeting_place_fixtures.sql @@ -0,0 +1,43 @@ +-- 9939 — fixtures des preuves des lieux de prise et de retour (US-514, migration 0142). TESTS +-- SEULEMENT. +-- +-- JAMAIS appliquée hors tests : seul le harnais ajoute test-migrations/, et seulement à la base +-- jetable principale `rueda_test_*`. +-- +-- Rôle (SECURITY DEFINER sous migrator, search_path figé ; aucun SQL dynamique) : +-- 1. `us514_trip_listing` : annonce d'un trip (lecture d'une colonne que le voyageur ne lit pas +-- directement), pour appeler la lecture du lieu exact de la fiche sur le trip de la fixture +-- 9948 ; +-- 2. `us514_close_review_window` : ferme à platform.now() la valeur en vigueur de +-- review_window_days d'un pays, comme la console de configuration (paramètre absent) ; appelée +-- SEULEMENT dans une transaction annulée. +-- AUCUNE fixture n'écrit un interrupteur de mise en service (17 §0.1). +-- +-- Retour arrière : DROP FUNCTION test_fixture.us514_trip_listing(uuid), +-- test_fixture.us514_close_review_window(text). + +CREATE FUNCTION test_fixture.us514_trip_listing(p_trip_id uuid) + RETURNS uuid + LANGUAGE sql + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ + SELECT t.listing_id FROM core.booking_trip AS t WHERE t.id = p_trip_id +$fn$; + +CREATE FUNCTION test_fixture.us514_close_review_window(p_country text) + RETURNS void + LANGUAGE sql + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ + UPDATE core.config_param_value + SET valid_to = platform.now() + WHERE key = 'review_window_days' AND country_code = p_country AND scope_type = 'COUNTRY' + AND valid_to IS NULL +$fn$; + +REVOKE ALL ON FUNCTION test_fixture.us514_trip_listing(uuid), + test_fixture.us514_close_review_window(text) FROM PUBLIC; +GRANT EXECUTE ON FUNCTION test_fixture.us514_trip_listing(uuid), + test_fixture.us514_close_review_window(text) TO app_api; diff --git a/packages/db/test/l0/l0-us514-meeting-place.test.ts b/packages/db/test/l0/l0-us514-meeting-place.test.ts new file mode 100644 index 000000000..7be2e3faa --- /dev/null +++ b/packages/db/test/l0/l0-us514-meeting-place.test.ts @@ -0,0 +1,337 @@ +/** + * US-514 (migration 0142, ADR-168 ; fixtures 9939, 9948, 9998) — lieux de prise et de retour, sous + * les rôles de PRODUCTION (assertion L0-05 en tête de chaque connexion : `withRole`, `connectAs`), + * au Panama (USD) et au Paraguay (PYG sans décimale). Tout se passe dans des transactions ANNULÉES. + * + * Attendus tirés de 19 US-514 (« Given une demande avec retour différent, When elle est soumise, + * Then ONE_WAY_NOT_ALLOWED » ; « Given un trip BOOKED, When le voyageur ouvre le détail, Then + * l'adresse exacte du lieu de remise s'affiche ; avant confirmation, seule la zone est visible » ; + * « Given la fin du trip + review_window_days, When la purge tourne, Then l'adresse de l'hôte + * disparaît de la vue du voyageur »), de 16 BKG-016 (retour au même lieu, one-way interdit ; trip + * annulé ⇒ adresse retirée), de 08 BR-BOOK-09 (pas de one-way à la réservation) et de 08 + * BR-REVIEW-01 (fenêtre de 10 jours après la fin, `review_window_days` du pays, graine 0009), + * jamais du code testé. + * + * Le devis du critère 1 est figé par la VRAIE commande de gel (US-208, US-226) avec les vecteurs du + * checkout repris de l0-us223-request-checkout (TA01 en PA, D2 en PY) : ils ne servent qu'à obtenir + * un devis du voyageur, aucun montant n'est vérifié ici. Interrupteurs ouverts par la procédure à + * deux personnes d'US-125, dans la transaction annulée. + */ +import { randomBytes } from 'node:crypto'; +import type pg from 'pg'; +import { describe, expect, it } from 'vitest'; +import { APP_ROLES, OWNER_ROLES } from '../../src/index.ts'; +import { + connectAs, + releaseClient, + withRole, + withTestTransaction, +} from '../../src/testing/index.ts'; +import { COUNTRIES, inTx, uuid } from '../support/avl.ts'; +import type { CountryCase } from '../support/avl.ts'; +import { + approveDriver, + checkoutPerson, + frozenQuote, + openSwitch, + protectionParams, + quoteDocs, + taxGroups, +} from '../support/checkout.ts'; +import type { CheckoutVector, Person } from '../support/checkout.ts'; +import { openSession, setVirtualNow } from '../support/iam.ts'; + +type Tx = pg.ClientBase; +type Row = Record; + +const NOW = '2026-12-01T12:00:00.000Z'; +const START = '2026-12-10T15:00:00.000Z'; + +/** Vecteurs du checkout (voir l'en-tête), seulement pour figer un devis. */ +const VECTORS: Readonly> = { + PA: { + daily: 4_000, + schedule: { tiers: [{ maxDays: null, rateBps: 0 }], minMinor: '0' }, + fee: 0, + taxes: { TRIP_PRICE: 840 }, + host: 9_000, + total: 15_840, + basicaPrice: '1/4', + protection: 3_000, + insurer: 2_100, + }, + PY: { + daily: 333_334, + schedule: null, + fee: 150_000, + taxes: { TRIP_PRICE: 100_000, TRIP_FEE: 15_000 }, + host: 750_001, + total: 1_415_002, + basicaPrice: '3/20', + protection: 150_000, + insurer: 105_000, + }, +}; + +/** Fenêtre de 08 BR-REVIEW-01 (graine 0009 de `review_window_days`, PA et PY), en minutes. */ +const WINDOW_MIN = 10 * 24 * 60; +/** Trip de la fixture 9948 (bien après la migration du banc : les paramètres y sont en vigueur). */ +const T0 = '2035-05-02T09:17:23.000Z'; +const TRIP_START = '2035-06-10T15:00:00.000Z'; +const TRIP_END = '2035-06-13T15:00:00.000Z'; +const LINES: Readonly> = { + USD: [{ type: 'TRIP_PRICE', amountMinor: '12000' }], + PYG: [{ type: 'TRIP_PRICE', amountMinor: '1000000' }], +}; +/** États où les lectures du voyageur rendent l'adresse (US-204, US-214) ; terminés ou annulés. */ +const MEETING_STATES = ['BOOKED', 'CHECKIN_OPEN', 'START_WINDOW_EXPIRED', 'IN_PROGRESS', 'OVERDUE']; +const LIST_STATES = [...MEETING_STATES, 'UNRETURNED']; +const CLOSED_STATES = ['RETURNED', 'COMPLETED', 'CANCELLED_BY_GUEST', 'CANCELLED_BY_HOST']; + +const RETURN_PLACE = 'SELECT * FROM core.booking_checkout_return_place($1, $2::uuid, $3::uuid)'; +const MEET = 'SELECT * FROM core.catalog_guest_meeting_point($1, $2::uuid)'; +const LIST = 'SELECT * FROM core.booking_guest_trips($1, NULL, $2::uuid, 200)'; + +const at = (iso: string, minutes: number): string => + new Date(Date.parse(iso) + minutes * 60_000).toISOString(); + +/** Scénario du devis : interrupteurs, barème de test, grille de protection (transaction annulée). */ +function quoteScenario(cc: CountryCase) { + return (fn: (tx: Tx, groups: Map) => Promise) => + withRole('app_api', (client) => + withTestTransaction(client, { virtualNow: NOW }, async (tx) => { + await openSwitch(tx, 'p2p_private_hosts_enabled', cc.country); + await openSwitch(tx, 'insurer_contract_active', cc.country); + const v = VECTORS[cc.country]!; + if (v.schedule !== null) { + await tx.query('SELECT test_fixture.us704_set_trip_fee_schedule($1, $2::jsonb)', [ + cc.country, + JSON.stringify(v.schedule), + ]); + } + await protectionParams(tx, cc.country, v); + await fn(tx, await taxGroups(tx, cc)); + }), + ); +} + +async function guest(tx: Tx, cc: CountryCase): Promise { + const p = await checkoutPerson(tx, cc.country); + await approveDriver(tx, p, cc.country, { birth: '1990-01-01', licenseExpiry: '2030-12-31' }); + return p; +} + +/** Annonce LISTED (fixture 9998) et lieu de son véhicule (fixture 9985). */ +async function listing(tx: Tx, cc: CountryCase): Promise<{ listingId: string; place: string }> { + const { rows } = await tx.query<{ listing_id: string; vehicle_id: string }>( + 'SELECT * FROM test_fixture.us208_listed_listing($1, $2, $3, $4)', + [cc.country, VECTORS[cc.country]!.daily, 'AUTOMATIC', true], + ); + const v = await tx.query<{ home_location_id: string }>( + 'SELECT home_location_id FROM test_fixture.us115_vehicle_row($1)', + [rows[0]!.vehicle_id], + ); + return { listingId: rows[0]!.listing_id, place: v.rows[0]!.home_location_id }; +} + +const returnPlace = async ( + tx: Tx, + hash: Buffer, + quoteId: string, + place: string | null, +): Promise => + (await tx.query<{ outcome: string }>(RETURN_PLACE, [hash, quoteId, place])).rows.map( + (r) => r.outcome, + )[0]; + +/** Trip BOOKED de la fixture 9948 (voyageur nommé, hôte, véhicule, lieu, annonce LISTED). */ +async function trip(tx: Tx, c: CountryCase, guestId: string): Promise { + await setVirtualNow(tx, T0); + const { rows } = await tx.query<{ trip_id: string }>( + `SELECT * FROM test_fixture.us214_trip($1, $2, 'Ana', 'Pérez', 'María', 'Gómez', $3, $4, + $5::jsonb)`, + [c.country, guestId, TRIP_START, TRIP_END, JSON.stringify(LINES[c.currency])], + ); + return rows[0]!.trip_id; +} + +/** Ce que voit le voyageur à l'instant `iso` : lieu exact de la fiche et détail du trip. */ +async function seenAt( + tx: Tx, + guestId: string, + listingId: string, + tripId: string, + iso: string, +): Promise<{ meeting: Row[]; detail: Row | undefined }> { + await setVirtualNow(tx, iso); + // session ouverte à cet instant (une session ouverte en T0 serait échue) + const s = await openSession(tx, guestId); + return { + meeting: (await tx.query(MEET, [s.hash, listingId])).rows, + detail: (await tx.query(LIST, [s.hash, tripId])).rows[0], + }; +} + +describe.each(COUNTRIES)('US-514 — lieux de prise et de retour ($country, $currency)', (cc) => { + it('critère 1 : lieu de retour différent du lieu de prise ⇒ ONE_WAY_NOT_ALLOWED ; absent ou identique ⇒ DONE ; devis d’autrui ou inconnu ⇒ QUOTE_NOT_FOUND ; sans session ⇒ AUTH_REQUIRED', async () => { + await quoteScenario(cc)(async (tx, groups) => { + const v = VECTORS[cc.country]!; + const p = await guest(tx, cc); + const other = await guest(tx, cc); + const mine = await listing(tx, cc); + const elsewhere = await listing(tx, cc); + expect(elsewhere.place).not.toBe(mine.place); + const d = quoteDocs(cc, v, groups, Date.parse(START), Date.parse(NOW)); + const quoteId = await frozenQuote(tx, p, mine.listingId, d); + + // retour au même lieu (par défaut, ou nommé) : accepté + expect(await returnPlace(tx, p.hash, quoteId, null)).toBe('DONE'); + expect(await returnPlace(tx, p.hash, quoteId, mine.place)).toBe('DONE'); + // lieu d'un autre véhicule, ou lieu inconnu : one-way, refusé + expect(await returnPlace(tx, p.hash, quoteId, elsewhere.place)).toBe('ONE_WAY_NOT_ALLOWED'); + expect(await returnPlace(tx, p.hash, quoteId, uuid())).toBe('ONE_WAY_NOT_ALLOWED'); + // devis d'un autre voyageur ou inconnu : même réponse, aucun oracle sur le lieu + expect(await returnPlace(tx, other.hash, quoteId, mine.place)).toBe('QUOTE_NOT_FOUND'); + expect(await returnPlace(tx, other.hash, quoteId, uuid())).toBe('QUOTE_NOT_FOUND'); + expect(await returnPlace(tx, p.hash, uuid(), mine.place)).toBe('QUOTE_NOT_FOUND'); + // session inconnue + expect(await returnPlace(tx, randomBytes(32), quoteId, mine.place)).toBe('AUTH_REQUIRED'); + // la lecture ne rend jamais le lieu lui-même + const raw = await tx.query(RETURN_PLACE, [p.hash, quoteId, uuid()]); + expect(raw.fields.map((f) => f.name)).toEqual(['outcome']); + }); + }); + + it('critère 2 : trip BOOKED ⇒ l’adresse exacte est rendue au seul voyageur (fiche et détail du trip) ; la fiche publique ne la contient jamais ; trip terminé ou annulé ⇒ retirée', async () => { + const api = await connectAs('app_api'); + try { + await inTx(api, { virtualNow: T0 }, async (tx) => { + const guestId = uuid(); + const tripId = await trip(tx, cc, guestId); + const listingId = ( + await tx.query<{ l: string }>('SELECT test_fixture.us514_trip_listing($1) AS l', [tripId]) + ).rows[0]!.l; + const before = at(TRIP_START, -24 * 60); + const seen = await seenAt(tx, guestId, listingId, tripId, before); + expect(seen.meeting).toHaveLength(1); + const address = seen.meeting[0]!['address_line']; + expect(address).toEqual(expect.any(String)); + expect(seen.detail).toMatchObject({ tab: 'UPCOMING', place_address: address }); + + // autre personne (sans trip de ce véhicule) : rien + const stranger = uuid(); + await trip(tx, cc, stranger); + await setVirtualNow(tx, before); + const s = await openSession(tx, stranger); + expect((await tx.query(MEET, [s.hash, listingId])).rows).toEqual([]); + expect((await tx.query(LIST, [s.hash, tripId])).rows).toEqual([]); + + // visiteur : la fiche publique ne porte ni le libellé ni l'adresse + const pub = await tx.query('SELECT * FROM core.catalog_public_listing($1)', [ + listingId, + ]); + expect(JSON.stringify(pub.rows)).not.toContain(String(address)); + + // trip terminé ou annulé : plus d'adresse, ni sur la fiche ni dans le détail + for (const status of CLOSED_STATES) { + await tx.query('SAVEPOINT us514_status'); + await tx.query('SELECT test_fixture.us207_force_status($1, $2)', [tripId, status]); + const closed = await seenAt(tx, guestId, listingId, tripId, before); + expect(closed.meeting, status).toEqual([]); + expect(closed.detail?.['place_address'], status).toBeNull(); + await tx.query('ROLLBACK TO SAVEPOINT us514_status'); + } + }); + } finally { + await releaseClient(api); + } + }); + + it('critère 3 : au-delà de la fin prévue + review_window_days, l’adresse disparaît de la vue du voyageur (fiche et détail), quel que soit l’état ; libellé et ville restent ; paramètre absent ⇒ jamais rendue', async () => { + const api = await connectAs('app_api'); + try { + await inTx(api, { virtualNow: T0 }, async (tx) => { + const guestId = uuid(); + const tripId = await trip(tx, cc, guestId); + const listingId = ( + await tx.query<{ l: string }>('SELECT test_fixture.us514_trip_listing($1) AS l', [tripId]) + ).rows[0]!.l; + const inside = at(TRIP_END, WINDOW_MIN - 1); + const outside = at(TRIP_END, WINDOW_MIN + 1); + for (const status of LIST_STATES) { + await tx.query('SAVEPOINT us514_status'); + await setVirtualNow(tx, T0); + if (status !== 'BOOKED') { + await tx.query('SELECT test_fixture.us207_force_status($1, $2)', [tripId, status]); + } + const a = await seenAt(tx, guestId, listingId, tripId, inside); + expect(a.detail?.['place_address'], `${status} dans la fenêtre`).toEqual( + expect.any(String), + ); + expect(a.meeting, `${status} dans la fenêtre`).toHaveLength( + MEETING_STATES.includes(status) ? 1 : 0, + ); + const b = await seenAt(tx, guestId, listingId, tripId, outside); + expect(b.meeting, `${status} après la fenêtre`).toEqual([]); + expect(b.detail, `${status} après la fenêtre`).toMatchObject({ + item_id: tripId, + place_address: null, + place_label: a.detail?.['place_label'], + place_city: a.detail?.['place_city'], + }); + await tx.query('ROLLBACK TO SAVEPOINT us514_status'); + } + + // paramètre du pays fermé (absent) : fail-closed, aucune adresse même dans la fenêtre + await setVirtualNow(tx, at(TRIP_START, -24 * 60)); + await tx.query('SELECT test_fixture.us514_close_review_window($1)', [cc.country]); + const closed = await seenAt(tx, guestId, listingId, tripId, at(TRIP_START, -23 * 60)); + expect(closed.meeting).toEqual([]); + expect(closed.detail).toMatchObject({ tab: 'UPCOMING', place_address: null }); + }); + } finally { + await releaseClient(api); + } + }); +}); + +describe('US-514 — lieu figé à la réservation et droits (0142)', () => { + it('aucun rôle applicatif ni propriétaire de commandes ne peut modifier un lieu ni le lieu d’un véhicule', async () => { + const roles = [...APP_ROLES, ...OWNER_ROLES]; + const columns: [string, string][] = [ + ...['kind', 'place_label', 'address_line', 'city', 'area_label', 'geo', 'geo_public'].map( + (c): [string, string] => ['core.catalog_location', c], + ), + ['core.catalog_vehicle', 'home_location_id'], + ]; + await withRole('app_api', async (client) => { + const writable: string[] = []; + for (const role of roles) { + for (const [table, column] of columns) { + const { rows } = await client.query<{ ok: boolean }>( + `SELECT pg_catalog.has_column_privilege($1::name, $2::regclass, $3::text, 'UPDATE') AS ok`, + [role, table, column], + ); + if (rows[0]?.ok === true) writable.push(`${role} ${table}.${column}`); + } + } + expect(writable).toEqual([]); + }); + }); + + it('app_worker et app_anon n’exécutent pas la lecture du lieu de retour (42501)', async () => { + for (const role of ['app_worker', 'app_anon'] as const) { + await withRole(role, async (client) => { + await client.query('BEGIN'); + try { + await expect( + client.query(RETURN_PLACE, [randomBytes(32), uuid(), uuid()]), + role, + ).rejects.toMatchObject({ code: '42501' }); + } finally { + await client.query('ROLLBACK'); + } + }); + } + }); +}); diff --git a/packages/i18n/src/catalogs/en.ts b/packages/i18n/src/catalogs/en.ts index b8fc37aa2..159084922 100644 --- a/packages/i18n/src/catalogs/en.ts +++ b/packages/i18n/src/catalogs/en.ts @@ -2025,6 +2025,7 @@ export const EN_MESSAGES = { 'common.checkout.quoteAlreadyUsed': 'You already booked with this price. Check your booking.', 'common.checkout.holdNotFound': 'We can’t find this booking in your account.', 'common.checkout.noticeTooShort': 'The host needs more notice. Choose a later start time.', + 'common.checkout.oneWayNotAllowed': 'You return the car to the same place you pick it up.', 'common.checkout.guestOverlap': 'You already have a trip on these dates. Choose other dates.', 'common.checkout.holdAlreadyLive': 'You’re already booking this car. Finish that booking or wait a few minutes.', diff --git a/packages/i18n/src/catalogs/es.ts b/packages/i18n/src/catalogs/es.ts index 6a6e6a22a..f90ee151b 100644 --- a/packages/i18n/src/catalogs/es.ts +++ b/packages/i18n/src/catalogs/es.ts @@ -2079,6 +2079,7 @@ export const ES_MESSAGES = { 'common.checkout.holdNotFound': 'No encontramos esta reserva en tu cuenta.', 'common.checkout.noticeTooShort': 'El anfitrión necesita más anticipación. Elige una hora de inicio más tarde.', + 'common.checkout.oneWayNotAllowed': 'Devuelves el auto en el mismo lugar donde lo recoges.', 'common.checkout.guestOverlap': 'Ya tienes un viaje en esas fechas. Elige otras.', 'common.checkout.holdAlreadyLive': 'Ya estás reservando este auto. Termina esa reserva o espera unos minutos.', diff --git a/packages/i18n/src/catalogs/fr.ts b/packages/i18n/src/catalogs/fr.ts index c9a0f0b0f..4a0bb5feb 100644 --- a/packages/i18n/src/catalogs/fr.ts +++ b/packages/i18n/src/catalogs/fr.ts @@ -2131,6 +2131,8 @@ export const FR_MESSAGES = { 'common.checkout.holdNotFound': 'Nous ne trouvons pas cette réservation dans ton compte.', 'common.checkout.noticeTooShort': 'L’hôte a besoin de plus de préavis. Choisis une heure de début plus tardive.', + 'common.checkout.oneWayNotAllowed': + 'Tu rends la voiture au même endroit que celui où tu la récupères.', 'common.checkout.guestOverlap': 'Tu as déjà un trajet à ces dates. Choisis-en d’autres.', 'common.checkout.holdAlreadyLive': 'Tu es déjà en train de réserver cette voiture. Termine cette réservation ou attends quelques minutes.', diff --git a/packages/i18n/src/catalogs/index.ts b/packages/i18n/src/catalogs/index.ts index c853d9103..367073ae6 100644 --- a/packages/i18n/src/catalogs/index.ts +++ b/packages/i18n/src/catalogs/index.ts @@ -252,8 +252,11 @@ export type { Catalog, Message, PluralCategory, PluralMessage, VersionedCatalog remboursement réparti sur les moyens d’origine (US-224 partie 224f, ADR-166) : `backoffice.cancel.outcome.REFUND_RAIL_UNAVAILABLE`, `…REFUND_RAIL_NOT_NATIVE`, `…REFUND_EXCEEDS_TENDER` (codes d’une demande d’annulation garée, console). + Version 83 (la 82 est réservée à US-225, en cours ; la 81 est celle d’US-224f) : lieux de prise + et de retour (US-514, ADR-168) : `common.checkout.oneWayNotAllowed` (lieu de retour différent du + lieu de prise refusé au checkout, 16 BKG-016 : one-way interdit). */ -export const CATALOG_VERSION = 81; +export const CATALOG_VERSION = 83; /** Catalogues de base par langue ; la langue d'un profil de locale choisit le sien. */ export const CATALOGS: Readonly>> = { diff --git a/packages/i18n/src/catalogs/pt.ts b/packages/i18n/src/catalogs/pt.ts index 2b4e036e8..837f22eec 100644 --- a/packages/i18n/src/catalogs/pt.ts +++ b/packages/i18n/src/catalogs/pt.ts @@ -2085,6 +2085,7 @@ export const PT_MESSAGES = { 'common.checkout.holdNotFound': 'Não encontramos esta reserva na sua conta.', 'common.checkout.noticeTooShort': 'O anfitrião precisa de mais antecedência. Escolha um horário de início mais tarde.', + 'common.checkout.oneWayNotAllowed': 'Você devolve o carro no mesmo lugar onde o retira.', 'common.checkout.guestOverlap': 'Você já tem uma viagem nessas datas. Escolha outras.', 'common.checkout.holdAlreadyLive': 'Você já está reservando este carro. Termine essa reserva ou espere alguns minutos.', From b9c655ed573e8f7c3626f4e32705b0eed5bc8f5d Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 14:43:17 -0300 Subject: [PATCH 2/3] =?UTF-8?q?test(US-514):=20politiques=20de=20la=20fen?= =?UTF-8?q?=C3=AAtre=20de=20l'adresse=20dans=20la=20liste=20exhaustive=20d?= =?UTF-8?q?e=20config-country=20;=20schema.md=20recopi=C3=A9=20de=20la=20C?= =?UTF-8?q?I?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Justification du test de sécurité modifié (packages/db/test/int/config-country.test.ts) : la liste exhaustive des politiques de config_param_value reçoit exactement les deux politiques ajoutées par 0143 (catalog_cmd_meeting_read, cmd_hold_meeting_read : SELECT, clé review_window_days seulement) ; aucune attente existante n'est retirée ni relâchée. Agent-Role: back-end Agent-Model: claude-opus-5-5 Co-Authored-By: Claude Opus 5.5 --- docs/architecture/schema.md | 6 +++++- packages/db/test/int/config-country.test.ts | 10 +++++++++- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/architecture/schema.md b/docs/architecture/schema.md index ba7762c0b..69835a0cd 100644 --- a/docs/architecture/schema.md +++ b/docs/architecture/schema.md @@ -7,7 +7,7 @@ Lu dans le catalogue (`pg_catalog`) d'une base jetable du banc, après les seule ## Synthèse -- 143 migrations ; 127 tables ; 3 vues ; 714 politiques RLS ; 285 fonctions `SECURITY DEFINER` ; 249 autres fonctions. +- 144 migrations ; 127 tables ; 3 vues ; 716 politiques RLS ; 286 fonctions `SECURITY DEFINER` ; 249 autres fonctions. - Tables sans RLS `ENABLE` + `FORCE` : aucune. - Rôles applicatifs avec `SUPERUSER` ou `BYPASSRLS` : aucun. @@ -158,6 +158,7 @@ Lu dans le catalogue (`pg_catalog`) d'une base jetable du banc, après les seule | `0140_booking_defaulted_host_trips_cancel` | AVL / SUP : hôte défaillant, annulation de ses trips à venir par l'ops, voyageurs remboursés | | `0141_payment_refund_multi_tender` | PAY : remboursement réparti sur les moyens d'origine (TJ16c / TJ16d) et reprise après un | | `0142_config_deposit_rail_params` | graine complémentaire : paramètres « deposit_always_required* » (US-225 ; 17 §7.2). | +| `0143_booking_meeting_place` | AVL / CAT : lieux de prise et de retour (US-514 ; 19 US-514 ; 16 BKG-016 ; 08 BR-BOOK-09 ; | ## Rôles @@ -2608,6 +2609,7 @@ Politiques RLS : - `app_read` (SELECT, PERMISSIVE, app_api, app_worker) USING `true` - `catalog_cmd_claim_read` (SELECT, PERMISSIVE, catalog_cmd_owner) USING `(key = 'plate_claims_open_per_host'::text)` - `catalog_cmd_insurer_read` (SELECT, PERMISSIVE, catalog_cmd_owner) USING `(key = 'insurer_contract_active'::text)` +- `catalog_cmd_meeting_read` (SELECT, PERMISSIVE, catalog_cmd_owner) USING `(key = 'review_window_days'::text)` - `catalog_cmd_plan_read` (SELECT, PERMISSIVE, catalog_cmd_owner) USING `(key = ANY (ARRAY['host_share_pct'::text, 'host_default_plan'::text]))` - `catalog_cmd_publish_read` (SELECT, PERMISSIVE, catalog_cmd_owner) USING `(key = 'listing_manual_review_required'::text)` - `catalog_cmd_read` (SELECT, PERMISSIVE, catalog_cmd_owner) USING `(key = ANY (ARRAY['price_display_step_minor'::text, 'listing_min_photos'::text, 'price_ceiling_daily_minor'::text, 'price_ceiling_extra_km_minor'::text, 'p2p_private_hosts_enabled'::text, 'advance_notice_minutes'::text, 'vehicle_financed_requires_lender_consent'::text, 'elig_age_years_ceiling'::text, 'elig_odometer_km_ceiling'::text, 'elig_doc_title'::text, 'elig_doc_plate_vin_photo'::text, 'elig_doc_inspection'::text, 'elig_doc_compulsory_insurance'::text, 'elig_doc_owner_authorization'::text, 'elig_doc_lender_consent'::text]))` @@ -2619,6 +2621,7 @@ Politiques RLS : - `cmd_golive_sel` (SELECT, PERMISSIVE, cmd_golive_owner) USING `((go_live_request_id IS NOT NULL) OR (key IN ( SELECT d.key FROM core.config_param_definition d WHERE d.go_live_switch)))` - `cmd_hold_cancel_read` (SELECT, PERMISSIVE, cmd_hold_owner) USING `(key = ANY (ARRAY['free_cancel_lead'::text, 'last_minute_threshold'::text, 'host_penalty'::text, 'platform_funded_host_compensation'::text]))` - `cmd_hold_contract_param_read` (SELECT, PERMISSIVE, cmd_hold_owner) USING `(key = 'grace_minutes'::text)` +- `cmd_hold_meeting_read` (SELECT, PERMISSIVE, cmd_hold_owner) USING `(key = 'review_window_days'::text)` - `cmd_hold_read` (SELECT, PERMISSIVE, cmd_hold_owner) USING `(key = ANY (ARRAY['buffer_minutes'::text, 'hold_ttl_minutes'::text, 'hold_max_total_minutes'::text, 'max_active_holds_per_guest'::text, 'hold_creations_per_guest_vehicle_hour'::text, 'sweep_grace_s'::text, 'flagged_booking_payment_order'::text, 'review_hold_minutes'::text, 'payment_in_flight_margin_s'::text, 'psp_call_timeout_s'::text, 'conversion_start_tolerance_minutes'::text, 'payment_attempts_per_hold'::text, 'max_trip_days'::text, 'advance_notice_minutes'::text, 'no_show_grace_minutes'::text, 'overdue_detection_minutes'::text, 'p2p_private_hosts_enabled'::text, 'insurer_contract_active'::text]))` - `cmd_hold_request_param_read` (SELECT, PERMISSIVE, cmd_hold_owner) USING `(key = ANY (ARRAY['booking_request_mode_enabled'::text, 'booking_request_expiry_hours'::text]))` - `cmd_hold_risk_read` (SELECT, PERMISSIVE, cmd_hold_owner) USING `(key = ANY (ARRAY['min_driver_age'::text, 'foreign_license_review_enabled'::text]))` @@ -6347,6 +6350,7 @@ Chacune a un propriétaire `NOLOGIN` dédié (ADR-053) et un `search_path` figé | `core.booking_checkout_protection(p_token_hash bytea, p_quote_id uuid)` | `TABLE(quote_id uuid, protection_level text, driver_age integer, frozen_at timestamp with time zone, insurer_contract_active boolean)` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | | `core.booking_checkout_quote(p_token_hash bytea, p_quote_id uuid)` | `TABLE(quote_id uuid, listing_id uuid, country_code text, currency text, start_at timestamp with time zone, end_at timestamp with time zone, billable_days integer, lines jsonb, total_minor bigint, expires_at timestamp with time zone, expired boolean, manual_transmission boolean, instant_book boolean, documents jsonb)` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | | `core.booking_checkout_request(p_token_hash bytea, p_hold_id uuid)` | `TABLE(outcome text, hold_kind text, request_status text, request_respond_by timestamp with time zone)` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | +| `core.booking_checkout_return_place(p_token_hash bytea, p_quote_id uuid, p_return_location_id uuid)` | `TABLE(outcome text)` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | | `core.booking_checkout_review_state(p_token_hash bytea, p_hold_id uuid)` | `TABLE(hold_id uuid, review_state text)` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | | `core.booking_checkout_summary(p_token_hash bytea, p_hold_id uuid)` | `TABLE(hold_id uuid, status text, expires_at timestamp with time zone, quote_id uuid, listing_id uuid, currency text, start_at timestamp with time zone, end_at timestamp with time zone, total_minor bigint, manual_confirmed_at timestamp with time zone, documents jsonb)` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | | `core.booking_cmd_accept_booking_request(p_token_hash bytea, p_org uuid, p_hold_id uuid)` | `jsonb` | `cmd_hold_owner` | search_path=pg_catalog, pg_temp | app_api: EXECUTE ; cmd_hold_owner: EXECUTE | diff --git a/packages/db/test/int/config-country.test.ts b/packages/db/test/int/config-country.test.ts index 1457758c8..feb4835c0 100644 --- a/packages/db/test/int/config-country.test.ts +++ b/packages/db/test/int/config-country.test.ts @@ -160,7 +160,7 @@ describe('configuration pays : structure et droits', () => { ); }); - it('base de production : seules les politiques migrator_all et app_read (SELECT) existent, plus la lecture du tampon par cmd_hold_owner, celle des codes pays par iam_staff_owner (US-012) et celle des fuseaux par risk_limit_owner (US-052) et celle des interrupteurs par cmd_money_owner (US-049), et celle des codes pays par iam_auth_owner (US-102), et celle de l’âge minimal de l’hôte par iam_auth_owner (US-107), et celle des délais des files par iam_staff_owner (US-109), et celle des paramètres de l’OTP par iam_auth_owner (US-104), et celle du pas de prix, du minimum de photos et de l’ouverture aux hôtes par catalog_cmd_owner (US-115), et celle des pays et de la rétention biométrique par kyc_cmd_owner (US-105), et la lecture et l’écriture des interrupteurs par cmd_golive_owner (US-125), et celle de l’âge minimal, du numéro fiscal et des interrupteurs de l’hôte par kyc_cmd_owner (US-123), et celles de la revue par exception par kyc_cmd_owner et du contrat d’assureur par catalog_cmd_owner (US-108), et celle du registre et des durées de la vie privée par privacy_cmd_owner (US-111), et celle des délais de notification d’une violation par iam_staff_owner (US-112), et celle du plafond des contestations par catalog_cmd_owner (US-122), et celle des plafonds de téléversement par catalog_cmd_owner (US-122, passe n° 2), et celles des paramètres et des taxes du rejeu du devis par cmd_money_owner (US-202), et celle de la durée maximale et du tampon par catalog_cmd_owner (US-201), et celle de la fenêtre de notation par review_cmd_owner (US-218), et celle des interrupteurs de l’hôte activable par cmd_hold_owner (US-208), et celle de l’annulation et du minimum de RC par catalog_cmd_owner (US-205), et celle des paramètres d’annulation réglée par cmd_hold_owner (US-215)', async () => { + it('base de production : seules les politiques migrator_all et app_read (SELECT) existent, plus la lecture du tampon par cmd_hold_owner, celle des codes pays par iam_staff_owner (US-012) et celle des fuseaux par risk_limit_owner (US-052) et celle des interrupteurs par cmd_money_owner (US-049), et celle des codes pays par iam_auth_owner (US-102), et celle de l’âge minimal de l’hôte par iam_auth_owner (US-107), et celle des délais des files par iam_staff_owner (US-109), et celle des paramètres de l’OTP par iam_auth_owner (US-104), et celle du pas de prix, du minimum de photos et de l’ouverture aux hôtes par catalog_cmd_owner (US-115), et celle des pays et de la rétention biométrique par kyc_cmd_owner (US-105), et la lecture et l’écriture des interrupteurs par cmd_golive_owner (US-125), et celle de l’âge minimal, du numéro fiscal et des interrupteurs de l’hôte par kyc_cmd_owner (US-123), et celles de la revue par exception par kyc_cmd_owner et du contrat d’assureur par catalog_cmd_owner (US-108), et celle du registre et des durées de la vie privée par privacy_cmd_owner (US-111), et celle des délais de notification d’une violation par iam_staff_owner (US-112), et celle du plafond des contestations par catalog_cmd_owner (US-122), et celle des plafonds de téléversement par catalog_cmd_owner (US-122, passe n° 2), et celles des paramètres et des taxes du rejeu du devis par cmd_money_owner (US-202), et celle de la durée maximale et du tampon par catalog_cmd_owner (US-201), et celle de la fenêtre de notation par review_cmd_owner (US-218), et celle des interrupteurs de l’hôte activable par cmd_hold_owner (US-208), et celle de l’annulation et du minimum de RC par catalog_cmd_owner (US-205), et celle des paramètres d’annulation réglée par cmd_hold_owner (US-215), et celle de la fenêtre de la vue de l’adresse par catalog_cmd_owner et cmd_hold_owner (US-514)', async () => { await withRole( 'app_api', async (client) => { @@ -187,6 +187,10 @@ describe('configuration pays : structure et droits', () => { ...(t === 'config_param_definition' || t === 'config_param_value' ? [{ t, pol: 'catalog_cmd_insurer_read', cmd: 'r', roles: 'catalog_cmd_owner' }] : []), + // lieu exact de la fiche (US-514, 0143) : fenêtre review_window_days seulement + ...(t === 'config_param_value' + ? [{ t, pol: 'catalog_cmd_meeting_read', cmd: 'r', roles: 'catalog_cmd_owner' }] + : []), // plans de gains de l'hôte (US-226, 0110) : host_share_pct et host_default_plan seulement ...(t === 'config_param_value' ? [{ t, pol: 'catalog_cmd_plan_read', cmd: 'r', roles: 'catalog_cmd_owner' }] @@ -246,6 +250,10 @@ describe('configuration pays : structure et droits', () => { ...(t === 'config_param_value' ? [{ t, pol: 'cmd_hold_contract_param_read', cmd: 'r', roles: 'cmd_hold_owner' }] : []), + // détail du trip du voyageur (US-514, 0143) : fenêtre review_window_days seulement + ...(t === 'config_param_value' + ? [{ t, pol: 'cmd_hold_meeting_read', cmd: 'r', roles: 'cmd_hold_owner' }] + : []), // commandes d'occupation (0032, US-022) : clé buffer_minutes seulement, en lecture ; // checkout (US-208, 0108) : interrupteurs de l'hôte activable (définition et valeur) ...(t === 'config_param_definition' || t === 'config_param_value' From de77aba92c469c924fe0c14d623456f52cdd9699 Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 15:56:17 -0300 Subject: [PATCH 3/3] docs(US-514): revues architecture, code, qa, securite et ux (claude-sonnet-5-5) Agent-Role: revue-securite Agent-Model: claude-sonnet-5-5 Co-Authored-By: Claude Sonnet 5.5 --- .../reviews/US-514/architecture-2026-11-18.md | 17 ++++++++++++++++ docs/team/reviews/US-514/code-2026-11-18.md | 17 ++++++++++++++++ docs/team/reviews/US-514/qa-2026-11-18.md | 17 ++++++++++++++++ .../reviews/US-514/securite-2026-11-18.md | 20 +++++++++++++++++++ docs/team/reviews/US-514/ux-2026-11-18.md | 16 +++++++++++++++ 5 files changed, 87 insertions(+) create mode 100644 docs/team/reviews/US-514/architecture-2026-11-18.md create mode 100644 docs/team/reviews/US-514/code-2026-11-18.md create mode 100644 docs/team/reviews/US-514/qa-2026-11-18.md create mode 100644 docs/team/reviews/US-514/securite-2026-11-18.md create mode 100644 docs/team/reviews/US-514/ux-2026-11-18.md diff --git a/docs/team/reviews/US-514/architecture-2026-11-18.md b/docs/team/reviews/US-514/architecture-2026-11-18.md new file mode 100644 index 000000000..2ef11ac75 --- /dev/null +++ b/docs/team/reviews/US-514/architecture-2026-11-18.md @@ -0,0 +1,17 @@ +# Revue architecture — US-514 « Lieux de prise et de retour » (PR n° 241) — 2026-11-18 + +Relecteur : revue-architecture / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 4b07e4a0d71bac9282a24c4f6710f11f638edc3a..e2eb2e6704816dbd1d5164bf556262a4094985b1 + +Contexte : lu CLAUDE.md, OPERATING_RULES (revues), ADR-168, passation US-514, US-514 de 19, BKG-016 de 16, passations US-115, US-204, US-214, le diff `origin/main...e2eb2e67` (28 fichiers) ; tête vérifiée inchangée ; CI verte au SHA relu (run 44370790154, dont base de données, qualité, revues). Rien exécuté localement. + +| # | Gravité | Constat | +| --- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 1 | INFO | **Numérotation contiguë.** Main est à 0143 (#237) ; la migration 0144, le catalogue v83 (82 = US-225), GL-45 et la fixture 9939 sont libres ; `schema.md` (145 migrations, 722 politiques, 290 `SECURITY DEFINER`, entrées 0144 et fonction) est cohérent avec la migration et le job base de données est vert. ADR-167 reste un trou de numérotation (attribution de l'orchestrateur, hors périmètre). | +| 2 | INFO | **Découpage conforme.** Aucune route, table ni colonne : une lecture SQL (`booking_checkout_return_place`, famille cmd_hold, propriétaire dédié, EXECUTE app_api), une étape du service avant la commande de checkout inchangée, un port `returnPlace` dans `CheckoutStore` (réel, indisponible, FAKE). Aucun import interne d'un autre module ; OpenAPI et `api.md` régénérés. | +| 3 | INFO | **Décisions PROPOSÉ bien posées.** Retour au même lieu toujours ; adresse bornée à fin prévue + `review_window_days` jugée à chaque lecture (rien copié, donc ni travailleur de purge ni donnée à effacer) : plus simple et plus minimal qu'une purge, cohérent avec ADR-132 et ADR-160, inscrit dans COMME_TURO. L'écart de vocabulaire avec le critère 3 (« la purge tourne ») est déclaré dans l'ADR et la passation. | +| 4 | INFO | **Suites déclarées et tracées.** Choix du point (BKG-016 alternatif), consignes N-148, report en 17 §2.3 et 16 A.8 par PR revue, conservation du contrat (0122 porte l'adresse), N-181 (corps de `booking_guest_trips` recopié : la prochaine story qui le remplace repart de 0144) : toutes dans la passation et GL-45. | +| 5 | MINEUR | **Deux sources de pays pour la même borne.** `catalog_guest_meeting_point` lit `review_window_days` du pays du trip (`t.country_code`), `booking_guest_trips` du pays du véhicule (`cv.country_code`, 0144 §3.1). Identiques tant qu'un trip a le pays de son véhicule, mais l'écart est inutile : aligner à la prochaine reprise du corps (N-181). Non bloquant. | +| 6 | INFO | **Recopie de corps assumée.** Les deux fonctions remplacées sont identiques à leur dernière définition (0106 et 0136) hors bloc de la fenêtre (comparé ligne à ligne) ; propriétaire, EXECUTE et `search_path` conservés par `CREATE OR REPLACE` sous le propriétaire d'origine ; retour arrière documenté. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-514/code-2026-11-18.md b/docs/team/reviews/US-514/code-2026-11-18.md new file mode 100644 index 000000000..a205ae188 --- /dev/null +++ b/docs/team/reviews/US-514/code-2026-11-18.md @@ -0,0 +1,17 @@ +# Revue code — US-514 « Lieux de prise et de retour » (PR n° 241) — 2026-11-18 + +Relecteur : revue-code / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 4b07e4a0d71bac9282a24c4f6710f11f638edc3a..e2eb2e6704816dbd1d5164bf556262a4094985b1 + +Contexte : lu CLAUDE.md, la passation, ADR-168, la migration 0144 en entier, `checkout.service.ts`, `model.ts`, `store.ts`, `errors.ts`, le FAKE, le contrat `checkout.contract.test.ts`, l'intégration `pg-checkout.int.test.ts`, les catalogues i18n, OpenAPI ; CI verte au SHA relu (run 44370790154). Rien exécuté localement. + +| # | Gravité | Constat | +| --- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | **Service correct.** `parseCheckoutDemand` valide la forme seule (UUID, `null` ou absent ; autre type ⇒ 400 `REQUEST_INVALID`) et normalise en minuscules ; le service n'appelle la base que si un lieu est présent (`checkout.service.ts` ~l.267-277), mappe `AUTH_REQUIRED` et `QUOTE_NOT_FOUND` vers `QuoteHttpError` (401, 404) et `ONE_WAY_NOT_ALLOWED` vers 422 avant toute pose ; panne de la base ⇒ 503 via `#safe`. | +| 2 | INFO | **Store fail-closed.** Une issue inconnue de la base (déploiement en cours) lève `CheckoutStoreError` (503) au lieu de laisser passer ; l'ensemble `RETURN_PLACE` est dérivé de la liste d'issues typée (`store.ts`). | +| 3 | INFO | **SQL.** Les deux remplacements ne portent que le bloc de la fenêtre : `jsonb_typeof = 'number'` et regex `^[1-9][0-9]{0,2}$` avant le cast (aucune erreur de cast possible), ligne en vigueur la plus récente (`ORDER BY valid_from DESC LIMIT 1`), comparaison inclusive, horloge `platform.now()` lue une fois. `LEFT JOIN LATERAL ... ON true` : sans paramètre, `rw.span` est NULL donc adresse NULL (fail-closed) et aucune ligne perdue. | +| 4 | MINEUR | **Commentaire de tête de `errors.ts`** : la ligne ajoutée (US-514) a été collée à la fin de la ligne KYC sans renvoi, d'où une ligne très longue et un paragraphe peu lisible (`errors.ts` l.17-21). Sans effet ; à recouper à la prochaine passe. | +| 5 | MINEUR | **Même source de pays à aligner** (trip vs véhicule), voir revue architecture n° 5. | +| 6 | INFO | **Tests.** Contrat HTTP : absent/null ⇒ aucune lecture ; différent ⇒ 422, corps exact, aucune pose ; identique ⇒ 201 et lieu transmis ; 404 ; trois mauvaises formes ⇒ 400 ; panne ⇒ 503. Intégration réelle (PA et PY) : refus puis hold posé avec le même devis (devis non engagé). | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-514/qa-2026-11-18.md b/docs/team/reviews/US-514/qa-2026-11-18.md new file mode 100644 index 000000000..578ba2373 --- /dev/null +++ b/docs/team/reviews/US-514/qa-2026-11-18.md @@ -0,0 +1,17 @@ +# Revue qa — US-514 « Lieux de prise et de retour » (PR n° 241) — 2026-11-18 + +Relecteur : revue-qa / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 4b07e4a0d71bac9282a24c4f6710f11f638edc3a..e2eb2e6704816dbd1d5164bf556262a4094985b1 + +Contexte : lu les critères de US-514 (19), BKG-016 (16), la passation, le L0 `l0-us514-meeting-place` (8 tests : 3 par pays, PA et PY, plus 2 de droits), la fixture 9939, le contrat HTTP, l'intégration `pg-checkout.int.test.ts` ; CI verte au SHA relu (run 44370790154, job base de données : test:int et test:l0). Rien exécuté localement. + +| # | Gravité | Constat | +| --- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | **Les trois critères sont éprouvés, PA (USD) et PY (PYG).** Critère 1 : `DONE` (absent, identique), `ONE_WAY_NOT_ALLOWED` (autre véhicule, lieu inconnu), `QUOTE_NOT_FOUND` (devis d'autrui, inconnu : même réponse), `AUTH_REQUIRED`, une seule colonne `outcome`. Critère 2 : adresse rendue au seul voyageur, fiche publique sans l'adresse, quatre états terminés ou annulés ⇒ retirée. Critère 3 : six états × (dans la fenêtre, hors fenêtre) ⇒ fiche et détail, libellé et ville conservés, paramètre fermé ⇒ jamais rendue. | +| 2 | INFO | **Règles de test respectées.** Rôle de production (`withRole`, `connectAs`, assertion L0-05), transactions annulées, instants virtuels (session rouverte à l'instant lu), attendus tirés de 19, 16 et 08 (fenêtre de 10 jours), non du code. Droits : aucun rôle applicatif ni propriétaire n'a UPDATE sur les 7 colonnes d'un lieu ni sur `home_location_id` (`has_column_privilege`) ; `app_worker` et `app_anon` ⇒ 42501. | +| 3 | MINEUR | **Borne non éprouvée au point exact.** La fenêtre est testée à ±1 minute de fin + 10 j ; le sens inclusif (`<=`) à l'instant exact n'est pas figé (`l0-us514-meeting-place.test.ts`, critère 3). À ajouter pour verrouiller la borne. | +| 4 | MINEUR | **Valeur mal formée du paramètre non éprouvée.** Le L0 ferme le paramètre (absent) mais ne pose jamais `10.0`, une chaîne, `0` ou quatre chiffres : le fail-closed de la regex n'est vu que par lecture. Un cas par une fixture qui réécrit la valeur couvrirait la branche. Non bloquant. | +| 5 | INFO | **Aucune régression.** Les preuves d'US-115, US-204 et US-214 restent vertes en CI (remplacements à signature et colonnes identiques) ; `config-country.test.ts` n'a gagné que les deux politiques attendues, sans rien retirer. | +| 6 | INFO | **Demande (REQUEST) non rejouée ici** : couverte par US-214 (adresse jamais rendue pour une demande, ville seule) et inchangée par le diff (condition `i.kind = 'TRIP'` conservée). | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-514/securite-2026-11-18.md b/docs/team/reviews/US-514/securite-2026-11-18.md new file mode 100644 index 000000000..c6536ae49 --- /dev/null +++ b/docs/team/reviews/US-514/securite-2026-11-18.md @@ -0,0 +1,20 @@ +# Revue securite — US-514 « Lieux de prise et de retour » (PR n° 241) — 2026-11-18 + +Relecteur : revue-securite / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5 ; revue dégradée : famille B indisponible, TECH-007) +Entrées : 4b07e4a0d71bac9282a24c4f6710f11f638edc3a..e2eb2e6704816dbd1d5164bf556262a4094985b1 + +Contexte : lu CLAUDE.md, ADR-168, la passation, la migration 0144 en entier, comparée ligne à ligne aux dernières définitions sur main (`core.catalog_guest_meeting_point` 0106, `core.booking_guest_trips` 0136), la liste blanche RLS-15, `config-country.test.ts` (test de sécurité modifié), le L0, le service et le store, OpenAPI. Chemins protégés `.github/`, `scripts/ci/`, `scripts/team/`, `review-requirements.json` : non touchés (diff vérifié). CI verte au SHA relu (run 44370790154, dont base de données et gitleaks). Rien exécuté localement. + +| # | Gravité | Constat | +| --- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 1 | INFO | **`booking_checkout_return_place` conforme.** `SECURITY DEFINER`, `SET search_path = pg_catalog, pg_temp`, objets qualifiés, aucun SQL dynamique, propriétaire `cmd_hold_owner` NOLOGIN (`GRANT CREATE` retiré en fin de fichier), `REVOKE ALL ... FROM PUBLIC`, EXECUTE `app_api` seul (L0 : 42501 pour `app_worker` et `app_anon`), entrée d'allowlist exacte. Lecture seule : aucune écriture. | +| 2 | INFO | **Identité et oracle.** Voyageur = `iam_session_resolve(empreinte)`, jamais un identifiant reçu ; le devis doit être le sien (`pq.guest_user_id = v_user`), sinon `QUOTE_NOT_FOUND` identique pour devis d'autrui et inconnu (prouvé). La fonction ne rend que `outcome`, jamais un lieu ; le seul renseignement est « ce lieu est-il le lieu de prise de mon propre devis », non devinable (UUID) et sans valeur. API : 404 sans écho, 400 sur mauvaise forme (avant la base), 401 sans session, 422 sans pose du hold. | +| 3 | INFO | **Remplacements à l'identique.** `catalog_guest_meeting_point` : mêmes signature, colonnes, états et jointures ; seuls diffèrent `v_now` et le `CROSS JOIN LATERAL` de la fenêtre dans l'`EXISTS`. `booking_guest_trips` : corps identique à 0136 sauf `v_now`, la condition d'adresse (`v_now <= i.ends_at + rw.span`) et le `LEFT JOIN LATERAL` `rw`. Propriétaire, EXECUTE, `search_path` et volatilité conservés (`CREATE OR REPLACE` sous le propriétaire d'origine). | +| 4 | INFO | **Fail-closed de la borne.** Paramètre absent, fermé, non numérique ou hors `^[1-9][0-9]{0,2}$` (`10.0`, 0, négatif, chaîne, quatre chiffres) ⇒ `span` NULL ⇒ adresse non rendue ; le cast n'est atteint que sur une valeur déjà filtrée. Quel que soit l'état (OVERDUE, UNRETURNED inclus), l'adresse cesse après `scheduled_end + span` : la fuite d'adresse d'un trip non rendu est fermée. Libellé et ville restent rendus (ADR-160). | +| 5 | INFO | **Droits ajoutés, portée exacte.** `SELECT (country_code, scheduled_end)` de `booking_trip` à `catalog_cmd_owner` (deux colonnes non sensibles, derrière la politique `catalog_cmd_guest_read` inchangée) ; deux politiques permissives `FOR SELECT`, une par propriétaire, limitées à `key = 'review_window_days'` (paramètre non sensible), colonnes déjà accordées ; aucune politique existante modifiée. | +| 6 | INFO | **Lieu figé prouvé.** Le L0 interroge `has_column_privilege(..., 'UPDATE')` pour chaque rôle applicatif et propriétaire sur `kind`, `place_label`, `address_line`, `city`, `area_label`, `geo`, `geo_public` et `home_location_id` : aucun droit ; il échoue si une story en ajoute un. | +| 7 | INFO | **Test de sécurité modifié, examiné.** `config-country.test.ts` : ajout de deux entrées attendues (`catalog_cmd_meeting_read`, `cmd_hold_meeting_read`, SELECT, PERMISSIVE) et mention dans le titre ; aucun attendu retiré ni assoupli ; la liste reste exhaustive (une politique de plus non déclarée ferait échouer). | +| 8 | MINEUR | **Source de pays divergente** (trip pour la fiche, véhicule pour la liste) : sans effet de sécurité tant que le pays du trip égale celui de son véhicule ; à aligner (revue architecture n° 5). | +| 9 | INFO | **Horloge, interrupteurs, secrets.** `platform.now()` seul ; aucun interrupteur de mise en service lu ni écrit ; fixture 9939 en `test-migrations` (jamais appliquée hors tests), aucune fixture n'écrit d'interrupteur ; aucun secret ni ajout à `.gitleaksignore`. Aucune donnée personnelle nouvelle (inventaire inchangé, minimisation renforcée). | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-514/ux-2026-11-18.md b/docs/team/reviews/US-514/ux-2026-11-18.md new file mode 100644 index 000000000..99322522c --- /dev/null +++ b/docs/team/reviews/US-514/ux-2026-11-18.md @@ -0,0 +1,16 @@ +# Revue ux — US-514 « Lieux de prise et de retour » (PR n° 241) — 2026-11-18 + +Relecteur : revue-ux / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 4b07e4a0d71bac9282a24c4f6710f11f638edc3a..e2eb2e6704816dbd1d5164bf556262a4094985b1 + +Contexte : lu 10b S03 (« retour au même lieu », `web.listing.meet.sameReturn`), S09 pour l'adresse, §4.3 (catalogue), le texte `common.checkout.oneWayNotAllowed` dans les quatre catalogues et la clé voisine `noticeTooShort` pour le registre. Aucun écran n'est changé (le client web n'envoie pas de lieu de retour) : pas de captures. CI verte au SHA relu (run 44370790154). + +| # | Gravité | Constat | +| --- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | **Aucun écran changé, parité des quatre catalogues.** Une clé ajoutée en es, en, fr et pt-BR (catalogue v83), sans variable ; tutoiement conservé en fr et es, « você » en pt-BR, comme le reste du catalogue. Le message n'est rendu que si un client envoie un lieu de retour différent : aucun parcours de la bêta ne le provoque. | +| 2 | MINEUR | **Le texte énonce la règle mais ne dit ni le refus ni la suite.** « You return the car to the same place you pick it up. » (es : « Devuelves el auto en el mismo lugar donde lo recoges. ») décrit la règle sans dire que la demande est refusée ; la clé voisine `noticeTooShort` donne une action (« Choose a later start time »). Proposition : « The car goes back to the place where you pick it up. Choose that place to continue. » À reprendre quand l'écran du choix du point existera ; non bloquant, aucun écran ne l'affiche. | +| 3 | MINEUR | **pt-BR un peu formel.** « onde o retira » : « onde você o pega » est plus courant au Brésil ; ne change pas le sens. | +| 4 | INFO | **Adresse bornée : pas de nouveau texte requis.** La disparition de l'adresse au-delà de fin + fenêtre donne la même cellule vide que pour un trip terminé (S09 explique déjà l'absence d'adresse hors à venir ou en cours) ; à revérifier quand S09 affichera un trip OVERDUE ou UNRETURNED très ancien. | +| 5 | INFO | **Suites UX déclarées** (choix du point, consignes de rendez-vous, adresse dans les messages) : reportées avec l'écran S03 ; aucune promesse d'interface dans cette story. | + +Verdict : APPROUVÉ