Come costruire un take-home dal repository della tua azienda
Ritaglia una piccola porzione eseguibile della tua codebase reale, rimuovi segreti e cronologia, falla partire con un unico file di configurazione e dimensiona il compito sul limite di tempo.
Per costruire un take-home dal repository della tua azienda, copia una piccola porzione della codebase reale in un repository separato, rimuovi segreti, cronologia e tutto ciò che è riservato, e assicurati che si installi e parta con un solo comando. Poi scrivi un solo compito che stia in circa metà del limite di tempo, con test che mostrino al candidato cosa significa "fatto".
Perché usare proprio il tuo codice?
Un compito nella tua codebase ti mostra come un candidato gestisce il codice su cui lavorerebbe davvero: le tue convenzioni, i tuoi framework, il tuo tipo di disordine. Mostra inoltre al candidato com'è il lavoro, il che aiuta le persone valide a dire di sì e permette a chi non è adatto di ritirarsi presto.
Il costo è la preparazione. Una porzione di un sistema reale deve girare da sola, senza la tua VPN, il database di staging o il registry interno dei pacchetti. Metti in conto qualche ora per il primo. Ogni compito successivo costruito sulla stessa porzione costa molto meno.
Scegli la porzione giusta
Non consegnare l'intero repository. Scegli il pezzo più piccolo che sia ancora realistico.
- Un servizio, non la piattaforma. Una singola API con i propri test è l'ideale. Se chiama tre servizi interni, sostituiscili con poche righe che restituiscono dati fissi.
- Codice che le persone toccano davvero. Il modulo di fatturazione che riceve una modifica a ogni sprint è una scelta migliore di uno strato di framework che nessuno modifica.
- Abbastanza contesto da esplorare. Qualche migliaio di righe va bene. I candidati dovrebbero riuscire a orientarsi in dieci minuti.
- Un punto d'innesto reale per il compito. Cerca un posto in cui una correzione di bug o una piccola feature si inseriscano in modo naturale, come una validazione mancante, un endpoint senza paginazione o una query lenta.
Usa una cartella di un monorepo
Se il tuo codice vive in un monorepo, spesso non devi estrarre nulla: punta il take-home alla cartella che contiene il servizio. Controlla che non importi pacchetti condivisi da altre parti del repository, oppure copia nella cartella i pochi di cui ha bisogno.
Rimuovi segreti, cronologia e tutto ciò che è riservato
Tratta la porzione come un rilascio open source. I candidati leggeranno ogni file.
- Parti da un repository nuovo. Copia i file, non fare un fork. La cronologia Git può contenere vecchie chiavi, nomi interni e commenti che preferiresti non condividere.
- Rimuovi i segreti. Elimina i file
.enve sostituiscili con un.env.examplecon valori fittizi. Cerca chiavi API, token, nomi host interni e stringhe di connessione. - Rimuovi i dati dei clienti. Fixture e file di seed spesso contengono copie di record reali. Sostituiscili con dati inventati.
- Controlla commenti e documentazione. I TODO che nominano clienti, i link a wiki interne e i riferimenti a incidenti devono sparire.
- Attenzione alle licenze. Il codice di terze parti con licenze restrittive potrebbe non essere condivisibile, nemmeno in un colloquio.
Suggerimento. Chiedi a qualcuno che non ha costruito la porzione di clonarla su una macchina pulita. Tutto ciò su cui deve farti domande è qualcosa su cui un candidato si bloccherà.
Fa' in modo che giri senza di te
Il candidato non dovrebbe passare la prima mezz'ora a installare cose. Punta a un comando di installazione, uno di avvio e uno di test, e documentali nel README.
- Fissa le versioni di linguaggio e dipendenze con un lockfile.
- Sostituisci le chiamate ai servizi interni con piccoli finti locali.
- Se il servizio ha bisogno di un database, usane uno vero con un piccolo seed. Vedi Come costruire un take-home con un database reale.
- Esegui i test una volta. Se qualcuno è instabile, correggilo o eliminalo prima che lo veda un candidato.
Resta sotto il limite di tempo
L'errore più comune nei take-home è un compito che richiede il doppio del tempo dichiarato. I candidati che hanno un lavoro e una famiglia ne pagano il prezzo, e tu li perdi.
- Cronometrati su una copia pulita, poi assicurati che il compito stia in metà del limite.
- Un obiettivo chiaro. "Aggiungi la paginazione a
GET /orders, con test" basta per 90 minuti in una codebase sconosciuta. - Di' loro cosa non fare. "Non serve toccare la UI" evita ai candidati di tirare a indovinare l'ambito.
- Lascia spazio per una breve relazione su cosa farebbero dopo. Mostra giudizio e costa cinque minuti.
Come farlo in Kendor
Kendor importa un repository direttamente in una sfida e lo esegue in una sandbox. I candidati non clonano né installano nulla in locale. Vedi Importare da qualsiasi host Git.
Importa il repository
In una prova, incolla l'URL in URL del repository e scegli Verifica. Kendor mostra un'anteprima dell'importazione: il numero di file, le dimensioni, il linguaggio rilevato e se il repository contiene già un kendor.yaml. Poi imposta il Titolo, il Linguaggio e gli eventuali Database, e scegli Aggiungi sfida.
- Host: github.com, gitlab.com e bitbucket.org, oltre al tuo GitHub Enterprise Server, GitLab, Gitea o Forgejo.
- Limiti: fino a 50 MB e 5.000 file, senza nessun singolo file oltre 5 MB.
- Le cartelle delle dipendenze come
node_modules,vendore.venvvengono escluse. La sandbox installa da sola le dipendenze.
Repository privati
Un proprietario dell'organizzazione aggiunge un token di sola lettura per l'host in Integrazioni → Host di codice. I token sono salvati cifrati e Kendor ne mostra sempre e solo gli ultimi quattro caratteri. Usa un token limitato ai soli repository che importerai. Vedi Repository privati.
Una cartella di un monorepo
Incolla un link a un branch o a una cartella, per esempio github.com/acme/platform/tree/main/services/billing, e verrà importata solo quella parte. Vedi Cartelle di un monorepo.
Uno snapshot fisso
L'importazione è una copia dei file a quel commit, senza la cronologia Git. I push successivi al repository non modificano una prova già inviata, quindi ogni candidato riceve lo stesso codice. Vedi Snapshot e aggiornamenti.
Fallo girare con kendor.yaml
Un kendor.yaml nella radice del progetto dice a Kendor come installarlo, avviarlo e testarlo. Se il repository ne ha uno, Kendor lo usa. In caso contrario, Kendor rileva una configurazione dai file del progetto e aggiunge un kendor.yaml da rivedere nella Configurazione runtime dell'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: apiPer un progetto con più servizi, ciascuno ha la propria voce sotto services, con un workDir per la sua cartella. Vedi il riferimento di kendor.yaml e App multi-servizio.
Imposta il limite di tempo e verificalo
Nelle impostazioni della prova, scegli un Limite di tempo. 90 minuti è il valore predefinito; i preset vanno da 30 minuti a 4 ore, oppure puoi inserire una durata personalizzata. Poi scegli Anteprima come candidato, esegui i test dalla scheda Test e svolgi tu stesso il compito contro il tempo.
Nota. Ciò che compare nel terminale del candidato viene registrato per i revisori. È un motivo in più per assicurarti che la porzione non contenga credenziali reali: tutto ciò che viene stampato lì finisce nella registrazione.