📐 Cálculo del RP

1. ¿Qué es el RP?

El RP (Rendimiento Personal) es una métrica única que se calcula para cada alumno y mide cuánto valor está generando en su evolución, combinando 4 dimensiones:

1. Lo que hace con el dinero — ingresar / ahorrar / donar / invertir
2. A qué edad lo está haciendo — más joven = más mérito
3. Qué hábitos y formación está construyendo — disciplina y conocimiento
4. Su comportamiento práctico — si realmente ejecuta acciones económicas

El resultado se expresa en euros equivalentes — un "valor monetizado" de toda su evolución.

2. Fórmula final

RP = (20 · DF · Gf)  +  (240 · C)
       └──────┬─────┘    └───┬───┘
         BLOQUE              BLOQUE
         DINERO            CERTIDUMBRE

Ambos bloques se suman, lo que significa que un alumno puede tener un RP elevado:

• Aunque genere poco dinero, si tiene mucha constancia y formación.
• O aunque esté flojo en hábitos, si genera dinero abundante de forma noble.

3. BLOQUE 1 — DINERO (DF)

3.1. Ponderadores del dinero (Db)

Db = DG + 2·DA + 3·DD + 4·DI

Lógica: se premia el "destino noble" del dinero. Invertir > donar > ahorrar > simplemente ingresar.

Ejemplo: si un alumno ingresa 100 € y los invierte enteros, Db = 100 + 0 + 0 + 400 = 500 puntos.
Si ingresa 100 € y se los gasta todos, Db = 100 puntos.

3.2. Factor edad (Ef)

Ef = 1 + 0.9 · max(0, 18 − edad)

Lógica: generar 100 € a los 10 años no equivale a hacerlo con 25. Cada año por debajo de 18 multiplica casi por 2 el mérito. Premia descomunalmente la juventud emprendedora.

3.3. Dinero final (DF)

DF = Db · Ef

Es lo que entra en la fórmula final, multiplicado por 20 y por Gf.

4. BLOQUE 2 — CERTIDUMBRE (C)

Mide el capital invisible del alumno: hábitos, formación, comunidad y ejecución.

4.1. G — Hábitos generales (factor multiplicador del dinero)

G  = (constanciaHabitos + progresoFormacion + participacionCom) / 3
Gf = (G / 100) · 0.151875

Lógica: Gf actúa como multiplicador del bloque dinero:

• Si G = 100% → Gf = 0.151875 (multiplica fuerte el dinero)
• Si G = 0% → Gf = 0 → el bloque dinero se anula completamente

4.2. Pilares individuales (cada uno cap a 1000)

Detalle de AP (suma de banderas si el alumno ha registrado algo):

• +400 si tiene alguna inversión
• +300 si tiene algún ingreso
• +200 si tiene alguna donación

C = H + S + K + 2·AP

Lógica de cada pilar:

• H → premia disciplina diaria
• S → premia que se exprese en comunidad (no aislamiento)
• K → premia formación + verificación (haber pasado quizzes)
• AP → premia que realmente ejecute acciones económicas en la vida real (no solo teorice). Por eso pondera doble ⭐

C tiene un máximo teórico de 5000 puntos (1000 + 1000 + 1000 + 2·1000).

5. Fórmula completa, paso a paso

DG = ingresos brutos
DA = max(0, ingresos − gastos)
DD = donaciones
DI = inversiones

Db = DG + 2·DA + 3·DD + 4·DI
Ef = 1 + 0.9 · max(0, 18 − edad)
DF = Db · Ef

constanciaHabitos = % hábitos cumplidos
progresoFormacion = % lecciones completadas
participacionCom  = min(100, mensajes · 5)
G  = (constanciaHabitos + progresoFormacion + participacionCom) / 3
Gf = (G / 100) · 0.151875

H  = min(1000, pctHabitos · 10)
S  = min(1000, mensajes · 20)
K  = min(1000, pctFormacion · 10)        // solo si hay quizzes pasados
AP = (DI > 0 ? 400 : 0) + (DG > 0 ? 300 : 0) + (DD > 0 ? 200 : 0)
C  = H + S + K + 2·AP

RP = (20 · DF · Gf) + (240 · C)

6. Ejemplo numérico

Alumno de 14 años que:

• Ingresó 200 € este mes
• Gastó 50 € → ahorró 150 €
• Invirtió 100 €
• No donó nada
• Cumple 80% de hábitos
• Lleva 60% de formación
• Escribió 10 mensajes en el foro
• Ha pasado algún quiz

Bloque Dinero:

• Db = 200 + 2·150 + 3·0 + 4·100 = 900
• Ef = 1 + 0.9·(18−14) = 4.6
• DF = 900 × 4.6 = 4140
• G = (80 + 60 + 50) / 3 = 63.3 → Gf = 0.0962
• Bloque dinero ≈ 20 × 4140 × 0.0962 ≈ 7.965 €

Bloque Certidumbre:

• H = min(1000, 80·10) = 800
• S = min(1000, 10·20) = 200
• K = min(1000, 60·10) = 600
• AP = 400 + 300 = 700
• C = 800 + 200 + 600 + 2·700 = 3000
• Bloque certidumbre = 240 × 3000 = 720.000

7. Análisis del peso real de cada bloque

7.1. Topes máximos teóricos

• Bloque Certidumbre: 240 · C con C máx = 5000 → tope = 1.200.000 €
• Bloque Dinero: 20 · DF · Gf, sin tope (depende del dinero real generado)

7.2. Peso por perfil de alumno

7.3. Punto de equilibrio (50/50)

20 · DF · 0.151875 = 240 · C
DF ≈ 79 · C

Si C está al máximo (5000), hace falta DF ≈ 395.000, lo cual implica movimientos económicos muy grandes (raros en alumnos jóvenes).

7.4. Conclusión sobre el peso

Además, el bloque dinero está "atado" a la certidumbre por Gf: sin hábitos ni formación, el bloque dinero se anula aunque el alumno haya generado millones.

8. Filosofía resumen — qué premia el RP y por qué

Resumen en una línea: El RP es ~90% certidumbre / ~10% dinero para la mayoría de alumnos, y el dinero solo se "activa" si hay hábitos detrás.

9. Dónde se usa el RP en la plataforma

1. pages/RPMetricas — desglose visual completo (Db, Ef, DF, G, H, S, K, AP, C y % de cada bloque).
2. components/dashboard/RPWidget — widget en el dashboard.
3. pages/Dashboard — calcula métricas financieras.
4. pages/Trackeador — recalcula RP en tiempo real con popups (PopupRPEnTiempoReal, PopupCambioRP).
5. Se guarda en cada RegistroEconomico (rp, erp, ahorrado) para histórico.
6. Componentes derivados: RPAhorroWidget, EvolucionChart, ModalObjetivoAlcanzado.

10. Puntos a revisar con el diseñador del algoritmo

1. Variable K (conocimiento): la fórmula implementada es K = min(1000, (qzOk / max(qzOk, 1)) · pctFormacion · 10). El término qzOk / max(qzOk, 1) siempre da 1 si hay algún quiz pasado y 0 si no, funcionando como un flag binario. ¿Es la intención o debería ser proporcional al ratio de aciertos?
2. Bloque dinero atado a Gf: si G = 0, todo el bloque dinero se anula. ¿Es deseado o se quiere un "suelo" mínimo?
3. Dominancia de la certidumbre: con las constantes actuales (20 vs 240), la certidumbre domina el RP en casi todos los casos reales. ¿Es la intención educativa o se busca más equilibrio?
4. Tope de participacionCom: se llega al 100% con solo 20 mensajes. ¿Está bien calibrado o se busca exigir más?
5. AP (aplicación práctica): son flags fijos. Un alumno que invierte 1 € obtiene los mismos 400 puntos que uno que invierte 10.000 €. ¿Está bien así o debería escalar?
6. Edad: se asume edad por defecto de 20 años si no está informada. Conviene comprobar que la edad real está disponible en el momento del cálculo.

11. Ubicación del código

• Cálculo central: components/lib/calcularRP.js
• Widget visual: components/dashboard/RPWidget.jsx
• Página de métricas: pages/RPMetricas.jsx
• Recálculo en tiempo real: pages/Trackeador.jsx