Envia a tua primeira triagem de código
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:
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: appversion: 1
runtime:
type: node
version: "22"
databases:
- type: postgres
version: "18"
init: db/schema.sql
install:
commands:
- npm ci
services:
app:
dev:
command: node --watch src/server.js
port: 3000
test:
command: node --test
preview:
service: appO 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.