Holarch

Для учебных курсов

Руководство преподавателя: курс с Holarch

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

На этой странице
  1. Перед началом
  2. Контрольный список настройки курса
  3. Работа с Class Review
  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 с панелью, которая проверяет работу. Студенты запускают их через Help → Tutorials на боковой панели. Учебные проекты не учитываются в числе активных проектов студента.
  • Листы упражнений с ответами, по одному на каждый курс обучения (список ниже), для самостоятельной практики.

Оцениваемая работа выполняется на открытой эталонной MBSE-модели EO-1 — вымышленном CubeSat, в который намеренно встроены пробелы, непройденные тесты и открытое изменение требования. Обзорный тур «Teaching with Holarch» за пять минут показывает сторону преподавателя.

Контрольный список настройки курса

Сделайте это за одну-две недели до первого занятия. Курс обучения 8, Teaching with Holarch, показывает каждый шаг на экране, как только будет опубликован на странице обучения.

  1. Создайте учебную организацию. Account Settings → Organizations → Create Organization, с названием курса. Вы становитесь её администратором. (Курс 8.1, Setting Up a Class Organization.)
  2. Запросите статус учебного курса. В Настройки организации откройте организацию и в разделе Класс нажмите Request Class Status…. Укажите курс, вуз и окончание семестра, приложите программу курса (PDF или Word) и отправьте. Holarch рассмотрит запрос и сообщит вам по электронной почте. Статус учебного курса даёт проектам организации 6 соавторов для проекта участника и 50 для вашего, по 2000 элементов в каждом, и вкладку Обзор группы, а её проекты не учитываются в числе активных проектов владельцев. См. Проведение курса. (Курс 8.2, Class Status and the Syllabus.)
  3. Добавьте участников. В разделе Участники введите адрес электронной почты каждого студента, выберите Участник и нажмите Add Member. Адрес без учётной записи получит приглашение.
  4. Сделайте ассистентов администраторами организации. Добавьте каждого ассистента с ролью Администратор организации, чтобы он видел Class Review и мог управлять списком. Администрирование организации не даёт доступа к содержимому проектов: проекты открываются через их собственный общий доступ.
  5. Пусть каждая группа создаст свой проект. Руководитель группы создаёт модель EO-1 (Manage Projects → Project Files ▾ → New Demo Project → CubeSat (Guided systems engineering)), выбирает учебную организацию в Share → Organization, приглашает группу как редакторов, а вас и ассистентов — как Рецензент. Рецензенты не учитываются в лимите соавторов; они могут читать, экспортировать, комментировать, утверждать или отклонять требования и рецензирование документов, но не редактировать.
  6. Опубликуйте свои шаблоны. Если задание начинается с документа, один раз создайте его из встроенного шаблона, добавьте в разделы свои указания и сохраните через Write ▾ → Templates ▸ Save as Template… в организацию как шаблон по умолчанию для его типа. Тогда студенты увидят его выбранным заранее в + Новый документ. См. Сохранение документа как шаблона. (Курс 8.3, Assignments from Templates.)
  7. Укажите сроки. Organization Settings → Class Review → + New Assignment, с названием, датой и временем сдачи. В этот момент 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. Попросите студентов хранить копии. Студенты могут экспортировать проект в любой момент. Просите экспорт перед каждым сроком сдачи.

Работа с 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: потребности, требования и прослеживание

Неделя 2: рецензирование, базовые линии и верификация

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

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

Неделя 1: функции и покрытие

Неделя 2: распределение и интерфейсы

Неделя 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: структура

Неделя 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 для каждой вехи: они оценивают суждение (полноту цепочки, качество каждого решения, различение верификации и валидации), а не количество элементов.

Листы упражнений

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

Где получить помощь

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

Издатель: Holarch