面向课程
讲师指南:使用 Holarch 讲授一门课程
如何在 Holarch 中设置班级,并在其中运行三个现成模块:需求与验证、功能与物理架构,以及 SysML v2 基础。每个模块列出学生观看的培训章节、完成的应用内教程以及提交的 EO-1 课程作业。随后是一个小组项目选项。
本页内容
开始之前
Holarch 对学生和讲师免费(参见面向课程)。学生通过三种途径学习该工具,课堂时间因此可以用于讲授方法:
- 培训章节,位于 /training/:简短视频,每个视频一项任务。
- 应用内教程:在一个小型气象站模型上的引导步骤,附有检查操作的面板。学生从导航栏中的帮助 → 教程启动教程。教程项目不计入学生的活动项目数。
- 练习单,附答案,每个培训课程系列一份(见下文列表),供课外练习。
评分作业使用 EO-1 开放 MBSE 参考模型,这是一颗虚构的立方星,其中特意设置了缺口、失败的测试和一项未决的需求变更。“使用 Holarch 教学”导览用五分钟展示讲师端的操作。
班级设置清单
在第一次课前一到两周完成以下步骤。培训课程系列 8“使用 Holarch 教学”在培训页面上发布后,会在屏幕上演示每个步骤。
- 创建班级组织。账户设置 → 组织 → 创建组织,以课程命名。您将成为其组织管理员。(课程 8.1,设置班级组织。)
- 申请班级状态。在组织设置中打开该组织,在班级下点击申请班级状态…。输入课程、学校和学期结束日期,附上教学大纲(PDF 或 Word)并发送。Holarch 会审核申请并通过电子邮件通知您。班级状态为组织的项目提供以下权益:成员的项目可有 6 名协作者,您的项目可有 50 名,每个项目 2,000 个条目,并提供班级评审标签页;其项目不计入所有者的活动项目数。参见运行班级。(课程 8.2,班级状态与教学大纲。)
- 添加成员。在成员下输入每位学生的电子邮件地址,选择成员,然后点击添加成员。没有账户的地址会收到邀请。
- 将助教设为组织管理员。以组织管理员身份添加每位助教,使其可以查看班级评审并管理名单。管理组织不提供对项目内容的访问权限:项目通过各自的共享设置打开。
- 让每个小组创建自己的项目。小组负责人创建 EO-1 模型(管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程)),在共享 → 组织下选择班级组织,邀请小组成员为编辑者,并邀请您和助教为评审者。评审者不计入协作者上限;他们可以阅读、导出、评论,以及审批或拒绝需求和文档评审,但不能编辑。
- 发布模板。如果某项作业从文档开始,可基于内置模板创建一次该文档,在其各节中添加说明,然后用编写 ▾ → 模板 ▸ 另存为模板…将其保存到组织,作为该类型的默认模板。学生随后会在+ 新建文档中看到它已被预先选中。参见将文档另存为模板。(课程 8.3,基于模板的作业。)
- 添加截止日期。组织设置 → 班级评审 → + 新建作业,填写名称以及截止日期和时间。到那一刻,Holarch 会保留每个小组项目的一个版本以及每位成员的计数,以便之后将后续工作与截止日期进行比较。参见设置作业截止日期。
- 决定 AI 的使用。AI 遵循班级组织的设置。考试时,取消勾选允许在此组织的项目中使用 AI,并保持勾选同时关闭 API 和 MCP 访问,这样通过 MCP 连接的 AI 工具也会关闭。考试结束后,重新勾选 AI 复选框,并单独重新开启 API 访问。参见为组织关闭 AI。(课程 8.5,考试时关闭 AI。)
- 提醒学生保留副本。学生可以随时导出项目。要求学生在每个截止日期前提交一份导出。
使用班级评审
班级评审用于在截止日期阅读小组作业。在组织设置 → 班级评审下打开,或按 ⌘K / Ctrl+K 并选择班级评审。
- 阅读作业。在小组项目下点击一个项目,即可在不加入的情况下查看。点击条目名称会打开预览,显示条目的文本和评论。
- 与截止日期比较。在比较对象下选择作业:计数显示截止日期时的值,之后更改或添加的工作会标记为截止日期后已更改或截止日期后已添加。Holarch 会标记逾期的工作,但不会在截止日期锁定项目。
- 在项目中评论和审批。作为小组项目的评审者,可以在条目上添加评论,并对评审中的需求使用审批和拒绝…。(课程 8.4,评审和评论学生作业。)
- 导出到成绩册。在班级汇总下,导出(Excel)会生成班级一张工作表、每个小组一张、每位学生一张。成绩和评分标准保留在您自己的成绩册中。
根据模型以及从中读出的推理过程评分。按成员统计的计数和活动记录仅用于少数情况下作为证据,即某位成员在小组作业中的份额存在疑问时;它们不是质量的衡量标准,也不是监视每位学生的理由。(课程 8.6,评分证据:班级评审与活动。)
模块 1:需求与验证(2 周)
学生学习编写和评审需求、将需求追溯到需要,并解读验证覆盖率。
第 1 周:需要、需求与追溯
- 观看:编写需求与质量检查、将需要追溯到需求、未决条目与审批。新用户先观看 Holarch 工作区。
- 教程:编写好的需求和追溯需求。
- 提交:A1 追溯一项需要(个人,一份书面说明)。
- 班级评审:A1 不更改模型中的任何内容,因此不需要在班级评审中设置截止日期。现在就添加 A2 的截止日期,让各小组看到期限。
第 2 周:评审、基线与验证
- 观看:基线与待检查的链接、验证与测试中心、RVTM 与 VCRM。
- 教程:验证需求。
- 提交:A2 需求返工与评审(小组)。将评审轮次安排在一周的中间:各小组将其三项需求设为“评审中”,您作为评审者进行评论并审批或拒绝,各小组在截止日期前作出回应。
- 班级评审:将每个小组项目与 A2 截止日期进行比较,阅读三项需求、其评审评论以及已建立基线的规格说明。可选的后续作业:将 A3 找出覆盖缺口作为第三周内容或课后作业。
模块 2:功能与物理架构(3 周)
学生分解功能,在功能与部件之间构建逻辑层,推导接口,并跟踪一项变更在架构中的传播。
第 1 周:功能与覆盖率
第 2 周:分配与接口
第 3 周:分析与变更
- 观看:仿真、预算与 TPM。
- 教程:仿真功能流和基线、变更、影响。
- 提交:A4。如果模块有余地安排第四周,可加入 A5 处理变更:本周章节中的功率方程和 TPM-2 是它的输入。
- 班级评审:为每项作业添加截止日期。对于 A4,与截止日期进行比较,并在每个小组的项目中打开新增的逻辑元素及其分配;小组提交的架构描述应与模型中的内容一致。
模块 3:SysML v2 基础(2 周)
学生用 SysML v2 文本表示法编写一个小型模型,以视图形式查看它,并了解工具的检查能证明什么。每个小组为其作业创建一个 SysML v2 项目;SysML v2 教程会构建一辆混合动力汽车的各个部件。
第 1 周:结构
- 观看:定义与属性、端口与接口、动作与流。
- 教程:入门、定义与属性和端口与接口。
- 课堂上:讲解 SysML v2 教学边界:编辑器检查什么、保留但不解释什么,以及为什么“Holarch 尚不支持”不等于“不允许”。
第 2 周:需求与约束
- 观看:需求、验证与可追溯性、约束与计算。
- 教程:需求和约束与计算。
- 提交:单独提交 A6 B 部分:用 SysML v2 表示的 EO-1 电源子系统、30 W 变更、满足该变更的设计,以及半页关于哪些内容经过检查、哪些仅被保留的说明。
- 班级评审:添加截止日期。将文件与半页说明一起阅读:成绩取决于说明,因为仅有 0 条诊断只能证明检查所覆盖的内容。
小组项目选项
对于学期项目,每个小组对自选的系统(而非 EO-1)建模,从需要一直到验证。班级功能承载课程结构:
- 班级组织中每个小组一个项目。小组负责人创建项目(空白项目,或基于面向课程页面上的示例课程入门项目),在共享 → 组织下选择班级组织,邀请小组成员为编辑者,并邀请教学人员为评审者。
- 以截止日期作为里程碑。为每个里程碑添加一项班级评审作业,例如概念与需要、需求评审、架构和验证计划。每个截止日期都会保留每个小组项目的一个版本,作为评分依据。
- 以评审者身份进行一轮评审。在需求里程碑之前,各小组将需求设为“评审中”;您和助教进行评论、审批或拒绝,各小组返工并重新提交,与 A2 相同。同伴评审的方式相同:将另一个小组的成员以评审者身份添加到项目中。
- 无 AI 的考试时段。考试期间为组织关闭 AI(连同 API 和 MCP 访问),考试结束后重新开启(清单第 8 步)。
- 以最终基线作为提交物。每个小组在控制与评审 → 基线和版本 → + 保存基线…下保存项目基线,以提交内容命名,并导出交付物(例如将规格说明和验证计划导出为 Word)。对基线评分,而不是对实时项目评分。
- 仅在需要时使用贡献证据。根据模型及其推理为小组评分。仅在某位成员的份额存在疑问时,才在班级评审中打开该成员的贡献。
针对每个里程碑调整 EO-1 作业的评分标准:它们评判的是判断力(链条的完整性、每项决策的质量、验证与确认的区分),而不是条目数量。
练习单
每份练习单包含一个培训课程系列的简短练习任务,附答案,供希望在作业之外多加练习的学生使用。练习单是公开的,因此不作为评分作业。
获取帮助
关于班级设置、班级状态问题或 A1 至 A6 的答案说明,可以主题 Instructor 联系我们。文档中的运行班级和贡献页面详细介绍了上述每个步骤。