Ir para o conteúdo

Inventário

O Inventário é o coração do Turbo EA. Aqui todos os cards (componentes) da arquitetura empresarial são listados: aplicações, processos, capacidades de negócio, organizações, fornecedores, interfaces e mais.

Visão do Inventário com Painel de Filtros

Estrutura da Tela do Inventário

Painel de Filtros à Esquerda

O painel lateral esquerdo permite filtrar cards por diferentes critérios:

  • Pesquisa — Busca de texto livre nos nomes dos cards
  • Tipos — Filtrar por um ou mais tipos de card: Objetivo, Plataforma, Iniciativa, Organização, Capacidade de Negócio, Contexto de Negócio, Processo de Negócio, Aplicação, Interface, Objeto de Dados, Componente de TI, Categoria Tecnológica, Fornecedor, Sistema
  • Subtipos — Quando um tipo é selecionado, filtre ainda mais por subtipo (ex.: Aplicação -> Aplicação de Negócio, Microsserviço, Agente de IA, Implantação)
  • Status de Aprovação — Rascunho, Aprovado, Quebrado ou Rejeitado
  • Ciclo de Vida — Filtrar por fase do ciclo de vida: Planejamento, Implantação, Ativo, Desativação, Fim de Vida
  • Qualidade dos Dados — Filtragem por limite: Bom (80%+), Médio (50-79%), Ruim (abaixo de 50%)
  • Tags — Filtrar por tags de qualquer grupo de tags
  • Relacionamentos — Filtrar por cards relacionados através de tipos de relacionamento
  • Atributos personalizados — Filtrar por valores em campos personalizados (busca de texto, opções de seleção)
  • Mostrar apenas arquivados — Alternância para visualizar cards arquivados (excluídos temporariamente)
  • Limpar tudo — Redefinir todos os filtros ativos de uma vez

Encontrar cartões sem valor. Os filtros de Subtipo, Ciclo de vida, Etiquetas, Relações e atributos personalizados de seleção incluem, cada um, uma opção (vazio). Selecione-a para listar apenas os cartões que não têm valor nesse campo — por exemplo, todos os cartões sem ciclo de vida definido. Pode ser combinada com valores normais (corresponde a qualquer um) e entre vários filtros (corresponde a todos).

Um contador de filtros ativos mostra quantos filtros estão atualmente aplicados.

Aba Colunas

A aba Colunas no painel lateral permite escolher quais colunas adicionais exibir na grade. As colunas disponíveis mudam dinamicamente com base nos tipos de cartões selecionados:

  • Um único tipo selecionado — Todos os campos de atributos definidos para esse tipo estão disponíveis, além de colunas de relações e metadados
  • Vários tipos selecionados — Apenas os campos que são comuns a todos os tipos selecionados estão disponíveis
  • Nenhum tipo selecionado — Uma mensagem de orientação solicita que você selecione primeiro um tipo de cartão

As colunas são agrupadas em cinco categorias:

Categoria Descrição
Colunas padrão Colunas sempre ativas: Tipo, Nome, Caminho, Descrição, Subtipo, Ciclo de vida, Estado de aprovação, Qualidade dos dados. Desmarque-as para ocultá-las da grade — útil para ajustar uma visualização salva apenas às colunas que você realmente usa.
Metadados Criado, Modificado, Criado por, Modificado por
Atributos Campos personalizados definidos no metamodelo (texto, número, custo, data, seleção, etc.)
Relações Tipos de cartões relacionados (por ex., Aplicações vinculadas a uma Capacidade de Negócio)
Partes interessadas Uma coluna por cada papel de parte interessada definido para o tipo selecionado (por ex. Partes interessadas: Responsible), mostrando os utilizadores atribuídos como chips. No modo de edição da grade, faça duplo clique numa célula para atribuir ou remover utilizadores desse papel diretamente na grade (requer a permissão de gestão de partes interessadas).

A coluna Pai mostra apenas o cartão diretamente acima, enquanto Caminho mostra toda a cadeia. No modo de edição da grelha, faça duplo clique numa célula Pai para mover o cartão, ou esvazie o campo para o levar ao nível superior. A coluna só é editável quando a grelha está filtrada por um único tipo de cartão com suporte a hierarquia. Se um movimento for recusado — por criar um ciclo, colidir com um cartão do mesmo nome sob o destino ou exceder a profundidade máxima —, o motivo aparece no fundo do ecrã e a célula é revertida.

A coluna Caminho mostra a hierarquia da ficha (por ex. «América do Norte / Vendas / Vendas internas») sem incluir o próprio nome da ficha, para que você possa exibir Nome e Caminho ao mesmo tempo.

Cada categoria tem uma caixa de seleção Selecionar tudo para ativar ou desativar rapidamente todas as colunas desse grupo. Um campo de pesquisa no topo permite encontrar colunas específicas por nome. O indicador em cada cabeçalho de seção mostra quantas colunas desse grupo estão atualmente visíveis.

Quando um tipo de cartão é selecionado pela primeira vez, todas as colunas de atributos e relações são ativadas por padrão. Você pode então desmarcar as colunas que não precisa. Um botão Redefinir na parte inferior da aba «Colunas» restaura a seleção de colunas padrão.

Um ponto indicador de alteração aparece no cabeçalho da aba «Colunas» quando a seleção de colunas difere dos padrões. O mesmo indicador aparece na aba Filtros quando há filtros ativos, facilitando ver rapidamente quais configurações foram modificadas.

Sua seleção de colunas, o layout das colunas (ordem da esquerda para a direita, larguras e colunas fixadas), os filtros ativos e a ordem de classificação são salvos automaticamente no navegador. Ao retornar à página de inventário, sua configuração anterior é restaurada. As visualizações salvas (favoritos) também preservam esse layout completo, de modo que ao alternar entre visualizações são restauradas exatamente as colunas que você havia configurado, e na mesma disposição, o que importa ao compartilhar uma visualização organizada com as partes interessadas.

Tabela Principal

O inventário usa uma tabela de dados AG Grid com recursos poderosos:

Coluna Descrição
Tipo Tipo do card com ícone colorido
Nome Nome do componente (clique para abrir o detalhe do card)
Descrição Breve descrição
Ciclo de Vida Estado atual do ciclo de vida
Status de Aprovação Badge de status de revisão
Qualidade dos Dados Porcentagem de completude com anel visual
Relacionamentos Contagem de relacionamentos com popover clicável mostrando cards relacionados

Recursos da tabela:

  • Ordenação — Clique em qualquer cabeçalho de coluna para ordenar em ascendente/descendente
  • Edição inline — No modo de edição da grade, edite valores de campos diretamente na tabela
  • Seleção múltipla — Selecione múltiplas linhas para operações em massa
  • Exibição de hierarquia — Relacionamentos pai/filho mostrados como caminhos em breadcrumb
  • Configuração de colunas — Mostrar, ocultar e reordenar colunas

Barra de Ferramentas

  • Edição na Grade — Alternar modo de edição inline para editar múltiplos cards na tabela
  • Exportar — Baixar dados como arquivo Excel (.xlsx)
  • Importar — Upload em massa de dados a partir de arquivos Excel
  • + Criar — Criar um novo card

Diálogo de Criação de Card

Como Criar um Novo Card

  1. Clique no botão + Criar (azul, canto superior direito)
  2. No diálogo que aparece:
  3. Selecione o Tipo de card (Aplicação, Processo, Objetivo, etc.)
  4. Insira o Nome do componente
  5. Opcionalmente, adicione uma Descrição
  6. Opcionalmente, clique em Sugerir com IA para gerar uma descrição automaticamente (veja Sugestões de Descrição com IA abaixo)
  7. Clique em CRIAR

Edição em massa

Marque duas ou mais linhas com as caixas de seleção da coluna à esquerda e clique em Edição em massa na barra de seleção. A caixa de diálogo aplica uma única alteração a todos os cartões selecionados.

A lista Campo agrupa o que pode ser alterado:

  • Geral — estado de aprovação, subtipo, etiquetas e pai
  • Atributos — qualquer campo editável definido para o tipo de cartão selecionado
  • Relações — uma entrada por tipo de relação e direção (por exemplo é executado em → Componente de TI)

Etiquetas, relações e pai oferecem um botão adicionar / remover, para que amplie ou reduza os valores existentes em vez de os substituir.

Reestruturar a hierarquia

O campo Pai aparece quando a grelha está filtrada por um único tipo de cartão com suporte a hierarquia. Um cartão tem exatamente um pai, por isso este único campo cobre os dois sentidos de uma reestruturação:

  • Definir pai — escolha um cartão do mesmo tipo; todos os cartões selecionados passam para baixo dele. É assim que se tornam vários cartões filhos de um mesmo pai.
  • Remover pai — todos os cartões selecionados voltam ao nível superior.

Os cartões são movidos um a um, pelo que um movimento não permitido bloqueia apenas esse cartão. A caixa de diálogo permanece aberta e indica quais os cartões bloqueados e porquê. Os motivos habituais são:

  • Já existe um cartão com o mesmo nome sob o pai de destino.
  • O pai escolhido é descendente de um dos cartões que estão a ser movidos, o que criaria um ciclo.
  • O movimento levaria uma capacidade de negócio para além do máximo de cinco níveis.

Um cartão leva consigo os seus próprios filhos ao mover-se, e os cartões aprovados voltam a Quebrado para que a alteração seja revista.

Sugestões de Descrição com IA

O Turbo EA pode usar IA para gerar uma descrição para qualquer card. Isso funciona tanto no diálogo de Criação de Card quanto nas páginas de detalhe de cards existentes.

Como funciona:

  1. Insira um nome de card e selecione um tipo
  2. Clique no ícone de brilho no cabeçalho do card, ou no botão Sugerir com IA no diálogo de Criação de Card
  3. O sistema realiza uma busca na web pelo nome do item (usando contexto por tipo — ex.: "SAP S/4HANA software application"), então envia os resultados para um LLM para gerar uma descrição concisa e factual
  4. Um painel de sugestão aparece com:
  5. Descrição editável — revise e modifique o texto antes de aplicar
  6. Pontuação de confiança — indica o quão certa a IA está (Alta / Média / Baixa)
  7. Links de fontes clicáveis — as páginas web das quais a descrição foi derivada
  8. Nome do modelo — qual LLM gerou a sugestão
  9. Clique em Aplicar descrição para salvar, ou Descartar para ignorar

Características principais:

  • Contextual por tipo: A IA entende o contexto do tipo de card. Uma busca de "Aplicação" adiciona "software application", uma busca de "Fornecedor" adiciona "technology vendor", etc.
  • Privacidade em primeiro lugar: Ao usar Ollama, o LLM roda localmente — seus dados nunca saem da sua infraestrutura. Provedores comerciais (OpenAI, Google Gemini, Anthropic Claude, etc.) também são suportados
  • Controlado pelo administrador: Sugestões de IA devem ser habilitadas por um administrador em Configurações > Sugestões de IA. Administradores escolhem quais tipos de card mostram o botão de sugestão, configuram o provedor de LLM e selecionam o provedor de busca web
  • Baseado em permissões: Apenas usuários com a permissão ai.suggest podem usar este recurso (habilitado por padrão para os papéis Admin, BPM Admin e Membro)

Visualizações Salvas (Favoritos)

Você pode salvar sua configuração atual de filtros, colunas e ordenação como uma visualização nomeada para reutilização rápida.

Criando uma Visualização Salva

  1. Configure o inventário com os filtros, colunas e ordenação desejados
  2. Clique no ícone de favorito no painel de filtros
  3. Insira um nome para a visualização
  4. Escolha a visibilidade:
  5. Privada — Apenas você pode ver
  6. Compartilhada — Visível para usuários específicos (com permissões de edição opcionais)
  7. Pública — Visível para todos os usuários

Usando Visualizações Salvas

Visualizações salvas aparecem na barra lateral do painel de filtros. Clique em qualquer visualização para aplicar instantaneamente sua configuração. As visualizações são organizadas em:

  • Minhas Visualizações — Visualizações que você criou
  • Compartilhadas Comigo — Visualizações que outros compartilharam com você
  • Visualizações Públicas — Visualizações disponíveis para todos

Importação / Exportação Excel

As importações e exportações do inventário usam uma pasta de trabalho Excel com várias planilhas que reconstrói uma sub-paisagem inteira — cards de qualquer número de tipos e as relações entre eles — sem nunca exigir a cópia de um UUID.

Estrutura da pasta de trabalho

  • Uma planilha por tipo de card (Application, Business Capability, IT Component, …) com as colunas principais, as colunas attr_<campo>, as colunas de ciclo de vida as colunas de relação rel:<tipo_de_relação> e as colunas de partes interessadas stakeholder:<chave_do_papel>.
  • Uma planilha Relations para tipos de relação com atributos (custo, descrição…). As relações simples permanecem em linha na planilha do card de origem.
  • Uma planilha _Meta com a versão do formato da pasta de trabalho.

Identificação sem GUIDs

Os cards são identificados pelo nome quando este é único dentro do tipo, e caso contrário pelo parent_path completo. Uma célula de relação pode conter NexaCore ERP diretamente se apenas uma Application tiver esse nome; em caso de ambiguidade, use Sales / Customer Mgmt / CRM.

Unicidade entre irmãos

Como os cards são identificados por nome + caminho, dois cards do mesmo tipo não podem partilhar simultaneamente o mesmo pai e o mesmo nome. Novos cards que provocariam uma colisão são rejeitados na criação (na caixa Criar card, no renomear em linha e durante a importação de Excel). Duplicados já presentes na base de dados — herdados de seeds ou imports anteriores — permanecem intactos: pode editar qualquer campo, mas criar um terceiro duplicado ou renomear um card de volta à colisão é bloqueado. A verificação é insensível a maiúsculas/minúsculas e espaços, igual ao resolvedor do importador.

Células de relação em linha

Cada coluna rel:<tipo_de_relação> expressa as relações de saída como uma lista separada por ponto e vírgula (por exemplo NexaCore ERP; BillingApp). Ponto e vírgula em vez de vírgula, porque os nomes de cards frequentemente contêm vírgulas (Acme, Inc.). Dentro de um nome, / e \ são escapados como \/ e \\ — o exportador faz isso automaticamente (ex.: SAP S/4HANASAP S\/4HANA). As células são declarativas: o seu conteúdo substitui o conjunto de relações de saída desse tipo a partir da origem. Remover um destino elimina a relação correspondente; esvaziar a célula elimina todas. Por compatibilidade, células separadas por vírgulas (formato antigo) continuam a ser aceites.

Células de partes interessadas

Em cada planilha de fichas, as colunas stakeholder:<chave_do_papel> carregam os utilizadores atribuídos a cada papel de parte interessada, como endereços de email separados por ponto e vírgula (a mesma convenção das colunas subscriptions:<RoleType> do LeanIX), por ex. [email protected]; [email protected]. O endereço de email é a única referência de utilizador aceite — os nomes podem colidir e nunca são usados na resolução; uma entrada Nome <email> é tolerada (usa-se o email entre parênteses angulares), um nome sozinho produz um aviso e é ignorado. Como as células de relação, as células de partes interessadas são declarativas por papel: os utilizadores listados tornam-se o conjunto completo de atribuições desse papel após a importação. Remover um utilizador retira a atribuição; esvaziar a célula limpa o papel; omitir a coluna deixa as atribuições intactas. Entradas sem utilizador correspondente produzem um aviso e são ignoradas — nunca bloqueiam a importação.

Planilha Relations

Para relações com atributos, use a planilha dedicada com as colunas relation_type, source_ref, target_ref, action (por defeito upsert, alternativamente delete), attr_<campo> e description.

Importar

Clique em Importar na barra de ferramentas, solte a pasta de trabalho e verifique a pré-visualização antes de aplicar. Verá tanto os cards a criar / atualizar como as relações a adicionar / remover. Os erros (por exemplo, um destino ambíguo com os seus caminhos candidatos) bloqueiam a aplicação.

Algumas notas sobre a importação:

  • Apenas name e type são obrigatórios para criar um card. Os campos marcados como obrigatórios no metamodelo (incluindo Provider ou qualquer outro tipo) não bloqueiam a importação — o card é criado na mesma, e as lacunas refletem-se na sua pontuação de qualidade de dados em vez de causarem um salto silencioso.
  • Uma / na coluna name de um card não precisa de ser escapada. O escape (\/ para uma barra, \\ para uma barra invertida) só é necessário quando referencia esse card a partir de uma célula parent_path, rel:<chave>, source_ref ou target_ref, onde / é o separador de caminho.

Exportar

Clique em Exportar. O filtro atual determina o conteúdo: com um filtro de tipo único, uma planilha para esse tipo; sem filtro, uma planilha por tipo presente. Em todos os casos a pasta de trabalho inclui Relations e _Meta e pode ser reimportada sem perder atributos específicos do tipo.

Você também pode escolher Exportar vista atual no menu Exportar — um instantâneo plano de uma única planilha que espelha o que está na tela (apenas as colunas visíveis, na ordem atual, para as linhas filtradas). Destina-se a compartilhamento e não é adequado para reimportação. Se as colunas de relações ainda estiverem a carregar, a exportação aguarda por elas, pelo que nunca podem sair vazias.