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 開始。教學課程專案不計入學生的使用中專案。
  • 練習題單附解答,每個訓練系列一份(列於下方),供課外練習。

評分作業使用 EO-1 Open MBSE Reference Model,這是一顆虛構的 CubeSat,刻意內建了缺口、失敗的測試與一項未結的需求變更。Teaching with Holarch 導覽 用五分鐘介紹教師端的功能。

課程設定檢查清單

請在第一堂課前一到兩週完成。Training Track 8「Teaching with Holarch」在 訓練頁面 上發布後,會在畫面上示範每個步驟。

  1. 建立課程組織。Account Settings → Organizations → Create Organization,以課程名稱命名。您會成為其組織管理員。(Track 8.1,Setting Up a Class Organization。)
  2. 申請課程身分。在 組織設定 中開啟組織,在 類別 之下按一下 Request Class Status…。輸入課程、學校與學期結束日,附上課程大綱(PDF 或 Word)後送出。Holarch 會審查申請並以電子郵件通知您。課程身分讓組織的專案享有:成員的專案 6 位協作者、您的專案 50 位協作者、每個專案 2,000 個項目,以及 班級審查 分頁;這些專案也不計入擁有者的使用中專案。請參閱 開設課程。(Track 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 之下選擇課程組織,邀請組員為編輯者,並邀請您與助教為 審查者。Reviewer 不計入協作者上限;他們可以閱讀、匯出、留言,以及核准或駁回需求與文件審查,但無法編輯。
  6. 發布您的範本。若作業從文件開始,請先以內建範本建立一次,在各章節加入您的說明,再以 Write ▾ → Templates ▸ Save as Template… 儲存到組織,並設為該類型的預設範本。學生在 + 新增文件 中就會看到它已預先選取。請參閱 將文件儲存為範本。(Track 8.3,Assignments from Templates。)
  7. 新增到期日。Organization Settings → Class Review → + New Assignment,輸入名稱以及到期日期與時間。在那一刻,Holarch 會保留每個小組專案的一個版本以及每位成員的計數,讓您日後能將之後的作業與到期日時的狀態比較。請參閱 設定作業到期日。
  8. 決定 AI 的使用。AI 依循課程組織的設定。考試時,請取消勾選 Allow AI in this organization's projects,並保持勾選 Also turn off API and MCP access,讓透過 MCP 連接的 AI 工具也一併關閉。考試結束後,重新勾選 AI 方塊,並另外重新開啟 API 存取。請參閱 為組織關閉 AI。(Track 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 身分在項目上留言,並對審查中的需求使用 核准 與 拒絕…。(Track 8.4,Reviewing and Commenting on Student Work。)
  • 匯出到成績簿。在 班級彙總 之下,匯出(Excel) 會產生全班一張工作表、每組一張以及每位學生一張。成績與評分量表保留在您自己的成績簿中。

請依模型以及您在其中讀到的推理評分。各成員的計數與 Activity 是證據,用於少數成員在小組作業中的貢獻有疑問的情況;它們不是品質的衡量標準,也不是監看每位學生的理由。(Track 8.6,Evidence for Grading: Class Review and Activity。)

單元 1:需求與驗證(2 週)

學生學習撰寫與審查需求、將需求追溯到需要,並解讀驗證涵蓋範圍。

第 1 週:需要、需求與追溯

第 2 週:審查、基準線與驗證

單元 2:功能與實體架構(3 週)

學生分解功能、在功能與零件之間建立邏輯層、推導介面,並追蹤一項變更在架構中的影響。

第 1 週:功能與涵蓋範圍

第 2 週:配置與介面

第 3 週:分析與變更

單元 3:SysML v2 基礎(2 週)

學生以 SysML v2 文字表示法撰寫一個小型模型,以檢視呈現它,並了解工具的檢查能證明什麼。每組為作業建立一個 SysML v2 專案;SysML v2 教學課程會建構一輛油電混合車的部分零件。

第 1 週:結構

第 2 週:需求與約束

小組專案選項

學期專題中,每組自選一個系統(而非 EO-1),從需要一路建模到驗證。課程功能負責承載課程結構:

  • 課程組織中每組一個專案。組長建立專案(空白,或從 課程使用 上的範例課程起始專案建立),在 Share → Organization 之下選擇課程組織,邀請組員為編輯者、教學團隊為 Reviewer。
  • 以里程碑作為到期日。每個里程碑新增一項 Class Review 作業,例如概念與需要、需求審查、架構與驗證計畫。每個到期日都會保留每個小組專案的一個版本,作為評分依據。
  • 以 Reviewer 身分進行審查回合。在需求里程碑之前,各組將需求設為 In Review;您與助教留言、核准或駁回,各組修訂後重新提交,與 A2 相同。同儕審查也以同樣方式進行:將另一組的成員以 Reviewer 身分加入專案。
  • 不使用 AI 的考試時段。考試期間為組織關閉 AI(連同 API 與 MCP 存取),考後再重新開啟(檢查清單步驟 8)。
  • 以最終基準線作為繳交成果。每組在 Control & Reviews → Baselines & Versions → + Save Baseline… 之下儲存專案基準線,以繳交名稱命名,並匯出交付物(例如將規格書與驗證計畫匯出為 Word)。請依基準線評分,而非即時專案。
  • 僅在必要時查看貢獻證據。依模型及其推理為小組評分。只有在某位成員的貢獻有疑問時,才在 Class Review 中開啟該成員的貢獻。

請為每個里程碑調整 EO-1 作業的評分量表:它們評的是判斷力(鏈的完整性、每項決策的品質、驗證與確認的區分),而不是項目數量。

練習題單

每份題單包含一個訓練系列的簡短練習任務並附解答,供需要比作業更多練習的學生使用。題單公開,因此不作為評分作業。

取得協助

如需課程設定、課程身分相關問題,或 A1 到 A6 的 解答說明,請以主題 Instructor 聯絡我們。文件中的 開設課程 與 貢獻 頁面詳述上述每個步驟。

由 Holarch發布