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.
Nesta página
- Conceitos
- Como usá-lo
- Quando e por quê
- Organizar os painéis
- Mover painéis com o teclado
- Acompanhar uma consulta com uma Visão salva
- Contar itens com um Detalhamento
- Escrever um resumo do projeto
- Editar a descrição do projeto
- Exemplo prático: um painel de revisão para a demonstração CubeSat EO-1
- Dicas e boas práticas
- Erros comuns
- Como se conecta
- A página Início
- Dashboards de versões anteriores
- Salvamento, desfazer e funções
- Mensagens
- Limites
- 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
- 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.
- 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.
- 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.
- 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
- Vá até o painel com Tab (um anel de foco aparece em volta dele) ou clique no cabeçalho.
- Pressione Alt+↑ ou Alt+↓ para movê-lo para cima ou para baixo na coluna.
- 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
- Clique em + Adicionar painel e escolha Visão salva.
- 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.
- 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).
- 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
- 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.
- Escolha ⋯ → Configurar… e selecione Contar por: Classe, Rótulo ou um atributo de enumeração em Atributo (listado como Classe: Atributo).
- 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.
- 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
- 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.
- 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.
- 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
- 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….
- 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:
- Abra o projeto de demonstração. Início abre.
- Clique em + Adicionar painel no fim da coluna principal e escolha Visão salva.
- Digite
class:Riskcomo 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.
- Clique duas vezes no nome do novo painel, digite Registro de riscos e pressione Enter.
- Arraste o painel para cima de Verificação.
- Escolha ✦ IA ▾ → Escrever resumo do projeto, leia a pré-visualização e clique em Manter no Início.
- 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
Cabeçalho da página
| Controle | O 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
| Controle | O que ele faz |
|---|---|
| Nome | O 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
| Painel | O que mostra | Ajustes e exportações |
|---|---|---|
| Próximas ações | Até 6 dos itens mais urgentes, de testes reprovados aos primeiros requisitos | — |
| Meu trabalho | Atribuí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 SE | A 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 modelo | Erros e avisos, depois as principais constatações (5, alto 10), erros primeiro, cada uma com Corrigir; Abrir checagens do modelo | — |
| Qualidade dos requisitos | Uma 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ção | verificados (n de total), reprovado e sem teste; cada um abre a RVTM filtrada por ele. Alto: Sem teste lista os requisitos | — |
| Riscos | Um 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 | — |
| Marcos | Itens 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 base | A 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ões | Configurar…: Somente itens correspondentes (uma consulta do Banco de dados) |
| Discussões em aberto | Comentários não resolvidos (5, alto 12), primeiro as menções a você, com o item, o autor, a data e Resolver | — |
| Visão salva | Uma consulta como Contagem, Lista ou Tabela (Número, Nome, Classe); Abrir no Banco de dados | Configurar…: Consulta salva, Consulta (pesquisa do Banco de dados), Mostrar como, Ordem, Linhas; Tabela (CSV) |
| Detalhamento | Contagens de itens como anel (até 6 valores) ou barras (mais de 6), com "Contar por …" abaixo | Configurar…: Contar por; Gráfico (SVG), Gráfico (PNG) |
| Resumo do projeto | O resumo guardado, quando e a partir de quê foi escrito; Escrever resumo / Escrever novamente | — |
| Nota | Rich text livre; Editar, depois Salvar ou Cancelar | — |
| Conteúdo do modelo | Contagens 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 recente | Abas abertas e documentos editados recentemente (6, alto 12) | — |
| Item fixado | Um diagrama, documento, apresentação, gráfico ou outro artefato como cartão com sua imagem | Configurar…: Tipo, Item; Imagem (PNG) |
| Galeria | Todos os artefatos de um tipo como cartões, com pesquisa, ordenação e Mostrar mais | Configurar…: 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.
| Widget | Painel |
|---|---|
| Nota | Nota com o mesmo texto |
| Pie Chart, Bar Chart | Detalhamento com as mesmas classes, rótulos ou atributo |
| Entity Table | Visão salva como tabela com a mesma consulta, ordem, colunas e até 50 linhas |
| Recent Changes | Mudanças desde a linha de base |
| Recent Comments | Discussões em aberto |
| Countdown Clock | Marcos, com o item ou a data do relógio primeiro |
| Calendar | Marcos (o calendário mensal está em Gerenciamento de projetos) |
| Process Steps | Gate 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 Preview | Item fixado |
| All Existing | Galeria |
| Project Summary, Project Description, Main Pages | Nã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
| Mensagem | Significado 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.