Club One
One club. One platform.
Plataforma SaaS premium para gestionar clubes y academias deportivas de forma sencilla.
Stack
- Frontend: Next.js 14 (App Router) + TypeScript
- Estilos: Tailwind CSS + shadcn/ui
- Animaciones: Framer Motion
- Estado: Zustand / TanStack Query
- Base de datos: Supabase (PostgreSQL + Data API)
- Auth: NextAuth.js (roles: SUPER_ADMIN, CLUB_ADMIN, ENTRENADOR, JUGADOR, TUTOR)
- Mensajería: API autenticada con sincronización automática
- Pagos: Stripe / Conekta (modo test)
- Automatizaciones: Webhooks para n8n
Instalación
npm install
Configuración
Usa .env.example como plantilla para .env y .env.local:
cp .env.example .env
En Supabase copia Project URL, Publishable key y Secret key desde
Connect a .env.local. También se admiten las claves legacy anon y
service_role. La clave secreta nunca debe llevar el prefijo NEXT_PUBLIC_.
Base de datos
Aplica los archivos de supabase/migrations desde SQL Editor, o configura
temporalmente SUPABASE_DB_URL con el Session pooler y ejecuta:
npm run db:migrate
npm run db:seed
Desarrollo
npm run dev
Abre http://localhost:3000.
Cuentas de demo
Rutas principales
/ — Landing page/login, /registro — Autenticación/super-admin/dashboard — Panel de plataforma/club/[clubId]/dashboard — Dashboard del club/club/[clubId]/equipos — Gestión de equipos/club/[clubId]/equipos/[equipoId]/roster — Roster/club/[clubId]/equipos/[equipoId]/tactica — Pizarra táctica/club/[clubId]/calendario — Eventos y RSVP/club/[clubId]/chat — Chat de equipo/club/[clubId]/cobros — Mensualidades y pagos/club/[clubId]/registro — Gestión de solicitudes de inscripción/club/[clubId]/background-checks — Verificación de antecedentes/club/[clubId]/configuracion — Configuración del club + bitácora de auditoría/inscripcion/[slug] — Formulario público de inscripción/inscripcion/[slug]/pago — Pago simulado del evento (solo sin STRIPE_SECRET_KEY)/inscripcion/[slug]/confirmacion — Confirmación de pago y creación de acceso/usa-goalkeeper-tour-2026 — Landing y selección de sede del USA Goalkeeper Tour 2026/club/[clubId]/evento — Panel de métricas del evento (USD), separado de la operación por suscripción/app/inicio — Vista mobile PWA (inicio de la app nativa)/eliminar-cuenta — Instrucciones públicas de eliminación de cuenta y datos
Flujo del evento (USA Goalkeeper Tour)
- La familia llena
/inscripcion/usa-goalkeeper-tour-2026 (posición única: Portero).
- Al enviar, se crea la solicitud y se abre Stripe Checkout con el precio del evento
($350 USD; usa
STRIPE_GOALKEEPER_TOUR_PRICE_ID del catálogo de Stripe si existe).
- Pago aprobado → la solicitud se aprueba sola, se crea la cuenta del tutor y el registro
del portero (vía webhook
checkout.session.completed o la página de confirmación).
- En la confirmación el tutor crea su contraseña y entra a la app (
/app/inicio).
La configuración de los cuatro formularios externos y sus enlaces está en docs/USA_GOALKEEPER_TOUR_JOTFORM.md.
App móvil (iOS / Android)
La app nativa usa Capacitor y carga el servidor desplegado. Guía completa de
compilación y publicación en App Store y Google Play: docs/APP_MOVIL.md.
cp .env.mobile.example .env.mobile # CAPACITOR_SERVER_URL=https://tu-dominio
npm run mobile:release # sincroniza iOS y Android
npm run mobile:ios # abre Xcode
npm run mobile:android # abre Android Studio
Webhooks
POST /api/webhooks/n8n/payment-reminderPOST /api/webhooks/n8n/weekly-reportPOST /api/webhooks/n8n/absence-alertPOST /api/webhooks/stripePOST /api/webhooks/conekta
Los webhooks de n8n requieren Authorization: Bearer <N8N_WEBHOOK_SECRET>. Stripe valida stripe-signature y Conekta valida el encabezado DIGEST con CONEKTA_WEBHOOK_PUBLIC_KEY.
Operación y salud
GET /api/health — comprueba base de datos e indica qué integraciones están configuradas, sin revelar secretos.- El benchmark y la ruta de paridad competitiva están en
docs/SPORTSENGINE_BENCHMARK.md.
Licencia
© Club One. Todos los derechos reservados.
