Workspace do Repositório
O workspace em /repositories/:repositoryId é onde o usuário retoma o trabalho depois que um repositório foi criado. Ele reúne header, breadcrumb, status, abas do ciclo do repositório, atividades recentes, pré-análise, tasks, documentação e grafo.
Quando usar
- Use o workspace para entender o estado atual de um repositório.
- Use-o para alternar entre código-fonte, tasks, documentação e grafo.
- Use a visão geral quando não souber qual é o próximo passo.
- Use abas bloqueadas como indicação do que ainda precisa ser concluído.
Abas do workspace
| Aba | Para que serve |
|---|---|
| Visão geral | Resume status, falhas e próximo passo recomendado. |
| Código-fonte | Envia ou revisa o pacote de código-fonte. |
| Tasks | Lista, cria e gerencia tasks de documentação ou backlog. |
| Documentação | Abre a documentação Markdown gerada. |
| Grafo | Explora relações encontradas no código analisado. |
| Algumas abas podem permanecer bloqueadas até existir código-fonte ou pré-análise. |
A medição de uso não aparece como aba do workspace. Quando habilitada, fica disponível pela área de administração e permite selecionar o repositório dentro da tela de uso.
Visão geral
Abra /repositories/:repositoryId/overview para revisar:
- Informações gerais do repositório.
- Organização ativa.
- Datas de criação e atualização.
- Tipo de armazenamento.
- Status atual.
- Próxima ação recomendada.
- Jornada do repositório.
- Tasks recentes.
- Dados de pré-análise quando disponíveis.
- Estimativas de custo e recomendações de modelo quando disponíveis.
- Resumo de medição de uso quando habilitada.
- Mensagens de erro quando houver falha.
A visão geral é a melhor tela para retomar o trabalho porque consolida o estado atual e aponta a próxima ação.
Sequência de status do repositório
| Status | O que significa | Próximo passo |
|---|---|---|
CREATED | Repositório criado. | Enviar código-fonte. |
UPLOADED | Código-fonte enviado. | Aguardar processamento ou revisar pré-análise. |
PROCESSING | Código-fonte em processamento. | Aguardar conclusão. |
PRE_ANALYZED | Pré-análise disponível, mas ainda não confirmada. | Ir para Código-fonte, revisar a pré-análise no indexer e confirmar. |
READY | Repositório pronto para novo trabalho. | Criar tasks, ler documentação ou explorar o grafo. |
ERROR | Criação, validação ou processamento falhou. | Revisar a etapa de código-fonte ou tentar novamente com um pacote corrigido. |
FAIL | Uma etapa posterior do repositório falhou. | Revisar o status, enviar um pacote corrigido ou tentar novamente o fluxo afetado. |
Resultado esperado
O workspace deve deixar claro o status do repositório, mostrar quais áreas estão disponíveis e orientar o próximo passo sem exigir descoberta manual de rotas.