Skip to content
Merged
2 changes: 1 addition & 1 deletion apps/api/src/modules/avl/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 0148, 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`.
Expand Down
2 changes: 1 addition & 1 deletion apps/api/src/modules/cat/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 0148 (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.

Expand Down
2 changes: 1 addition & 1 deletion apps/api/src/modules/sup/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 0148, 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`.

Expand Down
14 changes: 14 additions & 0 deletions changelog.d/US-224-durcissement.md
Original file line number Diff line number Diff line change
@@ -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)
Loading
Loading