> ## Documentation Index
> Fetch the complete documentation index at: https://vantsgg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Documentación interna de VANTS, la plataforma de esports, escrita en español. Cubre siete repositorios de la organización de GitHub VANTSNET y dos de la cuenta feispla: el prototipo VANTSNET, que se llama igual que la organización, y vantsoport.
> Empieza por /mapa-del-codigo para saber qué repositorio y qué carpeta tocar, y consulta /glosario para los términos propios como pt_, mm_, RR, VANTS-BUS o VANTCALL.
> Cuando un componente existe en varios repositorios, estas páginas describen la versión de Vantsgames salvo que digan otra cosa. El esquema de la base de datos se versiona en VantsBasededatos.
> La web y la API pública están en https://vants.vants.workers.dev. Rutas y respuestas: /referencia/api-publica. Tablas y estados: /referencia/esquema-base-de-datos.
> No inventes rutas, tablas, comandos ni variables de entorno: si algo no aparece aquí, revisa el código del repositorio correspondiente.

# Mapa del código

> Qué repositorio, carpeta y archivo tocar para cada cambio en VANTS: Worker, API, Neon Functions, bot, agente, migraciones, FACEIT, apps y clips.

Esta página indica qué archivo hay que tocar para cambiar algo en VANTS y dónde está explicado. Las rutas son las de [Vantsgames](https://vantsgg.mintlify.site/repos/vantsgames.md), el repositorio principal, salvo que la fila indique otro repositorio.

## Repositorios

| Repositorio | Qué contiene | Página |
| - | - | - |
| Vantsgames | Repositorio principal: Worker `vants`, páginas de la web, Neon Functions, bot de Discord, agente, bus de eventos, scripts y workflows | [Vantsgames](https://vantsgg.mintlify.site/repos/vantsgames.md) |
| vants-dev-launcher | Comparte con Vantsgames el Worker, las Neon Functions, el bot y el agente, y añade las páginas de la plataforma de torneos, la home en Astro, el launcher de escritorio Electron, el servidor MCP y servicios en Docker | [vants-dev-launcher](https://vantsgg.mintlify.site/repos/vants-dev-launcher.md) |
| Vants-Proteger | SPA estática con una app Vue en `web/`, una versión anterior del bot de Discord y una app Android | [Vants-Proteger](https://vantsgg.mintlify.site/repos/vants-proteger.md) |
| VantsBasededatos | Migraciones SQL del esquema de Neon y su flujo de pruebas con una rama por PR | [VantsBasededatos](https://vantsgg.mintlify.site/repos/vants-base-de-datos.md) |
| vants-clips | Clips destacados: cada clip es un release con vídeo y miniatura, y `manifest.json` es el índice. Solo datos, sin código | [vants-clips](https://vantsgg.mintlify.site/repos/vants-clips.md) |
| vants-faceit-webhook | Worker que recibe los webhooks de FACEIT, los guarda en Neon y los publica en VANTS-BUS | [vants-faceit-webhook](https://vantsgg.mintlify.site/repos/vants-faceit-webhook.md) |
| flask-agents | Web VANTS AI, cuartel general de los agentes, en Flask sobre Vercel: presenta el squad, sirve el chat Vants Soporte con GLM y tiene el consumidor de VANTS-BUS, que publica como `post.generated` los textos que redacta sobre partidos y torneos | [flask-agents](https://vantsgg.mintlify.site/repos/flask-agents.md) |
| VANTSNET | Prototipo de red de estadísticas y plataforma competitiva en la cuenta feispla: Next.js 16 y Prisma ORM 8 con PostgreSQL, Valorant con la API de Riot, Steam, torneos y equipos, Discord y FACEIT. Publica sus eventos en VANTS-BUS y no comparte base de datos con los demás | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md) |
| vantsoport | Soporte, privacidad y términos de Vants, la extensión de GitHub Copilot Chat, en la cuenta feispla. Sin código y sin relación con la plataforma | [vantsoport](https://vantsgg.mintlify.site/repos/vantsoport.md) |

## Web y API

| Qué quieres cambiar | Dónde | Más información |
| - | - | - |
| Rutas de la web y de la API, cabeceras de seguridad, protección contra bots y límites de uso | `vants-server/worker.js` | [Seguridad](https://vantsgg.mintlify.site/referencia/seguridad.md#la-web-y-la-api) |
| Validación de parámetros, orden, paginación y formato de las respuestas de la API | `vants-server/plataforma-core.js` | [Reglas generales](https://vantsgg.mintlify.site/referencia/api-publica.md#reglas-generales) |
| Configuración del Worker `vants` | `vants-server/wrangler.toml` | [Despliegue](https://vantsgg.mintlify.site/repos/vantsgames.md#despliegue) |
| Páginas HTML de la web | `vants-server/public/` | [Rutas de la web](https://vantsgg.mintlify.site/referencia/api-publica.md#rutas-de-la-web) |
| JavaScript y CSS de la web | `vants-server/public/static/` | |
| Pruebas de la API, del matchmaking, del agente y de `vantsbot` | `scripts/test_*.js` | [Workflows](https://vantsgg.mintlify.site/repos/vantsgames.md#workflows) |
| Pruebas end-to-end en navegador (Playwright) | `tests/e2e/` | |

> [!WARNING]
>
> En vants-dev-launcher la web estática está repetida en tres carpetas que deben ser idénticas: la raíz, `public/` y `vants-server/public/`. Un cambio en una se aplica en las tres. `node scripts/build-webapp.mjs` copia el build de `webapp/` a las tres y `node scripts/build-webapp.mjs --check` comprueba que siguen iguales; el workflow `fullstack` lo vigila.

## Datos y Neon Functions

Cada función vive en `neon-functions/<nombre>/index.ts`.

| Qué quieres cambiar | Dónde | Más información |
| - | - | - |
| Tablas, columnas, vistas y funciones SQL | `db/migrations/` de VantsBasededatos | [Esquema](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md), [VantsBasededatos](https://vantsgg.mintlify.site/repos/vants-base-de-datos.md) |
| Lecturas públicas sin sesión: torneos, calendario, ranking y reglas | `neon-functions/vantsdata/` | [API pública](https://vantsgg.mintlify.site/referencia/api-publica.md) |
| Matchmaking: cola, partidas, reportes, historial y RR | `neon-functions/mm/` | [Matchmaking](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#matchmaking) |
| Vincular cuentas de otras plataformas (OAuth) | `neon-functions/linker/` | |
| Órdenes al agente desde Discord (`/agente`) | `neon-functions/vantsbot/` | [Comandos](https://vantsgg.mintlify.site/referencia/bot-de-discord.md#comandos) |
| Telemetría de la web: errores, fallos de red, páginas vistas e inicios de sesión | `neon-functions/supervisor/` | [Bot y eventos web](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#bot-y-eventos-web) |
| Avisos de la plataforma en Discord | `neon-functions/discord-notify/` | |
| Pagos con Stripe | `neon-functions/stripe-checkout/`, `neon-functions/stripe-webhook/` | [Webhooks](https://vantsgg.mintlify.site/referencia/seguridad.md#webhooks) |
| Eventos entre proyectos (VANTS-BUS) | `vants-bus/` | [Bus de eventos](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#bus-de-eventos), [Conexiones](https://vantsgg.mintlify.site/conexiones-entre-repositorios.md#vants-bus) |
| Copia de los eventos del bus a `vants_feed` (Worker `vants-consumer-playvants`) | `vants-bus/consumer-worker/` | [Conexiones](https://vantsgg.mintlify.site/conexiones-entre-repositorios.md#vants-bus) |

## Bot, agente y automatizaciones

| Qué quieres cambiar | Dónde | Más información |
| - | - | - |
| Comandos del bot de Discord | `bot/commands/` | [Comandos](https://vantsgg.mintlify.site/referencia/bot-de-discord.md#comandos) |
| Alertas automáticas del bot | `bot/alerts.py` | [Bot de Discord](https://vantsgg.mintlify.site/referencia/bot-de-discord.md) |
| Avisos de telemetría al propietario por mensaje directo | `bot/supervisor.py` | [Bot de Discord](https://vantsgg.mintlify.site/referencia/bot-de-discord.md) |
| Respuestas del agente por mensaje directo | `bot/agent_bridge.py` | [Bot de Discord](https://vantsgg.mintlify.site/referencia/bot-de-discord.md) |
| Agente VANTS: chequeos, acciones, memoria y modelo de lenguaje | `services/agent-service/` | [Agente](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#agente) |
| Sincronización diaria de torneos de FACEIT | `scripts/sincronizar-faceit.mjs` (workflow `faceit-sync`) | [Plataforma de torneos](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#plataforma-de-torneos) |
| XP y rango de las partidas de FACEIT | `scripts/faceit-xp.mjs` (workflow `faceit-xp`) | [Escala de rango](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#escala-de-rango) |
| Aviso en Discord de cada push a `main` | `scripts/notificar-discord.mjs` (workflow `mejoras-discord`) | |
| Monitor de disponibilidad | `monitor/monitor.js` (workflow `monitor`) | |
| Resultados de vlr.gg | `scripts/scraper_vlr.py`, `vlr-results/` | |
| Cuándo se ejecuta cada workflow | `.github/workflows/` | [Workflows](https://vantsgg.mintlify.site/repos/vantsgames.md#workflows) |

## Otros repositorios

| Qué quieres cambiar | Dónde | Más información |
| - | - | - |
| Recepción de webhooks de FACEIT | vants-faceit-webhook, `src/index.js` | [vants-faceit-webhook](https://vantsgg.mintlify.site/repos/vants-faceit-webhook.md) |
| Conversión de webhooks de FACEIT en eventos del bus | vants-faceit-webhook, `src/vants-bus-faceit.js` | [vants-faceit-webhook](https://vantsgg.mintlify.site/repos/vants-faceit-webhook.md) |
| Reacciones de los agentes a los eventos del bus | flask-agents, `vants_bus/consumer.py` | [flask-agents](https://vantsgg.mintlify.site/repos/flask-agents.md#reacciones) |
| Notificaciones de VANTS-BUS en el launcher | vants-dev-launcher, `desktop-electron/vants-bus-consumer.js` | [Conexiones](https://vantsgg.mintlify.site/conexiones-entre-repositorios.md#vants-bus) |
| Publicación de eventos desde el Worker de la web | Vantsgames, `vants-server/worker.js` con el cliente de `vants-bus/` | [Conexiones](https://vantsgg.mintlify.site/conexiones-entre-repositorios.md#vants-bus) |
| Publicación de eventos desde VANTSNET | VANTSNET, `src/lib/bus/` | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md#publicación-en-vants-bus) |
| Clips destacados | La web los publica con `/api/clips/featured` y se guardan en vants-clips | [Clips destacados](https://vantsgg.mintlify.site/referencia/api-publica.md#clips-destacados) |
| Home en Astro con islas React y Vue | vants-dev-launcher, `webapp/` | [vants-dev-launcher](https://vantsgg.mintlify.site/repos/vants-dev-launcher.md) |
| Launcher de escritorio | vants-dev-launcher, `desktop-electron/` | [vants-dev-launcher](https://vantsgg.mintlify.site/repos/vants-dev-launcher.md) |
| Servidor MCP del proyecto | vants-dev-launcher, `mcp/server.mjs` | [vants-dev-launcher](https://vantsgg.mintlify.site/repos/vants-dev-launcher.md) |
| Estadísticas de Valorant: perfil, historial y scoreboard | VANTSNET, `src/lib/valorant/riot.ts` y `src/app/api/valorant/` | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md) |
| Perfiles de Steam | VANTSNET, `src/lib/steam/steam.ts` y `src/app/api/steam/resolve/` | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md#endpoints) |
| Torneos, inscripciones y partidas de VANTSNET | VANTSNET, `src/app/api/tournaments/` y `src/lib/validators.ts` | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md#plataforma-competitiva) |
| Equipos y miembros de VANTSNET | VANTSNET, `src/app/api/teams/` | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md#plataforma-competitiva) |
| Vinculación con Discord y consulta de FACEIT en VANTSNET | VANTSNET, `src/lib/discord.ts`, `src/lib/faceit.ts`, `src/app/api/auth/discord/` y `src/app/api/faceit/` | [VANTSNET](https://vantsgg.mintlify.site/repos/vantsnet.md#discord-y-faceit) |
| App Android | `android/` | [Arquitectura](https://vantsgg.mintlify.site/arquitectura.md) |
| Decisiones de arquitectura | `DECISIONS.md` | [Decisiones](https://vantsgg.mintlify.site/arquitectura.md#decisiones) |

Antes de cambiar código como agente de IA, lee las reglas de trabajo en [Documentación para agentes de IA](https://vantsgg.mintlify.site/agentes.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.