Aller au contenu
English

Présentation aux parties prenantes

  • Leçon 18
  • 50 min
  • Module 6 : Présenter la proposition

Où nous en sommes

Dans la leçon précédente, nous avons consigné chaque grand choix dans une fiche de décision. Mais Omar, Grace et Ines ne liront pas des fiches et des tableaux : ils ont besoin de réponses à leurs propres questions, en dix minutes. Dans cette leçon, nous préparons une présentation guidée qui dit ce que fait la proposition, son coût, nos hypothèses et les décisions à prendre, comme une mécanicienne qui explique une réparation en cinq minutes.

Ce que vous saurez faire

Expliquez la proposition en dix minutes aux personnes qui décident et à celles qui l’utilisent. Dites ce qu’elle leur apporte, son coût, nos hypothèses, les problèmes possibles et les décisions à prendre. Précisez la nature de chaque nombre.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 50 minutes

Ce que vous devez savoir

Ce qu’il vous faut sur votre ordinateur

  • Votre dossier design-pack de la dernière leçon, où python -m costmodel check affiche 7 of 9 passed (7 vérifications sur 9 réussies).

Testé avec Python 3.12 sur macOS (Apple silicon). Les commandes Windows (PowerShell) et Linux sont fournies, mais n’ont pas été testées.

Vous amenez votre voiture au garage parce que les freins font du bruit. La mécanicienne ne vous montre pas le manuel de réparation. Elle vous dit cinq choses.

« Les plaquettes de frein avant sont usées; des plaquettes neuves élimineront le bruit et rendront la voiture sécuritaire. Ça coûte environ 180 $ US. Les disques semblent corrects, mais je ne vois qu’un côté du disque gauche. S’il est aussi usé, ajoutez environ 120 $ US. Si vous attendez, la distance de freinage risque d’augmenter sur une route mouillée. Voulez-vous que je démonte la roue gauche pour vérifier aujourd’hui? »

En moins d’une minute, vous connaissez l’avantage, le prix et sa fourchette. Vous savez ce qu’elle ne peut pas encore voir, le risque et la seule décision qui vous revient. Vous n’aviez pas besoin de savoir comment fonctionne un frein. Et vous lui faites davantage confiance parce qu’elle a dit ce qu’elle ne pouvait pas voir.

La première version de la présentation de Kwame compte 31 diapositives. Elle montre le tableau des coûts avec 14 facteurs, la loi de Little et les résultats du routage à trois décimales. Elle montre aussi chaque ligne de demand.toml. Kwame répète sa présentation avec Grace.

Le lendemain, Grace dit à Omar : « Le calculateur indique qu’une question coûte 0,000157 $ US. C’est presque rien. » Omar écrit au propriétaire d’une troisième boutique : « Environ 1 950 questions par mois vous coûteraient environ 31 cents. »

Le nombre était juste, mais le message était faux. Le montant de 0,000157 $ US représente seulement le coût variable par question. 87 % du coût mensuel est fixe. La réplique d’API toujours active coûte 27,43 $ US, le serveur de base de données 13,50 $ US et son stockage 4,05 $ US. Ces coûts existent même sans aucune question. Aujourd’hui, un prix juste pour une boutique est plutôt de 26 $ US par mois, environ 84 fois le prix promis. Les diapositives contenaient le bon tableau. Elles ne précisaient pas quel nombre répondait à la question d’Omar, ni sa nature.

L’idée : une présentation fondée sur les questions du public

Section intitulée « L’idée : une présentation fondée sur les questions du public »

Une partie prenante est une personne qui prend des décisions sur le système, le finance ou l’utilise. Dans cette réunion, les parties prenantes de Larkfield sont Omar, qui paie, Grace, dont les agents utilisent l’assistant, et Ines, propriétaire de Bramble Books.

Une présentation guidée est un court exposé oral de la conception destiné à ces personnes, avec quelques images. Ce n’est pas une lecture à voix haute du dossier de conception. Le dossier reste la source de chaque nombre. La présentation choisit les quelques nombres qui répondent aux questions du public. Quatre règles la rendent efficace :

  1. Partez de leurs questions. Omar demande : « Combien ça coûtera par boutique? » Grace demande : « Est-ce rapide et exact? » Ines demande : « Une autre boutique peut-elle voir mes conditions fournisseurs? » Chaque partie de l’exposé répond à une de ces questions.
  2. Précisez la nature de chaque nombre, arrondissez-le et donnez sa fourchette. « Environ 52 $ US par mois, entre 41 et 76 $ US; un calcul fondé sur des temps mesurés, des prix courants et une demande supposée. » Deux chiffres significatifs suffisent pour décider.
  3. Montrez ce que vous ne savez pas. Présentez les hypothèses qui changent le plus la réponse et les risques, chacun avec ce qui limite les dommages.
  4. Terminez par une demande. Une décision que le public prend aujourd’hui, souvent une hypothèse non résolue : une supposition que l’équipe ne peut pas vérifier seule.

Les gens sautent souvent les troisième et quatrième règles, alors que ce sont elles qui renforcent la confiance. On croit la mécanicienne au sujet des plaquettes parce qu’elle dit : « Je ne peux pas voir le disque gauche. »

Prenez cinq lignes de sortie du dossier. Pour chacune, écrivez la phrase que vous diriez à voix haute et précisez sa nature :

Le dossier indique Vous dites Nature
Total 51.90 (scénario de base, mois 0) « Environ 52 $ US par mois pour les deux boutiques. Ça pourrait aller de 41 à 76 $ US. » calcul : temps mesurés × prix courants × demande supposée
per tenant 25.95, mois 12 : 13.97 « Environ 26 $ US par boutique maintenant. Avec quatre boutiques l’an prochain, environ 14 $ US chacune, car elles partagent les coûts fixes. » calcul; les nouvelles boutiques sont supposées
usage x 2 58.82 +13% « Si les gens posent deux fois plus de questions, la facture augmente d’environ 13 %, pas de 100 %. » calcul
chat-strong only 85.8%, chat-small only 86.6% « Le modèle puissant coûte 19 fois plus par question et n’a pas mieux répondu à nos 67 questions. » mesure
tokens/quota 114% (élevé, mois 0) « Si l’assistant apparaît sur la page d’accueil, la minute la plus chargée dépasse le quota actuel du fournisseur de modèles. » calcul à partir d’un quota mesuré et d’une demande supposée

Remarquez ce qui disparaît : la troisième décimale, les unités de jetons, le nom de la loi. Remarquez ce qui reste : la fourchette, la nature du nombre et la comparaison qui lui donne un sens.

Kwame rédige l’exposé en huit parties. Chaque partie a un message, une durée en minutes et une image ou une fiche qui l’appuie.

Huit cases sur deux rangées, les parties de la présentation avec leur durée en minutes. Première rangée : 1 le problème, 1 minute; 2 ce que les gens font, parcours J1 à J5, 1 minute; 3 la conception sur une page, 2 minutes; 4 le coût, environ 52 $ US par mois, 26 $ US par boutique, 2 minutes. Deuxième rangée : 5 ce que nous avons testé, chat-strong coûte 19 fois plus sans être meilleur, 1 minute; 6 hypothèses, ce que nous n'avons pas vérifié, 1 minute, en orange; 7 risques, une seule base de données et le quota du fournisseur, 1 minute, en orange; 8 feuille de route et demande, une question ouverte pour aujourd'hui, 1 minute, avec une bordure épaisse.
La présentation de dix minutes : cinq parties expliquent, deux parties exposent honnêtement les inconnues (en orange), et la dernière demande une décision. Dix minutes au total.
Description textuelle du diagramme

L’exposé compte huit parties en dix minutes. D’abord, le problème en une phrase, une minute. Ensuite, ce que les gens feront, les cinq parcours, une minute. Troisièmement, la conception sur une page, le diagramme de conteneurs, deux minutes. Quatrièmement, le coût : environ 52 $ US par mois, environ 26 $ US par boutique, deux minutes. Cinquièmement, nos tests : le modèle puissant coûte 19 fois plus par question sans être meilleur, une minute. Sixièmement, les hypothèses que nous n’avons pas vérifiées, une minute. Septièmement, les risques : une seule base de données et le quota du fournisseur, une minute. Huitièmement, la feuille de route et la seule question à trancher aujourd’hui, une minute.

La partie sur les coûts exige un graphique, pas le tableau des 14 facteurs. Omar demande le coût « par boutique ». Le graphique montre donc ce coût dans les trois scénarios, maintenant et avec quatre boutiques :

  • maintenant, deux boutiques
  • mois 12, quatre boutiques
Le coût par boutique dans les scénarios faible, de base et élevé : maintenant, avec deux boutiques, et au mois 12, avec quatre boutiques. Calculé par le dossier à partir de temps mesurés, de prix courants et d'une demande supposée. Les coûts fixes sont partagés; le coût par boutique baisse donc quand des boutiques s'ajoutent.
Description textuelle du graphique

Un graphique à colonnes avec trois paires de colonnes, faible, de base et élevé, en dollars US par boutique par mois. Dans chaque paire, la première colonne représente maintenant, avec deux boutiques, et la seconde le mois 12, avec quatre boutiques. Faible : 20,27, puis 10,20. De base : 25,95, puis 13,97. Élevé : 37,90, puis 26,79. Dans chaque scénario, le coût par boutique au mois 12 est inférieur au coût actuel.

Lisez le graphique comme Omar le fera. Le scénario de base coûte environ 26 $ US par boutique maintenant et environ 14 $ US avec quatre boutiques. Même le scénario élevé reste sous 40 $ US par boutique. Le total pour toutes les boutiques reste sous son budget de 150 $ US dans chaque scénario, comme l’a montré Plan de croissance.

La partie sur les hypothèses exige un autre graphique. Les hypothèses n’ont pas toutes la même importance. Le tableau de sensibilité montre de combien chacune change le total :

Variation du total mensuel du scénario de base quand une entrée change. Utilisation : deux fois plus de questions ajoute 13 %. Longueur : des réponses deux fois plus longues ajoutent 6 %. Prix : une hausse de tous les prix de 20 % ajoute 20 %. Modèle : chat-strong pour chaque réponse ajoute 235 %. Calculé par la commande de sensibilité du dossier.
Description textuelle du graphique

Un graphique à quatre colonnes, en pourcentage de variation du total mensuel. Utilisation, deux fois plus de questions : plus 13. Longueur, réponses deux fois plus longues : plus 6. Modèle, chat-strong pour chaque réponse : plus 235. Prix, tous augmentés de 20 pour cent : plus 20. La dernière colonne est environ dix fois plus haute que les autres.

Le message de la partie 6 est donc court. « Nos nombres de demande sont des suppositions, mais une estimation deux fois trop basse ajoute seulement 13 % à la facture. Le choix qui pourrait tripler la facture est celui du modèle, et nous l’avons mesuré. » Voilà une réponse en une image à la crainte de devoir « concevoir pour un million d’utilisateurs ».

Voici le fichier de plan que Kwame conserve dans le dossier, decisions/presentation-outline.md :

# Ten-minute walkthrough (for Omar, Grace and Ines)
1. **The problem in one sentence (1 min).** Several shops want the assistant; each must see only its own documents; Omar needs a price per shop.
2. **What people will do (1 min).** The journeys J1 to J5 and what is out of scope.
3. **The design on one page (2 min).** The container diagram: one application, one database, one model provider. Why not more services yet (ADR-0001).
4. **What it costs (2 min).** Base scenario: about US$52 a month for two shops, about US$26 per shop; low to high: US$41 to US$76. Most of it is fixed (the API replica and the database), so the cost per shop falls as shops join: about US$14 per shop with four shops in month 12. If usage doubles, the total rises about 13%, not 100%.
5. **What we tested (1 min).** The strong model costs 19 times more per question and was not better on our 67 questions (ADR-0003).
6. **Assumptions (1 min).** The numbers we did not verify: customers per day, questions per customer, growth, the cache hit share. The high scenario hits the provider quota in the busiest minute from the first month: the first thing to measure.
7. **Risks and failures (1 min).** The database is a single point of failure; the restore plan (ADR-0005). The provider quota (F1).
8. **The roadmap and what we ask for (1 min).** Release 1 with two shops, the validation work, the signals for each later step. One unresolved assumption to decide today: will customers see the assistant on the home page?
Speak plainly: say "measured", "price" or "assumption" for every number you show.

Regardez la partie 8. « Les clients verront-ils l’assistant sur la page d’accueil? » Kwame ne peut pas répondre à cette question par une mesure. C’est un choix d’affaires d’Omar. Il détermine le scénario à retenir : de base ou élevé. Le scénario élevé exige un quota fournisseur plus grand avant le lancement. La présentation se termine donc par la seule décision que le public peut prendre.

  1. Dans votre dossier design-pack, affichez les nombres pour la partie 4. Ce sont les scénarios de fin de cours :

    Fenêtre de terminal
    python -m costmodel scenarios
    Scenarios (US$ per month)
    low base high
    month 0 40.54 51.90 75.81 (2 tenants)
    per tenant 20.27 25.95 37.90
    month 12 40.79 55.86 107.17 (4 tenants)
    per tenant 10.20 13.97 26.79
  2. Affichez les nombres pour la partie 6 :

    Fenêtre de terminal
    python -m costmodel sensitivity
    Sensitivity (base scenario, month 0)
    what if US$/month change per question per tenant
    base 51.90 +0% 0.001181 25.95
    usage x 2 58.82 +13% 0.000669 29.41
    answers 2x longer 54.98 +6% 0.001251 27.49
    chat-strong for every answer 173.99 +235% 0.003959 86.99
    all prices +20% 62.28 +20% 0.001417 31.14

    Regardez la colonne « per question » (par question). Quand l’utilisation double, le coût total par question baisse : de 0,001181 $ US à 0,000669 $ US. Voilà pourquoi un coût par question ne veut rien dire sans son volume.

  3. Copiez le plan à partir de l’instantané end-of-m06.

    Fenêtre de terminal
    S=../nextia-learning-labs/C26/snapshots/end-of-m06
    cp "$S/decisions/presentation-outline.md" decisions/
  4. Vérifiez chaque nombre du plan dans les deux sorties. Arrondissez chacun de tête. 51,90 devient « environ 52 » et 25,95 devient « environ 26 ». De 40,54 à 75,81 devient « de 41 à 76 », et 13,97 devient « environ 14 ».

  5. Lancez la vérification :

    Fenêtre de terminal
    python -m costmodel check
    PASS requirements: journeys, out of scope, measurable quality attributes
    PASS demand: every value has evidence (verified or assumed)
    PASS prices: every price has its source
    PASS measured: every value names its run
    PASS architecture: every component has a job, an owner and a place on the diagram
    PASS decisions: every ADR has status, context, options, decision, consequences, revisit
    PASS failures: at least 5, each with owner, mitigation and signal
    FAIL roadmap: every ADR appears in the roadmap: decisions/roadmap.md does not exist yet
    PASS presentation: assumptions, risks and an unresolved assumption
    Design pack check: 8 of 9 passed

    La vérification de présentation cherche trois mots dans le plan : « Assumptions » (hypothèses), « Risks » (risques) et « unresolved » (non résolu). Elle ne peut pas juger la qualité de votre exposé. Elle vérifie seulement la présence des deux parties honnêtes et de la demande.

Une présentation guidée comprend autant de questions que d’exposé. Kwame prépare les trois questions que Tomás a posées pendant le cours, car Omar les posera aussi. Chaque réponse comporte un nombre et une phrase :

Question Réponse Source
« Ne devrait-on pas concevoir pour un million d’utilisateurs? » « À la minute la plus chargée du scénario de base, 0,58 requête est en cours. La première limite est le quota du fournisseur, qu’une conception plus grande ne change pas. » charge de travail, plan de croissance
« Ce n’est pas environ un cent par question? » « Seule la part du modèle est par question : 0,000157 $ US. Tout compris, c’est environ 0,0012 $ US aujourd’hui. Ce coût baisse quand l’utilisation augmente, car 87 % est fixe. » unités
« N’avons-nous pas besoin de Kubernetes et d’un service de base de données vectorielle? » « Pas encore. Une application et PostgreSQL suffisent à cette échelle; chaque fiche indique le signal qui justifierait un changement. » ADR-0001, ADR-0002

Et une question à laquelle seule l’équipe peut répondre honnêtement : « À quel point êtes-vous sûrs? » Kwame répond : « Les temps du modèle, la qualité et les nombres de jetons sont mesurés. Les prix sont les prix courants; ils changent. La demande est notre estimation, et nous la présentons sous forme de fourchette. Le temps de restauration reste une estimation jusqu’au premier test. »

Quand donner une telle présentation et ce qu’elle coûte

Section intitulée « Quand donner une telle présentation et ce qu’elle coûte »

Donnez-en une avant toute décision qui exige de l’argent ou des personnes hors de l’équipe : lancement, nouvelle boutique, nouveau modèle. Dix minutes et un fichier de plan coûtent peu comparativement à une semaine de travail sur la mauvaise conception.

Adaptez-la à chaque public. Un exposé pour des développeurs peut montrer la loi de Little et les facteurs de coût. Un exposé pour une propriétaire de boutique doit traiter de son prix, de sa vie privée et de sa qualité. Le dossier est le même; les questions ne le sont pas.

Ce qu’elle coûte : l’exposé cache volontairement des détails; le public ne peut donc pas vérifier chaque nombre pendant la réunion. C’est pourquoi chaque nombre du plan renvoie au dossier ou à une fiche. Après la réunion, n’importe qui peut ouvrir decisions/ et vérifier les raisons.

Erreur courante

Aucune hypothèse non résolue

Symptôme : vous avez remplacé la dernière phrase de la partie 8 par « Prochaines étapes : commencer à construire. » La vérification échoue :

FAIL presentation: assumptions, risks and an unresolved assumption: presentation-outline.md does not mention 'unresolved'
Design pack check: 7 of 9 passed

Cause : l’exposé se termine maintenant comme si toutes les entrées étaient connues. Le public repart sans prendre la seule décision qui change la conception. La question de la page d’accueil revient après le lancement, sous forme de problème de quota.

Correction : terminez par la question ouverte et la raison de son importance. Par exemple : « Une hypothèse non résolue à trancher aujourd’hui : les clients verront-ils l’assistant sur la page d’accueil? Si oui, il nous faut un quota fournisseur plus grand avant le lancement. »

Erreur courante

Une précision qui semble être une certitude

Symptôme : une diapositive indique « Coût mensuel : 51,90 $ US ». Omar inscrit 51,90 $ US au budget. Après le premier mois, la facture est de 58 $ US, et il demande ce qui a mal tourné.

Cause : deux décimales ressemblent à une mesure. Le nombre est un calcul fondé sur une demande supposée, et sa propre fourchette va de 40,54 à 75,81 $ US.

Correction : arrondissez-le et donnez sa fourchette et sa nature : « environ 52 $ US, entre 41 et 76 $ US, calculés avec une demande supposée ». Une facture de 58 $ US respecte alors le plan, et le journal d’utilisation montre quelle hypothèse a changé.

Changez une condition : le public. Ines, propriétaire de Bramble Books, ne peut pas venir à la réunion. Elle vous accorde trois minutes au téléphone. Elle pose trois questions : « Combien ça me coûtera? Larkfield ou une autre boutique peuvent-ils voir mes conditions fournisseurs? Répondra-t-il correctement à mon personnel? »

Rédigez pour elle un plan en trois parties, avec un nombre par partie et sa nature. Utilisez le dossier. python -m costmodel units donne la part du coût de Bramble Books. Terminez par une chose encore inconnue pour sa boutique.

Afficher une solution détaillée

python -m costmodel units affiche, dans le scénario de base, au mois 0 :

Unit economics, scenario base, month 0
total US$ 51.90 per month (fixed 87%, variable 13%)
per question (variable only) US$ 0.000157
per question (everything) US$ 0.001181
per document change US$ 0.000169 (embed + summary + worker)
Larkfield US$ 29.10 per month
Bramble Books US$ 22.80 per month
  1. Votre coût (1 min). « Environ 23 $ US par mois pour Bramble Books aujourd’hui. C’est la moitié des coûts fixes plus vos propres questions. Le calcul utilise des temps mesurés, des prix courants et notre estimation de vos 65 questions par jour. Quand deux autres boutiques s’ajouteront, votre part baissera, car les coûts fixes seront partagés entre quatre boutiques. »
  2. Votre vie privée (1 min). « Une autre boutique ne peut pas voir vos documents. Chaque ligne de la base de données porte l’identifiant de votre boutique. La base ne montre à chaque requête que les lignes de sa propre boutique. Le cours sur l’authentification a mesuré cette vérification à environ 0,1 ms par requête. Un test d’accès s’exécute à chaque changement, et la mise en production s’arrête s’il échoue. »
  3. Votre qualité (1 min). « Sur les 67 questions de Larkfield, 86,6 % des réponses étaient correctes : c’est une mesure. Nous n’avons pas encore mesuré vos questions. Priya créera un jeu d’évaluation pour vos conditions fournisseurs lors de la première mise en production. D’ici là, nous ne savons pas dans quelle mesure l’assistant répond correctement à votre personnel. C’est la partie non résolue pour votre boutique. »

La réponse sur la vie privée ne mentionne aucun prix ni modèle. Elle répond à sa vraie inquiétude par le mécanisme et un test. Et la dernière partie dit clairement ce qui reste inconnu et quel travail permettra de le mesurer.

Vérifiez votre compréhension

Pourquoi dire « environ 52 $ US par mois, entre 41 $ US et 76 $ US » plutôt que « 51,90 $ US »? Donnez deux raisons.

Afficher la réponse

D’abord, 51,90 $ US est un calcul fondé sur une demande supposée, pas une mesure. Deux décimales donnent une impression d’exactitude, et les auditeurs planifieront avec ce chiffre. Ensuite, la fourchette indique à quel point le résultat peut varier, du scénario bas au scénario haut. Une facture ultérieure dans cette fourchette est alors attendue, plutôt qu’un échec. Le nombre arrondi est aussi plus facile à retenir et à répéter correctement.

Vérifiez votre compréhension

Prédisez : au mois 12 du scénario de base, avec quatre magasins, le coût total par question dépasse-t-il 0,001181 $ US? Expliquez avec les chiffres du dossier.

Afficher la réponse

Il diminue, pour atteindre environ 0,000808 $ US. Le total passe seulement de 51,90 $ US à 55,86 $ US, car 87 % du coût est fixe. Le nombre de questions passe de 1 465 à 2 304 par jour. Les coûts fixes se répartissent maintenant sur plus de questions. Chaque question en supporte donc une plus petite part.

Vérifiez votre compréhension

Omar dit : « Sautons la diapositive sur les hypothèses. Ça donne l'impression qu'on n'est pas sûrs. » Que répondez-vous, en trois ou quatre phrases?

Afficher la réponse

Sans les hypothèses, les auditeurs considèrent chaque chiffre comme certain, et la première facture différente ressemble à une erreur. Avec elles, ils savent quelles données surveiller, et une facture dans la fourchette est attendue. Le graphique de sensibilité montre aussi que les estimations de demande comptent peu : doubler l’utilisation ajoute seulement 13 %. Et la seule hypothèse importante, la page d’accueil, est une décision que seul Omar peut prendre. L’omettre lui cacherait son propre choix.

Récapitulatif

  • Une partie prenante prend des décisions sur le système, le finance ou l’utilise. Une présentation guidée répond à ses questions en environ dix minutes, avec quelques images; le dossier reste la source des chiffres.
  • Quatre règles : partez de leurs questions; arrondissez chaque nombre, donnez sa fourchette et sa nature; montrez vos inconnues; terminez par une demande.
  • Le coût variable par question seul induit en erreur : 0,000157 $ US contre environ 26 $ US par magasin, car 87 % du coût est fixe.
  • La présentation guidée de Larkfield compte huit parties. Elle montre le coût par magasin : environ 26 $ US maintenant, environ 14 $ US avec quatre magasins. Elle montre aussi le graphique de sensibilité : utilisation ×2 ajoute 13 %, chat-strong 235 %.
  • Elle se termine par une hypothèse non résolue : les clients verront-ils l’assistant sur la page d’accueil?
  • python -m costmodel check affiche maintenant 8 of 9 passed (8 vérifications sur 9 réussies).

Ensuite, vous transformez les décisions en un ordre de travail, en commençant par une petite version que les gens peuvent utiliser.

Leçon suivante : Feuille de route de mise en œuvre