# FINVESTOR 0.8.2 — Metodología financiera, supuestos y protocolo de verificación

**Versión de interfaz:** 0.8.2 · **Versión interna del motor/guardado:** 8 · **Fecha de revisión de fuentes:** 23 de septiembre de 2026.  
**Naturaleza:** simulador educativo ficticio, sin datos en tiempo real, sin asesoría personal, sin oferta de crédito, inversión o seguro, sin respaldo de las entidades citadas. La calibración histórica **no** constituye predicción de los rendimientos futuros. Esta documentación describe los principales cálculos de `engine.js` y los datos de `calibration.js` incluidos en el mismo paquete.

> **Nota de interfaz 0.8.2.** Esta revisión no modifica las fórmulas del motor. Corrige la conexión entre el dashboard y el estado de la partida: navegación lateral, ficha “Mi vida”, campos del resumen mensual, detalle de flujo, inversión, progreso y accesos al Centro financiero. Se conserva la clave de guardado `finvestor-game-v0.8` para que las partidas 0.8 continúen funcionando sin migración.


## 1. Convenciones y contabilidad

- Unidad temporal: **un mes**; moneda interna MXN nominales. Se redondean flujos/saldos monetarios a centavos al procesar movimientos; las tasas conservan decimales completos. Los movimientos de inversión/aportación se realizan al final del mes; el rendimiento del mes se aplica al saldo invertido al comienzo. No se incorporan impuestos sobre rendimientos, comisiones bursátiles, ni tipo de cambio USD/MXN.
- Patrimonio neto = efectivo + ahorro + valor de inversiones + valor de casa + valor de automóvil − saldo tarjeta − saldos de préstamo personal, automotriz e hipotecario. Las aportaciones y transferencias entre activos no constituyen ingresos ni gastos y por sí mismas no alteran el patrimonio.
- Presupuesto: `flujo = ingreso recibido − suma de gastos recurrentes − pagos de créditos y tarjeta`; `efectivo final = efectivo inicial + flujo − aportación al ahorro − aportación a inversión`. El motor no permite cerrar un mes con efectivo negativo; se pueden ajustar gastos, retirar ahorro/inversión, abonar o reconocer insolvencia. Ahorro mantenido separado **no genera rendimiento**.
- Horizonte: desde edad elegida (18–64) hasta cumplir 65. Nuevos préstamos no pueden vencer después del horizonte. Deudas **preexistentes** sí pueden tener plazo remanente posterior: se conservan y exhiben sus saldos al concluir. No se condonan ni se presupone venta forzosa de activos.

## 2. Renta variable calibrada históricamente

**Fuente:** Aswath Damodaran, [Historical Returns on Stocks, Bonds and Bills, actualización enero 2026](https://pages.stern.nyu.edu/adamodar/New_Home_Page/datafile/histretSP.html), columna *S&P 500 (includes dividends)*, 20 observaciones anuales 2006–2025. Datos de muestra en `calibration.js`:

`15.61, 5.48, −36.55, 25.94, 14.82, 2.10, 15.89, 32.15, 13.52, 1.38, 11.77, 21.61, −4.23, 31.21, 18.02, 28.47, −18.04, 26.06, 24.88, 17.78` (% anuales con dividendos).

Definimos `L_y = ln(1 + R_y)`, media de los veinte `μ_L = mean(L_y)` y desviación **muestral** `σ_L = sqrt(sum((L_y−μ_L)^2)/(20−1))`. Valores calculados: `μ_L ≈ 0.10349359`, `σ_L ≈ 0.17635918`; retorno anual geométrico `exp(μ_L)−1 ≈ 10.90 %`. Un mes se sortea:

`Z_m ~ N(0,1)` mediante Box–Muller con generador pseudoaleatorio reproducible y semilla por partida; `r_m = exp(μ_L/12 + (σ_L/sqrt(12))·Z_m)−1`.

`rendimiento monetario_m = round(saldo invertido inicial_m · r_m, 2)`; `saldo final_m = saldo inicial_m + rendimiento_m + aportación_m`. El resultado variable futuro **no se muestra antes de avanzar**; se presenta el resultado del mes ya cerrado y su tasa realizada. Un historial con la misma semilla y decisiones es reproducible; diferentes semillas producen trayectorias diferentes. **No es una reproducción histórica ni un Monte Carlo calibrado completamente:** independencia mensual, distribución lognormal, parámetros constantes y muestra corta de 20 años ignoran correlación temporal, colas pesadas, cambios de régimen, riesgo cambiario, comisiones y fiscalidad. No compara rendimientos del índice en USD contra un portafolio verdadero en MXN; los porcentajes del índice se aplican a saldos MXN solo como aproximación didáctica.

## 3. Renta fija: referencia CETES a 28 días, tasa cambiante

Fuente: [Banxico SIE, cuadro CF114, CETES 28 días](https://www.banxico.org.mx/SieInternet/consultarDirectorioInternetAction.do?accion=consultarCuadro&idCuadro=CF114). El dato **promedio de agosto 2026 es 6.21 % anual**. Es un punto de partida histórico, **no** una tasa en vivo, rendimiento ofrecido o compromiso de CETES Directo. Se usa interés simple mensual aproximado de 30/360: `r_f,m = tasa_anual_vigente · 30/360`, `interés = inversión inicial × r_f,m`.

La tasa evoluciona después de cada mes mediante el mecanismo **inventado para el juego**, NO la política monetaria real de Banxico:

`tasa_m+1 = limitar[2%,15%](tasa_m + 0.10·(0.0621−tasa_m) + 0.0025·Z_m)`.

`Z_m` es normal pseudoaleatoria reproducible derivada de otra secuencia de la semilla. Esta dinámica es reversión a la referencia, con perturbación mensual hipotética de 0.25 puntos porcentuales en desviación estándar; **no** fue estimada de datos de CETES ni pronostica las decisiones de Banxico. La tasa vigente se ve en la pantalla y también interviene en el medidor de libertad financiera. No se simula compra o vencimiento exacto cada 28 días, descuento, ISR ni reinversión real de los títulos.

## 4. Inflación histórica de México y estilo de vida

Fuente: Banco Mundial a través de [FRED, Inflation, consumer prices for Mexico, `FPCPITOTLZGMEX`](https://fred.stlouisfed.org/data/FPCPITOTLZGMEX). Se toma la variación anual del **IPC promedio anual**, para cada año 2006–2025 (20 observaciones; tasas íntegras en `calibration.js`). La tasa anual **geométrica** de los veinte factores de crecimiento es `π = exp(mean(ln(1+inflación_y)))−1 ≈ 4.4269517 %`. Esto no equivale a una serie del INPC diciembre contra diciembre. Inflación mensual equivalente: `(1+π)^(1/12)−1` (aprox. 0.3616 %).

Al finalizar cada mes, se multiplica por `(1 + inflación mensual)` cada rubro de **gastos recurrentes**: vivienda, servicios, alimentos, transporte, salud, educación, entretenimiento y otros; se redondea a centavos. **No** se incrementa automáticamente el salario; el jugador puede cambiarlo manualmente. Se mantiene índice general de precios acumulado, no índices diferenciados por rubro. Al comprar vivienda, la partida de renta se pone en cero y el jugador debe presupuestar mantenimiento por su cuenta. La valoración de la vivienda crece a la inflación por hipótesis ficticia, NO por observación inmobiliaria.

## 5. Crédito: tasa contractual ≠ CAT

Banxico define el **CAT** como un indicador de costo anual total usado para comparar financiamientos, considerando más que la tasa de interés. Por ello el motor **no aplica el CAT como tasa de interés mensual**. En cambio, utiliza tasas nominales orientativas de productos publicados, comisiones separadas y cargos simplificados; **no calcula un CAT específico verificable** de estos contratos ficticios. Referencias para órdenes de magnitud: [BBVA préstamo personal](https://www.bbva.mx/personas/productos/creditos/prestamos-personales/prestamo-personal-inmediato.html), [BBVA Start tarjeta](https://www.bbva.mx/personas/productos/tarjetas-de-credito/tarjeta-de-credito-start.html) [BBVA crédito automotriz](https://www.bbva.mx/personas/productos/creditos/comprar-auto-credito.html) y [BBVA Hipoteca Fija](https://www.bbva.mx/personas/productos/creditos/credito-hipotecario/hipoteca-fija.html). Los datos publicados pueden variar según el producto y fecha.

| Instrumento | Supuesto nominal anual | Cargos al contratar / mensuales | Observaciones |
|---|---:|---|---|
| Personal | 30 % | Comisión inicial 2.75 % del principal + 16 % de IVA sobre comisión | Un préstamo personal activo; monto 1,000 a 100,000 MXN y 12/24/36 meses. |
| Tarjeta ficticia | 82.9 % | Interés mensual nominal/12; **IVA ilustrativo de 16 % sobre interés total** | Línea de 30,000 MXN; IVA real tiene reglas para interés real que aquí NO se replican; sin gracia, corte ni saldo promedio diario. |
| Automóvil | 18.49 % | Comisión 3 % + IVA; seguro/cargo ficticio mensual de 0.1 % del valor del auto al comprar | Precio 30,000–2,000,000 MXN. |
| Hipoteca | 11.2 % | Comisión **ficticia** 1 % + IVA; seguro/cargo ficticio mensual 0.05 % del saldo inicial | Precio 200,000–20,000,000 MXN. |

Para cada préstamo amortizable: `i = tasa nominal anual / 12`; `PMT = P·i / [1−(1+i)^(−n)]`; `interés_m = saldo_anterior·i`; `pago_m = min(saldo + interés + cargo, máximo(importe configurado, pago contractual + cargo))`, salvo política *liquidar todo*. `capital_m = pago_m − interés_m − cargo`; `saldo_nuevo = saldo_anterior − capital_m`. Se redondean mensualidades e intereses, y el último pago se ajusta para liquidar el saldo. Los abonos extraordinarios se deducen de capital y mantienen la mensualidad original, acortando el plazo. Para créditos **ya existentes** (personal, automotriz e hipotecario), desde la versión 0.6 no se impone la tasa ficticia de los créditos nuevos. El usuario captura **saldo actual `P`, mensualidad actual `PMT` y meses restantes `n`**. El motor resuelve numéricamente la tasa mensual `i` que satisface `PMT = P·i/[1−(1+i)^(−n)]`; después reporta la tasa efectiva anual implícita `(1+i)^12−1`. Si `PMT = P/n`, la tasa estimada es 0 %. Si la mensualidad es inferior a `P/n`, no existe una tasa no negativa que amortice el saldo en ese plazo y se rechaza la captura. Esta es una **estimación all-in**: si la mensualidad real contiene seguros, comisiones u otros cargos, la tasa implícita los absorbe y puede sobreestimar la tasa contractual. No es CAT, no reconstruye el contrato original y no separa componentes no informados por el jugador.

Se puede elegir **mínimo**, **liquidar saldo total con intereses/cargos del próximo mes**, u **otro importe**; si el importe indicado es inferior al mínimo aplicable, se cobra automáticamente el mínimo. Los pagos están sujetos a liquidez; los rechaza si el efectivo de fin de mes sería negativo. Una regla **ficticia** de aprobación limita pagos mínimos proyectados de deuda al 40 % del salario declarado, sin verificar historial crediticio ni morosidad.

### Tarjeta y mínimo de la Circular 34/2010

Fuente normativa: [Banco de México, Circular 34/2010, numeral 4.1, página 15 del PDF](https://www.banxico.org.mx/marco-normativo/normativa-emitida-por-el-banco-de-mexico/circular-34-2010/%7B0C55B906-6DB4-6B88-FED0-67987E9FB3CC%7D.pdf). La norma establece, entre otras disposiciones, el mayor de `(1.5 % del saldo revolvente sin intereses ni IVA + intereses e IVA)` y `(1.25 % del límite de la línea)`, con tope al saldo insoluto revolvente. La emisora puede establecer un mínimo superior; no equivale al contrato particular de BBVA. Este es el **piso normativo modelado**, no un emulador bancario completo; saldo insoluto al corte, saldos promedio, operaciones a meses, interés real/IVA y fechas de pago no se reproducen.

Ejemplo con saldo 18,000, límite 30,000 y tasa nominal 82.9 % anual: interés del mes = 1,243.50; IVA ficticio = 198.96; alternativa A = 270 + 1,243.50 + 198.96 = **1,712.46**; alternativa B = 375; mínimo = **1,712.46**. Para saldo inferior al piso de 375, se aplica el tope a principal, por lo que pueden quedar intereses ilustrativos para el siguiente mes; el pago *liquidar todo* cubre saldo más intereses e IVA. No se aplican recargos por mora ni promociones sin intereses.

## 6. Activos: automóvil e inmueble

El jugador puede declarar desde el inicio una vivienda y automóvil usando su **valor de mercado actual** —no el precio de compra histórico— y, si están financiados, saldo, mensualidad actual y plazo restante; también puede comprar un bien de cada categoría durante la partida. `financiamiento = precio − enganche`; el enganche y la comisión se restan al efectivo, el precio se suma a activos y el saldo financiado se suma a pasivos. Comisiones reducen patrimonio de inmediato. Compra de contado utiliza plazo cero. Mientras se conserve un activo solo puede existir uno por categoría. Desde 0.6 puede venderse vivienda o automóvil con una regla de **liquidez inmediata al 90 % del valor de mercado actual**: `precio de venta = 0.90 × valor de mercado`; `efectivo neto = precio de venta − saldo de deuda`. Si el resultado es positivo, se acredita el neto a efectivo y se liquida el crédito; si es negativo, el jugador debe disponer de efectivo suficiente para cubrir la diferencia antes de vender. Después de vender, la categoría queda libre y puede adquirirse otro activo similar. En vivienda, el juego avisa que debe revisarse el gasto mensual de vivienda después de vender; no asigna una renta automáticamente. No se aplican impuestos de adquisición/venta, escrituración, comisiones de intermediación, penalizaciones de prepago, tenencia, predial u otros costos reales. Seguro mensual en créditos **nuevos** automotrices e hipotecarios es un supuesto ficticio, no una cotización; en créditos existentes la mensualidad indicada por el usuario se modela como pago total y no se agrega un seguro separado.

Valor mensual automóvil = valor anterior `× 0.88^(1/12)` (depreciación hipotética 12 % anual). Valor mensual vivienda = valor anterior `× (1 + π_m)` (revalorización hipotética equivalente a inflación; no es índice de casas). Estos cambios afectan patrimonio, NO dinero disponible.

## 7. Eventos aleatorios y desempleo

Cada cierre mensual simulado usa una probabilidad hipotética de `1/6` de disparar un evento: reparación (32 % condicional), bono (33 %) o desempleo (35 %) según los cortes en código. Las reparaciones cuestan entre 2,500 y 7,000 MXN en incrementos de 500; se pueden cubrir con efectivo, ahorros, tarjeta o aplazar con aumento ficticio del 10 % en el costo. Bonos entre 1,500 y 6,000 MXN. El desempleo dura `2 a 5 meses` según semilla, genera **salario cero durante esos meses** desde su confirmación; no simula indemnización, apoyos ni pérdida estructural de empleabilidad. Se evita emitir otro evento de desempleo cuando ya existe uno en curso. Toda probabilidad es **inventada y no calibrada a datos de empleo**. Evento pendiente detiene el avance automático hasta que se tome una decisión.

El generador determinista a partir de una semilla aleatoria de inicio permite replicar resultados para enseñanza; el jugador puede inspeccionar la semilla en el indicador de libertad financiera. **No es seguro frente a manipulación competitiva**: el JavaScript y `localStorage` del usuario son editables.

## 8. Libertad financiera: primer cumplimiento histórico

La condición del juego se define según la instrucción del proyecto: todos los activos ya **invertidos** se suponen reasignados hipotéticamente a CETES a la tasa anual simulada vigente. `rendimiento mensual hipotético = saldo invertido × tasa_CETES_anual × 30/360`. `compromisos = gastos recurrentes mensuales vigentes + pagos programados de todas las deudas del próximo mes`. `cobertura (%) = 100 × rendimiento_hipotético / compromisos`. Se alcanza al cubrir 100 % o más si compromisos > 0. `capital requerido = compromisos / tasa mensual`.

Se guarda `freedomFirstMonth` solo cuando la condición se cumple **por primera vez**, incluso si posteriormente deja de cumplirse por inflación, tasa, gasto o retiro. Puede registrarse desde mes cero si el usuario inicia con suficiente inversión. Un mes de alcance no garantiza sostenibilidad: faltan impuestos, reinversión, variaciones de rendimiento, inflación futura, riesgo de concentración y cambios en estilo de vida. Bienes raíz/auto no se consideran inversiones líquidas por defecto. El rendimiento hipotético no se deposita automáticamente en efectivo.

**Regla propuesta para concurso futuro:** escenarios iniciales, costos, parámetros, semilla y reglas idénticos; comparar primero meses hasta primer logro, documentar si la condición persiste 12 meses y el patrimonio neto final. La aplicación web actual NO cuenta con verificación de servidor, perfiles o ranking antifraude: ninguna clasificación pública puede considerarse validada todavía.

## 9. Capa de juego incorporada en 0.7

La versión 0.7 **no cambia las fórmulas financieras centrales de 0.6**: conserva las reglas de inversión, inflación, créditos, activos, eventos y libertad financiera documentadas arriba. El cambio principal es la capa de experiencia: pantalla de vida, turno mensual, retos lúdicos, logros y un centro financiero plegable. Estos elementos presentan el estado del mismo motor; no sustituyen ni recalculan la contabilidad.

Se incorporan dos modos de inicio. **Mi Vida** permite personalizar el punto de partida. **Desafío Clásico 2026-A** fija edad 22, efectivo 15,000 MXN, ingreso neto 18,000 MXN, presupuesto base, ausencia de activos/deudas y semilla pseudoaleatoria `20260923`. Esto hace reproducible la secuencia aleatoria si dos jugadores toman las mismas decisiones; todavía no existe verificación de servidor, por lo que no debe usarse como ranking antifraude. La ocupación es descriptiva en 0.7 y no altera automáticamente salario ni probabilidades.

Los **12 logros** son indicadores lúdicos persistentes en el guardado: patrimonio positivo, primera inversión, reservas de 3 y 6 meses, auto, vivienda, liquidación de deuda después de haber tenido alguna, umbrales patrimoniales de 100 mil/500 mil/1 millón MXN, cobertura de 50 % y primer registro de libertad financiera. Un logro no implica que una decisión real sea financieramente recomendable; solo marca que se cumplió una condición dentro del simulador.

## 10. Migración, datos y descargos

- Almacena la partida 0.8 localmente en el navegador bajo clave `finvestor-game-v0.8`; no requiere cuentas ni recopila identidad real. Borrar datos del navegador o usar otro dispositivo puede perder progreso.
- Una partida existente 0.7 se ofrece para **importación voluntaria**; el original queda intacto. Se conservan saldos, activos, deudas, tasas, semilla, historial y primer logro de libertad financiera. Al importarla se agrega la nueva capa visual y se inicializan los logros de 0.7 a partir del estado conservado. No se garantiza equivalencia competitiva entre versiones distintas; se debe distinguir a concursantes por versión.
- Importes, tasas, calificaciones de crédito, eventos, seguros, revalorizaciones y rendimientos son ficticios; datos históricos de índices son referencias citadas; esto no es consejo profesional, pronóstico, asesoría, contrato, cálculo tributario, simulador oficial ni servicio avalado por BBVA, Banxico, INEGI, FRED, S&P o CETES Directo.
- No se incluyen impuestos personales ISR, cálculo completo de IVA real sobre intereses, hipoteca deducible, CAT efectivo de un crédito ficticio, primas reales, comisiones futuras, morosidad, cancelación de contrato, crédito hipotecario en UDIS, construcción de cartera real diversificada ni cambios de tipo de cambio.

## 11. Verificación reproducible

Con Node.js instalado, en la carpeta del paquete ejecuta `node test-engine.cjs`. Las **58 pruebas automatizadas incluidas** comparan directamente fórmulas, monto mínimo, préstamos, tablas, conservación patrimonial, inflación mensual/acumulada, tasas aleatorias con semillas iguales y diferentes, libertad financiera, desempleo, activos iniciales, estimación inversa de tasas, créditos personales existentes, venta de activos con y sin deuda, equity negativo, recompra y deudas finales. **Las pruebas automatizadas no demuestran precisión predictiva ni cumplimiento normativo completo**. Además se ejecutó una prueba funcional de interfaz en Chromium headless para los modos Mi Vida y Desafío, apertura del centro financiero y navegación de un turno, sin errores JavaScript observados. El despliegue definitivo todavía debe validarse en Cloudflare.

Para descargar fuentes originales, usar los cuatro enlaces señalados arriba y las fichas actuales oficiales de los productos financieros; algunas fichas comerciales y tasas pueden modificarse con el tiempo. El paquete es un conjunto estático autocontenido para Cloudflare Pages, con `index.html` en la raíz del ZIP.


## Interfaz 0.8: navegación guiada

La versión 0.8 no modifica las fórmulas financieras de 0.7. Reorganiza la experiencia en cuatro pasos visibles: **Tu situación actual → Decide este mes → Revisa tu progreso → Próxima meta**. El Centro financiero conserva los desgloses, formularios, tablas de amortización y metodología avanzada.

La interfaz usa el logotipo SVG oficial proporcionado para Finvestor y el verde de marca `#689E80`. Los nuevos resúmenes mensuales son vistas derivadas del mismo estado del motor; no constituyen cálculos alternativos.


## Actualización 0.8.2: accesibilidad visual
Esta revisión no cambia las ecuaciones del motor financiero. Ajusta exclusivamente la presentación del dashboard: tipografías, espaciado, densidad de información y puntos de ruptura responsivos. La compatibilidad de guardado con 0.8/0.8.1 se mantiene.
