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

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 93 additions & 0 deletions apps/api/src/modules/cfg/data/params.json
Original file line number Diff line number Diff line change
Expand Up @@ -2094,6 +2094,99 @@
"decision": "PROPOSED",
"decisionRef": "ADR-146 PROPOSÉ (US-223c) ; COMME_TURO",
"values": { "PA": false, "PY": false }
},
{
"key": "deposit_always_required",
"type": "BOOL",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 (déclencheur COUNTRY : caution imposée à tout trip du pays) ; 17 §7.2 ; ADR-108 ; absent ou illisible : déclencheur vrai, caution exigée (fail-closed)",
"status": "PROPOSÉ comme Turo (ADR-108) : aucune caution par défaut",
"decision": "PROPOSED",
"decisionRef": "17 §7.2 PROPOSÉ (ADR-108 ; COMME_TURO OQ-P2P-04)",
"values": { "PA": false, "PY": false }
},
{
"key": "deposit_trigger_classes",
"type": "JSON",
"unit": "value_class_set",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 (déclencheur CLASS : classe de valeur du véhicule, ADR-159) ; 17 §7.2 ; ADR-108 ; absent : toutes les classes déclenchent (fail-closed)",
"status": "PROPOSÉ comme Turo ({LUXE}, équivalent Super Deluxe) ; à confirmer par le fondateur avant la mise en ligne",
"decision": "TO_DECIDE",
"decisionRef": "OQ-P2P-04 ; décision du fondateur du 2026-11-12 (hésitation sur le luxe) ; ADR-108",
"values": { "PA": ["LUXE"], "PY": ["LUXE"] }
},
{
"key": "deposit_young_driver_age",
"type": "INT",
"unit": "years",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 (déclencheur AGE, seuil strict, plus jeune conducteur approuvé) ; 17 §7.2 ; ADR-108 ; absent : tout âge déclenche (fail-closed)",
"status": "PROPOSÉ comme Turo (30 ans) ; sans effet tant que deposit_young_driver_classes est vide",
"decision": "PROPOSED",
"decisionRef": "17 §7.2 PROPOSÉ (ADR-108)",
"values": { "PA": 30, "PY": 30 }
},
{
"key": "deposit_young_driver_classes",
"type": "JSON",
"unit": "value_class_set",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 (déclencheur AGE : classes du catalogue concernées) ; 17 §7.2 ; absent : toutes les classes (fail-closed)",
"status": "décidé (DEC-FONDATEUR-21, 2026-11-12) : ensemble vide, aucune caution liée à l’âge au PA et au PY",
"decision": "DECIDED",
"decisionRef": "DEC-FONDATEUR-21 (2026-11-12) ; 17 §7.2",
"values": { "PA": [], "PY": [] }
},
{
"key": "deposit_on_risk_flag",
"type": "BOOL",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 (déclencheur RISK : trip signalé par le contrôle de risque, BR-VERIF-09, ADM-029) ; 17 §7.2 ; absent : déclencheur vrai (fail-closed)",
"status": "PROPOSÉ comme Turo (vrai) ; sans effet tant que risk_control_deployed est faux",
"decision": "PROPOSED",
"decisionRef": "17 §7.2 PROPOSÉ (ADR-108)",
"values": { "PA": true, "PY": true }
},
{
"key": "risk_control_deployed",
"type": "BOOL",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 (« contrôle non déployé ≠ en panne », risk_control_deployed) ; ADR-108 point 3 bis ; faux : RISK non évalué (risk_evaluated = false) ; absent : contrôle tenu pour déployé, une panne rend RISK vrai (fail-closed)",
"status": "PROPOSÉ (faux tant que la caution sur signal de risque n’est pas branchée au contrôle de risque de US-209 ; changé seulement par l’administration avec journal)",
"decision": "PROPOSED",
"decisionRef": "ADR-108 point 3 bis ; 08 BR-PAY-06 (à reporter dans 17 §7.2)",
"values": { "PA": false, "PY": false }
},
{
"key": "deposit_reauth_lead_h",
"type": "DURATION",
"unit": "h",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 « Mécanisme » rail (a) : ré-autorisation planifiée à auth_expiry − 24 h",
"status": "PROPOSÉ (08 BR-PAY-06 ; la capacité SUPPORTS_REAUTH reste à valider avec le PSP)",
"decision": "PROPOSED",
"decisionRef": "08 BR-PAY-06 ; ADR-164 (à reporter dans 17 §7.2)",
"values": { "PA": 24, "PY": 24 }
},
{
"key": "deposit_fee_notice_h",
"type": "DURATION",
"unit": "h",
"scopes": ["COUNTRY"],
"failMode": "BLOCK",
"source": "08 BR-PAY-06 « Libération à heure fixe » : un frais annexe n’est capturé sur la caution que s’il a été notifié au voyageur au moins 48 h avant la décision (délai BR-REIMB-03) ; sinon débit MIT séparé",
"status": "PROPOSÉ (08 BR-PAY-06, BR-REIMB-03)",
"decision": "PROPOSED",
"decisionRef": "08 BR-PAY-06 ; ADR-164 (à reporter dans 17 §7.2)",
"values": { "PA": 48, "PY": 48 }
}
]
}
1 change: 1 addition & 0 deletions apps/api/src/modules/cfg/internal/defaults.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,7 @@ const EXPECTED_TO_DECIDE: Readonly<Record<string, string>> = {
deposit_charge_cap: '17 statut OQ-PAY-06, OQ-PAY-19',
deposit_max: '17 statut J-ADM-031',
deposit_safety_h: '17 statut OQ-PAY-02',
deposit_trigger_classes: '17 statut « à confirmer par le fondateur » (OQ-P2P-04 ; US-225)',
elig_age_years_ceiling: '16 HST-019 (« valeurs À DÉCIDER dans ADM-031 ») ; 22 OQ-P2P-02 (US-124)',
elig_doc_compulsory_insurance: '16 HST-039 ; 22 OQ-P2P-02 (US-124)',
elig_doc_inspection: '16 HST-039 ; 22 OQ-P2P-02 (US-124)',
Expand Down
7 changes: 7 additions & 0 deletions apps/api/src/modules/cfg/internal/model.ts
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,13 @@ export type ParamScope = (typeof PARAM_SCOPES)[number];
export const FAIL_MODES = ['BLOCK', 'FALSE', 'ZERO'] as const;
export type FailMode = (typeof FAIL_MODES)[number];

/**
* Classes de valeur d'un véhicule (08 BR-ACC-05 ; 17 §3.2.3 `vehicle.value_class`), vocabulaire
* fermé commun à tous les pays : forme des paramètres d'unité `value_class_set` (US-225).
*/
export const VALUE_CLASSES = ['STANDARD', 'PREMIUM', 'LUXE'] as const;
export type ValueClass = (typeof VALUE_CLASSES)[number];

/** Types de ligne d'un devis (17 §3.2 `quote_line.line_type`, 08 `LINES`) : `tax_line_config` les couvre tous. */
export const TAX_LINE_TYPES = [
'TRIP_PRICE',
Expand Down
12 changes: 12 additions & 0 deletions apps/api/src/modules/cfg/internal/parse.ts
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ import {
PARAM_SCOPES,
PARAM_TYPES,
TAX_LINE_TYPES,
VALUE_CLASSES,
} from './model.js';
import type {
CountryConfig,
Expand All @@ -36,6 +37,7 @@ import type {
TaxLineConfig,
TaxLineType,
TimeZoneCheck,
ValueClass,
PhoneNumberingConfig,
RegulatoryNotice,
} from './model.js';
Expand Down Expand Up @@ -735,6 +737,16 @@ function checkJsonShape(c: Collector, path: string, def: ParamDefinition, value:
c.add(path, 'part « n/d » dans [0 ; 1] attendue');
return false;
}
if (unit === 'value_class_set') {
// US-225 (ADR-164) : ensemble de classes de valeur (08 BR-ACC-05) ; vide permis (aucune
// classe, DEC-FONDATEUR-21) ; sans doublon, dans l'ordre du vocabulaire fermé
const rank = (v: unknown): number => VALUE_CLASSES.indexOf(v as ValueClass);
const ok =
Array.isArray(value) &&
value.every((v, i) => rank(v) >= 0 && (i === 0 || rank(v) > rank(value[i - 1])));
if (!ok) c.add(path, `ensemble de classes attendu, ordonné : ${VALUE_CLASSES.join(', ')}`);
return ok;
}
if (unit.endsWith('_list')) {
const ok =
Array.isArray(value) &&
Expand Down
13 changes: 10 additions & 3 deletions apps/api/src/modules/cfg/internal/seed-sql.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -84,17 +84,24 @@ describe('migration de graines', () => {
);

it('0009 reste rendue sans les paramètres ajoutés après elle (immuable, ADR-044, ADR-075)', () => {
for (const { prefix } of POST_SEED_PARAMS) expect(rendered).not.toContain(`'${prefix}`);
for (const { prefix, extraKeys } of POST_SEED_PARAMS) {
expect(rendered).not.toContain(`'${prefix}`);
for (const key of extraKeys ?? []) expect(rendered).not.toContain(`'${key}'`);
}
});

it.each(POST_SEED_PARAMS)(
'graine complémentaire $file identique au rendu des paramètres $prefix*',
({ prefix, file }) => {
({ prefix, file, extraKeys }) => {
const delta = renderParamSeedSql(config, prefix);
if (process.env['RUEDA_WRITE_CFG_SEED'] === '1')
writeFileSync(migrationUrl(file), delta, 'utf8');
expect(readFileSync(migrationUrl(file), 'utf8').replaceAll('\r\n', '\n')).toBe(delta);
const keys = [...config.definitions.keys()].filter((k) => k.startsWith(prefix));
const keys = [...config.definitions.keys()].filter(
(k) => k.startsWith(prefix) || (extraKeys ?? []).includes(k),
);
// US-225 : chaque clé nouvelle nommée existe dans le registre
for (const key of extraKeys ?? []) expect(keys).toContain(key);
expect(keys.length).toBeGreaterThan(0);
for (const key of keys) {
expect(delta).toContain(`('${key}', '`);
Expand Down
43 changes: 38 additions & 5 deletions apps/api/src/modules/cfg/internal/seed-sql.ts
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,11 @@ export const POST_SEED_PARAMS: readonly {
readonly refs?: string;
/** Clés définies dans 0009 dont les valeurs sont insérées par ce groupe (US-226). */
readonly valueKeys?: readonly string[];
/**
* Clés NOUVELLES du groupe hors du préfixe (US-225, ADR-164) : noms de 17 §7.2 sans préfixe
* commun (`deposit_*` couvre des clés de 0009). Le préfixe reste l'identifiant du groupe.
*/
readonly extraKeys?: readonly string[];
}[] = [
{ prefix: 'rate_limit_', file: '0046_config_rate_limit_params.sql', story: 'US-052' },
{ prefix: 'otp_rate_', file: '0065_config_otp_rate_params.sql', story: 'US-104' },
Expand Down Expand Up @@ -144,11 +149,31 @@ export const POST_SEED_PARAMS: readonly {
story: 'US-113',
refs: '08 BR-ACC-05 ; BOARD N-83 ; ADR-159',
},
{
prefix: 'deposit_always_required',
file: '0142_config_deposit_rail_params.sql',
story: 'US-225',
refs: '08 BR-PAY-06 ; 17 §7.2 ; ADR-108 ; ADR-164',
extraKeys: [
'deposit_fee_notice_h',
'deposit_on_risk_flag',
'deposit_reauth_lead_h',
'deposit_trigger_classes',
'deposit_young_driver_age',
'deposit_young_driver_classes',
'risk_control_deployed',
],
},
];

/** La clé appartient au groupe : préfixe ou clé nouvelle nommée (`extraKeys`). */
export function inPostSeedGroup(step: (typeof POST_SEED_PARAMS)[number], key: string): boolean {
return key.startsWith(step.prefix) || (step.extraKeys?.includes(key) ?? false);
}

/** La clé appartient à un groupe de paramètres ajouté après 0009. */
export function isPostSeedParam(key: string): boolean {
return POST_SEED_PARAMS.some((p) => key.startsWith(p.prefix));
return POST_SEED_PARAMS.some((p) => inPostSeedGroup(p, key));
}

/** Les valeurs de la clé (définie dans 0009) sont insérées par un groupe ajouté après 0009. */
Expand Down Expand Up @@ -466,11 +491,16 @@ export function renderParamSeedSql(config: CountryConfig, prefix: string): strin
const step = POST_SEED_PARAMS.find((p) => p.prefix === prefix);
if (!step) throw new Error(`groupe de paramètres « ${prefix} » absent de POST_SEED_PARAMS`);
const definitions = [...config.definitions.values()]
.filter((d) => d.key.startsWith(prefix))
.filter((d) => inPostSeedGroup(step, d.key))
.sort((a, b) => a.key.localeCompare(b.key));
const values = sortValues(config.values.filter((v) => v.key.startsWith(prefix)));
const values = sortValues(config.values.filter((v) => inPostSeedGroup(step, v.key)));
const number = step.file.slice(0, 4);
const like = `${prefix.replaceAll('_', '\\_')}%`;
const extra = step.extraKeys ?? [];
const where =
extra.length === 0
? ` WHERE d.key LIKE ${lit(like)}`
: ` WHERE (d.key LIKE ${lit(like)} OR d.key = ANY (${textArray(extra)}))`;
return [
[
`-- ${number} — graine complémentaire : paramètres « ${prefix}* » (${step.story} ; 17 §7.2).`,
Expand All @@ -480,7 +510,10 @@ export function renderParamSeedSql(config: CountryConfig, prefix: string): strin
'-- Valeurs PROPOSÉES ; valid_from posé par la garde (platform.now()).',
'--',
`-- Retour arrière (base sans dépendance) : DELETE des valeurs puis des définitions dont la clé`,
`-- commence par « ${prefix} » ; jamais en production : nouvelle migration à la place.`,
extra.length === 0
? `-- commence par « ${prefix} » ; jamais en production : nouvelle migration à la place.`
: `-- commence par « ${prefix} » ou vaut ${extra.join(', ')} ;\n` +
'-- jamais en production : nouvelle migration à la place.',
'',
].join('\n'),
definitionInsert(definitions),
Expand All @@ -497,7 +530,7 @@ export function renderParamSeedSql(config: CountryConfig, prefix: string): strin
'BEGIN',
' IF EXISTS (SELECT 1 FROM core.config_param_definition AS d',
' CROSS JOIN core.config_country AS c',
` WHERE d.key LIKE ${lit(like)}`,
where,
' AND NOT EXISTS (SELECT 1 FROM core.config_param_value AS v',
' WHERE v.key = d.key AND v.country_code = c.code)) THEN',
` RAISE EXCEPTION 'graine : paramètre ${prefix}* sans valeur pour un pays' USING ERRCODE = 'check_violation';`,
Expand Down
6 changes: 5 additions & 1 deletion apps/api/src/modules/pay/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Entités de 17 §3.2.7 :
| `mit_consent` | cible 17, pas encore créée |
| `tender` | cible 17, pas encore créée |
| `refund_instance` | cible 17, pas encore créée |
| `deposit_hold` | cible 17, pas encore créée |
| `deposit_hold` | cible 17, pas encore créée (US-701) ; rails et décision prêts en fonctions pures (US-225) |
| `chargeback` | cible 17, pas encore créée |
| `debt_balance` | cible 17, pas encore créée |
| `payment_plan` | cible 17, pas encore créée |
Expand All @@ -43,6 +43,10 @@ Entités de 17 §3.2.7 :

Hors entités de 17 : `core.payment_psp_capability_catalog` (catalogue des capacités, migration 0039 ; `SUPPORTS_PAYOUT_WITHOUT_HOST_TAX_ID` ajoutée par 0087, non bloquante, lue par le KYC de l'hôte : inconnue ⇒ numéro fiscal exigé avant l'activation, ADR-115). Commandes `SECURITY DEFINER` (famille `cmd_money`) : `core.payment_cmd_record_operation`, `payment_cmd_apply_operation_status`, `payment_cmd_receive_webhook` (0028), `payment_cmd_register_submerchant`, `payment_cmd_record_submerchant_status` (0039). Détail : `packages/db/README.md`, sections « Port PaymentProvider » et « Port de place de marché ».

## Caution « comme Turo » (US-225 ; 08 BR-PAY-06 ; ADR-108, ADR-164)

**Aucune caution par défaut.** Une caution n'existe que si un déclencheur paramétré par pays est vrai (`deposit_always_required`, `deposit_trigger_classes` = {LUXE}, âge sur `deposit_young_driver_classes` = vide au PA et au PY, signal de risque si `risk_control_deployed`) : graine `0142`, valeurs PROPOSÉES. Au checkout, avant le paiement, `decideDepositGate` rend `NOT_REQUIRED` (aucun rail évalué), `REQUIRED` avec le rail choisi par configuration, ou un refus (`PARAM_MISSING` si `deposit_amount` manque, `DEPOSIT_RAIL_UNAVAILABLE` avec les jours possibles). Le rail « débit puis remboursement » reste fermé tant que `funds_holding_enabled[pays]` = `false` (aucun fonds de tiers détenu) ; une capacité PSP inconnue vaut « non ». `planDepositDecision` et `DepositRailExecutor` exécutent la décision sur le port (FAKE seulement) avec le montant explicite de chaque commande. **Non branché** au checkout ni à un travailleur dans cette story : `deposit_hold`, l'écriture au checkout, les minuteries et l'écran S05 sont à US-701 / US-702 (voir `docs/team/handoffs/US-225.md`).

## Événements

Aucun événement de domaine n'est émis ni consommé par le code de PAY aujourd'hui. Chaque statut reçu est écrit dans `core.payment_payment_operation_event` (pas un événement d'outbox). La commande `CANCEL_ORDER` est écrite dans `core.payment_payment_command` par les commandes du hold (AVL, migration 0040), pas par un événement.
Expand Down
66 changes: 66 additions & 0 deletions apps/api/src/modules/pay/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,72 @@ export type {
export { COMMAND_KINDS, MoneyCommandSender } from './internal/money-command-sender.js';
export type { CommandKind, MoneyCommand, SendOutcome } from './internal/money-command-sender.js';

export { depositOperationKey, DEPOSIT_OPERATION_TYPES } from './internal/idempotency.js';
export type { DepositOperationType } from './internal/idempotency.js';

// Caution « comme Turo » : déclencheurs, rails, décision, exécution (US-225, ADR-164)
export {
DEPOSIT_TRIGGERS,
DEPOSIT_VALUE_CLASSES,
depositAmountFor,
evaluateDepositTriggers,
} from './internal/deposit-triggers.js';
export type {
DepositStage,
DepositTrigger,
DepositTriggerContext,
DepositTriggerDecision,
DepositTriggerParams,
DepositValueClass,
} from './internal/deposit-triggers.js';
export {
chargeLegs,
completeRailParams,
decideDepositGate,
DEPOSIT_EVENTS,
DEPOSIT_HOLD_STATUSES,
DEPOSIT_MECHANISMS,
depositAuthAt,
depositAuthExpiry,
depositDecisionAt,
depositHoldValidityHours,
depositReauthDueAt,
depositReleaseAt,
isCapturableOnDeposit,
nextDepositStatus,
planDepositDecision,
requiredHoldMinutes,
selectDepositRail,
} from './internal/deposit-rails.js';
export type {
DepositDecisionInput,
DepositDecisionPlan,
DepositEvent,
DepositFeePart,
DepositGateDecision,
DepositGateInput,
DepositHoldStatus,
DepositIncidentalFee,
DepositMechanism,
DepositRail,
DepositRailCapabilities,
DepositRailParams,
DepositRailRequest,
DepositRailSelection,
DepositStep,
} from './internal/deposit-rails.js';
export { DepositRailExecutor } from './internal/deposit-executor.js';
export type {
DepositExecution,
DepositPaymentProvider,
DepositReauthOutcome,
DepositReference,
DepositStepResult,
PlaceDepositRequest,
} from './internal/deposit-executor.js';
export { DEPOSIT_CONFIG_KEYS, PgDepositRailConfigReader } from './internal/pg-deposit-config.js';
export type { DepositRailConfig } from './internal/pg-deposit-config.js';

// Webhooks (17 §4.4)
export {
WEBHOOK_MAX_BODY_BYTES,
Expand Down
Loading
Loading