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

# Glosario

> Significado de los términos, prefijos y nombres internos de VANTS: pt_, mm_, RR, rangos, VANTS-BUS, VANTCALL, Neon Functions, RLS, Hyperdrive y otros.

Este glosario define los nombres propios, prefijos y siglas que aparecen en el código de VANTS y en esta documentación. Cada término enlaza a la página que lo explica en detalle cuando la hay.

## Plataforma y competición

| Término | Significado |
| - | - |
| VANTS | Plataforma de esports con web de torneos, matchmaking, ranking, bot de Discord y apps de escritorio y Android. Web: [vants.vants.workers.dev](https://vants.vants.workers.dev) |
| `pt_` | Prefijo de las tablas de la plataforma de torneos: el catálogo público de juegos, torneos, equipos, partidas, jugadores y artículos. Ver [Plataforma de torneos](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#plataforma-de-torneos) |
| `pt_players` | Catálogo público de jugadores. Es una tabla distinta de `players`, que guarda los perfiles de la plataforma |
| `mm_` | Prefijo de las tablas del matchmaking: cola, partidas, participantes, invitaciones y confirmaciones. Ver [Matchmaking](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#matchmaking) |
| `duo` y `team` | Modos del matchmaking: `duo` es 1v1 (2 jugadores) y `team` es 5v5 (10 jugadores) |
| Rating | Número que mide el nivel de un jugador. Siempre queda entre 0.50 y 1.60 |
| RR | El rating multiplicado por 100. Es la cifra que ve el jugador. Ver [Historial de RR](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#historial-de-rr) |
| Rango | Nivel que corresponde a un rating, de menor a mayor: ACERO, TITANIO, OBSIDIANA, CROMO, PLASMA, ÉTER y VANTS. La web de vants-dev-launcher añade FUNDICIÓN por debajo de 0.95. La web de Vantsgames muestra otra escalera, VANTS RANKED, con 9 rangos por XP, de CENIZA a SUPREMO. Ver [Escala de rango](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#escala-de-rango) |
| Colocación | Partidas de un jugador que todavía no tiene rating. Parten de un rating de 0.95 |
| Serie ranked | Enfrentamiento entre un retador y un rival. Lo reporta un jugador y lo confirma el rival o el propietario (`series_ranked`) |
| Presencia | Quién está conectado: `online`, `jugando` o `ausente`. La web y la app de escritorio envían un latido cada 60 segundos (`presence`) |
| `is_demo` | Marca de los datos de demostración. Filtra por `is_demo = true` para ocultarlos |
| FACEIT | Plataforma externa de partidas competitivas. VANTS sincroniza sus torneos, procesa sus partidas para dar XP y rango, y recibe sus webhooks a través de FACEIT App Studio |
| VLR | vlr.gg, la web de resultados de esports de Valorant. `scripts/scraper_vlr.py` y `vlr-results/` trabajan con sus resultados |
| Propietario | El dueño de la plataforma. Recibe por mensaje directo los avisos del bot y del agente, y aprueba los cambios antes de que lleguen a `main` |

## Infraestructura

| Término | Significado |
| - | - |
| Worker `vants` | Worker de Cloudflare que sirve la web y la API pública. Su código está en `vants-server/worker.js`. Ver [Arquitectura](https://vantsgg.mintlify.site/arquitectura.md) |
| Neon | Proveedor de la base de datos Postgres de VANTS. Ver [Esquema de la base de datos](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md) |
| Data API | API REST de Neon con la semántica de PostgREST. El Worker le reenvía el JWT de Auth0 del usuario y la RLS de cada tabla decide qué puede hacer |
| RLS | Row Level Security de Postgres: reglas por fila que deciden qué puede leer o escribir cada usuario |
| Auth0 | Proveedor de identidad. Las sesiones son JWT de Auth0 y `auth0_sub` identifica al usuario en la base de datos |
| Neon Functions | Funciones serverless de `neon-functions/`: `vantsdata`, `mm`, `vantsbot`, `linker`, `supervisor`, `discord-notify`, `stripe-checkout` y `stripe-webhook`. Ver [Mapa del código](https://vantsgg.mintlify.site/mapa-del-codigo.md#datos-y-neon-functions) |
| `vantsdata` | Neon Function de solo lectura que atiende las lecturas públicas sin sesión, como torneos, calendario y ranking |
| Hyperdrive | Configuración de Cloudflare (`vants-neon`) que agrupa y cachea conexiones a Neon. Se usa con el binding `HYPERDRIVE`. Ver [VantsBasededatos](https://vantsgg.mintlify.site/repos/vants-base-de-datos.md) |
| Rama `pr-<n>` | Rama de Neon que se crea al abrir un PR en VantsBasededatos para probar sus migraciones sobre una copia de producción. Se borra al cerrar el PR |
| Migración | Archivo SQL numerado e idempotente de `db/migrations/` que cambia el esquema. La numeración no se reescribe. Ver [VantsBasededatos](https://vantsgg.mintlify.site/repos/vants-base-de-datos.md) |
| TWA | Trusted Web Activity: la app Android de VANTS, que muestra la web dentro de una app |
| MYKD | Identidad visual de VANTS: rojo `#ff0d2e` sobre fondo oscuro |
| `DECISIONS.md` | Registro de decisiones de arquitectura (D1, D2 y siguientes) de Vantsgames y vants-dev-launcher. Ver [Decisiones](https://vantsgg.mintlify.site/arquitectura.md#decisiones) |

## Bots, agentes y eventos

| Término | Significado |
| - | - |
| VANTCALL | Bot de Discord de VANTS, escrito en Python con `discord.py`. Ver [Bot de Discord](https://vantsgg.mintlify.site/referencia/bot-de-discord.md) |
| ORION | Nombre de VANTCALL en algunos README |
| Agente VANTS | Servicio que vigila la plataforma, registra incidencias y ejecuta órdenes. Su código está en `services/agent-service/` y guarda su trabajo en las tablas `agent_`. Ver [Agente](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#agente) |
| `/agente` | Comando de Discord para consultar el estado del agente y darle órdenes. Ver [Comandos](https://vantsgg.mintlify.site/referencia/bot-de-discord.md#comandos) |
| Supervisor | Recoge la telemetría de la web (errores de JavaScript, fallos de red, páginas vistas e inicios de sesión) en `web_events`. `bot/supervisor.py` la reenvía al propietario por mensaje directo |
| VANTS-BUS | Bus de eventos inmutables con el que se comunican los proyectos, por ejemplo con `match.finished`. Ver [Bus de eventos](https://vantsgg.mintlify.site/referencia/esquema-base-de-datos.md#bus-de-eventos) |
| VANTS HUB | Launcher de escritorio de VANTS hecho con Electron, en `desktop-electron/` de [vants-dev-launcher](https://vantsgg.mintlify.site/repos/vants-dev-launcher.md) |


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