Holarch

Dla zajęć

Przewodnik dla prowadzących: kurs z Holarch

Jak skonfigurować zajęcia w Holarch i poprowadzić w nim trzy gotowe moduły: wymagania i weryfikacja, architektura funkcjonalna i fizyczna oraz podstawy SysML v2. Każdy moduł wymienia rozdziały szkoleń, które studenci oglądają, samouczki w aplikacji, które wykonują, i zadanie z modelem EO-1, które oddają. Na końcu opisano wariant z projektem grupowym.

Na tej stronie
  1. Zanim zaczniesz
  2. Lista kontrolna konfiguracji zajęć
  3. Korzystanie z Class Review
  4. Moduł 1: Wymagania i weryfikacja (2 tygodnie)
    1. Tydzień 1: potrzeby, wymagania i powiązania
    2. Tydzień 2: przegląd, linie bazowe i weryfikacja
  5. Moduł 2: Architektura funkcjonalna i fizyczna (3 tygodnie)
    1. Tydzień 1: funkcje i pokrycie
    2. Tydzień 2: alokacja i interfejsy
    3. Tydzień 3: analiza i zmiana
  6. Moduł 3: Podstawy SysML v2 (2 tygodnie)
    1. Tydzień 1: struktura
    2. Tydzień 2: wymagania i ograniczenia
  7. Wariant z projektem grupowym
  8. Arkusze ćwiczeń
  9. Pomoc

Zanim zaczniesz

Holarch jest bezpłatny dla studentów i prowadzących (zobacz Dla zajęć). Studenci uczą się narzędzia z trzech źródeł, dzięki czemu czas zajęć można poświęcić metodzie:

  • Rozdziały szkoleń na stronie /training/: krótkie filmy, każdy o jednym zadaniu.
  • Samouczki w aplikacji: prowadzone kroki na małym modelu stacji pogodowej, z panelem sprawdzającym pracę. Studenci uruchamiają je z poziomu Help → Tutorials na pasku bocznym. Projekty samouczków nie wliczają się do aktywnych projektów studenta.
  • Arkusze ćwiczeń z kluczem odpowiedzi, po jednym na ścieżkę szkoleniową (lista poniżej), do ćwiczeń poza zajęciami.

Ocenianą pracę wykonuje się na EO-1 Open MBSE Reference Model, fikcyjnym CubeSacie z celowo wbudowanymi lukami, niezaliczonymi testami i otwartą zmianą wymagania. Prezentacja Teaching with Holarch w pięć minut pokazuje stronę prowadzącego.

Lista kontrolna konfiguracji zajęć

Wykonaj te kroki tydzień lub dwa przed pierwszymi zajęciami. Ścieżka szkoleniowa 8, Teaching with Holarch, pokazuje każdy krok na ekranie, gdy tylko zostanie opublikowana na stronie szkoleń.

  1. Utwórz organizację zajęć. Account Settings → Organizations → Create Organization, z nazwą kursu. Twórca zostaje jej administratorem. (Ścieżka 8.1, Setting Up a Class Organization).
  2. Złóż wniosek o status zajęć. W Ustawienia organizacji otwórz organizację i w sekcji Klasa kliknij Request Class Status…. Podaj kurs, uczelnię i koniec semestru, dołącz sylabus (PDF lub Word) i wyślij. Holarch rozpatruje wniosek i odpowiada e-mailem. Status zajęć daje projektom organizacji 6 współpracowników w projekcie członka i 50 w projekcie prowadzącego, po 2 000 elementów każdy, oraz kartę Przegląd zajęć, a projekty te nie wliczają się do aktywnych projektów ich właścicieli. Zobacz Prowadzenie zajęć. (Ścieżka 8.2, Class Status and the Syllabus).
  3. Dodaj członków. W sekcji Członkowie wpisz adres e-mail każdego studenta, wybierz Członek i kliknij Add Member. Adres bez konta otrzymuje zaproszenie.
  4. Nadaj asystentom rolę administratora organizacji. Dodaj każdego asystenta z rolą Administrator organizacji, aby widział Class Review i mógł zarządzać listą uczestników. Administrowanie organizacją nie daje dostępu do treści projektów: projekty otwiera się przez ich własne udostępnianie.
  5. Niech każda grupa utworzy swój projekt. Lider grupy tworzy model EO-1 (Manage Projects → Project Files ▾ → New Demo Project → CubeSat (Guided systems engineering)), wybiera organizację zajęć w Share → Organization, zaprasza grupę jako edytorów, a prowadzącego i asystentów jako Recenzent. Recenzenci nie wliczają się do limitu współpracowników; mogą czytać, eksportować, komentować oraz zatwierdzać lub odrzucać wymagania i przeglądy dokumentów, ale nie mogą edytować.
  6. Opublikuj szablony. Jeśli zadanie zaczyna się od dokumentu, zbuduj go raz z wbudowanego szablonu, dodaj instrukcje do jego sekcji i zapisz poleceniem Write ▾ → Templates ▸ Save as Template… w organizacji jako domyślny dla jego typu. Studenci znajdą go wtedy wstępnie wybranego w + Nowy dokument. Zobacz Zapisywanie dokumentu jako szablonu. (Ścieżka 8.3, Assignments from Templates).
  7. Dodaj terminy. Organization Settings → Class Review → + New Assignment, z nazwą oraz datą i godziną terminu. W tym momencie Holarch zachowuje wersję każdego projektu grupy i liczniki każdego członka, aby można było później porównać dalszą pracę ze stanem w terminie. Zobacz Ustawianie terminu zadania.
  8. Zdecyduj w sprawie AI. AI działa zgodnie z ustawieniem organizacji zajęć. Na czas egzaminu odznacz Allow AI in this organization's projects i pozostaw zaznaczone Also turn off API and MCP access, aby narzędzia AI podłączone przez MCP również były wyłączone. Potem ponownie zaznacz pole AI i osobno włącz Dostęp przez API. Zobacz Wyłączanie AI dla organizacji. (Ścieżka 8.5, Turning AI Off for an Exam).
  9. Przypomnij studentom o kopiach. Studenci mogą w każdej chwili wyeksportować projekt. Poproś o eksport przed każdym terminem.

Korzystanie z Class Review

W Class Review czyta się pracę grup według stanu z terminu. Otwórz je w Organization Settings → Class Review albo naciśnij ⌘K / Ctrl+K i wybierz Przegląd zajęć.

  • Czytaj pracę. W sekcji Projekty grupowe kliknij projekt, aby go zobaczyć bez dołączania. Nazwy elementów otwierają podgląd z tekstem i komentarzami elementu.
  • Porównaj ze stanem w terminie. Wybierz zadanie w Porównaj z: liczniki pokazują wartości z terminu, a praca zmieniona lub dodana później jest oznaczona jako Changed after due date lub Added after due date. Holarch oznacza spóźnioną pracę; nie blokuje projektu w terminie.
  • Komentuj i zatwierdzaj w projekcie. Jako Reviewer projektu grupy dodawaj komentarze do elementów i używaj Zatwierdź oraz Odrzuć… przy wymaganiach w przeglądzie. (Ścieżka 8.4, Reviewing and Commenting on Student Work).
  • Eksportuj do dziennika ocen. W sekcji Zestawienie zajęć polecenie Eksportuj (Excel) daje jeden arkusz dla całych zajęć, jeden na grupę i jeden na studenta. Oceny i kryteria pozostają we własnym dzienniku ocen.

Oceniaj model i rozumowanie, które z niego wynika. Liczniki poszczególnych członków i Activity są dowodem w rzadkich przypadkach, gdy udział członka w pracy grupy budzi wątpliwości; nie są miarą jakości ani powodem do obserwowania każdego studenta. (Ścieżka 8.6, Evidence for Grading: Class Review and Activity).

Moduł 1: Wymagania i weryfikacja (2 tygodnie)

Studenci uczą się pisać i przeglądać wymagania, wiązać je z potrzebami i odczytywać pokrycie weryfikacją.

Tydzień 1: potrzeby, wymagania i powiązania

Tydzień 2: przegląd, linie bazowe i weryfikacja

Moduł 2: Architektura funkcjonalna i fizyczna (3 tygodnie)

Studenci dekomponują funkcje, budują warstwę logiczną między funkcjami a częściami, wyprowadzają interfejsy i śledzą zmianę w architekturze.

Tydzień 1: funkcje i pokrycie

Tydzień 2: alokacja i interfejsy

Tydzień 3: analiza i zmiana

  • Do obejrzenia: Simulation, Budgets and TPMs.
  • Samouczki: Simulate the Functional Flow i Baseline, Change, Impact.
  • Do oddania: A4. Jeśli w module jest miejsce na czwarty tydzień, dodaj A5 Przeprowadź zmianę: równania zasilania i TPM-2 z rozdziałów tego tygodnia są jego danymi wejściowymi.
  • Class Review: dodaj termin dla każdego zadania. Dla A4 porównaj ze stanem w terminie i otwórz nowe elementy logiczne oraz ich alokacje w projekcie każdej grupy; oddany opis architektury powinien odpowiadać zawartości modelu.

Moduł 3: Podstawy SysML v2 (2 tygodnie)

Studenci piszą mały model w notacji tekstowej SysML v2, oglądają go w widokach i uczą się, czego dowodzą kontrole narzędzia. Każda grupa tworzy projekt SysML v2 na swoją pracę; samouczki SysML v2 budują części samochodu hybrydowego.

Tydzień 1: struktura

Tydzień 2: wymagania i ograniczenia

Wariant z projektem grupowym

W projekcie semestralnym każda grupa modeluje wybrany przez siebie system, a nie EO-1, od potrzeb do weryfikacji. Strukturę kursu wyznaczają funkcje dla zajęć:

  • Jeden projekt na grupę w organizacji zajęć. Lider grupy tworzy projekt (pusty albo z przykładowego projektu startowego na stronie Dla zajęć), wybiera organizację zajęć w Share → Organization, zaprasza grupę jako edytorów, a kadrę dydaktyczną jako Reviewer.
  • Kamienie milowe jako terminy. Dodaj w Class Review jedno zadanie na kamień milowy, na przykład koncepcja i potrzeby, przegląd wymagań, architektura i plan weryfikacji. Każdy termin zachowuje wersję każdego projektu grupy, według której można oceniać.
  • Runda przeglądu w roli Reviewer. Przed kamieniem milowym wymagań grupy ustawiają swoje wymagania na In Review; prowadzący i asystenci komentują, zatwierdzają lub odrzucają, a grupy poprawiają i przesyłają ponownie, jak w A2. Przegląd koleżeński działa tak samo: dodaj członków innej grupy do projektu jako Reviewer.
  • Egzamin bez AI. Wyłącz AI dla organizacji, łącznie z dostępem API i MCP, na czas egzaminu, a potem włącz je ponownie (krok 8 listy kontrolnej).
  • Końcowa linia bazowa jako praca do oceny. Każda grupa zapisuje linię bazową projektu w Control & Reviews → Baselines & Versions → + Save Baseline…, nazwaną według oddawanej pracy, i eksportuje swoje produkty (na przykład specyfikację i plan weryfikacji do Worda). Oceniaj linię bazową, nie bieżący projekt.
  • Dowody wkładu tylko w razie potrzeby. Oceniaj grupę na podstawie modelu i jego uzasadnienia. Wkład członka otwieraj w Class Review tylko wtedy, gdy jego udział budzi wątpliwości.

Dostosuj kryteria oceny zadań EO-1 do każdego kamienia milowego: oceniają one osąd (kompletność łańcucha, jakość każdej decyzji, weryfikację w odróżnieniu od walidacji), a nie liczbę elementów.

Arkusze ćwiczeń

Każdy arkusz zawiera krótkie zadania ćwiczeniowe do jednej ścieżki szkoleniowej wraz z kluczem odpowiedzi, dla studentów, którzy chcą ćwiczyć więcej, niż dają zadania. Są publiczne, więc nie są pracą ocenianą.

Pomoc

W sprawie konfiguracji zajęć, statusu zajęć lub notatek z rozwiązaniami zadań A1–A6 skontaktuj się z nami, podając temat Instructor. Strony Prowadzenie zajęć i Wkład w Docs zawierają szczegóły każdego z powyższych kroków.

Wydawca: Holarch