Guía

Lógica de usuario · lógica de datos · lógica de negocio

Este dashboard te permite hacer tres cosas: analizar fondos de inversión con métricas y gráficos, construir carteras optimizadas matemáticamente, y llevar el seguimiento de tu cartera personal real. Las nueve pestañas de arriba son las diferentes herramientas. Dos de ellas (Listas seguimiento y Carteras Gestionadas) son puntos de entrada independientes; las demás dependen de que primero hayas cargado datos en Listas seguimiento. Esta guía te explica exactamente cómo moverte, qué hace cada cosa y cómo se calculan los números.

Primeros pasos — tu primera sesión en 5 minutos

Acabas de abrir el dashboard por primera vez · qué hacer exactamente

Si quieres analizar fondos o construir una cartera

Ve a Listas seguimiento (primera pestaña, estará en gris)
En el campo de texto grande, escribe el ISIN del fondo que quieres analizar — es un código de 12 caracteres que encontrarás en la ficha del fondo. Ejemplo: LU2274224596. Si tienes varios fondos, escríbelos uno por línea
Selecciona el rango de fechas. Para empezar: últimos 3 años
Escribe los ISINs en el campo de texto. Si quieres buscar fondos por descripción, usa el chatbot 💬 — puedes decirle "busca fondos de renta fija europeos defensivos"
Selecciona las fechas y los indicadores técnicos en la columna derecha del mismo panel
Pulsa el botón naranja ⬇ Cargar datos — está en la columna izquierda (sidebar)
Espera unos segundos. Cuando la pestaña se ponga verde, los datos están listos
Ahora puedes ir a Análisis de Activos, Construir cartera, Predicciones o Sentimiento — todos tienen datos con los que trabajar
Si ya estás en una de esas pestañas y quieres cambiar a otra lista guardada, busca el texto "¿Analizar otra lista?" en la esquina superior derecha y pídele al bot 💬 — él te preguntará las fechas y confirmará antes de cargar

Si quieres ver o actualizar tu cartera personal

Ve directamente a Carteras Gestionadas — no necesitas pasar por Listas seguimiento
Si ya tienes fondos registrados, pulsa ↻ Actualizar VLs para refrescar todos los precios de una vez
La tabla se actualiza con los últimos valores publicados por cada gestora
Para registrar una compra, venta o traspaso: busca el panel Mantenimiento en la parte inferior de la página

En encert (EC2), el botón "Actualizar VLs" también funciona. Las peticiones se reenvían automáticamente al Mac local vía proxy SSH, que ejecuta los scrapers. Si el Mac está apagado o el túnel caído, verás un error 503 — enciende el Mac y vuelve a intentarlo.

Parte 1 — Lógica de usuario · cómo moverse por el dashboard

El mapa: qué hace cada pestaña

Orientación rápida · qué requiere cada sección para funcionar

Antes de usar cualquier herramienta, conviene saber qué hace cada pestaña y si necesita algo previo. Las pestañas con badge Sí — Load Data primero están vacías hasta que cargues datos en Listas seguimiento.

Pestaña	Para qué sirve	¿Necesita algo previo?
Listas seguimiento	Carga los precios históricos de los fondos o activos que quieres analizar. Es la puerta de entrada a todo el análisis	No — empieza aquí
Análisis de Activos	Métricas de rentabilidad y riesgo, gráficos con indicadores técnicos, matriz de correlaciones y frontera eficiente (Monte Carlo)	Sí — Load Data primero
Predicciones	Modelo estadístico que estima si cada fondo subirá o bajará en la próxima sesión, usando un ETF de referencia como guía	Sí — Load Data primero
Análisis de Sentimiento	Analiza el flujo de noticias de cada instrumento con inteligencia artificial y da una señal positiva / negativa / neutra	Sí — Load Data primero
Comparador	Vista comparativa lado a lado de todos los fondos cargados: rentabilidades por período y ratios de riesgo (Alpha, Beta, Sharpe, R², TE, Correlación, IR) frente a su benchmark, con ventanas de 12 m / 3 a / 5 a	Sí — Load Data primero
Construir cartera	Construye carteras optimizadas matemáticamente con los activos que cargaste. Seis métodos de optimización disponibles y Análisis Profundo IA por activo	Sí — Load Data primero
Carteras Gestionadas	Tu cartera personal real. Registra compras, ventas y traspasos. Calcula rentabilidad, beneficios y métricas personalizadas	No — autónoma
Métricas	Explicación detallada de todas las métricas, fórmulas y modelos del dashboard. Consulta cuando no entiendas un número	No
Guía	Esta página	No
Parámetros	Preferencias de la app: mostrar/ocultar tooltips, modo del bot (discreto / proactivo / sin bot) y pedir confirmación antes de actuar. Las preferencias se guardan en tu navegador	No

El semáforo de la pestaña Listas seguimiento

La pestaña principal cambia de color según el estado de la sesión. Mirarlo te dice de un vistazo si puedes trabajar con las herramientas de análisis:

gris No hay datos cargados. Las pestañas de análisis no tienen instrumentos con los que trabajar. Debes hacer Load Data primero
verde Datos cargados y disponibles. Todas las pestañas de análisis están activas y listas
naranja Pestaña actualmente activa (la que estás viendo en este momento)

Regla práctica: si ves la pestaña Listas seguimiento en verde, puedes moverte libremente por el resto del dashboard sin hacer nada más. Si la ves en gris, empieza por ahí.

Los dos grandes flujos de trabajo

Sesión de análisis vs. seguimiento de cartera personal

Flujo A — Analizar fondos y construir carteras

Todo empieza en Listas seguimiento. Sin ese primer paso, las cuatro pestañas de análisis están vacías. Una vez cargados los datos, puedes moverte entre ellas en cualquier orden — los datos se mantienen disponibles durante toda la sesión.

1. Listas seguimiento → Load Data → 2. Análisis de Activos → 3. Predicciones → 4. Sentimiento → 5. Carteras → optimizar

Flujo B — Seguimiento de tu cartera personal

Carteras Gestionadas es completamente autónoma. No necesita Load Data, no comparte datos con el resto del dashboard, y sus datos se guardan en disco de forma permanente. Puedes acceder directamente desde cualquier página.

Ejercicios cerrados: al llegar el VL del 31 de diciembre de cada fondo, el sistema genera automáticamente un snapshot del ejercicio cerrado (ej: 2026). Aparece un desplegable junto al título "Carteras Gestionadas" para consultar ejercicios anteriores. En modo ejercicio cerrado la pantalla es de solo lectura — se muestran todos los fondos que existieron durante ese año (incluidos dados de baja) con todos sus movimientos, pero no se puede modificar nada. Útil para seguimiento fiscal y control de plusvalías latentes.

Scroll horizontal en la tabla de fondos: la tabla tiene scroll horizontal (estilo Excel) tanto en móvil como en desktop. La columna Fondo queda fija a la izquierda mientras desplazas las demás, para que siempre veas a qué fondo corresponde cada cifra.

1. Carteras Gestionadas → 2. ↻ Actualizar VLs → 3. Revisar métricas → Hecho

Escenarios habituales

Quiero analizar un fondo nuevo antes de comprarlo

Ve a Listas seguimiento → escribe el ISIN del fondo en el campo de tickers o búscalo con lenguaje natural (ej: "fondos de renta fija europea con baja duración")
Pulsa ⬇ Load Data
Ve a Análisis de Activos → revisa la evolución histórica, las métricas de riesgo y cómo se correlaciona con fondos que ya tienes
Ve a Predicciones → asigna un ETF de referencia y lanza el modelo para ver la señal de dirección (también puedes pedirle al chatbot que asigne el proxy directamente)
Si convence, ve a Construir cartera → optimiza la combinación con tu cartera actual

Quiero registrar un traspaso entre fondos

Ve a Carteras Gestionadas → panel Mantenimiento (parte inferior de la página)
Activa tanto Origen como Destino
Si tienes el PDF de Santander Private Banking, arrástralo sobre la zona de drop — se rellena solo
Si no tienes PDF: selecciona el fondo de origen (el que vendes), introduce los títulos y el VL de venta; luego el fondo de destino (el que compras) con sus datos
Pulsa ↔ Registrar operación

Quiero comparar varias carteras posibles

Listas seguimiento → carga todos los fondos que quieres comparar
Carteras → construye la primera cartera con el modo que prefieras → Guardar con nombre
Cambia el modo de optimización o los parámetros → construye de nuevo → guarda con otro nombre
Compara los resultados guardados en el panel izquierdo de Carteras

Guía pestaña a pestaña — Listas seguimiento

El punto de entrada · qué hacer aquí y en qué orden

¿Qué sucede cuando pulsas Load Data?

El botón naranja ⬇ Load Data descarga los precios históricos de todos los fondos introducidos desde Yahoo Finance. El proceso tiene dos fases: primero descarga los precios (5–30 s), y después — si Benchmark está en ON — resuelve el ETF de referencia de cada instrumento y calcula los indicadores β/α/R²/TE/Corr/IR (puede tardar hasta un minuto en la primera carga, instantáneo después gracias a la caché). Las pestañas de análisis permanecen bloqueadas hasta que ambas fases terminan. Cuando todo está listo, la pestaña se pone verde.

Coherencia con Carteras Gestionadas. Si uno de los fondos cargados también está en tu Carteras Gestionadas, el último valor de su serie se reusa directamente del VL más reciente de Carteras Gestionadas en lugar de pedirlo a fuentes externas. Es la misma fuente, pero ya validada y actualizada por ti — así el mismo fondo muestra exactamente el mismo VL en Listas seguimiento, Análisis de Activos, Predicciones, Construir cartera y Carteras Gestionadas.

Load Data borra los datos anteriores. Si ya tenías datos cargados de una sesión previa y pulsas Load Data de nuevo, la sesión anterior desaparece y empieza una nueva. Guarda los resultados importantes antes de recargar.

Cómo introducir los instrumentos

En el campo de texto grande escribe los identificadores de los instrumentos, uno por línea. No hace falta saber el ticker exacto: el sistema resuelve el nombre en tiempo real mientras escribes.

ISIN — lo más fiable para fondos de inversión. Código de 12 caracteres que encontrarás en la ficha del fondo. Ejemplos: LU2274224596, FR0128537232
Ticker de bolsa — para acciones e índices. Ejemplos: AAPL, ^GSPC (S&P 500), ^STOXX50E (EuroStoxx 50)
Divisas — Ejemplos: EURUSD=X, GBPEUR=X
Materias primas — Ejemplos: GC=F (oro), CL=F (petróleo WTI)

¿Qué es un proxy? Un target es el fondo que quieres analizar. Un proxy es un ETF que añades como referencia de mercado para el modelo de Predicciones — por ejemplo, si analizas un fondo de bolsa americana, el proxy podría ser SPY. Si marcas un instrumento como proxy en la watchlist, el optimizador de Carteras lo excluirá automáticamente de los pesos finales.

Dashboard Carteras Gestionadas

El panel principal de Listas seguimiento incluye un resumen en tiempo real de tu cartera personal con tres filas de métricas:

Fila 1: Total cartera €, Beneficio año €, Rentabilidad año %, XIRR medio
Fila 2: Mayor beneficio absoluto (clicable), Mayor pérdida absoluta (clicable), Beneficio esperado fin de año, Importe esperado fin de año
Fila 3: Máx. rentabilidad año % (clicable), Mayor drawdown (clicable), Señal del fondo con peor XIRR (Mantener / Vigilar / Reducir / Vender), Variación hoy €

El botón ↻ VLs en la cabecera del panel actualiza los valores liquidativos de todos tus fondos (igual que el botón de Carteras Gestionadas) y refresca el dashboard. Al abrir la página, el dashboard se carga sin actualizar VLs para que sea rápido. Cada fondo en la lista de tickers resueltos muestra también su fuente de datos (etiqueta pequeña a la derecha del porcentaje de peso) y el peso % aparece junto al alias, no al extremo de la fila.

Gestores: si tienes clientes asignados, verás un desplegable en la cabecera del Dashboard. Selecciona un cliente para ver sus métricas en el panel. El botón ↻ VLs también actúa sobre la cartera del cliente seleccionado. Para volver a tu propia cartera, elige Mi cartera en el desplegable.

Listas de Seguimiento — tus listas guardadas

El panel izquierdo muestra las Listas de Seguimiento. Son listas de tickers con nombre que se guardan en disco y persisten entre sesiones — no desaparecen al cerrar el navegador. En lugar de reescribir los mismos ISINs cada día, seleccionas la lista y pulsas Load Data.

Para guardar la lista actual: escribe un nombre en "Nombre lista de seguimiento…" y pulsa el botón de guardar
Para actualizar una lista existente: selecciónala, modifica los tickers y pulsa 💾 en "Modificaciones lista activa"
La lista Carteras Gestionadas se sincroniza automáticamente con los fondos activos de tu cartera personal — nunca la edites a mano
El chatbot puede crear, editar, renombrar y borrar listas de seguimiento por ti — pídele que lo haga directamente

Pesos de cartera

Junto a cada fondo resuelto aparece un campo % editable con el peso que ese instrumento representa en la cartera. Por defecto se reparte a igual peso entre todos los instrumentos. Puedes modificar cualquier peso manualmente — el indicador Σ pesos debajo de la lista muestra la suma total en verde (si suma 100%) o rojo (si no).

Los pesos viajan con el botón ⬇ Cargar datos y afectan al cálculo de la Cartera Ponderada en todas las pestañas de análisis: la línea de cartera en los gráficos, las métricas agregadas y la posición del portfolio en la Frontera Eficiente reflejarán tus pesos reales, no la media simple.

Carteras Gestionadas y pesos automáticos: al hacer clic en la lista "Carteras Gestionadas", los pesos se calculan automáticamente a partir del importe actual de cada fondo en tu cartera — proporcional al dinero invertido. Puedes ajustarlos después si lo necesitas.

Persistencia de pesos: los pesos se guardan por lista de seguimiento en el servidor — si los editas y pulsas 💾 Guardar cambios en la lista activa, viajan contigo entre dispositivos y sobreviven a limpiar caché del navegador. Si ajustas los pesos de una lista sin guardarlos, se mantienen como caché local hasta el siguiente guardado. El botón Limpiar borra los pesos en caché del navegador (los pesos guardados en el servidor permanecen). El tiempo de carga aparece junto al recuento en el sidebar (ej: ✓ 8 instrumentos cargados · 14s).

Búsqueda por descripción en lenguaje natural

Si no sabes el ISIN de un fondo, describe lo que buscas en la caja de texto de la derecha. Ejemplo: "fondos de renta fija europea de corta duración con baja volatilidad". El sistema consulta Morningstar a través de inteligencia artificial y añade los ISINs encontrados al campo de tickers automáticamente.

Rango de fechas — cuánta historia cargar

Menos de 1 año: insuficiente para el modelo de Predicciones. Los resultados de Carteras y Analytics son poco robustos
1–2 años: mínimo razonable. Funciona para análisis básico
2–4 años (recomendado): incluye diferentes ciclos de mercado. Predicciones más fiables, matrices de correlación más estables
Más de 5 años: útil para análisis histórico largo, pero ralentiza la carga con muchos instrumentos

Indicadores técnicos

Los indicadores que quieres ver en los gráficos de Análisis de Activos se seleccionan aquí, antes de cargar. Disponibles: RSI, MACD, Bollinger Bands, SMA 20/50, Fibonacci, Soporte/Resistencia, Fractales de Williams, Ondas de Elliott. Una vez seleccionados, pulsa Load Data y aparecerán en cada gráfico.

Botón Benchmark ON / OFF

El botón Benchmark ON controla si los indicadores de benchmark (β, α, R², Tracking Error, Correlación, IR) se pre-calculan durante la carga o se calculan al entrar en Análisis de Activos. En ON (por defecto), el sistema resuelve el ETF de referencia de cada instrumento y calcula las métricas mientras cargan los precios — puede tardar hasta un minuto en caché fría, pero al entrar en Análisis todo está listo al instante. En OFF, la carga de datos es inmediata y las métricas se calculan en el momento de entrar en Análisis de Activos (algo más lento en esa primera visita).

Cuándo desactivarlo: si quieres empezar a ver rentabilidades y gráficos técnicos sin esperar al pre-cálculo de benchmarks. Las métricas β/α/R²/TE/Corr/IR seguirán apareciendo, pero se cargarán al abrir Análisis en lugar de estar pre-calculadas. La preferencia se guarda entre sesiones.

Guía pestaña a pestaña — Carteras Gestionadas

Tu cartera personal real · completamente autónoma · datos permanentes

Dar de alta un fondo nuevo

En el panel Mantenimiento (parte inferior de la página), desactiva Origen (desmarca el checkbox de la izquierda)
En Destino, selecciona "Nuevo instrumento" en el desplegable
Escribe el ISIN en el campo de resolución → espera a que aparezca el nombre del fondo
Introduce el número de títulos (participaciones), el importe total en euros, el VL de la compra y la fecha
Pulsa ↔ Registrar operación

Formato de números: usa notación europea. Punto como separador de miles, coma como decimal. Ejemplos: 6.300,823 títulos — 48.250,00 euros — 128,80 VL. Si introduces el importe y los títulos, el sistema calcula el VL solo (o viceversa).

Estado de una operación: Confirmado vs. Previo

Cada operación registrada puede tener dos estados:

Confirmado: la operación es definitiva y se tiene en cuenta en todos los cálculos de rentabilidad, titulación y XIRR. Es el estado por defecto
Previo: la operación está pendiente de confirmación (por ejemplo, un traspaso en curso que aún no ha llegado a destino). Se almacena en el historial pero puede marcarse para distinguirla visualmente de las operaciones ejecutadas

Cuándo usar "Previo": cuando el banco confirma la orden de traspaso pero los títulos del fondo destino aún no aparecen en cartera. Así mantienes el registro sin que la operación parcial distorsione las métricas.

Importar PDFs de Santander Private Banking

Si operas con Santander Private Banking, puedes arrastrar los PDFs de traspaso directamente sobre la zona de drop (encima de cada columna). El sistema detecta automáticamente si el PDF es de venta (Emitido) o de compra (Recibido) y rellena todos los campos.

Flujo típico con PDF: arrastra el PDF de emisión sobre Origen → arrastra el PDF de recepción sobre Destino → verifica los datos → pulsa Registrar operación. Todo en menos de un minuto.

El asesor puede hacer todas las operaciones por ti

Desde el chat 💬 puedes pedir cualquier operación de mantenimiento: alta de fondo nuevo, aportación adicional a uno existente, venta parcial, cierre total, traspaso entre fondos o actualizar todos los VLs. El asesor te irá pidiendo los datos necesarios (fecha, importes, títulos) — el VL lo calcula él (importe ÷ títulos). Por seguridad, antes de tocar nada aplica una doble verificación inviolable: primero un resumen de la operación con tu confirmación verbal, después rellena el panel Mantenimiento para que veas los datos en pantalla y vuelve a pedirte OK, y solo entonces ejecuta. Esta doble verificación NO se puede desactivar — ni siquiera si tienes "Pedir confirmación antes de actuar" en OFF — porque aquí hay dinero real.

Actualizar los Valores Liquidativos (VL)

El botón ↻ Actualizar VLs lanza los scrapers automáticos para cada gestora (AzValor, Jupiter, Schroders…) y actualiza el precio de todos los fondos activos de una sola vez. Al terminar, cada fila se colorea: verde = actualizado correctamente, naranja = el scraper principal falló pero se obtuvo el VL de fuente alternativa, rojo = no se pudo obtener el VL. El botón "A" al final de cada fila hace lo mismo pero solo para ese fondo. Tanto en local como en encert (EC2) el botón está disponible — en EC2, la petición se reenvía al Mac local vía proxy, que ejecuta los scrapers. El VL de AzValor Internacional se obtiene comparando la API propia de azvalor.com y ycharts.com: gana la fuente con fecha más reciente; en caso de empate, siempre prima la gestora. Cuando azvalor.com publica tarde, ycharts adelanta el VL del día anterior.

En EC2, la actualización de VLs requiere que el Mac esté encendido y el túnel SSH activo. Si el Mac está apagado, la llamada devuelve un error 503. Los scrapers Playwright corren siempre en el Mac local, nunca en el servidor.

Generar Informe PDF

El botón 📄 Informe en la cabecera de Carteras Gestionadas genera un informe de 2 páginas estilo consultoría (McKinsey/BCG) con diseño corporativo navy y gold.

Cómo funciona:

Pulsa "📄 Informe" → se abre un modal con selector de período.
Elige el período con los botones rápidos (YTD, último trimestre, este trimestre, último año) o introduce fechas libres.
Pulsa "Generar preview" — el sistema clasifica tus fondos por clase de activo, genera los gráficos SVG y redacta el comentario de gestión con IA (~20 segundos).
Puedes editar libremente el comentario de gestión generado antes de descargarlo.
Pulsa "Imprimir / Guardar PDF" en la barra superior del informe para obtener el PDF.

Contenido del informe (2 páginas):

Pág. 1: cabecera oscura con nombre y período, banda KPI (plusvalía neta, patrimonio total, nº posiciones), gráfico SVG de evolución del patrimonio con gradiente navy, donut de composición con etiquetas de porcentaje, tabla de distribución por clase de activo.
Pág. 2: tabla completa de posiciones (compacta, con badges de clase y barras de porcentaje), operaciones del período, comentario de gestión redactado por IA en 2 columnas (editable directamente en el navegador).

Los gráficos se generan como SVG puros en el servidor — no dependen de JavaScript ni Chart.js, lo que garantiza que se imprimen correctamente sin problemas de renderizado.

La clasificación de fondos por clase de activo (Tesorería, Renta Fija, Mixtos/Retorno Absoluto, Renta Variable, Alternativos) la hace la IA automáticamente en base al nombre e ISIN de cada fondo.

El informe funciona también desde EC2: obtiene los datos del Mac local vía proxy (túnel SSH). Si el Mac está apagado o el túnel caído, aparecerá un error 503 al generar el preview.

Fondos dados de baja

Los fondos que has dado de baja aparecen en la tabla con el símbolo ⊘ delante del nombre y con menor opacidad. El botón "Ocultar bajas" en la cabecera del panel los esconde de la vista; vuelve a pulsarlo ("Mostrar bajas") para verlos de nuevo.

Ver el historial de operaciones de un fondo

Haz clic en cualquier fila de la tabla para expandir el historial de compras, ventas y traspasos de ese fondo. Desde ahí puedes editar o eliminar operaciones individuales. El botón para borrar el fondo completo también está aquí (en la cabecera del panel expandido), no en la tabla principal — así se evitan borrados accidentales.

La columna "Proyectado %" y "Benef. proy. fin año €"

El sistema proyecta el beneficio estimado a 31 de diciembre. La fórmula cambia según el año:

2026 (primer año): extrapolación lineal del beneficio total acumulado. Fórmula: beneficio_YTD ÷ días_transcurridos × días_en_el_año. Se usa el total de la cartera (no fondo a fondo) para evitar que las posiciones cerradas distorsionen la media.
2027 en adelante: proyección basada en el XIRR individual de cada fondo activo. Fórmula: beneficio_YTD + Σ(importe_actual × XIRR × fracción_restante_año). Solo se incluyen fondos con VL del año en curso.

Es una proyección matemática, no una previsión garantizada — cambia con cada actualización de VLs. El porcentaje proyectado se calcula sobre el importe a inicio de año.

Columnas "Benef. mes €", "Benef. trim. €" y "Benef. sem. €"

Junto a Benef. año € aparecen tres columnas con la variación de cada fondo por período en curso, todas por fecha del sistema:

Benef. mes €: diferencia entre el importe actual del fondo y el importe al cierre del mes anterior.
Benef. trim. €: diferencia respecto al cierre del trimestre anterior (31-mar / 30-jun / 30-sep / 31-dic).
Benef. sem. €: diferencia respecto al cierre del semestre anterior (30-jun / 31-dic).

La fila TOTAL agrega cada período sobre el historial de totales (no por suma de fondos), exactamente igual que las cajas equivalentes del Resumen Total.

Por qué algunas celdas muestran "—": cada columna necesita el snapshot del cierre del período anterior. En 2026, como la app arrancó en abril, faltan los snapshots de referencia anteriores a esa fecha — por eso Benef. trim. y Benef. sem. salen "—" para todos los fondos hasta julio 2026 (cuando se cierre Q2 / S1). Benef. mes funciona desde el primer cierre de mes completo. A partir de 2027 todos los períodos quedan operativos al cerrar cada uno.

Ver el historial de valores pasados (gráfico)

Haz clic derecho sobre cualquier celda de Imp. actual € o Benef. año € para ver un popup con los valores de esa celda en cada fecha de actualización anterior. Navega con las flechas ‹ › o con las teclas ← → del teclado. Cierra con Escape o haciendo clic fuera.

Mi Fiscalidad — plusvalías latentes

La pestaña Mi Fiscalidad (junto a "Mi Cartera" en la cabecera) muestra las plusvalías latentes de cada fondo activo, desglosadas en dos tramos fiscales:

Plusv. < 1 año: ganancia no realizada sobre posiciones con antigüedad inferior a un año (tributación en base general)
Plusv. > 1 año: ganancia no realizada sobre posiciones con más de un año de antigüedad (tributación en base del ahorro)

📥 Importar Excel del banco: botón en la cabecera de la caja "Plusvalías Latentes". Sube el informe fiscal del banco (Santander, formato .xls) → el sistema parsea las dos secciones (Latentes Inferior a 1 año y Latentes Superior a 1 año), matchea cada fondo del informe con tu cartera por nombre (admite truncamientos típicos del banco), muestra una vista previa con diff (actual vs nuevo + número de lotes nuevos) y al pulsar "Aplicar" actualiza las plusvalías y guarda el detalle FIFO completo. Antes de escribir se crea un backup automático del inversion.json.

Detalle FIFO por fondo: tras importar, cada fila con lotes muestra un indicador ▾ N. Click en la fila → popup con cada lote (fecha de adquisición, antigüedad, títulos, V. Adquisición €, V. Transmisión €, G/P €). Útil para decidir qué fondo vender minimizando coste fiscal.

Columnas extra de decisión:

% plusv / importe: qué porcentaje del valor del fondo es plusvalía latente. Cuanto menor, menos impuesto pagas en proporción al venderlo.
Coste fiscal estim.: plusvalía total × tipo IRPF ahorro configurado en Parámetros (default 23 %). Te da una pista de cuánto Hacienda se llevaría si materializas la ganancia.

Edición manual: sigue disponible el icono ✏ por si necesitas ajustar plusvalías a mano sin importar Excel.

Traspasos — herencia automática: cuando registras un traspaso entre fondos en el panel Mantenimiento, el sistema transfiere automáticamente la plusvalía del fondo origen al fondo destino de forma proporcional:

Traspaso total → toda la plusvalía pasa al nuevo fondo
Traspaso parcial → se transfiere la parte proporcional a los títulos traspasados

Por qué es útil: en España los traspasos entre fondos son neutros fiscalmente — la plusvalía "viaja" al fondo destino. Esta pestaña refleja exactamente eso, de forma que en todo momento sabes en qué fondo tienes acumulada la ganancia latente y en qué tramo fiscal cae.

Cadencia recomendada: pide el informe al banco cada vez que hagas una compra, venta o traspaso (y al menos cada 6 meses) — así la pestaña refleja la verdad fiscal del banco con todos sus lotes FIFO.

Gestores: el desplegable de cliente en la cabecera de Mi Fiscalidad permite ver la situación fiscal de cada cliente por separado.

Guía pestaña a pestaña — Construir cartera

Optimizador matemático · análisis profundo IA por activo · necesita Load Data previo

El flujo obligatorio

Sin datos cargados la pestaña no tiene instrumentos con los que trabajar. El orden siempre es:

Listas seguimiento → Load Data → Construir cartera → Elegir modo de optimización → Construir cartera (botón)

Los 6 modos de optimización — cuándo usar cada uno

Mín. Varianza: cartera con menor volatilidad posible. No necesita estimaciones de rentabilidad — solo usa cómo se mueven juntos los activos. Úsalo cuando quieres el menor riesgo posible y no tienes convicción sobre qué va a subir más. El slider de volatilidad no aplica.
Var. Objetivo: marcas un nivel de riesgo en el slider y el optimizador construye la cartera más cercana a ese número. Úsalo cuando tienes un perfil de riesgo concreto en mente.
Máx. Sharpe: mejor relación rentabilidad/riesgo. Por cada punto de riesgo, maximiza lo que ganas. El modo más equilibrado para horizonte largo. El slider de volatilidad no aplica.
Máx. Rendimiento: maximiza la rentabilidad esperada sin superar el nivel del slider. Úsalo cuando tu tolerancia al riesgo es alta y quieres aprovechar las señales direccionales de Predicciones.
Máx. Diversificación: maximiza el beneficio de que los activos no se muevan juntos. Úsalo cuando el objetivo es la diversificación estructural. El slider de volatilidad no aplica.
Máx. Sortino: como Máx. Sharpe pero solo penaliza la volatilidad bajista — los días en los que la cartera sube no cuentan como "riesgo". Úsalo cuando te preocupan especialmente las caídas. El slider de volatilidad no aplica.

Parámetros — importe, volatilidad objetivo y restricciones

Importe a invertir (€): tu capital disponible. Si lo introduces, los resultados muestran cuántos euros asignar a cada posición además del peso %
Volatilidad objetivo (%): nivel de riesgo anualizado deseado. Solo aplica en Var. Objetivo y Máx. Rendimiento. Referencias: ≤5% conservadora · ~10% moderada · ~17% dinámica · ≥22% agresiva
Peso mínimo por activo (%): porcentaje mínimo que el optimizador asignará a cualquier activo incluido. Evita posiciones insignificantes
Peso máximo por activo (%): tope que un solo activo puede recibir. Limita la concentración
Número de posiciones (mín–máx): rango de activos que la cartera final puede incluir. El optimizador elige la mejor combinación dentro de ese rango

Tasa libre de riesgo

Es la rentabilidad anual de un activo sin riesgo (típicamente Letras del Tesoro a corto plazo) y se usa en Sharpe, Sortino y Kelly. Default 2 %. Si los tipos de referencia suben, sube el valor — un Sharpe medido con tasa libre 2 % en un entorno del 4 % sobreestima el atractivo del activo. Aplica solo a esa corrida de la optimización; el resto de la app sigue usando el default global del servidor.

Retorno esperado por señal — rango mín/máx

En los modos que usan retornos esperados (Máx. Sharpe, Máx. Rendimiento, Máx. Sortino), el optimizador convierte las señales del modelo de Predicciones en retornos esperados anualizados, mapeando el rango definido por estos dos inputs.

Importante: el modelo no predice rentabilidades directamente — predice probabilidades de subida (P) entre 0 % y 100 %. El optimizador transforma esa probabilidad en un retorno esperado anualizado mediante interpolación lineal entre el mínimo y el máximo que tú defines:

R = R_mín + P · (R_máx − R_mín), con P expresado en fracción (0 a 1)

Ejemplos con R_mín = −5 % y R_máx = +20 % (rango = 25 %):

P = 0 % → R = −5 + 0 · 25 = −5 %
P = 50 % → R = −5 + 0,5 · 25 = 7,5 %
P = 80 % → R = −5 + 0,8 · 25 = 15 %
P = 100 % → R = −5 + 1 · 25 = 20 %

Con esos retornos esperados (uno por activo), el optimizador construye después la cartera de Máx. Sharpe, Máx. Rendimiento o Máx. Sortino. Cambiar el rango permite calibrar cuánto pesa la convicción direccional en la optimización: un rango más amplio (p.ej. −10 % / +30 %) hace que las predicciones influyan más; uno más estrecho (p.ej. 0 % / +10 %) atenúa su efecto.

Override manual por fondo: si tienes convicción personal sobre un activo concreto, puedes sobrescribir su retorno esperado individualmente (fila por fila en la lista de activos) y el optimizador lo usará tal cual en vez del valor mapeado.

Método de retornos y método de covarianza

Método de retornos — Logarítmicos vs Simples: los logarítmicos tienen mejores propiedades matemáticas (son aditivos en el tiempo y casi simétricos en torno a 0). Si no tienes preferencia, deja Logarítmicos. Los Simples son más intuitivos para períodos cortos
Método de covarianza — Estándar / Robusta / EWMA: cómo se estima la relación de riesgo entre activos. Estándar: media histórica simple. Robusta: reduce el efecto de outliers (winsorización) — buena en mercados con crashes. EWMA: da más peso a los datos recientes (λ≈0,94) — buena cuando la volatilidad cambia con el tiempo

Cómo leer los resultados

Pesos (%): qué porcentaje de tu capital iría a cada fondo
Importe (€): si introdujiste el capital, muestra los euros a asignar a cada posición
Contribución al Riesgo (RC %): cuánto del riesgo total aporta cada activo. Un fondo con peso 5% pero RC 20% concentra demasiado riesgo en relación con su peso — replantear si vale la pena
Frontera Eficiente: la curva muestra todas las carteras posibles. El punto marcado es la tuya. Hacia la izquierda = menos riesgo; hacia la derecha = más retorno esperado a costa de más riesgo

Escala del gráfico: los botones Lin · Log · √ sobre el gráfico cambian la escala del eje. Lin es la habitual. Log es útil cuando hay diferencias muy grandes entre los activos. √ (raíz cuadrada) comprime los extremos sin llegar a logarítmica.

Quitar un activo de la cartera optimizada

En la tabla de composición, cada fila tiene una × a la izquierda. Pulsarla quita ese activo de la sesión y reoptimiza al instante con el resto. No toca tu lista guardada en Listas seguimiento — solo la sesión actual.

Guardar, cargar y borrar carteras

Tras construir una cartera, en el panel "Guardar esta cartera" escribe un nombre y pulsa Guardar — queda almacenada en disco con todos sus pesos, importe y parámetros. Las carteras guardadas se listan en el panel lateral con dos botones por fila: Cargar (reconstruye los pesos en la pantalla actual) y × (borra la cartera).

Cargar una cartera desde Listas seguimiento: si pides al bot "carga la cartera Conservadora", rellena el textarea de Listas seguimiento con los activos de esa cartera para que puedas reanalizar el conjunto.

Clear — empezar de cero

El botón Clear junto a "Construir cartera" limpia la cartera actual de la pantalla y permite empezar de nuevo sin tocar tus listas guardadas ni los datos de sesión.

Análisis Profundo por IA

El botón Análisis profundo → en la cabecera de "Composición de la cartera" abre un selector con dos pasos: eliges el activo a analizar y un toggle, y pulsas Generar informe →. El sistema produce un informe completo por activo con score de inversión 0–10, tabla de rentabilidades trimestrales vs. benchmark, catalizadores positivos y riesgos, análisis de noticias recientes, y un veredicto Comprar / Mantener / Reducir. Botón ↓ PDF para descargar y ✕ Cerrar para volver a la cartera.

Requiere clave de Anthropic configurada en el archivo .env. Si no está configurada, el botón no aparece.

El asesor puede configurar la pestaña entera

Desde el chat 💬 puedes pedir cualquier ajuste en lenguaje natural: importe, volatilidad objetivo, modo de optimización, pesos mín/máx, número de posiciones, tasa libre de riesgo, rangos de retorno por señal, retornos esperados por fondo, método de retornos y covarianza. Ejemplos: "pon 250.000 € y entre 5 y 8 fondos", "cambia a covarianza robusta", "máximo 4 posiciones", "limpia la pestaña". Tras construir, también puedes pedirle "pon 40% en AzValor, 35% en Carmignac y 25% en Man Dynamic" y aplica esos pesos en vivo (sin reoptimizar), siempre que sumen 100% e incluyan a todos los activos visibles.

Guía pestaña a pestaña — Análisis de Activos

Métricas · gráficos · correlaciones · frontera eficiente

Lo que encontrarás

Period Performance: rentabilidades en múltiples períodos (ayer, semana, mes, 3 meses, 6 meses, año hasta hoy, 1 año). Primer vistazo rápido al comportamiento de cada instrumento
Evolución indexada (base 100): todos los fondos normalizados desde el mismo punto de partida. Permite comparar quién ha subido más independientemente del precio de cada participación
Gráfico individual por activo: precio histórico con los indicadores técnicos que elegiste al cargar, más métricas clave de riesgo (volatilidad, Sharpe, Beta, Alpha, R², Tracking Error). Las definiciones de estas métricas están en el Glosario
Matriz de correlación: tabla de colores que muestra cómo de sincronizados están los movimientos de los fondos entre sí. Verde = se mueven poco juntos (buena diversificación). Rojo = se mueven igual (diversificación reducida)
Snowflake: gráfico radar de 5 ejes normalizados a una escala 0–10 que compara visualmente los activos cargados. Las cinco dimensiones son: Rentabilidad (retorno total del período, mayor = mejor), Riesgo (inverso de la volatilidad anualizada, menor volatilidad = mayor puntuación), Consistencia (ratio de Sharpe), Correlación (inverso de la correlación con el benchmark — menor correlación = más independiente = mayor puntuación; requiere benchmark cargado) y Máx. Drawdown (inverso de la caída máxima — caídas más suaves = mayor puntuación). Cuanto más "extendido" hacia fuera esté el polígono de un activo, mejor combinación de las cinco dimensiones. Se activa con el botón Mostrar del panel
Tabla de datos: precios históricos completos con botón de descarga en CSV
Frontera Eficiente: panel bajo demanda (botón "Calcular"). Simula 3.000 carteras aleatorias con todos los instrumentos cargados — incluyendo el ETF benchmark si lo hay — y muestra cuáles ofrecen el mayor retorno esperado para cada nivel de riesgo. Tres puntos especiales destacados: Igual Peso, Mínima Varianza (la cartera menos volátil posible) y Máximo Sharpe (la mejor relación retorno/riesgo). Bajo el gráfico aparecen los pesos de cada instrumento para cada uno de estos tres puntos óptimos. Se necesitan al menos 2 instrumentos cargados

Guía pestaña a pestaña — Comparador

Vista comparativa lado a lado · una tabla, todos los fondos de la sesión

Qué hace

Pone todos los fondos cargados en sesión uno al lado del otro en una sola tabla, con sus rentabilidades por período y sus ratios de riesgo frente a un benchmark. Útil cuando ya los has analizado por separado en Análisis de Activos y quieres ver de un vistazo cuál se comporta mejor en cada métrica.

Requiere Load Data primero. Si no hay sesión activa, la página muestra "Carga datos en Listas seguimiento primero. El Comparador necesita una sesión activa." Los fondos que aparecen son exactamente los que cargaste en la última sesión.

Cómo se lee la tabla

Una columna por fondo. Cada columna lleva en cabecera el nombre del fondo y, debajo, su benchmark resuelto automáticamente durante Load Data — el ETF de referencia que la app usa para calcular Alpha, Beta, R², Tracking Error, Correlación e IR. Cada fondo tiene su propio benchmark, no se usa uno común a toda la tabla.

Las cifras positivas salen en ▲ verde, las negativas en ▼ rojo y las nulas en ◆ neutro
R² y Correlación se muestran sin signo — son siempre positivos
Máxima caída sale siempre como porcentaje negativo
Las celdas sin dato disponible muestran "—"

Bloque 1 — Rentabilidades

Ocho filas con la rentabilidad de cada fondo por período:

YTD · Mensual · Trimestral · 6 meses · Un año
Tres años * · Cinco años * · Diez años * — los tres marcados con asterisco están anualizados y expresados en euros (nota al pie de la tabla)

Bloque 2 — Principales ratios

Nueve filas con los ratios de riesgo frente al benchmark de cada fondo: Volatilidad, Máxima caída, Alpha, Beta, Ratio de Sharpe, R², Tracking Error, Correlación y Ratio de información. Encima del bloque hay tres pestañas para elegir la ventana temporal: 12 meses · 3 años · 5 años. Cambia la pestaña y las nueve filas se recalculan para esa ventana.

Por qué ventanas y no "todo el histórico": el comportamiento de un fondo cambia con el tiempo. Comparar Sharpe a 12 meses con Sharpe a 5 años te dice si el fondo está mejorando o empeorando, y si los ratios "buenos" son recientes o consistentes en el largo plazo.

Sustituir el benchmark de un fondo

En la cabecera de cada columna hay una caja editable con el ticker del benchmark. Escribe otro ticker y pulsa Enter para sustituirlo — los ratios del bloque 2 se recalculan al instante con ese nuevo benchmark. Mientras el override está activo, el nombre legible bajo la caja aparece en color acento. Para volver al benchmark automático, pulsa el botón ✕ a la derecha de la caja.

Cuándo usar el override: cuando el benchmark automático no representa bien el fondo (categoría Morningstar demasiado genérica, o un ETF que no replica con precisión). Probar manualmente otro ETF más afín suele dar R² más alto y ratios más fiables.

Quitar un fondo de la sesión

El botón × en la esquina superior derecha de cada columna quita ese fondo de la sesión actual sin tocar la lista guardada en Listas seguimiento. Útil para comparar solo un subconjunto sin recargar. El cambio se sincroniza con el resto de pestañas — al volver a Análisis de Activos, Predicciones o Construir cartera, ese fondo ya no estará.

El asesor también puede hacerlo. Si le pides al bot "quita el fondo X del comparador" o "saca X de la sesión", lanza la misma acción y la tabla se refresca al momento sin que tengas que cambiar de pestaña.

Guía pestaña a pestaña — Análisis de Sentimiento

FinBERT · noticias · señal positiva / negativa / neutra por instrumento

Qué hace exactamente

Para cada instrumento cargado, el sistema busca noticias recientes en NewsAPI, Finnhub, Google News, Funds People y Funds Europe. Luego analiza cada titular con FinBERT, un modelo de inteligencia artificial entrenado específicamente en textos financieros (no es un modelo genérico como ChatGPT — fue entrenado solo con artículos del sector). El resultado es una etiqueta Positivo / Negativo / Neutro con un score numérico de convicción.

Cómo usarlo paso a paso

Elige cuántos artículos por instrumento. 3–5 es rápido (menos de un minuto); 15–20 es más representativo pero puede tardar varios minutos
Pulsa ▶ Analizar — el proceso corre en segundo plano, verás el progreso en tiempo real
Los resultados aparecen ordenados: los más positivos arriba, los más negativos abajo
Haz clic en una tarjeta para expandirla y ver los titulares individuales con su score

Cómo interpretarlo: el sentimiento es contexto, no una señal de trading aislada. Un fondo con sentimiento muy negativo puede estar barato y ser una oportunidad; uno con sentimiento positivo puede estar sobrecomprado. Úsalo como una capa adicional de información combinada con Analytics y Predicciones.

El asesor te puede lanzar el análisis. Pídele "analiza las noticias" o "lanza el sentimiento". Antes de ejecutar te preguntará siempre cuántos artículos por instrumento quieres usar (te mostrará el valor actual). Si le dices un número entre 3 y 30, lo ajusta y lanza. Si le dices "déjalo así", lanza con el valor que esté configurado. El valor que dejes seleccionado en el input persiste entre sesiones.

Primera ejecución: el modelo FinBERT pesa aproximadamente 2,4 GB y se descarga automáticamente la primera vez. Puede tardar varios minutos. A partir de entonces queda en caché local y las ejecuciones siguientes son inmediatas.

Guía pestaña a pestaña — Predicciones

Modelo estadístico · señal UP / DOWN / Neutral · proxies ETF

La idea central: por qué necesita un ETF de referencia

Los fondos de inversión publican su precio una vez al día, a veces con un día de retraso. Eso hace muy difícil detectar señales en tiempo real. La solución: buscar un ETF de referencia (proxy) que se comporte de forma similar al fondo — los ETF cotizan en tiempo real, con precios cada segundo. El modelo aprende la relación entre el ETF y el fondo, y cuando el ETF sube o baja hoy, el modelo puede estimar qué hará el fondo mañana.

Paso a paso: primera vez con un fondo nuevo

Entra en Predicciones con datos cargados — verás la tabla con todos los fondos cargados
Para cada fondo, pulsa el botón 🔍 — el sistema buscará automáticamente el mejor ETF proxy disponible. Puede tardar 15–20 segundos por fondo
Verás un badge R² que indica cuánto explica ese proxy al fondo. Verde ≥ 0,20 · Naranja ≥ 0,05 · Gris = muy bajo. Si el R² es bajo, prueba otro proxy escribiéndolo manualmente
Una vez asignado el proxy, pulsa el botón ▶ para lanzar el modelo y ver la señal

Los chips de sugerencia que aparecen bajo el campo de proxy (para fondos con ISIN) están basados en la composición real del fondo extraída de su ficha técnica PDF. Son el mejor punto de partida antes de lanzar la búsqueda automática completa.

Cómo leer la señal

Señal UP: en situaciones similares a la de hoy, el fondo subió más del 60% de las veces históricamente
Señal DOWN: en situaciones similares a la de hoy, el fondo bajó más del 60% de las veces históricamente
Neutral: el modelo no tiene convicción suficiente para inclinarse en ninguna dirección

Limitación importante: esto es un modelo estadístico basado en correlaciones históricas, no una predicción garantizada. Una precisión del 55% significa que acertó la dirección el 55% de las veces en el pasado — mejor que el azar, pero lejos de ser infalible. Úsalo como una señal más, no como una orden de compra.

El parámetro "Días de adelanto"

El slider de días (lag) controla si el proxy de hoy predice el fondo de hoy (lag = 0) o el fondo de dentro de N días (lag = N). Algunos fondos reaccionan con un día de retraso a su mercado de referencia porque publican el VL al día siguiente. Si el R² con lag = 0 es bajo, prueba lag = 1 ó 2.

Panel "Componentes del fondo" — predicción Multi-feature

Bajo la tabla principal hay un segundo panel que funciona de forma diferente al modelo de proxy único. En lugar de usar un solo ETF de referencia, este panel usa todos los instrumentos cargados a la vez como variables explicativas (features) simultáneas. Selecciona el fondo que quieres predecir como "instrumento objetivo" y pulsa ▶ — el modelo analiza cómo se mueven conjuntamente el resto de fondos cargados y extrae la señal de dirección.

R² modelo: proporción de la varianza del fondo objetivo explicada por el modelo. 0 = el modelo no explica nada; 1 = predicción perfecta. En la práctica, valores ≥ 0,15 son útiles (verde), 0,05–0,15 aceptables (naranja), < 0,05 insuficientes (gris). Un R² alto no garantiza que la señal sea rentable, pero indica que el modelo ha encontrado una relación estadística robusta
WF Acc (Walk-Forward Accuracy): precisión de dirección medida con validación walk-forward. El modelo se entrena en el pasado y se evalúa en el siguiente período sin ver el futuro — repitiendo el proceso en ventanas deslizantes. Es el indicador más fiable de cómo se habría comportado el modelo en condiciones reales. ≥ 60% = bueno (verde); 50–60% = moderado (naranja); < 50% = malo (rojo)
Quintiles: el modelo divide la distribución histórica de scores en 5 tramos iguales. Para cada tramo muestra el porcentaje de veces que el fondo subió (P(Up)). El quintil activo (marcado con ◄) es donde cae el score de hoy — su P(Up) es la base de la señal UP / DOWN / Neutral. Si el score de hoy cae en un quintil con P(Up) > 60%, la señal es UP; < 40%, DOWN; entre ambos, Neutral

Cuándo usar cada panel: el panel de proxy único (columna derecha al pulsar ▶ en la tabla) es más rápido e interpretable — sabes exactamente qué ETF está guiando la señal. El panel de Componentes es más potente cuando tienes varios fondos relacionados cargados — puede capturar información que un solo proxy perdería. Compara ambas señales antes de tomar una decisión.

ATG/claude — predicción combinada del día (panel Componentes)

Cuando los días de adelanto están en 0 y la watchlist activa lleva pesos guardados, el panel Componentes del fondo muestra cuatro cajas en lugar de la señal única:

Ridge — el modelo estadístico clásico de la pestaña (regresión regularizada con todos los componentes y los retornos pasados del propio fondo)
Correlación — variación del mismo día de cada componente que ya ha publicado, ponderada por su correlación con el fondo y por su peso de cartera. Aplica un factor de amortiguación calibrado para esa lista sobre los últimos 60 días donde el fondo publicó (el motor exagera la magnitud porque las acciones individuales son más volátiles que el fondo diversificado, y la calibración lo corrige)
Martingala — apuesta a la vuelta de la tendencia cuando la racha actual de retornos del fondo iguala o supera el récord histórico. Días sin dato heredan el signo del día previo
ATG/claude — mezcla ponderada de los tres motores (25% Ridge / 60% Correlación / 15% Martingala base). La martingala se modula por la confianza del Ridge: cuando el Ridge está indeciso (P(Up) cerca del 50%) la martingala entra con todo su peso; cuando el Ridge da señal contundente, la martingala se anula y su peso se redistribuye a los otros dos. Esta es la señal del día que debes leer; las otras tres están para que veas de dónde viene

Solo con días de adelanto = 0. Si subes el stepper a 1, 2 o más, las cajas de Correlación, Martingala y ATG/claude desaparecen y vuelves a ver solo Ridge — los motores de correlación y martingala usan información del día actual, no tienen sentido proyectados a futuro. Para horizontes mayores el modelo Ridge sigue siendo la única señal disponible.

Utilidad práctica. En fondos la señal tiene valor diagnóstico pero limitado para operar — los VL publican con retraso (T+1 o T+2) y no se pueden vender al momento. El verdadero potencial está en ETFs que cotizan en tiempo real: la infraestructura está preparada para aplicarla ahí cuando trabajemos con ETFs.

El asistente de IA — cómo usarlo

Chat integrado · disponible en todas las pestañas · Claude Sonnet 4.6

Asesor proactivo al entrar sin datos cargados

Cuando entras en Listas seguimiento sin ningún dato cargado, el panel de chat se abre automáticamente y saluda según la franja horaria. Si tu respuesta es vaga, te pregunta si quieres ayuda para construir una cartera. Si prefieres explorar solo, el panel se cierra. Si quieres ayuda, describe con tus propias palabras qué buscas (objetivo, horizonte, riesgo): el bot busca fondos en Morningstar, te presenta opciones y cuando confirmes arranca la carga y navega a Análisis de Activos automáticamente.

Tour guiado completo: el bot te lleva de pestaña en pestaña sin que tengas que navegar manualmente. En cada pantalla resume lo más relevante y pregunta si quieres continuar. En Predicciones selecciona el instrumento y lanza el modelo por ti — solo tienes que decirle los resultados que ves en pantalla. En Sentimiento clasifica cada fondo explícitamente como Positivo, Negativo o Neutro (con aviso de confianza baja si hay pocas noticias). En Construir cartera selecciona el modo óptimo según el contexto y lanza la optimización automáticamente. Al terminar te pregunta si estás satisfecho, quieres ajustar algún fondo o prefieres reiniciar el ciclo completo.

Qué es y cómo invocarlo

El botón 💬 en la esquina inferior derecha abre un asistente conversacional disponible en todas las pestañas. Se invoca manualmente — simplemente haz clic en él cuando lo necesites. El panel es arrastrable: si tapa algo, cógelo por la barra superior y muévelo.

Qué puede hacer

Ver y analizar tu cartera desde cualquier pestaña: el bot conoce siempre el resumen de tu cartera (fondos activos, total, beneficio del año, XIRR) sin importar en qué pestaña estés. En Carteras Gestionadas además accede al detalle completo de cada fondo, las últimas operaciones y la tendencia de los últimos 7 días
Analizar métricas de la sesión: en Análisis de Activos sabe la volatilidad, Sharpe, MDD, beta y alpha de cada instrumento cargado. En Predicciones conoce los proxies asignados y las señales UP/DOWN. En Sentimiento ve los resultados de la última ejecución. Los instrumentos cargados en sesión también son visibles en cualquier pestaña
Consultar APIs en tiempo real: cuando necesita datos que no están en el contexto actual, el bot los busca él solo — sin que tengas que pedírselo. Puede buscar información de cualquier fondo por ISIN, descubrir fondos en Morningstar, encontrar ETFs proxy para un fondo concreto y consultar estadísticas históricas de ETFs por ticker. Simplemente pregúntale y él decide si necesita consultar algo externo
Explicar métricas con detalle: pregúntale qué es el Sharpe, la beta, el XIRR, el MDD, el Tracking Error o cualquier otro indicador — te lo explica en contexto con tus datos reales. Si preguntas "¿cómo funciona X?" accede a la guía de usuario completa para responderte con precisión
Guiarte paso a paso por cualquier flujo: "¿cómo cargo datos?", "¿cómo optimizo una cartera?", "¿qué hace exactamente el modo Máximo Sharpe?" — el bot consulta la guía de usuario internamente y te da una respuesta completa sin que tengas que buscarla tú
Ayudar a buscar fondos (Discovery guiado): si le describes lo que buscas, te hace hasta 4 preguntas para afinar (tipo de activo, región, riesgo, estilo) y luego lanza la búsqueda en Morningstar directamente. Si un fondo te interesa, puede darlo de alta en Carteras Gestionadas en el mismo flujo
Comparar dos fondos: dile los dos ISINs y te muestra categoría, gestora, benchmark y divisa de ambos lado a lado
Simular el crecimiento de una inversión: dile el fondo, el importe inicial y el horizonte en años. El bot calcula tres escenarios (pesimista, base, optimista) con interés compuesto y evolución año a año. Si el fondo está en Carteras Gestionadas, usa su rentabilidad histórica como referencia base; si no, usa la que tú le indiques
Sugerir un rebalanceo: dile cómo quieres que quede distribuida tu cartera (ej: "40% AzValor, 60% Carmignac") y el bot calcula exactamente cuánto hay que comprar o vender de cada fondo en euros para llegar a esa distribución. Solo análisis — no ejecuta ninguna operación
Simular el impacto de una aportación: dile cuánto quieres aportar (y opcionalmente a qué fondos) y el bot muestra cómo quedaría la distribución de tu cartera antes y después. Si no especificas a qué fondos, distribuye proporcionalmente al peso actual
Ver correlaciones entre activos: si tienes una sesión de análisis activa (datos cargados en Listas seguimiento), el bot puede mostrarte la matriz de correlaciones entre los instrumentos y explicar qué significa cada par
Comparar escenarios de cambio de cartera: pregúntale "¿fue buena decisión vender X, Y, Z y comprar A, B, C?" o "¿habría ganado más si no hubiera movido la cartera?". El bot calcula en euros cuánto vale hoy el escenario real (los fondos que compraste) frente al escenario contrafactual (si hubieras mantenido los fondos originales), y te da la diferencia directamente. No necesita que le aportes títulos ni importes — los extrae de tus operaciones registradas en Carteras Gestionadas. Si algún fondo dado de baja no tiene el NAV actualizado, pulsa primero el botón ↻ Bajas en Carteras Gestionadas para obtener el resultado exacto
Ver el historial de operaciones de un fondo: pregúntale "¿cuándo compré AzValor y a qué precio?", "¿cuántos títulos netos tengo de Carmignac 2029?" o "¿cuál ha sido mi coste medio en este fondo?". El bot accede al historial completo de flujos con títulos, importes y NAV de cada operación
Ver la evolución histórica de un fondo o de la cartera completa: pregúntale "¿cómo ha ido mi cartera este mes?", "¿cuándo estaba en máximos?", "¿cuánto ha caído AzValor desde su máximo en cartera?". El bot consulta hasta 90 snapshots diarios por fondo y del total agregado
Buscar noticias sobre un fondo o mercado: pregúntale "¿qué está pasando con Carmignac?", "¿hay noticias sobre renta fija emergente?", "dame contexto sobre Man Dynamic Income". No necesitas tener datos cargados — funciona en cualquier pestaña en cualquier momento
Análisis combinado automático: el bot cruza información de varias pestañas sin que se lo pidas. Si un fondo tiene señal bajista en Predicciones y también pérdidas en Carteras Gestionadas, lo menciona junto. Si la cartera lleva semanas bajando y hay noticias negativas en los fondos implicados, los conecta en una sola respuesta
Dar de alta un fondo en Carteras Gestionadas: dile el ISIN, los títulos, el importe y la fecha — calcula el VL él solo y rellena el formulario de alta completo
Registrar una venta parcial en Carteras Gestionadas: dile el ISIN, los títulos vendidos, el importe y la fecha — rellena el formulario de venta
Registrar una baja (cierre total) en Carteras Gestionadas: dile el ISIN y el importe de reembolso total — rellena el formulario de cierre de posición completo
Gestionar carteras guardadas: en la pestaña Construir cartera, tras construir una cartera, puede guardarla con un nombre ("guarda esta cartera como Conservadora"). En Listas seguimiento puede cargar una cartera guardada ("carga la cartera Conservadora"), lo que rellena el campo de tickers con los activos de esa cartera
Configurar y lanzar la optimización en Construir cartera: el asesor puede cambiar todos los parámetros de la pestaña desde el chat — importe a invertir, volatilidad objetivo, modo de optimización, peso mínimo y máximo por activo, tasa libre de riesgo, rango de retorno esperado por señal, retorno esperado por fondo, método de retornos (logarítmicos o simples), método de covarianza (estándar, robusta o EWMA), y rango de número de posiciones. Pídeselo en lenguaje natural: "pon 250.000 € y entre 5 y 8 fondos", "cambia a covarianza robusta", "déjame solo 4 posiciones máximo". También puede limpiar todos los parámetros con "limpia la pestaña" o "empieza de cero"
Gestionar proxies y lanzar Predicciones: el asesor puede asignar un proxy a un fondo ("pon el IVLU como proxy de mi AzValor"), pedirle que busque el mejor automáticamente ("búscame el mejor proxy para el Carmignac"), borrarlo a petición tuya ("quita el proxy de X"), o cambiar los días de adelanto sin lanzar la predicción ("prueba con 2 días de retraso en X"). El asesor también puede aconsejarte que borres un proxy si detecta que tiene un R² bajo, pero siempre te pedirá confirmación antes. Para lanzar la predicción, simplemente pídeselo y elige modo "proxy único" o "componentes del fondo"
Controlar Listas seguimiento entero desde el chat: esto es clave en modo Bot (pantalla oculta) porque sin estas acciones no tendrías cómo cambiar nada de la pestaña. El asesor puede cargar tickers sueltos con fechas concretas ("carga IE… y LU… desde 2024 hasta hoy"), limpiar la pestaña ("empieza de cero"), cambiar fechas, activar o desactivar el Benchmark, añadir/quitar indicadores técnicos (RSI, MACD, Bollinger, SMA, Fibonacci, Williams, Soporte/Resistencia, Elliott), cambiar los parámetros de cada indicador (períodos, multiplicadores), cambiar la filosofía del score técnico (Momentum o Mean reversion), cambiar los pesos del score, y asignar pesos por activo. Pídeselo en lenguaje natural: "pon RSI período 21 y MACD 8/21/5", "cambia el score a mean reversion con pesos 25/25/25/25"
Ajustar pesos a mano sobre una cartera ya construida: tras lanzar la optimización, puedes pedirle "pon 40% en AzValor, 35% en Carmignac y 25% en Man Dynamic" y aplicará esos pesos en vivo — la tabla, las tarjetas de resumen y el gráfico se actualizan al instante, sin volver a optimizar. Exige que le digas los pesos de todos los activos visibles y que sumen 100 %

Qué puede consultar en tiempo real (ejemplos)

"¿Qué categoría y benchmark tiene el fondo con ISIN LU1333146287?" — el bot consulta la metadata directamente
"Busca fondos de renta fija high yield europeos con baja volatilidad" — lanza la búsqueda en Morningstar y te devuelve opciones con ISIN y gestora
"¿Qué ETFs puedo usar como proxy para el AzValor Internacional?" — busca candidatos por composición, categoría e índice replicado
"¿Cómo ha ido el CSPX.LSE en el último año? ¿qué volatilidad tiene?" — consulta el historial de precios y calcula las estadísticas
"Si pongo 50.000€ en el AzValor durante 10 años al 8% anual, ¿cuánto tendré?" — calcula 3 escenarios con interés compuesto
"Quiero que mi cartera quede 50% AzValor, 30% Carmignac, 20% Man Dynamic. ¿Qué tengo que comprar o vender?" — calcula el rebalanceo en euros
"¿Cómo funciona el modo Máxima Diversificación del optimizador?" — consulta la guía interna y te explica en detalle
"¿Por qué aparece "—" en la columna Q1 de mi cartera?" — te explica las reglas de disponibilidad trimestral
"¿Habría ganado más si hubiera mantenido el Man GLG en lugar de pasarme al Carmignac?" — compara el valor hipotético del fondo en baja con el valor actual del fondo activo. Requiere pulsar ↻ Bajas primero para tener el VL actualizado

Qué NO hace

Nunca inventa ISINs, nombres de fondos ni cifras financieras — si no sabe algo, lo busca en las APIs o te dice que no hay datos disponibles
No ejecuta ninguna acción (alta, venta, baja, rebalanceo) sin pedirte confirmación previa
Las simulaciones de inversión, rebalanceo, aportaciones y comparativas de bajas son de solo lectura — el bot no toca tu cartera real, solo muestra el análisis
Las consultas a APIs externas pueden tardar 15-40 segundos — es normal. Mientras el bot consulta datos, aparece un indicador en cursiva ("Buscando fondos…", "Consultando datos del fondo…"). Espera a que desaparezca antes de escribir otro mensaje
Si la búsqueda supera el tiempo límite, el bot sugiere cómo reformular la consulta para que sea más rápida (ej: sin restricción de estrellas, región más concreta)

Historial y ciclo de vida

El chat recuerda la conversación mientras navegas entre pestañas — el historial vive en el servidor y se restaura al cambiar de tab. Sobrevive a Load Data, así que la fase previa de búsqueda y elección de fondos también se conserva. Solo se borra en dos casos: cuando pulsas el botón Clear o cuando cierras el navegador.

Guardar la conversación como PDF

Si quieres conservar lo que has hablado con el asistente, dile en lenguaje natural "guárdame la conversación", "descárgame el chat en PDF" o "exporta esto". Se abre una pestaña nueva con la conversación formateada y el diálogo de impresión del navegador, donde eliges Guardar como PDF. El PDF captura toda la conversación de la sesión actual, desde la primera interacción con el bot hasta la última — incluida la fase previa a Load Data y aunque haya habido un reinicio del servidor por medio. Cuando cierras el navegador o pulsas Clear, el historial desaparece del servidor sin dejar rastro.

El bot opera desde la pestaña donde estés

Le puedes pedir al asistente acciones que afectan a Listas seguimiento (buscar fondos, cargar datos) desde cualquier pestaña sin que te mueva. Si haces "buscame fondos x" desde Comparador o Predicciones, el bot encuentra los fondos y los deja preparados en el textarea de Listas seguimiento — los verás en cuanto vuelvas allí. Si pides "carga estos datos", el bot lanza la carga directamente y al terminar refresca la pestaña en la que estabas para que veas los nuevos datos en su contexto. No tienes que ir a Listas seguimiento manualmente para nada.

Cuándo esperar antes de ir a otras pestañas

Cuando el asistente lanza una búsqueda de fondos y los añade al campo de tickers, el botón Load Data arranca la descarga. Las pestañas de análisis (Análisis de Activos, Predicciones, Sentimiento) permanecen bloqueadas hasta que tanto los precios como los indicadores de benchmark estén completamente calculados. La pestaña Listas seguimiento se pone en verde cuando todo está listo.

Consejo: puedes preguntarle sobre tu cartera desde cualquier pestaña — "¿cuánto llevo ganado este año?" funciona aunque estés en Análisis de Activos. Y si encuentras un fondo en el discovery, dile "ese me interesa" para añadirlo a Carteras Gestionadas directamente. Para el rebalanceo, simulaciones y gestión de carteras guardadas, el bot accede a Carteras Gestionadas desde cualquier pestaña en modo solo lectura.

Bot autónomo — análisis nocturno y alertas

Monitorización sin intervención · alertas en el chat · Claude Sonnet 4.6

Qué hace

El bot autónomo analiza tu cartera en segundo plano y te avisa cuando detecta algo relevante. A diferencia del chat (que se invoca manualmente), el bot actúa por su cuenta en cuatro situaciones:

Cada noche a las 00:00 (Madrid): actualiza todos los VLs, calcula métricas, detecta anomalías y genera un resumen en lenguaje natural
Tras cargar datos (Load Data): analiza el estado de tu cartera en el contexto de los instrumentos que acabas de cargar
Tras actualizar VLs (↻ Actualizar VLs): revisa los resultados del scraper y detecta fondos sin precio del día
Tras registrar una operación: confirma que la operación es coherente y revisa el estado de la cartera resultante

Cómo te llegan las alertas

Las alertas aparecen automáticamente en el panel del chat 💬. Si tienes alertas sin leer, el botón muestra un contador rojo. La primera vez del día el panel se abre solo; las siguientes veces del mismo día solo muestra el badge sin abrir el panel. Las alertas sobreviven al cierre del navegador y al reinicio del servidor — se guardan en disco.

Qué detecta

Errores (rojos): XIRR imposible (<−100% o >500%), importe negativo en fondo activo, discrepancia entre suma de fondos y total, fondo sin VL registrado
Avisos (ámbar): VL sin actualizar desde hace 4+ días hábiles, beneficio anual no calculado, fondo en baja con pérdida significativa (>20%), VL obtenido de fuente alternativa
Informativos (solo nocturno): variación diaria inusual (>3× la media histórica), combinación de señal DOWN con pérdidas, proyección anual extrema

Qué no hace

El bot nunca sugiere comprar, vender ni rebalancear — solo informa. Tampoco analiza las pestañas de Predicciones, Analytics o Sentimiento por su cuenta (solo las menciona si están activas en la sesión). Las alertas son siempre sobre Carteras Gestionadas.

Desactivar temporalmente

Si necesitas desactivar el bot (por ejemplo durante una migración de datos), el administrador puede añadir AUTONOMOUS_AGENT_DISABLED=1 al fichero de entorno del servidor. Al quitarlo, el bot retoma el ciclo nocturno en la siguiente medianoche.

Guía pestaña a pestaña — Métricas

Glosario de fondos · fórmulas y casos de uso · sin sesión necesaria

Para qué sirve

Es la referencia de consulta cuando no entiendes un número o un concepto que aparece en otra pestaña. Cada métrica tiene su propia tarjeta con: definición, interpretación, ejemplo numérico y fórmula. No necesita Load Data — puedes abrirla cuando quieras.

Qué encontrarás

Métricas básicas de fondos: VL (Valor Liquidativo), XIRR (tasa interna de retorno con fechas reales), métricas del panel de Carteras Gestionadas (Valor actual, Coste neto, Beneficio total, Variaciones por período)
Riesgo y rentabilidad ajustada: Volatilidad, Beta, Alpha, Ratio de Sharpe, Ratio de Información, R², Tracking Error, Correlación
Mecánica del optimizador: Mínima Varianza, Máxima Diversificación, Varianza Objetivo, Máximo Rendimiento, Máximo Sharpe, Frontera Eficiente, Contribución al Riesgo, Modelo de Markowitz
Cálculo de retornos: diferencia entre retornos logarítmicos y simples, métodos de covarianza (Estándar, Robusta, EWMA), estimación de retornos esperados con score OLS
Indicadores técnicos: RSI, MACD, Bollinger Bands, SMA 20/50, Retrocesos de Fibonacci, fractales, Ondas de Elliott. Cada uno con una etiqueta de exactitud académica

Cómo se usa en la práctica: mientras estás mirando una tabla en Análisis de Activos o un resultado del optimizador, pulsa el link "Métricas" de la barra superior — abre esta página completa. Tras consultar el concepto, vuelve donde estabas con el botón "atrás" del navegador.

Guía pestaña a pestaña — Parámetros

Preferencias de la app · se guardan en el navegador · sin sesión necesaria

Qué puedes configurar

Tooltips: mostrar u ocultar los iconos ? de ayuda en toda la app. Útil cuando ya dominas las métricas y prefieres una pantalla más limpia
Modo del bot:
- Disponible pero discreto (default): el bot está visible en la esquina pero no se abre solo — tú lo invocas cuando quieres
- Sin bot: el botón ámbar 💬 desaparece de toda la app salvo en Carteras Gestionadas
Confirmación antes de actuar: si está activado, el asesor describe la acción y espera tu OK antes de aplicarla. Si lo desactivas, ejecuta directamente y te informa al terminar. Excepción inviolable: en Carteras Gestionadas el asesor SIEMPRE pide confirmación (alta, venta, baja, traspaso, plusvalías), independientemente de este ajuste — ahí hay dinero real
Fiscalidad — tipo IRPF ahorro (%): tipo marginal de la base del ahorro que se usa para estimar el Coste fiscal estimado en Carteras Gestionadas → Mi Fiscalidad. Default 23 %. Tramos vigentes en España (2026): 19 % hasta 6 k€, 21 % hasta 50 k€, 23 % hasta 200 k€, 27 % hasta 300 k€, 28 % por encima

Cómo se guardan

Las preferencias se guardan automáticamente al cambiarlas — en el navegador (localStorage), no en el servidor. Eso significa que viajan con tu equipo y navegador, no entre dispositivos. Cada cambio muestra un breve "Guardado" en verde y te devuelve al inicio para refrescar la app con los nuevos ajustes. El botón Restablecer vuelve todos los valores a sus defaults.

El asesor también puede cambiarlos

Pídele en lenguaje natural: "oculta los tooltips", "quita el bot", "deja de pedirme confirmación cada vez", "sube el tipo IRPF al 27%". Aplica los cambios y refresca igual que si hubieras tocado los controles tú.

Parte 2 — Lógica de datos · qué existe, dónde vive, cuándo desaparece

Dos tipos de dato: permanentes y de sesión

Qué se guarda en disco · qué vive solo en memoria · cuándo se borra

Datos permanentes — sobreviven al cierre del navegador

Listas de Seguimiento: las listas de tickers guardadas en Listas seguimiento. Se guardan en disco y no desaparecen salvo que las borres tú manualmente
Carteras Gestionadas: fondos, operaciones, historial de VLs, flujos de caja. Completamente aislados en su propio archivo en disco. Ninguna acción del resto del dashboard los toca nunca
Carteras guardadas: los resultados de optimización que guardas con nombre desde Construir cartera. Persisten entre sesiones

Datos de sesión — existen mientras trabajas, luego desaparecen

Precios descargados: el resultado de pulsar Load Data. Los precios históricos de los instrumentos cargados viven en la memoria del servidor mientras la sesión está activa
Proxies asignados en Predicciones: el ETF que asignaste o que buscó la lupa para cada fondo
Resultados de análisis: gráficos de Analytics, señales de Predicciones, resultados de Sentimiento — todo se recalcula en cada sesión a partir de los datos cargados

Los tres eventos que borran los datos de sesión

1. Cerrar el navegador · 2. Botón Clear · 3. Botón Load Data

Cerrar el navegador: si hay datos cargados, el navegador muestra un aviso "¿Deseas salir? Los datos se borrarán." Si confirmas, el servidor limpia la caché. Si cancelas, sigues en el dashboard con todo intacto
Botón Clear en Listas seguimiento: borra la sesión inmediatamente. La pestaña vuelve a gris. No tiene confirmación — es instantáneo
Botón Load Data: antes de cargar los nuevos datos, borra los anteriores. Así nunca hay mezcla de dos cargas distintas

Cada vez que abres el dashboard de nuevo, la sesión anterior ya no existe. Debes hacer Load Data para empezar a analizar. Los datos permanentes (watchlists, Carteras Gestionadas, carteras guardadas) siempre están ahí — solo los datos de análisis de la sesión desaparecen.

Cómo fluyen los datos entre pestañas

El recorrido desde la carga hasta los resultados

El flujo principal de análisis

Listas seguimiento es el único origen de datos de análisis. Cuando pulsas Load Data, los precios se guardan en la memoria del servidor y quedan disponibles para todas las demás pestañas simultáneamente. No hay que volver a cargar nada al cambiar de pestaña.

Recorrido de los datos de análisis

Yahoo Finance → Load Data → Caché del servidor (memoria) → Analytics · Carteras · Predicciones · Sentimiento

El flujo de Carteras Gestionadas (completamente independiente)

Carteras Gestionadas no toca el caché de análisis en ningún momento. Tiene su propio flujo cerrado:

Scrapers de gestoras → VLs actualizados → Disco (inversion.json) → Métricas en tiempo real

El único puente entre Carteras Gestionadas y el resto

Cuando registras una operación o hay cambios en tu cartera personal, el sistema actualiza automáticamente la watchlist "Carteras Gestionadas" en Listas seguimiento. Así puedes cargar esa watchlist en cualquier momento para analizar tus fondos actuales con todas las herramientas del dashboard.

De dónde viene cada dato

Fuentes externas · lógica de resolución · qué se cachea y cuánto

Precios históricos de fondos y ETFs

Cuando pulsas Load Data, el sistema descarga precios históricos en tres fases. Primero intenta EOD Historical Data (mejor cobertura para fondos europeos e ISINs). Si no obtiene datos suficientes, prueba Yahoo Finance. Como último recurso usa Investing.com mediante un scraper. El sistema elige automáticamente la fuente con los datos más recientes. Los precios se guardan en disco (output/price_cache.csv) para que la próxima carga sea instantánea.

Etiqueta "Fuente" en Period Performance. Cada caja de Period Performance muestra debajo el sitio al que enlaza el nombre del fondo, y ambos están sincronizados: si el ISIN tiene web oficial de la gestora (Schroders, JPMorgan, Carmignac, AzValor, Jupiter, Man, Groupama, Global Evolution) se enlaza directamente a esa página; si está catalogado en Investing.com se enlaza al ETF/fondo en Investing.com; si es un ISIN sin web propia ni Investing se enlaza a la página real del activo en Morningstar (URL canónica del snapshot, resuelta una vez por el screener de Morningstar y cacheada en disco); y los tickers cortos de ETFs/acciones se enlazan a Yahoo Finance. Cuando un ISIN no aparece en ningún sitio fiable, la caja simplemente no muestra etiqueta ni enlace — preferimos sin link a mandar a un buscador genérico.

Cómo se evita la mezcla de divisas en el precio "live" del día. Cuando EOD y Yahoo aún no han publicado el cierre, el sistema podría leer la cotización en vivo en la página de Investing.com — pero esa página a veces muestra el precio en una divisa distinta a la del histórico (un ETC cotizado en LSE en peniques sterling ~6500 cuya página de Investing muestra el equivalente en USD ~88, p.ej.). Para no contaminar el caché, el sistema aplica cuatro capas, en este orden: (1) los fines de semana no consulta Investing (cierres repetidos del viernes ensucian las analíticas); (2) si EOD o Yahoo ya respondieron con la serie histórica (en la divisa correcta del activo), no consulta Investing — la fila de hoy se rellena al final de la jornada cuando EOD/Yahoo publiquen el cierre; (3) cuando sí consulta Investing, lee la variación porcentual del día y la aplica sobre el último valor cacheado (el porcentaje es invariante a la divisa, así el cálculo queda automáticamente en la divisa correcta sin convertir tipos de cambio); (4) como red de seguridad final, cualquier salto mayor del 15 % vs el último valor se descarta. Todas las decisiones se loggean ([PW SKIP], [PW DELTA], [PW NO-DELTA], [PW REJECT]) — ningún fallo queda silencioso.

Cargar datos desde el asesor: por qué a veces el chat parecía quedarse "colgado". Cuando pides al asesor que cargue una lista de activos, el chat muestra un spinner mientras la descarga se hace en segundo plano. Antes había cuatro situaciones en las que el spinner del chat se quedaba activo para siempre sin que nadie te dijera nada: la lista venía vacía, el servidor rechazaba la petición, había un fallo de red al iniciar, o el polling de estado fallaba cinco veces seguidas (típico tras saturación por muchos Chromiums en paralelo). Ahora cada uno de esos casos finaliza el spinner con un mensaje claro ("✗ No he encontrado tickers para cargar", "✗ Fallo al iniciar la carga: …", "✗ Error de red al iniciar la carga: …", "✗ La carga se perdió por errores de red consecutivos. Reintenta cuando quieras") y limpia el flag interno, de forma que el asesor siempre te dice qué pasó y puedes reintentar.

El aviso "⚠ La carga no se ha iniciado" ya no salta cuando el asesor solo está proponiendo. El chat vigila si el asesor anuncia una carga pero no la lanza realmente — entonces saca un aviso amarillo. El problema era que en español el asesor propone cargar usando frases como "cargo los 6 fondos a 3 años, ¿lo hago?" o "voy a cargar Y, ¿confirmas?", y el vigilante no distinguía entre proponer y actuar: saltaba siempre que el asesor te preguntaba antes de cargar. Ahora el vigilante mira también si el mensaje del asesor termina con una pregunta de confirmación ("¿lo hago?", "¿confirmas?", "¿quieres?", "¿te parece?", "¿lanzo?", etc.) y, si la hay, calla. Si el asesor dice "estoy cargando" o "iniciando la carga" sin preguntar nada y de verdad no ha lanzado la orden, el aviso sigue saliendo — ese es el fallo real que el vigilante existe para detectar.

Carga combinada con cambio de pestaña — el caso "carga estos 5 y vamos a Comparador". Cuando le pides al asesor que cargue unos fondos y al mismo tiempo te lleve a otra pestaña, internamente usa una acción distinta a la carga normal (la que acepta el destino al que ir tras terminar). El handler del navegador que recibía esa acción era estricto con el formato del mensaje y, cuando el asesor lo emitía en el formato más natural (el mismo que ya usa la carga simple), el handler se rompía en silencio: el asesor parecía haber lanzado la carga (escribía "Cargando los datos, te aviso en cuanto esté listo (~30s)") pero la petición real nunca salía. Aparecía el aviso amarillo del vigilante con razón. Ahora el handler tolera los dos formatos posibles y el vigilante reconoce también esta acción combinada como carga válida — la carga arranca y el aviso ya no aparece en este caso.

ISIN / ticker → EOD Historical Data → si falla → Yahoo Finance → si falla → Investing.com → price_cache.csv

Valores Liquidativos (NAV) de Carteras Gestionadas

Cada fondo tiene scrapers propios según su gestora. El sistema intenta todas las fuentes disponibles para ese ISIN y gana siempre la que tenga la fecha más reciente. En caso de empate de fecha, el orden de preferencia es: web propia de la gestora > FT Markets > Morningstar. EOD Historical Data actúa como fallback cuando Playwright no está disponible (EC2). Los scrapers de gestora y FT requieren Playwright (Mac local); en EC2 el sistema usa EOD y Morningstar automáticamente.

Caso especial — LU0107768219 (Schroder ISF Inflation Plus C EUR). Como FT publica el VL del día antes que la web de Schroders pero con los decimales mal escalados para este fondo, el sistema usa un atajo: lee de FT solo el cambio del día (p. ej. Today's Change −0,083) y lo suma al último VL bueno conocido (cacheado en output/nav_last_known.json). El cambio absoluto sí viene en la escala correcta, y al día siguiente la web de Schroders publica el VL real y se normaliza. Cuatro capas defensivas: (1) skip fines de semana, (2) skip si Schroders ya entregó VL de hoy, (3) leer solo el cambio absoluto (nunca el precio), (4) guardrail residual del 15 % vs último valor. Logs: [FT DELTA], [FT SKIP], [FT NO-DELTA], [FT REJECT]. Para este ISIN, Investing.com y Morningstar quedan fuera del pipeline (no aportan sobre Schroders + EOD).

ISIN del fondo → intenta todas → Web gestora + FT Markets + EOD / Morningstar → gana la más reciente → NAV actualizado

Metadata de fondos (nombre, categoría, benchmark)

Para resolver el ISIN de un fondo a su nombre completo, categoría Morningstar y benchmark declarado, el sistema consulta en cascada: primero EOD Historical Data (API de datos financieros, TTL 30 días), luego Morningstar (mstarpy, API no oficial), y finalmente el PDF de la ficha técnica del fondo si las anteriores no tienen el dato. Toda esta metadata se cachea en disco (output/metadata_cache.json) para no repetir llamadas.

ISIN → EOD Historical Data → Morningstar → PDF ficha técnica → metadata_cache.json

ETF proxy para Predicciones y Análisis (β, α, R²)

Para encontrar el ETF que mejor replica un fondo, el sistema sigue cuatro pasos en orden: (1) usa el proxy que asignaste tú manualmente en la pestaña Predicciones (tiene prioridad absoluta); (2) si no hay proxy manual, busca en EOD los ETFs que replican el benchmark declarado del fondo; (3) busca por categoría Morningstar; (4) pide a Claude Haiku (LLM) que sugiera ETFs basándose en los holdings del PDF. Una vez encontrado un proxy, el sistema calcula β, α, R², TE, Corr e IR comparando las series de precios solapadas.

proxy manual → si no hay → EOD benchmark → EOD categoría → Claude Haiku (PDF) → etf_universe_cache.json

Noticias y análisis de sentimiento

El sentimiento se nutre de tres fuentes simultáneas: NewsAPI (noticias en inglés de medios generalistas), Finnhub (noticias financieras específicas de empresas y ETFs), y Google News RSS + Funds People / Funds Europe (noticias especializadas de fondos en español). Los titulares y fragmentos recogidos se pasan por FinBERT, un modelo de lenguaje entrenado específicamente en textos financieros, que clasifica cada noticia como positiva, negativa o neutral. El modelo (2,4 GB) se descarga solo la primera vez.

NewsAPI + Finnhub + Google News / FundsPeople → FinBERT → score sentimiento

Descubrimiento de fondos por lenguaje natural

El buscador de fondos en Construir cartera (campo "Buscar fondos…") envía tu consulta en texto libre a Claude, que la interpreta y genera términos de búsqueda para Morningstar. Los resultados se presentan con ISIN, nombre, categoría y rentabilidad. Requiere que ANTHROPIC_API_KEY esté configurada.

texto libre → Claude (interpreta) → Morningstar → lista de fondos

Análisis Profundo por instrumento

El panel de Análisis Profundo en Construir cartera combina datos de dos orígenes: las métricas cuantitativas (volatilidad, Sharpe, MDD, beta…) se calculan directamente a partir de los precios ya descargados en sesión. Los datos cualitativos extendidos (valoración, fundamentales, resultados trimestrales) se obtienen en tiempo real de Yahoo Finance para acciones, y de Morningstar + PDF de la ficha para fondos.

Todos los datos de precios y metadata son de fuentes externas y pueden tener retrasos de 1 día (Yahoo Finance cierra el día anterior) o incluso de varios días para fondos poco seguidos. El dashboard no genera datos propios — los descarga, los cachea y los calcula.

Qué pasa si algo no funciona como esperabas

Situaciones frecuentes · causa · solución

Las pestañas de análisis están vacías al entrar: la sesión expiró o fue borrada. Vuelve a Listas seguimiento y pulsa Load Data
Un fondo no carga (aparece en errores tras Load Data): el ISIN puede no estar en Yahoo Finance o el ticker puede ser incorrecto. Prueba el ticker directo de Yahoo Finance si el ISIN no funciona
El modelo de Predicciones da señal Neutral siempre: el R² del proxy elegido es muy bajo. Prueba otro proxy manualmente o usa la búsqueda automática con la lupa
El botón "Actualizar VLs" en EC2 devuelve error 503: el botón sí está disponible en EC2, pero reenvía la petición al Mac local vía proxy SSH. Si el Mac está apagado o el túnel está caído, aparece el error 503. Enciende el Mac, comprueba el túnel y vuelve a intentarlo
El análisis de sentimiento tarda mucho la primera vez: está descargando el modelo FinBERT (2,4 GB). Es normal. Solo ocurre la primera vez
Un fondo muestra "—" en varias columnas de Carteras Gestionadas: los datos trimestrales (Q1/Q2/Q3) solo están disponibles cuando el trimestre ha cerrado con un VL real. Consulta la Parte 3 de esta guía para el detalle
Después de cerrar el navegador, los proxies de Predicciones han desaparecido: es el comportamiento correcto — los proxies son datos de sesión y se borran al limpiar. Reasígnalos con la lupa o escríbelos manualmente

Parte 3 — Lógica de negocio · cómo se calculan los números

Cómo funciona el optimizador de carteras

Qué hace matemáticamente el botón "Construir cartera"

El problema que resuelve

Tienes 10 fondos. ¿Cuánto dinero poner en cada uno? Hay millones de combinaciones posibles. El optimizador busca la combinación que mejor cumple el objetivo que elegiste — menos riesgo, más rentabilidad, mejor equilibrio entre ambos… — respetando las restricciones que configuraste (pesos mínimos y máximos, número de posiciones).

Por qué combinar fondos reduce el riesgo

Si dos fondos no se mueven igual (correlación baja), cuando uno baja el otro puede estar subiendo o quieto. Combinados, el resultado es más estable que cualquiera de los dos por separado. Esta idea — que la diversificación reduce el riesgo más allá de lo que aportaría cada activo por separado — es la base de la Teoría Moderna de Carteras de Markowitz (Premio Nobel 1990).

Ejemplo concreto

Un fondo de bolsa con volatilidad del 12% y un fondo de bonos con volatilidad del 4%, combinados al 50%, no dan una volatilidad del 8% (el promedio) — dan menos del 8% si su correlación es baja, porque cuando la bolsa cae, los bonos suelen mantenerse o subir. La diversificación crea ese "descuento de riesgo".

Qué significan los parámetros avanzados

Método de retornos (logarítmicos vs. simples): cómo se mide el cambio de precio entre sesiones. Los logarítmicos tienen mejores propiedades matemáticas. Si no tienes preferencia, deja logarítmicos
Método de covarianza (Estándar / Robusta / EWMA): cómo se estima la relación entre activos. Estándar usa todo el histórico por igual. Robusta ignora los días de crash extremos. EWMA da más peso a los datos recientes. En mercados tranquilos: Estándar. En mercados cambiantes: EWMA
Retornos esperados manuales: en los modos Máx. Sharpe y Máx. Rendimiento, puedes sobrescribir la estimación automática con tu propia convicción sobre un fondo concreto

Cómo funciona el modelo de Predicciones

Sin jerga estadística · la lógica detrás de la señal UP/DOWN

La idea, explicada sin estadística

Imagina que tienes un fondo de bonos europeos que publica su precio una vez al día con retraso. Existe un ETF de bonos europeos que cotiza en tiempo real, cada segundo. Históricamente, cuando ese ETF sube un 0,5% en un día, tu fondo sube un 0,4% al día siguiente — son como sombra y objeto. El modelo aprende esa relación.

Además aprende si tu fondo tiene tendencia a continuar en la misma dirección varios días seguidos (momentum) o a rebotar en sentido contrario (reversión a la media). Combinando ambas cosas, genera una estimación de dirección para mañana.

Qué es el R² y por qué importa

Analogía

Imagina que el R² es la "fuerza de la cuerda" entre el ETF proxy y el fondo. R² = 0,40 significa que el ETF explica el 40% de los movimientos del fondo. El 60% restante se mueve por otras razones que el modelo no captura. Si la cuerda es muy floja (R² < 0,10), el proxy no es bueno para ese fondo y la señal no es fiable.

R² ≥ 0,20 (verde): buena base para el modelo
R² entre 0,05 y 0,20 (naranja): aceptable, la señal tiene incertidumbre
R² < 0,05 (gris): el proxy no explica bien este fondo — busca uno mejor

Cómo se convierte el modelo en señal UP / DOWN

El modelo calcula un "score" para el día de hoy. Para saber qué significa ese score, el sistema mira atrás en la historia: "¿cuántos días pasados tuvieron un score similar a hoy? Y en esos días, ¿qué hizo el fondo al día siguiente?" Si en el 70% de esos días históricos similares el fondo subió → señal UP con 70% de probabilidad.

Rangos de score por quintil

Bajo cada etiqueta de quintil (Q1, Q2, Q3, Q4, Q5) aparece el rango numérico exacto del score que define ese quintil, por ejemplo −0.0312 → 0.0041. Esto permite comparar el score del día de hoy con los límites históricos y entender en qué parte de la distribución se encuentra: si el score actual está cerca del borde superior de su quintil, la señal está casi en la categoría siguiente.

OOS Accuracy vs. WF Accuracy — en qué fijarse

Analogía

OOS Accuracy es como estudiar los exámenes de los últimos 5 años y que te pongan el examen del año 6. Es una medida honesta pero puede ser optimista si ese período fue fácil.

WF Accuracy es como hacer ese mismo ejercicio 50 veces seguidas con diferentes fragmentos de historia, siempre estudiando con datos del pasado y probando con el futuro inmediato. Es más realista porque simula cómo funcionará el modelo en producción.

Si WF Accuracy es mucho menor que OOS Accuracy (más de 10 puntos de diferencia), el modelo memorizó un período específico pero no generaliza bien. La señal real en producción se parecerá más al WF Accuracy — ese es el número en el que debes fijarte.

Cómo funciona el cierre de año de Carteras Gestionadas

Automático · fondo a fondo · sin intervención · qué ocurre en enero

Cierre incremental — fondo a fondo

El cierre no es un evento de golpe. Ocurre progresivamente: cuando el sistema recibe un VL con fecha 31-dic de un fondo (al actualizar VLs), ese fondo se incorpora al ejercicio cerrado. El proceso puede durar varios días porque algunos fondos publican con retraso.

Por cada fondo que recibe su VL del 31-dic, el sistema hace dos cosas en paralelo:

Lo añade al snapshot del ejercicio cerrado — una foto completa que incluye todos los fondos que existieron durante ese año, activos y dados de baja.
Lo establece como valor inicial del nuevo ejercicio (1 de enero), lo que resetea Benef. año, Rent., Proyección y XIRR a 0 para ese fondo.

Los fondos que aún no tienen su VL del 31-dic siguen funcionando con normalidad en el año nuevo — no bloquean nada. El 8 de enero hay un cierre forzado con el último VL disponible de cada fondo pendiente. Si después del día 8 llega el VL real del 31-dic de algún fondo, el sistema lo sobrescribe automáticamente en la siguiente actualización — sin intervención manual.

No hay que hacer nada. Sigue actualizando VLs con normalidad. El cierre ocurrirá solo, fondo a fondo, según lleguen los VLs de diciembre.

Qué ves el 1 de enero (y por qué no es un bug)

El 1 de enero, para los fondos que ya han cerrado el ejercicio:

Benef. año = 0 € y % año = 0 % — el VL del 31-dic es a la vez el VL de inicio del año nuevo y el VL actual. No hay diferencia todavía.
Var. día, semana, mes = 0 — no hay VL nuevo publicado aún.
Valor actual = Inicio año.

Es correcto y esperado. A partir del 2 de enero los fondos publican nuevos VLs y las métricas empiezan a moverse.

El selector de año cerrado

Cuando hay un ejercicio cerrado, aparece un desplegable junto al título "Carteras Gestionadas":

Año actual — la cartera viva, editable.
2026 (o el año cerrado) — el snapshot del ejercicio, en modo consulta.

En modo año cerrado puedes ver todos los fondos que existieron ese año (incluidos los dados de baja), todos sus movimientos (flujos: compras, ventas, traspasos) y las métricas de cierre (beneficio, rentabilidad, XIRR). La trazabilidad es completa fondo a fondo. Útil para control fiscal y decisiones basadas en plusvalías y minusvalías realizadas.

Ajustes puntuales: aunque el año cerrado es de consulta, puedes corregir el VL final o el beneficio de un fondo concreto si el banco confirma un dato tardío diferente al que llegó por scraping. El resto del ejercicio no se toca.

Los fondos dados de baja durante el año aparecen en el ejercicio cerrado pero desaparecen del año activo. Hasta el 31 de diciembre, el selector solo muestra "Año actual" con la nota "Año anterior disponible el 31-dic".

Resumen Total — caja Resultado bajas

El panel Resumen Total incluye una caja Resultado bajas (entre Retiradas y Valor actual) que muestra el beneficio o pérdida consolidado de los fondos cerrados durante el año. Solo aparece si hay fondos dados de baja con resultado registrado.

La fórmula del resumen es: Inicio año + Benef. año = Valor actual. El Benef. año ya incluye el resultado de las bajas; la caja "Resultado bajas" es informativa y muestra qué parte proviene de posiciones cerradas.

Cuándo ver "—" en una celda de Carteras Gestionadas

No es un error · qué significa cada guión · cuándo desaparecerá

Muchas celdas muestran "—" en determinados momentos. No es un fallo — significa que el dato aún no está disponible. Desde mayo 2026 todas las cajas de periodo (semana, mes, mes anterior, Q1..Q4, S1..S2) se calculan con la misma regla: importe del total hoy − importe del total al cierre del periodo anterior, todo por fecha del sistema (no por fecha del VL). Si falta el snapshot del inicio o del fin del periodo, aparece "—". El cierre del año sigue siendo la única excepción y usa su mecanismo propio (`nav_inicio_anyo`).

Inicio año € (—): solo muestra valor cuando el sistema ha hecho al menos un cierre de año real. Si incorporaste los fondos este mismo año, el VL de inicio de año fue retroactivo y el sistema lo marca como "—" hasta enero del año siguiente, cuando haga el primer cierre real
Benef. semana € / % var. semana (—): requiere snapshot del último domingo (o el más reciente anterior). Aparece desde el primer domingo en el que ha habido actualización. El lunes la caja resetea y refleja solo lo que ha movido la cartera ese día — el resultado del domingo ya cerró la semana anterior
Benef. mes € / % var. mes (—): requiere snapshot del último día del mes anterior. Aparece desde el día 1 de cada mes (siempre que la app estuviera funcionando ese último día). El día 1 la caja resetea
Benef. mes ant. € / % mes anterior (—): requiere snapshots del último día del mes anterior y del último día del mes anteanterior. En mayo 2026 sale "—" porque no hay snapshot del 31-marzo (la app arrancó en abril)
Q1 € / % 2026 (—): nunca disponible en 2026. Necesita snapshots del 31-dic-2025 y del 31-mar-2026; ninguno existe
Q2 € / % 2026 (—): nunca disponible en 2026. Necesita snapshot del 31-mar-2026; no existe
Q3 € / % 2026: disponible a partir del 1 de octubre de 2026. Necesita snapshots del 30-jun-2026 y del 30-sep-2026 (ambos existirán)
Q4 € / % 2026: disponible a partir del 1 de enero de 2027. Necesita 30-sep-2026 y 31-dic-2026
S1 € / % 2026 (—): nunca disponible en 2026. Necesita snapshot del 31-dic-2025
S2 € / % 2026: disponible a partir del 1 de enero de 2027. Necesita 30-jun-2026 y 31-dic-2026
Var. día € / % (—): no hay aún un "ayer" en el historial. Aparece tras la primera actualización de VLs después de un día de diferencia

Resumen para 2026: primeros datos trimestrales/semestrales fiables — Q3 € (octubre 2026), Q4 € / S2 € (enero 2027). Q1, Q2 y S1 de 2026 quedan vacíos para siempre porque el historial empieza en abril. A partir de 2027 todos los periodos estarán operativos al cerrar cada uno.

Máx. ganancia año € y Máx. pérdida año € — Resumen Total

Nuevas métricas en el panel de Resumen Total de Carteras Gestionadas

El panel Resumen Total incluye dos nuevas cajas que registran los extremos del beneficio acumulado durante el año en curso:

Máx. ganancia año €: el mayor beneficio anual acumulado registrado hasta la fecha. De momento refleja el beneficio actual (la cartera nunca ha estado en un punto más alto este año)
Máx. pérdida año €: la mayor pérdida anual acumulada registrada. Muestra 0,00 € porque la cartera no ha tenido ningún período negativo desde el inicio del seguimiento