SOLUCIÓ

COM HO FAREM

Aquest va ser el plantejament inicial. La direcció es manté, però l'arquitectura actual incorpora FITBOX HUB com a capa central de dades, control i validació; Make queda com a possible orquestrador, no com a font de veritat.

1. LLEGIR

Dades del client
Perfil + Bodymetrics
+ Historial + Notes

→

2. GENERAR

IA crea el pla
Prompt + dades client
→ exercicis per dia

→

3. CREAR

Pla a Virtuagym
PUT plan/definition
amb act_days (JSON)

→

4. ASSIGNAR

Al calendari del client
POST assign workout
dies + setmanes + data

→

5. REBRE

Client veu el pla
A l'app Virtuagym
automàticament

Virtuagym API + FITBOX HUB + IA + Make (orquestració opcional) = Plans personalitzats amb control i validació

VIABILITAT

QUÈ PODEM FER AMB L'API?

La viabilitat del nucli d'entrenament ja està demostrada: podem llegir dades útils, crear plans i assignar-los. El feedback subjectiu via Questionnaires continua pendent de confirmació oficial de Virtuagym.

Perfil del membre

Objectiu (perdre pes, guanyar múscul...)
Nivell (principiant → expert)
Gènere, edat, antiguitat

API DIRECTE ✓

Bodymetrics

Pes, alçada, BMI
% Greix, massa muscular
Greix visceral, perímetre cintura

API DIRECTE ✓

Historial d'entrenament

Exercicis completats i pesos usats
Freqüència de visites al gym
Plans anteriors assignats

API DIRECTE ✓

Preferències i benestar

Lesions, limitacions, dies disponibles
Son, nivell d'energia, estrès
Feedback del pla anterior

VIA COACHING NOTES

Actualització setembre 2026: hem demanat a Virtuagym com crear/assignar Questionnaires i recuperar-ne les respostes via API. Encara no tenim resposta oficial. Les Coaching Notes són accessibles i útils com a context, però no les considerem substitut del feedback del client fins validar el flux oficial.

INNOVACIÓ

COACHING NOTES: CONTEXT DISPONIBLE

Les Coaching Notes són una font accessible de context i poden guardar informació estructurada. El feedback setmanal del client, però, queda pendent de resoldre mitjançant Questionnaires oficials de Virtuagym.

Nota d'onboarding (una sola vegada)

        // POST /v1/club/{id}/notes

        // note_type: "coaching"

        {

          "tipo": "onboarding",

          "lesions": ["genoll_dret"],

          "dies_disponibles": [1, 3, 5],

          "cardio_vs_forca": "30/70",

          "equip_evitar": ["barbell"],

          "zona_focus": "core",

          "preferencia_intensitat": "moderada"

        }

Nota setmanal (cada setmana, recurrent)

        // Mini-enquesta: WhatsApp / email / app

        // Es guarda com a coaching note

        {

          "tipo": "checkin_setmanal",

          "setmana": "2026-W19",

          "son": 4,

          "energia": 3,

          "dolor": "cap",

          "feedback": "bé però vull més cardio"

        }

MOTOR IA

COM GENERA LA IA EL PLA?

La IA rep les dades del client i retorna un JSON amb els exercicis per dia, directament compatible amb l'API de Virtuagym.

INPUT → La IA rep:

Perfil: Dona, 34 anys, intermedi, objectiu: tonificar

Cos: 65kg, 24% greix, BMI 23

Historial: 4 sessions/setmana, pesos progressant

Notes: Lesió genoll dret, prefereix dumbbells

Check-in: Son 4/5, energia 3/5, vol més cardio

OUTPUT → La IA retorna:

        {

          "name": "Maria - S19 Tonificar",

          "goal": 1,

          "act_days": [

            [{"act_id":492, "reps":[12,10,8]},...],

            [{"act_id":26, "duration":1800},...],

            [{"act_id":143, "reps":[15,12,10]},...],

          ]

        }

El prompt inclourà regles de periodització, progressió de càrrega, equilibri muscular i respecte a lesions — validat per Diego

MAKE.COM

L'ORQUESTRACIÓ DEL ROADMAP INICIAL

Trigger: Cada diumenge a les 20:00

Make s'activa i obté la llista de membres actius del club via API Virtuagym

Iterator: Per a cada membre

GET perfil + GET bodymetrics + GET historial d'activitats + GET coaching notes

Mòdul IA: Generar pla

Enviar totes les dades al prompt → rebre JSON amb act_days (exercicis per dia de la setmana)

PUT: Crear pla a Virtuagym

Crear el plan definition amb nom personalitzat, objectiu i exercicis per dia

POST: Assignar al membre

Assignar el pla al calendari del client amb start_date = dilluns, weekdays i 1 setmana

Sleep: Esperar 8 segons

Respectar el límit de 500 requests/hora (batch de ~100 membres per tanda)

ROADMAP

4 FASES D'IMPLEMENTACIÓ

FASE 0

Connexió tècnica

Connectar Make amb Virtuagym. Verificar lectura de dades dels 2 test users

~1 sessió

FASE 1

Model de dades

Definir onboarding + coaching notes. Escriure dades de test

~1 sessió

FASE 2

Motor IA

Crear i afinar el prompt. Diego valida els plans generats

~2 sessions

FASE 3

End-to-end

Escenari complet en Make. Els test users reben el pla a l'app

~2 sessions

Total estimat 6–8 sessions de treball · Test users Matias Luciani · Jordi Navarro Ayala

FASE 0 — Connexió i validació tècnica

0.1

2GROWConnectar Make amb Virtuagym

Instal·lar mòdul Virtuagym a Make → configurar api_key + club_secret

Connexió activa

0.2

2GROWGET dels 2 membres de prova

Verificar lectura de perfil + bodymetrics de Matias (#47443170) i Jordi Navarro (#29296913)

Dades reals llegides

0.3

2GROWDescarregar catàleg d'exercicis

GET Activity Definitions → guardar tots els act_id en Google Sheet o datastore de Make

Catàleg complet

✓ Validat quan: podem llegir dades reals dels 2 test users des de Make

FASE 1 — Model de dades del client

1.1

JORDI+DIEGODefinir preguntes d'onboarding

Lesions, dies disponibles, preferències d'entrenament, objectius detallats

Formulari tancat

1.2

2GROWDissenyar estructura JSON per Coaching Notes

Esquema fix i parseable per Make: {"tipo":"onboarding", "lesions":[], ...}

Esquema definit

1.3

2GROWEscriure notes de prova per als 2 test users

POST coaching notes amb dades de test per Matias i Jordi Navarro → verificar lectura

Notes llegibles

1.4

2GROWDissenyar mini-enquesta setmanal

Son, energia, dolor, feedback → canal: app Virtuagym, WhatsApp o email

Enquesta definida

✓ Validat quan: podem llegir notes estructurades dels 2 test users

FASE 2 — Motor IA: el prompt

Aquesta és la fase més crítica. El prompt ha d'incloure regles d'entrenament professional i generar output vàlid per l'API.

2.1

2GROWCrear prompt base amb regles d'entrenador

Periodització, progressió de càrrega, equilibri muscular, respecte a lesions, volum adequat

Prompt v1

2.2

2GROWDefinir output JSON compatible amb act_days

La IA ha de retornar: [{act_id, reps, rest_period, duration},...] per dia, mapejat al catàleg real

Format validat

2.3

2GROWTestejar amb dades reals de Matias i Jordi Navarro

Generar 3-4 plans → Diego els revisa i dona feedback → iterar el prompt fins aprovar

Plans coherents

2.4

DIEGOValidació dels plans generats

Són coherents? Respecten lesions? La progressió és correcta? El volum és adequat?

APROVACIÓ ✓

FASE 3 — Escenari end-to-end

El roadmap inicial preveia centralitzar el flux a Make. L'arquitectura actual trasllada l'estat, el catàleg, la normalització i els validators al FITBOX HUB; Make pot quedar per programació i orquestració quan aporti valor.

3.1

2GROWMontar escenari complet a Make

Trigger → llegir dades → IA → crear pla → assignar. Filtre: NOMÉS member_id dels 2 test users

Escenari funcional

3.2

2GROWExecutar flux complet per als 2 test users

Verificar que el pla apareix al calendari de Virtuagym del client

Pla visible

3.3

DIEGOMatias i Jordi Navarro veuen el seu pla a l'app

Confirmar que el reben correctament al calendari de l'app Virtuagym

PILOT VALIDAT ✓

Després del pilot: escalar a 310+ clients

Activar l'escenari per a tots els membres actius · Afegir check-in setmanal · Feedback loop automàtic

PLANS D'ENTRENAMENTGENERATS PER IA

EL COLL D'AMPOLLA

Temps perdut

Punt de fallada

No escala

COM HO FAREM

1. LLEGIR

2. GENERAR

3. CREAR

4. ASSIGNAR

5. REBRE

QUÈ PODEM FER AMB L'API?

Perfil del membre

Bodymetrics

Historial d'entrenament

Preferències i benestar

COACHING NOTES: CONTEXT DISPONIBLE

Nota d'onboarding (una sola vegada)

Nota setmanal (cada setmana, recurrent)

COM GENERA LA IA EL PLA?

INPUT → La IA rep:

OUTPUT → La IA retorna:

L'ORQUESTRACIÓ DEL ROADMAP INICIAL

Trigger: Cada diumenge a les 20:00

Iterator: Per a cada membre

Mòdul IA: Generar pla

PUT: Crear pla a Virtuagym

POST: Assignar al membre

Sleep: Esperar 8 segons

4 FASES D'IMPLEMENTACIÓ

FASE 0 — Connexió i validació tècnica

2GROWConnectar Make amb Virtuagym

2GROWGET dels 2 membres de prova

2GROWDescarregar catàleg d'exercicis

FASE 1 — Model de dades del client

JORDI+DIEGODefinir preguntes d'onboarding

2GROWDissenyar estructura JSON per Coaching Notes

2GROWEscriure notes de prova per als 2 test users

2GROWDissenyar mini-enquesta setmanal

FASE 2 — Motor IA: el prompt

2GROWCrear prompt base amb regles d'entrenador

2GROWDefinir output JSON compatible amb act_days

2GROWTestejar amb dades reals de Matias i Jordi Navarro

DIEGOValidació dels plans generats

FASE 3 — Escenari end-to-end

2GROWMontar escenari complet a Make

2GROWExecutar flux complet per als 2 test users

DIEGOMatias i Jordi Navarro veuen el seu pla a l'app

Després del pilot: escalar a 310+ clients

ABANS vs DESPRÉS

SENSE AUTOMATITZACIÓ

AMB AUTOMATITZACIÓ IA

CONTROLS I LÍMITS

Pilot controlat

Diego supervisa

Límit API: 500 req/h

Rollback immediat

STACK TECNOLÒGIC

Virtuagym

FITBOX HUB

Claude / GPT

Make.com

COMENCEM PER AQUÍ

Connectar Make amb Virtuagym (api_key + club_secret)

Fer primer GET de Matias i Jordi Navarro per validar connexió

Descarregar catàleg d'exercicis (Activity Definitions)

Sessió amb Diego per definir preguntes d'onboarding

Crear el prompt IA i generar primers plans de prova

AUTOMATITZEM-HO?

PLANS D'ENTRENAMENT
GENERATS PER IA