Travail final
- Après les études de cas
- environ 3 h
Où nous en sommes
Dans ce cours, vous avez transformé une demande pour « un assistant d'IA pour plusieurs boutiques » en une proposition que d'autres peuvent vérifier : des besoins, une architecture tracée, un coût avec ses raisons, des options mesurées, des plans pour les défaillances et la croissance, et des décisions écrites. Maintenant, les locataires, la demande et les décisions sont les vôtres. Dans ce travail, vous rédigez votre propre proposition d'architecture et de coûts pour un petit assistant documentaire multilocataire.
Ce que vous saurez faire
Rédigez votre propre proposition d’architecture et de coûts pour un petit assistant documentaire multilocataire, des besoins au plan d’exploitation. Vous utilisez le dossier de conception de ce cours, mais toutes les entrées sont les vôtres : locataires, demande, cibles et décisions. Un réviseur doit pouvoir vérifier chaque nombre et suivre chaque flux. Il doit voir ce que vous feriez en cas de défaillance ou de croissance.
Avant de commencerCe qu’il faut savoir et avoir sous la main
- Vous avez terminé les modules 1 à 6. Chaque partie ci-dessous nomme les leçons qu’elle utilise.
- Vous n’avez pas besoin des études de cas pour ce travail. Le certificat en exige au moins une : Plan de coûts et de capacité à partir de données de demande réelles ou Revue de conception d’un service ouvert de questions sur des documents. Les deux utilisent le même dossier dans une nouvelle situation. Chacune constitue donc une bonne préparation à ce travail.
- Le dossier : votre dossier
design-packà la fin du module 6, ou l’instantanéend-of-m06(voir les instantanés). Copiez-le dans un nouveau dossier, par exemplemy-proposal, pour garder votre dossier de cours intact. Créez un nouvel environnement virtuel dans ce nouveau dossier, comme dans Préparer le dossier de conception. - Python 3.12 ou une version plus récente, comme dans le cours. Aucun compte, appel de modèle ou paiement n’est nécessaire. Vous réutilisez les valeurs mesurées et la liste de prix du cours; vous n’en mesurez pas de nouvelles.
- Vous pouvez travailler en plusieurs séances. Exécutez
python -m pytest -qetpython -m costmodel checkaprès chaque partie.
La situation
Section intitulée « La situation »Choisissez les locataires de votre assistant. Vous avez deux options :
- Votre propre cas : un petit groupe d’organisations qui partageraient un assistant documentaire. Par exemple, trois écoles d’un district, les succursales d’une petite entreprise ou quelques magasins utilisant le même outil de soutien. Chaque locataire a ses propres documents et utilisateurs. Aucun locataire ne doit voir les documents ou les réponses d’un autre.
- Le scénario du cours, Willowmere Libraries (construit pour ce travail) : trois bibliothèques municipales partagent un assistant. Chaque bibliothèque téléverse ses propres documents : règles de prêt, règles de réservation des salles et guides de ses activités. Le personnel pose des questions au comptoir, et les membres en posent sur le site Web de chaque bibliothèque. La plus grande bibliothèque compte environ 12 employés et 900 visiteurs lors d’une journée chargée. Les deux petites comptent chacune 3 employés et environ 150 visiteurs. Une quatrième bibliothèque pourrait se joindre au groupe l’an prochain. Tous les nombres de ce scénario sont inventés : traitez chacun comme une hypothèse et donnez-lui une plage.
Quel que soit votre choix, écrivez deux phrases en haut de votre proposition : qui sont les locataires et quelle décision elle appuie. Par exemple : « Construire un assistant pour les trois bibliothèques. Combien coûte-t-il par bibliothèque, et que devons-nous surveiller? »
Partie 1 : besoins mesurables
Section intitulée « Partie 1 : besoins mesurables »Utilise Utilisateurs et flux de travail, Attributs de qualité et Hypothèses de demande.
- Réécrivez
requirements.mdpour vos locataires : les personnes, leurs principaux parcours (au moins quatre) et les éléments exclus du périmètre. Donnez une raison pour chaque élément. - Formulez les attributs de qualité comme des cibles, chacune accompagnée d’une méthode de mesure. Couvrez la latence (un SLO avec un percentile), la disponibilité, la confidentialité entre locataires, l’auditabilité et la maintenabilité. Couvrez aussi la reprise (RTO et RPO) et le budget. Indiquez qui a approuvé chaque cible, ou précisez qu’il s’agit de votre hypothèse.
- Réécrivez
demand.tomlpour vos locataires : personnel, clients ou membres, questions par personne, documents, modifications des documents et croissance. Donnez à chaque valeur une plage (basse, de base, haute) et ses preuves, marquéesverified:(vérifié) ouassumed:(supposé). Avec le scénario Willowmere, presque tout estassumed:; expliquez pourquoi chaque plage a cette largeur. - Exécutez
python -m costmodel demandetpython -m costmodel demand --month 12. Expliquez l’heure et la minute les plus chargées que le dossier calcule. Précisez d’où vient le profil de pointe : si vous gardez les valeurs du cours, indiquez qu’elles proviennent d’une autre charge de travail.
Partie 2 : flux de données et de requêtes cohérents
Section intitulée « Partie 2 : flux de données et de requêtes cohérents »Utilise Limites des services, Flux de données et d’identité et Simplicité et évolution.
- Mettez à jour
architecture/components.tomlet le diagramme de conteneurs : chaque partie a une tâche, un responsable et des données conservées. Si votre conception garde les huit parties du cours, expliquez pourquoi elles conviennent à vos locataires. - Décrivez le flux de requête d’une question et la séquence d’ingestion d’un document. Incluez le temps mesuré de chaque étape provenant de
measured.toml. - Décrivez le flux de données et d’identité. Montrez où circule le locataire : jeton, transaction de base de données, clé de cache, ligne de tâche et chemin de fichier. Suivez une question d’un locataire et un document d’un autre locataire, en montrant chaque valeur. Faites comme dans le petit exemple de Flux de données et d’identité.
- Exécutez
python -m costmodel components. Chaque composant doit figurer sur le diagramme.
Partie 3 : feuille de calcul des coûts transparente
Section intitulée « Partie 3 : feuille de calcul des coûts transparente »Utilise Calculer la charge de travail, Modèle de coûts, Économie unitaire, Routage entre modèles, Cache et traitement par lots et Construire ou acheter.
- Vérifiez
design.toml: le modèle, la proportion de réponses trouvées dans le cache, les répliques et la taille de la base de données. Modifiez chaque valeur qui ne convient pas à vos locataires et justifiez-la. - Exécutez
workload,costs,units,scenariosetsensitivity, pour le scénario de base et le scénario haut. Exécutez ensuitepython -m costmodel exportet gardezcosts.csvcomme feuille de calcul. - Étiquetez chaque nombre cité : mesure, prix ou hypothèse. Écrivez « Les prix changent : consultez la page actuelle » à côté des coûts.
- Répondez avec des nombres aux trois questions que Tomás a posées dans le cours, pour vos locataires. Combien de requêtes sont en cours à la minute la plus chargée? Combien coûte une question, en coûts variables seulement et tous frais compris, et pourquoi ces deux coûts diffèrent-ils? Si l’utilisation double, le coût par locataire double-t-il?
- Recalculez à la main une ligne du tableau des coûts à partir de ses entrées. Par exemple, choisissez les jetons de réponse ou le serveur de base de données. Montrez que le résultat égale celui du dossier.
Partie 4 : compromis, défaillances et plan d’exploitation
Section intitulée « Partie 4 : compromis, défaillances et plan d’exploitation »Utilise Scénarios de défaillance, Objectifs de reprise, Plan de croissance, Décisions d’architecture, Présentation aux parties prenantes et Feuille de route de mise en œuvre.
- Comparez au moins deux conceptions avec une même charge de travail, une même vérification de qualité et une même liste de prix. Faites comme dans l’exercice du module de Construire ou acheter. Incluez le temps des personnes lorsqu’il diffère. Indiquez les preuves de qualité dont vous disposez : le résultat de routage du cours provient d’un autre ensemble de questions.
- Rédigez
decisions/failure-modes.mdpour votre conception : au moins cinq défaillances. Pour chacune, indiquez ce que voient les utilisateurs, un signal de détection avec un seuil, une mesure d’atténuation, un responsable et la reprise. Nommez le point unique de défaillance et une mesure d’atténuation proportionnée, avec son prix. - Inscrivez vos cibles de reprise et les temps des étapes dans
design.toml, puis exécutezpython -m costmodel recovery. Indiquez quels nombres un test de restauration doit mesurer. - Exécutez
python -m costmodel growthetpython -m costmodel growth --scenario high. Décrivez les étapes de croissance, chacune avec son signal et son seuil. Indiquez quel seuil est franchi en premier, et quand. - Rédigez au moins trois fiches de décision. Chacune présente les options écartées, un coût et un déclencheur de réexamen que quelqu’un peut interpréter aujourd’hui.
- Rédigez
decisions/roadmap.md: une première version utilisable avec un critère d’achèvement, les travaux de validation classés selon ce qu’ils pourraient changer, puis les étapes suivantes, chacune conditionnée par un signal. - Rédigez
decisions/presentation-outline.md: une présentation de dix minutes aux responsables de vos locataires. Utilisez des nombres arrondis avec leurs plages et leurs catégories, les risques et une hypothèse non résolue. - Exécutez
python -m costmodel check. La commande doit afficherDesign pack check: 9 of 9 passed(vérification du dossier de conception : 9 sur 9 réussies).
Erreur courante
Les tests échouent après la modification des entrées
Symptôme : python -m pytest -q échoue après la réécriture de demand.toml ou de design.toml. Cela arrive, par exemple, dans test_the_pack_demand_counts_verified_and_assumed ou dans les tests de croissance.
Cause : certains tests du cours vérifient les résultats propres à Larkfield. Par exemple, ils vérifient le nombre de valeurs de demande vérifiées ou le premier signal atteint. Vos locataires donnent d’autres résultats. Les tests qui vérifient une règle doivent toujours réussir, comme « requêtes simultanées = taux d’arrivée × temps dans le système ».
Solution : modifiez chaque test qui échoue pour qu’il vérifie votre propre résultat, et justifiez le changement en une ligne. Ne supprimez pas un test qui vérifie une règle. Si un tel test échoue, votre entrée ne respecte pas le modèle : lisez le message et corrigez l’entrée.
Éléments à remettre
Section intitulée « Éléments à remettre »Votre dossier de proposition (sans .venv), avec requirements.md, demand.toml, design.toml, architecture/, decisions/, costs.csv, les tests et PROPOSAL.md :
# <your tenants>: architecture and cost proposal## The decision (two sentences: the tenants and what the proposal supports)## Requirements (journeys, out of scope, quality attributes with targets and how measured, demand ranges with verified and assumed values)## Architecture and flows (container diagram, request flow, ingestion sequence, where the tenant travels)## Cost worksheet (workload, cost by driver, unit costs, scenarios, sensitivity, one line by hand, every number labelled measured, price or assumption)## Trade-offs (designs compared under one workload, decision records)## Failure and recovery (failure table, single point of failure, RTO and RPO, the restore test)## Growth and operating plan (signals and lines, the first limit, the roadmap)## Assumptions and limits (the assumption that would change the recommendation; what is not measured)Comment le travail est évalué
Section intitulée « Comment le travail est évalué »Un réviseur évalue chaque élément requis comme démontré, partiellement démontré ou pas encore démontré, avec une raison concrète. Pour terminer le cours, vous devez démontrer les quatre éléments. Vous pouvez améliorer un élément et le soumettre à nouveau.
| Élément requis | Démontré | Partiellement démontré, par exemple | Pas encore démontré, par exemple |
|---|---|---|---|
| Besoins mesurables | Les parcours et la liste des exclusions conviennent aux locataires. Chaque attribut de qualité a une cible, une période et une méthode de mesure. La demande est une plage par locataire. Chaque valeur indique si elle est vérifiée ou supposée, avec une raison. | Les cibles existent, mais l’une n’a aucune méthode de mesure (« rapide »). Ou la demande est un nombre unique sans plage. | Les services sont choisis avant les parcours. Ou il n’y a aucune cible, seulement des adjectifs. |
| Flux de données et de requêtes cohérents | Chaque partie du diagramme a une tâche et un responsable. Le flux de requête et la séquence d’ingestion utilisent les mêmes parties et les temps mesurés. Le locataire accompagne chaque flux : jeton, transaction, clé de cache, tâche et chemin de fichier. | Les flux existent, mais la clé de cache ou la tâche en arrière-plan ne contient pas le locataire. Ou une partie apparaît dans un flux, mais pas sur le diagramme. | Aucun flux ne montre comment les données d’un locataire restent séparées. Ou les flux contredisent le diagramme. |
| Feuille de calcul des coûts transparente | Les sorties du dossier et costs.csv donnent le coût par facteur, par question et par locataire, dans trois scénarios, avec sensibilité. Chaque nombre est étiqueté comme mesure, prix ou hypothèse. Une ligne est recalculée à la main et concorde. Les trois questions de Tomás reçoivent des réponses chiffrées. |
Les coûts sont corrects, mais certains nombres n’ont pas de catégorie. Ou seul le scénario de base est présenté. | Un coût par question sans son volume et sa part fixe. Ou un nombre que le réviseur ne peut pas relier à une entrée. |
| Analyse des compromis et des défaillances | Les conceptions sont comparées avec une même charge de travail, vérification de qualité et liste de prix, avec le temps des personnes. Le tableau des défaillances indique les responsables, les signaux et la reprise. Le point unique de défaillance a une mesure d’atténuation proportionnée, avec son prix. Les RTO et RPO proviennent du dossier, et le test de restauration est planifié. Le plan de croissance nomme la première limite. Chaque fiche de décision a un déclencheur de réexamen. La feuille de route renvoie à chaque fiche, et check (vérification) affiche 9 sur 9. |
Le tableau contient des défaillances, mais certains responsables sont « l’équipe », ou certains signaux sont des plaintes. Ou une fiche de décision n’a aucun déclencheur interprétable. | Aucune analyse des défaillances. Ou la conception ajoute des services ou de la haute disponibilité sans nombre pour les justifier. |
Même si le reste est solide, la proposition reste incomplète si un flux transmet la réponse d’un locataire à un autre. Elle reste aussi incomplète si un coût est présenté sans ses hypothèses. Un beau diagramme ne compense pas une clé de cache sans locataire. Un total précis ne compense pas une hypothèse cachée.
Les résultats du cours peuvent vous aider à juger les vôtres, mais ce ne sont pas des cibles. Pour les deux magasins de Larkfield, le scénario de base coûtait 51,90 $ US par mois, dont 87 % de coûts fixes. Doubler l’utilisation ajoutait 13 %, et 0,58 requête était en cours à la minute la plus chargée. La première limite était le quota du fournisseur, atteint dès le mois 0 du scénario haut. Vos locataires sont différents, donc vos nombres le seront aussi.
Récapitulatif
Dans ce cours, vous avez transformé une demande d’« assistant d’IA pour plusieurs magasins » en une proposition vérifiable par d’autres :
- Les besoins d’abord : parcours, cibles mesurables et demande sous forme de plages, chaque nombre étant vérifié ou supposé.
- Une architecture simple et traçable : une application modulaire et une base de données, avec le locataire dans chaque flux.
- Des coûts justifiés : calcul de charge, tableau des coûts par facteur, économie unitaire et sensibilité. Ils reposent sur des temps mesurés, des prix affichés et des hypothèses déclarées.
- Des options mesurées, pas devinées : modèle puissant, cache, traitement par lots, construction ou achat, chacun avec un nombre.
- Défaillances et croissance planifiées : responsables, cibles de reprise, restauration testée et signaux avec des seuils.
- Des décisions écrites : fiches avec déclencheurs de réexamen, présentation avec une question ouverte et feuille de route qui commence modestement.
Si vous n’en avez pas encore fait, choisissez une étude de cas pour le certificat : Plan de coûts et de capacité à partir de données de demande réelles ou Revue de conception d’un service ouvert de questions sur des documents.