Contreparties et entités

Ce que « RÉSOLU » veut dire dépend de la nature de la transaction. Un virement à une personne est resolved sans qu'aucune identité ne soit créée — c'est la bonne réponse, pas un échec. Un retrait d'espèces est resolved sans marchand. Un achat carte, lui, exige sa contrepartie.

resolved : toutes les dimensions exigées par l'archétype sont là. partial : la nature est connue, une dimension exigée manque — ou des signaux se contredisent, auquel cas on refuse de conclure. unresolved : on ignore jusqu'à la nature. Les erreurs techniques (401, 409, 503) ne sont jamais une issue sémantique : elles ne portent pas ce champ.

Le vocabulaire est français et c'est celui de la base (le vocabulaire des archétypes de résolution), conservé tel quel pour ti_v1. inconnu : la nature même de la transaction est inconnue. non_couvert : la nature est connue mais aucune politique ne la couvre (missing = [resolution_policy]).

Les dimensions exigées par l'archétype et absentes.

Ce que le normaliseur a lu. Des chaînes, pas des scores.

null est un résultat, pas une panne : un inconnu honnête.

L'identifiant stable de l'entité dans le graphe, sous forme d'UUID nu, sans préfixe. Il est opaque : ne lui prêtez aucune structure. Le même identifiant désigne la même entité d'une réponse à l'autre et d'un workspace à l'autre (le graphe est partagé ; l'identifiant n'est pas une donnée de votre workspace). Il est cité tel quel dans series[].evidence sous la forme entite:<uuid>.

Comment le motif a apparié le libellé. Deux rapports de longueur, qui sont des propriétés du texte et pas une preuve d'identité. match dit par quelle voie (jetons : un alias entier dans le libellé ; tronque : un fragment de libellé coupé par la banque). pattern est l'alias apparié, en clair.

Quatre choses différentes qui se ressemblent, et que ce bloc refuse de confondre. Le type d'entité (counterparty.kind : marque, entité légale, intermédiaire de paiement) dit ce que c'est. L'activité (activity) dit ce que ça fait, en noms d'industrie. La catégorie (category, hors de cet objet) dit à quoi l'argent est allé, en lignes de budget. Le type de transaction (transaction_type) dit ce qui s'est passé. Aucun ne se déduit d'un autre. Et il n'existe aucun category = subscription : un abonnement n'est pas une sorte de dépense, c'est un modèle de relation commerciale. null quand le graphe ne sait rien de cette entité — une abstention, pas une panne.

Le métier, sur deux niveaux (parent puis code). On s'arrête au parent quand la source s'y arrête : un rôle utility dit « réseau » sans dire lequel, et on rend alors utilities, jamais utilities.electricity. Ce qui n'est pas su ne se complète pas.

Ce qui est habituel dans ce métier — pas un verdict sur cette transaction. Un service de streaming se vend par abonnement ; un fournisseur d'électricité facture de façon répétée sans qu'on s'abonne ; un supermarché vend à l'acte. C'est une plausibilité qui renforce un rythme déjà observé dans le workspace. Seul, il ne conclut jamais : commonly_subscription_based sur une transaction isolée ne fait pas un abonnement, et c'est la série (series[].type = subscription) qui tranche.

Les rôles portés par l'entité dans le graphe (merchant, utility, government, financial_institution, payment_intermediary…). Un rôle n'est pas un métier, mais il en dit assez pour en dériver un quand aucun catalogue ne couvre l'entité.

Une marque n'est pas une entité légale. « Netflix » est ce qu'on lit sur le relevé ; « Netflix Inc » est ce qui contracte. Les deux existent séparément dans le graphe, reliés par brand_of, parce que les fusionner ferait disparaître le jour où une marque change de propriétaire. null quand aucune société mère n'est connue — pas quand il n'y en a pas.

Le même espace d'identifiants que counterparty.entity_id : UUID nu, opaque, stable.

D'où vient ce qu'on affirme. nature classe la connaissance par autorité déclarée, dans cet ordre : curated (une personne l'a vérifié), deterministic (dérivé mécaniquement d'un fait déjà tenu), provider (un tiers l'annonce), inferred (nous l'avons déduit), participant (un seul client l'a dit). Cet ordre est déclaré, pas déduit d'un nombre : sans lui, un 0,95 déduit l'emporterait sur un 0,90 vérifié. strength ne départage qu'à nature égale, et n'est pas calibrée. Et aucune connaissance globale ne vient d'un seul client : ce qu'un workspace observe reste dans ce workspace. Une nature participant ne peut jamais devenir une vérité du graphe partagé.

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Comment la provenance a été établie. Les clefs varient : derivation (categorie_de_depense_vers_activite, role_vers_activite…), categorie_source ou role, et note, une phrase constante en français. Aucune de ces valeurs n'est un nombre.

Dit pourquoi aucune identité n'a été établie.

Une catégorie n'est pas une identité. Quand le libellé désigne un métier (« BOULANGERIE DUPONT », « PHARMACIE DE LA GARE ») et non une enseigne connue, la réponse rend ce métier ici et laisse counterparty à null. Rendre « Boulangerie » comme contrepartie reviendrait à nommer un rayon à la place d'une entreprise. Et c'est une ligne de budget, pas un métier. Cette catégorie répond à « à quoi cet argent est-il allé », du point de vue de la personne. Ce que l'entité fait est un autre champ, counterparty.semantics.activity, et les deux ne se substituent pas : EDF vend de l'électricité (activity = utilities.electricity) et la dépense se range sous logement.electricite. source dit d'où vient la ligne : entity_graph quand elle est portée par l'enseigne reconnue, generic_trade_entry quand elle est déduite d'un mot de métier lu dans le libellé. La première est bornée par confidence.entity — une enseigne mal reconnue ne donne pas une catégorie sûre. Quand une règle de votre organisation a posé la catégorie (voir customization), source est absent : slug et label viennent alors du catalogue Noryo, et aucune des deux origines Noryo ne serait vraie.

Pourquoi le moteur a refusé de nommer, alors qu'il aurait pu. trade_not_identity : un métier a été reconnu, pas une enseigne. atm_operator_not_counterparty : sur un mouvement d'espèces, la banque reconnue exploite le distributeur — elle n'est pas en face. account_bank_not_counterparty : sur un frais bancaire, c'est la banque du compte, et la nommer n'apprend rien. person_named_not_brand : le libellé nomme une personne, et l'enseigne reconnue appartient au motif du virement. Une abstention n'est pas une panne : policy.outcome peut rester resolved si l'archétype n'exigeait pas d'entité.

Les facilitateurs de paiement lus dans le libellé (PAYPAL *NETFLIX en donne un). Ils ne sont jamais la contrepartie. evidence est un code et une source — plus jamais le motif d'appariement lui-même, qui est une règle interne.

L'entité du facilitateur dans le graphe, quand elle y est.

Le code du facilitateur au référentiel.

Ce que la transaction signifie, par opposition à payment qui dit comment l'argent a circulé. evidence est un code de règle, pas une explication : la note interne de la règle sortait ici dans une version antérieure ; les réponses créées alors portent legacy_note_redacted.

rail_rule : le rail seul a décidé. descriptor_rule : le libellé seul. descriptor_sense_rail_mechanism : le libellé donne le sens, le rail le mécanisme, sans conflit. rail_and_descriptor_agree : les deux disent la même chose. descriptor_refines_rail / rail_refines_descriptor : l'un précise l'autre. rail_descriptor_conflict : contradiction, aucune certitude fabriquée (voir signal_conflicts). no_rule : rien ne s'applique. Le suffixe +counterparty_nature dit que la nature de la contrepartie a affiné le type.

Ce que le moteur a compris du rail et du mécanisme de paiement.

Une phrase explicative constante, en français, qui rappelle la différence entre rail et transaction_type. Pas une donnée.

Les signaux qui se contredisent. Quand il y en a, policy.outcome est partial : on refuse de conclure.

Une phrase, en français : comment le conflit a été arbitré.

L'issue de la voie « sous-marchand » (un facilitateur porte l'enseigne réelle). none : voie non ouverte. no_candidate : ouverte, aucune entité. resolved : une entité unique. ambiguous : plusieurs, abstention. Absent sur les réponses les plus anciennes, créées avant que cette voie existe.

L'issue de la voie « libellé tronqué » (la banque a coupé le nom). Mêmes valeurs que submerchant_lane. Absent sur les réponses les plus anciennes, créées avant que cette voie existe.

Le nom est conservé pour ti_v1 ; ce n'est pas une confiance. Chacun de ces nombres est une constante déclarée — posée par la personne qui a écrit le motif ou la règle, et lue telle quelle. Toute transaction qui touche le même motif reçoit le même nombre. Mesuré sur 644 libellés : la précision en fonction du seuil n'est pas monotone — 0,85 donne 0,86 de précision, 0,88 donne 0,33, 0,92 donne 0,25, 0,97 donne 0,79. Ce nombre n'ordonne pas le juste avant le faux. Ne l'utilisez ni comme probabilité ni comme seuil : utilisez policy.outcome. 0 a un sens précis par champ : abstention (entity), rôle inconnu (counterparty), conflit sans ancêtre commun (transaction_type). location vaut toujours 0 : rien n'est résolu sur cet axe dans cette version.

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Des durées, en millisecondes. Rien à voir avec une confiance.

Les versions qui ont produit cette réponse. Un client qui conserve un nombre doit conserver la version à côté : la même valeur, sous une autre version, peut ne plus mesurer la même chose.

L'ontologie du graphe d'entités (onto_v1).

Les règles de type de transaction (txtype_v1).

Le moteur de résolution (ti_v4).

La même valeur que policy.policy_version.

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Le métier, sur deux niveaux (parent puis code). On s'arrête au parent quand la source s'y arrête : un rôle utility dit « réseau » sans dire lequel, et on rend alors utilities, jamais utilities.electricity. Ce qui n'est pas su ne se complète pas.

Ce qui est habituel dans ce métier — pas un verdict sur cette transaction. Un service de streaming se vend par abonnement ; un fournisseur d'électricité facture de façon répétée sans qu'on s'abonne ; un supermarché vend à l'acte. C'est une plausibilité qui renforce un rythme déjà observé dans le workspace. Seul, il ne conclut jamais : commonly_subscription_based sur une transaction isolée ne fait pas un abonnement, et c'est la série (series[].type = subscription) qui tranche.

Les rôles portés par l'entité dans le graphe (merchant, utility, government, financial_institution, payment_intermediary…). Un rôle n'est pas un métier, mais il en dit assez pour en dériver un quand aucun catalogue ne couvre l'entité.

Une marque n'est pas une entité légale. « Netflix » est ce qu'on lit sur le relevé ; « Netflix Inc » est ce qui contracte. Les deux existent séparément dans le graphe, reliés par brand_of, parce que les fusionner ferait disparaître le jour où une marque change de propriétaire. null quand aucune société mère n'est connue — pas quand il n'y en a pas.

Le même espace d'identifiants que counterparty.entity_id : UUID nu, opaque, stable.

D'où vient ce qu'on affirme. nature classe la connaissance par autorité déclarée, dans cet ordre : curated (une personne l'a vérifié), deterministic (dérivé mécaniquement d'un fait déjà tenu), provider (un tiers l'annonce), inferred (nous l'avons déduit), participant (un seul client l'a dit). Cet ordre est déclaré, pas déduit d'un nombre : sans lui, un 0,95 déduit l'emporterait sur un 0,90 vérifié. strength ne départage qu'à nature égale, et n'est pas calibrée. Et aucune connaissance globale ne vient d'un seul client : ce qu'un workspace observe reste dans ce workspace. Une nature participant ne peut jamais devenir une vérité du graphe partagé.

Toujours non_calibree dans cette version, et c'est une contrainte, pas une convention : la valeur est un vocabulaire en base, les colonnes qui la portent y font référence, et une garde refuse tout littéral hors vocabulaire chez chaque producteur. Le jour où une calibration réelle existe, elle entrera par une migration déclarée, avec le corpus qui la défend.

Comment la provenance a été établie. Les clefs varient : derivation (categorie_de_depense_vers_activite, role_vers_activite…), categorie_source ou role, et note, une phrase constante en français. Aucune de ces valeurs n'est un nombre.