課程使用
教師指南:用 Holarch 開設課程
說明如何在 Holarch 中設定課程,並在其中進行三個現成單元:需求與驗證、功能與實體架構,以及 SysML v2 基礎。每個單元列出學生觀看的訓練章節、在應用程式中完成的教學課程,以及要繳交的 EO-1 課堂作業。最後附上小組專案選項。
本頁內容
開始之前
Holarch 對學生與教師免費(請參閱 課程使用)。學生透過三種來源學習工具,課堂時間就能用在方法上:
- /training/ 上的訓練章節:簡短影片,每支一項任務。
- 應用程式內教學課程:在小型 Weather Station 模型上的引導步驟,並有面板檢查成果。學生從側欄的 Help → Tutorials 開始。教學課程專案不計入學生的使用中專案。
- 練習題單附解答,每個訓練系列一份(列於下方),供課外練習。
評分作業使用 EO-1 Open MBSE Reference Model,這是一顆虛構的 CubeSat,刻意內建了缺口、失敗的測試與一項未結的需求變更。Teaching with Holarch 導覽 用五分鐘介紹教師端的功能。
課程設定檢查清單
請在第一堂課前一到兩週完成。Training Track 8「Teaching with Holarch」在 訓練頁面 上發布後,會在畫面上示範每個步驟。
- 建立課程組織。Account Settings → Organizations → Create Organization,以課程名稱命名。您會成為其組織管理員。(Track 8.1,Setting Up a Class Organization。)
- 申請課程身分。在 組織設定 中開啟組織,在 類別 之下按一下 Request Class Status…。輸入課程、學校與學期結束日,附上課程大綱(PDF 或 Word)後送出。Holarch 會審查申請並以電子郵件通知您。課程身分讓組織的專案享有:成員的專案 6 位協作者、您的專案 50 位協作者、每個專案 2,000 個項目,以及 班級審查 分頁;這些專案也不計入擁有者的使用中專案。請參閱 開設課程。(Track 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 之下選擇課程組織,邀請組員為編輯者,並邀請您與助教為 審查者。Reviewer 不計入協作者上限;他們可以閱讀、匯出、留言,以及核准或駁回需求與文件審查,但無法編輯。
- 發布您的範本。若作業從文件開始,請先以內建範本建立一次,在各章節加入您的說明,再以 Write ▾ → Templates ▸ Save as Template… 儲存到組織,並設為該類型的預設範本。學生在 + 新增文件 中就會看到它已預先選取。請參閱 將文件儲存為範本。(Track 8.3,Assignments from Templates。)
- 新增到期日。Organization Settings → Class Review → + New Assignment,輸入名稱以及到期日期與時間。在那一刻,Holarch 會保留每個小組專案的一個版本以及每位成員的計數,讓您日後能將之後的作業與到期日時的狀態比較。請參閱 設定作業到期日。
- 決定 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。)
- 提醒學生保留副本。學生隨時可以匯出專案。請在每個截止日前要求他們匯出。
使用 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 週:需要、需求與追溯
- 觀看: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 教學界限:Editor 檢查什麼、哪些只保留而不解讀,以及為什麼「Holarch 尚未支援」不等於「不允許」。
第 2 週:需求與約束
- 觀看:Requirements、Verification and Traceability、Constraints and Calculations。
- 教學課程:Requirements 與 Constraints and Calculations。
- 繳交:單獨的 A6 B 部分:以 SysML v2 表示的 EO-1 電力子系統、30 W 變更、滿足該變更的設計,以及說明哪些經過檢查、哪些只被保留的半頁文字。
- Class Review:新增到期日。請將檔案與半頁說明一起閱讀:成績取決於說明,因為 0 個診斷本身只能證明檢查所涵蓋的內容。
小組專案選項
學期專題中,每組自選一個系統(而非 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 聯絡我們。文件中的 開設課程 與 貢獻 頁面詳述上述每個步驟。