Top Coders LATAM
Ranking de desarrolladores de América Latina en GitHub. Datos públicos, score
transparente, sitio estático.
En vivo: https://top-coders-chi.vercel.app
Alcance actual: Argentina, Bolivia, Brasil, Chile, Colombia, México y Perú.
countries.json tiene 51 países definidos; el sitio sólo publica los que tienen
un data/<slug>.json, así que ampliar es correr el fetch de un slug nuevo.
Inspirado en top-coders-peru de
Joel Ibaceta, reescrito para funcionar en cualquier país y con vistas que el
original no tenía: perfil por dev, ranking por lenguaje y comparación entre países.
Cómo funciona
countries.json → scripts/fetch.mjs → data/<pais>.json → Astro → dist/
scripts/fetch.mjs busca perfiles con location: de cada país (REST search),
trae el detalle de cada uno en lotes por GraphQL y calcula el score.- El sitio se construye leyendo
data/*.json. Un país sin JSON no existe en el sitio.
- Un cron semanal regenera los datos y los commitea.
Uso
npm install
npm run data # refresca los países ya publicados
npm run data -- uruguay # agrega uno nuevo
npm run dev
Necesitas un token de GitHub en GITHUB_TOKEN. En local usa el de gh auth token
automáticamente.
Variables útiles: POOL (candidatos por país, default 200), KEEP (cuántos se
publican, default 100).
El score
Cuatro dimensiones normalizadas contra referencias fijas en escala logarítmica:
| Dimensión | Peso | Fuente |
|---|
| Impacto | 35% | estrellas de sus repos propios no-fork |
| Popularidad | 25% | seguidores |
| Actividad | 20% | commits del último año |
| Colaboración | 20% | pull requests mergeados |
score = Σ(peso × log10(1+valor) / log10(1+referencia)) × 100
Referencias: 50.000 estrellas, 20.000 seguidores, 4.000 commits, 1.000 PRs.
Fijas a propósito: si normalizas contra la muestra del día (como hace el proyecto
original), el score de una persona cambia según quién más esté en la lista, y no
se puede comparar entre países.
Agregar un país
Una entrada en countries.json y npm run data -- <slug>. El campo q son los
términos que se buscan en el location del perfil.
Soporte
Issues: https://github.com/harold18m/top-coders/issues · contacto: [email protected]
Ver SUPPORT.md, incluido cómo pedir que retiremos tu perfil.
Límites
Sólo mide actividad pública, y el país sale de un campo de texto libre. Ver
/metodo en el sitio.
MIT.
