App Alpha Athletics

Aplicación web (PWA) de Alpha Athletics para asesorados y coach: programaciones por microciclo, registro de entrenamiento (carga/reps/RIR por serie), bienestar diario, nutrición individualizada, chat, cuestionarios, biblioteca de contenidos y gamificación (rachas, XP, niveles, logros).

Estado

En producción (alpha-athletics-app.vercel.app) con backend en Supabase: login real, base de datos con RLS, Edge Function del chat y ranking de disciplina. Sin las variables VITE_SUPABASE_* la app arranca en modo demo con datos simulados ("Valentina Cruz") persistidos en localStorage — es el modo en el que corren los tests.

• Especificación: docs/specs/2026-07-13-app-alpha-athletics-diseno.md
• Plan de implementación: docs/plans/2026-07-13-etapa1-app-alpha.md
• Etapa 3 (pendiente): generación de microciclos con IA (Cerebro Alpha / motor Heracles).
• Convenciones y trampas del proyecto: CLAUDE.md

Cómo correrla

npm install
npm run dev      # abre http://localhost:5173
npm run verify   # tipos + linter + tests: pasar esto antes de cada push
npm run build    # build de producción

npm run verify es lo mismo que corre CI. Por separado: npm run typecheck, npm run lint, npm test.

⚠️ Un push a main despliega a producción en Vercel. Trabajar en rama.

En la app: el avatar de la esquina superior derecha permite alternar entre la vista de asesorada (Valentina) y la del coach (Bryan). El sol/luna cambia el tema.

Nota técnica de este equipo

La política de control de aplicaciones de Windows bloquea binarios nativos de npm (esbuild.exe, rollup nativo, rolldown). Por eso package.json fija overrides a las versiones WebAssembly (esbuild-wasm, @rollup/wasm-node) y usa Tailwind v3 (JS puro). No quitar esos overrides en esta máquina.