Fiche enseignant
Le marché vu du code
- Pour qui
- Développeurs et testeurs, sans formation financière, qui lisent du TypeScript ; à suivre en atelier d’équipe plutôt qu’en cours magistral.
- Prérequis
- Lire du TypeScript : unions discriminées, fonctions pures, tests unitaires.
- Les leçons carnet d’ordres, types d’ordre et fixing du parcours Les mécanismes du marché (/fr/etudiant/).
- Facultatif : le dépôt ouvert pour lire le code du moteur @criee/marche à côté des leçons.
Les séances
Séance 1 · Le domaine, l’ordre et le carnet90 min
- Le domaine en dix objets
- Distinguer un ordre, une exécution et un règlement-livraison dans le code
- Traiter le délai de règlement comme un paramètre, faute de texte qui le fixe
- Expliquer pourquoi numéroter les exécutions rend un import rejouable sans doublon
- Modéliser un ordre
- Modéliser un ordre avec des entiers pour les prix et les quantités
- Distinguer les règles que vérifie le moteur de celles laissées à votre code
- Utiliser une union discriminée et never pour faire signaler un cas oublié
- Le carnet, une structure triée
- Écrire la clé de tri prix puis rang de chaque côté du carnet
- Lire la vue agrégée et la fourchette renvoyées par le moteur
- Estimer le coût d’une insertion, tableau trié ou niveaux et recherche dichotomique
- 10 min · Question d’entrée, réponse écrite : « Quelle différence entre une exécution et un règlement-livraison ? » On compare après la lecture
- 25 min · Lecture de « Le domaine en dix objets » : carte du domaine projetée et métamorphose des objets ; un achat de 40 servi par deux ventes donne combien d’exécutions ? Puis quiz
- 25 min · Lecture de « Modéliser un ordre » : faire proposer des ordres invalides au validateur de la leçon, puis discuter l’union discriminée et le recours à never ; quiz
- 25 min · Lecture de « Le carnet, une structure triée » : écrire au tableau la clé de tri prix puis rang de chaque côté, estimer le coût d’une insertion ; quiz
- 5 min · Synthèse : chacun écrit pourquoi un rang entier remplace l’heure dans la priorité
Séance 2 · Cotation continue, fixing et invariants90 min
- La cotation continue, ligne à ligne
- Suivre la boucle de Carnet.passer ligne à ligne jusqu’au reliquat
- Prévoir le prix d’échange retenu par le moteur en cotation continue
- Expliquer ce que deviennent le reliquat d’un ordre au marché et l’objet de l’appelant
- Le fixing en code
- Calculer la courbe de demande, d’offre et de volume sur les prix candidats
- Appliquer les règles de départage du fixing et lire la règle qui a tranché
- Prévoir qui est servi au prix d’équilibre, selon la priorité de temps
- Les invariants d’un moteur
- Énoncer les six invariants d’un moteur et reconnaître leur violation
- Repérer ce qui menace le déterminisme d’un moteur de cotation
- Exploiter un test par propriétés : rejouer la graine, lire le rétrécissement
- 10 min · Rappel : côté ventes, deux ordres à 10 100 (rangs 2 et 6) et un ordre à 10 050 ; dans quel ordre sont-ils servis ?
- 25 min · Lecture de « La cotation continue, ligne à ligne » : traversée de Carnet.passer, faire prédire le prix d’échange et le reliquat avant de lancer la trace ; quiz
- 25 min · Lecture de « Le fixing en code » : prévoir le fixing avant le moteur, puis traiter le défi de la leçon sur la construction des prix candidats ; quiz
- 25 min · Lecture de « Les invariants d’un moteur » : banc des invariants, rejouer une graine et lire le rétrécissement d’un test par propriétés ; quiz
- 5 min · Synthèse : chacun associe un des six invariants à une ligne de code vue dans la séance
Séance 3 · Tests, protocole FIX et contrôle d’une séance90 min
- Du métier au cas de test
- Traduire une règle métier en cas de test étant donné, quand, alors
- Choisir les cas limites qui mettent une règle à l’épreuve
- Traiter une règle non couverte et interpréter un mutant qui survit
- Cycle de vie d’un ordre et protocole FIX
- Décrire la machine à états d’un ordre et ses transitions interdites
- Reconnaître les messages FIX d’un ordre et leurs valeurs par défaut
- Gérer les numéros de séquence et les doublons d’une session FIX
- Du moteur à MIMS : contrôler une séance
- 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
- 10 min · Rappel : quelle différence entre un test d’exemple et un test par propriétés ?
- 25 min · Lecture de « Du métier au cas de test » : par deux, écrire une règle de priorité en étant donné, quand, alors, choisir ses cas limites, puis le défi du mutant qui survit ; quiz
- 25 min · Lecture de « Cycle de vie d’un ordre et protocole FIX » : machine à états et transitions interdites, voyage d’un message FIX, numéros de séquence et doublons ; quiz
- 25 min · Lecture de « Du moteur à MIMS : contrôler une séance » : bilan de séance, somme des mouvements espèces, choix de la clé qui rend un import idempotent ; quiz
- 5 min · Synthèse : chacun écrit un cas de test qu’il ajouterait à son propre projet
Séance 4 · Modifier, rejouer, comptabiliser90 min
- Modifier et annuler un ordre
- Prévoir l’effet d’une modification d’ordre sur sa priorité de temps
- Écrire une modification avec annuler puis passer, en conservant le rang
- Traiter les retours d’annuler, y compris pour un ordre déjà exécuté
- Journaliser et rejouer une séance
- Reconstruire le carnet à un instant donné en rejouant le journal
- Comparer deux séances par leur empreinte, où l’ordre des exécutions compte
- Expliquer pourquoi le journal et l’instantané doivent garder les rangs
- D’une exécution aux écritures
- Traduire une exécution en mouvements titres et espèces qui portent sa référence
- Vérifier que les mouvements de tous les comptes, commissions comprises, s’annulent
- Corriger une exécution erronée par contre-passation, sans rien effacer
- 10 min · Révision du jour sur /fr/revision/ : chacun traite les questions échues, puis on corrige à voix haute celles que plusieurs ont ratées
- 25 min · Lecture de « Modifier et annuler un ordre » : B réduit de 20 à 10 garde-t-il sa place ? Défi : écrire une modification avec annuler puis passer en gardant le rang ; quiz
- 25 min · Lecture de « Journaliser et rejouer une séance » : reconstruire le carnet à un instant donné, comparer deux séances par leur empreinte ; quiz
- 25 min · Lecture de « D’une exécution aux écritures » : mouvements titres et espèces, somme nulle commissions comprises, correction par contre-passation ; quiz
- 5 min · Synthèse : chacun écrit pourquoi on n’efface jamais une exécution erronée
Séance 5 · Fiches de référence et évaluation60 min
- Fiche : le contrat du moteur
- Retrouver la signature et les garanties de chaque fonction du moteur
- Retrouver les limites connues du moteur pédagogique, chacune à tester
- Fiche : invariants et cas de test
- Retrouver les six invariants et leur traduction en assertions
- Retrouver les cas limites à couvrir et les contrôles après une séance
- 10 min · Rappel : que renvoie fixing() quand aucun prix ne permet d’échange ?
- 15 min · Fiche « le contrat du moteur » : chaque binôme prend une fonction et en présente la signature, les garanties et une limite connue à tester
- 15 min · Fiche « invariants et cas de test » : réciter les six invariants dans l’ordre, puis dresser la liste des contrôles à faire après une séance
- 15 min · Évaluation du parcours sur /fr/developpeur/evaluation/, seul et sans notes : 15 questions tirées des quiz, 11 bonnes réponses pour l’attestation, à imprimer ou à photographier
- 5 min · Synthèse : chacun choisit un invariant à transformer en test dans son code
Conseils
- Le site est un export statique, sans serveur : une page ne se rouvre sans connexion que si le navigateur l’a déjà chargée, et rien ne le garantit. Faites ouvrir les leçons de la séance la veille, avec une connexion, ou projetez-les depuis un poste qui les a déjà affichées.
- Les réponses aux quiz alimentent la révision espacée de /fr/revision/ : une question revient le lendemain, puis après 3, 7, 16 et 35 jours. Ouvrez chaque séance par la révision du jour. La progression reste dans le navigateur de chaque téléphone : un téléphone partagé mélange les résultats, et la navigation privée les efface.
- Les deux fiches finales n’ont pas de quiz : imprimez-les et gardez-les à côté du poste pendant les revues de code. L’évaluation de /fr/developpeur/evaluation/ tire 15 questions des quiz du parcours ; 11 bonnes réponses (70 %) donnent une attestation imprimable, sans valeur de diplôme.
- Les limites connues du moteur pédagogique sont listées dans la fiche du contrat : présentez-les comme des cas à tester, pas comme des défauts à corriger pendant l’atelier.
- Un participant qui bloque sur la leçon 5 gagne à lire d’abord « Calculer un prix de fixing » du parcours étudiant : le code n’y ajoute que la structure, pas la règle.
Corrigés des quiz
61 questions, avec la bonne réponse et son explication.
Le domaine en dix objets
Un ordre d'achat de 40 titres peut produire...
→ zéro, une ou plusieurs exécutions
Un ordre est confronté à autant d'ordres opposés qu'il le faut ; il peut aussi n'en trouver aucun.
Qui transmet l'ordre d'un client au marché de la BVMAC ?
→ une société de bourse agréée
La négociation à la BVMAC relève du monopole des sociétés de bourse agréées par la COSUMAF.
Que modifie le règlement-livraison d'une exécution ?
→ la position et les espèces
Le règlement fait passer les titres chez l'acheteur et l'argent chez le vendeur : position et compte espèces bougent.
Comment coder le délai de règlement-livraison ?
→ comme un paramètre de configuration
Aucun texte trouvé ne fixe ce délai à la BVMAC : un paramètre évite de figer une hypothèse.
Pourquoi numéroter les exécutions à leur sortie du moteur ?
→ pour reconnaître un import déjà rejoué
Sans identifiant, deux imports du même fichier compteraient deux fois les mêmes titres ; un numéro stable sert de clé.
Modéliser un ordre
Comment stocker un prix d'obligation coté 99,50 % ?
→ un entier, 9950, en centièmes
Deux décimales exactes : on compte en centièmes de point, avec un entier.
Dans le type Ordre du moteur, limite vaut null pour...
→ un ordre au marché
L'ordre au marché n'a pas de prix : null encode son absence de limite.
Quelle règle le moteur pédagogique vérifie-t-il lui-même ?
→ la quantité entière, strictement positive
Carnet.passer lève une exception si la quantité n'est pas un entier strictement positif ; le reste est à votre charge.
Le pas de cotation actuel de la BVMAC est...
→ fixé par une instruction
Le règlement renvoie à une instruction de la BVMAC, que nos recherches n'ont pas trouvée.
Que renvoie lireOrdre pour une quantité « 2,5 » et une limite « 10 100,5 » ?
→ les deux erreurs en même temps
La fonction accumule les erreurs avant de répondre : l'utilisateur corrige tout en une fois.
Pourquoi écrire const jamais: never = o dans le default ?
→ le compilateur signale un cas oublié
Si un type d'ordre n'est pas traité, o n'est plus de type never à cet endroit : la compilation échoue.
Le carnet, une structure triée
Côté ventes, quel ordre limité est le meilleur ?
→ le prix le plus bas
Un acheteur préfère payer moins : à la vente, le prix le plus bas est servi en premier.
Pourquoi trierCote donne-t-il un prix infini à l'ordre au marché ?
→ pour le placer devant tous
Un prix fictif infini le place devant tout ordre limité, sans cas particulier dans le comparateur.
Deux achats au même prix : lequel passe devant ?
→ celui du rang le plus petit
À prix égal, la priorité de temps s'applique : le rang d'arrivée le plus petit l'emporte.
Que renvoie fourchette() quand un côté est vide ?
→ un écart égal à null
Sans meilleur achat ou sans meilleure vente, l'écart n'existe pas : le moteur renvoie null.
Dans le moteur, modifier un ordre renvoyé par ordres()...
→ modifie aussi l'ordre du carnet
trierCote copie le tableau mais pas les ordres : l'objet renvoyé est celui du carnet.
Niveaux 10 100, 10 000 et 9 950 côté achats : où indexNiveau place-t-il 10 050 ?
→ à l'indice un
10 050 se range après 10 100 et avant 10 000, donc à l'indice 1.
La cotation continue, ligne à ligne
Pourquoi la boucle peut-elle s'arrêter au premier ordre incompatible ?
→ le côté opposé est trié
Trié du meilleur au moins bon, le côté opposé ne contient plus rien de compatible après le premier refus.
Une vente à 9 950 attend ; un achat à 10 050 arrive. Prix d'échange ?
→ 9 950, le prix présent
Le moteur exécute au prix de l'ordre déjà présent dans le carnet.
Un achat au marché de 20 ne trouve que 12 titres. Les 8 restants...
→ disparaissent sans entrer au carnet
La condition entrant.limite !== null bloque le rangement : le reliquat d'un ordre au marché est abandonné.
Après c.passer(o), que vaut o.quantite pour l'objet de l'appelant ?
→ sa quantité initiale, toujours inchangée
passer copie l'ordre entrant et range une autre copie pour le reliquat : l'objet de l'appelant n'est pas modifié.
Le fixing en code
Pourquoi seules les limites présentes sont-elles des prix candidats ?
→ entre deux limites, rien ne change
Demande et offre cumulées ne bougent qu'aux limites ; un prix intermédiaire n'apporterait aucun volume de plus.
Deux prix donnent le même volume et le même déséquilibre négatif. Le moteur prend...
→ le prix le plus bas
Déséquilibre négatif partout : l'offre excède, la pression pousse vers le bas, donc le prix le plus bas.
Au prix d'équilibre, deux achats ont une limite égale à ce prix. Lequel est servi d'abord ?
→ le plus ancien des deux
À la limite égale au prix, la priorité de temps départage : le rang le plus petit passe devant.
Que vaut regle quand un seul prix maximise le volume ?
→ 'volume'
Le départage s'arrête à la première règle : un seul candidat au volume maximal suffit.
Sans prix de référence, fixing sur deux seuls ordres au marché renvoie...
→ un prix égal à null
Aucune limite, aucun prix de référence : la liste des candidats est vide, donc aucun échange.
Quelle complexité pour calculer la courbe, avec c candidats et n ordres ?
→ O(c × n) opérations
Pour chaque candidat, le moteur filtre tous les ordres d'achat et de vente.
Les invariants d’un moteur
Après un ordre en continu, le meilleur achat vaut 10 050 et la meilleure vente 10 000. Que concluez-vous ?
→ le carnet est croisé, bogue
Un achat à 10 050 et une vente à 10 000 sont compatibles : ils auraient dû s'échanger. L'invariant est violé.
Lequel de ces appels menace le déterminisme d'un moteur ?
→ un appel à Date.now()
L'heure système change d'une exécution à l'autre : deux rejeux du même journal pourraient diverger.
Un test par propriétés échoue sur la graine 137. Que faites-vous d'abord ?
→ vous rejouez la graine 137
La graine rend l'échec reproductible : on rejoue la séance, on la réduit, puis on en fait un test d'exemple.
Le rétrécissement réduit une séance fautive de 12 ordres à 2. Ce résultat est...
→ le plus petit contre-exemple trouvé
Retirer encore un ordre ferait passer le test : c'est un minimum local, prêt à devenir un test d'exemple.
Deux rejeux divergent parce que deux événements du journal ont changé d'ordre. Le moteur est...
→ toujours déterministe malgré tout
Même suite d'entrées, mêmes sorties : ici, la suite d'entrées a changé. C'est le journal qu'il faut ordonner totalement.
Du métier au cas de test
Dans un cas de test, la partie « alors » doit être...
→ un résultat précis et vérifiable
Le « alors » se vérifie par une machine : des valeurs exactes, pas une intention.
Quel cas limite met le mieux à l'épreuve la priorité de temps ?
→ deux ordres au même prix
La priorité de temps ne joue qu'à prix égal : c'est la seule situation qui la révèle.
Le moteur ne gère pas encore les ordres tout ou rien. Que faites-vous du cas ?
→ vous l'écrivez en test todo
Un test en attente garde la règle visible et sert de spécification à la future fonctionnalité.
Un mutant survit à toute votre suite de tests. Cela signifie...
→ aucun test n'observe ce changement
Le mutant change un comportement que personne ne vérifie : il manque un test, ou des données qui isolent la règle.
Cycle de vie d’un ordre et protocole FIX
Quel message FIX porte un nouvel ordre ?
→ NewOrderSingle, de type D
NewOrderSingle (MsgType D) transmet un nouvel ordre ; ExecutionReport (8) en rend compte.
Un NewOrderSingle sans TimeInForce (59) est...
→ un ordre valable jour
Dans FIX Latest, l'absence de TimeInForce vaut ordre jour.
Un ordre passe de « partiellement exécuté » à « reçu ». C'est...
→ une transition interdite
Le cycle de vie avance, il ne revient pas en arrière : la table de transitions doit refuser ce passage.
Dans une session FIX, les numéros de séquence...
→ se suivent depuis 1
La session est une série continue de numéros commençant à 1 ; la couche session prévoit la resynchronisation.
Le même ExecutionReport arrive deux fois après une resynchronisation. Le suivi doit...
→ compter l'exécution une seule fois
Une exécution comptée deux fois fausse la quantité exécutée, puis la position : la passerelle doit ignorer ce qu'elle a déjà vu.
Du moteur à MIMS : contrôler une séance
Une exécution de 30 titres est ventilée pour 35 titres entre deux clients. Que concluez-vous ?
→ une anomalie de ventilation
La somme ventilée doit égaler la quantité exécutée : 5 titres apparaissent de nulle part.
Avant commission, un client achète 40 titres à 10 000. Son compte espèces varie de...
→ moins 400 000 francs
L'achat débite le compte du montant prix × quantité : 40 × 10 000 = 400 000.
Pourquoi un ordre limité à 9 950 n'a-t-il aucun mouvement après un fixing à 10 000 ?
→ sa limite ne croise pas
Un acheteur limité à 9 950 refuse de payer 10 000 : il n'est pas servi, aucun mouvement n'est attendu.
Une exécution n'a été enregistrée que du côté acheteur. Quel contrôle le révèle ?
→ la somme des espèces nulle
L'acheteur est débité sans que personne ne soit crédité : la somme des mouvements espèces n'est plus nulle.
Le même fichier d'exécutions est importé deux fois. La clé de dédoublonnage doit être...
→ la référence de chaque exécution
Deux exécutions distinctes peuvent avoir le même prix et la même quantité ; seule leur référence les distingue sans ambiguïté.
Modifier et annuler un ordre
Un ordre en attente voit sa quantité réduite. Sa priorité de temps...
→ conservée, il garde son rang ancien
Réduire la quantité conserve la priorité ; augmenter la quantité ou changer la limite la fait perdre.
Comment modifier garde-t-il la priorité avec l'API du moteur ?
→ en repassant son ancien rang
passer accepte un rang fourni : repasser l'ordre avec son ancien rang lui rend sa place dans la file.
Que renvoie annuler pour un ordre déjà entièrement exécuté ?
→ false, l'ordre n'est plus là
Un ordre exécuté n'est plus dans le carnet : annuler renvoie false et rien ne change.
Pourquoi valider la nouvelle quantité avant d'appeler annuler ?
→ pour ne pas perdre l'ordre
Si passer lève une exception après annuler, l'ordre a quitté le carnet sans être repassé : il est perdu.
Une limite relevée croise une vente en attente. modifier renvoie...
→ un tableau d'exécutions immédiates
L'ordre repassé est confronté au côté opposé comme tout ordre entrant : il peut s'exécuter aussitôt.
Journaliser et rejouer une séance
Pour reconstruire le carnet à l'instant t, il faut...
→ rejouer les t premiers événements
L'état à l'instant t est le rejeu des t premiers événements du journal sur un carnet neuf.
Pourquoi MoteurJournalise écrit-il le rang dans le journal ?
→ parce qu'aucune API n'expose le compteur
Un carnet restauré repart à 1 : sans rang journalisé, la reprise renumérote les ordres et la priorité change.
Deux séances ont les mêmes exécutions dans un autre ordre. Leurs empreintes...
→ diffèrent, car l'ordre compte
L'empreinte est calculée sur la suite sérialisée : changer l'ordre change le texte, donc l'empreinte.
Un événement du journal se révèle faux. Que faites-vous ?
→ vous ajoutez un événement correctif
Le journal est en ajout seul : on corrige en ajoutant, jamais en réécrivant, comme le bulletin officiel de la cote.
À l'événement 6, la reprise sans rangs donne la même vue. Le rejeu est-il juste ?
→ non, un rang caché diffère
a3 a reçu le rang 1 au lieu de 5 : invisible dans la vue agrégée, la différence sort à l'événement suivant.
D’une exécution aux écritures
Une exécution entre deux clients produit combien de mouvements titres ?
→ deux, de sens opposés
L'acheteur reçoit les titres, le vendeur les livre : deux mouvements de même quantité, de signes opposés.
Une exécution validée se révèle fausse. Que fait le back-office ?
→ il ajoute les mouvements inverses
La contre-passation ajoute les écritures inverses : les soldes reviennent, l'historique garde les deux.
Pourquoi chaque mouvement porte-t-il la référence de son exécution ?
→ pour éviter tout double comptage
La référence sert de clé d'idempotence : une exécution déjà intégrée n'est pas intégrée à nouveau.
Le taux de commission de l'exemple, 0,5 %, est...
→ un simple paramètre fictif du parcours
Aucune source du parcours ne fixe de taux : c'est un paramètre fictif, comme la grille paramétrée de MIMS.
Après commissions, quelle somme de mouvements espèces doit être nulle ?
→ celle de tous les comptes
Les commissions sortent des comptes clients et entrent au compte des commissions : seule la somme globale est nulle.