Training Please · app web

Panel de coach y plan semanal de cada atleta. Next.js en Vercel, login con Google (Firebase Auth), datos en Firestore y Firebase Admin SDK en rutas API privadas. Proyecto hecho desde cero con Claude Code. El diseño respeta el de la web original del plan de Claudia (rosa, celeste, amarillo y menta; Oswald y Nunito Sans; tarjetas por día con check y cuenta regresiva), con tres temas a elegir: rosa, azul y oscuro.

Sitio público y acceso a la app

• / es el sitio informativo de Training Please (propósito, cómo funciona, piloto y "Crece con nosotros"). Contenido editable en src/lib/site.ts (testimonios, pasos y pilares); estilos en src/app/site.css.
• /entrar es el login de la app. Las páginas privadas redirigen ahí si no hay sesión.
• El formulario "Únete al piloto" guarda la solicitud en pilotRequests/{correo} vía /api/solicitudes. El coach la ve en Panel coach › Solicitudes del piloto: Aprobar crea el alta (igual que el alta manual) y Descartar la cierra.

Cómo funciona el acceso

• No hay invitación por enlace. El coach da de alta a cada atleta desde Panel coach › Dar de alta con su nombre y su correo de Google.
• Al entrar con Google, /api/bootstrap comprueba el correo (lista ADMIN_EMAILS o alta del coach), crea users/{uid} y pone el rol como custom claim. Un correo no registrado no entra.
• El atleta acepta disclaimer, términos y consentimiento de datos la primera vez (y de nuevo si cambia LEGAL_VERSION en src/lib/legal.ts). Puede revocarlo desde Ajustes › Privacidad; desde ese momento el coach deja de ver sus registros.

Datos en Firestore

Ruta	Qué guarda	Quién escribe
users/{uid}	rol, nombre, correo, tema, carrera objetivo, perfil, consentimiento vigente	servidor al crear; el atleta edita tema, perfil, carrera y consentimiento
allowlist/{correo}	altas manuales pendientes o usadas	solo servidor
pilotRequests/{correo}	solicitudes del sitio: datos de contacto, nivel, carrera, autorización y estado (pending, approved, dismissed)	solo servidor; el coach lee
investorContacts/{id}	mensajes de "Crece con nosotros"	solo servidor; el coach lee
consents/{uid}/events/{id}	evidencia: versión, finalidades, fecha, navegador, otorgado o revocado	atleta (solo agrega)
plans/{uid}/weeks/{semanaISO}	título, fase, objetivo, notas, marca de IA	coach
plans/{uid}/weeks/{semanaISO}/sessions/{id}	fecha, deporte, título, duración, distancia, RPE objetivo, instrucciones	coach
logs/{uid}/entries/{sessionId}	realizada, RPE real, comentario	atleta

"No realizada" no se guarda: se calcula al leer. Una sesión sin marcar queda pendiente hasta el final del día siguiente y luego no realizada. El cumplimiento cuenta solo las sesiones principales (las extra y el descanso no).

Puesta en marcha

1. Firebase (proyecto trainingplease, ya creado): activar Authentication › Google y Firestore (región sugerida southamerica-east1 o us-east1). En Authentication › Settings › Authorized domains, agregar el dominio de Vercel.
2. Reglas: npx firebase deploy --only firestore:rules --project <id>.
3. Vercel: nuevo proyecto con este repo (raíz por defecto, framework Next.js). Variables de entorno (ver .env.example):
   • NEXT_PUBLIC_FIREBASE_*: opcionales; la configuración web del proyecto trainingplease ya está en src/lib/firebase.ts.
   • FIREBASE_SERVICE_ACCOUNT: el JSON de la cuenta de servicio (Configuración del proyecto › Cuentas de servicio › Generar nueva clave), pegado en una línea. Nunca subirlo al repo.
   • ADMIN_EMAILS: correos de Google de la coach y admins, separados por coma.
4. Entrar con la cuenta del coach, dar de alta a los atletas y pedirles que entren con Google.
5. Plan actual de Claudia: cuando ella haya entrado una vez, en Panel coach › Claudia aparece el botón Cargar plan de Claudia (web anterior) (solo si aún no tiene semanas). También se puede con npm run seed:plan -- [email protected] data/claudia-plan.json y la cuenta de servicio.

Datos de la web anterior

data/claudia-plan.json (semanas y sesiones) y data/claudia-meta.json (fases, mes a mes, "lo mejor de mí y mi reto", niveles de meta) guardan el contenido de la web estática de Claudia, que se retiró del repo. Sirven para cargar su plan y para construir más adelante las vistas "La meta" y "Lo mejor de mí".

Desarrollo

npm install
npm run lint          # tipos
npm test              # fechas, estados y cumplimiento
npm run test:rules    # reglas de Firestore en el emulador (requiere Java)
cp .env.emulators.example .env.local && npm run dev:emu   # app completa con emuladores

Con emuladores, en la consola del navegador __tpSignIn('[email protected]') inicia sesión sin la ventana de Google.

Exportar e importar semanas

En la ficha de cada atleta (panel coach) hay dos paneles:

• Exportar semana: descarga o copia un JSON con el perfil del atleta, la semana elegida (y, si se marca, las 4 anteriores), sus sesiones y los registros (hecho, RPE real, comentario, fecha). Los registros solo se incluyen si el atleta tiene el consentimiento vigente.
• Importar semana: pega o sube un JSON con el formato de scripts/seed-plan.mjs ([{ id, week, sessions }]) o un archivo exportado. Muestra una vista previa y lo guarda por /api/admin/plan con el mismo comportamiento que el script: fusiona la semana y crea o reemplaza sus sesiones, sin borrar otras.

Agente principal (IA)

Cada domingo a las 4 pm de Lima (cron de Vercel, vercel.json) el agente principal analiza la semana que cierra de cada atleta y arma la siguiente. Si el Guardián no encuentra problemas, la carga sola en el plan del atleta; si encuentra, queda pendiente en la ficha del atleta (sección "Agente principal") para que el coach la apruebe, la edite o la descarte. Antes de las 4 pm el coach puede dejar una nota para la próxima semana de cada atleta, y el atleta sus avisos (viajes, días sin entrenar); el agente lee ambos. El coach también puede pedir la semana en el momento con "Generar la semana siguiente ahora", que siempre queda para aprobar.

• Ajustes puntuales: en la misma sección, el coach elige una semana cargada y escribe qué cambiar ("mueve el fondo del domingo al sábado"). El agente cambia solo eso, conserva los ids de las sesiones, no toca las ya pasadas o registradas y lo deja como propuesta para aprobar.
• Solo trabaja con atletas que marcaron la finalidad opcional de IA en su consentimiento, y solo lee registros si el consentimiento está vigente.
• src/lib/agent/metrics.ts (Análisis): cumplimiento, km, RPE y alertas, en código.
• src/lib/agent/methodology.ts (Ciencia): la metodología vigente que sigue el modelo (versión 2: principios publicados de Daniels y reglas de seguridad con estudios; detalle en 09-metodologia-agente-ciencia.md).
• src/lib/agent/fitness.ts (Ciencia): índice de forma, equivalencias y ritmos por atleta con las ecuaciones de Daniels y Gilbert, a partir del tiempo de referencia que el coach guarda en la ficha (sección "Forma actual").
• src/lib/agent/headCoach.ts: llama a la Claude API (salida JSON con esquema) y corrige hasta 3 veces si el Guardián encuentra problemas.
• src/lib/agent/guardrails.ts (Guardián): reglas duras sobre la propuesta: tope de +20 % de km por semana (+30 % sobre hace dos), ninguna salida más de 10 % sobre la más larga de 30 días, fondo hasta 150 min, topes por tipo de sesión, días duros, taper, días suaves tras una carrera, descarga, dolor, enfermedad y formato. En un ajuste puntual las reglas de estructura quedan como avisos.
• Datos: proposals/{uid}/weeks/{semana}, athleteMemory/{uid} (ficha, tiempo de referencia, meta de tiempo e historial) y agentRuns/{id} (registro con tokens y costo). Solo servidor; las reglas de Firestore ya los niegan al cliente.
• Variables en Vercel: ANTHROPIC_API_KEY (clave de la Claude API) y CRON_SECRET (cualquier texto largo; Vercel lo envía al cron).

Correo (Resend)

• RESEND_API_KEY: sin ella no se envía ningún correo y todo lo demás funciona igual (/api/health muestra email).
• EMAIL_FROM (opcional, por defecto Training Please <[email protected]>): remitente de un dominio verificado en Resend.
• RESEND_SEGMENT_BOLETIN y RESEND_SEGMENT_ATLETAS (opcionales): ids de segmentos de Resend.
• Avisos: cuando una propuesta se carga en el plan (aprobada por el coach o cargada sola por el cron), el atleta recibe "Tu semana está lista" y se suma al segmento de atletas.
• Boletín: el formulario del sitio (/#boletin) guarda newsletter/{correo} con su consentimiento y suma el contacto al segmento del boletín. El boletín y los comunicados se escriben y envían desde Broadcasts en Resend, que agrega la baja.
• Blog: el coach escribe en /coach/blog (posts en posts/{slug}, con versión en inglés opcional y marca «Solo atletas»). "Enviar a los atletas" manda un correo a cada atleta con consentimiento, en su idioma; "Enviar al boletín" crea y envía un broadcast al segmento RESEND_SEGMENT_BOLETIN (solo posts públicos). Los me gusta pasan por /api/blog/like: uno por cuenta o por navegador, y como máximo 5 anónimos por post desde una misma conexión (la IP se guarda solo como hash con LIKE_SALT, o CRON_SECRET si no existe).
• Arquitectura completa: 08-arquitectura-agentes-ia.md en los documentos del proyecto.