Requisitos
Mapa do programa
Veja como seus projetos se vinculam entre si, com contagens de vínculos por par de projetos, e siga a cadeia de vínculos de um item por outros projetos.
Nesta página
Visão geral
Um programa que abrange vários projetos (um projeto do sistema, projetos de subsistemas, um projeto de testes, bibliotecas) é amarrado por vínculos com outros projetos. Cada vínculo fica guardado no projeto que o cria, então nenhum projeto sozinho mostra o quadro completo. O Mapa do programa mostra: ele desenha uma caixa por projeto que você pode abrir e uma seta por par de projetos, rotulada com a relação e o número de vínculos.
A página tem duas visões:
- Projetos: todos os projetos que você pode abrir e os vínculos entre eles, como grafo ou tabela.
- Rastreamento do item: um item no meio e os itens vinculados a ele em outros projetos, anel por anel, até seis etapas de distância.
O Mapa do programa está aberto a todos que entraram na conta. Os vínculos em si são criados no plano Team; os vínculos guardados em um projeto cujo plano do proprietário não os inclui são desenhados em cinza. Os vínculos entre os projetos de demonstração Hybrid Car e Hybrid Car Battery Pack funcionam em todos os planos.
Conceitos
O que o mapa mostra
| Elemento | Significado |
|---|---|
| Caixa | Um projeto que você pode abrir: o nome, o tipo de projeto e o número de itens; o nome acessível acrescenta os vínculos que ele contém e recebe |
| Seta | Vínculos guardados no projeto da cauda que apontam para itens do projeto da ponta |
| Rótulo da seta | relação · vínculos · excluídos, por exemplo traced from · 12 · 1 excluído |
| Projetos que você não pode abrir (N vínculos) | Uma caixa tracejada que conta todos os vínculos para um projeto que você não pode abrir |
| Caixa de liberação de biblioteca | Uma liberação de biblioteca que você pode ler, vinculada a partir dos seus projetos |
As setas geralmente apontam para cima: os projetos de subsistemas guardam vínculos traced from e satisfies com o projeto do sistema, e os projetos de testes guardam vínculos verifies. O mapa coloca os projetos que contêm vínculos abaixo dos projetos para os quais apontam.
Quem vê o quê
O mapa é montado apenas a partir dos projetos que você pode abrir: um projeto do qual você é membro com qualquer função, que não está na Lixeira e cuja regra de autenticação em duas etapas da organização você cumpre.
- Um vínculo para um projeto que você não pode abrir é contado em Projetos que você não pode abrir (N vínculos). Essa caixa nunca nomeia o projeto nem o item, e tem a mesma aparência se o projeto existe, está na Lixeira ou nunca existiu.
- Os vínculos guardados em um projeto que você não pode abrir não são contados em lugar nenhum, mesmo quando apontam para os seus projetos.
- Ser administrador da organização não acrescenta nada: o mapa usa a participação nos projetos.
- As exportações (CSV, SVG, PNG) contêm exatamente o que a página mostra.
Cores
| Cor | Significado |
|---|---|
| Seta azul | Vínculos entre projetos que você pode abrir |
| Seta âmbar | Alguns dos destinos foram excluídos (na Lixeira ou sumidos) |
| Seta cinza | Vínculos para projetos que você não pode abrir, para uma liberação de biblioteca, ou guardados em um projeto cujo plano do proprietário não inclui vínculos com outros projetos |
Como usá-lo
Ver como os seus projetos se vinculam
- Clique em Gerenciar projetos e depois em Mapa do programa. A visão Projetos abre com todos os projetos que contêm ou recebem vínculos.
- Leia as setas. Aponte para uma caixa para esmaecer tudo o que não está conectado a ela.
- Clique em uma seta. O inspetor lista os vínculos dela, 100 de cada vez: o item que contém cada vínculo, a relação e o item de destino. Clique em qualquer um dos itens para abri-lo no projeto dele, ou em Mostrar mais para os próximos 100.
- Clique em Exportar CSV no inspetor para salvar os vínculos dessa seta, ou em Exportar ▾ na barra para salvar o mapa inteiro como CSV, SVG ou PNG.
Começar por um projeto
- Abra o projeto, depois Verificação → Cobertura do programa, e clique em Abrir Mapa do programa.
- O mapa mostra apenas esse projeto e os projetos vinculados a ele, diretamente ou por meio de outros.
- Clique em Mostrar todos os projetos para ver tudo o que você pode abrir.
Você também pode clicar em uma caixa e escolher Mostrar só projetos vinculados.
Rastrear um item pelo programa
- Selecione o item. Na seção Rastreabilidade do inspetor, abra Outros projetos ⋯ e escolha Mostrar no Mapa do programa. Na lista de vínculos de uma seta, clique em Rastrear este item.
- A visão Rastreamento do item mostra o item no meio e os itens vinculados a ele em anéis: o primeiro anel a uma etapa de distância, o segundo a duas. Os vínculos são seguidos nas duas direções.
- Escolha Etapas (1 a 6, padrão 3) para ir mais longe ou ficar mais perto.
- Os itens são coloridos por projeto, com uma caixa tracejada em torno dos itens de cada projeto. Desmarque Agrupar por projeto para remover as caixas.
- Clique em um item para ver Abrir item e Rastrear a partir daqui, que o coloca no meio.
Exemplo prático: a demonstração CubeSat EO-1 e um projeto de carga útil
- Crie a demonstração CubeSat EO-1 e depois um segundo projeto EO-1 Payload com o requisito PL.1 Imager resolution.
- Em EO-1 Payload, selecione PL.1. Em Rastreabilidade → Outros projetos, clique em +, escolha traced from, o projeto CubeSat e o requisito de imageamento dele, e clique em Adicionar vínculo.
- Crie um terceiro projeto EO-1 Test Campaign com o caso de teste TC.4 Resolution test, e vincule-o com verifies a PL.1 em EO-1 Payload.
- Abra Gerenciar projetos → Mapa do programa. O mapa mostra EO-1 Test Campaign embaixo, EO-1 Payload acima dele e o projeto CubeSat no topo, com as setas verifies · 1 e traced from · 1.
- Clique em PL.1 → Rastreabilidade ⋯ → Mostrar no Mapa do programa: o caso de teste e o requisito do CubeSat ficam a uma etapa de distância, um de cada lado.
Exemplo prático: o Hybrid Car e o seu conjunto de baterias
- Em Gerenciar projetos, clique em Arquivos do projeto ▾ → Novo projeto de demonstração → Hybrid Car (SysML v2).
- Depois crie Arquivos do projeto ▾ → Novo projeto de demonstração → Hybrid Car Battery Pack (SysML v2). Os requisitos do conjunto de baterias do fornecedor, PackCapacity, PackMass e ChargeAcceptance, estão vinculados com traced from aos requisitos do carro VR-3, VR-6 e VR-5 na sua demonstração Hybrid Car mais recente, independentemente de qual das duas você criar primeiro; criar a demonstração Hybrid Car de novo move os vínculos para a nova. Esses vínculos de demonstração funcionam em todos os planos. Sem um projeto Hybrid Car, a demonstração do conjunto de baterias não tem vínculos.
- Abra Gerenciar projetos → Mapa do programa. O mapa mostra os dois projetos SysML v2 com a seta traced from · 3.
Dicas e boas práticas
- Combine as relações que os subprojetos usam (traced from ou satisfies para requisitos, verifies para testes) para que as setas se leiam da mesma forma em todo lugar.
- Desative Agrupar relações para ver uma seta por relação, por exemplo para distinguir os vínculos de requisitos dos vínculos de testes entre os mesmos dois projetos.
- Arraste as caixas para organizar o mapa. As posições ficam guardadas neste navegador para cada escopo.
- Use a visão Tabela para ordenar os pares de projetos por número de vínculos ou de destinos excluídos.
- Uma seta âmbar indica vínculos que precisam de reparo: abra a lista de vínculos dela e depois corrija ou remova os vínculos em Rastreabilidade → Outros projetos do item.
Erros comuns
| Problema | Causa | Correção |
|---|---|---|
| Um projeto está faltando | Você não é membro dele, ele está na Lixeira ou não tem vínculos | Peça acesso ao proprietário; marque Mostrar projetos sem vínculos para listar os projetos sem vínculos |
| Tudo vai para Projetos que você não pode abrir | Os vínculos apontam para projetos dos quais você não é membro | Peça acesso ao proprietário do projeto |
| Setas cinza no meio do mapa | O projeto que contém os vínculos tem um proprietário sem o plano Team | O proprietário faz o upgrade em Ajustes da conta → Plano e cobrança |
| Um novo vínculo ainda não aparece | O mapa ainda está lendo as alterações recentes | Clique em Atualizar após um minuto |
Como se conecta a outros recursos
- Vínculos com outros projetos: o mapa os lê; não adiciona nem altera nada. Crie vínculos em Rastreabilidade → Outros projetos de um item (veja Vínculos com outros projetos).
- Cobertura do programa: a visão por item dos vínculos para um projeto, com as lacunas (veja Cobertura do programa). Abrir Mapa do programa ali inicia o mapa a partir desse projeto.
- Bibliotecas: os vínculos com um item de uma liberação de biblioteca aparecem como setas para a caixa da liberação (veja Bibliotecas).
- Diagrama Spider: o rastreamento dentro de um projeto, com caixas tracejadas para itens vinculados em outros lugares. O Rastreamento do item usa o mesmo layout em anéis.
- API e MCP: o mesmo mapa e o mesmo rastreamento para ferramentas (veja API e MCP).
A página Mapa do programa
Barra
| Controle | O que ele faz |
|---|---|
| Projetos / Rastreamento do item | Alterna a visão |
| Escopo | Todos os meus projetos, uma organização (quando você pertence a uma) ou uma pasta com as subpastas dela (quando você tem pastas; veja Pastas de projetos) |
| Mostrar todos os projetos | Mostrado depois de abrir o mapa a partir de um projeto; sai do conjunto vinculado desse projeto |
| Mostrar projetos sem vínculos | Mostra também os projetos sem vínculos |
| Agrupar relações | Uma seta por par de projetos (os rótulos listam cada relação), ou uma seta por relação |
| Etapas | Rastreamento do item: de 1 a 6 etapas de distância |
| Agrupar por projeto | Rastreamento do item: caixas tracejadas em torno dos itens de cada projeto |
| Grafo / Tabela | O diagrama ou uma tabela ordenável; em uma tela estreita, a tabela abre primeiro |
| Atualizar | Lê os vínculos de novo |
| Exportar ▾ | Exportar CSV, Exportar SVG, Exportar PNG |
Grafo
- Clique em uma caixa para mostrar o projeto dela no inspetor: Abrir projeto e Mostrar só projetos vinculados. Clique duas vezes em uma caixa, ou pressione Shift+Enter nela, para abrir o projeto.
- Clique em uma seta para listar os vínculos dela no inspetor.
- Arraste as caixas para movê-las; role ou faça o gesto de pinça para dar zoom; arraste o fundo para deslocar.
- Pressione Tab para chegar ao mapa e depois as teclas de seta para mover entre caixas e setas; Enter vai para o inspetor. Cada caixa e cada seta têm um nome que um leitor de tela lê, como "EO-1 Payload, projeto LML, 1 vínculo de saída, 1 de entrada".
Tabela
| Visão | Colunas |
|---|---|
| Projetos | Projeto de origem, Relação, Projeto de destino, Vínculos, Excluído |
| Rastreamento do item | Projeto, Número, Nome, Classe, Etapas a partir do item, Estado |
Clique no título de uma coluna para ordenar.
Inspetor
| Seleção | Conteúdo |
|---|---|
| Caixa do projeto | Nome, tipo, número de itens, vínculos de saída e de entrada; Abrir projeto, Mostrar só projetos vinculados |
| Seta | Projeto de origem e de destino, vínculos por relação, a lista de vínculos (100 de cada vez, Mostrar mais), Exportar CSV, Rastrear este item por linha |
| Item (Rastreamento do item) | Número e nome, classe, projeto, etapas a partir do item rastreado, estado; Abrir item, Rastrear a partir daqui |
| Projetos que você não pode abrir | "Vínculos para projetos que você não pode abrir. Peça acesso ao proprietário do projeto." |
API e MCP
A API REST e o MCP dão as mesmas respostas com o próprio acesso e a lista de projetos do token. Os projetos de uma organização que desativou o acesso à API ficam de fora, como os projetos que você não pode abrir.
| Chamada | Retorna |
|---|---|
GET /api/v1/program-map | Projetos, liberações, setas (from, to, relation, links, deleted, plan) e a contagem oculta; from, unlinked, org como na página |
GET /api/v1/projects/<project>/items/<item>/trace | O Rastreamento do item: nós com projeto, número, nome, classe e etapas, os vínculos entre eles e a contagem oculta; steps 1–6 (padrão 3) |
MCP program_map | O mesmo que GET /program-map |
MCP trace_chain | O mesmo que a chamada de rastreamento; os itens em projetos com marcações de dados regulados respondem withheld |
Veja API e MCP.
Mensagens
| Mensagem | Significado |
|---|---|
| Nenhum vínculo entre os seus projetos. Adicione um na seção Rastreabilidade de um item. | Nenhum dos seus projetos contém ou recebe um vínculo que você possa ver |
| Este projeto não tem vínculos com outros projetos. Adicione um na seção Rastreabilidade de um item. | O mapa foi aberto a partir de um projeto sem vínculos |
| Este item não tem vínculos com outros projetos. Adicione um na seção Rastreabilidade dele. | O item rastreado não tem vínculos |
| Alguns projetos ainda estão sendo lidos. Atualize em um minuto. | As alterações recentes em projetos grandes ainda estão sendo lidas; o mapa mostra o que está pronto |
| Mostrando os primeiros 500 itens. Reduza as etapas. | O Rastreamento do item atingiu o limite |
| N vínculos de projetos cujo plano do proprietário não inclui vínculos com outros projetos não são seguidos. | O Rastreamento do item ignorou vínculos guardados sob um plano que não os inclui |
| Não foi possível ler o mapa do programa. Recarregue a página. | A solicitação falhou |
Limites
| Limite | Valor |
|---|---|
| Etapas do Rastreamento do item | 1 a 6 |
| Itens em um Rastreamento do item | 500 |
| Vínculos listados por página na lista de uma seta | 100 |
| Vínculos por projeto | 20.000 (veja Vínculos com outros projetos) |