Para turmas
Guia do instrutor: ministrar um curso com o Holarch
Como preparar uma turma no Holarch e conduzir nela três módulos prontos: requisitos e verificação, arquitetura funcional e física, e fundamentos de SysML v2. Cada módulo lista os capítulos de treinamento que os alunos assistem, os tutoriais no app que eles concluem e o trabalho de aula do EO-1 que entregam. Em seguida há uma opção de projeto em grupo.
Nesta página
Antes de começar
O Holarch é gratuito para alunos e instrutores (veja Para turmas). Os alunos aprendem a ferramenta por três fontes, para que o tempo de aula fique para o método:
- Capítulos de treinamento em /training/: vídeos curtos, uma tarefa cada.
- Tutoriais no app: passos guiados em um pequeno modelo de estação meteorológica, com um painel que checa o trabalho. Os alunos os iniciam em Ajuda → Tutoriais na barra lateral. Projetos de tutorial não contam para os projetos ativos de um aluno.
- Listas de exercícios com gabarito, uma por trilha de treinamento (listadas abaixo), para praticar fora da aula.
O trabalho avaliado usa o EO-1 Open MBSE Reference Model, um CubeSat fictício com lacunas, testes reprovados e uma mudança de requisito em aberto embutidos de propósito. O tour guiado Teaching with Holarch mostra o lado do instrutor em cinco minutos.
Lista de verificação para preparar a turma
Faça isto uma ou duas semanas antes da primeira aula. A trilha de treinamento 8, Teaching with Holarch, mostra cada passo na tela assim que for publicada na página de treinamento.
- Crie a organização da turma. Ajustes da conta → Organizações → Criar organização, com o nome do curso. Você passa a ser o administrador da organização. (Trilha 8.1, Setting Up a Class Organization.)
- Solicite o status de turma. Em Ajustes da organização, abra a organização e, em Turma, clique em Request Class Status…. Informe o curso, a instituição e o fim do período letivo, anexe o plano de ensino (PDF ou Word) e envie. O Holarch analisa a solicitação e envia um e-mail a você. O status de turma dá aos projetos da organização 6 colaboradores no projeto de um membro e 50 nos seus, 2.000 itens cada, e a aba Revisão da turma, e seus projetos não contam para os projetos ativos dos proprietários. Veja Conduzir uma turma. (Trilha 8.2, Class Status and the Syllabus.)
- Adicione os membros. Em Membros, informe o endereço de e-mail de cada aluno, escolha Membro e clique em Add Member. Um endereço sem conta recebe um convite.
- Torne seus monitores administradores da organização. Adicione cada monitor como Admin da organização, para que vejam a Revisão da turma e possam gerenciar a lista de alunos. Administrar uma organização não dá acesso ao conteúdo dos projetos: os projetos são abertos pelo seu próprio compartilhamento.
- Peça que cada grupo crie seu projeto. O líder do grupo cria o modelo EO-1 (Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)), escolhe a organização da turma em Compartilhar → Organização, convida o grupo como editores e você e seus monitores como Revisor. Revisores não contam no limite de colaboradores; podem ler, exportar, comentar e aprovar ou rejeitar requisitos e revisões de documentos, mas não editar.
- Publique seus modelos. Se um trabalho começa a partir de um documento, crie-o uma vez a partir de um modelo integrado, adicione suas instruções às seções e salve-o com Escrever ▾ → Modelos ▸ Salvar como modelo… na organização, como padrão do seu tipo. Os alunos então o encontram pré-selecionado em + Novo documento. Veja Salvar um documento como modelo. (Trilha 8.3, Assignments from Templates.)
- Cadastre os prazos. Ajustes da organização → Revisão da turma → + Nova entrega, com um nome e a data e hora do prazo. Nesse momento, o Holarch guarda uma versão de cada projeto de grupo e as contagens de cada membro, para que você possa comparar o trabalho posterior com o prazo. Veja Definir o prazo de um trabalho.
- Decida sobre a IA. A IA segue o ajuste da organização da turma. Para uma prova, desmarque Allow AI in this organization's projects e mantenha Also turn off API and MCP access marcado, para que ferramentas de IA conectadas por MCP também fiquem desligadas. Depois, marque de novo a caixa de IA e reative o Acesso à API separadamente. Veja Desligar a IA em uma organização. (Trilha 8.5, Turning AI Off for an Exam.)
- Peça aos alunos que guardem cópias. Os alunos podem exportar um projeto a qualquer momento. Peça uma exportação antes de cada prazo.
Usar a Revisão da turma
A Revisão da turma é onde você lê o trabalho dos grupos em um prazo. Abra-a em Ajustes da organização → Revisão da turma ou pressione ⌘K / Ctrl+K e escolha Revisão da turma.
- Leia o trabalho. Em Projetos em grupo, clique em um projeto para vê-lo sem entrar nele. Os nomes dos itens abrem uma prévia com o texto e os comentários do item.
- Compare com um prazo. Escolha o trabalho em Comparar com: as contagens mostram o valor no prazo, e o trabalho alterado ou adicionado depois é marcado como Changed after due date ou Added after due date. O Holarch marca o trabalho atrasado; ele não bloqueia o projeto no prazo.
- Comente e aprove no projeto. Como Revisor do projeto do grupo, adicione comentários aos itens e use Aprovar e Rejeitar… nos requisitos em revisão. (Trilha 8.4, Reviewing and Commenting on Student Work.)
- Exporte para o diário de notas. Em Consolidado da turma, Exportar (Excel) gera uma planilha para a turma, uma por grupo e uma por aluno. Notas e rubricas ficam no seu próprio diário de notas.
Avalie o modelo e o raciocínio que você lê nele. As contagens por membro e a Atividade são evidência para o caso raro em que a participação de um membro no trabalho do grupo é questionada; não são medida de qualidade nem motivo para vigiar cada aluno. (Trilha 8.6, Evidence for Grading: Class Review and Activity.)
Módulo 1: Requisitos e verificação (2 semanas)
Os alunos aprendem a escrever e revisar requisitos, rastreá-los até as necessidades e ler a cobertura de verificação.
Semana 1: necessidades, requisitos e rastreamento
- Assistir: Writing Requirements and the Quality Check, Tracing Needs to Requirements, Open Items and Approvals. Usuários novos assistem antes a The Holarch Workspace.
- Tutoriais: Write Good Requirements e Trace Requirements.
- Entregar: A1 Rastrear uma necessidade (individual, uma nota escrita).
- Revisão da turma: o A1 não muda nada no modelo, então não precisa de prazo na Revisão da turma. Cadastre agora o prazo do A2 para que os grupos vejam a data-limite.
Semana 2: revisão, linhas de base e verificação
- Assistir: Baselines and Links to Review, Verification and the Test Center, RVTM and VCRM.
- Tutoriais: Verify the Requirements.
- Entregar: A2 Retrabalho e revisão de requisitos (grupos). Planeje a rodada de revisão para o meio da semana: os grupos colocam seus três requisitos em In Review, você comenta e aprova ou rejeita como Revisor, e eles respondem antes do prazo.
- Revisão da turma: compare cada projeto de grupo com o prazo do A2, leia os três requisitos, seus comentários de revisão e a especificação com linha de base. Continuação opcional: A3 Encontrar as lacunas de cobertura como terceira semana ou como tarefa de casa.
Módulo 2: Arquitetura funcional e física (3 semanas)
Os alunos decompõem funções, constroem uma camada lógica entre as funções e as partes, derivam interfaces e acompanham uma mudança pela arquitetura.
Semana 1: funções e cobertura
- Assistir: Functions and the FFBD, Action Diagrams.
- Tutoriais: Functional Analysis.
- Entregar: A3 Encontrar as lacunas de cobertura (grupos). Ele mostra aos alunos onde a arquitetura é fraca antes de estendê-la.
Semana 2: alocação e interfaces
- Assistir: Allocation, Interfaces.
- Tutoriais: Physical Architecture and Allocation e Interfaces.
- Iniciar: A4 Estender a arquitetura (grupos, prazo no fim da semana 3).
Semana 3: análise e mudança
- Assistir: Simulation, Budgets and TPMs.
- Tutoriais: Simulate the Functional Flow e Baseline, Change, Impact.
- Entregar: A4. Se o módulo tiver espaço para uma quarta semana, adicione A5 Tratar a mudança: as equações de potência e o TPM-2 dos capítulos desta semana são suas entradas.
- Revisão da turma: cadastre um prazo por trabalho. Para o A4, compare com o prazo e abra os novos elementos lógicos e suas alocações no projeto de cada grupo; a descrição de arquitetura entregue deve corresponder ao que o modelo contém.
Módulo 3: Fundamentos de SysML v2 (2 semanas)
Os alunos escrevem um pequeno modelo na notação textual do SysML v2, veem-no como visões e aprendem o que as checagens da ferramenta comprovam. Cada grupo cria um projeto SysML v2 para o seu trabalho; os tutoriais de SysML v2 constroem partes de um carro híbrido.
Semana 1: estrutura
- Assistir: Definitions and Attributes, Ports and Interfaces, Actions and Flows.
- Tutoriais: Getting Started, Definitions and Attributes e Ports and Interfaces.
- Em aula: percorra os limites didáticos do SysML v2: o que o Editor checa, o que ele guarda sem interpretar e por que “ainda não no Holarch” não é “não permitido”.
Semana 2: requisitos e restrições
- Assistir: Requirements, Verification and Traceability, Constraints and Calculations.
- Tutoriais: Requirements e Constraints and Calculations.
- Entregar: A6 parte B isoladamente: o subsistema de energia do EO-1 em SysML v2, a mudança para 30 W, um projeto que a atenda e a meia página sobre o que foi checado e o que foi apenas guardado.
- Revisão da turma: cadastre o prazo. Leia o arquivo e a meia página juntos: a nota se apoia na explicação, já que 0 diagnósticos por si só comprova apenas o que as checagens cobrem.
Opção de projeto em grupo
Em um projeto semestral, cada grupo modela um sistema à sua escolha, não o EO-1, das necessidades à verificação. Os recursos de turma sustentam a estrutura do curso:
- Um projeto por grupo na organização da turma. O líder do grupo cria o projeto (em branco ou a partir do exemplo inicial de turma em Para turmas), escolhe a organização da turma em Compartilhar → Organização, convida o grupo como editores e a equipe docente como Revisor.
- Marcos como prazos. Adicione um trabalho na Revisão da turma por marco, por exemplo conceito e necessidades, revisão de requisitos, arquitetura e plano de verificação. Cada prazo guarda uma versão de cada projeto de grupo para avaliação.
- Uma rodada de revisão como Revisor. Antes do marco de requisitos, os grupos colocam seus requisitos em In Review; você e os monitores comentam, aprovam ou rejeitam, e os grupos retrabalham e reenviam, como no A2. A revisão por pares funciona do mesmo modo: adicione os membros de outro grupo a um projeto como Revisor.
- Um período de prova sem IA. Desligue a IA na organização, com o acesso por API e MCP, durante a prova e religue-a depois (passo 8 da lista de verificação).
- Uma linha de base final como entrega. Cada grupo salva uma linha de base do projeto em Controle e revisões → Linhas de base e versões → + Salvar linha de base…, com o nome da entrega, e exporta seus entregáveis (por exemplo, a especificação e o plano de verificação para Word). Avalie a linha de base, não o projeto vivo.
- Evidência de contribuição só quando necessário. Avalie o grupo pelo modelo e pelo raciocínio. Abra as contribuições de um membro na Revisão da turma apenas quando a participação dele for questionada.
Adapte as rubricas dos trabalhos do EO-1 a cada marco: elas avaliam julgamento (completude da cadeia, qualidade de cada decisão, verificação em contraste com validação), não o número de itens.
Listas de exercícios
Cada lista contém tarefas curtas de prática para uma trilha de treinamento, com gabarito, para alunos que queiram praticar mais do que os trabalhos oferecem. Elas são públicas, portanto não são trabalho avaliado.
- Primeiros passos
- Requisitos e verificação
- Comportamento e arquitetura
- Documentos e entregáveis
- Fundamentos de SysML v2
Obter ajuda
Para a preparação da turma, uma dúvida sobre o status de turma ou as notas de solução de A1 a A6, fale conosco com o assunto Instructor. As páginas Conduzir uma turma e Contribuições dos Docs trazem os detalhes de cada passo acima.