Expediente del caso

Fitlosophy

Simbolo de la marca de la edicion del caso
Simbolo de la marca de la edicion del caso
Periodo
2026-08 — presente
Estado
active
Visibilidad
public
Stack
Markdown, YAML, Python
  • technology:markdown
  • technology:yaml
  • technology:python
  • domain:fitness
  • domain:bjj

Evidencias · FITLOSOPHY

Repositorio

  • roadmap de producto con fases 0-12 y validacion manual previa al desarrollo
Sistema personal de entrenamiento adaptativo orientado a combinar acondicionamiento fisico, BJJ, perdida de grasa, fuerza y prevencion de lesiones. Evita calendarios rigidos: la sesion del dia se decide a partir del estado de recuperacion, la carga acumulada reciente, la existencia o no de sesion de BJJ, el estado de la zona lumbar y articulaciones y el objetivo fisico prioritario. La informacion se mantiene en Markdown y YAML para consumirse desde una futura aplicacion React o Svelte sin acoplar el diseno a un framework. La aplicacion no se construira hasta validar manualmente el modelo funcional (fases 0 a 6 del roadmap); desde la fase 8 el repositorio publico incluye un motor Python en `app/backend/`.

Expediente del caso

Motivación

Los planes de entrenamiento con calendarios rigidos fallan cuando el cuerpo no esta para la sesion marcada: lesion, carga acumulada o una sesion de BJJ cambian lo que conviene hacer hoy. La motivacion fue un sistema que decide la sesion del dia desde el estado real del atleta, en lugar de seguir una plantilla fija.

El reto

El reto es que la decision no es una regla simple: combina recuperacion, carga de los ultimos dias, presencia de BJJ, estado lumbar y objetivo prioritario, y debe ser explicable. Si el sistema no justifica por que propone esa sesion, nadie confiara en el.

Enfoque

El modelo de dominio se escribe primero en documentacion (Markdown) con datos en YAML, sin acoplar el diseno a un framework. El desarrollo sigue un roadmap en fases (0-12) con una puerta de validacion manual antes de construir la app. Desde la fase 8, el repositorio publico incorpora un motor Python en `app/backend/` que implementa lo que dicen los documentos.

Aprendizaje

Escribir el modelo en documentacion antes que el codigo mantiene la fuente de verdad en los documentos y hace la decision trazable. La validacion manual previa evita construir una app sobre un modelo que aun no convence. Cuando el modelo madura, el motor pasa a codigo sin saltarse el roadmap.

Estado actual

Activo. El repositorio publico (papulo79/fitlosophy) documenta el modelo, el roadmap en fases 0-12 y, desde la fase 8, un motor Python en `app/backend/`. El sistema sigue en desarrollo orientado a validar el modelo funcional antes del MVP.