Holarch

Для навчальних курсів

Посібник для викладача: проведення курсу з Holarch

Як налаштувати курс у Holarch і провести на ньому три готові модулі: вимоги та верифікація, функціональна й фізична архітектура та основи SysML v2. Кожен модуль перелічує навчальні розділи, які переглядають студенти, практичні уроки в застосунку, які вони проходять, і завдання для курсу на EO-1, яке вони здають. Далі описано варіант із груповим проєктом.

На цій сторінці
  1. Перш ніж почати
  2. Контрольний список налаштування курсу
  3. Використання «Огляду курсу»
  4. Модуль 1: Вимоги та верифікація (2 тижні)
    1. Тиждень 1: потреби, вимоги та простежування
    2. Тиждень 2: рецензування, базові лінії та верифікація
  5. Модуль 2: Функціональна й фізична архітектура (3 тижні)
    1. Тиждень 1: функції та покриття
    2. Тиждень 2: розподіл та інтерфейси
    3. Тиждень 3: аналіз і зміни
  6. Модуль 3: Основи SysML v2 (2 тижні)
    1. Тиждень 1: структура
    2. Тиждень 2: вимоги та обмеження
  7. Варіант із груповим проєктом
  8. Аркуші вправ
  9. Отримання допомоги

Перш ніж почати

Holarch безкоштовний для студентів і викладачів (див. Для навчальних курсів). Студенти опановують інструмент із трьох джерел, тож час заняття можна присвятити методу:

  • Навчальні розділи на /training/: короткі відео, кожне про одне завдання.
  • Практичні уроки в застосунку: покрокові вказівки на невеликій моделі Weather Station з панеллю, яка перевіряє роботу. Студенти запускають їх через Довідка → Посібники на бічній панелі. Навчальні проєкти не зараховуються до активних проєктів студента.
  • Аркуші вправ із ключами відповідей, по одному на навчальний трек (перелік нижче), для практики поза заняттями.

Оцінювані роботи виконуються на відкритій еталонній моделі MBSE EO-1 — вигаданому CubeSat, у який навмисно закладено прогалини, непройдені тести й відкриту зміну вимоги. Оглядова екскурсія «Викладання з Holarch» за п’ять хвилин показує роботу викладача.

Контрольний список налаштування курсу

Зробіть це за тиждень-два до першого заняття. Навчальний трек 8 «Teaching with Holarch» показує кожен крок на екрані, щойно його опублікують на сторінці навчання.

  1. Створіть організацію курсу. Налаштування облікового запису → Організації → Створити організацію, з назвою курсу. Ви стаєте її адміністратором. (Трек 8.1, Setting Up a Class Organization.)
  2. Запросіть статус курсу. У Налаштуваннях організації відкрийте організацію й у розділі Курс натисніть Request Class Status…. Укажіть курс, заклад і кінець семестру, додайте силабус (PDF або Word) і надішліть. Holarch розгляне запит і надішле вам лист. Статус курсу дає проєктам організації 6 співпрацівників для проєкту учасника й 50 для вашого, по 2 000 елементів і вкладку Огляд курсу, а її проєкти не зараховуються до активних проєктів власників. Див. Проведення курсу. (Трек 8.2, Class Status and the Syllabus.)
  3. Додайте учасників. У розділі Учасники введіть адресу електронної пошти кожного студента, виберіть Учасник і натисніть Add Member. Адреса без облікового запису отримає запрошення.
  4. Зробіть асистентів адміністраторами організації. Додайте кожного асистента з роллю Адміністратор організації, щоб вони бачили «Огляд курсу» й могли керувати списком учасників. Адміністрування організації не дає доступу до вмісту проєктів: проєкти відкриваються через власні налаштування спільного доступу.
  5. Попросіть кожну групу створити свій проєкт. Лідер групи створює модель EO-1 (Керування проєктами → Project Files ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)), вибирає організацію курсу в Поділитися → Організація, запрошує групу як редакторів, а вас і асистентів — з роллю Рецензент. Рецензенти не зараховуються до ліміту співпрацівників; вони можуть читати, експортувати, коментувати та затверджувати або відхиляти вимоги й рецензування документів, але не редагувати.
  6. Опублікуйте свої шаблони. Якщо завдання починається з документа, створіть його один раз із вбудованого шаблону, додайте свої інструкції до його розділів і збережіть через Write ▾ → Шаблони ▸ Зберегти як шаблон… в організацію як типовий для цього типу. Тоді студенти побачать його вже вибраним у + Новий документ. Див. Збереження документа як шаблону. (Трек 8.3, Assignments from Templates.)
  7. Додайте терміни. Налаштування організації → Огляд курсу → + Нове завдання, з назвою, датою й часом здачі. У цей момент Holarch зберігає версію кожного групового проєкту та лічильники кожного учасника, тож пізнішу роботу можна порівняти зі станом на термін. Див. Встановлення терміну завдання.
  8. Вирішіть щодо ШІ. ШІ підпорядковується налаштуванню організації курсу. На час іспиту зніміть позначку Allow AI in this organization's projects і залиште позначеним Also turn off API and MCP access, щоб інструменти ШІ, підключені через MCP, теж були вимкнені. Після іспиту знову позначте поле ШІ й окремо ввімкніть Доступ через API. Див. Вимкнення ШІ для організації. (Трек 8.5, Turning AI Off for an Exam.)
  9. Попросіть студентів зберігати копії. Студенти можуть будь-коли експортувати проєкт. Вимагайте експорт перед кожним терміном.

Використання «Огляду курсу»

«Огляд курсу» — місце, де ви читаєте роботи груп на дату здачі. Відкрийте його через Налаштування організації → Огляд курсу або натисніть ⌘K / Ctrl+K і виберіть Огляд курсу.

  • Читайте роботи. У розділі Групові проєкти клацніть проєкт, щоб переглянути його, не приєднуючись. Назви елементів відкривають попередній перегляд із текстом і коментарями елемента.
  • Порівнюйте зі станом на термін. Виберіть завдання в Порівняти з: лічильники показують значення на дату здачі, а роботу, змінену чи додану пізніше, позначено Changed after due date або Added after due date. Holarch позначає запізнілу роботу, але не блокує проєкт після терміну.
  • Коментуйте й затверджуйте в проєкті. Як рецензент групового проєкту додавайте коментарі до елементів і використовуйте Затвердити та Відхилити… для вимог на рецензуванні. (Трек 8.4, Reviewing and Commenting on Student Work.)
  • Експортуйте для журналу оцінок. У розділі Зведення курсу кнопка Експортувати (Excel) дає один аркуш на курс, по одному на групу й по одному на студента. Оцінки й рубрики залишаються у вашому власному журналі.

Оцінюйте модель і міркування, які ви в ній бачите. Лічильники учасників і «Активність» — це докази для рідкісних випадків, коли частка учасника в груповій роботі викликає сумнів; вони не є мірилом якості й не приводом стежити за кожним студентом. (Трек 8.6, Evidence for Grading: Class Review and Activity.)

Модуль 1: Вимоги та верифікація (2 тижні)

Студенти вчаться писати й рецензувати вимоги, простежувати їх до потреб і читати покриття верифікацією.

Тиждень 1: потреби, вимоги та простежування

Тиждень 2: рецензування, базові лінії та верифікація

Модуль 2: Функціональна й фізична архітектура (3 тижні)

Студенти декомпонують функції, будують логічний рівень між функціями та складниками, виводять інтерфейси й простежують зміну через архітектуру.

Тиждень 1: функції та покриття

Тиждень 2: розподіл та інтерфейси

Тиждень 3: аналіз і зміни

  • Перегляд: Simulation, Budgets and TPMs.
  • Практичні уроки: Simulate the Functional Flow і Baseline, Change, Impact.
  • Здати: A4. Якщо в модулі є місце для четвертого тижня, додайте A5 Опрацювати зміну: рівняння енергоживлення та TPM-2 з розділів цього тижня є його вхідними даними.
  • Огляд курсу: додайте термін для кожного завдання. Для A4 порівняйте зі станом на термін і відкрийте нові логічні елементи та їхні розподіли в проєкті кожної групи; поданий опис архітектури має відповідати вмісту моделі.

Модуль 3: Основи SysML v2 (2 тижні)

Студенти пишуть невелику модель у текстовій нотації SysML v2, бачать її як подання й дізнаються, що доводять перевірки інструмента. Кожна група створює для своєї роботи проєкт SysML v2; практичні уроки SysML v2 будують частини гібридного автомобіля.

Тиждень 1: структура

Тиждень 2: вимоги та обмеження

  • Перегляд: Requirements, Verification and Traceability, Constraints and Calculations.
  • Практичні уроки: Requirements і Constraints and Calculations.
  • Здати: A6, частина B окремо: підсистема енергоживлення EO-1 у SysML v2, зміна на 30 W, проєкт, що їй відповідає, і пів сторінки про те, що перевірено, а що лише збережено.
  • Огляд курсу: додайте термін. Читайте файл і текст на пів сторінки разом: оцінка ґрунтується на поясненні, адже 0 діагностик саме по собі доводить лише те, що охоплюють перевірки.

Варіант із груповим проєктом

Для семестрового проєкту кожна група моделює систему на власний вибір, а не EO-1, від потреб до верифікації. Структуру курсу забезпечують можливості для курсів:

  • Проєкт на групу в організації курсу. Лідер групи створює проєкт (порожній або з прикладу стартового проєкту курсу на сторінці Для навчальних курсів), вибирає організацію курсу в Поділитися → Організація, запрошує групу як редакторів, а викладачів — з роллю рецензента.
  • Контрольні етапи як терміни. Додайте одне завдання «Огляду курсу» на кожен контрольний етап, наприклад концепція й потреби, рецензування вимог, архітектура та план верифікації. Кожен термін зберігає версію кожного групового проєкту для оцінювання.
  • Раунд рецензування з роллю рецензента. Перед етапом вимог групи переводять свої вимоги в статус In Review; ви й асистенти коментуєте, затверджуєте або відхиляєте, а групи доопрацьовують і подають знову, як у A2. Взаємне рецензування працює так само: додайте учасників іншої групи до проєкту як рецензентів.
  • Іспит без ШІ. Вимкніть ШІ для організації разом із доступом через API та MCP на час іспиту й увімкніть знову після нього (крок 8 контрольного списку).
  • Фінальна базова лінія як здана робота. Кожна група зберігає базову лінію проєкту через Контроль і рецензування → Базові лінії та версії → + Зберегти базову лінію… з назвою здачі й експортує свої результати (наприклад, специфікацію та план верифікації у Word). Оцінюйте базову лінію, а не живий проєкт.
  • Докази внеску лише за потреби. Оцінюйте групу за моделлю та її обґрунтуванням. Відкривайте внески учасника в «Огляді курсу» лише тоді, коли його частка викликає сумнів.

Адаптуйте рубрики завдань EO-1 для кожного контрольного етапу: вони оцінюють судження (повноту ланцюжка, якість кожного рішення, розрізнення верифікації й валідації), а не кількість елементів.

Аркуші вправ

Кожен аркуш містить короткі практичні завдання для одного навчального треку з ключем відповідей — для студентів, яким потрібно більше практики, ніж дають завдання. Вони загальнодоступні, тож не є оцінюваною роботою.

Отримання допомоги

З питань налаштування курсу, статусу курсу або нотаток із розв’язками для A1–A6 напишіть нам з темою Instructor. Сторінки Проведення курсу і Внески в Docs містять подробиці кожного кроку вище.

Опубліковано Holarch