Como construir um take-home a partir do repositório da tua empresa
Corta uma fatia pequena e executável do teu código real, remove segredos e histórico, faz com que arranque com um único ficheiro de configuração e dimensiona a tarefa para o limite de tempo.
Para construir um take-home a partir do repositório da tua empresa, copia uma fatia pequena do código real para um repositório separado, remove segredos, histórico e tudo o que for confidencial, e garante que instala e arranca com um único comando. Depois escreve uma tarefa que caiba em cerca de metade do limite de tempo, com testes que mostrem ao candidato o que significa «concluído».
Porquê usar o teu próprio código?
Uma tarefa no teu próprio código mostra-te como um candidato lida com o código em que realmente trabalharia: as tuas convenções, as tuas frameworks, o teu tipo de desarrumação. Também mostra ao candidato como é o trabalho, o que ajuda as boas pessoas a dizer que sim e deixa as que não encaixam desistir cedo.
O custo é a preparação. Uma fatia de um sistema real tem de correr sozinha, sem a tua VPN, a base de dados de staging ou o registo de pacotes interno. Planeia algumas horas para a primeira. Todas as tarefas seguintes construídas sobre a mesma fatia são muito mais baratas.
Escolhe a fatia certa
Não entregues o repositório inteiro. Escolhe o menor pedaço que ainda pareça real.
- Um serviço, não a plataforma. Uma única API com os seus próprios testes é o ideal. Se chamar três serviços internos, substitui-os por algumas linhas que devolvam dados fixos.
- Código em que as pessoas realmente mexem. O módulo de faturação que recebe uma alteração a cada sprint é melhor escolha do que uma camada de framework que ninguém edita.
- Contexto suficiente para explorar. Alguns milhares de linhas servem. Os candidatos devem conseguir orientar-se em dez minutos.
- Uma costura real para a tarefa. Procura um sítio onde uma correção de bug ou uma pequena funcionalidade encaixe naturalmente, como uma validação em falta, um endpoint sem paginação ou uma query lenta.
Usa uma pasta de um monorepo
Se o teu código vive num monorepo, muitas vezes não precisas de extrair nada: aponta o take-home para a pasta que contém o serviço. Verifica que não importa pacotes partilhados de outras partes do repositório, ou inclui na pasta os poucos de que precisa.
Remove segredos, histórico e tudo o que for confidencial
Trata a fatia como uma publicação open source. Os candidatos vão ler todos os ficheiros.
- Começa um repositório novo. Copia os ficheiros, não faças fork. O histórico do Git pode guardar chaves antigas, nomes internos e comentários que preferias não partilhar.
- Remove os segredos. Apaga os ficheiros
.enve substitui-os por um.env.examplecom valores fictícios. Procura chaves de API, tokens, nomes de host internos e cadeias de ligação. - Remove dados de clientes. Fixtures e ficheiros de seed muitas vezes guardam cópias de registos reais. Substitui-os por dados inventados.
- Verifica comentários e documentação. TODOs que nomeiam clientes, links para wikis internas e referências a incidentes têm de sair.
- Atenção às licenças. Código de terceiros com licenças restritivas pode não poder ser partilhado, mesmo numa entrevista.
Dica. Pede a alguém que não construiu a fatia que a clone numa máquina limpa. Tudo o que tiver de perguntar é algo em que um candidato vai ficar preso.
Faz com que corra sem ti
O candidato não deve gastar a primeira meia hora a instalar coisas. Aponta para um comando de instalação, um comando de arranque e um comando de testes, e documenta-os no README.
- Fixa as versões da linguagem e das dependências com um lockfile.
- Substitui as chamadas a serviços internos por pequenas simulações locais.
- Se o serviço precisa de uma base de dados, usa uma real com um seed pequeno. Vê Como construir um take-home com uma base de dados real.
- Corre os testes uma vez. Se algum for instável, corrige-o ou apaga-o antes de um candidato o ver.
Mantém a tarefa abaixo do limite de tempo
O erro mais comum nos take-homes é uma tarefa que demora o dobro do anunciado. Os candidatos que têm emprego e família pagam por isso, e tu perdes-os.
- Cronometra-te numa cópia limpa e depois garante que a tarefa cabe em metade do limite.
- Um objetivo claro. «Adiciona paginação a
GET /orders, com testes» chega para 90 minutos num código desconhecido. - Diz-lhes o que não fazer. «Não é preciso mexer na UI» poupa os candidatos a adivinhar o âmbito.
- Deixa espaço para um breve resumo do que fariam a seguir. Mostra discernimento e custa cinco minutos.
Fazê-lo no Kendor
O Kendor importa um repositório diretamente para um desafio e corre-o numa sandbox. Os candidatos não clonam nem instalam nada localmente. Vê Importar de qualquer host de Git.
Importa o repositório
Numa triagem, cola o URL 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, a linguagem detetada e se o repositório já tem um kendor.yaml. Depois define o Título, a Linguagem e os Bancos de dados e escolhe Adicionar desafio.
- Hosts: github.com, gitlab.com e bitbucket.org, além do teu próprio GitHub Enterprise Server, GitLab, Gitea ou Forgejo.
- Limites: até 50 MB e 5000 ficheiros, sem nenhum ficheiro individual acima de 5 MB.
- As pastas de dependências, como
node_modules,vendore.venv, ficam de fora. A sandbox instala as dependências por si.
Repositórios privados
Um responsável da organização adiciona um token só de leitura para o host em Integrações → Hosts de código. Os tokens são guardados encriptados e o Kendor só mostra os últimos quatro carateres. Usa um token limitado apenas aos repositórios que vais importar. Vê Repositórios privados.
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. Vê Pastas de monorepo.
Um snapshot fixo
A importação é uma cópia dos ficheiros nesse commit, sem o histórico do Git. Pushes posteriores ao repositório não alteram uma triagem que já foi enviada, por isso todos os candidatos recebem o mesmo código. Vê Snapshots e atualizações.
Faz com que corra com o kendor.yaml
Um kendor.yaml na raiz do projeto diz ao Kendor como o instalar, iniciar e testar. Se o repositório tiver um, o Kendor usa-o. Se não, o Kendor deteta uma configuração a partir dos ficheiros do projeto e acrescenta um kendor.yaml para reveres na Configuração de runtime do editor.
version: 1
runtime:
type: node
version: "22"
databases:
- type: postgres
version: "18"
init: db/seed.sql
install:
commands:
- npm ci
services:
api:
dev:
command: npm run dev
port: 3000
test:
command: node --test
preview:
service: apiPara um projeto com vários serviços, cada um tem a sua própria entrada em services, com um workDir para a respetiva pasta. Vê a referência do kendor.yaml e Aplicações com vários serviços.
Define o limite de tempo e verifica-o
Nas definições da triagem, escolhe um Limite de tempo. 90 minutos é o valor por omissão; as predefinições vão de 30 minutos a 4 horas, ou podes introduzir uma duração personalizada. Depois escolhe Pré-visualizar como candidato, corre os testes a partir do separador Testes e faz a tarefa tu próprio contra o relógio.
Nota. O que aparece no terminal do candidato é gravado para os revisores. É mais um motivo para garantires que a fatia não tem credenciais reais: tudo o que for impresso ali acaba na gravação.