Для учебных курсов
Руководство преподавателя: курс с Holarch
Как настроить учебный курс в Holarch и провести на нём три готовых модуля: требования и верификация, функциональная и физическая архитектура, основы SysML v2. Для каждого модуля указаны главы обучения, которые смотрят студенты, встроенные учебные пособия, которые они проходят, и учебное задание EO-1, которое они сдают. Далее описан вариант с групповым проектом.
На этой странице
Перед началом
Holarch бесплатен для студентов и преподавателей (см. Для учебных курсов). Студенты осваивают инструмент по трём источникам, так что время занятий остаётся для метода:
- Главы обучения на /training/: короткие видео, по одной задаче в каждом.
- Встроенные учебные пособия: пошаговые инструкции на небольшой модели Weather Station с панелью, которая проверяет работу. Студенты запускают их через Help → Tutorials на боковой панели. Учебные проекты не учитываются в числе активных проектов студента.
- Листы упражнений с ответами, по одному на каждый курс обучения (список ниже), для самостоятельной практики.
Оцениваемая работа выполняется на открытой эталонной MBSE-модели EO-1 — вымышленном CubeSat, в который намеренно встроены пробелы, непройденные тесты и открытое изменение требования. Обзорный тур «Teaching with Holarch» за пять минут показывает сторону преподавателя.
Контрольный список настройки курса
Сделайте это за одну-две недели до первого занятия. Курс обучения 8, Teaching with Holarch, показывает каждый шаг на экране, как только будет опубликован на странице обучения.
- Создайте учебную организацию. Account Settings → Organizations → Create Organization, с названием курса. Вы становитесь её администратором. (Курс 8.1, Setting Up a Class Organization.)
- Запросите статус учебного курса. В Настройки организации откройте организацию и в разделе Класс нажмите Request Class Status…. Укажите курс, вуз и окончание семестра, приложите программу курса (PDF или Word) и отправьте. Holarch рассмотрит запрос и сообщит вам по электронной почте. Статус учебного курса даёт проектам организации 6 соавторов для проекта участника и 50 для вашего, по 2000 элементов в каждом, и вкладку Обзор группы, а её проекты не учитываются в числе активных проектов владельцев. См. Проведение курса. (Курс 8.2, Class Status and the Syllabus.)
- Добавьте участников. В разделе Участники введите адрес электронной почты каждого студента, выберите Участник и нажмите Add Member. Адрес без учётной записи получит приглашение.
- Сделайте ассистентов администраторами организации. Добавьте каждого ассистента с ролью Администратор организации, чтобы он видел Class Review и мог управлять списком. Администрирование организации не даёт доступа к содержимому проектов: проекты открываются через их собственный общий доступ.
- Пусть каждая группа создаст свой проект. Руководитель группы создаёт модель EO-1 (Manage Projects → Project Files ▾ → New Demo Project → CubeSat (Guided systems engineering)), выбирает учебную организацию в Share → Organization, приглашает группу как редакторов, а вас и ассистентов — как Рецензент. Рецензенты не учитываются в лимите соавторов; они могут читать, экспортировать, комментировать, утверждать или отклонять требования и рецензирование документов, но не редактировать.
- Опубликуйте свои шаблоны. Если задание начинается с документа, один раз создайте его из встроенного шаблона, добавьте в разделы свои указания и сохраните через Write ▾ → Templates ▸ Save as Template… в организацию как шаблон по умолчанию для его типа. Тогда студенты увидят его выбранным заранее в + Новый документ. См. Сохранение документа как шаблона. (Курс 8.3, Assignments from Templates.)
- Укажите сроки. Organization Settings → Class Review → + New Assignment, с названием, датой и временем сдачи. В этот момент 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.)
- Попросите студентов хранить копии. Студенты могут экспортировать проект в любой момент. Просите экспорт перед каждым сроком сдачи.
Работа с Class Review
В Class Review вы читаете работу групп на дату сдачи. Откройте её через Organization Settings → Class Review или нажмите ⌘K / Ctrl+K и выберите Обзор группы.
- Читайте работу. В разделе Групповые проекты нажмите на проект, чтобы просмотреть его, не присоединяясь. Названия элементов открывают предпросмотр с текстом элемента и комментариями.
- Сравнивайте с датой сдачи. Выберите задание в Сравнить с: счётчики показывают значения на дату сдачи, а работа, изменённая или добавленная позже, помечается Changed after due date или Added after due date. Holarch помечает опоздавшую работу, но не блокирует проект на дату сдачи.
- Комментируйте и утверждайте в проекте. Как Reviewer группового проекта добавляйте комментарии к элементам и используйте Утвердить и Отклонить… для требований на рецензировании. (Курс 8.4, Reviewing and Commenting on Student Work.)
- Экспортируйте для журнала оценок. В разделе Сводка по группе команда Экспорт (Excel) даёт один лист на курс, по одному на группу и по одному на студента. Оценки и критерии остаются в вашем собственном журнале.
Оценивайте модель и рассуждения, которые в ней видны. Счётчики по участникам и Activity — свидетельства для редкого случая, когда под вопросом доля участника в групповой работе; это не мера качества и не повод следить за каждым студентом. (Курс 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 Проследить потребность (индивидуально, письменная записка).
- Class Review: A1 ничего не меняет в модели, поэтому срок в Class Review для него не нужен. Добавьте сейчас срок A2, чтобы группы видели дедлайн.
Неделя 2: рецензирование, базовые линии и верификация
- Посмотреть: Baselines and Links to Review, Verification and the Test Center, RVTM and VCRM.
- Учебные пособия: Verify the Requirements.
- Сдать: A2 Доработка и рецензирование требований (группы). Запланируйте раунд рецензирования на середину недели: группы переводят свои три требования в In Review, вы комментируете и утверждаете или отклоняете как Reviewer, а они отвечают до срока сдачи.
- Class 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 из глав этой недели.
- Class Review: добавьте срок для каждого задания. Для 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 Вт, удовлетворяющий ему проект и полстраницы о том, что было проверено, а что только сохранено.
- Class Review: добавьте срок. Читайте файл и полстраницы вместе: оценка опирается на объяснение, поскольку 0 диагностических сообщений сами по себе доказывают только то, что охватывают проверки.
Вариант с групповым проектом
В семестровом проекте каждая группа моделирует систему по своему выбору, а не EO-1, от потребностей до верификации. Структуру курса несут возможности учебной организации:
- Проект на группу в учебной организации. Руководитель группы создаёт проект (пустой или из примерной заготовки курса на странице Для учебных курсов), выбирает учебную организацию в Share → Organization, приглашает группу как редакторов, а преподавателей — как Reviewer.
- Вехи как сроки. Добавьте по одному заданию Class Review на веху, например концепция и потребности, рецензирование требований, архитектура и план верификации. На каждую дату сдачи сохраняется версия каждого группового проекта для оценивания.
- Раунд рецензирования в роли Reviewer. Перед вехой требований группы переводят свои требования в In Review; вы и ассистенты комментируете, утверждаете или отклоняете, а группы дорабатывают и отправляют повторно, как в A2. Взаимное рецензирование работает так же: добавьте участников другой группы в проект как Reviewer.
- Экзамен без ИИ. На время экзамена отключите ИИ для организации вместе с доступом через API и MCP, а затем снова включите (шаг 8 контрольного списка).
- Итоговая базовая линия как сданная работа. Каждая группа сохраняет базовую линию проекта через Control & Reviews → Baselines & Versions → + Save Baseline… с названием сдаваемой работы и экспортирует результаты (например, спецификацию и план верификации в Word). Оценивайте базовую линию, а не живой проект.
- Свидетельства вклада — только при необходимости. Оценивайте группу по модели и её обоснованию. Открывайте вклад участника в Class Review, только если его доля под вопросом.
Адаптируйте критерии оценивания заданий EO-1 для каждой вехи: они оценивают суждение (полноту цепочки, качество каждого решения, различение верификации и валидации), а не количество элементов.
Листы упражнений
Каждый лист содержит короткие практические задачи по одному курсу обучения с ответами — для студентов, которым нужно больше практики, чем дают задания. Листы открыты, поэтому не являются оцениваемой работой.
- Начало работы
- Требования и верификация
- Поведение и архитектура
- Документы и результаты
- Основы SysML v2
Где получить помощь
По вопросам настройки курса, статуса учебного курса или методических указаний с решениями для A1–A6 свяжитесь с нами, указав тему Instructor. Страницы Docs Проведение курса и Вклад участников подробно описывают каждый шаг выше.