Holarch

Pacote do instrutor · v1.0

Ensinar com o Holarch: pacote do instrutor

Resultados de aprendizagem e seis trabalhos com rubricas para um curso semestral de engenharia de sistemas ou MBSE, todos baseados no EO-1 Open MBSE Reference Model v1.1, um CubeSat 6U fictício de observação da Terra. Gratuito sob CC BY 4.0.

Baixar o pacote do instrutor v1.0

Todos os arquivos (.zip, 17 KB)

Arquivos Markdown que abrem em qualquer editor. Usa o EO-1 Reference Model v1.1. Licença: CC BY 4.0, crédito “Holarch”.

Nesta página
  1. O que ele contém
  2. Como usá-lo
  3. Notas de solução
  4. Resultados de aprendizagem
    1. Correspondência com os trabalhos
  5. A1 · Rastrear uma necessidade
  6. A2 · Retrabalho e revisão de requisitos
  7. A3 · Encontrar as lacunas de cobertura
  8. A4 · Estender a arquitetura
  9. A5 · Tratar a mudança
  10. A6 · Plano de validação
  11. Ensinar SysML v2 com o Holarch: o que ele checa e o que apenas guarda
  12. Downloads
  13. Versões
  14. Como citar
  15. Licença

O que ele contém

ArquivoParaO que ele contém
learning-outcomes.mdInstrutores, registros de acreditaçãoOs resultados de aprendizagem do curso, os trabalhos que avaliam cada um e os recursos do Holarch usados.
assignments/A1-trace-a-need.md a A6-validation-plan.mdAlunos (para distribuir)Seis trabalhos sobre o EO-1, cada um com contexto, tarefa, o que entregar e uma rubrica.
sysml-v2-teaching-boundaries.mdInstrutoresO que os projetos SysML v2 do Holarch checam, o que guardam sem interpretar e o que ainda não está disponível.

Como usá-lo

  1. Dê a cada grupo sua própria cópia do EO-1 v1.1. No Holarch: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat EO-1, ou baixe eo-1-v1.1.holarch.json em holarch.app/reference-models/eo-1/ e importe-o com Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto…. Todo trabalho parte do modelo tal como é distribuído.
  2. Conduza o curso em uma organização de turma. Adicione cada trabalho com seu prazo em Ajustes da organização → Revisão da turma → + Nova entrega. A Revisão da turma guarda uma versão de cada projeto de grupo em cada prazo e mostra o trabalho de cada aluno.
  3. Para o A2, entre em cada projeto de grupo como Revisor: você pode comentar, aprovar, rejeitar e reabrir requisitos, e nada mais.
  4. Para o A6, os alunos partem do modelo integrado Verification and Validation Plan. Para lhes dar uma versão enxuta com suas próprias instruções, salve uma como modelo da organização (Escrever ▾ → Modelos ▸ Salvar como modelo…, Salvar em: Organização) e torne-a o padrão para Test Plan Document.
  5. Defina os pesos, os tamanhos de grupo e os prazos do seu curso. Os pesos indicados são sugestões.

Os trabalhos citam páginas do Holarch, mas toda pergunta também pode ser respondida com os arquivos CSV do EO-1, para que alunos que trabalham em outra ferramenta possam participar.

Notas de solução

As notas de solução, com constatações esperadas, respostas de exemplo e erros comuns de A1 a A6, não são publicadas, para que os alunos não possam baixar as respostas. Os instrutores as baixam no Holarch: Ajustes da organização → Revisão da turma → Baixar notas de resolução. O botão aparece para os administradores (instrutores e monitores) de uma organização com status de turma.

Resultados de aprendizagem

Curso: Model-Based Systems Engineering, um semestre, graduação em nível avançado ou primeiro ano de pós-graduação.

Ao final do curso, os alunos conseguem:

#ResultadoAvaliado porRecursos do Holarch usados
LO1Distinguir necessidades dos stakeholders de requisitos do sistema e rastrear cada necessidade até os requisitos que a formalizam.A1, prova intermediáriaStatements, relacionamentos traced to, a seção Rastreabilidade da Visão do item, Matriz de rastreabilidade
LO2Escrever requisitos necessários, singulares, inequívocos e verificáveis, com um método de verificação e critérios de sucesso.A2, prova intermediáriaAtributos de requisito, Qualidade, TBD/TBR
LO3Conduzir um ciclo de revisão e aprovação de requisitos e responder aos comentários da revisão com mudanças no modelo.A2, participação na revisãoPapel de Revisor, Aprovações (Aprovar, Rejeitar…, Reabrir), comentários com menções
LO4Analisar a cobertura de rastreabilidade e de verificação e decidir, para cada lacuna, se o erro está no modelo ou no requisito.A3Matriz de rastreabilidade, RVTM, Checagens do modelo
LO5Decompor funções, definir uma arquitetura lógica, alocar funções a elementos lógicos e físicos e derivar as interfaces resultantes.A4, prova finalDiagramas de Action e FFBDs, Assets, alocação, Registro de interfaces
LO6Avaliar o impacto de uma mudança de requisito por meio do modelo e registrar uma decisão para cada item afetado.A5, prova finalVínculos a revisar, análise de impacto, Solicitações de mudança, Linhas de base e versões
LO7Planejar verificação e validação: distingui-las, escolher métodos, escrever procedimentos de teste e de validação nos termos certos e ler uma RVTM.A6, prova finalCasos e conjuntos de teste, Central de testes, RVTM e VCRM, modelos de documento
LO8Produzir entregáveis de engenharia a partir do modelo e mantê-los coerentes com ele: documentos com linha de base e matrizes exportadas para revisão.A2, A6, prova finalDocumentos, matrizes vivas, linhas de base, exportação para Word e Excel
LO9 (opcional)Ler e escrever a notação textual do SysML v2 para um subsistema e dizer quais propriedades uma ferramenta checou e quais ela apenas guardou.Parte opcional do A6Projeto SysML v2, as checagens do Editor, a nota didática sobre SysML v2

Correspondência com os trabalhos

ResultadoA1 Rastrear uma necessidadeA2 Retrabalho de requisitosA3 Lacunas de coberturaA4 ArquiteturaA5 Impacto da mudançaA6 Plano de validação
LO1●○○
LO2●○
LO3●
LO4○●○
LO5●
LO6●
LO7○○○●
LO8○●

● resultado principal avaliado, ○ também contribui.

Notas para o instrutor

  • Os resultados descrevem a capacidade em engenharia de sistemas, não a habilidade com a ferramenta. O Holarch é onde os alunos praticam; os arquivos CSV do EO-1 permitem que um aluno demonstre cada resultado sem ele.
  • Os resultados seguem a prática comum de engenharia de sistemas, por exemplo os processos técnicos da ISO/IEC/IEEE 15288: definição de necessidades e requisitos dos stakeholders, definição de requisitos do sistema, definição da arquitetura, verificação e validação. Relacione-os aos critérios de acreditação do seu programa conforme a sua instituição exigir.

A1 · Rastrear uma necessidade

Resultados: LO1 (principal), LO4, LO7 · Tamanho do grupo: individual · Peso sugerido: 8 %

Contexto

O cliente do EO-1, uma empresa de análise agrícola, declarou três necessidades. N2 Twice-Weekly Revisit diz: “Farm customers need fresh imagery of their fields at least twice a week in the growing season.” Uma necessidade só é atendida quando os requisitos que a formalizam são satisfeitos pelo projeto e verificados, e a própria necessidade é validada com o cliente.

Tarefa

  1. Siga N2 pelo modelo: os requisitos que ela rastreia, seus filhos, as funções e componentes que satisfazem cada um e os casos de teste que os verificam, com o status de cada teste.
  2. Desenhe a cadeia como uma tabela ou um pequeno diagrama: uma linha ou caixa por item, com número, nome, status e o relacionamento que o liga.
  3. Encontre a atividade de validação de N2 e seu status.
  4. Responda: que evidência ainda falta para que N2 conte como validada? Liste cada peça faltante, o item a que pertence e o que a fecharia.
  5. Procure requisitos que apoiam N2 mas não a rastreiam. Indique um candidato e argumente a favor ou contra adicionar o vínculo. Não o adicione ao modelo.

No Holarch: abra N2 na Visão do item e leia sua seção Rastreabilidade, depois use Verificação → Matriz de rastreabilidade, Verificação → RVTM e Verificação → Central de testes. Sem o Holarch: eo-1-v1.1-traceability.csv e eo-1-v1.1-rvtm.csv.

Entregar

Uma nota de uma a duas páginas (Word ou PDF) com a cadeia, a evidência faltante e sua resposta ao passo 5. Não altere o modelo neste trabalho.

Rubrica

Critério4 Exemplar3 Proficiente2 Em desenvolvimento1 Iniciante
Cadeia completa e correta (40 %)Todos os itens de N2 até os testes, com os relacionamentos e status corretos, incluindo os dois filhos e a atividade de validação.Um item ou status faltando ou errado.A cadeia para nos requisitos ou omite um filho.Itens listados sem relacionamentos.
Evidência faltante (35 %)Aponta todas as lacunas (testes não executados, um pai sem verificação própria, requisitos ainda não aprovados, a validação não executada, o filho sem função) e o que fecha cada uma.A maioria das lacunas, com o que as fecha.Lista lacunas sem dizer o que as fecha.Diz apenas “faltam testes”.
Verificação vs. validação (15 %)Mantém as duas separadas o tempo todo: os requisitos são verificados, a necessidade é validada.Um deslize.Trata um teste aprovado como validação da necessidade.Nenhuma distinção.
Vínculo candidato (10 %)Um requisito específico com um argumento fundamentado em um sentido ou no outro.Um candidato com um argumento fraco.Um candidato sem argumento.Ausente.

A2 · Retrabalho e revisão de requisitos

Resultados: LO2 (principal), LO3, LO8 · Tamanho do grupo: grupo · Peso sugerido: 10 %

Contexto

Três requisitos do EO-1 ainda são rascunhos e têm nota 44 % na checagem de qualidade do Holarch:

  • 2.5 Safe Mode Recovery: “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”
  • 3.5 Battery Thermal Control: “The thermal design shall keep the battery warm enough (TBD).”
  • 6.4 Operator Interface: “The operator interface shall be user friendly and/or easy to use.”

O 3.5 também tem um problema em aberto, ISS-3 Battery heater set point not chosen, e um comentário de revisão do comitê de revisão de projeto, RID-1 No cold-case analysis for the battery heater.

Tarefa

  1. Para cada um dos três, liste o que o torna fraco, palavra por palavra onde isso importar.
  2. Reescreva cada um no projeto do grupo: um “shall”, uma condição mensurável e um ponto de partida ou condição declarados quando houver tempo ou alcance envolvidos. Substitua cada TBD por um valor e registre sua justificativa, ou mantenha um TBR com responsável e data. Para o 3.5, diga como sua reescrita responde a ISS-3 e RID-1.
  3. Preencha Verification Method, Nível de verificação e Critérios de sucesso para cada um.
  4. Rastreie cada um até sua origem (uma necessidade, um requisito pai ou uma fonte) e até a função que o satisfaz. Se não existir função, indique a função que está faltando.
  5. Coloque cada um em In Review. Seu instrutor os revisa como Revisor. Responda a cada comentário no modelo (altere o requisito ou responda com um motivo) e depois resolva o comentário.
  6. Salve uma linha de base do documento EO-1 System Requirements Specification (SRS-001) chamada “A2 entregue” e exporte-a para Word.

No Holarch: Necessidades e requisitos → Qualidade, o inspetor do requisito, Necessidades e requisitos → Aprovações e, no documento, Versão ▾ → Salvar linha de base… e Entregar ▾ → Specification (Word).

Entregar

A exportação para Word e uma nota de meia página sobre as fraquezas que você encontrou no passo 1. O modelo, tal como estiver no prazo, é avaliado junto.

Rubrica

Critério4 Exemplar3 Proficiente2 Em desenvolvimento1 Iniciante
Requisitos reescritos (40 %)Os três singulares, mensuráveis e verificáveis; condições e pontos de partida declarados; valores justificados.Um requisito ainda tem um termo vago ou uma condição faltando.Valores adicionados, mas faltam condições ou justificativa.Redação alterada, ainda não verificável.
Atributos de verificação (20 %)Método, nível e critérios de sucesso adequados a cada requisito e executáveis como escritos.Uma incompatibilidade, por exemplo Test onde só Analysis é possível.Métodos definidos, critérios de sucesso vagos.Ausente.
Rastreabilidade (15 %)Cada um rastreado até sua fonte e sua função satisfatória, ou a função faltante indicada.Um vínculo faltando.Somente fontes.Nenhum.
Ciclo de revisão (15 %)Todos os comentários da revisão respondidos no modelo e resolvidos; requisitos rejeitados retrabalhados e reenviados.Um comentário deixado em aberto.Comentários respondidos sem mudanças no modelo.Comentários ignorados.
Análise das fraquezas (10 %)Precisa: aponta cada termo vago e por que não pode ser verificado.Genérica, mas correta.Repete a nota de qualidade.Ausente.

A3 · Encontrar as lacunas de cobertura

Resultados: LO4 (principal), LO1, LO2, LO7 · Tamanho do grupo: grupo · Peso sugerido: 10 %

Contexto

O EO-1 está em sua revisão crítica de projeto. O modelo é imperfeito de propósito: alguns requisitos não têm função que os satisfaça, alguns não têm teste, alguns testes falharam e uma equação não está vinculada a nada.

Tarefa

Trabalhe com o modelo tal como é distribuído na v1.1. Use uma cópia nova se o projeto do seu grupo tiver mudado.

  1. Liste todos os requisitos que nenhuma função satisfaz.
  2. Liste todos os requisitos que nenhum caso de teste verifica e aqueles cujos testes falharam, com o problema em aberto e qualquer desvio registrado contra eles.
  3. Liste os requisitos sem componente que os satisfaça. Decida quais precisam de um e quais são corretamente satisfeitos no nível da missão ou do segmento.
  4. Encontre itens do modelo que nada rastreia. Dica: observe as equações de potência.
  5. Para cada lacuna, decida: falta algo no modelo (uma função, um componente, um teste, um vínculo) ou o requisito é desnecessário ou está mal escrito? Dê uma frase de justificativa por lacuna.
  6. Feche três lacunas à sua escolha no projeto do grupo, cada uma como uma mudança que você possa apontar em Controle e revisões → Atividade.

No Holarch: Verificação → Matriz de rastreabilidade, Verificação → RVTM, Verificação → Checagens do modelo e Riscos, problemas e decisões → Problemas e ações. Sem o Holarch: eo-1-v1.1-traceability.csv (sua coluna Cobertura), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv e eo-1-v1.1-deviations-waivers.csv.

Entregar

Uma tabela de lacunas (lacuna, item, decisão, justificativa, fechada sim ou não) em Excel ou Word e uma lista das três mudanças que você fez.

Rubrica

Critério4 Exemplar3 Proficiente2 Em desenvolvimento1 Iniciante
Lacunas encontradas (35 %)Todas as lacunas de função, teste, componente e itens órfãos, incluindo os testes que falharam com seus problemas e o desvio.Uma ou duas lacunas não encontradas.Só os rascunhos óbvios encontrados.Menos da metade.
Decisões (35 %)Cada lacuna recebe uma decisão defensável; distingue projeto faltante de requisitos desnecessários ou com escopo errado e de satisfação no nível da missão.A maioria das decisões é sólida.Toda lacuna tratada como “adicionar um vínculo”.Nenhuma decisão.
Mudanças feitas (20 %)Três mudanças que realmente fecham lacunas, cada uma um passo limpo no registro.Duas boas mudanças.Mudanças que escondem uma lacuna, como um vínculo adicionado sem motivo.Nenhum.
Apresentação (10 %)A tabela é ordenável e completa.Pequenas omissões.Difícil de acompanhar.Ausente.

A4 · Estender a arquitetura

Resultados: LO5 (principal), LO4 · Tamanho do grupo: grupo · Peso sugerido: 12 %

Contexto

A arquitetura lógica do EO-1 (L0) cobre apenas as fatias de energia e de tratamento de dados: L1 Power Generation a L6 Fault Management. Cada elemento lógico agrupa funções (allocated to) e é realizado por uma parte física (related to); por exemplo, F3.1 Convert Sunlight to Power é alocada a L1, e 1.3.1 Solar Arrays realiza L1. A determinação e o controle de atitude têm as funções F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels e F4.4 Unload Wheel Momentum, e partes físicas sob 1.2 ADCS, mas nenhuma camada lógica.

Tarefa

  1. Adicione elementos lógicos para determinação e controle de atitude sob L0. Cada elemento declara seu propósito sem nomear hardware.
  2. Aloque F4.1 a F4.4 a eles e relacione cada elemento lógico às partes físicas sob 1.2 ADCS que o realizam, seguindo o padrão de L1 a L6.
  3. Desenhe o diagrama de Action de F4 com os itens que fluem entre suas subfunções, por exemplo a estimativa de atitude e os comandos de torque, se o projeto do seu grupo ainda não tiver um.
  4. A partir dos fluxos que cruzam as fronteiras dos elementos, derive as interfaces. Compare-as com as interfaces existentes IF-06, IF-16, IF-17 e IF-18: quais coincidem, quais faltam e quais transportam itens que nenhuma função usa?
  5. Verifique se 2.1 a 2.4 são satisfeitos, cada um, pela função que realiza o trabalho e diga qual elemento lógico passa então a ser responsável por cada requisito.

No Holarch: Arquitetura → Assets, Comportamento → Diagramas de Action (F4), a seção Rastreabilidade do inspetor para as alocações, Interfaces → Registro de interfaces e a predefinição Hierarquia de alocação do diagrama de hierarquia. Sem o Holarch: eo-1-v1.1-allocation-chain.csv e eo-1-v1.1-icd.csv.

Entregar

Uma descrição breve da arquitetura (duas a três páginas, Word ou PDF): os elementos lógicos com seus propósitos, a tabela de alocação (função → elemento lógico → parte física), o diagrama de Action de F4 e a comparação de interfaces.

Rubrica

Critério4 Exemplar3 Proficiente2 Em desenvolvimento1 Iniciante
Elementos lógicos (25 %)Independentes da solução, coesos, cada um com um propósito claro; sem nomes de hardware.Um elemento nomeia hardware ou mistura propósitos.Os elementos copiam as partes físicas.Ausentes ou pouco claros.
Alocação (30 %)Cada subfunção alocada uma vez ao elemento certo; elementos realizados por partes; coerente no modelo.Uma alocação questionável.Alocações apenas a partes, pulando a camada lógica.Incompleto.
Fluxos e interfaces (30 %)Interfaces derivadas dos fluxos que cruzam fronteiras; comparação precisa com IF-06, IF-16, IF-17 e IF-18, incluindo lacunas nos dois sentidos.Comparação quase toda correta.Interfaces listadas, não derivadas.Ausente.
Responsabilidade pelos requisitos (15 %)Cada um de 2.1 a 2.4 rastreado, por meio de sua função, até um elemento lógico, inconsistências apontadas.Um faltando.Listados sem checagem.Ausente.

A5 · Tratar a mudança

Resultados: LO6 (principal), LO7 · Tamanho do grupo: grupo · Peso sugerido: 10 %

Contexto

Após a revisão de projeto, o requisito 3.1 Orbit Average Power mudou de 28 W para 30 W de potência média por órbita no fim de vida. O caso de teste TC-06 Solar Array Power Test foi aprovado com o valor antigo. O Holarch marcou os vínculos de 3.1 para revisão.

Tarefa

  1. Liste todos os itens que a mudança alcança: para a frente pelos vínculos de 3.1, para trás até aquilo de que 3.1 deriva, e itens que mencionam o valor antigo sem vínculo com 3.1. Diga como encontrou cada um.
  2. Para cada item, escreva a pergunta que a mudança levanta, sua constatação (com números, onde o modelo os tiver) e uma decisão: nenhuma mudança (marcar o vínculo como revisado, com um comentário), atualizar ou escalar para o comitê de mudanças.
  3. Decida o que fazer com o TC-06: um teste aprovado com 28 W ainda comprova 30 W? Mostre as contas a partir das equações do modelo.
  4. Encontre um item que a análise baseada em vínculos não alcança e diga por que ele importa.
  5. Registre suas decisões no projeto do grupo: um comentário em cada vínculo que você marcar como revisado, uma solicitação de mudança para o que o comitê precisa decidir e uma linha de base antes e outra depois.

No Holarch: Necessidades e requisitos → Vínculos a revisar, a análise de impacto a partir de 3.1 (Abrir em ▾ → Spider, depois Impacto), a seção Rastreabilidade do inspetor, as equações de potência EQ-1.1 a EQ-1.4 e o TPM-2 (Arquitetura → Orçamentos e TPMs), Controle e revisões → Solicitações de mudança e Controle e revisões → Linhas de base e versões. Sem o Holarch: eo-1-v1.1-traceability.csv e eo-1-v1.1-change-impact-3.1.csv, o registro de impacto publicado; faça primeiro sua própria análise e depois compare.

Entregar

Um registro de impacto (uma tabela: item, como foi alcançado, pergunta, constatação, decisão, status) e uma recomendação de um parágrafo ao comitê de mudanças.

Rubrica

Critério4 Exemplar3 Proficiente2 Em desenvolvimento1 Iniciante
Alcance (30 %)Itens encontrados para a frente, para trás e por busca de texto, incluindo os que nenhum vínculo alcança.Só vínculos, todos eles.Alguns vínculos para a frente.Só 3.1 e TC-06.
Constatações com números (30 %)Usa os valores e equações do modelo; o déficit do TC-06 é calculado e explicado.Números quase todos corretos.Apenas qualitativo.Conclusões erradas.
Decisões (25 %)Cada item tem uma decisão adequada à constatação; vínculos marcados como revisados só com motivo; itens do comitê mantidos à parte.Uma decisão fraca.Marca vínculos como revisados sem motivos.Nenhuma decisão.
Registro no modelo (15 %)Comentários, solicitação de mudança e linhas de base presentes e coerentes com o registro.Um faltando.Só o documento.Nada no modelo.

A6 · Plano de validação

Resultados: LO7 (principal), LO8, LO1 · Tamanho do grupo: grupo · Peso sugerido: 10 %

Contexto

A verificação pergunta se o EO-1 foi construído corretamente em relação aos seus requisitos; a validação pergunta se ele é o sistema certo para os clientes agrícolas. O conjunto de validação do EO-1, TS-3 Mission Validation, contém VAL-01 Customer Alert Pilot (para N1, não executado), VAL-02 Growing Season Revisit Simulation (para N2, não executado) e VAL-03 Agronomist Map Review (para N3, aprovado).

Comece o plano em Necessidades e requisitos → Documentos → + Novo documento. Em Modelo, defina Modelos para como Test Plan Document e escolha o modelo integrado Verification and Validation Plan com Incluir orientações de redação, ou o modelo da organização que o seu instrutor publicou para este trabalho.

Tarefa

  1. 5.1 Operational Scenarios: escreva o cenário do VAL-01 nos termos do cliente: quem faz o quê, em que dia, com que resultado. Indique a necessidade que ele exercita.
  2. 5.2 Users and Participants: indique os usuários representativos e o que cada um decide.
  3. 5.3 Validation Environment: descreva o ambiente, como ele difere da operação e o que essa diferença significa para o resultado.
  4. Escreva os critérios de aceitação do VAL-01 de modo que um cliente possa dizer sim ou não sem julgamento de engenharia e registre-os no Resultado esperado do caso de teste.
  5. 8 Verification Status: leia a matriz viva. Escolha o teste reprovado TC-04 Pointing Accuracy Test e diga o que o resultado do VAL-01 significaria se o TC-04 ainda estiver reprovado na época do piloto.
  6. Exporte o plano para Word.

Opcional: bônus de SysML v2 (LO9, até 10 % a mais)

Crie um projeto SysML v2 a partir de eo-1-v1.1-power-subsystem.sysml (Gerenciar projetos → Arquivos de projeto ▾ → Importar arquivos SysML v2…). O arquivo ainda contém o requisito 3.1 com 28 W. Altere a potência média por órbita exigida para 30 W, a mudança do A5, e leia o que o Editor informa. É um erro de modelagem ou uma constatação de projeto? Depois altere os valores de projeto, não o requisito, até a linha de status do Editor dizer Nenhum problema, e diga se os novos valores são fisicamente críveis. Em meia página, diga quais das suas afirmações a ferramenta checou e quais ela apenas guardou; a nota didática sobre SysML v2 que o seu instrutor compartilha lista ambas.

Entregar

  • A exportação para Word do plano.
  • Para o bônus de SysML v2: o arquivo .sysml e a meia página.

Rubrica

Critério4 Exemplar3 Proficiente2 Em desenvolvimento1 Iniciante
Cenário nos termos do cliente (30 %)Concreto, do dia a dia, sem jargão de engenharia; exercita claramente N1.Claro, com algum jargão.Um procedimento de teste, não um cenário.Ausente ou genérico.
Critérios de aceitação (25 %)Observáveis, sim ou não, de responsabilidade do cliente; ligados ao “on the day of an overpass” de N1.Quase todos observáveis.Somente limites de engenharia.Vagos.
Participantes e ambiente (20 %)Usuários representativos indicados com suas decisões; diferenças em relação à operação e seu efeito declarados.Um faltando.Listados sem efeito.Ausente.
Raciocínio de V&V (15 %)Explica por que um piloto de validação pode ter sucesso ou falhar independentemente do TC-04 e o que cada resultado significa.Quase todo sólido.Confunde verificação e validação.Ausente.
Entregável (10 %)Exportação limpa para Word, orientações do modelo substituídas por conteúdo.Restos de texto de orientação.Exportado em parte.Ausente.
Bônus de SysML v2 (até +10 %)Constatação explicada; Nenhum problema, com valores críveis; declaração precisa do que foi checado e do que foi guardado.Nenhum problema; declaração genérica.Requisito enfraquecido em vez de o projeto ser alterado, ou restaram problemas.Sem pontos.

Ensinar SysML v2 com o Holarch: o que ele checa e o que apenas guarda

Os projetos SysML v2 do Holarch suportam um subconjunto da especificação OMG SysML v2. O estado atual de cada área está na página de cobertura da linguagem SysML v2 (holarch.app/sysml-v2-coverage/); consulte-a antes de cada período letivo. Ao ensinar a linguagem com o Holarch, mantenha separados três tipos de afirmação, para que os alunos não aprendam um limite da ferramenta como regra da linguagem nem tomem uma construção que a ferramenta guardou por uma que ela checou:

  • Checado: o Editor analisa a construção e a checa enquanto você digita, e as visões e páginas a usam. Quando a linha de status do Editor diz Nenhum problema, essas checagens passaram.
  • Guardado, não interpretado: analisado e guardado exatamente como escrito, no texto e nas exportações, mas sem significado atribuído. Nenhum problema não diz nada sobre se está certo.
  • Ainda não no Holarch: a construção ou o recurso não está disponível no Holarch. Continua sendo SysML v2 válido.

Checado: seguro para ensinar e avaliar com a ferramenta

ÁreaO que os alunos podem confiar que o Editor detecta
SintaxeCaracteres, comentários, strings, chaves, ;, nomes e tokens esperados.
Nomes e importaçõesNomes não resolvidos, ambíguos, duplicados e privados; importações de membro, de namespace, recursivas e filtradas.
Definições, usos, especializaçãopart, attribute, port, action, state, requirement e os demais tipos e suas definições; tipagem, subconjunto, redefinição e conjugação; ciclos e o tipo errado de definição.
Multiplicidades, valores e unidadesLimites válidos; grandezas com os tipos de grandeza ISQ e unidades SI e US customary; checagens de dimensão: uma potência onde se espera uma massa é um erro.
Restrições e cálculosTipos de operandos, argumentos de cálculo, condições booleanas e avaliação: restrições, requisitos e objetivos que não valem para os valores atuais são informados.
EstruturaExtremidades de conexão; direções de portas, fluxos e mensagens; interfaces e conectores de binding.
Ações e estadosAlvos de sucessão, nós de controle, os valores que um laço for percorre, transições iniciais, regiões paralelas, gatilhos de transição e efeitos do.
Requisitos e casos de usoAlvos de subject, actor, stakeholder, require e assume constraint, satisfy, verify e frame nos lugares certos.
Alocaçãoallocate … to …, definições de alocação, dependências.
VariabilidadeUma variação contém apenas variantes do seu tipo, uma escolha é uma variante do seu ponto, e os valores da escolha são avaliados.
Indivíduos, snapshots e fatias de tempoCada um tem as características da ocorrência a que pertence; seus próprios valores são lidos primeiro.

Checado em parte: ensinar declarando o limite

ÁreaChecado ou executadoLimite a informar aos alunos
AçõesO Simulador executa fluxos de ação, inclusive execuções de Monte Carlo.Durações de etapas, probabilidades de ramificação e contagens de laços são ajustes do Simulador guardados no Holarch, não no texto, então uma exportação .sysml não os inclui.
EstadosO Simulador executa máquinas de estado com estímulos e mostra os estados ativos.O mesmo: os ajustes do Simulador não fazem parte do texto.
Casos de análise e de verificaçãoSubject, objetivo, resultado de retorno; verify e um veredito.Um caso de análise só é avaliado quando todas as entradas têm valor; não há solver. Em uma Visão paramétrica, Resolver encontra uma incógnita por restrição. As análises de estudo de trade-off da biblioteca padrão não são avaliadas.
Visõesview, view def, expose, filtros, pontos de vista e as definições de visão padrão; as Visões de sequência desenham fragmentos alt, opt, loop e par.O layout pertence ao Holarch, não ao modelo.
VariabilidadeVariações, variantes e configurações são checadas e avaliadas.O Holarch ainda não procura nem lista todas as combinações válidas.
Metadados e palavras-chave@Name, #Name, metadata … about, palavras-chave definidas pelo usuário a partir de metadados semânticos.Outros metadados definidos pelo usuário não têm significado além de seus valores; metadados escritos com about não acrescentam tipo base.
Representações textuaisCorpos rep … language em SysML e KerML são checados, e um corpo de restrição em SysML é avaliado.Corpos em outras linguagens, como Python, OCL ou MATLAB, são guardados como texto e nunca executados.
Intercâmbio JSON do SysML v2Importação e exportação no formato de elementos da Systems Modeling API, com os ids dos elementos preservados.Tipos de elemento que o Holarch não interpreta são mantidos como importados e gravados de volta sem alteração; não têm texto e não podem ser editados.

Guardado, não interpretado: Nenhum problema não comprova nada aqui

  • Corpos de representações textuais em linguagens que não sejam SysML e KerML.
  • Os valores de metadados definidos pelo usuário que não sejam metadados semânticos.
  • Texto doc e comentários: nunca comparados com o modelo. No subsistema de energia do EO-1, mudar o requisito 3.1 para 30 W deixa seu doc dizendo 28 W, sem nenhum problema informado. Um bom exercício.
  • Tipos de elemento que o Holarch não interpreta em um arquivo JSON do SysML v2 importado.

O inverso também importa: status de requisitos, resultados de verificação e rótulos são dados do Holarch. Não estão no texto nem em uma exportação .sysml.

Ainda não no Holarch

  • Arquivos .kerml: não são importados, e modelos escritos em KerML não são checados. O KerML é lido apenas para a biblioteca padrão.
  • Extensões da linguagem além de palavras-chave definidas pelo usuário; a biblioteca padrão não pode ser editada.
  • Um solver para casos de análise e uma busca por combinações válidas de variantes nas páginas do Holarch.
  • Commits da Systems Modeling API na main, tags e merges: outras ferramentas fazem commits em branches de solicitações de mudança, e um aprovador os aplica no Holarch.

Como usar isto em um curso

  • Diga “a ferramenta checou” apenas para as áreas checadas. Por exemplo, Nenhum problema significa que as unidades são coerentes e que os requisitos valem para os valores atuais. Não significa que o texto doc corresponde aos valores nem que um corpo em Python está certo.
  • Avalie as construções guardadas lendo-as. Avalie-as por inspeção, não pela contagem de problemas.
  • O comportamento é executado no Simulador, tanto para fluxos de ação quanto para máquinas de estado. As durações e probabilidades que o Simulador usa são ajustes do Holarch: se os alunos entregarem apenas o arquivo .sysml, peça também os ajustes.
  • As regras da linguagem vêm da especificação, não de uma ferramenta. Onde o Holarch não implementou algo, diga “ainda não no Holarch”, não “não permitido”.
  • O bônus do A6 se apoia nesta nota: os alunos mudam 3.1 para 30 W no subsistema de energia do EO-1, veem a checagem de avaliação informar isso, corrigem o projeto e anotam o que foi checado e o que foi apenas guardado.

Downloads

O pacote é um único arquivo zip. Ele traz a versão no nome, para que um curso possa indicar exatamente a cópia que usou. Os arquivos CSV e de projeto dos trabalhos são os downloads do EO-1 Reference Model v1.1 na página do EO-1.

ArquivoO que ele contém
teaching-with-holarch-v1.0.zipTodos os arquivos abaixo em uma única pasta.
README.txtO conteúdo, como usar o pacote, o aviso de licença e o histórico de alterações.
LICENSE.txtO aviso de licença.
learning-outcomes.mdOs resultados de aprendizagem do curso e sua correspondência com os trabalhos.
assignments/A1-trace-a-need.mdA1 Rastrear uma necessidade.
assignments/A2-requirements-rework.mdA2 Retrabalho e revisão de requisitos.
assignments/A3-coverage-gaps.mdA3 Encontrar as lacunas de cobertura.
assignments/A4-extend-the-architecture.mdA4 Estender a arquitetura.
assignments/A5-work-the-change.mdA5 Tratar a mudança.
assignments/A6-validation-plan.mdA6 Plano de validação.
sysml-v2-teaching-boundaries.mdEnsinar SysML v2 com o Holarch: o que ele checa e o que apenas guarda.

As notas de solução não estão no zip; veja Notas de solução.

Versões

Este é o Teaching with Holarch instructor package v1.0, escrito para o EO-1 Reference Model v1.1. Uma nova versão recebe novos nomes de arquivo; as versões anteriores continuam disponíveis em seus endereços.

  • v1.0: Primeira versão: os resultados de aprendizagem do curso e os trabalhos A1 a A6 com rubricas, para o EO-1 Reference Model v1.1.

Como citar

Cite a versão que você usou:

Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.

Licença

Os arquivos do pacote do instrutor são licenciados sob a Licença Creative Commons Atribuição 4.0 Internacional (CC BY 4.0). Você pode copiá-los, compartilhá-los e adaptá-los para qualquer finalidade, inclusive comercial, desde que dê o crédito apropriado, inclua um link para a licença e diga se fez alterações. Crédito: “Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0”. Cada download traz este aviso.

O EO-1 Reference Model mantém sua própria linha de crédito: “EO-1 Reference Model v1.1, Holarch, CC BY 4.0”. Todos os nomes, pessoas e resultados do EO-1 são inventados.

A licença cobre apenas os arquivos do pacote. As notas de solução não fazem parte do pacote, e o software Holarch não é coberto por ela.

Publicado por Holarch