Holarch

Primeiros passos

Início

A página inicial do projeto: o que requer atenção, em que ponto está cada grupo do ciclo de vida e duas colunas de painéis para o trabalho, as checagens e o status que você acompanha, das próximas ações e gates do processo a riscos, mudanças desde a linha de base e um resumo do projeto feito pela IA.

Como usá-lo →

Nesta página
  1. Conceitos
  2. Como usá-lo
    1. Quando e por quê
    2. Organizar os painéis
    3. Mover painéis com o teclado
    4. Acompanhar uma consulta com uma Visão salva
    5. Contar itens com um Detalhamento
    6. Escrever um resumo do projeto
    7. Editar a descrição do projeto
    8. Exemplo prático: um painel de revisão para a demonstração CubeSat EO-1
    9. Dicas e boas práticas
    10. Erros comuns
    11. Como se conecta
  3. A página Início
    1. Cabeçalho da página
    2. Cabeçalho do painel
    3. Painéis
  4. Dashboards de versões anteriores
  5. Salvamento, desfazer e funções
  6. Mensagens
  7. Limites
  8. Páginas relacionadas

Início é onde um projeto abre. O topo mostra o que requer atenção e em que ponto está cada grupo do ciclo de vida. Abaixo, duas colunas de painéis mostram o trabalho e o status que você acompanha: as próximas ações, o gate atual do Processo de SE, as constatações das checagens do modelo, a qualidade dos requisitos, a verificação, os riscos, os marcos, as mudanças desde a última linha de base, as discussões em aberto, visões salvas, gráficos de detalhamento, notas e um resumo do projeto feito pela IA.

Cada painel lê o modelo diretamente, então é atualizado assim que alguém altera os itens que ele mostra. O layout dos painéis é salvo no projeto: todos os membros veem o mesmo Início, e cada mudança nele pode ser desfeita.

Conceitos

  • Cabeçalho: o nome do projeto (na barra superior) e a primeira linha da descrição do projeto, com Editar descrição.
  • Requer atenção: cartões de saúde que contam problemas: vínculos a revisar, TBDs atrasados, testes reprovados, violações de TPM, riscos altos, checagens do modelo e o status do salvamento. Só aparecem os cartões com contagem acima de zero; sem nenhum, um cartão diz Nada requer atenção. Consulte Primeiros passos.
  • Ciclo de vida: um cartão por grupo da barra lateral, com seu número principal.
  • Sugestão de tour: um projeto novo ou quase vazio (menos de 25 itens) mostra ▶ Assistir ao tour de 4 minutos acima de Requer atenção. × o oculta neste navegador.
  • Coluna: uma coluna de painéis. A coluna principal ocupa cerca de dois terços da largura, a coluna lateral o restante. Em uma janela estreita, a coluna lateral passa para baixo da principal.
  • Painel: uma caixa em uma coluna com um nome, um menu ⋯ e seu conteúdo. Um painel é baixo (até cerca de 300 px de altura, depois rola) ou alto (até cerca de 600 px).
  • Painéis únicos: a maioria dos painéis mostra uma coisa para o projeto inteiro e pode estar em Início uma vez: Próximas ações, Meu trabalho, Gate do Processo de SE, Checagens do modelo, Qualidade dos requisitos, Verificação, Riscos, Marcos, Mudanças desde a linha de base, Discussões em aberto, Conteúdo do modelo, Resumo do projeto e Trabalho recente. Visão salva, Detalhamento, Nota, Item fixado e Galeria podem ser adicionados quantas vezes forem necessárias.
  • Painéis padrão: um novo projeto recebe painéis adequados à sua etapa. No início (a primeira metade das fases do Processo de SE, ou ainda sem linha de base do projeto): Próximas ações, Gate do Processo de SE e Qualidade dos requisitos na coluna principal; Trabalho recente, Marcos, Discussões em aberto e Resumo do projeto na coluna lateral. Mais tarde: Próximas ações, Verificação e Mudanças desde a linha de base; Trabalho recente, Riscos, Marcos e Resumo do projeto.

Como usá-lo

Quando e por quê

Use Início no começo de cada sessão de trabalho e antes das revisões. Requer atenção diz o que está quebrado; os painéis mostram o que você escolheu acompanhar.

  • Durante o trabalho com requisitos: Gate do Processo de SE para as checagens da fase, Qualidade dos requisitos para os enunciados mais fracos e um Detalhamento do status dos requisitos.
  • Antes de uma revisão como SRR ou PDR: Marcos para a data da revisão, Discussões em aberto para os comentários ainda em aberto, Mudanças desde a linha de base para o que mudou desde a última revisão e um Resumo do projeto para começar o resumo da revisão.
  • Durante a integração e os testes: Verificação, um Detalhamento do status dos casos de teste e Checagens do modelo.
  • Para uma turma ou uma equipe nova: Gate do Processo de SE conduz todos pelas checagens de fase do processo escolhido.

Organizar os painéis

  1. Clique em + Adicionar painel no fim da coluna principal ou da lateral. (Ou escolha Início ▾ → Adicionar painel…, que adiciona à coluna principal.)

    Um menu lista os painéis que ainda não estão em Início.

  2. Clique em um painel.

    A maioria dos painéis aparece no fim da coluna na hora. Visão salva, Item fixado e Galeria abrem antes um formulário curto; preencha-o e clique em Adicionar painel.

  3. Arraste o painel pelo cabeçalho para outro lugar, na mesma coluna ou na outra.

    Uma linha mostra onde ele vai parar. O layout é salvo quando você solta o mouse.

  4. Para alterar um painel, clique em ⋯ no cabeçalho dele:
    • Configurar… abre o formulário dele (só os painéis com ajustes têm essa opção).
    • Renomear… define o nome. Clicar duas vezes no nome o renomeia no local: Enter salva, Esc cancela. Um nome vazio traz de volta o nome original do painel.
    • Tornar alto ou Tornar baixo muda a altura.
    • Mover para cima, Mover para baixo e Mover para a coluna lateral (ou Mover para a coluna principal) o movem.
    • Exportar… baixa o conteúdo (só os painéis com exportações têm essa opção).
    • Remover do Início o remove na hora. A notificação oferece Desfazer.

Mover painéis com o teclado

  1. Vá até o painel com Tab (um anel de foco aparece em volta dele) ou clique no cabeçalho.
  2. Pressione Alt+↑ ou Alt+↓ para movê-lo para cima ou para baixo na coluna.
  3. Pressione Alt+→ para movê-lo para a coluna lateral, ou Alt+← para movê-lo para a coluna principal.

    O painel mantém o foco depois de cada movimento.

Acompanhar uma consulta com uma Visão salva

  1. Clique em + Adicionar painel e escolha Visão salva.
  2. Em Consulta salva, escolha uma consulta salva no Banco de dados, ou mantenha Uma consulta digitada aqui e digite uma Consulta (pesquisa do Banco de dados), por exemplo class:Risk.

    O número de itens correspondentes aparece abaixo do campo enquanto você digita.

  3. Defina Mostrar como como Contagem, Lista ou Tabela, a Ordem (Alterados por último primeiro, Mais recentes primeiro, Número ou Nome) e o número de Linhas (1 a 50).
  4. Clique em Adicionar painel.

    Abrir no Banco de dados, na parte inferior, executa a mesma consulta no Banco de dados. Exportar… → Tabela (CSV) baixa todos os itens correspondentes.

Contar itens com um Detalhamento

  1. Clique em + Adicionar painel e escolha Detalhamento.

    Um novo Detalhamento conta requisitos por Status quando o esquema tem esse atributo; caso contrário, conta itens por classe.

  2. Escolha ⋯ → Configurar… e selecione Contar por: Classe, Rótulo ou um atributo de enumeração em Atributo (listado como Classe: Atributo).
  3. Clique em Salvar.

    Com até 6 valores, o painel desenha um anel com o total no meio; com mais, desenha barras horizontais. Aponte para uma fatia ou barra para ver a contagem; uma fatia de classe ou rótulo abre o Banco de dados filtrado por ela.

  4. Para usar o gráfico em outro lugar, escolha ⋯ → Exportar… → Gráfico (SVG) ou Gráfico (PNG). O PNG tem fundo branco, a menos que você marque Fundo transparente.

Escrever um resumo do projeto

  1. Escolha ✦ IA ▾ → Escrever resumo do projeto na barra superior, ou clique em Escrever resumo no painel Resumo do projeto.

    O Holarch envia à IA o resumo do projeto, as mudanças desde a linha de base de projeto mais recente (ou os itens alterados nos últimos 30 dias), os problemas das checagens de saúde (riscos altos, testes reprovados, medidas violadas, itens TBD/TBR atrasados, vínculos a revisar, erros das checagens do modelo) e a fase atual do Processo de SE.

  2. Leia o resumo na pré-visualização. Ele tem três partes: Alterações, Em risco e Próximo, com links para os itens que cita.
  3. Clique em Manter no Início para guardá-lo no painel Resumo do projeto (um único Desfazer reverte tudo), ou em Fechar para descartá-lo.

    O painel mostra quando o resumo foi escrito, por qual modelo e a partir de quê. Escrever novamente o substitui depois de uma nova pré-visualização.

Editar a descrição do projeto

  1. Clique em Editar descrição ao lado da linha de descrição (ou em Adicionar uma descrição quando não houver nenhuma), ou escolha Início ▾ → Editar descrição….
  2. Edite o texto no editor de rich text e clique em Salvar.

    A primeira linha aparece no topo de Início. A descrição é a mesma de Preferências do projeto….

Exemplo prático: um painel de revisão para a demonstração CubeSat EO-1

A demonstração CubeSat EO-1 abre com Próximas ações, os detalhamentos Status dos requisitos e Status do caso de teste, Verificação, um diagrama fixado Functional Flow, Marcos com a data de lançamento primeiro, um gate de processo Model Walkthrough, Discussões em aberto, Trabalho recente e Resumo do projeto. Prepare-a para uma revisão de projeto:

  1. Abra o projeto de demonstração. Início abre.
  2. Clique em + Adicionar painel no fim da coluna principal e escolha Visão salva.
  3. Digite class:Risk como consulta, defina Mostrar como como Tabela e Linhas como 10, e clique em Adicionar painel.

    A tabela lista RK-1 Reaction Wheel Failure, RK-3 Launch Slip e os outros riscos.

  4. Clique duas vezes no nome do novo painel, digite Registro de riscos e pressione Enter.
  5. Arraste o painel para cima de Verificação.
  6. Escolha ✦ IA ▾ → Escrever resumo do projeto, leia a pré-visualização e clique em Manter no Início.
  7. Antes da revisão, escolha ⋯ → Exportar… → Tabela (CSV) na tabela de riscos para anexá-la ao pacote de revisão.

Dicas e boas práticas

  • Uma pergunta por painel. Um Detalhamento do status dos requisitos e uma Visão salva dos requisitos em rascunho são lidos mais rápido do que uma tabela lotada.
  • Dê aos painéis o nome da pergunta, por exemplo Requisitos não verificados.
  • Mantenha a coluna lateral curta: marcos, discussões e trabalho recente cabem nela; tabelas e gráficos precisam da coluna principal.
  • Salve uma linha de base do projeto a cada revisão. Mudanças desde a linha de base e o resumo mostram então o que mudou desde essa revisão.
  • Use testes de atributo nas consultas, como Requirement:"Status=Draft". A Ordem do painel decide a ordem.

Erros comuns

  • "Nada a contar por classe. Escolha o que contar com ⋯ → Configurar…." O Detalhamento não tem itens para contar. Escolha outro Contar por.
  • "Ainda não há linha de base do projeto. Salve uma em Linhas de base e versões para contar as mudanças posteriores a ela." Mudanças desde a linha de base precisa de uma linha de base de todo o projeto. Até lá, lista os itens alterados recentemente.
  • Um painel não se move quando arrastado. Arraste-o pelo cabeçalho, não pelo conteúdo, ou use Alt+teclas de seta.
  • O resumo está desatualizado. Um resumo é escrito uma vez, sob solicitação. Clique em Escrever novamente depois de mudanças maiores.

Como se conecta

  • Saúde e próximas ações: Próximas ações usa as mesmas contagens de Requer atenção, dos badges da barra lateral e do botão Requer atenção da barra superior.
  • Processo de SE: Gate do Processo de SE mostra a fase atual do guia Processo de SE, suas checagens em aberto e o marco do gate e o pacote de revisão.
  • Modelo e banco de dados: Visão salva e o filtro de Mudanças desde a linha de base usam a sintaxe de consulta do Banco de dados.
  • Linhas de base e versões: Mudanças desde a linha de base compara a linha de base de projeto mais recente com o modelo atual, como faz Comparar; Comparar em Linhas de base e versões abre a comparação completa.
  • Verificação e riscos: Verificação usa as mesmas linhas da RVTM; Riscos usa o Registro de riscos e a escala de riscos do projeto (Riscos, problemas e decisões).
  • Exportação: o layout dos painéis acompanha a exportação de um projeto quando Incluir preferências do projeto está ativado (consulte Importar e exportar).

A página Início

ControleO que ele faz
Início ▾Adicionar painel…, Editar descrição…, Preferências do projeto…, Exportar projeto… e Redefinir o Início…. Não aparece com acesso somente de visualização.
Continuar: …Abre o item que você abriu mais recentemente. Aparece depois que você abre um diagrama, documento ou outro item.
✦ IA ▾ → Escrever resumo do projeto (na barra superior)Escreve um resumo do projeto (veja acima).

Redefinir o Início… pergunta "Substituir os painéis pelo conjunto padrão para a etapa do projeto? Desfazer traz de volta os painéis atuais." Redefinir substitui todos os painéis.

Cabeçalho do painel

ControleO que ele faz
NomeO nome do painel. Clique duas vezes para renomeá-lo no local. Arraste o cabeçalho para mover o painel.
⋯Configurar…, Renomear…, Tornar alto / Tornar baixo, Mover para cima, Mover para baixo, Mover para a coluna lateral / Mover para a coluna principal, Exportar… e Remover do Início.

Painéis

PainelO que mostraAjustes e exportações
Próximas açõesAté 6 dos itens mais urgentes, de testes reprovados aos primeiros requisitos—
Meu trabalhoAtribuído a mim (com prazos), Aguardando revisão (requisitos Em revisão) e Menções (comentários em aberto que mencionam seu nome); Abrir Meu trabalho—
Gate do Processo de SEA fase atual com sua etapa e progresso, Checagens em aberto (até 4, alto 8) com links, e Gate: cada revisão da fase com seu marco, pacote de revisão e dias restantes; Abrir Processo de SE—
Checagens do modeloErros e avisos, depois as principais constatações (5, alto 10), erros primeiro, cada uma com Corrigir; Abrir checagens do modelo—
Qualidade dos requisitosUma barra dos requisitos por pontuação de qualidade: Boa (67 % ou mais), Razoável, Fraca (abaixo de 34 %) e Sem pontuação, depois Menores pontuações (4, alto 10); Abrir Qualidade—
Verificaçãoverificados (n de total), reprovado e sem teste; cada um abre a RVTM filtrada por ele. Alto: Sem teste lista os requisitos—
RiscosUm mapa de calor: linhas de probabilidade (a mais alta no topo) por colunas de consequência na escala de riscos do projeto, com o número de riscos em cada célula e a cor do nível da célula; riscos sem probabilidade ou consequência são contados abaixo; Abrir Registro de riscos—
MarcosItens Time com o rótulo Milestone e data de início de hoje em diante (5, alto 12), com a data e Em n dias; a menos de 14 dias, o chip fica destacado. O número de marcos já passados aparece abaixo—
Mudanças desde a linha de baseA linha de base de projeto mais recente, depois adicionados, removidos, alterados e mudanças de vínculos, depois Últimos itens alterados (4, alto 8); Comparar em Linhas de base e versõesConfigurar…: Somente itens correspondentes (uma consulta do Banco de dados)
Discussões em abertoComentários não resolvidos (5, alto 12), primeiro as menções a você, com o item, o autor, a data e Resolver—
Visão salvaUma consulta como Contagem, Lista ou Tabela (Número, Nome, Classe); Abrir no Banco de dadosConfigurar…: Consulta salva, Consulta (pesquisa do Banco de dados), Mostrar como, Ordem, Linhas; Tabela (CSV)
DetalhamentoContagens de itens como anel (até 6 valores) ou barras (mais de 6), com "Contar por …" abaixoConfigurar…: Contar por; Gráfico (SVG), Gráfico (PNG)
Resumo do projetoO resumo guardado, quando e a partir de quê foi escrito; Escrever resumo / Escrever novamente—
NotaRich text livre; Editar, depois Salvar ou Cancelar—
Conteúdo do modeloContagens de itens: itens, requisitos, ações, assets e relacionamentos, depois Mudanças recentes: os últimos itens alterados (6, alto 12); Abrir Banco de dados—
Trabalho recenteAbas abertas e documentos editados recentemente (6, alto 12)—
Item fixadoUm diagrama, documento, apresentação, gráfico ou outro artefato como cartão com sua imagemConfigurar…: Tipo, Item; Imagem (PNG)
GaleriaTodos os artefatos de um tipo como cartões, com pesquisa, ordenação e Mostrar maisConfigurar…: Tipo

Dashboards de versões anteriores

Um projeto salvo com o antigo dashboard de widgets abre com os widgets convertidos em painéis, na ordem de leitura. Os widgets do terço direito da grade antiga vão para a coluna lateral; widgets com 10 linhas de altura ou mais se tornam painéis altos. O título próprio de um widget se torna o nome do painel.

WidgetPainel
NotaNota com o mesmo texto
Pie Chart, Bar ChartDetalhamento com as mesmas classes, rótulos ou atributo
Entity TableVisão salva como tabela com a mesma consulta, ordem, colunas e até 50 linhas
Recent ChangesMudanças desde a linha de base
Recent CommentsDiscussões em aberto
Countdown ClockMarcos, com o item ou a data do relógio primeiro
CalendarMarcos (o calendário mensal está em Gerenciamento de projetos)
Process StepsGate do Processo de SE, com uma linha para a lista de verificação e seu progresso; as etapas continuam sendo itens do modelo
Requirement Verification (RVTM)Verificação
Artifact PreviewItem fixado
All ExistingGaleria
Project Summary, Project Description, Main PagesNão transferidos: Requer atenção e Ciclo de vida mostram as contagens, a descrição está no cabeçalho e a barra lateral tem links para as páginas

Um aviso acima das colunas informa quantos widgets se tornaram painéis e cita os que não foram transferidos. Manter estes painéis salva o layout convertido; Usar os painéis padrão o substitui pelo conjunto padrão. O layout antigo fica no projeto até ser excluído com o projeto.

Salvamento, desfazer e funções

  • Cada mudança em Início (adicionar, mover, redimensionar, renomear, ajustes, remover, redefinir, um resumo guardado) é revertida com um único Desfazer (⌘Z / Ctrl+Z).
  • O layout faz parte do projeto. Todos os membros veem o mesmo Início, e uma mudança feita por um membro chega aos outros.
  • Leitores e Revisores veem os painéis, mas não Início ▾, + Adicionar painel nem os comandos de edição em ⋯.

Mensagens

MensagemSignificado e correção
"Todos os painéis já estão em Início."Todos os painéis únicos estão em Início e nenhum outro painel pode ser adicionado. Remova um antes.
"Escolha um item. Este projeto ainda não tem nenhum deste tipo."Item fixado: escolha outro tipo ou crie primeiro um item deste tipo.
"Não é possível ler a consulta. Confira-a com a sintaxe de pesquisa do Banco de dados."Visão salva: corrija a consulta.
"A consulta salva deste painel foi excluída. Escolha outra com ⋯ → Configurar…."A consulta do Banco de dados por trás de uma Visão salva não existe mais.
"O item fixado não existe mais. Escolha outro com ⋯ → Configurar…."O artefato fixado foi excluído.
"Nenhum guia de processo em uso. Escolha um processo para ver aqui suas checagens de fase e gates."Gate do Processo de SE sem processo. Clique em Abrir Processo de SE e escolha um.
"Nenhum marco próximo. Aplique o rótulo Milestone a um item Time e dê a ele uma data de início, ou adicione marcos de gate em Processo de SE."Marcos não tem nada para mostrar.
"Não foi possível mostrar este painel: …"O painel não pôde ser desenhado. Confira os ajustes dele ou remova-o e adicione-o novamente.

Limites

  • Duas colunas; os painéis são baixos ou altos.
  • Visão salva: até 50 linhas; o CSV contém todos os itens correspondentes.
  • Resumo do projeto: no máximo 150 mudanças e 40 riscos altos vão para a IA. O resumo não está disponível em projetos SysML v2.
  • Um Início por projeto, compartilhado por todos os membros.