From 8f6b6ee6e748b8593971ea26fcdc0f22d5e512cf Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 18:18:03 -0300 Subject: [PATCH 1/5] feat(US-224): durcissement avant l'ouverture d'un pays (N-354, N-342, N-313) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CANCEL_HOST_TRIPS : seul un hôte suspendu pour la sûreté (TS_HOLD, POLICY_VIOLATION, KYC_REVOKED) voit ses trips à venir annulés ; restriction d'argent seule refusée (N-354) - reçu d'un trip : hôte jugé comme pour le relevé (titulaire au rôle P2P_HOST ACTIVE) ; co-hôte et adhésion retirée => NOT_FOUND (N-342) - classe de valeur : écritures d'une saisie libre reconnues (« G 500 », « LandCruiser », « MercedesBenz »), graine complétée, ADR-159 corrigé (N-313) - migration 0146, fixture 9935, ADR-171, L0 en PA/USD et PY/PYG Agent-Role: back-end Agent-Model: claude-opus-5-5 Co-Authored-By: Claude Opus 5.5 --- apps/api/src/modules/avl/README.md | 2 +- apps/api/src/modules/cat/README.md | 2 +- apps/api/src/modules/sup/README.md | 2 +- changelog.d/US-224-durcissement.md | 14 + ...R-159-classe-de-valeur-a-la-publication.md | 4 +- .../ADR-171-durcissement-avant-ouverture.md | 32 ++ docs/team/COMME_TURO.md | 1 + docs/team/handoffs/US-224.md | 53 +++ packages/db/README.md | 9 + .../0146_hardening_country_open.sql | 321 ++++++++++++++++++ .../9935_test_hardening_fixtures.sql | 61 ++++ .../db/test/l0/l0-n83-value-class.test.ts | 17 + .../db/test/l0/l0-us217-host-receipt.test.ts | 15 + .../test/l0/l0-us224e-defaulted-host.test.ts | 51 ++- 14 files changed, 577 insertions(+), 7 deletions(-) create mode 100644 changelog.d/US-224-durcissement.md create mode 100644 docs/adr/ADR-171-durcissement-avant-ouverture.md create mode 100644 packages/db/migrations/0146_hardening_country_open.sql create mode 100644 packages/db/test-migrations/9935_test_hardening_fixtures.sql diff --git a/apps/api/src/modules/avl/README.md b/apps/api/src/modules/avl/README.md index 34ea9507..67b87a72 100644 --- a/apps/api/src/modules/avl/README.md +++ b/apps/api/src/modules/avl/README.md @@ -20,7 +20,7 @@ AVL ne calcule ni prix (PRC) ni règlement (STL), et n'appelle jamais le PSP lui - US-207 : machine à états du trip (SM-1) en base : table des transitions, commandes `core.booking_cmd_trip_transition` et `core.booking_cmd_trip_cancel` (travailleur `trip_lifecycle`), journal d'état, segment et conducteur principal, `trip.status_changed` et `trip.cancellation.qualified` (migration 0099, ADR-126). Les routes du voyageur, de l'hôte et de l'ops et le règlement dans la même transaction arrivent avec US-215 / US-224 ; - US-208 : checkout en une page, partie back-end (migrations 0107, 0108, ADR-133) : devis figé avec durée de validité, commande `core.booking_cmd_checkout` (devis, annonce immédiate, boîte manuelle, conducteur titulaire, documents acceptés, pose du hold par `core.booking_cmd_place_hold`), rattachement `booking_checkout_acceptance` / `booking_checkout_terms` ; aucun paiement (US-223) ; - US-209 (209b, migration 0119, ADR-141) : décision de l'ops sur une réservation signalée, commande `core.booking_manual_action_review_flagged` liée à `REVIEW_FLAGGED_BOOKING` (cadre d'US-101, appelée par la console) : APPROVED ⇒ `reviewed_at` et UNE prolongation `reviewed_at + LEAST(hold_ttl_minutes, hold_max_total_minutes)` (hold et occupation), puis paiement par le chemin d'US-223a ; REJECTED ⇒ `RELEASED` / `REVIEW_REJECTED`, occupation libérée ; aucun débit. Hold de revue échu jamais revu ⇒ `RELEASED` / `REVIEW_REJECTED` (déclencheur `hold_review_lapse`, quel que soit l'écrivain), élément de file d'un hold sorti sans décision clos `CANCELLED` (déclencheur `hold_review_item_close`). Branche `PAY_THEN_REVIEW` : refus d'un trip payé ⇒ `CANCELLATION_UNAVAILABLE` (US-224). Événement `booking.hold.review_decided`. -- US-217 (217a, migration 0137, ADR-161) : `GET /trips/{tripId}/receipt` (`TripReceiptController`, `SessionGuard` puis `TermsGuard`, sans cache) : reçu du trip lu par sa partie (`core.booking_trip_receipt`) : titulaire du compte d'hôte ⇒ gains du trip (jambe HOST de la version en tête du règlement ou de la capture, plan et part figés, frais retenus par Kmino, pénalité du `host_ledger` en ligne séparée, net) ; voyageur ⇒ total payé, remboursé, trip fee et sa taxe de ligne, facture hors plateforme ; autre personne, trip inconnu ou mal formé ⇒ 404 `RECEIPT_NOT_FOUND` ; sans capture ni règlement ⇒ 409 `RECEIPT_NOT_READY` ; forme inattendue ⇒ 503 `RECEIPT_UNAVAILABLE`. `GET /host/accounts/{orgId}/earnings/{month}` (`HostEarningsController`) : relevé du mois d'un compte titulaire (`core.booking_host_earnings`) par devise ; 400 `REQUEST_INVALID`, 404 `EARNINGS_NOT_FOUND`, 503 `EARNINGS_UNAVAILABLE`. Montants en texte (signés pour les ajustements et le net), jamais recalculés ; clés exactes contrôlées ; +- US-217 (217a, migration 0137, ADR-161) : `GET /trips/{tripId}/receipt` (`TripReceiptController`, `SessionGuard` puis `TermsGuard`, sans cache) : reçu du trip lu par sa partie (`core.booking_trip_receipt`) : titulaire du compte d'hôte au rôle `P2P_HOST` `ACTIVE` (comme le relevé ; co-hôte ou adhésion retirée ⇒ 404, depuis 0146, N-342, ADR-171) ⇒ gains du trip (jambe HOST de la version en tête du règlement ou de la capture, plan et part figés, frais retenus par Kmino, pénalité du `host_ledger` en ligne séparée, net) ; voyageur ⇒ total payé, remboursé, trip fee et sa taxe de ligne, facture hors plateforme ; autre personne, trip inconnu ou mal formé ⇒ 404 `RECEIPT_NOT_FOUND` ; sans capture ni règlement ⇒ 409 `RECEIPT_NOT_READY` ; forme inattendue ⇒ 503 `RECEIPT_UNAVAILABLE`. `GET /host/accounts/{orgId}/earnings/{month}` (`HostEarningsController`) : relevé du mois d'un compte titulaire (`core.booking_host_earnings`) par devise ; 400 `REQUEST_INVALID`, 404 `EARNINGS_NOT_FOUND`, 503 `EARNINGS_UNAVAILABLE`. Montants en texte (signés pour les ajustements et le net), jamais recalculés ; clés exactes contrôlées ; - US-217 (217b, migration 0145, ADR-167) : reçu du voyageur sans taxe du trip fee dès qu'une part du trip fee est remboursée, et 409 `RECEIPT_NOT_READY` sans règlement ni capture même avec un devis (comme l'hôte) ; `refundMinor` documenté comme le remboursement **dû** au règlement (l'émis se lit sur `/trips/{tripId}/refunds`) ; relevé : `earnedMinor` (acquis) et `pendingMinor` (à venir) contrôlés comme les autres clés (forme inattendue ⇒ 503). - US-224 (224d, migration 0130, ADR-154) : `GET /trips/{tripId}/refunds` (`TripRefundsController`, `SessionGuard` puis `TermsGuard`, sans cache) : remboursement du trip lu par sa partie (`core.booking_trip_refunds`) : voyageur ⇒ état SM-8, montant remboursé, rail, dates de planification et d'émission ; titulaire du compte d'hôte ⇒ la seule part de la jambe HOST ; toute autre personne, trip inconnu ou identifiant mal formé ⇒ 404 `REFUND_NOT_FOUND` (même réponse) ; forme inattendue ou base indisponible ⇒ 503 `REFUNDS_UNAVAILABLE`. Montants en texte, jamais recalculés ; exposant de la devise et fuseau du trip pour l'affichage ; - US-214 (migration 0136, ADR-160) : `GET /trips` et `GET /trips/{tripId}` (`GuestTripsController`, `SessionGuard` puis `TermsGuard`, sans cache) : « Mis viajes » et détail du trip du voyageur de la SESSION (`core.booking_guest_trips`, `PgGuestTripStore`) : trips (onglets UPCOMING, IN_PROGRESS, DONE, CANCELLED) et demandes en attente de l'hôte (REQUESTED) ; auto sans plaque, hôte en prénom et initiale, adresse d'un trip à venir ou en cours seulement, total du devis figé relu (jamais recalculé) avec l'exposant de la devise, état du contrat. Trip d'une autre personne (y compris un trip hébergé par la session), inconnu ou identifiant mal formé ⇒ 404 `TRIP_NOT_FOUND` (même réponse) ; forme inattendue de la base ⇒ 503 `TRIPS_UNAVAILABLE` (fail-closed). Contrat : `avl/testing/guest-trips.contract.test.ts` ; preuve base : `l0-us214-guest-trips`. diff --git a/apps/api/src/modules/cat/README.md b/apps/api/src/modules/cat/README.md index 9c9c868d..75cc5e7a 100644 --- a/apps/api/src/modules/cat/README.md +++ b/apps/api/src/modules/cat/README.md @@ -63,7 +63,7 @@ Modifier la graine : éditer les données, puis `RUEDA_WRITE_CATALOG_SEED=1 pnpm **Import de la douane (ADR-109, PROPOSÉ)**. La douane ne donne aucune caractéristique technique : un modèle importé n'a ni carrosserie, ni places, ni portes, et sa variante ni boîte, ni carburant, ni transmission (« fiche à compléter par l'ops »). Rien n'est deviné : `prefill` rend ces champs à `null` avec `specsComplete: false`, l'hôte les saisit (le véhicule les exige), et la console de l'ops affiche « fiche à compléter » (`backoffice.catalog.specsPending`, catalogue i18n v27). Depuis 0095 (N-101, ADR-123), les variantes de la douane sont **communes aux deux pays** (`market` nul) : `listMakes` et `listModels` les proposent à tout hôte, au même titre que celles d'origine. La douane ne donne pas de classe de valeur : elle est attribuée à la publication (ci-dessous, N-83). Un modèle de la v1 garde sa fiche ; il ne reçoit une variante de la douane que pour des années antérieures à ses variantes. -**Classe de valeur attribuée à la publication (N-83, ADR-159, PROPOSÉ)**. Aucune variante n'a de classe (`STANDARD`, `PREMIUM`, `LUXE`, 08 BR-ACC-05), ni un véhicule hors catalogue ; or une classe inconnue n'est jamais couverte par le contrat de l'assureur (0081). À la publication (`core.catalog_cmd_submit_listing`, migration 0135), un véhicule sans classe reçoit, dans l'ordre : la classe de sa variante (`CATALOG`), sinon celle d'une règle de modèle ou de marque (`MODEL_RULE`, `MAKE_RULE`, table `core.catalog_value_class_rule` : marques et modèles de valeur haute en `PREMIUM` ou `LUXE`, jamais en `STANDARD`), sinon le défaut du pays `vehicle_default_value_class` (`COUNTRY_DEFAULT`, STANDARD PROPOSÉ, migration générée 0134) ; absent : aucune classe, jamais couvert. Provenance et règle sont gardées sur le véhicule (`value_class_source`, `value_class_rule_id`) ; une classe posée n'est jamais recalculée, sauf au rattachement par l'ops d'un véhicule déjà classé (déclencheur `catalog_vehicle_value_class_follow`). Valeurs à confirmer avec l'assureur (`POUR_LE_FONDATEUR.md` §3). Suites : valeur déclarée par l'hôte, révision par l'ops depuis la console. +**Classe de valeur attribuée à la publication (N-83, ADR-159, PROPOSÉ)**. Aucune variante n'a de classe (`STANDARD`, `PREMIUM`, `LUXE`, 08 BR-ACC-05), ni un véhicule hors catalogue ; or une classe inconnue n'est jamais couverte par le contrat de l'assureur (0081). À la publication (`core.catalog_cmd_submit_listing`, migration 0135), un véhicule sans classe reçoit, dans l'ordre : la classe de sa variante (`CATALOG`), sinon celle d'une règle de modèle ou de marque (`MODEL_RULE`, `MAKE_RULE`, table `core.catalog_value_class_rule` : marques et modèles de valeur haute en `PREMIUM` ou `LUXE`, jamais en `STANDARD`), sinon le défaut du pays `vehicle_default_value_class` (`COUNTRY_DEFAULT`, STANDARD PROPOSÉ, migration générée 0134) ; absent : aucune classe, jamais couvert. Provenance et règle sont gardées sur le véhicule (`value_class_source`, `value_class_rule_id`) ; une classe posée n'est jamais recalculée, sauf au rattachement par l'ops d'un véhicule déjà classé (déclencheur `catalog_vehicle_value_class_follow`). Depuis 0146 (N-313, ADR-171), les écritures courantes d'une saisie libre sont reconnues (marque sans ses tirets, « MercedesBenz » ; modèle de la règle suivi d'un chiffre ou d'une lettre, « G 500 », « S580 », « LX570 », « 740i » ; « LandCruiser ») et la graine est complétée (GMC Yukon et Sierra, Rivian, Lucid, etc.) ; une marque **absente** de la table suit le défaut du pays. Valeurs à confirmer avec l'assureur (`POUR_LE_FONDATEUR.md` §3). Suites : valeur déclarée par l'hôte, révision par l'ops depuis la console. Depuis US-115, `core.booking_vehicle_party` lit `catalog_vehicle` et son annonce `LISTED` ; occupations, holds et trips portent une clé étrangère `(vehicle_id, org_id, country_code)` vers `catalog_vehicle` (ADR-060, ADR-089, ADR-099). Sans annonce publiée (US-118), aucun hold ni blocage n'est possible en production. diff --git a/apps/api/src/modules/sup/README.md b/apps/api/src/modules/sup/README.md index 5d372696..cd70e361 100644 --- a/apps/api/src/modules/sup/README.md +++ b/apps/api/src/modules/sup/README.md @@ -51,7 +51,7 @@ SUP ne décide pas les règles des autres modules : une action de console appell - `GET /console/cancellations/{id}` : dernière demande `CANCEL_TRIP_*` du trip (action, motif demandé, initiateur, sous-motif, état `PENDING` / `SETTLED` / `FIN_REVIEW` / `FAILED`, code garé, porteur du coût, heures) et son règlement (remboursement du voyageur, pénalité et compensation de l'hôte, variation par jambe, ordres REFUND et leur état ; montants en unités mineures, texte, avec l'exposant de la devise) ; `{ cancellation: null }` sans demande. Commande `core.support_staff_trip_cancellation` : permission `ops.platform_cancel` dans le pays du trip, garde ADR-122 (403 `STAFF_SELF_FORBIDDEN`), trip inconnu ou d'un autre pays 403 `FORBIDDEN`, refus journalisés ; lecture non inscrite au journal des accès (aucune donnée personnelle, PROPOSÉ). - Console O01 (`apps/backoffice/app/console/cancel-view.tsx`) : formulaire propre aux trois annulations (demandeur, motif fermé, confirmation), puis état réel relu jusqu'au règlement. - **US-224e** (ADR-163, migration 0140) : hôte défaillant (08 BR-TRUST-09). - - `CANCEL_HOST_TRIPS` de `POST /console/actions` (sujet = le compte d'hôte, permission `ops.platform_cancel`, aucune saisie) est liée à `core.booking_manual_action_cancel_host_trips` : l'hôte doit d'abord être restreint (`RESTRICT_ACCOUNT`) ; 201 `STAFF_ACTION_DONE` = une demande `CANCEL_TRIP_PLATFORM` / `HOST_ACCOUNT_CLOSED` enregistrée par trip à venir du compte, chacune réglée par le travailleur `trip_lifecycle` (remboursement intégral, aucune pénalité) et lue par `GET /console/cancellations/{id}` ; refus 409 `STAFF_ACTION_REFUSED` (`values.reason` : `HOST_NOT_RESTRICTED`, `NO_TRIP_TO_CANCEL`, `NOT_FOUND`, `SELF_FORBIDDEN`). Bouton de la fiche 360° : suite (écran et textes). + - `CANCEL_HOST_TRIPS` de `POST /console/actions` (sujet = le compte d'hôte, permission `ops.platform_cancel`, aucune saisie) est liée à `core.booking_manual_action_cancel_host_trips` : l'hôte doit d'abord être restreint pour la sûreté (`RESTRICT_ACCOUNT` : `TS_HOLD` ou `POLICY_VIOLATION`, ou `KYC_REVOKED` ; depuis 0146, N-354, ADR-171, une restriction d'argent `UNPAID_BALANCE`, `PAYMENT_PLAN_ACTIVE` ou `CHARGEBACK` ne suffit pas : `HOST_NOT_RESTRICTED`) ; 201 `STAFF_ACTION_DONE` = une demande `CANCEL_TRIP_PLATFORM` / `HOST_ACCOUNT_CLOSED` enregistrée par trip à venir du compte, chacune réglée par le travailleur `trip_lifecycle` (remboursement intégral, aucune pénalité) et lue par `GET /console/cancellations/{id}` ; refus 409 `STAFF_ACTION_REFUSED` (`values.reason` : `HOST_NOT_RESTRICTED`, `NO_TRIP_TO_CANCEL`, `NOT_FOUND`, `SELF_FORBIDDEN`). Bouton de la fiche 360° : suite (écran et textes). - **US-224d** (ADR-154, migration 0130) : `GET /console/refunds/{id}` (identifiant du trip) : remboursements SM-8 du trip pour OPS_AGENT, FINANCE et ADMIN (`ops.platform_cancel` ou `finance.platform_advance` dans le pays du trip, commande `core.support_staff_trip_refunds`) : état, montant, rail, tentative, version du règlement, jambes demandées et de l'ordre envoyé, statut de l'ordre, motif de blocage, alerte FIN, avance, dates de planification et d'émission ; montants en texte avec l'exposant de la devise ; garde ADR-122 (403 `STAFF_SELF_FORBIDDEN`), trip inconnu ou d'un autre pays 403 `FORBIDDEN`, refus journalisés ; lecture non inscrite au journal des accès (aucune donnée personnelle). - À venir : gestes commerciaux (US-533), console à rôles complets (US-534), commandes de domaine d'état liées par leurs stories (US-208, US-124…), mise en file par les commandes productrices (US-114, US-118, US-209), notification de l'ADMIN sur `kyc.host_screening.flagged`. diff --git a/changelog.d/US-224-durcissement.md b/changelog.d/US-224-durcissement.md new file mode 100644 index 00000000..1369febc --- /dev/null +++ b/changelog.d/US-224-durcissement.md @@ -0,0 +1,14 @@ +lot: L2 +module: Console interne + +- Sécurité : l'action de console `CANCEL_HOST_TRIPS` n'annule les trips à venir d'un hôte que s'il est suspendu pour la sûreté (`TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED`) ; une restriction d'argent (`UNPAID_BALANCE`, `PAYMENT_PLAN_ACTIVE`, `CHARGEBACK`) est refusée (`HOST_NOT_RESTRICTED`) (US-224) + +lot: L2 +module: Règlement et finance + +- Sécurité : le reçu d'un trip n'est rendu à l'hôte que s'il est titulaire du compte avec le rôle `P2P_HOST` actif, comme le relevé des gains ; co-hôte ou adhésion retirée ⇒ 404 `RECEIPT_NOT_FOUND` (US-224, suite d'US-217) + +lot: L2 +module: Catalogue et annonces + +- Corrigé : la classe de valeur d'un véhicule saisi hors catalogue reconnaît les écritures courantes (« G 500 », « S580 », « LandCruiser », « MercedesBenz », « 740i ») et les marques et modèles ajoutés (GMC Yukon et Sierra, Rivian, Lucid, etc.) : jamais une classe plus basse que la règle (US-224, suite d'US-113) diff --git a/docs/adr/ADR-159-classe-de-valeur-a-la-publication.md b/docs/adr/ADR-159-classe-de-valeur-a-la-publication.md index 73d104e4..7403e0b6 100644 --- a/docs/adr/ADR-159-classe-de-valeur-a-la-publication.md +++ b/docs/adr/ADR-159-classe-de-valeur-a-la-publication.md @@ -14,7 +14,7 @@ Aucune variante du catalogue n'a de classe de valeur : ni la graine v1 (0063), n 1. `CATALOG` : classe de la variante du catalogue (saisie ou vérifiée par l'ops, par exemple à l'approbation d'une demande d'ajout) ; 2. `MODEL_RULE` puis `MAKE_RULE` : table `core.catalog_value_class_rule` (marque, modèle facultatif, pays facultatif). Les slugs sont ceux du catalogue, sinon la marque et le modèle saisis par l'hôte passés par `core.catalog_slug`. Le modèle se reconnaît au slug exact ou à un préfixe suivi d'un tiret (`land-cruiser` couvre `land-cruiser-300`). La règle la plus précise l'emporte : modèle le plus long, puis règle du pays, puis classe la plus haute ; 3. `COUNTRY_DEFAULT` : paramètre `vehicle_default_value_class[pays]` (ENUM, migration générée 0134), **PROPOSÉ `STANDARD`** au Panama et au Paraguay ; absent ou illisible : aucune classe, le véhicule reste jamais couvert (fail-closed). -2. **Jamais sous-assuré** : les marques et modèles de valeur haute sont relevés par la table, jamais par le défaut. Graine PROPOSÉE (0135, aucun code pays) : marques de luxe ⇒ `LUXE` (Porsche, Ferrari, Lamborghini, Maserati, Bentley, Rolls-Royce, Aston Martin, McLaren, Bugatti, Maybach, Lotus ; « Range Rover » saisi comme marque) ; marques premium ⇒ `PREMIUM` (Mercedes-Benz, BMW, Audi, Lexus, Land Rover, Jaguar, Volvo, Infiniti, Genesis, Cadillac, Lincoln, Acura, Tesla, Alfa Romeo, Mini, DS, Polestar, Hummer, Ram) ; modèles de luxe ⇒ `LUXE` (Range Rover, Defender, Classe G et S, GLS, SL, AMG GT, Série 7, X7, Q8, R8, LX, Land Cruiser, Corvette, GT-R) ; modèles de valeur haute d'une marque généraliste ⇒ `PREMIUM` (Land Cruiser Prado, Tundra, Sequoia, Supra, Alphard, Silverado, Tahoe, Suburban, Camaro, Mustang, F-150, Bronco, Expedition, Grand Cherokee, Wrangler, Patrol, Challenger, Charger, Durango, Ram). Aucune règle ne range un véhicule plus bas que le défaut. Le défaut `STANDARD` vaut pour les marques généralistes : comme Turo, la classe suit la valeur et la plupart des véhicules sont standard ; le moins de limitations possible pour l'hôte et le voyageur. +2. **Jamais sous-assuré, pour les marques et modèles de la table** (corrigé par ADR-171, N-313) : les marques et modèles de valeur haute **listés** sont relevés par la table, jamais par le défaut ; leurs écritures courantes d'une saisie libre (casse, espaces, tirets absents, chiffres collés : « G 500 », « LandCruiser ») sont reconnues depuis 0146. Une marque ou un modèle **absent** de la table suit le défaut du pays : la table se complète par migration revue. Graine PROPOSÉE (0135, aucun code pays) : marques de luxe ⇒ `LUXE` (Porsche, Ferrari, Lamborghini, Maserati, Bentley, Rolls-Royce, Aston Martin, McLaren, Bugatti, Maybach, Lotus ; « Range Rover » saisi comme marque) ; marques premium ⇒ `PREMIUM` (Mercedes-Benz, BMW, Audi, Lexus, Land Rover, Jaguar, Volvo, Infiniti, Genesis, Cadillac, Lincoln, Acura, Tesla, Alfa Romeo, Mini, DS, Polestar, Hummer, Ram) ; modèles de luxe ⇒ `LUXE` (Range Rover, Defender, Classe G et S, GLS, SL, AMG GT, Série 7, X7, Q8, R8, LX, Land Cruiser, Corvette, GT-R) ; modèles de valeur haute d'une marque généraliste ⇒ `PREMIUM` (Land Cruiser Prado, Tundra, Sequoia, Supra, Alphard, Silverado, Tahoe, Suburban, Camaro, Mustang, F-150, Bronco, Expedition, Grand Cherokee, Wrangler, Patrol, Challenger, Charger, Durango, Ram). Aucune règle ne range un véhicule plus bas que le défaut. Le défaut `STANDARD` vaut pour les marques généralistes : comme Turo, la classe suit la valeur et la plupart des véhicules sont standard ; le moins de limitations possible pour l'hôte et le voyageur. 3. **Quand** : à la publication (`core.catalog_cmd_submit_listing`, corps de 0084 recopié, une étape ajoutée), après le contrôle des photos et avant les contrôles automatiques. `core.catalog_vehicle_assign_value_class` pose la classe d'un véhicule **sans classe**, avec sa provenance (`catalog_vehicle.value_class_source`) et la règle appliquée (`value_class_rule_id`) : l'ops voit pourquoi le véhicule a cette classe. Une classe déjà posée n'est jamais recalculée. La classe reste posée si un contrôle suivant refuse la publication (c'est un attribut du véhicule). 4. **Rattachement par l'ops** (US-114, MERGE ou APPROVE) d'un véhicule hors catalogue **déjà classé par cette règle** : le déclencheur `catalog_vehicle_value_class_follow` (`BEFORE UPDATE OF variant_id`, seulement si `value_class_source` est posée) recalcule la classe avec la nouvelle variante : un véhicule publié ne perd jamais sa classe. Un véhicule jamais publié garde le comportement d'US-114 (classe de la variante, souvent nulle), et sera classé à sa publication. 5. **Droits** : fonctions SECURITY INVOKER, propriétaire `migrator`, EXECUTE au seul `catalog_cmd_owner` ; lecture de la table et de la seule clé `vehicle_default_value_class` par `catalog_cmd_owner` ; UPDATE des deux colonnes nouvelles à `catalog_cmd_owner`. Aucun droit applicatif sur la table (matrice d'autorisations : aucune cellule). @@ -22,7 +22,7 @@ Aucune variante du catalogue n'a de classe de valeur : ni la graine v1 (0063), n ## Conséquences -- Une variante de la douane, de la graine v1 ou un véhicule hors catalogue devient publiable dès que le reste est réuni (contrat qui couvre sa classe, interrupteurs, compte, véhicule confirmé). Une marque premium inconnue tombe en classe haute ; un contrat limité à `STANDARD` la refuse (`VEHICLE_NOT_COVERED`) au lieu de la sous-assurer. +- Une variante de la douane, de la graine v1 ou un véhicule hors catalogue devient publiable dès que le reste est réuni (contrat qui couvre sa classe, interrupteurs, compte, véhicule confirmé). Une marque ou un modèle de la table, même écrit librement, tombe en classe haute ; un contrat limité à `STANDARD` le refuse (`VEHICLE_NOT_COVERED`) au lieu de le sous-assurer. Une marque **absente** de la table suit le défaut du pays (corrigé par ADR-171 : cette phrase disait à tort « une marque premium inconnue tombe en classe haute »). - La caution `LUXE`, l'âge minimal par classe et le signal `HIGH_VALUE_CLASS` s'appliquent aux classes attribuées. - Preuves : `packages/db/test/l0/l0-n83-value-class.test.ts` (PA et PY, sous `app_api`, transactions annulées) ; `l0-n101-catalogue-pa.test.ts` adapté (la variante sans fiche n'est plus refusée pour sa classe). - Valeurs à confirmer par le fondateur avec l'assureur (contrat : classes couvertes, barème) : `POUR_LE_FONDATEUR.md` §3. Un changement passe par une nouvelle valeur du paramètre, ou par une migration qui ajoute ou retire (`status = 'RETIRED'`) des règles. diff --git a/docs/adr/ADR-171-durcissement-avant-ouverture.md b/docs/adr/ADR-171-durcissement-avant-ouverture.md new file mode 100644 index 00000000..e6bdfe43 --- /dev/null +++ b/docs/adr/ADR-171-durcissement-avant-ouverture.md @@ -0,0 +1,32 @@ +# ADR-171 — Durcissement avant l'ouverture d'un pays : hôte défaillant, reçu de l'hôte, saisies libres de la classe de valeur + +- **Statut** : PROPOSÉ (US-224, suites N-354, N-342, N-313 ; agent back-end, claude-opus-5-5, 2026-11-18). Revues exigées : celles de `check-story-reviews.mjs` (US-224 : code, architecture, sécurité, argent, ux, qa) ; `SECURITY DEFINER`, rôles et action de masse sur un autre modèle que l'auteur. +- **Complète** : ADR-163 (hôte défaillant, `CANCEL_HOST_TRIPS`), ADR-124 (hôte restreint), ADR-161 (reçus et relevé des gains), ADR-159 (classe de valeur à la publication, corrigé par celui-ci). +- **Sources** : 08 BR-TRUST-09 (hôte défaillant), BR-ACC-05 (classes et seuils PROPOSÉS), BR-COHOST ; revues de #235 (sécurité n° 4, architecture n° 5), de #231 (sécurité n° 4) et de #229 (N-313) ; BOARD N-354, N-342, N-313 ; CLAUDE.md contraintes 3, 7 et 9. Migration 0146. + +## Contexte + +Trois réserves des revues, toutes marquées « avant l'ouverture d'un pays » : + +1. **N-354** : `CANCEL_HOST_TRIPS` (0140) acceptait toute restriction active du titulaire, y compris une restriction d'argent (`UNPAID_BALANCE`, `PAYMENT_PLAN_ACTIVE`, `CHARGEBACK`). Le recouvrement d'une avance de Kmino (US-709) pourra poser une telle restriction : un seul agent pouvait alors annuler tous les trips à venir d'un hôte qui doit seulement de l'argent. +2. **N-342** : `core.booking_trip_receipt` (0137) jugeait l'hôte sur `holder_user_id` seul, alors que le relevé des gains exige le rôle `P2P_HOST` `ACTIVE` (`core.iam_host_accounts`). +3. **N-313** : la règle « jamais sous-assuré » d'ADR-159 ne valait que pour les slugs exacts de la table : « G 500 », « S 580 » donnaient `PREMIUM` (règle de la marque) au lieu de `LUXE` ; « LandCruiser », GMC (Yukon, Sierra) et des marques premium absentes donnaient le défaut du pays (`STANDARD`). + +## Décision + +1. **Hôte défaillant = suspendu pour la sûreté.** `CANCEL_HOST_TRIPS` exige une restriction active du titulaire d'un des genres `TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED` ; sinon `HOST_NOT_RESTRICTED`, rien n'est écrit. Une restriction d'argent bloque toujours les nouvelles réservations (ADR-124, inchangé). Liste fermée, la même pour tous les pays. Comme Turo : la plateforme annule les trips d'un hôte désactivé pour la confiance et la sûreté, pas pour une dette, qui se recouvre sur ses versements (`host_ledger`). La validation à deux personnes (`requires_approval`) n'est pas retenue : le cadre d'US-101 la réserve aux demandes FINANCE ; la restriction de sûreté est elle-même posée par une action de console journalisée (`RESTRICT_ACCOUNT`, permission `ops.restrict_account`, genres `TS_HOLD` et `POLICY_VIOLATION`) ou par la révocation KYC, ce qui fait deux actions distinctes et journalisées avant l'annulation (le même agent peut les porter s'il a les deux permissions : une validation à deux personnes reste une suite possible, inscrite au BOARD). +2. **Reçu de l'hôte = relevé de l'hôte.** Le reçu d'un trip est rendu à l'hôte seulement s'il est titulaire du compte avec le rôle `P2P_HOST` `ACTIVE` (`core.iam_host_accounts`), comme le relevé. Un titulaire dont l'adhésion est retirée, ou un co-hôte (`CO_HOST`), reçoit `NOT_FOUND`, la même réponse qu'un tiers. Co-hôtes : refusés (fail-closed) tant qu'aucune permission de co-hôte ne porte la lecture des gains (BR-COHOST). +3. **Saisies libres de la classe de valeur.** `core.catalog_value_class_resolve` compare la marque sans ses tirets (« MercedesBenz » = « mercedes-benz », « LandRover » = « land-rover ») et reconnaît le modèle d'une règle au début du modèle saisi, tirets facultatifs (« landcruiser » = « land-cruiser »), suivi de la fin, d'un tiret, d'un chiffre si la règle finit par une lettre (« g » ⇒ « g500 », « lx » ⇒ « lx570 ») ou d'une lettre si elle finit par un chiffre (« 740 » ⇒ « 740i »). La règle la plus précise l'emporte (modèle le plus long sans ses tirets, puis règle du pays, puis la classe la plus haute). Graine PROPOSÉE complétée, sans code pays : + - marques de luxe : Karma, Koenigsegg, Lucid, Pagani, Rimac ; + - marques premium : Alpina, Alpine, Denza, Hongqi, Ineos, Morgan, Rivian, Voyah, Zeekr ; + - modèles `LUXE` : BMW Série 7 (« 7 Series », « Series 7 », 740, 750, 760, i7), Cadillac Escalade, GMC Hummer, Infiniti QX80, Lincoln Navigator ; Mercedes (écritures « Mercedes », « Mercedes-AMG », « Mercedes-Benz ») : AMG GT, Classe G et S (« G », « S », « Clase G / S », « Classe G / S », « G-Class », « S-Class »), GLS, SL ; + - modèles `PREMIUM` : GMC Sierra et Yukon, Nissan Armada, Toyota Prado. + + Une marque ou un modèle absent de la table suit le défaut du pays : « jamais sous-assuré » vaut pour la table et ses écritures, pas pour une marque inconnue. La table se complète par migration revue (valeurs définitives selon le contrat de l'assureur, POUR_LE_FONDATEUR.md §3). Une classe déjà posée n'est jamais recalculée. + +## Conséquences + +- Aucun texte, aucune route ni aucun code d'erreur nouveau : `HOST_NOT_RESTRICTED` et `NOT_FOUND` / `RECEIPT_NOT_FOUND` existaient. +- `cmd_hold_owner` lit en plus la colonne `kind` de `core.iam_restriction` (liste fermée, non personnelle). +- Une saisie libre peut être classée plus haut qu'avant (jamais plus bas) ; un contrat d'assureur limité à `STANDARD` refuse alors le véhicule (`VEHICLE_NOT_COVERED`) au lieu de le sous-assurer. +- Preuves L0 sous `app_api` / `app_worker` (L0-05), en PA / USD et PY / PYG : `l0-us224e-defaulted-host` (genres d'argent refusés, genres de sûreté acceptés), `l0-us217-host-receipt` (co-hôte et adhésion retirée ⇒ `NOT_FOUND`), `l0-n83-value-class` (écritures « G 500 », « S580 », « LandCruiser », « MercedesBenz », GMC, Rivian, 740i, LX570 ; « GLA 200 » et « Golf » sans débordement). Fixture 9935. diff --git a/docs/team/COMME_TURO.md b/docs/team/COMME_TURO.md index 3c5f8560..ebeafc57 100644 --- a/docs/team/COMME_TURO.md +++ b/docs/team/COMME_TURO.md @@ -11,6 +11,7 @@ Règles : | Date | Story | Question | Solution de Turo | Source | Adaptation Kmino | Statut | | ---------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | +| 2026-11-18 | US-224 (N-354) | Quel hôte peut voir tous ses trips à venir annulés par la plateforme : toute personne restreinte, ou seulement l'hôte défaillant ? | la plateforme désactive un hôte pour la confiance et la sûreté et annule alors ses réservations ; une dette se recouvre sur les versements, sans annuler les trips | 08 BR-TRUST-09 ; ADR-124 | `CANCEL_HOST_TRIPS` exige une restriction de sûreté (`TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED`) ; une restriction d'argent seule est refusée (`HOST_NOT_RESTRICTED`) ; ADR-171 | PROPOSÉ | | 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É | diff --git a/docs/team/handoffs/US-224.md b/docs/team/handoffs/US-224.md index e1f7c6d0..9f3782fc 100644 --- a/docs/team/handoffs/US-224.md +++ b/docs/team/handoffs/US-224.md @@ -409,3 +409,56 @@ Export des oracles : TJ16a / TJ16b (USD), TJ16c / TJ16d (PYG), TJ15a à TJ15d, T ## Prochaine commande exacte `gh pr checks --repo Noamgitpty/rueda` (le job « base de données » fait foi pour `schema.md` et les preuves L0) ; après chaque fusion de main : renuméroter 0141. + +--- + +# Durcissement avant l'ouverture d'un pays (suites N-354, N-342, N-313) + +Agent de story (back-end), claude-opus-5-5. Branche `story/US-224-durcissement`, partie d'`origin/main` (`f91ef0fc`), worktree `../wt/HARD-1`. Décision : **ADR-171** (PROPOSÉ ; ADR-159 corrigé). Identifiant de story : US-224 (inscrit au registre des revues ; ses rôles couvrent ceux d'US-113 et d'US-217, dont relèvent N-313 et N-342) ; aucun identifiant nouveau. + +## Périmètre + +- **N-354** : `CANCEL_HOST_TRIPS` n'annule que pour un hôte suspendu pour la sûreté (`TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED`) ; restriction d'argent seule ⇒ `HOST_NOT_RESTRICTED`, rien d'écrit. Validation à deux personnes non retenue (cadre d'US-101 : `requires_approval` réservé aux demandes FINANCE) : suite possible. +- **N-342** : reçu de l'hôte jugé par `core.iam_host_accounts` (titulaire au rôle `P2P_HOST` `ACTIVE`, comme le relevé) ; co-hôte et adhésion retirée ⇒ `NOT_FOUND` (fail-closed tant qu'aucune permission de co-hôte ne porte les gains). +- **N-313** : écritures d'une saisie libre reconnues par `core.catalog_value_class_resolve` (marque sans tirets ; modèle de la règle suivi d'un chiffre ou d'une lettre ; tirets facultatifs) ; graine complétée ; phrase d'ADR-159 corrigée (une marque absente de la table suit le défaut du pays). + +## Numéros + +Migration **0146** (`0146_hardening_country_open.sql`, suite contiguë de main au premier push ; #242, #244 et #246 prennent aussi 0146 : renuméroter à chaque fusion de main — fichier, en-tête, README db, ADR-171, cette passation, `schema.md`). **ADR-171** (169 : US-701, 170 : US-221b). Fixture **9935** (libre sur main et dans les PR ouvertes : 9936, 9937, 9938, 9945 prises). Aucun texte ⇒ aucun catalogue. + +## Fait + +- Migration 0146 : trois corps remplacés (0140, 0137, 0135) à signature, propriétaire et droits identiques ; `GRANT SELECT (kind) ON core.iam_restriction TO cmd_hold_owner` ; règles ajoutées à `core.catalog_value_class_rule` (`source_ref` « N-313 »). +- Fixture 9935 : `hard_restrict`, `hard_membership_status`, `hard_add_cohost` (EXECUTE app_api). +- Docs : ADR-171, ADR-159 (deux phrases corrigées), README db / SUP / AVL / CAT, `changelog.d/US-224-durcissement.md`, `COMME_TURO.md` (1 entrée), `schema.md` (recopié du job « base de données »). + +## Valeurs attendues + +Aucun montant nouveau. Classes : 08 BR-ACC-05 (seuils PROPOSÉS) et la graine d'ADR-171 ; genres de restriction : ADR-171. + +## Tests existants modifiés (à examiner un par un par la revue sécurité) + +- `packages/db/test/l0/l0-us224e-defaulted-host.test.ts` : en-tête complété ; dans le parcours principal, AJOUT (entre le refus « non suspendu » et la restriction `TS_HOLD`) de trois restrictions d'argent successives, chacune suivie d'un refus `HOST_NOT_RESTRICTED` sans écriture ; test AJOUTÉ (`POLICY_VIOLATION`, `KYC_REVOKED` ⇒ `DONE`, une demande `HOST_ACCOUNT_CLOSED`). Aucune assertion retirée ni affaiblie. +- `packages/db/test/l0/l0-us217-host-receipt.test.ts` : en-tête complété ; dans le test des critères 1 et 2, AJOUT (même transaction annulée, après les `NOT_FOUND` existants) : co-hôte ACTIVE ⇒ `NOT_FOUND` ; titulaire à l'adhésion `REMOVED` ⇒ `NOT_FOUND` ; voyageur toujours `GUEST`. Aucune assertion retirée. +- `packages/db/test/l0/l0-n83-value-class.test.ts` : en-tête complété ; 13 cas AJOUTÉS à `OFF_CATALOG_CASES` (dont « GLA 200 » ⇒ `PREMIUM` de la marque et « Golf » ⇒ défaut : aucune règle qui déborde). Cas existants inchangés. + +## Décisions PROPOSÉ + +- Genres de défaillance : `TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED` (liste fermée, sans code pays ; comme Turo, `COMME_TURO.md`). +- Co-hôtes : aucune lecture du reçu des gains. +- Graine de la classe de valeur complétée (valeurs à confirmer avec l'assureur, POUR_LE_FONDATEUR.md §3, inchangé). + +## Suites (à inscrire au BOARD) + +- `CANCEL_HOST_TRIPS` à deux personnes (validation d'un second agent hors du cadre FINANCE) si la revue sécurité l'exige. +- Permission de co-hôte pour les gains (BR-COHOST) : lecture du reçu et du relevé par un co-hôte autorisé. +- Curation des règles de classe par l'ops sans migration (déjà suite d'ADR-159). + +## Pièges + +- `rtrim(…, '-?')` retire les caractères `-` et `?` de la fin du motif : sûr, un slug finit toujours par `[a-z0-9]`. +- L'ordre des règles compare la longueur du modèle SANS ses tirets ; à égalité, la marque écrite exactement l'emporte, puis le slug et l'identifiant (ordre total). + +## Prochaine commande exacte + +`gh pr checks --repo Noamgitpty/rueda` (le job « base de données » fait foi pour `schema.md` et les preuves L0) ; après chaque fusion de main : renuméroter 0146. diff --git a/packages/db/README.md b/packages/db/README.md index 29dd454a..61c33fd8 100644 --- a/packages/db/README.md +++ b/packages/db/README.md @@ -1062,3 +1062,12 @@ Migration `0144_booking_meeting_place`. Fixture `9939_test_us514_meeting_place_f - **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). + +## Durcissement avant l'ouverture d'un pays (US-224 ; suites N-354, N-342, N-313 ; ADR-171) + +Migration `0146_hardening_country_open`. Fixture `9935_test_hardening_fixtures` (restriction d'un genre donné, statut de l'adhésion du titulaire, co-hôte ACTIVE ; transactions de test). + +- **N-354** : corps de `core.booking_manual_action_cancel_host_trips` (0140) remplacé : `CANCEL_HOST_TRIPS` exige une restriction active de sûreté du titulaire (`TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED`) ; une restriction d'argent seule (`UNPAID_BALANCE`, `PAYMENT_PLAN_ACTIVE`, `CHARGEBACK`) ⇒ `HOST_NOT_RESTRICTED`, rien d'écrit. `GRANT SELECT (kind) ON core.iam_restriction TO cmd_hold_owner` ajouté. +- **N-342** : corps de `core.booking_trip_receipt` (0137) remplacé : l'hôte est jugé par `core.iam_host_accounts` (titulaire au rôle `P2P_HOST` `ACTIVE`, comme `booking_host_earnings`) ; co-hôte ou adhésion retirée ⇒ `NOT_FOUND`. +- **N-313** : corps de `core.catalog_value_class_resolve` (0135) remplacé : marque comparée sans ses tirets, modèle de la règle reconnu au début du modèle saisi (tirets facultatifs, suivi de la fin, d'un tiret, d'un chiffre ou d'une lettre selon la fin de la règle) ; graine `core.catalog_value_class_rule` complétée (`source_ref` « N-313 »). Une classe posée n'est jamais recalculée. +- **Preuves** : `test/l0/l0-us224e-defaulted-host.test.ts`, `test/l0/l0-us217-host-receipt.test.ts`, `test/l0/l0-n83-value-class.test.ts` (PA USD, PY PYG ; rôles de production). diff --git a/packages/db/migrations/0146_hardening_country_open.sql b/packages/db/migrations/0146_hardening_country_open.sql new file mode 100644 index 00000000..3d7f857b --- /dev/null +++ b/packages/db/migrations/0146_hardening_country_open.sql @@ -0,0 +1,321 @@ +-- 0146 — SUP / FIN / CAT : durcissement avant l'ouverture d'un pays (suites des revues : BOARD +-- N-354, N-342, N-313 ; ADR-171, PROPOSÉ). Appliquée sous `migrator`, en une transaction. +-- +-- 1. N-354 (revues sécurité et architecture de #235, US-224e) : `CANCEL_HOST_TRIPS` n'annule les +-- trips à venir d'un hôte que s'il est DÉFAILLANT, c'est-à-dire suspendu par une restriction +-- active d'un genre de sûreté : `TS_HOLD` (confiance et sécurité), `POLICY_VIOLATION`, +-- `KYC_REVOKED`. Une restriction d'argent (`UNPAID_BALANCE`, `PAYMENT_PLAN_ACTIVE`, +-- `CHARGEBACK`) bloque toujours les nouvelles réservations (ADR-124, inchangé) mais ne suffit +-- plus à annuler en masse les trips d'un hôte qui doit seulement une avance à Kmino : issue +-- `HOST_NOT_RESTRICTED`, rien n'est écrit (fail-closed). Liste fermée, sans code pays ; comme +-- Turo (la plateforme annule les trips d'un hôte désactivé pour la sûreté, pas pour une dette). +-- Corps de 0140 recopié, une condition changée ; droit de lecture de `kind` AJOUTÉ à +-- `cmd_hold_owner` (colonne non personnelle, liste fermée). +-- 2. N-342 (revues sécurité de #231, US-217a) : `core.booking_trip_receipt` juge l'hôte comme le +-- relevé des gains (`booking_host_earnings`) : titulaire du compte ET rôle `P2P_HOST` `ACTIVE` +-- (`core.iam_host_accounts`). Un titulaire dont l'adhésion n'est plus active, comme un co-hôte +-- (`CO_HOST`), reçoit `NOT_FOUND`, la même réponse qu'un tiers (aucun oracle). Co-hôtes : refusés +-- tant qu'aucune permission de co-hôte ne porte la lecture des gains (BR-COHOST, PROPOSÉ, +-- fail-closed). Corps de 0137 recopié, le jugement de l'hôte changé. +-- 3. N-313 (revue sécurité de #229, N-83) : classe de valeur des saisies libres. Une marque ou un +-- modèle s'écrit de plusieurs façons (« G 500 », « G500 », « LandCruiser », « Mercedes ») : +-- `core.catalog_value_class_resolve` compare désormais les slugs SANS leurs tirets (« landcruiser » +-- = « land-cruiser ») et reconnaît un modèle suivi d'un chiffre (« g500 », « lx570 ») ou, pour un +-- modèle qui finit par un chiffre, d'une lettre (« 740i ») ; graine complétée (marques et modèles +-- absents, écritures « Mercedes » et « Mercedes-AMG » des modèles de Mercedes-Benz). Les règles +-- ne font toujours que RELEVER une classe ; la règle la plus précise l'emporte (modèle le plus +-- long sans ses tirets, puis règle du pays, puis la classe la plus haute). Une marque ou un modèle +-- absent de la table suit toujours le défaut du pays (ADR-159 corrigé) : la table se complète. +-- Les véhicules déjà classés ne sont pas recalculés (une classe posée ne change jamais). +-- +-- Expand / contract : trois corps remplacés à signature, propriétaire, SECURITY et droits +-- identiques ; un droit de colonne et des règles AJOUTÉS ; rien n'est retiré. L'API N lit les mêmes +-- issues (aucun code nouveau). +-- +-- Retour arrière : +-- réappliquer core.booking_manual_action_cancel_host_trips de 0140 (sous cmd_hold_owner), +-- core.booking_trip_receipt de 0137 (sous cmd_hold_owner), core.catalog_value_class_resolve de +-- 0135 (sous migrator) ; REVOKE SELECT (kind) ON core.iam_restriction FROM cmd_hold_owner ; +-- UPDATE core.catalog_value_class_rule SET status = 'RETIRED' +-- WHERE source_ref LIKE '%N-313%' (jamais supprimées). + +-- 1 et 2. Commandes de cmd_hold_owner --------------------------------------------------------- +GRANT SELECT (kind) ON core.iam_restriction TO cmd_hold_owner; + +GRANT CREATE ON SCHEMA core TO cmd_hold_owner; +SET LOCAL ROLE cmd_hold_owner; + +-- 1. N-354 : seul un hôte suspendu pour la sûreté est « défaillant » (corps de 0140) +CREATE OR REPLACE FUNCTION core.booking_manual_action_cancel_host_trips(p_token_hash bytea, + p_action_id uuid, + p_action_code text, + p_subject_id uuid, + p_input jsonb, + p_reason text, + p_actor uuid, + p_actor_role text) + RETURNS TABLE (outcome text, ref_id uuid, emitted_event_ids uuid[]) + LANGUAGE plpgsql + VOLATILE + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ +#variable_conflict use_column +DECLARE + v_org record; + r record; + v_target text := core.booking_cancellation_target('HOST_ACCOUNT_CLOSED'); + v_n integer := 0; +BEGIN + IF p_action_code IS DISTINCT FROM 'CANCEL_HOST_TRIPS' OR p_action_id IS NULL + OR p_subject_id IS NULL OR p_actor IS NULL OR p_actor_role IS NULL OR p_reason IS NULL + OR p_input IS NULL THEN + RAISE EXCEPTION 'annulation des trips d''un hôte : action invalide' + USING ERRCODE = 'invalid_parameter_value'; + END IF; + + SELECT o.id, o.holder_user_id INTO v_org + FROM core.iam_organization AS o WHERE o.id = p_subject_id; + IF v_org.id IS NULL THEN + RETURN QUERY SELECT 'NOT_FOUND'::text, NULL::uuid, '{}'::uuid[]; + RETURN; + END IF; + -- l'hôte défaillant est d'abord suspendu (08 BR-TRUST-09, ADR-124) par une restriction active + -- d'un genre de SÛRETÉ (N-354, ADR-171) ; une restriction d'argent (dette, plan de paiement, + -- rétrofacturation) ne rend pas l'hôte défaillant : rien n'est annulé (fail-closed) + IF NOT EXISTS (SELECT 1 FROM core.iam_restriction AS x + WHERE x.user_id = v_org.holder_user_id AND x.active + AND x.kind IN ('TS_HOLD', 'POLICY_VIOLATION', 'KYC_REVOKED')) THEN + RETURN QUERY SELECT 'HOST_NOT_RESTRICTED'::text, NULL::uuid, '{}'::uuid[]; + RETURN; + END IF; + -- défense en profondeur (la console a déjà appliqué la garde ADR-122 au compte d'hôte) : l'agent + -- n'annule pas un trip dont il est le voyageur + IF EXISTS (SELECT 1 FROM core.booking_trip AS t + WHERE t.org_id = v_org.id AND t.guest_user_id = p_actor) THEN + RETURN QUERY SELECT 'SELF_FORBIDDEN'::text, NULL::uuid, '{}'::uuid[]; + RETURN; + END IF; + + -- trips à venir : état qui a une sortie CANCEL vers CANCELLED_BY_PLATFORM (paire de SM-1, même + -- règle que CANCEL_TRIP_PLATFORM) ; une demande vivante d'un trip (autre agent, même instant) le + -- laisse à sa demande (ON CONFLICT : index trip_cancellation_live_unique) + FOR r IN + SELECT t.id, t.country_code + FROM core.booking_trip AS t + WHERE t.org_id = v_org.id + AND EXISTS (SELECT 1 FROM core.booking_trip_transition AS tt + WHERE tt.from_status = t.status AND tt.via = 'CANCEL' + AND tt.to_status = v_target) + AND NOT EXISTS (SELECT 1 FROM core.booking_trip_cancellation AS c + WHERE c.trip_id = t.id AND c.status IN ('PENDING', 'SETTLED', 'FIN_REVIEW')) + ORDER BY t.scheduled_start, t.id + LOOP + INSERT INTO core.booking_trip_cancellation + (id, trip_id, country_code, action_code, requested_reason, initiator, sub_reason, + requested_at, requested_by) + VALUES (pg_catalog.md5(p_action_id::text || ':' || r.id::text)::uuid, r.id, r.country_code, + 'CANCEL_TRIP_PLATFORM', 'HOST_ACCOUNT_CLOSED', 'PLATFORM', NULL, platform.now(), p_actor) + ON CONFLICT DO NOTHING; + IF FOUND THEN + v_n := v_n + 1; + END IF; + END LOOP; + IF v_n = 0 THEN + RETURN QUERY SELECT 'NO_TRIP_TO_CANCEL'::text, NULL::uuid, '{}'::uuid[]; + RETURN; + END IF; + RETURN QUERY SELECT 'DONE'::text, p_action_id, '{}'::uuid[]; +END +$fn$; +COMMENT ON FUNCTION core.booking_manual_action_cancel_host_trips(bytea, uuid, text, uuid, jsonb, text, uuid, text) IS + 'Commande liée à CANCEL_HOST_TRIPS (cadre d''US-101) : hôte défaillant suspendu (restriction ' + 'active TS_HOLD, POLICY_VIOLATION ou KYC_REVOKED ; jamais une restriction d''argent, N-354), une ' + 'demande d''annulation PENDING par trip à venir de son compte, motif dérivé HOST_ACCOUNT_CLOSED ' + '(remboursement intégral, 08 BR-TRUST-09, BR-CXL-14), réglée par le travailleur trip_lifecycle ; ' + 'aucun montant. EXECUTE iam_staff_owner. US-224e (ADR-163, ADR-171).'; + +-- 2. N-342 : l'hôte du reçu est jugé comme celui du relevé (corps de 0137) +CREATE OR REPLACE FUNCTION core.booking_trip_receipt(p_token_hash bytea, p_trip_id uuid) + RETURNS TABLE (outcome text, viewer_role text, trip_status text, currency text, timezone text, + receipt jsonb) + LANGUAGE plpgsql + STABLE + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ +#variable_conflict use_column +DECLARE + v_user uuid; + t record; + v_role text; + v_receipt jsonb; +BEGIN + SELECT s.user_id INTO v_user FROM core.iam_session_resolve(p_token_hash) AS s; + SELECT tr.id, tr.status, tr.currency, tr.timezone, tr.guest_user_id, tr.org_id INTO t + FROM core.booking_trip AS tr + WHERE tr.id = p_trip_id; + -- hôte : titulaire du compte avec le rôle P2P_HOST ACTIVE (iam_host_accounts, comme le relevé + -- des gains ; N-342, ADR-171) ; co-hôte, adhésion retirée : refusé (fail-closed) + v_role := CASE WHEN v_user IS NULL OR t.id IS NULL THEN NULL + WHEN v_user = t.guest_user_id THEN 'GUEST' + WHEN EXISTS (SELECT 1 FROM core.iam_host_accounts(p_token_hash) AS a + WHERE a.org_id = t.org_id) THEN 'HOST' END; + IF v_role IS NULL THEN + -- autre personne, trip inconnu, session absente : même réponse (aucun oracle d'existence) + RETURN QUERY SELECT 'NOT_FOUND'::text, NULL::text, NULL::text, NULL::text, NULL::text, + NULL::jsonb; + RETURN; + END IF; + v_receipt := core.finance_trip_receipt_view(t.id, v_role); + IF v_receipt IS NULL THEN + -- trip sans capture ni règlement : aucun montant à montrer (jamais un reçu deviné) + RETURN QUERY SELECT 'NO_RECEIPT'::text, v_role, t.status, t.currency, t.timezone, NULL::jsonb; + RETURN; + END IF; + RETURN QUERY SELECT 'OK'::text, v_role, t.status, t.currency, t.timezone, v_receipt; +END +$fn$; +COMMENT ON FUNCTION core.booking_trip_receipt(bytea, uuid) IS + 'Reçu d''un trip pour sa partie de la session (voyageur : paiement et trip fee ; titulaire du ' + 'compte d''hôte au rôle P2P_HOST ACTIVE : gains du trip) ; NOT_FOUND sinon, NO_RECEIPT sans ' + 'capture ni règlement. SECURITY DEFINER, EXECUTE app_api. US-217 (217a, ADR-161 ; N-342, ADR-171).'; + +RESET ROLE; +REVOKE CREATE ON SCHEMA core FROM cmd_hold_owner; + +-- 3. N-313 : écritures d'une saisie libre (corps de 0135 ; propriétaire migrator, inchangé) ------ +CREATE OR REPLACE FUNCTION core.catalog_value_class_resolve(p_country text, p_variant uuid, + p_make_text text, p_model_text text) + RETURNS TABLE (value_class text, source text, rule_id uuid) + LANGUAGE plpgsql + STABLE + SET search_path = pg_catalog, pg_temp +AS $fn$ +#variable_conflict use_column +DECLARE + v_now timestamptz := platform.now(); + v_class text; + v_make text; + v_model text; + v_rule record; + v_def text; +BEGIN + IF p_country IS NULL THEN + RETURN QUERY SELECT NULL::text, NULL::text, NULL::uuid; + RETURN; + END IF; + -- 1. classe de la variante du catalogue + IF p_variant IS NOT NULL THEN + SELECT v.value_class, m.slug, o.slug INTO v_class, v_make, v_model + FROM core.catalog_vehicle_variant AS v + JOIN core.catalog_vehicle_model AS o ON o.id = v.model_id + JOIN core.catalog_vehicle_make AS m ON m.id = o.make_id + WHERE v.id = p_variant; + IF v_class IS NOT NULL THEN + RETURN QUERY SELECT v_class, 'CATALOG'::text, NULL::uuid; + RETURN; + END IF; + END IF; + -- 2. règle de modèle ou de marque (variante du catalogue, sinon saisie de l'hôte). N-313 : + -- marque comparée sans ses tirets ; modèle de la règle reconnu au début du modèle saisi, ses + -- tirets facultatifs, suivi de la fin, d'un tiret, ou d'un chiffre (règle qui finit par une + -- lettre : « g » ⇒ « g500 ») ou d'une lettre (règle qui finit par un chiffre : « 740 » ⇒ + -- « 740i ») ; les slugs n'ont que [a-z0-9-] : aucun caractère spécial dans le motif + v_make := COALESCE(v_make, core.catalog_slug(p_make_text)); + v_model := COALESCE(v_model, core.catalog_slug(p_model_text)); + IF v_make IS NOT NULL THEN + SELECT r.id, r.value_class, r.model_slug INTO v_rule + FROM core.catalog_value_class_rule AS r + WHERE r.status = 'ACTIVE' + AND pg_catalog.replace(r.make_slug, '-', '') = pg_catalog.replace(v_make, '-', '') + AND (r.country_code IS NULL OR r.country_code = p_country) + AND (r.model_slug IS NULL + OR (v_model IS NOT NULL + AND v_model ~ ('^' + || pg_catalog.rtrim(pg_catalog.regexp_replace( + pg_catalog.replace(r.model_slug, '-', ''), '(.)', '\1-?', 'g'), '-?') + || CASE WHEN r.model_slug ~ '[a-z]$' THEN '(-|$|[0-9])' + ELSE '(-|$|[a-z])' END))) + ORDER BY pg_catalog.char_length(pg_catalog.replace(COALESCE(r.model_slug, ''), '-', '')) DESC, + (r.country_code IS NOT NULL) DESC, + CASE r.value_class WHEN 'LUXE' THEN 3 WHEN 'PREMIUM' THEN 2 ELSE 1 END DESC, + (r.make_slug = v_make) DESC, r.make_slug, r.id + LIMIT 1; + IF v_rule.id IS NOT NULL THEN + RETURN QUERY SELECT v_rule.value_class, + CASE WHEN v_rule.model_slug IS NULL THEN 'MAKE_RULE' + ELSE 'MODEL_RULE' END::text, + v_rule.id; + RETURN; + END IF; + END IF; + -- 3. défaut du pays en vigueur (chaîne de la liste fermée, sinon aucune classe) + SELECT CASE WHEN pg_catalog.jsonb_typeof(pv.value) = 'string' THEN pv.value #>> '{}' END + INTO v_def + FROM core.config_param_value AS pv + WHERE pv.key = 'vehicle_default_value_class' AND pv.country_code::text = p_country + 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; + IF v_def IN ('STANDARD', 'PREMIUM', 'LUXE') THEN + RETURN QUERY SELECT v_def, 'COUNTRY_DEFAULT'::text, NULL::uuid; + RETURN; + END IF; + RETURN QUERY SELECT NULL::text, NULL::text, NULL::uuid; +END +$fn$; +COMMENT ON FUNCTION core.catalog_value_class_resolve(text, uuid, text, text) IS + 'Classe de valeur d''un véhicule : variante du catalogue (CATALOG), règle de modèle ou de marque ' + '(MODEL_RULE, MAKE_RULE ; écritures d''une saisie libre reconnues, N-313), défaut du pays ' + '(COUNTRY_DEFAULT) ; sinon aucune (fail-closed). Lecture seule. EXECUTE catalog_cmd_owner. ' + 'N-83 (ADR-159, ADR-171).'; + +-- Graine complétée (PROPOSÉE, aucun code pays ; 08 BR-ACC-05 : PREMIUM au-delà de 35 000 $, LUXE +-- au-delà de 70 000 $, prix d'un véhicule récent, notoriété publique). Valeurs définitives selon +-- le contrat de l'assureur (POUR_LE_FONDATEUR.md §3). +INSERT INTO core.catalog_value_class_rule (make_slug, model_slug, value_class, source_ref) VALUES + -- marques de luxe absentes + ('karma', NULL, 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque de luxe)'), + ('koenigsegg', NULL, 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque de luxe)'), + ('lucid', NULL, 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque de luxe)'), + ('pagani', NULL, 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque de luxe)'), + ('rimac', NULL, 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque de luxe)'), + -- marques premium absentes + ('alpina', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('alpine', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('denza', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('hongqi', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('ineos', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('morgan', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('rivian', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('voyah', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + ('zeekr', NULL, 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (marque premium)'), + -- modèles de valeur haute absents d'une marque premium ou généraliste + ('bmw', '7-series', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe, saisie libre)'), + ('bmw', '740', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe, saisie libre)'), + ('bmw', '750', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe, saisie libre)'), + ('bmw', '760', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe, saisie libre)'), + ('bmw', 'i7', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe)'), + ('bmw', 'series-7', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe, saisie libre)'), + ('cadillac', 'escalade', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe)'), + ('gmc', 'hummer', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe)'), + ('gmc', 'sierra', 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (pick-up pleine taille)'), + ('gmc', 'yukon', 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle premium)'), + ('infiniti', 'qx80', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe)'), + ('lincoln', 'navigator', 'LUXE', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe)'), + ('nissan', 'armada', 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle premium)'), + ('toyota', 'prado', 'PREMIUM', '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle premium, saisie libre)'); + +-- Écritures « Mercedes », « Mercedes-AMG » et « Mercedes-Benz » : mêmes modèles de luxe, plus les +-- lettres seules de la Classe G et de la Classe S (« G 500 », « S 580 ») et leur nom français. +INSERT INTO core.catalog_value_class_rule (make_slug, model_slug, value_class, source_ref) +SELECT mk.slug, md.slug, 'LUXE', + '08 BR-ACC-05 ; N-313 graine PROPOSÉE (modèle de luxe, saisie libre)' + FROM (VALUES ('mercedes'), ('mercedes-amg'), ('mercedes-benz')) AS mk (slug) + CROSS JOIN (VALUES ('amg-gt'), ('clase-g'), ('clase-s'), ('classe-g'), ('classe-s'), ('g'), + ('g-class'), ('gls'), ('s'), ('s-class'), ('sl')) AS md (slug) + WHERE NOT EXISTS (SELECT 1 FROM core.catalog_value_class_rule AS r + WHERE r.country_code IS NULL AND r.make_slug = mk.slug + AND r.model_slug = md.slug); diff --git a/packages/db/test-migrations/9935_test_hardening_fixtures.sql b/packages/db/test-migrations/9935_test_hardening_fixtures.sql new file mode 100644 index 00000000..648e3b48 --- /dev/null +++ b/packages/db/test-migrations/9935_test_hardening_fixtures.sql @@ -0,0 +1,61 @@ +-- 9935 — Fixtures de TEST du durcissement avant l'ouverture d'un pays (migration 0146, ADR-171 ; +-- BOARD N-354, N-342). Jamais en production (test-migrations/ seulement). SECURITY DEFINER sous +-- migrator (politique migrator_all), search_path figé ; l'appelant reste sous un rôle de +-- production (L0-05), dans une transaction de test. +-- +-- - hard_restrict : restriction active d'un genre donné (liste fermée de la table) sur une +-- personne (titulaire d'un compte d'hôte de la fixture 9300) ; +-- - hard_membership_status : statut de l'adhésion P2P_HOST du titulaire d'un compte d'hôte +-- (adhésion retirée : REMOVED) ; +-- - hard_add_cohost : co-hôte ACTIVE d'un compte d'hôte (personne neuve), rend son identifiant. +-- Les attendus des tests viennent d'ADR-171, d'ADR-163 et d'ADR-161, jamais de ces fixtures. +-- +-- Retour arrière : DROP FUNCTION test_fixture.hard_restrict(uuid, text), +-- test_fixture.hard_membership_status(uuid, text), test_fixture.hard_add_cohost(uuid). + +CREATE FUNCTION test_fixture.hard_restrict(p_user_id uuid, p_kind text) + RETURNS void + LANGUAGE sql + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ + INSERT INTO core.iam_restriction (id, user_id, kind, active, reason) + VALUES (pg_catalog.gen_random_uuid(), p_user_id, p_kind, true, 'test durcissement (N-354)') +$fn$; + +CREATE FUNCTION test_fixture.hard_membership_status(p_org_id uuid, p_status text) + RETURNS void + LANGUAGE sql + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ + UPDATE core.iam_membership AS m + SET status = p_status + FROM core.iam_organization AS o + WHERE o.id = p_org_id AND m.org_id = o.id AND m.user_id = o.holder_user_id + AND m.role = 'P2P_HOST' +$fn$; + +CREATE FUNCTION test_fixture.hard_add_cohost(p_org_id uuid) + RETURNS uuid + LANGUAGE plpgsql + SECURITY DEFINER + SET search_path = pg_catalog, pg_temp +AS $fn$ +DECLARE + v_user uuid := pg_catalog.gen_random_uuid(); +BEGIN + INSERT INTO core.iam_user_account (id, email, legal_first_name, legal_last_name, preferred_locale, + status) + VALUES (v_user, pg_catalog.format('cohost-%s@fixture.test', v_user), 'Fixture', 'Cohost', 'en', + 'ACTIVE'); + INSERT INTO core.iam_membership (id, user_id, org_id, role, status) + VALUES (pg_catalog.gen_random_uuid(), v_user, p_org_id, 'CO_HOST', 'ACTIVE'); + RETURN v_user; +END +$fn$; + +REVOKE ALL ON FUNCTION test_fixture.hard_restrict(uuid, text), + test_fixture.hard_membership_status(uuid, text), test_fixture.hard_add_cohost(uuid) FROM PUBLIC; +GRANT EXECUTE ON FUNCTION test_fixture.hard_restrict(uuid, text), + test_fixture.hard_membership_status(uuid, text), test_fixture.hard_add_cohost(uuid) TO app_api; diff --git a/packages/db/test/l0/l0-n83-value-class.test.ts b/packages/db/test/l0/l0-n83-value-class.test.ts index 9b55a8bf..7059aaa5 100644 --- a/packages/db/test/l0/l0-n83-value-class.test.ts +++ b/packages/db/test/l0/l0-n83-value-class.test.ts @@ -8,6 +8,8 @@ * ouverts par la procédure à deux personnes d'US-125, dans la transaction du test) ; * - marque ou modèle de valeur haute, du catalogue ou saisi hors catalogue ⇒ classe haute, jamais * STANDARD (contrat limité à STANDARD ⇒ VEHICLE_NOT_COVERED : jamais sous-assuré) ; + * - N-313 (migration 0146, ADR-171) : écritures courantes d'une saisie libre (« G 500 », « S580 », + * « LandCruiser », « MercedesBenz »), marques et modèles ajoutés à la graine ; * - aucune régression : un véhicule déjà classé garde sa classe ; une variante générale de la * graine v1 suit le défaut ; un véhicule jamais publié reste sans classe au rattachement ; * - le défaut est un paramètre du pays (autre valeur ⇒ autre classe) ; contrat fermé ⇒ toujours @@ -157,6 +159,21 @@ const OFF_CATALOG_CASES: ReadonlyArray<{ { make: 'Mercedes', model: 'C 200', expected: 'PREMIUM', source: 'MAKE_RULE' }, { make: 'Range Rover', model: 'Velar', expected: 'LUXE', source: 'MAKE_RULE' }, { make: 'Marca Inventada', model: 'Modelo Uno', expected: 'DEFAULT', source: 'COUNTRY_DEFAULT' }, + // N-313 (migration 0146, ADR-171) : écritures d'une saisie libre (espaces, casse, tirets + // absents, chiffres collés), marques et modèles ajoutés ; jamais une règle qui déborde + { make: 'Mercedes-Benz', model: 'G 500', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'MERCEDES', model: 'S580', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'MercedesBenz', model: 'S-Class', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'Mercedes', model: 'GLA 200', expected: 'PREMIUM', source: 'MAKE_RULE' }, + { make: 'Toyota', model: 'LandCruiser 300', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'toyota', model: 'LandCruiser Prado', expected: 'PREMIUM', source: 'MODEL_RULE' }, + { make: 'GMC', model: 'Yukon Denali', expected: 'PREMIUM', source: 'MODEL_RULE' }, + { make: 'GMC', model: 'Sierra 1500', expected: 'PREMIUM', source: 'MODEL_RULE' }, + { make: 'Rivian', model: 'R1S', expected: 'PREMIUM', source: 'MAKE_RULE' }, + { make: 'Lexus', model: 'LX570', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'BMW', model: '740i', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'LandRover', model: 'Defender 110', expected: 'LUXE', source: 'MODEL_RULE' }, + { make: 'Volkswagen', model: 'Golf', expected: 'DEFAULT', source: 'COUNTRY_DEFAULT' }, ]; // ---- aides : hôte, véhicule, annonce, publication ---------------------------------------------- diff --git a/packages/db/test/l0/l0-us217-host-receipt.test.ts b/packages/db/test/l0/l0-us217-host-receipt.test.ts index d11b3d11..9f276c67 100644 --- a/packages/db/test/l0/l0-us217-host-receipt.test.ts +++ b/packages/db/test/l0/l0-us217-host-receipt.test.ts @@ -15,6 +15,8 @@ * `hostFromGuestMinor`, = TJ02a en USD) ; annulation de l'hôte T14 / T48 (jambe HOST 0, pénalité * `hostPenaltyMinor` en ligne séparée, 08 E7 règle 7) ; lignes, taux et taxe payée des trips A et D * (08 BR-PRICE-12 : taxe par ligne, `roundHalfUp` unique). 19 US-217 critères 1 à 3. + * N-342 (migration 0146, ADR-171) : un co-hôte ou un titulaire dont l'adhésion P2P_HOST n'est plus + * ACTIVE lit le reçu comme un tiers (NOT_FOUND), comme pour le relevé. */ import { ratio, roundHalfUp } from '@rueda/money'; import { legVector, settlementVector } from '@rueda/money/golden-vectors'; @@ -390,6 +392,19 @@ describe.each(COUNTRIES)('US-217a — reçu des gains et du trip fee — $countr ] as const) { expect((await tx.query(READ, [hash, trip])).rows).toEqual([notFound]); } + + // N-342 (migration 0146, ADR-171) : l'hôte du reçu est jugé comme celui du relevé + // (titulaire au rôle P2P_HOST ACTIVE) : un co-hôte ACTIVE du compte, puis le titulaire + // dont l'adhésion est retirée (fixture 9935, transaction annulée) ⇒ la réponse d'un tiers + const cohost = ( + await tx.query<{ id: string }>('SELECT test_fixture.hard_add_cohost($1) AS id', [w.org]) + ).rows[0]!.id; + const cohostHash = await session(tx, cohost); + expect((await tx.query(READ, [cohostHash, w.booked])).rows).toEqual([notFound]); + await tx.query('SELECT test_fixture.hard_membership_status($1, $2)', [w.org, 'REMOVED']); + expect((await tx.query(READ, [hostHash, w.booked])).rows).toEqual([notFound]); + // le voyageur n'est pas touché + expect((await receipt(tx, guestHash, w.booked))['viewer_role']).toBe('GUEST'); }); // les vues internes ne sont jamais appelables par app_api diff --git a/packages/db/test/l0/l0-us224e-defaulted-host.test.ts b/packages/db/test/l0/l0-us224e-defaulted-host.test.ts index c9e1ab31..91866013 100644 --- a/packages/db/test/l0/l0-us224e-defaulted-host.test.ts +++ b/packages/db/test/l0/l0-us224e-defaulted-host.test.ts @@ -5,8 +5,10 @@ * table de décision n° 13), en USD (PA) et en PYG sans décimale (PY). * * Parcours : un compte d'hôte a deux trips à venir encaissés (jambes TJ01 / TJ08a) ; l'ops ne peut - * pas annuler ses trips tant qu'il n'est pas suspendu (HOST_NOT_RESTRICTED, rien d'écrit) ; il est - * restreint (restriction active posée par la fixture 9941), puis `CANCEL_HOST_TRIPS` écrit UNE + * pas annuler ses trips tant qu'il n'est pas suspendu (HOST_NOT_RESTRICTED, rien d'écrit), ni + * quand il n'a que des restrictions d'argent (N-354, migration 0146, ADR-171 : UNPAID_BALANCE, + * PAYMENT_PLAN_ACTIVE, CHARGEBACK, fixture 9935) ; il est restreint pour la sûreté (TS_HOLD posée + * par la fixture 9941 ; POLICY_VIOLATION et KYC_REVOKED prouvés à part), puis `CANCEL_HOST_TRIPS` écrit UNE * demande PENDING par trip à venir de ce compte (motif dérivé HOST_ACCOUNT_CLOSED, initiateur * PLATFORM), aucune pour le trip d'un autre hôte ; rejeu ⇒ DUPLICATE ; nouvelle demande ⇒ * NO_TRIP_TO_CANCEL. Chaque demande @@ -64,6 +66,11 @@ const ACTED_AT_MS = Date.UTC(2031, 4, 20, 12, 0, 0); /** Départ des trips : 10 h après l'action (T22 : demande à T−10 h). */ const LEAD_MINUTES = 600; +/** Genres de restriction d'argent : jamais une défaillance (N-354, ADR-171). */ +const MONEY_KINDS = ['UNPAID_BALANCE', 'PAYMENT_PLAN_ACTIVE', 'CHARGEBACK'] as const; +/** Genres de sûreté qui rendent l'hôte défaillant, autres que TS_HOLD (N-354, ADR-171). */ +const SAFETY_KINDS = ['POLICY_VIOLATION', 'KYC_REVOKED'] as const; + interface CaseOf { readonly c: CountryCase; /** Vecteur qui fournit le trip (A de T22, D de T48) ; le motif vient de la base. */ @@ -232,6 +239,18 @@ describe.each(CASES)('critère 5 d’US-224 — hôte défaillant — $c.country }); expect(await cancellationsOf(api, org)).toEqual([]); + // N-354 (ADR-171) : une restriction d'ARGENT (dette, plan de paiement, rétrofacturation) + // bloque les nouvelles réservations mais ne rend pas l'hôte défaillant : toujours refusé, + // rien d'écrit, même avec les trois genres actifs ensemble + for (const kind of MONEY_KINDS) { + await api.query('SELECT test_fixture.hard_restrict($1, $2)', [holder, kind]); + expect(await act(api, k, 'CANCEL_HOST_TRIPS', org, {}), kind).toMatchObject({ + outcome: 'REFUSED', + detail: 'HOST_NOT_RESTRICTED', + }); + expect(await cancellationsOf(api, org)).toEqual([]); + } + // suspendu (ADR-124 : plus aucune nouvelle réservation ; restriction posée par la fixture 9941, // l'action RESTRICT_ACCOUNT est prouvée par l0-us109), puis ses trips à venir annulés await api.query('SELECT test_fixture.us224e_restrict($1)', [holder]); @@ -363,6 +382,34 @@ describe.each(CASES)('critère 5 d’US-224 — hôte défaillant — $c.country }); }); + it.each(SAFETY_KINDS)( + 'N-354 : hôte suspendu pour la sûreté (%s) ⇒ CANCEL_HOST_TRIPS annule son trip à venir (HOST_ACCOUNT_CLOSED)', + async (kind) => { + await withRole('app_api', async (api) => { + await withRole('app_worker', async (worker) => { + const org = uuid(); + const t = await trip(worker, k, org); + const { rows: h } = await api.query<{ id: string }>( + 'SELECT test_fixture.us224e_org_holder($1) AS id', + [org], + ); + const holder = h[0]?.id ?? ''; + expect(holder).not.toBe(''); + await api.query('SELECT test_fixture.hard_restrict($1, $2)', [holder, kind]); + expect((await act(api, k, 'CANCEL_HOST_TRIPS', org, {})).outcome).toBe('DONE'); + const pending = await cancellationsOf(api, org); + expect(pending.map((x) => x.trip_id)).toEqual([t.trip]); + expect(pending[0]).toMatchObject({ + action_code: 'CANCEL_TRIP_PLATFORM', + requested_reason: 'HOST_ACCOUNT_CLOSED', + initiator: 'PLATFORM', + status: 'PENDING', + }); + }); + }); + }, + ); + it('un agent SUPPORT (sans ops.platform_cancel) est refusé ; un compte inconnu n’annule rien', async () => { await withRole('app_api', async (api) => { const support = await createStaff(api, 'SUPPORT_AGENT', [k.c.country], { From 8bb5fb5ce2be37a81d3fa0d4f843934e84bf4f37 Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 18:31:38 -0300 Subject: [PATCH 2/5] =?UTF-8?q?docs(US-224):=20ligne=20vide=20du=20README?= =?UTF-8?q?=20db=20apr=C3=A8s=20la=20r=C3=A9solution=20du=20conflit?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Agent-Role: back-end Agent-Model: claude-opus-5-5 Co-Authored-By: Claude Opus 5.5 --- packages/db/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/db/README.md b/packages/db/README.md index 1b980ed5..8b35b32b 100644 --- a/packages/db/README.md +++ b/packages/db/README.md @@ -1071,6 +1071,7 @@ Migration `0146_payment_deposit_hold`, fixture `9945_test_us701_deposit_hold_fix - **Fonctions** (cmd_hold_owner, RLS-15) : `payment_deposit_checkout(jeton, hold)` et `payment_cmd_record_deposit_decision(jeton, hold, décision)` (EXECUTE `app_api`, voyageur de la session, hold d'un autre ⇒ `HOLD_NOT_FOUND`) ; `payment_deposit_reauth_due(lot)` et `payment_cmd_deposit_transition(…)` (EXECUTE `app_worker`, nom `payment_command`). Revérifications de l'écriture : `deposit_decision_mismatch` (montant ≠ `deposit_amount[pays][classe]`, `NOT_REQUIRED` sur un pays ou une classe déclencheurs, classe inconnue), `deposit_rail_closed` (`CHARGE_THEN_REFUND` tant que `funds_holding_enabled` = faux). - **Droits ajoutés** à cmd_hold_owner : politiques de lecture `cmd_hold_deposit_read` de `config_param_value` (`deposit_always_required`, `deposit_trigger_classes`, `deposit_amount`, `funds_holding_enabled`) et de `config_param_definition` (`funds_holding_enabled`) ; `SELECT (conversion_operation_id)` de `booking_checkout_hold`. - **Preuves** : `test/l0/l0-us701-deposit-hold.test.ts` (PA USD, PY PYG ; `app_api`, `app_worker`). + ## Durcissement avant l'ouverture d'un pays (US-224 ; suites N-354, N-342, N-313 ; ADR-171) Migration `0147_hardening_country_open`. Fixture `9935_test_hardening_fixtures` (restriction d'un genre donné, statut de l'adhésion du titulaire, co-hôte ACTIVE ; transactions de test). From f4020a39f241eb0fc1affd37c76768ba2f175797 Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 18:41:19 -0300 Subject: [PATCH 3/5] =?UTF-8?q?docs(US-224):=20schema.md=20recopi=C3=A9=20?= =?UTF-8?q?de=20la=20sortie=20du=20job=20=C2=AB=20base=20de=20donn=C3=A9es?= =?UTF-8?q?=20=C2=BB=20(migration=200147)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Agent-Role: back-end Agent-Model: claude-opus-5-5 Co-Authored-By: Claude Opus 5.5 --- docs/architecture/schema.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/architecture/schema.md b/docs/architecture/schema.md index fec6f73b..91cc2544 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 -- 147 migrations ; 129 tables ; 3 vues ; 728 politiques RLS ; 294 fonctions `SECURITY DEFINER` ; 253 autres fonctions. +- 148 migrations ; 129 tables ; 3 vues ; 728 politiques RLS ; 294 fonctions `SECURITY DEFINER` ; 253 autres fonctions. - Tables sans RLS `ENABLE` + `FORCE` : aucune. - Rôles applicatifs avec `SUPERUSER` ou `BYPASSRLS` : aucun. @@ -162,6 +162,7 @@ Lu dans le catalogue (`pg_catalog`) d'une base jetable du banc, après les seule | `0144_booking_meeting_place` | AVL / CAT : lieux de prise et de retour (US-514 ; 19 US-514 ; 16 BKG-016 ; 08 BR-BOOK-09 ; | | `0145_finance_receipt_alignment` | FIN : alignement des reçus et du relevé des gains sur les décisions écrites d'US-217 | | `0146_payment_deposit_hold` | PAY : caution de la plateforme figée au checkout (`deposit_hold`), vue du voyageur sans | +| `0147_hardening_country_open` | SUP / FIN / CAT : durcissement avant l'ouverture d'un pays (suites des revues : BOARD | ## Rôles From 6090e0ed9195967000afaaccf16f49ede155769b Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 19:11:19 -0300 Subject: [PATCH 4/5] =?UTF-8?q?docs(US-224):=20revues=20ind=C3=A9pendantes?= =?UTF-8?q?=20de=20la=20PR=20n=C2=B0=20247=20(durcissement=20avant=20ouver?= =?UTF-8?q?ture,=20f4020a39)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Agent-Role: revue-argent Agent-Model: claude-sonnet-5-5 --- .../reviews/US-224/architecture-2026-11-18h.md | 13 +++++++++++++ docs/team/reviews/US-224/argent-2026-11-18h.md | 15 +++++++++++++++ docs/team/reviews/US-224/code-2026-11-18h.md | 14 ++++++++++++++ docs/team/reviews/US-224/qa-2026-11-18h.md | 13 +++++++++++++ docs/team/reviews/US-224/securite-2026-11-18h.md | 16 ++++++++++++++++ docs/team/reviews/US-224/ux-2026-11-18h.md | 12 ++++++++++++ 6 files changed, 83 insertions(+) create mode 100644 docs/team/reviews/US-224/architecture-2026-11-18h.md create mode 100644 docs/team/reviews/US-224/argent-2026-11-18h.md create mode 100644 docs/team/reviews/US-224/code-2026-11-18h.md create mode 100644 docs/team/reviews/US-224/qa-2026-11-18h.md create mode 100644 docs/team/reviews/US-224/securite-2026-11-18h.md create mode 100644 docs/team/reviews/US-224/ux-2026-11-18h.md diff --git a/docs/team/reviews/US-224/architecture-2026-11-18h.md b/docs/team/reviews/US-224/architecture-2026-11-18h.md new file mode 100644 index 00000000..8254b2ff --- /dev/null +++ b/docs/team/reviews/US-224/architecture-2026-11-18h.md @@ -0,0 +1,13 @@ +# Revue architecture — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247) — 2026-11-18 + +Relecteur : revue-architecture / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : eb90f895..f4020a39f241eb0fc1affd37c76768ba2f175797 + +Contexte : lecture de `git diff eb90f895...f4020a39` (migration 0147, fixture 9935, ADR-171, correction d'ADR-159, trois L0, documentation). CI de f4020a39 (run 44404059009) verte, dont « base de données » (test:int, test:l0). Corps recopiés de 0140, 0137 et 0135 comparés au corps de 0147 : seules les conditions annoncées changent. + +| # | Gravité | Constat | +| --- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | ADR-171 PROPOSÉ, complète ADR-163, 124, 161 et corrige ADR-159 (phrase fausse « marque premium inconnue tombe en classe haute » rectifiée explicitement). Expand / contract respecté : rien n'est retiré. | +| 2 | INFO | Cohérence avec CLAUDE.md : `cmd_hold_owner` seul propriétaire des commandes, aucune importation inter-module, aucune constante de pays, `platform.now()`, défaut du pays pour une marque absente. COMME_TURO et BOARD (N-354, N-342, N-313) à jour ; la validation à deux personnes écartée est motivée et notée comme suite possible. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/argent-2026-11-18h.md b/docs/team/reviews/US-224/argent-2026-11-18h.md new file mode 100644 index 00000000..997448f6 --- /dev/null +++ b/docs/team/reviews/US-224/argent-2026-11-18h.md @@ -0,0 +1,15 @@ +# Revue argent — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247) — 2026-11-18 + +Relecteur : revue-argent / 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 : eb90f895..f4020a39f241eb0fc1affd37c76768ba2f175797 + +Contexte : lecture de `git diff eb90f895...f4020a39` (migration 0147, fixture 9935, ADR-171, correction d'ADR-159, trois L0, documentation). CI de f4020a39 (run 44404059009) verte, dont « base de données » (test:int, test:l0). Corps recopiés de 0140, 0137 et 0135 comparés au corps de 0147 : seules les conditions annoncées changent. + +| # | Gravité | Constat | +| --- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Aucun montant, aucune jambe, aucun arrondi, aucune écriture de grand livre touchés ; `CANCEL_HOST_TRIPS` écrit les mêmes demandes d'annulation PENDING (motif `HOST_ACCOUNT_CLOSED`, remboursement intégral réglé ensuite par le règlement) ; seule la condition d'entrée se resserre. | +| 2 | INFO | Une dette envers Kmino (`UNPAID_BALANCE`, `PAYMENT_PLAN_ACTIVE`, `CHARGEBACK`) ne peut plus déclencher l'annulation de masse ; elle se recouvre sur les versements (host_ledger), conforme à BR-TRUST-09 et à COMME_TURO. Aucune constante de pays. | +| 3 | INFO | Le reçu (N-342) n'est plus lisible par un co-hôte ni par un ex-hôte : la vue `finance_trip_receipt_view` n'est appelée qu'après le jugement du rôle ; montants lus, jamais recalculés. | +| 4 | INFO | Les tests PA/USD et PY/PYG existants gardent toutes leurs assertions ; seul le commentaire d'en-tête est étendu et des cas sont ajoutés. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/code-2026-11-18h.md b/docs/team/reviews/US-224/code-2026-11-18h.md new file mode 100644 index 00000000..500f6823 --- /dev/null +++ b/docs/team/reviews/US-224/code-2026-11-18h.md @@ -0,0 +1,14 @@ +# Revue code — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247) — 2026-11-18 + +Relecteur : revue-code / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : eb90f895..f4020a39f241eb0fc1affd37c76768ba2f175797 + +Contexte : lecture de `git diff eb90f895...f4020a39` (migration 0147, fixture 9935, ADR-171, correction d'ADR-159, trois L0, documentation). CI de f4020a39 (run 44404059009) verte, dont « base de données » (test:int, test:l0). Corps recopiés de 0140, 0137 et 0135 comparés au corps de 0147 : seules les conditions annoncées changent. + +| # | Gravité | Constat | +| --- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Corps recopiés conformes aux versions 0140, 0137 et 0135 (diff ligne à ligne) ; commentaires, COMMENT ON et retour arrière cohérents ; migration contiguë (0147). | +| 2 | INFO | N-313 : motif construit à partir de slugs `[a-z0-9-]` (contrainte de format de la table) donc sans caractère spécial ; `rtrim` retire les `-?` finaux ; `« gla-200 »`, `« golf »` restent hors règle, `« g500 »`, `« lx570 »`, `« 740i »` entrent. Insertions de graine sans conflit avec 0135 (unicité NULLS NOT DISTINCT) ; `NOT EXISTS` pour les lignes Mercedes. | +| 3 | INFO | Tests modifiés : trois fichiers L0, ajouts et commentaires seulement, aucune assertion retirée. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/qa-2026-11-18h.md b/docs/team/reviews/US-224/qa-2026-11-18h.md new file mode 100644 index 00000000..1ea74591 --- /dev/null +++ b/docs/team/reviews/US-224/qa-2026-11-18h.md @@ -0,0 +1,13 @@ +# Revue qa — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247) — 2026-11-18 + +Relecteur : revue-qa / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : eb90f895..f4020a39f241eb0fc1affd37c76768ba2f175797 + +Contexte : lecture de `git diff eb90f895...f4020a39` (migration 0147, fixture 9935, ADR-171, correction d'ADR-159, trois L0, documentation). CI de f4020a39 (run 44404059009) verte, dont « base de données » (test:int, test:l0). Corps recopiés de 0140, 0137 et 0135 comparés au corps de 0147 : seules les conditions annoncées changent. + +| # | Gravité | Constat | +| --- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Preuves L0 sous les rôles de production (assertion L0-05 en tête de chaque test existant), en PA/USD et PY/PYG : trois genres d'argent refusés avec liste vide d'annulations, deux genres de sûreté acceptés (`it.each`), co-hôte puis adhésion retirée en NOT_FOUND, voyageur inchangé, 13 saisies libres dont `GLA 200` et `Golf` sans débordement. | +| 2 | INFO | Aucune assertion retirée ; modifications des tests existants = commentaires et ajouts. CI complète verte au SHA relu (run 44404059009). | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/securite-2026-11-18h.md b/docs/team/reviews/US-224/securite-2026-11-18h.md new file mode 100644 index 00000000..9ed210bb --- /dev/null +++ b/docs/team/reviews/US-224/securite-2026-11-18h.md @@ -0,0 +1,16 @@ +# Revue securite — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247) — 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 : eb90f895..f4020a39f241eb0fc1affd37c76768ba2f175797 + +Contexte : lecture de `git diff eb90f895...f4020a39` (migration 0147, fixture 9935, ADR-171, correction d'ADR-159, trois L0, documentation). CI de f4020a39 (run 44404059009) verte, dont « base de données » (test:int, test:l0). Corps recopiés de 0140, 0137 et 0135 comparés au corps de 0147 : seules les conditions annoncées changent. + +| # | Gravité | Constat | +| --- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | `GRANT SELECT (kind) ON core.iam_restriction TO cmd_hold_owner` : une seule colonne, liste fermée non personnelle ; la politique `cmd_hold_read` (0064) existait déjà ; aucun droit d'écriture ajouté. | +| 2 | INFO | Les trois fonctions gardent signature, `SECURITY DEFINER`, `search_path = pg_catalog, pg_temp`, propriétaire (`cmd_hold_owner`, `migrator` pour la résolution) et EXECUTE inchangés ; `CREATE OR REPLACE` sous `SET LOCAL ROLE`, `REVOKE CREATE` rendu. `core.iam_host_accounts` est déjà exécutable par `cmd_hold_owner` (0126). Aucune escalade, aucun secret, `platform.now()`, aucun `now()` métier. | +| 3 | INFO | N-354 : `HOST_NOT_RESTRICTED` et rien d'écrit pour une restriction d'argent seule ; liste fermée `TS_HOLD`, `POLICY_VIOLATION`, `KYC_REVOKED` prise parmi les six genres de 17 (table `restriction`) ; le classement sûreté / argent est un jugement PROPOSÉ (08 ne le tranche pas), fail-closed, consigné ADR-171 et COMME_TURO. | +| 4 | INFO | N-342 : `NOT_FOUND` identique pour tiers, co-hôte, adhésion retirée, session absente (aucun oracle) ; le titulaire actif et le voyageur sont inchangés. Preuves L0 sous `app_api`. | +| 5 | INFO | Fixture 9935 : `SECURITY DEFINER`, `search_path` figé, `REVOKE PUBLIC`, dans `test-migrations/` seulement, jamais en production. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/ux-2026-11-18h.md b/docs/team/reviews/US-224/ux-2026-11-18h.md new file mode 100644 index 00000000..a8bcff56 --- /dev/null +++ b/docs/team/reviews/US-224/ux-2026-11-18h.md @@ -0,0 +1,12 @@ +# Revue ux — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247) — 2026-11-18 + +Relecteur : revue-ux / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : eb90f895..f4020a39f241eb0fc1affd37c76768ba2f175797 + +Contexte : lecture de `git diff eb90f895...f4020a39` (migration 0147, fixture 9935, ADR-171, correction d'ADR-159, trois L0, documentation). CI de f4020a39 (run 44404059009) verte, dont « base de données » (test:int, test:l0). Corps recopiés de 0140, 0137 et 0135 comparés au corps de 0147 : seules les conditions annoncées changent. + +| # | Gravité | Constat | +| --- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 1 | INFO | Aucun texte visible ajouté (aucun fichier `apps/web`, catalogue ou i18n dans le diff) ; `HOST_NOT_RESTRICTED` et `RECEIPT_NOT_FOUND` existaient déjà avec leurs textes es / en / fr / pt-BR. Exigence quadrilingue sans objet. | + +Verdict : APPROUVÉ From 4d1d8cb2c081ecc1b58e7e7dbd819bcd4ac47418 Mon Sep 17 00:00:00 2001 From: Projetapploccar <351336702+Projetapploccar@users.noreply.github.com> Date: Wed, 18 Nov 2026 19:44:50 -0300 Subject: [PATCH 5/5] =?UTF-8?q?docs(US-224):=20revues=20du=20delta=20de=20?= =?UTF-8?q?la=20PR=20n=C2=B0=20247=20(fusion=20de=20main,=200148,=208474b1?= =?UTF-8?q?cf)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Agent-Role: revue-argent Agent-Model: claude-sonnet-5-5 --- .../reviews/US-224/architecture-2026-11-18i.md | 15 +++++++++++++++ docs/team/reviews/US-224/argent-2026-11-18i.md | 15 +++++++++++++++ docs/team/reviews/US-224/code-2026-11-18i.md | 15 +++++++++++++++ docs/team/reviews/US-224/qa-2026-11-18i.md | 15 +++++++++++++++ docs/team/reviews/US-224/securite-2026-11-18i.md | 15 +++++++++++++++ docs/team/reviews/US-224/ux-2026-11-18i.md | 15 +++++++++++++++ 6 files changed, 90 insertions(+) create mode 100644 docs/team/reviews/US-224/architecture-2026-11-18i.md create mode 100644 docs/team/reviews/US-224/argent-2026-11-18i.md create mode 100644 docs/team/reviews/US-224/code-2026-11-18i.md create mode 100644 docs/team/reviews/US-224/qa-2026-11-18i.md create mode 100644 docs/team/reviews/US-224/securite-2026-11-18i.md create mode 100644 docs/team/reviews/US-224/ux-2026-11-18i.md diff --git a/docs/team/reviews/US-224/architecture-2026-11-18i.md b/docs/team/reviews/US-224/architecture-2026-11-18i.md new file mode 100644 index 00000000..07e714a0 --- /dev/null +++ b/docs/team/reviews/US-224/architecture-2026-11-18i.md @@ -0,0 +1,15 @@ +# Revue architecture — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247, delta après fusion de main et renumérotation 0147 → 0148) — 2026-11-18 + +Relecteur : revue-architecture / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 6b0fc3e5..8474b1cf97b1e7924ac3b396ab280f9f1f4c2b66 + +Contexte : seconde passe après la fusion de `origin/main` (#244, US-212b, migration 0147) dans la branche et la renumérotation du durcissement en 0148. Revue 2026-11-18h (APPROUVÉ au SHA f4020a39) inchangée sur le fond. Comparaison `git diff 6090e0ed 8474b1cf` limitée aux fichiers propres à la PR. + +| # | Gravité | Constat | +| --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Migration renommée 0147 → 0148 : le diff du fichier se réduit à la ligne d'en-tête (« 0147 » → « 0148 ») ; corps SQL identique à la version relue (fonctions, GRANT, graine). | +| 2 | INFO | Fixture 9935, trois L0, ADR-159, ADR-171, README avl / cat / sup, passation US-224 : identiques à la version relue après remplacement de 0147 par 0148 (la passation ajoute en plus la mention de la fusion de #244 dans la note de renumérotation). | +| 3 | INFO | Conflits : `schema.md` = main plus deux lignes (compte « 149 migrations », ligne 0148) ; `packages/db/README.md` = section US-212b de main conservée, section du durcissement ajoutée. | +| 4 | INFO | La migration 0147 de #244 (`ctr_constancia_frozen_host_checkout_host`) ne redéfinit ni `booking_trip_receipt`, ni `booking_manual_action_cancel_host_trips`, ni `catalog_value_class_resolve` : aucun écrasement entre les deux migrations. Les apports de main (allowlist SECURITY DEFINER, i18n, e2e, fixture 9938) sont étrangers à la PR. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/argent-2026-11-18i.md b/docs/team/reviews/US-224/argent-2026-11-18i.md new file mode 100644 index 00000000..d02927b9 --- /dev/null +++ b/docs/team/reviews/US-224/argent-2026-11-18i.md @@ -0,0 +1,15 @@ +# Revue argent — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247, delta après fusion de main et renumérotation 0147 → 0148) — 2026-11-18 + +Relecteur : revue-argent / 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 : 6b0fc3e5..8474b1cf97b1e7924ac3b396ab280f9f1f4c2b66 + +Contexte : seconde passe après la fusion de `origin/main` (#244, US-212b, migration 0147) dans la branche et la renumérotation du durcissement en 0148. Revue 2026-11-18h (APPROUVÉ au SHA f4020a39) inchangée sur le fond. Comparaison `git diff 6090e0ed 8474b1cf` limitée aux fichiers propres à la PR. + +| # | Gravité | Constat | +| --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Migration renommée 0147 → 0148 : le diff du fichier se réduit à la ligne d'en-tête (« 0147 » → « 0148 ») ; corps SQL identique à la version relue (fonctions, GRANT, graine). | +| 2 | INFO | Fixture 9935, trois L0, ADR-159, ADR-171, README avl / cat / sup, passation US-224 : identiques à la version relue après remplacement de 0147 par 0148 (la passation ajoute en plus la mention de la fusion de #244 dans la note de renumérotation). | +| 3 | INFO | Conflits : `schema.md` = main plus deux lignes (compte « 149 migrations », ligne 0148) ; `packages/db/README.md` = section US-212b de main conservée, section du durcissement ajoutée. | +| 4 | INFO | La migration 0147 de #244 (`ctr_constancia_frozen_host_checkout_host`) ne redéfinit ni `booking_trip_receipt`, ni `booking_manual_action_cancel_host_trips`, ni `catalog_value_class_resolve` : aucun écrasement entre les deux migrations. Les apports de main (allowlist SECURITY DEFINER, i18n, e2e, fixture 9938) sont étrangers à la PR. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/code-2026-11-18i.md b/docs/team/reviews/US-224/code-2026-11-18i.md new file mode 100644 index 00000000..f9e2b885 --- /dev/null +++ b/docs/team/reviews/US-224/code-2026-11-18i.md @@ -0,0 +1,15 @@ +# Revue code — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247, delta après fusion de main et renumérotation 0147 → 0148) — 2026-11-18 + +Relecteur : revue-code / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 6b0fc3e5..8474b1cf97b1e7924ac3b396ab280f9f1f4c2b66 + +Contexte : seconde passe après la fusion de `origin/main` (#244, US-212b, migration 0147) dans la branche et la renumérotation du durcissement en 0148. Revue 2026-11-18h (APPROUVÉ au SHA f4020a39) inchangée sur le fond. Comparaison `git diff 6090e0ed 8474b1cf` limitée aux fichiers propres à la PR. + +| # | Gravité | Constat | +| --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Migration renommée 0147 → 0148 : le diff du fichier se réduit à la ligne d'en-tête (« 0147 » → « 0148 ») ; corps SQL identique à la version relue (fonctions, GRANT, graine). | +| 2 | INFO | Fixture 9935, trois L0, ADR-159, ADR-171, README avl / cat / sup, passation US-224 : identiques à la version relue après remplacement de 0147 par 0148 (la passation ajoute en plus la mention de la fusion de #244 dans la note de renumérotation). | +| 3 | INFO | Conflits : `schema.md` = main plus deux lignes (compte « 149 migrations », ligne 0148) ; `packages/db/README.md` = section US-212b de main conservée, section du durcissement ajoutée. | +| 4 | INFO | La migration 0147 de #244 (`ctr_constancia_frozen_host_checkout_host`) ne redéfinit ni `booking_trip_receipt`, ni `booking_manual_action_cancel_host_trips`, ni `catalog_value_class_resolve` : aucun écrasement entre les deux migrations. Les apports de main (allowlist SECURITY DEFINER, i18n, e2e, fixture 9938) sont étrangers à la PR. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/qa-2026-11-18i.md b/docs/team/reviews/US-224/qa-2026-11-18i.md new file mode 100644 index 00000000..2b941252 --- /dev/null +++ b/docs/team/reviews/US-224/qa-2026-11-18i.md @@ -0,0 +1,15 @@ +# Revue qa — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247, delta après fusion de main et renumérotation 0147 → 0148) — 2026-11-18 + +Relecteur : revue-qa / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 6b0fc3e5..8474b1cf97b1e7924ac3b396ab280f9f1f4c2b66 + +Contexte : seconde passe après la fusion de `origin/main` (#244, US-212b, migration 0147) dans la branche et la renumérotation du durcissement en 0148. Revue 2026-11-18h (APPROUVÉ au SHA f4020a39) inchangée sur le fond. Comparaison `git diff 6090e0ed 8474b1cf` limitée aux fichiers propres à la PR. + +| # | Gravité | Constat | +| --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Migration renommée 0147 → 0148 : le diff du fichier se réduit à la ligne d'en-tête (« 0147 » → « 0148 ») ; corps SQL identique à la version relue (fonctions, GRANT, graine). | +| 2 | INFO | Fixture 9935, trois L0, ADR-159, ADR-171, README avl / cat / sup, passation US-224 : identiques à la version relue après remplacement de 0147 par 0148 (la passation ajoute en plus la mention de la fusion de #244 dans la note de renumérotation). | +| 3 | INFO | Conflits : `schema.md` = main plus deux lignes (compte « 149 migrations », ligne 0148) ; `packages/db/README.md` = section US-212b de main conservée, section du durcissement ajoutée. | +| 4 | INFO | La migration 0147 de #244 (`ctr_constancia_frozen_host_checkout_host`) ne redéfinit ni `booking_trip_receipt`, ni `booking_manual_action_cancel_host_trips`, ni `catalog_value_class_resolve` : aucun écrasement entre les deux migrations. Les apports de main (allowlist SECURITY DEFINER, i18n, e2e, fixture 9938) sont étrangers à la PR. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/securite-2026-11-18i.md b/docs/team/reviews/US-224/securite-2026-11-18i.md new file mode 100644 index 00000000..c62240f5 --- /dev/null +++ b/docs/team/reviews/US-224/securite-2026-11-18i.md @@ -0,0 +1,15 @@ +# Revue securite — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247, delta après fusion de main et renumérotation 0147 → 0148) — 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 : 6b0fc3e5..8474b1cf97b1e7924ac3b396ab280f9f1f4c2b66 + +Contexte : seconde passe après la fusion de `origin/main` (#244, US-212b, migration 0147) dans la branche et la renumérotation du durcissement en 0148. Revue 2026-11-18h (APPROUVÉ au SHA f4020a39) inchangée sur le fond. Comparaison `git diff 6090e0ed 8474b1cf` limitée aux fichiers propres à la PR. + +| # | Gravité | Constat | +| --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Migration renommée 0147 → 0148 : le diff du fichier se réduit à la ligne d'en-tête (« 0147 » → « 0148 ») ; corps SQL identique à la version relue (fonctions, GRANT, graine). | +| 2 | INFO | Fixture 9935, trois L0, ADR-159, ADR-171, README avl / cat / sup, passation US-224 : identiques à la version relue après remplacement de 0147 par 0148 (la passation ajoute en plus la mention de la fusion de #244 dans la note de renumérotation). | +| 3 | INFO | Conflits : `schema.md` = main plus deux lignes (compte « 149 migrations », ligne 0148) ; `packages/db/README.md` = section US-212b de main conservée, section du durcissement ajoutée. | +| 4 | INFO | La migration 0147 de #244 (`ctr_constancia_frozen_host_checkout_host`) ne redéfinit ni `booking_trip_receipt`, ni `booking_manual_action_cancel_host_trips`, ni `catalog_value_class_resolve` : aucun écrasement entre les deux migrations. Les apports de main (allowlist SECURITY DEFINER, i18n, e2e, fixture 9938) sont étrangers à la PR. | + +Verdict : APPROUVÉ diff --git a/docs/team/reviews/US-224/ux-2026-11-18i.md b/docs/team/reviews/US-224/ux-2026-11-18i.md new file mode 100644 index 00000000..acbd6ee2 --- /dev/null +++ b/docs/team/reviews/US-224/ux-2026-11-18i.md @@ -0,0 +1,15 @@ +# Revue ux — US-224 « durcissement avant ouverture d'un pays (N-354, N-342, N-313) » (PR n° 247, delta après fusion de main et renumérotation 0147 → 0148) — 2026-11-18 + +Relecteur : revue-ux / claude-sonnet-5-5 (famille A, modèle autre que l'auteur claude-opus-5-5) +Entrées : 6b0fc3e5..8474b1cf97b1e7924ac3b396ab280f9f1f4c2b66 + +Contexte : seconde passe après la fusion de `origin/main` (#244, US-212b, migration 0147) dans la branche et la renumérotation du durcissement en 0148. Revue 2026-11-18h (APPROUVÉ au SHA f4020a39) inchangée sur le fond. Comparaison `git diff 6090e0ed 8474b1cf` limitée aux fichiers propres à la PR. + +| # | Gravité | Constat | +| --- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | INFO | Migration renommée 0147 → 0148 : le diff du fichier se réduit à la ligne d'en-tête (« 0147 » → « 0148 ») ; corps SQL identique à la version relue (fonctions, GRANT, graine). | +| 2 | INFO | Fixture 9935, trois L0, ADR-159, ADR-171, README avl / cat / sup, passation US-224 : identiques à la version relue après remplacement de 0147 par 0148 (la passation ajoute en plus la mention de la fusion de #244 dans la note de renumérotation). | +| 3 | INFO | Conflits : `schema.md` = main plus deux lignes (compte « 149 migrations », ligne 0148) ; `packages/db/README.md` = section US-212b de main conservée, section du durcissement ajoutée. | +| 4 | INFO | La migration 0147 de #244 (`ctr_constancia_frozen_host_checkout_host`) ne redéfinit ni `booking_trip_receipt`, ni `booking_manual_action_cancel_host_trips`, ni `catalog_value_class_resolve` : aucun écrasement entre les deux migrations. Les apports de main (allowlist SECURITY DEFINER, i18n, e2e, fixture 9938) sont étrangers à la PR. | + +Verdict : APPROUVÉ