Для навчальних курсів
Посібник для викладача: проведення курсу з Holarch
Як налаштувати курс у Holarch і провести на ньому три готові модулі: вимоги та верифікація, функціональна й фізична архітектура та основи SysML v2. Кожен модуль перелічує навчальні розділи, які переглядають студенти, практичні уроки в застосунку, які вони проходять, і завдання для курсу на EO-1, яке вони здають. Далі описано варіант із груповим проєктом.
На цій сторінці
Перш ніж почати
Holarch безкоштовний для студентів і викладачів (див. Для навчальних курсів). Студенти опановують інструмент із трьох джерел, тож час заняття можна присвятити методу:
- Навчальні розділи на /training/: короткі відео, кожне про одне завдання.
- Практичні уроки в застосунку: покрокові вказівки на невеликій моделі Weather Station з панеллю, яка перевіряє роботу. Студенти запускають їх через Довідка → Посібники на бічній панелі. Навчальні проєкти не зараховуються до активних проєктів студента.
- Аркуші вправ із ключами відповідей, по одному на навчальний трек (перелік нижче), для практики поза заняттями.
Оцінювані роботи виконуються на відкритій еталонній моделі MBSE EO-1 — вигаданому CubeSat, у який навмисно закладено прогалини, непройдені тести й відкриту зміну вимоги. Оглядова екскурсія «Викладання з Holarch» за п’ять хвилин показує роботу викладача.
Контрольний список налаштування курсу
Зробіть це за тиждень-два до першого заняття. Навчальний трек 8 «Teaching with Holarch» показує кожен крок на екрані, щойно його опублікують на сторінці навчання.
- Створіть організацію курсу. Налаштування облікового запису → Організації → Створити організацію, з назвою курсу. Ви стаєте її адміністратором. (Трек 8.1, Setting Up a Class Organization.)
- Запросіть статус курсу. У Налаштуваннях організації відкрийте організацію й у розділі Курс натисніть Request Class Status…. Укажіть курс, заклад і кінець семестру, додайте силабус (PDF або Word) і надішліть. Holarch розгляне запит і надішле вам лист. Статус курсу дає проєктам організації 6 співпрацівників для проєкту учасника й 50 для вашого, по 2 000 елементів і вкладку Огляд курсу, а її проєкти не зараховуються до активних проєктів власників. Див. Проведення курсу. (Трек 8.2, Class Status and the Syllabus.)
- Додайте учасників. У розділі Учасники введіть адресу електронної пошти кожного студента, виберіть Учасник і натисніть Add Member. Адреса без облікового запису отримає запрошення.
- Зробіть асистентів адміністраторами організації. Додайте кожного асистента з роллю Адміністратор організації, щоб вони бачили «Огляд курсу» й могли керувати списком учасників. Адміністрування організації не дає доступу до вмісту проєктів: проєкти відкриваються через власні налаштування спільного доступу.
- Попросіть кожну групу створити свій проєкт. Лідер групи створює модель EO-1 (Керування проєктами → Project Files ▾ → Новий демопроєкт → CubeSat (системна інженерія з посібником)), вибирає організацію курсу в Поділитися → Організація, запрошує групу як редакторів, а вас і асистентів — з роллю Рецензент. Рецензенти не зараховуються до ліміту співпрацівників; вони можуть читати, експортувати, коментувати та затверджувати або відхиляти вимоги й рецензування документів, але не редагувати.
- Опублікуйте свої шаблони. Якщо завдання починається з документа, створіть його один раз із вбудованого шаблону, додайте свої інструкції до його розділів і збережіть через Write ▾ → Шаблони ▸ Зберегти як шаблон… в організацію як типовий для цього типу. Тоді студенти побачать його вже вибраним у + Новий документ. Див. Збереження документа як шаблону. (Трек 8.3, Assignments from Templates.)
- Додайте терміни. Налаштування організації → Огляд курсу → + Нове завдання, з назвою, датою й часом здачі. У цей момент Holarch зберігає версію кожного групового проєкту та лічильники кожного учасника, тож пізнішу роботу можна порівняти зі станом на термін. Див. Встановлення терміну завдання.
- Вирішіть щодо ШІ. ШІ підпорядковується налаштуванню організації курсу. На час іспиту зніміть позначку Allow AI in this organization's projects і залиште позначеним Also turn off API and MCP access, щоб інструменти ШІ, підключені через MCP, теж були вимкнені. Після іспиту знову позначте поле ШІ й окремо ввімкніть Доступ через API. Див. Вимкнення ШІ для організації. (Трек 8.5, Turning AI Off for an Exam.)
- Попросіть студентів зберігати копії. Студенти можуть будь-коли експортувати проєкт. Вимагайте експорт перед кожним терміном.
Використання «Огляду курсу»
«Огляд курсу» — місце, де ви читаєте роботи груп на дату здачі. Відкрийте його через Налаштування організації → Огляд курсу або натисніть ⌘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: потреби, вимоги та простежування
- Перегляд: Writing Requirements and the Quality Check, Tracing Needs to Requirements, Open Items and Approvals. Нові користувачі спочатку переглядають The Holarch Workspace.
- Практичні уроки: Write Good Requirements і Trace Requirements.
- Здати: A1 Простежити потребу (індивідуально, письмова записка).
- Огляд курсу: A1 нічого не змінює в моделі, тож терміну в «Огляді курсу» не потребує. Додайте зараз термін A2, щоб групи бачили дедлайн.
Тиждень 2: рецензування, базові лінії та верифікація
- Перегляд: Baselines and Links to Review, Verification and the Test Center, RVTM and VCRM.
- Практичні уроки: Verify the Requirements.
- Здати: A2 Доопрацювання та рецензування вимог (групи). Заплануйте раунд рецензування на середину тижня: групи переводять свої три вимоги в статус In Review, ви коментуєте й затверджуєте або відхиляєте як рецензент, а вони відповідають до терміну.
- Огляд курсу: порівняйте кожен груповий проєкт зі станом на термін A2, прочитайте три вимоги, коментарі рецензування до них і специфікацію в базовій лінії. Додатково: A3 Знайти прогалини в покритті як третій тиждень або домашнє завдання.
Модуль 2: Функціональна й фізична архітектура (3 тижні)
Студенти декомпонують функції, будують логічний рівень між функціями та складниками, виводять інтерфейси й простежують зміну через архітектуру.
Тиждень 1: функції та покриття
- Перегляд: Functions and the FFBD, Action Diagrams.
- Практичні уроки: Functional Analysis.
- Здати: A3 Знайти прогалини в покритті (групи). Воно показує студентам слабкі місця архітектури, перш ніж вони її розширять.
Тиждень 2: розподіл та інтерфейси
- Перегляд: Allocation, Interfaces.
- Практичні уроки: Physical Architecture and Allocation і Interfaces.
- Почати: A4 Розширити архітектуру (групи, термін — кінець тижня 3).
Тиждень 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: структура
- Перегляд: Definitions and Attributes, Ports and Interfaces, Actions and Flows.
- Практичні уроки: Getting Started, Definitions and Attributes і Ports and Interfaces.
- На занятті: розберіть межі викладання SysML v2: що перевіряє редактор, що він зберігає без інтерпретації і чому «поки немає в Holarch» не означає «заборонено».
Тиждень 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 для кожного контрольного етапу: вони оцінюють судження (повноту ланцюжка, якість кожного рішення, розрізнення верифікації й валідації), а не кількість елементів.
Аркуші вправ
Кожен аркуш містить короткі практичні завдання для одного навчального треку з ключем відповідей — для студентів, яким потрібно більше практики, ніж дають завдання. Вони загальнодоступні, тож не є оцінюваною роботою.
- Початок роботи
- Вимоги та верифікація
- Поведінка та архітектура
- Документи та результати
- Основи SysML v2
Отримання допомоги
З питань налаштування курсу, статусу курсу або нотаток із розв’язками для A1–A6 напишіть нам з темою Instructor. Сторінки Проведення курсу і Внески в Docs містять подробиці кожного кроку вище.