Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions apps/api/openapi/openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand All @@ -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"
]
}
}
Expand Down Expand Up @@ -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"
},
Expand Down
2 changes: 2 additions & 0 deletions apps/api/src/modules/avl/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` (0144).

**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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ class DbError extends Error {

function failingStore(error: unknown): CheckoutStore {
const fail = (): Promise<never> => 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;
Expand Down
11 changes: 11 additions & 0 deletions apps/api/src/modules/avl/internal/checkout/checkout.service.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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),
);
Expand Down
4 changes: 3 additions & 1 deletion apps/api/src/modules/avl/internal/checkout/errors.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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';
Expand Down Expand Up @@ -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' },
Expand Down
14 changes: 12 additions & 2 deletions apps/api/src/modules/avl/internal/checkout/model.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand All @@ -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[] = [];
Expand All @@ -121,5 +130,6 @@ export function parseCheckoutDemand(body: unknown): CheckoutDemand | null {
driverLastName: last,
manualTransmissionConfirmed: manual === true,
acceptedDocuments: documents,
...(isUuid(returnLocation) ? { returnLocationId: returnLocation.toLowerCase() } : {}),
};
}
10 changes: 10 additions & 0 deletions apps/api/src/modules/avl/internal/checkout/pg-checkout.int.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -271,6 +271,16 @@ describe.each(countryCases())(
expect(card).toEqual({ totalMinor: want.total, billableDays: 3 });
expect(created.totalMinor).toBe(want.total);

// US-514 (0144) : 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 })),
Expand Down
39 changes: 39 additions & 0 deletions apps/api/src/modules/avl/internal/checkout/store.ts
Original file line number Diff line number Diff line change
Expand Up @@ -199,11 +199,30 @@ export interface CheckoutResult {
readonly expiresAt: string | null;
}

/** Issues de `core.booking_checkout_return_place` (0144, 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<string>(RETURN_PLACE_OUTCOMES);

export interface CheckoutStore {
/** Annonce LISTED et instant serveur ; `null` : inconnue ou non publiée. */
listing(listingId: string): Promise<CheckoutListing | null>;
/** Devis figé du voyageur ; `null` : inconnu ou d'un autre voyageur. */
quote(proof: Buffer, quoteId: string): Promise<CheckoutQuoteRow | null>;
/**
* 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<ReturnPlaceOutcome>;
/** Contrôles, consentements et pose du hold, en une transaction (base). */
checkout(proof: Buffer, quoteId: string, demand: CheckoutDemand): Promise<CheckoutResult>;
/** Hold de checkout du voyageur ; `null` : inconnu ou d'un autre voyageur. */
Expand All @@ -220,6 +239,7 @@ export class UnavailableCheckoutStore implements CheckoutStore {
Promise.reject(new CheckoutStoreError('magasin du checkout indisponible'));
listing = (): Promise<CheckoutListing | null> => this.#fail();
quote = (): Promise<CheckoutQuoteRow | null> => this.#fail();
returnPlace = (): Promise<ReturnPlaceOutcome> => this.#fail();
checkout = (): Promise<CheckoutResult> => this.#fail();
hold = (): Promise<CheckoutHold | null> => this.#fail();
}
Expand Down Expand Up @@ -394,6 +414,25 @@ export class PgCheckoutStore implements CheckoutStore {
};
}

async returnPlace(
proof: Buffer,
quoteId: string,
returnLocationId: string,
): Promise<ReturnPlaceOutcome> {
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<CheckoutResult> {
const { rows } = await this.db.query(
'SELECT * FROM core.booking_cmd_checkout($1, $2::uuid, $3, $4, $5, $6::jsonb)',
Expand Down
49 changes: 49 additions & 0 deletions apps/api/src/modules/avl/testing/checkout.contract.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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);
Expand Down
14 changes: 14 additions & 0 deletions apps/api/src/modules/avl/testing/fake-checkout-store.ts
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ import type {
CheckoutQuoteRow,
CheckoutResult,
CheckoutStore,
ReturnPlaceOutcome,
} from '../internal/checkout/store.js';

export class FakeQuoteStore implements QuoteStore {
Expand Down Expand Up @@ -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<never> {
return Promise.reject(new Error('base indisponible (FAKE)'));
Expand All @@ -78,6 +82,16 @@ export class FakeCheckoutStore implements CheckoutStore {
});
}

returnPlace(
proof: Buffer,
quoteId: string,
returnLocationId: string,
): Promise<ReturnPlaceOutcome> {
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<CheckoutResult> {
if (this.down) return this.#fail();
this.demands.push({ proof: proof.toString('hex'), quoteId, demand });
Expand Down
6 changes: 6 additions & 0 deletions changelog.d/US-514-lieux.md
Original file line number Diff line number Diff line change
@@ -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)
Loading
Loading