Pular para o conteúdo principal

Visão Geral do Smart Engineering

O Smart Engineering apoia a jornada de modernização de código. Você cadastra um repositório, indexa o código-fonte, revisa as estatísticas, executa processos que geram documentação e artefatos de backlog e usa os resultados para navegar por documentação, grafos técnicos, logs e métricas de uso.

Dois fluxos conduzidos por agentes se apoiam nessa base:

  • Chat Agêntico — um workspace de conversa em que um agente responde perguntas sobre um repositório, executa fluxos repetíveis e propõe alterações que você aprova ali mesmo. É a tela que a aplicação abre após o login.
  • Modernização de Código — um chat guiado que usa a documentação concluída para analisar a aplicação atual, preparar um plano de modernização e gerar os arquivos de uma nova aplicação.

O que você vê depende da organização ativa, do status do repositório, das opções de processo disponíveis e das permissões atribuídas à sua conta.

Quando usar​

  • Documentar sistemas existentes a partir do código-fonte.
  • Entender estrutura, dependências, linguagens e volume de código.
  • Gerar documentação técnica, diagramas e artefatos de backlog.
  • Investigar relações técnicas no grafo do repositório.
  • Perguntar a um agente sobre um repositório ou executar um fluxo padronizado sobre ele.
  • Recuperar conhecimento sobre um sistema legado ou pouco documentado.

Antes de começar​

  • Confirme a organização ativa.
  • Garanta que o repositório correto será criado ou selecionado.
  • Prepare o código-fonte em um arquivo .zip ou tenha acesso ao repositório Git.
  • Confirme que sua conta pode acessar o módulo e executar processos.

Acesso​

A aplicação usa o modelo de autenticação e permissão configurado para o ambiente. Quando o login é obrigatório, usuários não autenticados são redirecionados para a tela de login. Após o login, a aplicação valida a sessão ativa antes de exibir telas protegidas.

Se o acesso à sua organização ou ao módulo estiver ausente, contate o administrador do workspace ou o gerente do projeto antes de criar repositórios.

A barra lateral agrupa o módulo em seções:

O header expõe controles globais, o seletor de organização e o command palette. O command palette (buscar telas e ações) pode abrir itens de navegação, agêntico, personalizar, modernização, repositório atual e administração, conforme o contexto e as permissões.

Workspace do repositório​

O workspace do repositório fica disponível em /repositories/:repositoryId. Ele mostra um cabeçalho, breadcrumb, status atual e abas para o ciclo de vida do repositório:

  • Visão geral
  • Indexação
  • Estatísticas
  • Código-fonte
  • Processos
  • Documentação
  • Grafo
  • Configurações

Algumas abas ficam bloqueadas até existir código-fonte ou pré-análise. O Explorador de Custos fica na área de Administração, não é uma aba do workspace.

Passo a passo​

  1. Faça login e confirme a organização ativa.
  2. Crie ou abra um repositório.
  3. Abra Indexação e conecte um repositório Git ou envie um arquivo .zip.
  4. Aguarde o processamento e confirme a pré-análise; revise as Estatísticas.
  5. Crie um processo e selecione as saídas de que precisa.
  6. Acompanhe status, logs e ações disponíveis.
  7. Leia a documentação gerada.
  8. Inicie um projeto de Modernização de Código quando quiser planejar e gerar uma nova aplicação.
  9. Use o Chat Agêntico para fazer perguntas ou executar fluxos sobre o repositório.
  10. Explore o grafo, as referências e o inspetor de código para contexto técnico.
  11. Consulte o Explorador de Custos ou baixe o pacote de resultado quando necessário.

Resultado esperado​

Ao final do fluxo, o repositório deve ter código processado, estatísticas disponíveis, um ou mais processos executados, documentação gerada e referências de grafo. Os projetos de Modernização de Código mantêm o plano, os documentos e os arquivos gerados disponíveis para revisão ou download.

Veja também​