Holarch

Para turmas · Modelo de referência EO-1 v1.1

Trabalhos de aula sobre o modelo de referência EO-1

Seis trabalhos para um curso de engenharia de sistemas, cada um com uma tarefa, o que entregar e uma rubrica. Todos usam o EO-1 Open MBSE Reference Model, um CubeSat 6U fictício de observação da Terra, tal como é distribuído. Os alunos podem responder a todas as perguntas no Holarch ou a partir dos arquivos CSV do modelo em qualquer ferramenta. Uso e adaptação livres sob CC BY 4.0.

Nesta página
  1. Como usá-los
  2. Resultados de aprendizagem
  3. A1 · Rastrear uma necessidade
    1. Tarefa
    2. Entregar
    3. Rubrica
  4. A2 · Retrabalho e revisão de requisitos
    1. Tarefa
    2. Entregar
    3. Rubrica
  5. A3 · Encontrar as lacunas de cobertura
    1. Tarefa
    2. Entregar
    3. Rubrica
  6. A4 · Estender a arquitetura
    1. Tarefa
    2. Entregar
    3. Rubrica
  7. A5 · Tratar a mudança
    1. Tarefa
    2. Entregar
    3. Rubrica
  8. A6 · Plano de validação
    1. Tarefa (parte A)
    2. Parte B: SysML v2 (opcional)
    3. Entregar
    4. Rubrica
  9. Trabalhar sem o Holarch
  10. Ensinar SysML v2: o que o Holarch checa e o que ele apenas guarda
    1. Checado
    2. Checado, com um limite a declarar
    3. Guardado, não interpretado
    4. Como usar isto em um curso
  11. Soluções
  12. Licença e crédito

Como usá-los

Os trabalhos acompanham o modelo das necessidades dos stakeholders até a verificação e a mudança. Distribua-os em ordem ou escolha os que se encaixam no seu curso. Cada um indica os resultados de aprendizagem que avalia, um tamanho de grupo sugerido e uma rubrica de quatro níveis com pesos; altere os pesos e os níveis conforme o seu sistema de avaliação.

  1. Dê o modelo a cada aluno ou grupo. Baixe o EO-1 Reference Model v1.1 ou peça que cada grupo o crie no Holarch com Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada). Todo trabalho parte do modelo tal como é distribuído; se o projeto de um grupo tiver mudado desde então, peça que trabalhe em uma cópia nova.
  2. Prepare a turma. Coloque os projetos dos grupos em uma organização de turma, adicione você e seus monitores a cada projeto de grupo como Revisor e cadastre o prazo de cada trabalho em Revisão da turma. O guia do instrutor traz uma lista de verificação de configuração e três planos de módulo.
  3. Avalie o raciocínio, não a habilidade com a ferramenta. As rubricas recompensam constatações, decisões e sua justificativa. Um aluno que trabalha com os arquivos CSV pode alcançar o nível máximo em todos os critérios, exceto naqueles que pedem mudanças no modelo.

Todos os nomes, pessoas, organizações e resultados do EO-1 são inventados. O EO-1 não é uma espaçonave real.

Resultados de aprendizagem

Os resultados descrevem a capacidade em engenharia de sistemas. Eles seguem 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.

ResultadoOs alunos conseguemTrabalho principalTambém emRecursos do Holarch usados
LO1Distinguir necessidades dos stakeholders de requisitos do sistema e rastrear cada necessidade até os requisitos que a formalizam.A1A3, A6Statements, vínculos traced to, a Visão do item e sua seção Rastreabilidade, a 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.A2A3Atributos de requisito, Qualidade, o Registro de 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.A2O papel de Revisor, Aprovações (Aprovar, Rejeitar…, Reabrir), comentários
LO4Analisar a cobertura de rastreabilidade e de verificação e decidir, para cada lacuna, se o erro está no modelo ou no requisito.A3A1, A4Matriz 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.A4Diagramas de Action, a hierarquia de Assets, alocação, 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.A5Vínculos a revisar, análise de impacto, Solicitações de mudança e suas listas de Impacto, linhas de base
LO7Planejar verificação e validação: distingui-las, escolher métodos, escrever critérios de validação nos termos do cliente e ler uma RVTM.A6A1, A3, A5Casos 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 vivas exportadas para revisão.A6A2Documentos, matrizes vivas, linhas de base, exportação para Word
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.A6 parte BUm projeto SysML v2, as checagens do Editor, os limites didáticos abaixo

A1 · Rastrear uma necessidade

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

O cliente do EO-1, uma empresa de análise agrícola, declarou três necessidades. N2 Twice-Weekly Revisit pede imagens recentes das lavouras dos clientes pelo menos duas vezes por semana durante a safra. 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 ao seguinte.
  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 a Visão do item de N2 e siga sua seção Rastreabilidade, depois a Matriz de rastreabilidade, a 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 cada requisito filho 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, requisitos ainda não aprovados, um requisito sem função que o satisfaça, validação não executada) 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 que faltam testes.
Verificação e 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 %

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.”

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 seu 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 prazo.
  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, diga qual função está faltando.
  5. Coloque cada um em In Review. Seu instrutor os revisa como Revisor, com comentários e Aprovar ou Rejeitar…. Responda a cada comentário no modelo: altere o requisito ou adicione um comentário com sua justificativa. Retrabalhe um requisito rejeitado e coloque-o em In Review novamente.
  6. Salve uma linha de base da System Requirements Specification chamada “A2 entregue” e exporte-a para Word.

No Holarch: Necessidades e requisitos → Qualidade, o inspetor do requisito, Necessidades e requisitos → Aprovações, Versão ▾ → Salvar linha de base… e Entregar ▾ → Especificação (Word) do documento. Sem o Holarch: eo-1-v1.1-requirements.csv; entregue as reescritas como tabela, e seu instrutor conduz a rodada de revisão por e-mail ou em aula.

Entregar

A exportação para Word e 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; requisitos rejeitados retrabalhados e reenviados.Um comentário sem resposta.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 %

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. 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 de cada falha.
  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 seu grupo, cada uma como uma mudança que você possa apontar em Controle e revisões → Atividade.

No Holarch: a Matriz de rastreabilidade, a RVTM e Verificação → Checagens do modelo. Sem o Holarch: eo-1-v1.1-traceability.csv (sua coluna Cobertura) e eo-1-v1.1-rvtm.csv; descreva as três mudanças em vez de fazê-las.

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 item não rastreado, incluindo os testes que falharam e seus problemas.Uma ou duas lacunas não encontradas.Só os rascunhos óbvios encontrados.Menos da metade.
Decisões (35 %)Cada lacuna tem uma decisão defensável; projeto faltante é distinguido 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 %

A arquitetura lógica do EO-1, L0 EO-1 Logical Architecture, cobre apenas as fatias de energia e de tratamento de dados: L1 Power Generation a L6 Fault Management. 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. Siga o padrão de L1 a L6: abra um deles na Visão do item e veja sua seção Rastreabilidade para saber quais relacionamentos ele usa.
  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: a hierarquia de Assets, o diagrama de Action de F4, o Registro de interfaces e um diagrama de hierarquia com a predefinição Hierarquia de alocação. Sem o Holarch: eo-1-v1.1-allocation-chain.csv, eo-1-v1.1-icd.csv e eo-1-v1.1-traceability.csv; desenhe o diagrama à mão ou em qualquer ferramenta.

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 e 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; uma 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, com as 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 %

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. Os vínculos de 3.1 agora aparecem em Vínculos a revisar.

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 que dê o motivo), 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 seu grupo. Salve uma linha de base do projeto antes de começar. Marque como revisados, com comentários, os vínculos que continuam válidos. Crie uma solicitação de mudança para o que o comitê precisa decidir (o modelo já contém a CR-1 como rascunho, então a sua é a CR-2), adicione os itens afetados e prepare as mudanças que você propõe. Leia a lista de Impacto de cada mudança preparada e compare-a com o seu próprio registro: o que ela lista que você deixou passar, e o que você encontrou que ela não consegue listar? Envie a solicitação para revisão sem aplicá-la e depois salve uma segunda linha de base.

Opcional: se o seu instrutor ativar Work in change requests nos Ajustes de solicitações de mudança do projeto, faça as edições propostas na solicitação em rascunho, nas páginas de sempre, em vez de prepará-las uma a uma, e revise-as na solicitação antes de enviá-la.

No Holarch: Necessidades e requisitos → Vínculos a revisar, uma análise de impacto a partir de 3.1 (Abrir em ▾ → Spider, depois Impacto), a seção Rastreabilidade da Visão do item, a busca, as equações de potência e o TPM-2, 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 para a análise; eo-1-v1.1-change-impact-3.1.csv é o próprio registro de impacto do modelo, então faça sua análise primeiro e compare depois.

Planos: solicitações de mudança, suas listas de Impacto e os registros de aprovação funcionam em todos os planos. O controle de configuração (itens aprovados e com linha de base só mudam por uma solicitação aprovada) vem com os planos Individual e Team, e o trabalho dentro de uma solicitação de mudança com o plano Team. Um endereço de e-mail acadêmico verificado ou a participação em uma organização de turma ativa inclui ambos. Veja Controle de configuração.

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 efeito sobre o 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.Vínculos marcados como revisados sem motivos.Nenhuma decisão.
Registro no modelo (15 %)Comentários, a solicitação de mudança com suas mudanças preparadas e as duas linhas de base presentes e coerentes com o registro; diferenças em relação à lista de Impacto explicadas.Um faltando.Só o registro escrito.Nada no modelo.

A6 · Plano de validação

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

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 contém VAL-01 Customer Alert Pilot (para N1), VAL-02 Growing Season Revisit Simulation (para N2) e VAL-03 Agronomist Map Review (para N3, aprovado).

Comece o plano com + Novo documento na página Documentos. Em Modelos para, escolha o modelo de turma do seu instrutor, se houver; caso contrário, escolha o modelo integrado Verification and Validation Plan (um Test Plan Document) com Incluir orientações de redação. Os números de seção abaixo são os do modelo integrado.

Tarefa (parte A)

  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 deles 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 caso de teste.
  5. 8 Verification Status: leia a RVTM 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. Substitua as orientações de redação pelo seu conteúdo e exporte o plano para Word.

Parte B: SysML v2 (opcional)

Use-a como bônus de até 10 % ou isoladamente em um módulo de SysML v2. Crie um projeto SysML v2 a partir de eo-1-v1.1-power-subsystem.sysml com Gerenciar projetos → Arquivos de projeto ▾ → Importar arquivos SysML v2…. O arquivo ainda contém 3.1 com 28 W.

  1. 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?
  2. Altere os valores de projeto, não o requisito, até o arquivo ter 0 diagnósticos. Diga se os novos valores são fisicamente críveis.
  3. Em meia página, diga quais das suas afirmações a ferramenta checou e quais ela apenas guardou. Use os limites didáticos abaixo.

Sem o Holarch: escreva o plano no Word a partir dos títulos de seção acima; tire o status de verificação de eo-1-v1.1-rvtm.csv.

Entregar

A exportação para Word do plano e, para a parte B, 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 e ligados ao que N1 pede.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 seu efeito.Ausente.
Raciocínio sobre verificação e validação (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 %)Uma exportação limpa para Word, com as orientações de redação substituídas por conteúdo.Restos de texto de orientação.Exportado em parte.Ausente.
Parte B: SysML v2 (bônus, até 10 %)A constatação explicada; 0 diagnósticos com valores críveis; uma declaração precisa do que foi checado e do que foi guardado.0 diagnósticos; a declaração é genérica.O requisito foi enfraquecido em vez de o projeto ser alterado, ou restaram diagnósticos.Não tentado.

Trabalhar sem o Holarch

Todos os trabalhos podem ser feitos só com os arquivos do EO-1, então alunos que usam outra ferramenta, ou nenhuma, podem participar. Os arquivos CSV são UTF-8 com linha de cabeçalho e abrem em qualquer planilha. São visões do mesmo modelo, versão 1.1.

TrabalhoArquivos
A1 Rastrear uma necessidaderastreabilidade, RVTM
A2 Retrabalho de requisitosrequisitos, rastreabilidade
A3 Lacunas de coberturarastreabilidade (coluna Coverage), RVTM, problemas e ações
A4 Arquiteturacadeia de alocação, interfaces, rastreabilidade
A5 Tratar a mudançarastreabilidade; depois, para comparar: impacto da mudança em 3.1
A6 Plano de validaçãoRVTM, requisitos; parte B: subsistema de energia (.sysml)

Todos os arquivos, com um README e a licença, estão em eo-1-v1.1.zip. Os downloads do EO-1 descrevem cada arquivo.

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

Os projetos SysML v2 do Holarch suportam um subconjunto da especificação OMG SysML v2. Ao ensinar a linguagem com ele, 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 como uma que ela checou. A página Cobertura da linguagem SysML v2 lista o estado atual; consulte-a antes de cada período letivo.

Checado

O Editor checa estes pontos enquanto você digita, e as visões e páginas os usam. Quando o Editor mostra 0 diagnósticos, essas checagens passaram.

  • 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 e especialização: tipagem, subconjunto, redefinição e conjugação; ciclos e o tipo errado de definição.
  • Multiplicidades, valores e unidades: limites válidos, grandezas com as unidades ISQ, SI e US customary da biblioteca padrão, e checagens de dimensão (uma potência onde se espera uma massa é informada).
  • Restrições e cálculos: tipos de operandos, argumentos de cálculo e 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 e as direções de portas, fluxos e mensagens.
  • Requisitos, casos de uso e visões: membros no lugar certo e alvos de satisfy, verify, expose e frame.
  • Ações e estados: sucessões, nós de controle, transições iniciais, regiões paralelas, gatilhos e efeitos. O Simulador executa fluxos de ação, inclusive execuções de Monte Carlo, e executa máquinas de estado com estímulos.
  • Variabilidade, indivíduos e fatias de tempo: uma variante tem as características da sua variação e uma escolha deve ser uma das variantes do seu ponto; um snapshot ou fatia de tempo tem as características da sua ocorrência.

Checado, com um limite a declarar

ÁreaLimite a informar aos alunos
Casos de análiseUm 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.
VariabilidadeVariações, variantes e configurações são checadas e avaliadas, mas as páginas do Holarch ainda não listam todas as combinações válidas. Um ponto de variação sem escolha tem valor desconhecido, então uma asserção sobre ele não é atendida nem violada.
Metadados e extensões da linguagemPalavras-chave definidas pelo usuário funcionam por meio de metadados semânticos. Outros metadados definidos pelo usuário não têm significado além de seus valores. A biblioteca padrão é somente leitura.
KerMLO KerML da biblioteca padrão é lido, mas arquivos .kerml não são importados e modelos escritos em KerML não são checados.
Intercâmbio JSON do SysML v2Tipos de elemento que o Holarch não interpreta são mantidos como importados e gravados de volta sem alteração na exportação; não têm texto e não podem ser editados.
Systems Modeling APIOutras ferramentas leem o modelo e fazem commits em branches de solicitações de mudança; um aprovador os aplica no Holarch. Não há commits na main, tags nem merges.

Guardado, não interpretado

O Holarch guarda estes exatamente como escritos, no texto e nas exportações. 0 diagnósticos não diz nada sobre se estão certos.

  • Representações textuais em outras linguagens (rep language "Python" e semelhantes): o corpo é guardado como texto e nunca executado. Corpos em SysML e KerML são checados.
  • As palavras de um requisito: o texto doc é a declaração que o leitor vê; a checagem avalia o require constraint, não as palavras. No subsistema de energia do EO-1, mudar o valor exigido para 30 W deixa o texto doc dizendo 28 W até alguém editá-lo. É um bom exercício.
  • Os valores de metadados definidos pelo usuário que não sejam metadados semânticos.

Como usar isto em um curso

  • Diga “a ferramenta checou” apenas para as áreas checadas. Por exemplo, 0 diagnósticos significa que as unidades são coerentes e que o requisito vale para os valores atuais. Não significa que o texto do requisito concorda com sua restrição, nem que um corpo escrito em outra linguagem está correto.
  • Avalie as construções guardadas lendo-as, não pela contagem de diagnósticos.
  • 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”.
  • A parte B do A6 se apoia nesta seção: os alunos veem a avaliação informar o requisito alterado, corrigem o projeto e anotam o que foi checado e o que foi apenas guardado.

Soluções

Instrutores podem solicitar as notas de solução (constatações esperadas, respostas de exemplo e erros comuns de A1 a A6) pelo suporte: fale conosco com o assunto Instructor, seu curso e sua instituição. As notas não são publicadas, para que os alunos não possam baixar as respostas.

Licença e crédito

Estes trabalhos são licenciados sob a Licença Creative Commons Atribuição 4.0 Internacional (CC BY 4.0). Você pode copiá-los, distribuí-los e adaptá-los, desde que dê o crédito apropriado, inclua um link para a licença e diga se fez alterações. Crédito: “Class assignments on the EO-1 reference model, Holarch, CC BY 4.0”. Os arquivos do modelo EO-1 mantêm sua própria linha de crédito.

A licença cobre apenas os textos dos trabalhos. O software Holarch não é coberto por ela.

Publicado por Holarch