Aller au contenu
Criée

Du moteur à MIMS : contrôler une séance

Des exécutions aux positions et aux espèces : ce qu’un testeur vérifie après une séance.

Leçon 912 min

À la fin de cette leçon

  • Suivre une séance du moteur jusqu’aux mouvements des comptes clients
  • Contrôler la ventilation et la somme des espèces pour révéler une anomalie
  • Choisir la clé qui rend idempotent l’import d’un fichier d’exécutions
Dans cette leçon4

Le moteur s'arrête aux exécutions. Pour une société de bourse, la journée continue : chaque exécution doit se rattacher aux ordres de ses clients, faire bouger leurs positions et leurs comptes espèces, puis se dénouer chez le dépositaire central. Tester MIMS après une séance, c'est vérifier que cette chaîne ne crée ni ne perd rien.

La chaîne, écran par écran

D'une séance aux comptes, dans MIMS

1/6Ordres

Le registre des ordres (/fr/orders) liste les ordres saisis, contrôlés par le Middle Office avant transmission.

La même chaîne, vue par l'ordre : un ordre fictif traverse les écrans, change de statut, reçoit deux exécutions à deux prix différents, puis devient une position. Regardez la barre d'exécution : elle avance à l'arrivée de chaque exécution, jamais à la validation.

La vie d’un ordre dans MIMS1/8
/fr/orders/new
client
C-0042
titre
KAPOK
sens
achat
quantité
40
limite
10 100
C-0042
40 × 10 100
saisi

exécuté 0/40

/fr/orders/new

Saisie de l’ordre

Le Front Office saisit l’ordre du client fictif C-0042 ; les contrôles pré-négociation s’affichent pendant la saisie.

Deux règles du marché encadrent cette chaîne. Tout ordre est horodaté dès sa réception et transmis à la BVMAC « sans compensation ni globalisation » (RG BVMAC 2025, art. 150) : chaque exécution doit donc se rattacher à des ordres clients identifiables. Et les négociations sont au comptant : l'ancien règlement exigeait que l'acheteur dispose des fonds et le vendeur des titres dès la passation de l'ordre (RG BVMAC 2008, art. 30).

Rejouez une séance et contrôlez-la

Deux sociétés de bourse fictives, six clients inventés, un fixing. Avancez pas à pas : exécutions du moteur, puis mouvements par client, puis contrôles. Les commissions sont laissées de côté : elles ne viennent pas du moteur.

Après la séance : ce que vérifie le testeurfixing 10 000 · 60
ordreclientdemandétitresespèces
K-01AwaSDB Kapok+40 × 10 100··
K-02BertrandSDB Kapok-30 × 9 900··
K-03ChantalSDB Kapok+20 × marché··
B-01DidierSDB Baobab-50 × 10 000··
B-02EstherSDB Baobab-20 × 10 100··
B-03FabriceSDB Baobab+30 × 9 950··

Remarquez trois détails que le testeur doit savoir expliquer :

  • Didier vendait 50 titres à 10 000, exactement le prix du fixing, et n'en vend que 30 : Bertrand, plus agressif à 9 900, est servi en totalité d'abord, et Didier reçoit le reste.
  • Chantal, avec un ordre au marché, est servie la première, bien qu'arrivée après Awa.
  • Esther et Fabrice n'ont aucun mouvement : leurs limites ne croisent pas le prix.

De mémoire : avant toute commission, que vaut la somme de tous les mouvements espèces d'une séance, toutes sociétés de bourse confondues ?

La liste du testeur

Après une séance, pour chaque titre :

  1. Ordres : quantité exécutée inférieure ou égale à la quantité de l'ordre ; état cohérent avec cette quantité.
  2. Ventilation : la somme ventilée d'une exécution égale sa quantité, ni plus ni moins.
  3. Positions : variation de chaque position = titres achetés − titres vendus du client, exécution par exécution.
  4. Espèces : variation = montants des ventes − montants des achats − commissions ; aucun solde négatif sans découvert autorisé.
  5. Marché : titres achetés = titres vendus ; somme des espèces nulle avant commissions.
  6. Cours : le prix retenu correspond à celui que publie le Bulletin officiel de la cote, qui donne notamment premier et dernier cours, plus haut et plus bas (RG BVMAC 2025, art. 132).
  7. Rejeu : importer deux fois le même fichier d'exécutions ne doit rien compter deux fois.

Ces contrôles sont des invariants au sens de Les invariants d'un moteur : ils doivent tenir après chaque séance, quelles que soient les entrées. Testez-les donc comme tels, sur des séances générées, pas seulement sur celle du jour.

Qui règle, et quand ? La BEAC assure le rôle de dépositaire central à titre transitoire depuis 2019 (RA BVMAC 2024). Le futur dépositaire central unique n'était pas opérationnel fin 2025, et son statut actuel n'est pas confirmé. Aucun texte trouvé ne fixe le délai de règlement-livraison : dans les tests, traitez-le comme un paramètre.

Plus loin

Le contrôle « somme nulle », en code

Les contrôles 3 à 5 s'écrivent en quelques lignes, à partir des seules exécutions. Reprenez la séance rejouée plus haut :

import { fixing, type Execution } from '@criee/marche'

const r = fixing(ordres, 10000) // les six ordres de la séance ci-dessus
// r.prix 10000, r.volume 60
// [{ achat: 'K-03', vente: 'K-02', prix: 10000, quantite: 20 },
//  { achat: 'K-01', vente: 'K-02', prix: 10000, quantite: 10 },
//  { achat: 'K-01', vente: 'B-01', prix: 10000, quantite: 30 }]

const mouvements = r.executions.flatMap((e: Execution) => [
  { ordre: e.achat, titres: e.quantite, especes: -e.prix * e.quantite },
  { ordre: e.vente, titres: -e.quantite, especes: e.prix * e.quantite },
])
const somme = (k: 'titres' | 'especes') => mouvements.reduce((s, m) => s + m[k], 0)

expect(somme('titres')).toBe(0)
expect(somme('especes')).toBe(0)

Pas à pas : chaque exécution donne deux mouvements opposés, donc la somme vaut zéro par construction. Ce test ne vérifie rien du moteur ; il vérifie votre traduction. Il devient utile quand les mouvements viennent d'ailleurs : d'un import, d'une saisie, d'une validation par lot. Remplacez mouvements par ce que le progiciel a réellement produit, et le même test attrape une exécution enregistrée d'un seul côté. Remarquez aussi la première ligne : Chantal (K-03), servie au marché, passe avant Awa (K-01) jusque dans les mouvements.

Importer deux fois sans compter deux fois

Le contrôle 7 cache un choix de conception : la clé de dédoublonnage. La clé sûre est la référence de l'exécution, telle que le fichier la transmet.

function importer(registre: Map<string, Execution>, lignes: { ref: string; e: Execution }[]): number {
  let ajoutees = 0
  for (const { ref, e } of lignes) {
    if (registre.has(ref)) continue // déjà importée
    registre.set(ref, e)
    ajoutees++
  }
  return ajoutees
}

const registre = new Map<string, Execution>()
importer(registre, fichier) // 3   (les trois exécutions de la séance)
importer(registre, fichier) // 0   (rien n'est compté deux fois)

Piège. Une clé tirée du contenu (prix, quantité, ordres) semble pratique, mais deux exécutions distinctes peuvent porter le même prix et la même quantité : la seconde serait perdue sans erreur. Cas limite. Dans un fichier, « 1.500 » peut se lire 1 500 ou 1,5 selon le séparateur : la lecture des nombres vue dans Modéliser un ordre doit connaître le format du fichier, sinon une quantité est divisée par mille en silence.

La leçon D'une exécution aux écritures poursuit la chaîne : comment une exécution validée devient mouvements, commissions et écritures.

De mémoire, leçon 1 : quelle relation entre un ordre et ses exécutions, et que change la ventilation ?

À toi de jouer

Une exécution de 30 titres est ventilée pour 35 titres entre deux clients. Que concluez-vous ?

1Une exécution de 30 titres est ventilée pour 35 titres entre deux clients. Que concluez-vous ?

Avant commission, un client achète 40 titres à 10 000. Son compte espèces varie de...

2Avant commission, un client achète 40 titres à 10 000. Son compte espèces varie de...

Pourquoi un ordre limité à 9 950 n'a-t-il aucun mouvement après un fixing à 10 000 ?

3Pourquoi un ordre limité à 9 950 n'a-t-il aucun mouvement après un fixing à 10 000 ?

Une exécution n'a été enregistrée que du côté acheteur. Quel contrôle le révèle ?

4Une exécution n'a été enregistrée que du côté acheteur. Quel contrôle le révèle ?

Le même fichier d'exécutions est importé deux fois. La clé de dédoublonnage doit être...

5Le même fichier d'exécutions est importé deux fois. La clé de dédoublonnage doit être...

À lire ensuite : Règlement général de la BVMAC (2025)

Une question ? Posez-la à votre enseignant, ou à un assistant IA en lui donnant le titre de cette leçon.

Partager :WhatsAppLinkedIn

Pour aller plus loin