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 |
| 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 |
| 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 |
| VantsBasededatos | Migraciones SQL del esquema de Neon y su flujo de pruebas con una rama por PR | VantsBasededatos |
| 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 |
| vants-faceit-webhook | Worker que recibe los webhooks de FACEIT, los guarda en Neon y los publica en VANTS-BUS | vants-faceit-webhook |
| 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 |
| 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 |
| 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 |
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 |
| Validación de parámetros, orden, paginación y formato de las respuestas de la API | vants-server/plataforma-core.js | Reglas generales |
Configuración del Worker vants | vants-server/wrangler.toml | Despliegue |
| Páginas HTML de la web | vants-server/public/ | 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 |
| Pruebas end-to-end en navegador (Playwright) | tests/e2e/ |
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 enneon-functions/<nombre>/index.ts.
| Qué quieres cambiar | Dónde | Más información |
|---|---|---|
| Tablas, columnas, vistas y funciones SQL | db/migrations/ de VantsBasededatos | Esquema, VantsBasededatos |
| Lecturas públicas sin sesión: torneos, calendario, ranking y reglas | neon-functions/vantsdata/ | API pública |
| Matchmaking: cola, partidas, reportes, historial y RR | neon-functions/mm/ | Matchmaking |
| Vincular cuentas de otras plataformas (OAuth) | neon-functions/linker/ | |
Órdenes al agente desde Discord (/agente) | neon-functions/vantsbot/ | 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 |
| Avisos de la plataforma en Discord | neon-functions/discord-notify/ | |
| Pagos con Stripe | neon-functions/stripe-checkout/, neon-functions/stripe-webhook/ | Webhooks |
| Eventos entre proyectos (VANTS-BUS) | vants-bus/ | Bus de eventos, Conexiones |
Copia de los eventos del bus a vants_feed (Worker vants-consumer-playvants) | vants-bus/consumer-worker/ | Conexiones |
Bot, agente y automatizaciones
| Qué quieres cambiar | Dónde | Más información |
|---|---|---|
| Comandos del bot de Discord | bot/commands/ | Comandos |
| Alertas automáticas del bot | bot/alerts.py | Bot de Discord |
| Avisos de telemetría al propietario por mensaje directo | bot/supervisor.py | Bot de Discord |
| Respuestas del agente por mensaje directo | bot/agent_bridge.py | Bot de Discord |
| Agente VANTS: chequeos, acciones, memoria y modelo de lenguaje | services/agent-service/ | Agente |
| Sincronización diaria de torneos de FACEIT | scripts/sincronizar-faceit.mjs (workflow faceit-sync) | Plataforma de torneos |
| XP y rango de las partidas de FACEIT | scripts/faceit-xp.mjs (workflow faceit-xp) | 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 |
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 |
| Conversión de webhooks de FACEIT en eventos del bus | vants-faceit-webhook, src/vants-bus-faceit.js | vants-faceit-webhook |
| Reacciones de los agentes a los eventos del bus | flask-agents, vants_bus/consumer.py | flask-agents |
| Notificaciones de VANTS-BUS en el launcher | vants-dev-launcher, desktop-electron/vants-bus-consumer.js | Conexiones |
| Publicación de eventos desde el Worker de la web | Vantsgames, vants-server/worker.js con el cliente de vants-bus/ | Conexiones |
| Publicación de eventos desde VANTSNET | VANTSNET, src/lib/bus/ | VANTSNET |
| Clips destacados | La web los publica con /api/clips/featured y se guardan en vants-clips | Clips destacados |
| Home en Astro con islas React y Vue | vants-dev-launcher, webapp/ | vants-dev-launcher |
| Launcher de escritorio | vants-dev-launcher, desktop-electron/ | vants-dev-launcher |
| Servidor MCP del proyecto | vants-dev-launcher, mcp/server.mjs | vants-dev-launcher |
| Estadísticas de Valorant: perfil, historial y scoreboard | VANTSNET, src/lib/valorant/riot.ts y src/app/api/valorant/ | VANTSNET |
| Perfiles de Steam | VANTSNET, src/lib/steam/steam.ts y src/app/api/steam/resolve/ | VANTSNET |
| Torneos, inscripciones y partidas de VANTSNET | VANTSNET, src/app/api/tournaments/ y src/lib/validators.ts | VANTSNET |
| Equipos y miembros de VANTSNET | VANTSNET, src/app/api/teams/ | VANTSNET |
| 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 |
| App Android | android/ | Arquitectura |
| Decisiones de arquitectura | DECISIONS.md | Decisiones |