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 |
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 |
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 |
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 |
| 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 |
| 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 |
| Neon | Proveedor de la base de datos Postgres de VANTS. Ver Esquema de la base de datos |
| 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 |
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 |
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 |
| 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 |
Bots, agentes y eventos
| Término | Significado |
|---|---|
| VANTCALL | Bot de Discord de VANTS, escrito en Python con discord.py. Ver Bot de Discord |
| 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 |
/agente | Comando de Discord para consultar el estado del agente y darle órdenes. Ver 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 |
| VANTS HUB | Launcher de escritorio de VANTS hecho con Electron, en desktop-electron/ de vants-dev-launcher |