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
- O que ele contém
- Como usá-lo
- Notas de solução
- Resultados de aprendizagem
- A1 · Rastrear uma necessidade
- A2 · Retrabalho e revisão de requisitos
- A3 · Encontrar as lacunas de cobertura
- A4 · Estender a arquitetura
- A5 · Tratar a mudança
- A6 · Plano de validação
- Ensinar SysML v2 com o Holarch: o que ele checa e o que apenas guarda
- Downloads
- Versões
- Como citar
- Licença
O que ele contém
| Arquivo | Para | O que ele contém |
|---|---|---|
learning-outcomes.md | Instrutores, registros de acreditação | Os 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.md | Alunos (para distribuir) | Seis trabalhos sobre o EO-1, cada um com contexto, tarefa, o que entregar e uma rubrica. |
sysml-v2-teaching-boundaries.md | Instrutores | O 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
- 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.jsonem 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. - 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.
- Para o A2, entre em cada projeto de grupo como Revisor: você pode comentar, aprovar, rejeitar e reabrir requisitos, e nada mais.
- 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.
- 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:
| # | Resultado | Avaliado por | Recursos do Holarch usados |
|---|---|---|---|
| LO1 | Distinguir necessidades dos stakeholders de requisitos do sistema e rastrear cada necessidade até os requisitos que a formalizam. | A1, prova intermediária | Statements, relacionamentos traced to, a seção Rastreabilidade da Visão do item, Matriz de rastreabilidade |
| LO2 | Escrever requisitos necessários, singulares, inequívocos e verificáveis, com um método de verificação e critérios de sucesso. | A2, prova intermediária | Atributos de requisito, Qualidade, TBD/TBR |
| LO3 | Conduzir 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ão | Papel de Revisor, Aprovações (Aprovar, Rejeitar…, Reabrir), comentários com menções |
| LO4 | Analisar a cobertura de rastreabilidade e de verificação e decidir, para cada lacuna, se o erro está no modelo ou no requisito. | A3 | Matriz de rastreabilidade, RVTM, Checagens do modelo |
| LO5 | Decompor funções, definir uma arquitetura lógica, alocar funções a elementos lógicos e físicos e derivar as interfaces resultantes. | A4, prova final | Diagramas de Action e FFBDs, Assets, alocação, Registro de interfaces |
| LO6 | Avaliar o impacto de uma mudança de requisito por meio do modelo e registrar uma decisão para cada item afetado. | A5, prova final | Vínculos a revisar, análise de impacto, Solicitações de mudança, Linhas de base e versões |
| LO7 | Planejar 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 final | Casos e conjuntos de teste, Central de testes, RVTM e VCRM, modelos de documento |
| LO8 | Produzir 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 final | Documentos, 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 A6 | Projeto SysML v2, as checagens do Editor, a nota didática sobre SysML v2 |
Correspondência com os trabalhos
| Resultado | A1 Rastrear uma necessidade | A2 Retrabalho de requisitos | A3 Lacunas de cobertura | A4 Arquitetura | A5 Impacto da mudança | A6 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
- 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.
- 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.
- Encontre a atividade de validação de N2 e seu status.
- 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.
- 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ério | 4 Exemplar | 3 Proficiente | 2 Em desenvolvimento | 1 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
- Para cada um dos três, liste o que o torna fraco, palavra por palavra onde isso importar.
- 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.
- Preencha Verification Method, Nível de verificação e Critérios de sucesso para cada um.
- 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.
- 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.
- 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ério | 4 Exemplar | 3 Proficiente | 2 Em desenvolvimento | 1 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.
- Liste todos os requisitos que nenhuma função satisfaz.
- 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.
- 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.
- Encontre itens do modelo que nada rastreia. Dica: observe as equações de potência.
- 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.
- 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ério | 4 Exemplar | 3 Proficiente | 2 Em desenvolvimento | 1 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
- Adicione elementos lógicos para determinação e controle de atitude sob L0. Cada elemento declara seu propósito sem nomear hardware.
- 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.
- 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.
- 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?
- 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ério | 4 Exemplar | 3 Proficiente | 2 Em desenvolvimento | 1 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
- 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.
- 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.
- 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.
- Encontre um item que a análise baseada em vínculos não alcança e diga por que ele importa.
- 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ério | 4 Exemplar | 3 Proficiente | 2 Em desenvolvimento | 1 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
- 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.
- 5.2 Users and Participants: indique os usuários representativos e o que cada um decide.
- 5.3 Validation Environment: descreva o ambiente, como ele difere da operação e o que essa diferença significa para o resultado.
- 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.
- 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.
- 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
.sysmle a meia página.
Rubrica
| Critério | 4 Exemplar | 3 Proficiente | 2 Em desenvolvimento | 1 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
| Área | O que os alunos podem confiar que o Editor detecta |
|---|---|
| Sintaxe | Caracteres, comentários, strings, chaves, ;, nomes e tokens esperados. |
| Nomes e importações | Nomes não resolvidos, ambíguos, duplicados e privados; importações de membro, de namespace, recursivas e filtradas. |
| Definições, usos, especialização | part, 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 unidades | Limites 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álculos | Tipos 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. |
| Estrutura | Extremidades de conexão; direções de portas, fluxos e mensagens; interfaces e conectores de binding. |
| Ações e estados | Alvos 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 uso | Alvos de subject, actor, stakeholder, require e assume constraint, satisfy, verify e frame nos lugares certos. |
| Alocação | allocate … to …, definições de alocação, dependências. |
| Variabilidade | Uma 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 tempo | Cada 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
| Área | Checado ou executado | Limite a informar aos alunos |
|---|---|---|
| Ações | O 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. |
| Estados | O 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ção | Subject, 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ões | view, 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. |
| Variabilidade | Variaçõ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 textuais | Corpos 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 v2 | Importaçã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
doce comentários: nunca comparados com o modelo. No subsistema de energia do EO-1, mudar o requisito 3.1 para 30 W deixa seudocdizendo 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
doccorresponde 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.
| Arquivo | O que ele contém |
|---|---|
| teaching-with-holarch-v1.0.zip | Todos os arquivos abaixo em uma única pasta. |
README.txt | O conteúdo, como usar o pacote, o aviso de licença e o histórico de alterações. |
LICENSE.txt | O aviso de licença. |
learning-outcomes.md | Os resultados de aprendizagem do curso e sua correspondência com os trabalhos. |
assignments/A1-trace-a-need.md | A1 Rastrear uma necessidade. |
assignments/A2-requirements-rework.md | A2 Retrabalho e revisão de requisitos. |
assignments/A3-coverage-gaps.md | A3 Encontrar as lacunas de cobertura. |
assignments/A4-extend-the-architecture.md | A4 Estender a arquitetura. |
assignments/A5-work-the-change.md | A5 Tratar a mudança. |
assignments/A6-validation-plan.md | A6 Plano de validação. |
sysml-v2-teaching-boundaries.md | Ensinar 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.