Workspace do Repositório
O workspace do repositório em /repositories/:repositoryId é onde o usuário retoma o trabalho depois que o repositório é criado. Ele reúne o cabeçalho do repositório, o breadcrumb, o status, as abas do ciclo de vida, a atividade recente, as estatísticas, os processos, a documentação e o grafo.
Quando usar
- Para entender o estado atual de um repositório.
- Para navegar entre indexação, estatísticas, código-fonte, processos, documentação e grafo.
- Use a visão geral quando estiver em dúvida sobre qual é a próxima etapa.
- Use as abas bloqueadas como orientação do que ainda falta concluir.
Antes de começar
- Confirme a organização ativa.
- Abra o repositório correto em
/repositories. - Verifique se o código-fonte e a pré-análise já estão disponíveis.
Abas do workspace
| Aba | Para que serve |
|---|---|
| Visão geral | Resume o status do repositório, o checklist de primeiros passos e a próxima etapa recomendada. |
| Indexação | Conecta um repositório Git ou envia um ZIP, e reindexa quando o código muda. |
| Estatísticas | Distribuição por linguagem, estatísticas de arquivos, stack detectada e estimativas de custo do código indexado. |
| Código-fonte | Navega pelos arquivos indexados. |
| Processos | Lista, cria e gerencia processos (saídas de documentação e de backlog). |
| Documentação | Abre a documentação Markdown gerada. |
| Grafo | Explora as relações encontradas no código analisado. |
| Configurações | Gerencia as integrações do repositório, incluindo o Git CI. |
As abas Estatísticas e Código-fonte são desbloqueadas quando a análise termina. A Documentação é desbloqueada depois que um processo produz saída, e o Grafo é desbloqueado quando existe uma versão de origem ativa.
O Explorador de Custos não é uma aba do workspace do repositório. Ele fica disponível na área de Administração, onde você seleciona o repositório dentro da tela.
Visão geral do repositório
Abra a raiz do workspace (/repositories/:repositoryId) para revisar:
- Informações gerais do repositório e a organização ativa.
- Datas de criação e de atualização, e o tipo de armazenamento.
- Status atual e a jornada do repositório.
- O checklist de primeiros passos mostrando o que está concluído, em andamento ou pendente.
- A próxima ação recomendada.
- Processos recentes.
- Dados de pré-análise, estimativas de custo de LLM e recomendações de modelo quando disponíveis.
- Mensagens de erro quando há uma falha.
A visão geral é a melhor tela para retomar o trabalho porque consolida o estado atual e aponta a próxima ação recomendada.
Sequência de status do repositório
| Status | O que significa | Próxima etapa |
|---|---|---|
CREATED | O repositório foi criado. | Abra a Indexação e conecte ou envie o código-fonte. |
UPLOADED | O código-fonte foi fornecido. | Aguarde o processamento ou revise a pré-análise. |
PROCESSING | O código-fonte está sendo processado. | Aguarde a conclusão. |
PRE_ANALYZED | A pré-análise está disponível, mas ainda não confirmada. | Abra a Indexação, revise a pré-análise na caixa de diálogo de confirmação e confirme. |
READY | O repositório está pronto para novo trabalho. | Crie processos, leia a documentação ou explore o grafo. |
ERROR | Falha na criação, na validação ou no processamento. | Revise a etapa de Indexação ou tente novamente com um código corrigido. |
FAIL | Falha em uma etapa posterior do repositório. | Revise o status, forneça um código corrigido ou repita o fluxo afetado. |
Resultado esperado
O workspace deve deixar claro o status do repositório, mostrar quais áreas estão disponíveis e guiar o usuário até a próxima ação sem exigir a descoberta manual de rotas.