Radar de Tecnologias
O Radar de Tecnologias oferece uma visão geral visual de cada tecnologia usada em toda a sua arquitetura. As tecnologias são automaticamente categorizadas em quadrantes e classificadas por nível de adoção com base no uso real nos seus elementos e relacionamentos C4.
Conceitos Fundamentais
Tecnologias
Uma tecnologia representa qualquer ferramenta, linguagem, framework ou serviço usado na sua arquitetura. Cada tecnologia possui:
| Campo | Descrição |
|---|---|
| Nome | Nome de exibição (ex.: PostgreSQL, React, Kubernetes) |
| Categoria | Classificação que determina seu quadrante no radar |
| Descrição | Notas opcionais sobre uso ou propósito |
| Ícone | Logo opcional para identificação visual |
Quadrantes
As tecnologias são agrupadas em quatro quadrantes com base na sua categoria:
| Quadrante | Categorias |
|---|---|
| Linguagens | Linguagens de programação, runtimes |
| Frameworks | Frameworks, bibliotecas |
| Dados | Bancos de dados, message brokers, object storage |
| Infraestrutura | Serviços de nuvem, ferramentas DevOps, protocolos de transporte, outros |
Anéis de Adoção
Cada tecnologia é posicionada em um anel com base na amplitude de uso na sua arquitetura:
| Anel | Critério | Significado |
|---|---|---|
| Core | Usada em 4+ elementos/relacionamentos | Tecnologia fundamental, profundamente incorporada |
| Ativa | Usada em 2-3 elementos/relacionamentos | Ativamente adotada, uso crescente |
| Emergente | Usada em 1 elemento/relacionamento | Recentemente introduzida, sendo avaliada |
| Registrada | Ainda não vinculada a nenhum elemento | Catalogada mas não em uso ativo |
Visualizações
Visualização Radar
A visualização padrão. As tecnologias aparecem como pontos em um gráfico radar, posicionadas por quadrante e anel.
Interações:
- Passe o mouse sobre um ponto para ver o nome da tecnologia e destacar tecnologias relacionadas
- Clique em um ponto para abrir o painel de detalhes
- Clique no rótulo de um quadrante para filtrar por aquele quadrante
Visualização em Tabela
Uma lista estruturada de todas as tecnologias agrupadas por quadrante e anel. Cada entrada mostra o nome da tecnologia, ícone e uma barra de uso indicando a adoção relativa.
Visualização de Gerenciamento
A visualização de administração para criar, editar e excluir tecnologias.
Adicionando Tecnologias a Elementos
As tecnologias são vinculadas a elementos e relacionamentos C4, o que determina o posicionamento no radar.
A Partir do Painel do Elemento
- Selecione qualquer sistema, container ou componente no diagrama
- Abra o painel de detalhes do elemento
- Na seção Tecnologias, pesquise e selecione tecnologias
- As mudanças são salvas imediatamente
A Partir de Relacionamentos
- Clique em um relacionamento (aresta) entre dois elementos
- No painel do relacionamento, encontre Tecnologias
- Adicione tecnologias relevantes (ex.: o protocolo ou framework usado para comunicação)
Durante a Descoberta com IA
Quando você executa a descoberta com IA em um repositório, o Archyl detecta automaticamente tecnologias do seu código-fonte e as vincula aos elementos descobertos.
Gerenciando Tecnologias
Criando uma Tecnologia
- Navegue até Tecnologias > visualização Gerenciamento
- Clique em Adicionar tecnologia
- Preencha nome, categoria e descrição opcional
- Faça upload de uma imagem de logo se desejar
- Clique em Criar
Editando uma Tecnologia
- Na visualização Gerenciamento, encontre a tecnologia na lista
- Clique no botão Editar (ícone de lápis)
- Modifique nome, categoria, descrição ou logo
- Clique em Salvar alterações
Excluindo uma Tecnologia
- Na visualização Gerenciamento, clique no botão Excluir (ícone de lixeira) na linha da tecnologia
- Confirme a exclusão
Excluir uma tecnologia a remove de todos os elementos e relacionamentos vinculados.
Painel de Detalhes
Clique em qualquer tecnologia na visualização radar ou tabela para abrir o painel de detalhes. Ele mostra:
Estatísticas de Uso
- Elementos: Quantos elementos C4 usam esta tecnologia
- Relacionamentos: Quantos relacionamentos a referenciam
- Nível de adoção: Uma barra percentual relativa à sua tecnologia mais usada
Tecnologias Associadas
Tecnologias que frequentemente aparecem junto com a selecionada. Isso revela combinações naturais na sua stack — por exemplo, se React e TypeScript frequentemente aparecem juntos.
Elementos Relacionados
Uma lista de todos os sistemas, containers ou componentes que usam esta tecnologia. Clique em qualquer elemento para navegar diretamente até ele no diagrama.
Pesquisando Tecnologias
Na Página do Radar
Use o campo de pesquisa na barra de cabeçalho para filtrar tecnologias por nome ou categoria. Combine com filtros de quadrante e anel para refinar ainda mais os resultados.
Na Pesquisa Global
Pressione Cmd+K (ou Ctrl+K) para abrir a pesquisa global. Digite o nome de uma tecnologia — tecnologias correspondentes aparecem com um badge Tecnologia.
Filtragem
Filtro por Quadrante
Clique no dropdown de quadrante para mostrar apenas tecnologias de um quadrante específico (Linguagens, Frameworks, Dados ou Infraestrutura).
Filtro por Anel
Clique em qualquer pílula de anel (Core, Ativa, Emergente, Registrada) para filtrar por nível de adoção.
Filtros Combinados
Todos os filtros funcionam juntos. Por exemplo, filtre por quadrante "Frameworks" + anel "Core" para ver suas dependências de framework mais críticas.
Boas Práticas
Mantenha o Catálogo Atualizado
- Adicione tecnologias conforme as adota
- Remova tecnologias descontinuadas
- Atualize categorias se o papel de uma ferramenta mudar
Vincule Tecnologias Consistentemente
- Aplique tecnologias no nível C4 correto — linguagens e frameworks em containers/componentes, infraestrutura em sistemas
- Marque relacionamentos com o protocolo ou transporte usado (ex.: gRPC, REST, AMQP)
- Seja específico — prefira "PostgreSQL" a "Banco de Dados SQL"
Use o Radar para Governança
- Revise o radar durante reuniões de revisão de arquitetura
- Tecnologias no anel Emergente são candidatas para avaliação da equipe
- Tecnologias no anel Registrada sem uso podem ser candidatas para remoção
- Um radar saudável tem a maioria das tecnologias em Core ou Ativa
Aproveite as Tecnologias Associadas
- Use os dados "associado com" para entender agrupamentos tecnológicos
- Identifique combinações inesperadas que podem indicar inconsistência
- Identifique oportunidades de padronização quando tecnologias similares servem o mesmo propósito
Próximos Passos
- Descoberta com IA — Detecte tecnologias automaticamente a partir do código
- Insights de Arquitetura — Receba recomendações sobre sua arquitetura
- Elementos e Estilização — Aprenda sobre elementos C4