Uso Avançado
Use estas práticas depois que o fluxo básico de repositório e task já estiver funcionando.
Retome pela visão geral
A visão geral em /repositories/:repositoryId/overview é o melhor ponto para entender o que falta fazer. Ela pode mostrar informações gerais, organização, datas, tipo de armazenamento, status atual, próxima ação recomendada, jornada do repositório, tasks recentes, pré-análise, estimativas de custo, resumo de medição de uso e mensagens de erro quando houver falha.
Quando houver dúvida sobre o próximo passo, comece pela visão geral e siga a ação recomendada.
Use o command palette
Abra o command palette pelos controles do app ou pelo atalho configurado para navegar rapidamente entre telas de repositório, conhecimento e administração. As ações disponíveis dependem do repositório atual, das features habilitadas e das permissões da conta.
Tutorial contextual
Inicie um tutorial contextual pelo command palette quando precisar de orientação na tela atual.
Grafo global
Abra o grafo global para usar recursos de grafo fora do workspace de um repositório. O usuário pode selecionar um repositório existente com código-fonte disponível ou enviar um .zip para gerar um grafo.
Medição de uso
A medição de uso fica disponível pela área de administração quando o acompanhamento de uso está habilitado. Ela não faz parte das abas do workspace do repositório.
Quando habilitada, a medição de uso pode mostrar resumo, histórico e eventos recentes.
Se a feature estiver desligada, o app redireciona o usuário para uma tela segura, como a lista de repositórios ou a visão geral.
Chaves de API
A tela /modernization/api-keys apoia integrações programáticas. Usuários podem listar chaves, criar uma nova chave, copiá-la no momento da criação, revogar, excluir e atualizar a lista.
Copie a chave quando ela aparecer. Credenciais desse tipo normalmente não são exibidas novamente depois da criação.
Configurações e modelos
Abra /settings para ajustar modelos e comportamento do app. Chat e criação de tasks podem depender dos modelos disponíveis para a organização.
Boas práticas
- Confirme a organização ativa antes de criar ou procurar repositórios.
- Siga a sequência recomendada pelo status do repositório.
- Revise a pré-análise antes de criar tasks.
- Use a visão geral para retomar contexto depois de interrupções.
- Use logs da task antes de reiniciar trabalhos com falha.
- Use filtros quando houver muitas tasks ou documentos.
- Baixe resultados concluídos quando os artefatos precisarem circular fora da aplicação.
Componentes da experiência
| Componente | Papel |
|---|---|
| Header | Identidade do app, usuário e ações globais. |
| Menu lateral | Navegação principal por áreas. |
| Command palette | Busca e execução rápida de ações globais ou específicas do repositório. |
| Breadcrumb | Localização dentro do fluxo do repositório. |
| Abas do workspace | Navegação entre visão geral, código, tasks, documentação e grafo. |
| Logs de task | Mostram detalhes recentes da execução. |
| Viewer de documentação | Lista páginas e renderiza Markdown/diagramas sob demanda. |
| Grafo | Mostra relações do código, referências e arquivos relacionados. |
| Medição de uso | Resumo, detalhes e histórico de uso. |
| Dialogs | Confirmações para ações destrutivas. |