Saltar para o conteúdo
KendorDocs

Envia a tua primeira triagem de código

Para responsáveis e editores ·

Cria uma triagem de código a partir do teu próprio repositório, confirma que corre e convida um candidato. Cerca de 15 minutos.

Antes de começares

  • Uma organização do Kendor. O acesso é por pedido: pede através do formulário de contacto e recebes um link para a configurar.
  • A função de Responsável ou de Editor. Os observadores podem ler triagens, mas não as podem criar.
  • Um repositório onde o candidato trabalhe, em qualquer host de Git. Ainda não tens repositório? Começa antes com um projeto em branco (passo 2).

Criar uma triagem

Abre Triagens na barra lateral e escolhe Nova triagem. Dá-lhe o nome que os candidatos vão ver, como Rate limiter, no campo Dê um nome a esta triagem.

Nas definições à direita, escolhe um Limite de tempo. 90 minutos é o valor por omissão e serve para a maioria das tarefas de backend; também podes escolher entre 30 minutos e 4 horas, ou uma duração personalizada. Depois de o rascunho existir, as alterações são guardadas à medida que trabalhas.

Adicionar um desafio a partir do teu repositório

Cola o URL do repositório em URL do repositório e escolhe Verificar. O Kendor mostra uma pré-visualização da importação: o número de ficheiros, o tamanho e se o repositório já tem um kendor.yaml.

  • Hosts: github.com, gitlab.com e bitbucket.org, além do teu próprio GitHub Enterprise Server, GitLab, Gitea ou Forgejo.
  • Repositórios privados: um responsável da organização adiciona primeiro um token só de leitura em Integrações → Hosts de código. Os tokens são guardados encriptados e o Kendor só mostra os últimos quatro carateres.
  • Uma pasta de um monorepo: cola um link para um branch ou uma pasta (por exemplo github.com/acme/platform/tree/main/services/billing) e só essa parte é importada.

Define o Título, a Linguagem e os Bancos de dados de que o projeto precisa e escolhe Adicionar desafio. A importação é uma cópia desse commit: pushes posteriores ao repositório não alteram uma triagem que já foi enviada.

Sem repositório? Em Ou adicionar:, escolhe Projeto em branco para começar a partir de um dos modelos do Kendor, ou Ficheiro único para uma pergunta ao estilo de algoritmos.

Verificar como corre

Um kendor.yaml na raiz do projeto diz ao Kendor como o instalar, iniciar e testar. Quando o repositório não tem um, o editor abre Configuração de runtime por ti. Preenche o formulário, ou muda para YAML em bruto, e guarda: o Kendor escreve o kendor.yaml e reinicia a sandbox com ele.

Um projeto pequeno com uma base de dados PostgreSQL tem este aspeto:

kendor.yaml
version: 1
runtime:
  type: python
  version: "3.12"
databases:
  - type: postgres
    version: "18"
    init: db/schema.sql
install:
  commands:
    - pip install --user -r requirements.txt
services:
  app:
    dev:
      command: uvicorn main:app --host $HOST --port $PORT --reload
      port: 8000
    test:
      command: pytest --tap-stream
preview:
  service: app

O Kendor inicia a base de dados dentro da sandbox e passa a respetiva cadeia de ligação à tua aplicação como DATABASE_URL. Escolhe Pré-visualizar como candidato para ver a aplicação a correr exatamente como um candidato a vai ver.

Garantir que os testes correm

Os candidatos correm eles próprios os testes do projeto, a partir do separador Testes no editor ou do terminal, as vezes que quiserem. Os testes são ficheiros normais do projeto, por isso os candidatos também os podem ler.

O separador Testes corre o comando test do kendor.yaml. Para teres uma linha por teste em vez de um único aprovado ou reprovado, faz o comando imprimir TAP: pytest --tap-stream (o Python do Kendor inclui o pytest-tap) ou o node --test incorporado do Node fazem ambos isso. Corre a suite uma vez na pré-visualização para a confirmares.

Lançar a triagem

De volta às definições da triagem, adiciona Revisores predefinidos e confirma a Expiração do convite (7 dias, a menos que a alteres). Para deixares os candidatos usar agentes de programação com IA no terminal, ativa Assistentes de IA no terminal. Com as chaves de API da tua própria organização, têm o Claude Code e o Codex; com a conta deles, podem também correr o Antigravity, o GitHub Copilot, o Cline, o OpenCode ou o Cursor.

A Lista de lançamento mostra o que falta. Uma triagem precisa de um título, de pelo menos um desafio e de uma configuração de runtime válida. Escolhe Lançar e a triagem fica Disponível.

Convidar um candidato

Abre Candidatos e escolhe Convidar candidato. Introduz um ou mais emails, escolhe a triagem (só aparecem as triagens disponíveis) e escolhe Enviar convite.

Cada candidato recebe por email o seu próprio link. Não precisam de conta: introduzem o nome e o temporizador arranca quando escolhem Começar triagem. Se preferires enviar tu o link, usa Copiar link de convite na linha do candidato.

Dica. Envia o primeiro convite a ti próprio para veres exatamente o que os candidatos veem.

Rever a submissão

Quando o candidato submete, abre-o em Candidatos e escolhe Abrir revisão. Vais encontrar o código e o respetivo diff em Solução, além dos separadores Cronologia, Terminal, Agentes de IA e Atividade.

Cada revisor regista uma recomendação, de Sim convicto a Não convicto, com uma nota opcional. Depois alguém toma a decisão: Avançar ou Rejeitar. Nenhuma das duas envia email ao candidato, por isso és tu quem decide quando e como ele recebe resposta. Marcar como aprovado e Marcar como não aprovado são diferentes: enviam logo ao candidato o resultado por email. Vê Rever uma submissão.

Este artigo foi útil?