Dossier de l'enseignant · v1.0
Enseigner avec Holarch : dossier de l'enseignant
Des acquis d'apprentissage et six devoirs avec grilles d'évaluation pour un cours semestriel d'ingénierie système ou de MBSE, tous construits sur le modèle de référence MBSE ouvert EO-1 v1.1, un CubeSat 6U fictif d'observation de la Terre. Gratuit sous CC BY 4.0.
Télécharger le dossier de l'enseignant v1.0
Tous les fichiers (.zip, 17 Ko)
Des fichiers Markdown qui s'ouvrent dans n'importe quel éditeur. Utilise le modèle de référence EO-1 v1.1. Licence : CC BY 4.0, mention « Holarch ».
Sur cette page
- Contenu
- Mode d'emploi
- Notes de corrigé
- Acquis d'apprentissage
- A1 · Tracer un besoin
- A2 · Reprise et revue des exigences
- A3 · Trouver les lacunes de couverture
- A4 · Étendre l'architecture
- A5 · Traiter la modification
- A6 · Plan de validation
- Enseigner SysML v2 avec Holarch : ce qui est contrôlé et ce qui est seulement conservé
- Téléchargements
- Versions
- Comment le citer
- Licence
Contenu
| Fichier | Pour | Contenu |
|---|---|---|
learning-outcomes.md | Enseignants, dossiers d'accréditation | Les acquis d'apprentissage du cours, les devoirs qui évaluent chacun d'eux et les fonctionnalités de Holarch utilisées. |
assignments/A1-trace-a-need.md à A6-validation-plan.md | Étudiants (à distribuer) | Six devoirs sur EO-1, chacun avec contexte, tâche, livrables et grille d'évaluation. |
sysml-v2-teaching-boundaries.md | Enseignants | Ce que les projets SysML v2 de Holarch contrôlent, ce qu'ils conservent sans l'interpréter, et ce qui n'est pas encore disponible. |
Mode d'emploi
- Donnez à chaque groupe sa propre copie d'EO-1 v1.1. Dans Holarch : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat EO-1, ou téléchargez
eo-1-v1.1.holarch.jsondepuis holarch.app/reference-models/eo-1/ et importez-le avec Gérer les projets → Fichiers de projet ▾ → Importer un projet…. Chaque devoir part du modèle tel qu'il est livré. - Menez le cours dans une organisation de cours. Ajoutez chaque devoir avec sa date limite sous Paramètres de l'organisation → Revue de la classe → + Nouveau devoir. Revue de la classe conserve une version de chaque projet de groupe à chaque date limite et montre le travail de chaque étudiant.
- Pour A2, rejoignez chaque projet de groupe en tant que Relecteur : vous pouvez commenter, approuver, rejeter et rouvrir des exigences, et rien d'autre.
- Pour A6, les étudiants partent du modèle intégré Verification and Validation Plan. Pour leur donner une version allégée avec vos propres consignes, enregistrez-en une comme modèle d'organisation (Rédiger ▾ → Modèles ▸ Enregistrer comme modèle…, Enregistrer dans : Organisation) et faites-en le modèle par défaut pour Test Plan Document.
- Fixez les pondérations, la taille des groupes et les dates limites de votre cours. Les pondérations indiquées sont des suggestions.
Les devoirs citent des pages de Holarch, mais chaque question peut aussi trouver sa réponse dans les fichiers CSV d'EO-1, si bien que les étudiants qui travaillent dans un autre outil peuvent participer.
Notes de corrigé
Les notes de corrigé, avec les constats attendus, des exemples de réponses et les erreurs courantes pour A1 à A6, ne sont pas publiées, afin que les étudiants ne puissent pas télécharger les réponses. Les enseignants les téléchargent dans Holarch : Paramètres de l'organisation → Revue de la classe → Télécharger les notes de corrigé. Le bouton s'affiche pour les administrateurs (enseignants et assistants d'enseignement) d'une organisation dotée du statut de classe.
Acquis d'apprentissage
Cours : Model-Based Systems Engineering, un semestre, fin de licence ou première année de master.
À la fin du cours, les étudiants sont capables de :
| # | Acquis | Évalué par | Fonctionnalités Holarch utilisées |
|---|---|---|---|
| LO1 | Distinguer les besoins des parties prenantes des exigences système, et tracer chaque besoin vers les exigences qui le formalisent. | A1, partiel | Statements, relations traced to, section Traçabilité de la Vue Élément, Matrice de traçabilité |
| LO2 | Rédiger des exigences nécessaires, unitaires, non ambiguës et vérifiables, avec une méthode de vérification et des critères de réussite. | A2, partiel | Attributs des exigences, Qualité, TBD/TBR |
| LO3 | Mener un cycle de revue et d'approbation sur des exigences, et répondre aux commentaires de revue par des modifications du modèle. | A2, participation à la revue | Rôle de relecteur, Approbations (Approuver, Rejeter…, Rouvrir), commentaires avec mentions |
| LO4 | Analyser la couverture de traçabilité et de vérification, et décider pour chaque lacune si c'est le modèle ou l'exigence qui est erroné. | A3 | Matrice de traçabilité, RVTM, contrôles du modèle |
| LO5 | Décomposer des fonctions, définir une architecture logique, allouer les fonctions aux éléments logiques et physiques, et dériver les interfaces qui en découlent. | A4, examen final | Diagrammes d'action et FFBD, Assets, allocation, Registre des interfaces |
| LO6 | Évaluer l'impact d'une modification d'exigence à travers le modèle, et enregistrer une décision pour chaque élément concerné. | A5, examen final | Liens à revoir, analyse d'impact, Demandes de modification, Références et versions |
| LO7 | Planifier la vérification et la validation : les distinguer, choisir des méthodes, rédiger des procédures de test et de validation dans les bons termes, et lire une RVTM. | A6, examen final | Cas et suites de test, Centre de test, RVTM et VCRM, modèles de documents |
| LO8 | Produire des livrables d'ingénierie à partir du modèle et les maintenir cohérents avec lui : documents et matrices figés dans une référence et exportés pour revue. | A2, A6, examen final | Documents, matrices dynamiques, références, export Word et Excel |
| LO9 (facultatif) | Lire et écrire la notation textuelle SysML v2 pour un sous-système, et indiquer quelles propriétés un outil a contrôlées et lesquelles il s'est contenté de conserver. | Partie facultative de A6 | Projet SysML v2, contrôles de l'Éditeur, note pédagogique sur SysML v2 |
Correspondance avec les devoirs
| Acquis | A1 Tracer un besoin | A2 Reprise des exigences | A3 Lacunes de couverture | A4 Architecture | A5 Impact d'une modification | A6 Plan de validation |
|---|---|---|---|---|---|---|
| LO1 | ● | ○ | ○ | |||
| LO2 | ● | ○ | ||||
| LO3 | ● | |||||
| LO4 | ○ | ● | ○ | |||
| LO5 | ● | |||||
| LO6 | ● | |||||
| LO7 | ○ | ○ | ○ | ● | ||
| LO8 | ○ | ● |
● acquis principal évalué, ○ y contribue aussi.
Notes pour l'enseignant
- Les acquis décrivent une compétence en ingénierie système, pas une maîtrise d'outil. Holarch est le lieu où les étudiants s'exercent ; les fichiers CSV d'EO-1 permettent à un étudiant de démontrer chaque acquis sans lui.
- Les acquis suivent la pratique courante de l'ingénierie système, par exemple les processus techniques de l'ISO/IEC/IEEE 15288 : définition des besoins et exigences des parties prenantes, définition des exigences système, définition de l'architecture, vérification et validation. Mettez-les en correspondance avec les critères d'accréditation de votre programme comme l'exige votre établissement.
A1 · Tracer un besoin
Acquis : LO1 (principal), LO4, LO7 · Taille du groupe : individuel · Pondération suggérée : 8 %
Contexte
Le client d'EO-1, une société d'analyse agricole, a exprimé trois besoins. N2 Twice-Weekly Revisit s'énonce ainsi : « Farm customers need fresh imagery of their fields at least twice a week in the growing season. » Un besoin n'est satisfait que lorsque les exigences qui le formalisent sont satisfaites par la conception et vérifiées, et que le besoin lui-même est validé avec le client.
Tâche
- Suivez N2 à travers le modèle : les exigences vers lesquelles il est tracé, leurs enfants, les fonctions et composants qui satisfont chacune d'elles, et les cas de test qui les vérifient, avec le statut de chaque test.
- Représentez la chaîne sous forme de tableau ou de petit diagramme : une ligne ou une case par élément, avec son numéro, son nom, son statut et la relation qui le relie.
- Trouvez l'activité de validation de N2 et son statut.
- Répondez : quelles preuves manquent encore pour que N2 soit considéré comme validé ? Listez chaque élément manquant, l'élément du modèle auquel il appartient, et ce qui permettrait de le combler.
- Cherchez des exigences qui soutiennent N2 sans lui être tracées. Nommez une candidate et argumentez pour ou contre l'ajout de la trace. Ne l'ajoutez pas au modèle.
Dans Holarch : ouvrez N2 dans la Vue Élément et lisez sa section Traçabilité, puis utilisez Vérification → Matrice de traçabilité, Vérification → RVTM et Vérification → Centre de test. Sans Holarch : eo-1-v1.1-traceability.csv et eo-1-v1.1-rvtm.csv.
À remettre
Une note d'une à deux pages (Word ou PDF) avec la chaîne, les preuves manquantes et votre réponse à l'étape 5. Ne modifiez pas le modèle pour ce devoir.
Grille d'évaluation
| Critère | 4 Exemplaire | 3 Maîtrisé | 2 En progrès | 1 Débutant |
|---|---|---|---|---|
| Chaîne complète et correcte (40 %) | Chaque élément de N2 jusqu'aux tests, avec les bonnes relations et les bons statuts, y compris les deux enfants et l'activité de validation. | Un élément ou un statut manquant ou erroné. | La chaîne s'arrête aux exigences ou oublie une exigence fille. | Éléments listés sans leurs relations. |
| Preuves manquantes (35 %) | Nomme chaque lacune (tests non exécutés, un parent sans vérification propre, des exigences pas encore approuvées, la validation non exécutée, l'enfant sans fonction) et ce qui comble chacune. | La plupart des lacunes, avec ce qui les comble. | Liste les lacunes sans dire ce qui les comble. | Dit seulement « des tests manquent ». |
| Vérification ou validation (15 %) | Distingue les deux tout du long : les exigences sont vérifiées, le besoin est validé. | Une erreur. | Considère qu'un test réussi valide le besoin. | Aucune distinction. |
| Trace candidate (10 %) | Une exigence précise, avec une argumentation raisonnée dans un sens ou dans l'autre. | Un candidat avec une argumentation mince. | Un candidat sans argumentation. | Absent. |
A2 · Reprise et revue des exigences
Acquis : LO2 (principal), LO3, LO8 · Taille du groupe : groupe · Pondération suggérée : 10 %
Contexte
Trois exigences d'EO-1 sont encore à l'état de brouillon et obtiennent 44 % au contrôle qualité de Holarch :
- 2.5 Safe Mode Recovery : « The spacecraft should recover from safe mode quickly and resume imaging as appropriate »
- 3.5 Battery Thermal Control : « The thermal design shall keep the battery warm enough (TBD). »
- 6.4 Operator Interface : « The operator interface shall be user friendly and/or easy to use. »
La 3.5 a aussi un problème ouvert, ISS-3 Battery heater set point not chosen, et un commentaire de revue du comité de revue de conception, RID-1 No cold-case analysis for the battery heater.
Tâche
- Pour chacune des trois, listez ce qui la rend faible, mot par mot lorsque c'est important.
- Réécrivez chacune dans le projet de groupe : un seul « shall », une condition mesurable, et un point de départ ou une condition explicite lorsqu'une durée ou une plage est en jeu. Remplacez chaque TBD par une valeur et consignez sa justification, ou conservez un TBR avec un responsable et une date. Pour la 3.5, expliquez comment votre réécriture répond à ISS-3 et RID-1.
- Renseignez la Méthode de vérification, le Niveau de vérification et les Critères de réussite de chacune.
- Tracez chacune vers son origine (un besoin, une exigence parente ou une source) et vers la fonction qui la satisfait. S'il n'existe aucune fonction, nommez la fonction manquante.
- Passez chacune à En revue. Votre enseignant les examine en tant que relecteur. Répondez à chaque commentaire dans le modèle (modifiez l'exigence, ou répondez en donnant une raison), puis résolvez le commentaire.
- Enregistrez une référence du document EO-1 System Requirements Specification (SRS-001) nommée « A2 handed in » et exportez-la vers Word.
Dans Holarch : Besoins et exigences → Qualité, l'inspecteur de l'exigence, Besoins et exigences → Approbations, et dans le document Version ▾ → Enregistrer la référence… et Livrer ▾ → Spécification (Word).
À remettre
L'export Word, plus une note d'une demi-page sur les faiblesses trouvées à l'étape 1. Le modèle tel qu'il se présente à la date limite est noté avec.
Grille d'évaluation
| Critère | 4 Exemplaire | 3 Maîtrisé | 2 En progrès | 1 Débutant |
|---|---|---|---|---|
| Exigences réécrites (40 %) | Les trois sont unitaires, mesurables et vérifiables ; conditions et points de départ explicites ; valeurs justifiées. | Une exigence comporte encore un terme vague ou une condition manquante. | Valeurs ajoutées, mais conditions ou justification manquantes. | Formulation modifiée, toujours invérifiable. |
| Attributs de vérification (20 %) | La méthode, le niveau et les critères de réussite conviennent à chaque exigence et pourraient être appliqués tels qu'écrits. | Une incohérence, par exemple Test là où seule l'Analyse est possible. | Méthodes renseignées, critères de réussite vagues. | Absent. |
| Traçabilité (15 %) | Chacune tracée vers sa source et sa fonction qui la satisfait, ou la fonction manquante nommée. | Une trace manquante. | Sources uniquement. | Aucune. |
| Cycle de revue (15 %) | Chaque commentaire de revue a reçu une réponse dans le modèle et est résolu ; les exigences rejetées ont été retravaillées et soumises à nouveau. | Un commentaire laissé ouvert. | Commentaires traités sans modification du modèle. | Commentaires ignorés. |
| Analyse des faiblesses (10 %) | Précise : nomme chaque terme vague et explique pourquoi il ne peut pas être vérifié. | Générale mais correcte. | Reprend le score de qualité. | Absent. |
A3 · Trouver les lacunes de couverture
Acquis : LO4 (principal), LO1, LO2, LO7 · Taille du groupe : groupe · Pondération suggérée : 10 %
Contexte
EO-1 en est à sa revue critique de conception. Le modèle est volontairement imparfait : certaines exigences ne sont satisfaites par aucune fonction, certaines n'ont aucun test, certains tests ont échoué, et une équation n'est reliée à rien.
Tâche
Travaillez à partir du modèle tel qu'il est livré en v1.1. Utilisez une nouvelle copie si votre projet de groupe a changé.
- Listez chaque exigence qu'aucune fonction ne satisfait.
- Listez chaque exigence qu'aucun cas de test ne vérifie, et celles dont les tests ont échoué, avec le problème ouvert et toute dérogation enregistrée à leur encontre.
- Listez les exigences sans composant qui les satisfait. Décidez lesquelles en ont besoin et lesquelles sont à juste titre satisfaites au niveau de la mission ou du segment.
- Trouvez les éléments du modèle vers lesquels rien n'est tracé. Indice : regardez les équations de puissance.
- Pour chaque lacune, décidez : manque-t-il quelque chose au modèle (une fonction, un composant, un test, un lien), ou l'exigence est-elle inutile ou mal rédigée ? Donnez une phrase de raisonnement par lacune.
- Comblez trois lacunes de votre choix dans le projet de groupe, chacune sous la forme d'une modification identifiable dans Contrôle et revues → Activité.
Dans Holarch : Vérification → Matrice de traçabilité, Vérification → RVTM, Vérification → Contrôles du modèle et Risques, problèmes et décisions → Problèmes et actions. Sans Holarch : eo-1-v1.1-traceability.csv (sa colonne Coverage), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv et eo-1-v1.1-deviations-waivers.csv.
À remettre
Un tableau des lacunes (lacune, élément, décision, justification, comblée oui ou non) en Excel ou Word, et la liste des trois modifications effectuées.
Grille d'évaluation
| Critère | 4 Exemplaire | 3 Maîtrisé | 2 En progrès | 1 Débutant |
|---|---|---|---|---|
| Lacunes trouvées (35 %) | Toutes les lacunes de fonctions, de tests, de composants et d'éléments orphelins, y compris les tests en échec avec leurs problèmes et leur dérogation. | Une ou deux lacunes manquées. | Seuls les brouillons évidents trouvés. | Moins de la moitié. |
| Décisions (35 %) | Chaque lacune reçoit une décision défendable ; distingue la conception manquante des exigences inutiles ou mal délimitées et de la satisfaction au niveau de la mission. | La plupart des décisions sont fondées. | Chaque lacune est traitée par « ajouter un lien ». | Aucune décision. |
| Modifications effectuées (20 %) | Trois modifications qui comblent réellement des lacunes, chacune constituant une étape nette dans l'historique. | Deux bonnes modifications. | Des modifications qui masquent une lacune, comme un lien ajouté sans raison. | Aucune. |
| Présentation (10 %) | Le tableau est triable et complet. | Omissions mineures. | Difficile à suivre. | Absent. |
A4 · Étendre l'architecture
Acquis : LO5 (principal), LO4 · Taille du groupe : groupe · Pondération suggérée : 12 %
Contexte
L'architecture logique d'EO-1 (L0) ne couvre que les tranches alimentation et gestion des données : de L1 Power Generation à L6 Fault Management. Chaque élément logique regroupe des fonctions (allocated to) et est réalisé par une partie physique (related to) ; par exemple, F3.1 Convert Sunlight to Power est allouée à L1, et 1.3.1 Solar Arrays réalise L1. La détermination et le contrôle d'attitude disposent des fonctions F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels et F4.4 Unload Wheel Momentum, et de parties physiques sous 1.2 ADCS, mais d'aucune couche logique.
Tâche
- Ajoutez sous L0 des éléments logiques pour la détermination et le contrôle d'attitude. Chaque élément énonce son objet sans nommer de matériel.
- Allouez-leur F4.1 à F4.4, et reliez chaque élément logique aux parties physiques sous 1.2 ADCS qui le réalisent, selon le modèle de L1 à L6.
- Dessinez le diagramme d'action de F4 avec les items qui circulent entre ses sous-fonctions, par exemple l'estimation d'attitude et les commandes de couple, si votre projet de groupe n'en a pas encore.
- À partir des flux qui franchissent les frontières des éléments, dérivez les interfaces. Comparez-les aux interfaces existantes IF-06, IF-16, IF-17 et IF-18 : lesquelles correspondent, lesquelles manquent, et lesquelles transportent des items qu'aucune fonction n'utilise ?
- Vérifiez que 2.1 à 2.4 sont chacune satisfaites par la fonction qui fait le travail, et indiquez quel élément logique est alors responsable de chaque exigence.
Dans Holarch : Architecture → Assets, Comportement → Diagrammes Action (F4), la section Traçabilité de l'inspecteur pour les allocations, Interfaces → Registre des interfaces, et le préréglage Hiérarchie d'allocation du diagramme de hiérarchie. Sans Holarch : eo-1-v1.1-allocation-chain.csv et eo-1-v1.1-icd.csv.
À remettre
Une courte description d'architecture (deux à trois pages, Word ou PDF) : les éléments logiques avec leur finalité, le tableau d'allocation (fonction → élément logique → partie physique), le diagramme d'action F4 et la comparaison des interfaces.
Grille d'évaluation
| Critère | 4 Exemplaire | 3 Maîtrisé | 2 En progrès | 1 Débutant |
|---|---|---|---|---|
| Éléments logiques (25 %) | Indépendants de la solution, cohérents, chacun avec une finalité claire ; aucun nom de matériel. | Un élément nomme du matériel ou mélange des objets. | Les éléments recopient les parties physiques. | Absents ou flous. |
| Allocation (30 %) | Chaque sous-fonction allouée une fois au bon élément ; éléments réalisés par des parties ; cohérent dans le modèle. | Une allocation discutable. | Allocations uniquement à des parties, en sautant la couche logique. | Incomplète. |
| Flux et interfaces (30 %) | Interfaces déduites des flux qui traversent les frontières ; comparaison précise avec IF-06, IF-16, IF-17 et IF-18, y compris les écarts dans les deux sens. | Comparaison globalement juste. | Interfaces listées, non dérivées. | Absent. |
| Responsabilité des exigences (15 %) | Chacune des exigences 2.1 à 2.4 tracée via sa fonction jusqu'à un élément logique, incohérences nommées. | Une manquante. | Listées sans vérification. | Absent. |
A5 · Traiter la modification
Acquis : LO6 (principal), LO7 · Taille du groupe : groupe · Pondération suggérée : 10 %
Contexte
Après la revue de conception, l'exigence 3.1 Orbit Average Power est passée de 28 W à 30 W de puissance moyenne par orbite en fin de vie. Le cas de test TC-06 Solar Array Power Test a été réussi par rapport à l'ancienne valeur. Holarch a marqué les liens de 3.1 à revoir.
Tâche
- Listez chaque élément que la modification atteint : en aval via les liens partant de 3.1, en amont vers ce dont 3.1 dérive, et les éléments qui mentionnent l'ancienne valeur sans lien vers 3.1. Indiquez comment vous avez trouvé chacun.
- Pour chaque élément, rédigez la question que pose la modification, votre constat (avec des chiffres lorsque le modèle en contient) et une décision : aucune modification (marquer le lien comme revu avec un commentaire), mise à jour, ou remontée au comité de modifications.
- Décidez quoi faire de TC-06 : un test réussi à 28 W prouve-t-il encore 30 W ? Montrez le calcul à partir des équations du modèle.
- Trouvez un élément que l'analyse fondée sur les liens manque et expliquez pourquoi il compte.
- Consignez vos décisions dans le projet de groupe : un commentaire sur chaque lien marqué comme revu, une demande de modification pour ce que le comité doit décider, et une référence avant et après.
Dans Holarch : Besoins et exigences → Liens à revoir, l'analyse d'impact depuis 3.1 (Ouvrir dans ▾ → Spider, puis Impact), la section Traçabilité de l'inspecteur, les équations de puissance EQ-1.1 à EQ-1.4 et TPM-2 (Architecture → Budgets et TPM), Contrôle et revues → Demandes de modification et Contrôle et revues → Références et versions. Sans Holarch : eo-1-v1.1-traceability.csv et eo-1-v1.1-change-impact-3.1.csv, le dossier d'impact publié ; faites d'abord votre propre analyse, puis comparez.
À remettre
Un dossier d'impact (un tableau : élément, comment il a été atteint, question, constat, décision, statut) et une recommandation d'un paragraphe au comité de modifications.
Grille d'évaluation
| Critère | 4 Exemplaire | 3 Maîtrisé | 2 En progrès | 1 Débutant |
|---|---|---|---|---|
| Portée (30 %) | Éléments trouvés en aval, en amont et par recherche textuelle, y compris ceux qu'aucun lien n'atteint. | Liens uniquement, tous. | Quelques liens en aval. | 3.1 et TC-06 seulement. |
| Constats chiffrés (30 %) | Utilise les valeurs et équations du modèle ; le déficit de TC-06 est calculé et expliqué. | Chiffres globalement justes. | Qualitatif uniquement. | Conclusions erronées. |
| Décisions (25 %) | Chaque élément a une décision adaptée au constat ; liens marqués comme revus uniquement avec une raison ; points relevant du comité traités à part. | Une décision faible. | Marque des liens comme revus sans justification. | Aucune décision. |
| Traces dans le modèle (15 %) | Commentaires, demande de modification et références en place et cohérents avec le dossier. | Une manquante. | Seulement le document. | Rien dans le modèle. |
A6 · Plan de validation
Acquis : LO7 (principal), LO8, LO1 · Taille du groupe : groupe · Pondération suggérée : 10 %
Contexte
La vérification demande si EO-1 a été bien construit par rapport à ses exigences ; la validation demande s'il s'agit du bon système pour les clients agricoles. La suite de validation d'EO-1, TS-3 Mission Validation, contient VAL-01 Customer Alert Pilot (pour N1, non exécuté), VAL-02 Growing Season Revisit Simulation (pour N2, non exécuté) et VAL-03 Agronomist Map Review (pour N3, réussi).
Commencez le plan dans Besoins et exigences → Documents → + Nouveau document. Sous Modèle, réglez Modèles pour sur Test Plan Document et choisissez le modèle intégré Verification and Validation Plan avec Inclure les consignes de rédaction, ou le modèle d'organisation que votre enseignant a publié pour ce devoir.
Tâche
- 5.1 Scénarios opérationnels : rédigez le scénario de VAL-01 dans les termes du client : qui fait quoi, quel jour, avec quel résultat. Nommez le besoin qu'il met en œuvre.
- 5.2 Users and Participants : nommez les utilisateurs représentatifs et ce que chacun décide.
- 5.3 Environnement de validation : décrivez l'environnement, en quoi il diffère de l'exploitation, et ce que cette différence signifie pour le résultat.
- Rédigez les critères d'acceptation de VAL-01 de sorte qu'un client puisse répondre oui ou non sans jugement d'ingénieur, et consignez-les dans le Résultat attendu du cas de test.
- 8 Verification Status : lisez la matrice dynamique. Prenez le test en échec TC-04 Pointing Accuracy Test et dites ce que signifierait le résultat de VAL-01 si TC-04 est toujours en échec au moment du pilote.
- Exportez le plan vers Word.
Facultatif : bonus SysML v2 (LO9, jusqu'à 10 % supplémentaires)
Créez un projet SysML v2 à partir de eo-1-v1.1-power-subsystem.sysml (Gérer les projets → Fichiers de projet ▾ → Importer des fichiers SysML v2…). Le fichier contient encore l'exigence 3.1 à 28 W. Passez la puissance moyenne par orbite requise à 30 W, la modification de A5, et lisez ce que signale l'Éditeur. S'agit-il d'une erreur de modélisation ou d'un constat de conception ? Modifiez ensuite les valeurs de conception, et non l'exigence, jusqu'à ce que la ligne d'état de l'Éditeur indique Aucun problème, et dites si vos nouvelles valeurs sont physiquement crédibles. En une demi-page, indiquez lesquelles de vos affirmations l'outil a contrôlées et lesquelles il a seulement conservées ; la note pédagogique sur SysML v2 que partage votre enseignant liste les deux.
À remettre
- L'export Word du plan.
- Pour le bonus SysML v2 : le fichier
.sysmlet la demi-page.
Grille d'évaluation
| Critère | 4 Exemplaire | 3 Maîtrisé | 2 En progrès | 1 Débutant |
|---|---|---|---|---|
| Scénario dans les termes du client (30 %) | Concret, tiré du quotidien, sans jargon d'ingénieur ; met clairement en jeu N1. | Clair, avec un peu de jargon. | Une procédure de test, pas un scénario. | Absent ou générique. |
| Critères d'acceptation (25 %) | Observables, par oui ou par non, du ressort du client ; liés au « on the day of an overpass » de N1. | Globalement observables. | Seuils d'ingénierie uniquement. | Vagues. |
| Participants et environnement (20 %) | Utilisateurs représentatifs nommés avec leurs décisions ; écarts avec l'exploitation et leur effet indiqués. | Une manquante. | Listés sans effet. | Absent. |
| Raisonnement V&V (15 %) | Explique pourquoi un pilote de validation peut réussir ou échouer indépendamment de TC-04 et ce que signifie chaque issue. | Globalement fondé. | Confond vérification et validation. | Absent. |
| Livrable (10 %) | Export Word propre, consignes du modèle remplacées par le contenu. | Restes de consignes. | Partiellement exporté. | Absent. |
| Bonus SysML v2 (jusqu'à +10 %) | Constat expliqué ; Aucun problème, avec des valeurs crédibles ; énoncé précis de ce qui a été contrôlé et de ce qui a été conservé. | Aucun problème ; énoncé général. | Exigence affaiblie au lieu de modifier la conception, ou problèmes restants. | Aucun point. |
Enseigner SysML v2 avec Holarch : ce qui est contrôlé et ce qui est seulement conservé
Les projets SysML v2 de Holarch prennent en charge un sous-ensemble de la spécification SysML v2 de l'OMG. L'état actuel de chaque domaine figure sur la page de couverture du langage SysML v2 (holarch.app/sysml-v2-coverage/) ; consultez-la avant chaque semestre. Lorsque vous enseignez le langage avec Holarch, distinguez trois types d'énoncés, afin que les étudiants ne prennent pas une limite de l'outil pour une règle du langage, ni une construction que l'outil a conservée pour une construction qu'il a contrôlée :
- Contrôlé : l'Éditeur analyse la construction et la contrôle pendant la saisie, et les vues et pages l'utilisent. Lorsque la ligne d'état de l'Éditeur indique Aucun problème, ces contrôles ont réussi.
- Conservé, non interprété : analysé et conservé exactement tel qu'écrit, dans le texte et dans les exports, mais sans signification attribuée. Aucun problème ne dit rien de sa justesse.
- Pas encore dans Holarch : la construction ou la fonctionnalité n'est pas disponible dans Holarch. Elle reste du SysML v2 valide.
Contrôlé : à enseigner et à évaluer en toute sécurité avec l'outil
| Domaine | Ce que l'Éditeur détecte de manière fiable pour les étudiants |
|---|---|
| Syntaxe | Caractères, commentaires, chaînes, accolades, ;, noms et jetons attendus. |
| Noms et imports | Noms non résolus, ambigus, en double et privés ; imports de membres, d'espaces de noms, récursifs et filtrés. |
| Définitions, usages, spécialisation | part, attribute, port, action, state, requirement et les autres genres et leurs définitions ; typage, sous-ensemble, redéfinition et conjugaison ; cycles et mauvais genre de définition. |
| Multiplicités, valeurs et unités | Bornes valides ; grandeurs avec les natures de grandeurs ISQ et les unités SI et usuelles américaines ; contrôles de dimension : une puissance là où une masse est attendue est une erreur. |
| Contraintes et calculs | Types des opérandes, arguments des calculs, conditions booléennes, et évaluation : les contraintes, exigences et objectifs qui ne sont pas vérifiés pour les valeurs actuelles sont signalés. |
| Structure | Extrémités des connexions ; sens des ports, flux et messages ; interfaces et connecteurs de liaison. |
| Actions et états | Cibles de succession, nœuds de contrôle, valeurs parcourues par une boucle for, transitions initiales, régions parallèles, déclencheurs de transitions et effets do. |
| Exigences et cas d'utilisation | Cibles subject, actor, stakeholder, require et assume constraint, satisfy, verify et frame aux bons endroits. |
| Allocation | allocate … to …, définitions d'allocation, dépendances. |
| Variabilité | Une variation ne possède que des variantes de son genre, un choix est une variante de son point, et les valeurs du choix sont évaluées. |
| Individus, instantanés et tranches temporelles | Chacun possède les caractéristiques de l'occurrence à laquelle il appartient ; ses propres valeurs sont lues en premier. |
Partiellement contrôlé : enseigner en nommant la limite
| Domaine | Contrôlé ou exécuté | Limite à signaler aux étudiants |
|---|---|---|
| Actions | Le Simulateur exécute les flux d'actions, y compris en Monte-Carlo. | Les durées des étapes, les probabilités des branches et le nombre d'itérations des boucles sont des paramètres du Simulateur conservés dans Holarch, pas dans le texte ; un export .sysml ne les transporte donc pas. |
| États | Le Simulateur exécute les machines à états avec des stimuli et affiche les états actifs. | Idem : les paramètres du Simulateur ne font pas partie du texte. |
| Cas d'analyse et de vérification | Sujet, objectif, résultat retourné ; verify et un verdict. | Un cas d'analyse n'est évalué que lorsque chaque entrée a une valeur ; il n'y a pas de solveur. Dans une vue paramétrique, Résoudre trouve une inconnue par contrainte. Les analyses d'étude de compromis de la bibliothèque standard ne sont pas évaluées. |
| Vues | view, view def, expose, filtres, points de vue et définitions de vues standard ; les vues de séquence dessinent les fragments alt, opt, loop et par. | La mise en page appartient à Holarch, pas au modèle. |
| Variabilité | Les variations, variantes et configurations sont contrôlées et évaluées. | Holarch ne recherche ni ne liste encore toutes les combinaisons valides. |
| Métadonnées et mots-clés | @Name, #Name, metadata … about, mots-clés définis par l'utilisateur à partir de métadonnées sémantiques. | Les autres métadonnées définies par l'utilisateur n'ont aucune signification au-delà de leurs valeurs ; les métadonnées écrites avec about n'ajoutent aucun type de base. |
| Représentations textuelles | Les corps rep … language en SysML et KerML sont contrôlés, et un corps de contrainte SysML est évalué. | Les corps dans d'autres langages, comme Python, OCL ou MATLAB, sont conservés sous forme de texte et jamais exécutés. |
| Échange JSON SysML v2 | Import et export au format d'éléments du Systems Modeling API, avec conservation des identifiants d'éléments. | Les genres d'éléments que Holarch n'interprète pas sont conservés tels qu'importés et réécrits sans modification ; ils n'ont pas de texte et ne peuvent pas être modifiés. |
Conservé, non interprété : Aucun problème ne prouve rien ici
- Les corps des représentations textuelles dans des langages autres que SysML et KerML.
- Les valeurs des métadonnées définies par l'utilisateur autres que les métadonnées sémantiques.
- Le texte
docet les commentaires : jamais comparés au modèle. Dans le sous-système d'alimentation d'EO-1, passer l'exigence 3.1 à 30 W laisse sondocindiquer 28 W, sans qu'aucun problème ne soit signalé. Un bon exercice. - Les genres d'éléments que Holarch n'interprète pas dans un fichier JSON SysML v2 importé.
L'inverse compte aussi : le statut des exigences, les résultats de vérification et les étiquettes sont des données Holarch. Ils ne figurent pas dans le texte ni dans un export .sysml.
Pas encore dans Holarch
- Fichiers
.kerml: non importés, et les modèles écrits en KerML ne sont pas contrôlés. KerML n'est lu que pour la bibliothèque standard. - Extensions du langage autres que les mots-clés définis par l'utilisateur ; la bibliothèque standard ne peut pas être modifiée.
- Un solveur pour les cas d'analyse, et une recherche des combinaisons de variantes valides dans les pages de Holarch.
- Commits du Systems Modeling API vers
main, étiquettes et fusions : les autres outils commitent dans des branches de demande de modification, et un approbateur les applique dans Holarch.
Utilisation dans un cours
- Ne dites « l'outil a contrôlé » que pour les domaines contrôlés. Par exemple, Aucun problème signifie que les unités sont cohérentes et que les exigences sont vérifiées pour les valeurs actuelles. Cela ne signifie pas que le texte
doccorrespond aux valeurs ni qu'un corps Python est correct. - Évaluez les constructions conservées en les lisant. Notez-les par inspection, pas d'après le nombre de problèmes.
- Le comportement s'exécute dans le Simulateur, pour les flux d'actions comme pour les machines à états. Les durées et probabilités qu'utilise le Simulateur sont des paramètres de Holarch : si les étudiants ne rendent que le fichier
.sysml, demandez aussi les paramètres. - Les règles du langage viennent de la spécification, pas d'un outil. Lorsque Holarch n'a pas implémenté quelque chose, dites « pas encore dans Holarch », et non « interdit ».
- Le bonus de A6 s'appuie sur cette note : les étudiants passent 3.1 à 30 W dans le sous-système d'alimentation d'EO-1, voient le contrôle d'évaluation le signaler, corrigent la conception, et consignent ce qui a été contrôlé et ce qui a seulement été conservé.
Téléchargements
Le dossier est un seul fichier zip. Il porte la version dans son nom, pour qu'un cours puisse désigner exactement la copie utilisée. Les fichiers CSV et de projet des devoirs sont les téléchargements du modèle de référence EO-1 v1.1 sur la page EO-1.
| Fichier | Contenu |
|---|---|
| teaching-with-holarch-v1.0.zip | Tous les fichiers ci-dessous dans un seul dossier. |
README.txt | Le contenu, le mode d'emploi du dossier, l'avis de licence et l'historique des modifications. |
LICENSE.txt | L'avis de licence. |
learning-outcomes.md | Les acquis d'apprentissage du cours et leur correspondance avec les devoirs. |
assignments/A1-trace-a-need.md | A1 Tracer un besoin. |
assignments/A2-requirements-rework.md | A2 Reprise et revue des exigences. |
assignments/A3-coverage-gaps.md | A3 Trouver les lacunes de couverture. |
assignments/A4-extend-the-architecture.md | A4 Étendre l'architecture. |
assignments/A5-work-the-change.md | A5 Traiter la modification. |
assignments/A6-validation-plan.md | A6 Plan de validation. |
sysml-v2-teaching-boundaries.md | Enseigner SysML v2 avec Holarch : ce qui est contrôlé et ce qui est seulement conservé. |
Les notes de corrigé ne sont pas dans le zip ; voir Notes de corrigé.
Versions
Il s'agit du dossier de l'enseignant « Teaching with Holarch » v1.0, rédigé pour le modèle de référence EO-1 v1.1. Une nouvelle version reçoit de nouveaux noms de fichiers ; les versions antérieures restent disponibles à leurs adresses.
- v1.0 : première version : les acquis d'apprentissage du cours et les devoirs A1 à A6 avec grilles d'évaluation, pour le modèle de référence EO-1 v1.1.
Comment le citer
Citez la version que vous avez utilisée :
Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.
Licence
Les fichiers du dossier de l'enseignant sont placés sous la licence Creative Commons Attribution 4.0 International (CC BY 4.0). Vous pouvez les copier, les partager et les adapter à toute fin, y compris commerciale, à condition de créditer de manière appropriée, de fournir un lien vers la licence et d'indiquer si des modifications ont été apportées. Mention : « Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0 ». Chaque téléchargement comporte cet avis.
Le modèle de référence EO-1 conserve sa propre mention d'attribution : « EO-1 Reference Model v1.1, Holarch, CC BY 4.0 ». Tous les noms, personnes et résultats d'EO-1 sont inventés.
La licence couvre uniquement les fichiers du dossier. Les notes de corrigé ne font pas partie du dossier, et le logiciel Holarch n'est pas couvert par la licence.