> ## 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.

# vants-dev-launcher

> Versión ampliada de VANTS con las páginas de torneos, la home en Astro, el launcher Electron, el servidor MCP, Docker y sus workflows de GitHub Actions.

Plataforma de torneos estilo strafe.com: calendario por juego y estado, partidas en vivo, ranking, brackets, equipos, jugadores, noticias, búsqueda, tienda y membresías. Comparte con [Vantsgames](https://vantsgg.mintlify.site/repos/vantsgames.md) el Worker, las Neon Functions, el bot y el agente, y añade la home en Astro, el launcher de escritorio, el servidor MCP del proyecto y servicios en Docker.

Web: [https://vants.vants.workers.dev](https://vants.vants.workers.dev)

## Estructura

| Ruta | Contenido |
| - | - |
| Raíz y `public/` | Páginas HTML (inicio, equipos, torneos, partidos, ranking, clips, membresías, tienda) |
| `vants-server/` | Worker de Cloudflare y lógica compartida |
| `webapp/` | Astro con islas React (Explore) y Vue + Three (Emblema3D) |
| `neon-functions/` | `vantsdata`, `mm`, `vantsbot`, `linker`, `supervisor`, Stripe, Discord |
| `services/` | Servicio de agente y matchmaking |
| `bot/` | Bot ORION de Discord (Python). Ver [Bot de Discord](https://vantsgg.mintlify.site/referencia/bot-de-discord.md) |
| `desktop-electron/` | Launcher Electron con auto-update |
| `android/` | App Android |
| `mcp/` | Servidor MCP stdio con 4 herramientas |
| `monitor/` | Monitor de disponibilidad |
| `db/migrations/` | Migraciones SQL (01 a 34) |
| `docs/` | Guías: testing, despliegue, troubleshooting, configuración |
| `product/`, `architecture/`, `research/` | Requisitos, diseño y análisis de referencia |

> [!WARNING]
>
> La web estática está repetida en la raíz, `public/` y `vants-server/public/`, y las tres copias deben ser idénticas. `node scripts/build-webapp.mjs` copia el build de `webapp/` a las tres y `node scripts/build-webapp.mjs --check` comprueba que coinciden. El workflow `fullstack` lo vigila.

## Requisitos

* Node 20 o superior.
* Cuenta de Cloudflare con el Worker `vants`.
* Proyecto Neon y tenant de Auth0.

## Workflows de GitHub Actions

`tests`, `neon-migrate`, `neon-deploy-functions`, `cloudflare-deploy`, `fullstack`, `agente`, `faceit-sync`, `faceit-xp`, `monitor`, `mejoras-discord`, `desktop-electron`, `windows-build` y `android-build`. Hay también `bootstrap-copiar-neon`, que se lanza a mano y copia la clave de Neon (`NEON_API_KEY`) a los secretos de la organización y de los repositorios que la necesitan.

Al hacer push a `main`, cada workflow se lanza según los archivos que cambien. Consulta [Arquitectura general](https://vantsgg.mintlify.site/arquitectura.md).

## Docker

`docker-compose.yml` levanta un `api-gateway` (Express, puerto 8080) y `matchmaking` (puerto 8081).


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