Saltar al contenido
KendorDocs

Cómo crear una prueba para hacer en casa a partir del repositorio de tu empresa

Recorta una porción pequeña y ejecutable de tu código real, elimina secretos e historial, haz que arranque con un único archivo de configuración y dimensiona la tarea según el límite de tiempo.

Para crear una prueba para hacer en casa a partir del repositorio de tu empresa, copia una porción pequeña del código real en un repositorio aparte, elimina los secretos, el historial y todo lo confidencial, y asegúrate de que se instala y arranca con un solo comando. Después escribe una tarea que quepa en aproximadamente la mitad del límite de tiempo, con tests que muestren al candidato qué significa "terminado".

¿Por qué usar tu propio código?

Una tarea en tu propio código te muestra cómo maneja un candidato el código con el que trabajaría de verdad: tus convenciones, tus frameworks, tu tipo de desorden. También le muestra al candidato cómo es el puesto, lo que ayuda a que las buenas personas digan que sí y a que quienes no encajan se descarten pronto.

El coste es la preparación. Una porción de un sistema real tiene que ejecutarse por sí sola, sin tu VPN, tu base de datos de staging ni tu registro interno de paquetes. Calcula unas cuantas horas para la primera. Cada tarea posterior construida sobre la misma porción es mucho más barata.

Elige la porción adecuada

No entregues el repositorio entero. Elige la pieza más pequeña que siga pareciendo real.

  • Un servicio, no la plataforma. Una única API con sus propios tests es lo ideal. Si llama a tres servicios internos, simúlalos con unas pocas líneas que devuelvan datos fijos.
  • Código que la gente toca de verdad. El módulo de facturación que recibe un cambio en cada sprint es mejor opción que una capa de framework que nadie edita.
  • Suficiente contexto para explorar. Unos pocos miles de líneas está bien. Los candidatos deberían poder orientarse en diez minutos.
  • Un punto de apoyo real para la tarea. Busca un lugar donde encajen de forma natural la corrección de un bug o una pequeña funcionalidad, como una validación que falta, un endpoint sin paginación o una consulta lenta.

Usa una carpeta de un monorepo

Si tu código vive en un monorepo, a menudo no necesitas extraer nada: apunta la prueba a la carpeta que contiene el servicio. Comprueba que no importa paquetes compartidos de otra parte del repositorio, o incorpora a esa carpeta los pocos que necesite.

Elimina secretos, historial y todo lo confidencial

Trata la porción como una publicación de código abierto. Los candidatos leerán todos los archivos.

  • Empieza un repositorio nuevo. Copia los archivos, no hagas un fork. El historial de Git puede contener claves antiguas, nombres internos y comentarios que preferirías no compartir.
  • Elimina los secretos. Borra los archivos .env y sustitúyelos por un .env.example con valores ficticios. Busca claves de API, tokens, nombres de host internos y cadenas de conexión.
  • Elimina los datos de clientes. Los fixtures y los archivos de seed suelen contener copias de registros reales. Sustitúyelos por datos inventados.
  • Revisa los comentarios y la documentación. Los TODO que nombran clientes, los enlaces a wikis internas y las referencias a incidentes se van.
  • Atiende a las licencias. Puede que el código de terceros con licencias restrictivas no se pueda compartir, ni siquiera en una entrevista.

Consejo. Pide a alguien que no creó la porción que la clone en una máquina limpia. Todo lo que tenga que preguntar es algo en lo que un candidato se quedará atascado.

Haz que funcione sin ti

El candidato no debería pasar la primera media hora instalando cosas. Apunta a un comando de instalación, un comando de inicio y un comando de tests, y documéntalos en el README.

  • Fija las versiones del lenguaje y de las dependencias con un lockfile.
  • Sustituye las llamadas a servicios internos por pequeñas simulaciones locales.
  • Si el servicio necesita una base de datos, usa una real con un seed pequeño. Consulta Cómo crear una prueba para hacer en casa con una base de datos real.
  • Ejecuta los tests una vez. Si alguno es inestable, arréglalo o bórralo antes de que lo vea un candidato.

Mantén la tarea dentro del límite de tiempo

El error más común en las pruebas para hacer en casa es una tarea que lleva el doble de lo anunciado. Los candidatos que tienen trabajo y familia lo pagan, y los pierdes.

  • Cronométrate en una copia limpia y asegúrate de que la tarea cabe en la mitad del límite.
  • Un objetivo claro. "Añade paginación a GET /orders, con tests" basta para 90 minutos en un código desconocido.
  • Diles lo que no deben hacer. "No hace falta tocar la interfaz" evita que los candidatos tengan que adivinar el alcance.
  • Deja espacio para un breve resumen de lo que harían a continuación. Muestra criterio y cuesta cinco minutos.

Cómo hacerlo en Kendor

Kendor importa un repositorio directamente a un reto y lo ejecuta en un sandbox. Los candidatos no clonan ni instalan nada en local. Consulta Importar desde cualquier servicio de Git.

Importa el repositorio

En una prueba, pega la URL en URL del repositorio y elige Comprobar. Kendor muestra una vista previa de la importación: el número de archivos, el tamaño, el lenguaje detectado y si el repositorio ya tiene un kendor.yaml. Después define el Título, el Lenguaje y las Bases de datos, y elige Añadir reto.

  • Servicios: github.com, gitlab.com y bitbucket.org, además de tu propio GitHub Enterprise Server, GitLab, Gitea o Forgejo.
  • Límites: hasta 50 MB y 5.000 archivos, sin ningún archivo individual de más de 5 MB.
  • Las carpetas de dependencias como node_modules, vendor y .venv se dejan fuera. El sandbox instala las dependencias por sí mismo.

Repositorios privados

Un propietario de la organización añade un token de solo lectura del servicio en Integraciones → Servicios de código. Los tokens se guardan cifrados y Kendor solo muestra sus últimos cuatro caracteres. Usa un token limitado únicamente a los repositorios que vayas a importar. Consulta Repositorios privados.

Una carpeta de un monorepo

Pega un enlace a una rama o carpeta, por ejemplo github.com/acme/platform/tree/main/services/billing, y solo se importa esa parte. Consulta Carpetas de monorepo.

Una instantánea fija

La importación es una copia de los archivos en ese commit, sin el historial de Git. Los pushes posteriores al repositorio no cambian una prueba que ya está en circulación, así que todos los candidatos reciben el mismo código. Consulta Instantáneas y actualizaciones.

Haz que se ejecute con kendor.yaml

Un kendor.yaml en la raíz del proyecto le indica a Kendor cómo instalarlo, iniciarlo y probarlo. Si el repositorio tiene uno, Kendor lo usa. Si no, Kendor detecta una configuración a partir de los archivos del proyecto y añade un kendor.yaml para que lo revises en la Configuración de ejecución del editor.

kendor.yaml
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: api

Para un proyecto con varios servicios, cada uno tiene su propia entrada en services, con un workDir para su carpeta. Consulta la referencia de kendor.yaml y Aplicaciones con varios servicios.

Fija el límite de tiempo y compruébalo

En los ajustes de la prueba, elige un Límite de tiempo. 90 minutos es el valor por defecto; los preajustes van de 30 minutos a 4 horas, o puedes introducir una duración personalizada. Después elige Vista previa como candidato, ejecuta los tests desde la pestaña Tests y haz tú mismo la tarea contra el reloj.

Nota. Lo que aparece en la terminal del candidato se graba para los revisores. Es un motivo más para asegurarte de que la porción no contiene credenciales reales: todo lo que se imprima allí acaba en la grabación.

¿Te ha resultado útil este artículo?