수업용
강사 가이드: Holarch로 과정 가르치기
Holarch에서 수업을 설정하고 그 위에서 바로 쓸 수 있는 세 가지 모듈을 운영하는 방법입니다: 요구사항과 검증, 기능 및 물리 아키텍처, SysML v2 기초. 각 모듈에는 학생이 시청할 교육 장, 완료할 앱 내 튜토리얼, 제출할 EO-1 수업 과제가 나와 있습니다. 그다음에 그룹 프로젝트 옵션이 이어집니다.
이 페이지의 내용
시작하기 전에
Holarch는 학생과 강사에게 무료입니다(수업용 참조). 학생은 세 가지 자료로 도구를 배우므로 수업 시간은 방법론에 쓸 수 있습니다:
- /training/의 교육 장: 하나의 작업을 다루는 짧은 동영상.
- 앱 내 튜토리얼: 작업을 검사하는 패널과 함께 작은 Weather Station 모델에서 진행하는 안내 단계. 학생은 레일의 도움말 → 튜토리얼에서 시작합니다. 튜토리얼 프로젝트는 학생의 활성 프로젝트 수에 포함되지 않습니다.
- 수업 외 연습을 위한 교육 트랙별 해답이 포함된 연습 문제지(아래 목록).
평가 대상 과제는 EO-1 Open MBSE 참조 모델을 사용합니다. 이 모델은 빈틈, 실패한 테스트, 미결 요구사항 변경을 의도적으로 넣어 둔 가상의 CubeSat입니다. Holarch로 가르치기 가이드 투어는 강사 측 화면을 5분 안에 보여 줍니다.
수업 설정 체크리스트
첫 수업 1~2주 전에 진행하십시오. 교육 트랙 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 커버리지 빈틈 찾기를 3주차나 숙제로 진행합니다.
모듈 2: 기능 및 물리 아키텍처(3주)
학생은 기능을 분해하고, 기능과 부품 사이에 논리 계층을 만들고, 인터페이스를 도출하며, 아키텍처를 따라 변경을 추적합니다.
1주차: 기능과 커버리지
- 시청: 기능과 FFBD, Action 다이어그램.
- 튜토리얼: 기능 분석.
- 제출: A3 커버리지 빈틈 찾기(그룹). 학생이 아키텍처를 확장하기 전에 어디가 부족한지 보여 줍니다.
2주차: 할당과 인터페이스
- 시청: 할당, 인터페이스.
- 튜토리얼: 물리 아키텍처와 할당 및 인터페이스.
- 시작: A4 아키텍처 확장(그룹, 3주차 말 마감).
3주차: 분석과 변경
- 시청: 시뮬레이션, 예산과 TPM.
- 튜토리얼: 기능 흐름 시뮬레이션 및 베이스라인, 변경, 영향.
- 제출: A4. 모듈에 4주차 여유가 있다면 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로 하여 문의하십시오. Docs의 수업 운영 및 기여도 페이지에 위의 모든 단계가 자세히 나와 있습니다.