PIRLO BOT

Bot de Discord multiclub para estadísticas y gestión de clubes de EA SPORTS FC 27.

Proyecto independiente. MARÍTIMO CF (maritimo.app) es el primer club conectado, como proveedor externo de datos mediante API.

Estado

Fases 1-4 completadas: proyecto, base de datos multiclub, núcleo y permisos, y comandos de Discord funcionando en el servidor de pruebas. Siguiente: Fase 5 (MARÍTIMO CF como proveedor).

Comandos de Discord

Comando	Quién
/pirlo ayuda	Todos
/club registrar · /club conectar · /club info · /club canal	Gestor del servidor · gestor del servidor y admin del club · todos · admin
/vincular · /solicitudes (con botones)	Todos · DT/admin
/plantilla ver · rol · posiciones · baja	Miembros · DT/admin · cada jugador · DT/admin
/temporada crear · /temporada fechas · /temporada ver	Admin · admin · todos

Los comandos se registran solo en el servidor de pruebas desde GitHub Actions → Registrar comandos de Discord (secretos DISCORD_BOT_TOKEN y DISCORD_DEV_GUILD_ID).

Requisitos

• Node.js 22 o superior
• Supabase CLI (incluida como dependencia de desarrollo; necesita Docker para la base local)

Puesta en marcha

npm install
cp .env.example .env.local   # rellena los valores (nunca los subas a git)
npm run check                # lint + formato + tipos + pruebas
npm run dev                  # servidor local en http://localhost:3000

Para probar con Discord en local, expón el puerto con un túnel HTTPS y configura esa URL + /api/interactions como Interactions Endpoint URL de una aplicación de pruebas.

Scripts

Script	Qué hace
npm run dev	Servidor local con recarga
npm run check	Lint, formato, tipos y pruebas
npm test	Pruebas (Vitest)
npm run commands:register	Registra comandos en el servidor de pruebas
npm run db:new <nombre>	Crea una migración nueva
npm run db:types	Genera tipos TypeScript desde la base local

Documentación

• Arquitectura
• Modelo de datos
• Proveedores de estadísticas
• Despliegue
• Permisos y roles
• Instrucciones permanentes para Claude