Holarch

Pour les cours

Guide de l'enseignant : animer un cours avec Holarch

Comment mettre en place un cours dans Holarch et y animer trois modules prêts à l'emploi : exigences et vérification, architecture fonctionnelle et physique, et bases de SysML v2. Chaque module liste les chapitres de formation que les étudiants regardent, les tutoriels intégrés qu'ils réalisent et le devoir de cours EO-1 qu'ils remettent. Une option de projet de groupe suit.

Sur cette page
  1. Avant de commencer
  2. Liste de contrôle pour la mise en place du cours
  3. Utiliser la Revue de la classe
  4. Module 1 : exigences et vérification (2 semaines)
    1. Semaine 1 : besoins, exigences et traçage
    2. Semaine 2 : revue, références et vérification
  5. Module 2 : architecture fonctionnelle et physique (3 semaines)
    1. Semaine 1 : fonctions et couverture
    2. Semaine 2 : allocation et interfaces
    3. Semaine 3 : analyse et modification
  6. Module 3 : bases de SysML v2 (2 semaines)
    1. Semaine 1 : structure
    2. Semaine 2 : exigences et contraintes
  7. Option de projet de groupe
  8. Fiches d'exercices
  9. Obtenir de l'aide

Avant de commencer

Holarch est gratuit pour les étudiants et les enseignants (voir Pour les cours). Les étudiants apprennent l'outil à partir de trois sources, si bien que le temps de cours peut être consacré à la méthode :

  • Chapitres de formation sur /training/ : de courtes vidéos, une tâche chacune.
  • Tutoriels intégrés : des étapes guidées sur un petit modèle de station météo, avec un panneau qui contrôle le travail. Les étudiants les lancent depuis Aide → Tutoriels dans le rail. Les projets de tutoriel ne comptent pas dans les projets actifs d'un étudiant.
  • Fiches d'exercices avec corrigés, une par parcours de formation (listées ci-dessous), pour s'entraîner en dehors du cours.

Le travail noté utilise le modèle de référence MBSE ouvert EO-1, un CubeSat fictif comportant volontairement des lacunes, des tests en échec et une modification d'exigence en cours. La visite guidée Enseigner avec Holarch montre le côté enseignant en cinq minutes.

Liste de contrôle pour la mise en place du cours

Faites-le une ou deux semaines avant la première séance. Le parcours de formation 8, Enseigner avec Holarch, montre chaque étape à l'écran dès sa publication sur la page de formation.

  1. Créez l'organisation de classe. Paramètres du compte → Organisations → Créer l'organisation, avec le nom du cours. Vous en devenez l'administrateur. (Parcours 8.1, Mettre en place une organisation de classe.)
  2. Demandez le statut de classe. Dans Paramètres de l'organisation, ouvrez l'organisation et, sous Classe, cliquez sur Demander le statut de classe…. Saisissez le cours, l'établissement et la fin du semestre, joignez le programme du cours (PDF ou Word) et envoyez. Holarch examine la demande et vous envoie un e-mail. Le statut de classe donne aux projets de l'organisation 6 collaborateurs pour le projet d'un membre et 50 pour les vôtres, 2 000 éléments chacun, et l'onglet Revue de la classe, et ses projets ne comptent pas dans les projets actifs de leurs propriétaires. Voir Gérer un cours. (Parcours 8.2, Le statut de classe et le programme du cours.)
  3. Ajoutez les membres. Sous Membres, saisissez l'adresse e-mail de chaque étudiant, choisissez Membre et cliquez sur Ajouter le membre. Une adresse sans compte reçoit une invitation.
  4. Faites de vos assistants des administrateurs de l'organisation. Ajoutez chaque assistant avec Admin de l'organisation, pour qu'il voie la Revue de la classe et puisse gérer la liste des inscrits. Administrer une organisation ne donne aucun accès au contenu des projets : les projets s'ouvrent selon leur propre partage.
  5. Demandez à chaque groupe de créer son projet. Le chef de groupe crée le modèle EO-1 (Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → CubeSat (ingénierie système guidée)), choisit l'organisation de classe sous Partager → Organisation, invite le groupe comme éditeurs, et vous et vos assistants comme Relecteur. Les relecteurs ne comptent pas dans la limite de collaborateurs ; ils peuvent lire, exporter, commenter et approuver ou rejeter les exigences et les revues de documents, mais pas modifier.
  6. Publiez vos modèles. Si un devoir part d'un document, construisez-le une fois à partir d'un modèle intégré, ajoutez vos consignes à ses sections et enregistrez-le avec Rédiger ▾ → Modèles ▸ Enregistrer comme modèle… dans l'organisation, comme modèle par défaut de son type. Les étudiants le trouvent alors présélectionné dans + Nouveau document. Voir Enregistrer un document comme modèle. (Parcours 8.3, Des devoirs à partir de modèles.)
  7. Ajoutez les échéances. Paramètres de l'organisation → Revue de la classe → + Nouveau devoir, avec un nom et la date et l'heure d'échéance. À ce moment, Holarch conserve une version de chaque projet de groupe et les décomptes de chaque membre, pour que vous puissiez comparer le travail ultérieur à l'échéance. Voir Définir l'échéance d'un devoir.
  8. Décidez pour l'IA. L'IA suit le paramètre de l'organisation de classe. Pour un examen, décochez Autoriser l'IA dans les projets de cette organisation et laissez Désactiver aussi l'accès API et MCP coché, pour que les outils d'IA connectés via MCP soient aussi désactivés. Ensuite, cochez de nouveau la case de l'IA et réactivez séparément l'Accès API. Voir Désactiver l'IA pour une organisation. (Parcours 8.5, Désactiver l'IA pour un examen.)
  9. Dites aux étudiants de conserver des copies. Les étudiants peuvent exporter un projet à tout moment. Demandez un export avant chaque échéance.

Utiliser la Revue de la classe

La Revue de la classe est l'endroit où vous lisez le travail des groupes à une échéance. Ouvrez-la sous Paramètres de l'organisation → Revue de la classe, ou appuyez sur ⌘K / Ctrl+K et choisissez Revue de la classe.

  • Lisez le travail. Sous Projets de groupe, cliquez sur un projet pour le voir sans le rejoindre. Les noms d'éléments ouvrent un aperçu avec le texte et les commentaires de l'élément.
  • Comparez avec une échéance. Choisissez le devoir sous Comparer avec : les décomptes affichent leur valeur à l'échéance, et le travail modifié ou ajouté ensuite est marqué Modifié après l'échéance ou Ajouté après l'échéance. Holarch signale le travail en retard ; il ne verrouille pas un projet à l'échéance.
  • Commentez et approuvez dans le projet. En tant que relecteur du projet de groupe, ajoutez des commentaires sur les éléments et utilisez Approuver et Rejeter… sur les exigences en revue. (Parcours 8.4, Revoir et commenter le travail des étudiants.)
  • Exportez pour le carnet de notes. Sous Synthèse de la classe, Exporter (Excel) fournit une feuille pour la classe, une par groupe et une par étudiant. Les notes et grilles d'évaluation restent dans votre propre carnet de notes.

Notez le modèle et le raisonnement que vous y lisez. Les décomptes par membre et l'Activité servent de preuves dans le cas rare où la part d'un membre dans le travail de groupe est mise en question ; ce ne sont ni une mesure de qualité ni une raison de surveiller chaque étudiant. (Parcours 8.6, Des preuves pour la notation : Revue de la classe et Activité.)

Module 1 : exigences et vérification (2 semaines)

Les étudiants apprennent à rédiger et revoir des exigences, à les tracer vers les besoins et à lire la couverture de vérification.

Semaine 1 : besoins, exigences et traçage

Semaine 2 : revue, références et vérification

Module 2 : architecture fonctionnelle et physique (3 semaines)

Les étudiants décomposent des fonctions, construisent une couche logique entre les fonctions et les parties, dérivent des interfaces et suivent une modification à travers l'architecture.

Semaine 1 : fonctions et couverture

Semaine 2 : allocation et interfaces

Semaine 3 : analyse et modification

  • À regarder : Simulation, Budgets et TPM.
  • Tutoriels : Simuler le flux fonctionnel et Référence, modification, impact.
  • À remettre : A4. Si le module dispose d'une quatrième semaine, ajoutez A5 Traiter la modification : les équations de puissance et la TPM-2 des chapitres de cette semaine en sont les données d'entrée.
  • Revue de la classe : ajoutez une échéance par devoir. Pour A4, comparez avec l'échéance et ouvrez les nouveaux éléments logiques et leurs allocations dans le projet de chaque groupe ; la description d'architecture remise doit correspondre au contenu du modèle.

Module 3 : bases de SysML v2 (2 semaines)

Les étudiants écrivent un petit modèle en notation textuelle SysML v2, le voient sous forme de vues et apprennent ce que prouvent les contrôles de l'outil. Chaque groupe crée un projet SysML v2 pour son travail ; les tutoriels SysML v2 construisent des parties d'une voiture hybride.

Semaine 1 : structure

Semaine 2 : exigences et contraintes

  • À regarder : Exigences, Vérification et traçabilité, Contraintes et calculs.
  • Tutoriels : Exigences et Contraintes et calculs.
  • À remettre : A6 partie B seule : le sous-système d'alimentation d'EO-1 en SysML v2, la modification à 30 W, une conception qui la satisfait, et la demi-page sur ce qui a été contrôlé et ce qui a seulement été conservé.
  • Revue de la classe : ajoutez l'échéance. Lisez le fichier et la demi-page ensemble : la note repose sur l'explication, car 0 diagnostic ne prouve à lui seul que ce que couvrent les contrôles.

Option de projet de groupe

Pour un projet de semestre, chaque groupe modélise un système de son choix, autre qu'EO-1, des besoins à la vérification. Les fonctionnalités de classe portent la structure du cours :

  • Un projet par groupe dans l'organisation de classe. Le chef de groupe crée le projet (vierge, ou à partir du projet de départ d'exemple de Pour les cours), choisit l'organisation de classe sous Partager → Organisation, invite le groupe comme éditeurs et l'équipe pédagogique comme relecteurs.
  • Les jalons comme échéances. Ajoutez un devoir de Revue de la classe par jalon, par exemple concept et besoins, revue des exigences, architecture et plan de vérification. Chaque échéance conserve une version de chaque projet de groupe pour la notation.
  • Un tour de revue en tant que relecteur. Avant le jalon des exigences, les groupes passent leurs exigences à En revue ; vous et les assistants commentez, approuvez ou rejetez, et les groupes retravaillent et soumettent de nouveau, comme dans A2. La revue par les pairs fonctionne de la même façon : ajoutez les membres d'un autre groupe à un projet en tant que relecteurs.
  • Une période d'examen sans IA. Désactivez l'IA pour l'organisation, avec l'accès API et MCP, pendant l'examen, et réactivez-la ensuite (étape 8 de la liste de contrôle).
  • Une référence finale comme rendu. Chaque groupe enregistre une référence du projet sous Contrôle et revues → Références et versions → + Enregistrer une référence…, nommée d'après le rendu, et exporte ses livrables (par exemple la spécification et le plan de vérification en Word). Notez la référence, pas le projet en cours.
  • Les preuves de contribution seulement si nécessaire. Notez le groupe sur le modèle et son raisonnement. N'ouvrez les contributions d'un membre dans la Revue de la classe que lorsque sa part est mise en question.

Adaptez les grilles d'évaluation des devoirs EO-1 à chaque jalon : elles évaluent le jugement (complétude de la chaîne, qualité de chaque décision, vérification par rapport à validation) plutôt que le nombre d'éléments.

Fiches d'exercices

Chaque fiche contient de courts exercices pour un parcours de formation, avec un corrigé, pour les étudiants qui veulent s'entraîner davantage que ne le permettent les devoirs. Elles sont publiques et ne servent donc pas de travail noté.

Obtenir de l'aide

Pour la mise en place d'un cours, une question sur le statut de classe ou les notes de corrigé de A1 à A6, contactez-nous avec le sujet Instructor. Les pages Gérer un cours et Contributions de la documentation détaillent chaque étape ci-dessus.

Publié par Holarch