Texto del repositorio público, commit 8729248. Fuente: docs/claude/ui-patterns.md.
Patrones de UI: responsive, tiras, widgets y análisis IA de earnings
Detalle movido desde
CLAUDE.mdel 2026-10-04 para que el fichero que se carga en cada sesión solo lleve el índice y las reglas críticas. Léelo antes de tocar esta zona.
Responsive — tres reglas que se aprendieron midiendo (2026-08-01)
Auditoría de /app/gastos con Playwright a 320/375/414/768 px (modo demo, document.scrollWidth vs clientWidth + getBoundingClientRect de cada nodo). Las tres causaban fallos REALES, no teóricos:
- Los items de un grid de widgets necesitan
min-w-0([&>div]:min-w-0junto al[&>div]:h-fullque ya llevaban). Un grid item traemin-width:auto, así que en la columna ÚNICA de móvil basta con UN hijo indeformable para estirar el track y sacar de pantalla a TODOS los widgets. El culpable medido fue el<input>de búsqueda de la lista de movimientos: un input impone su ancho intrínseco (~20 caracteres = 212 px) como mínimo, y llevaba la columna a 367 px dentro de un contenedor de 343 → los 7 widgets desbordaban 8 px. Para el propio input:size={1}+min-w-0(sin ambos,w-fullno basta dentro de un flex). DialogContentacota su alto y da margen lateral él solo (w-[calc(100%-2rem)] sm:w-full,max-h-[calc(100dvh-2rem)] overflow-y-auto). Sin el tope, un formulario largo centrado contranslate-y(-50%)se sale por ARRIBA y por abajo en un teléfono y no hay forma de llegar al botón de guardar. El margen va sobrew-*y NO sobremax-w-*a propósito: los diálogos pasan su propiomax-w-md/max-w-4xlytwMergedescartaría unmax-wbase.dvh, novh: el viewport móvil encoge con la barra de URL y el teclado.- Mínimo táctil 40 px hasta
lg, no hastasm: una tablet de 768 px sigue siendo táctil. Patrón para botones de icono:min-w-[40px] min-h-[40px] lg:min-w-0 lg:min-h-0. La auditoría encontró 34 botones por debajo de 36 px (los de editar/borrar meta estaban a 26×26). Para agrandar el área táctil SIN mover el icono:-m-3 p-3(el margen negativo compensa el padding) — así se arregló la X de cerrar deDialogContent, que medía 16×16.
- Los diálogos van por ENCIMA de la cabecera de la app (2026-08-18):
DialogOverlay/DialogContentestaban enz-50y la cabecera deDashboardLayoutenz-[70], así que un diálogo alto en móvil —que queda a 16px del borde superior— tenía su título Y su botón de cerrar TAPADOS por la cabecera, sin forma de cerrarlo con la X (medido conelementFromPointsobre el título: devolvía elsvgdel logo). Ahoraz-[96]/z-[97]: por encima de cabecera (70), sidebar móvil (76) y overlay de búsqueda global (90/95), y por DEBAJO de los toasts (z-[100]) — un guardado hecho desde un diálogo tiene que poder confirmarse por encima de él. Al añadir cualquier overlay nuevo, colócalo en esa escala.
Corolario de método: antes de tocar Tailwind "responsive", mide. El instrumento (script Playwright que recorre viewports y lista los nodos que se salen y los targets pequeños) tarda menos en escribirse que en discutirse.
Tiras horizontales: components/ui/ScrollStrip.jsx
Las pestañas de listas de favoritos (widget del Dashboard y pantalla /app/favorites) van dentro de ScrollStrip. Dos cosas que hace y conviene no deshacer:
- Barra de scroll VISIBLE (
custom-scrollbar-xenindex.css, 5 px). Antes iban conno-scrollbar: con doce listas no había ninguna señal de que quedaran más a la derecha y solo se descubrían arrastrando a ciegas. - Difuminado por el lado que aún se puede desplazar, calculado con
scrollLeft/scrollWidth(derecha al principio, ambos en medio, izquierda al final — verificado en el navegador). Es unmask-imagesobre el propio contenido, NO un degradado encima: así no hay que acertar con el color del fondo, que cambia entre la tarjeta del Dashboard (bg-white dark:bg-slate-800) y la pantalla de favoritos, y entre claro y oscuro. Sin nada que desplazar no se pone máscara, o difuminaría la primera y la última pestaña sin motivo. El difuminado es la única señal en macOS y en cualquier navegador con scrollbars de overlay, donde la barra solo aparece al desplazar (medido: en Chromium headlessoffsetHeight - clientHeightda 0 aun desbordando 414 px).
Análisis IA de una presentación de resultados (widget Earnings)
Al desplegar una fila del widget "Resultados (Earnings)" aparece "Analizar presentación de resultados" (o "Analizar expectativas" si el trimestre aún no se ha publicado) → POST /api/analyze-earnings (withRateLimit('analysis'), misma cuota que el score de cartera).
- El prompt vive en
server/prompts/earningsAnalysis.js(PURO y testeado):sanitizeEarningsPayload(clamps de longitud, control chars fuera, números no finitos → null) +buildEarningsPromptcon DOS modos segúnepsActual !== null— publicado (post-mortem + reacción real del mercado) o pendiente (expectativas, con prohibición explícita de inventar el desenlace). Cuando no hay movimiento de cotización el bloque de datos dice "NO DISPONIBLE (no lo inventes)" en lugar de omitirlo. - ⚠️ quoteSummary (v10) SOLO funciona por el crumb proxy
/api/yahoo-profile/:ticker?modules=…. El proxy plano/api/yahoo/v10/finance/quoteSummary/...devuelve SIEMPRE{"error":{"code":"Unauthorized","description":"Invalid Crumb"}}— Yahoo exige cookie+crumb. Por eso el widget mostraba "Sin datos históricos disponibles" para TODOS los tickers y el fallback deearningsService(modules=calendarEvents) nunca devolvió una fecha; ambos se migraron al crumb proxy el 2026-07-26. El override?modules=existe en los TRES lados (plugin de dev,server/routes/marketProxy.js,api/yahoo-profile.js), así que la migración es segura en prod. CualquierquoteSummarynuevo va por ahí, nunca por/api/yahoo. - UNA sola llamada (
modules=earningsHistory,earningsTrend,earnings,price) alimenta el historial del widget Y el contexto del análisis; el parseo es puro y testeado (parseEarningsDetail), cacheado 30 min por ticker (Yahoo rate-limita quoteSummary con 429 fácilmente).regularMarketChangePercentdel módulopriceviene como FRACCIÓN (0.0342) — se lee defmty solo se escalarawcomo fallback (extractChangePct); precios en GBp se normalizan a GBP. - Guard de plausibilidad del BPA (
assessEpsPlausibility, puro + tests): los calendarios de terceros publican a veces unepsque no es el trimestral comparable (GOOGL Jun/2026 llegó como real 9.11 vs est. 2.88 → "+216%"). Si la sorpresa supera ±100% o el BPA triplica el máximo histórico conocido, el prompt inyecta un AVISO DE CALIDAD DE DATOS ordenando tratar la cifra como posiblemente errónea y no construir la lectura de mercado sobre ella. Mismo espíritu queisPlausiblePriceUpdate: no se borra el dato, se marca. - Resultado cacheado en localStorage por
ticker+fecha del informe(trazza_earnings_ai_v2:…): volver a desplegar la fila NUNCA vuelve a gastar cuota. La v1 se invalidó el 2026-10-03 porque esos análisis se generaron con las sorpresas del historial 100 veces más pequeñas (Yahoo mandasurprisePercentcomo FRACCIÓN: 2.1489 = +214,89 %, y se pintaba "+2.1%"). El botón solo aparece cuando el historial trimestral ya está resuelto. - El formato de las narrativas IA (secciones con emoji + bullets) se parsea en
src/lib/aiInsightFormat.js(parseInsightBlocks, puro + tests) y se pinta concomponents/ui/AiInsightBlocks.jsx(renderInlinepara negritas). Lo consumen el widget de earnings yPortfolioScoreWidget— no duplicar el parser en una tercera superficie.
Widgets personalizables (Dashboard + Gastos)
Orden inicial: DEFAULT_DASHBOARD_ORDER define lo que ve un usuario NUEVO — no puede salir del registry porque el registry está partido en dos arrays (dashboard + gastos) y el orden deseado los intercala. resolveDashboardLayout(saved, registry, defaultOrder) lo aplica SOLO cuando no hay orden guardado; lo que el usuario reordene manda siempre, así que cambiar este orden NO mueve el dashboard de quien ya tenga un layout guardado (tiene que reordenar o restaurar desde el personalizador).
Colocación vigente (2026-09-10, pedida por el owner) con los widgets de gastos apagados:
| Invertido / Favoritos (1) | Rendimiento (2) |
| Wallet Map (2) | Quesito / Puntuación (1) |
| Dividendos (1) | Earnings (1) | Noticias (1) |
DEFAULT_PAIRS empareja invested+watchlist y allocation+score — ninguna pareja depende ya de la feature de gastos, así que el layout inicial no cambia al encenderla. Noticias pasó de span: 3 a span: 1 para compartir fila con los dos calendarios (petición del owner): su columna es justo la que rellena el sobrante de las dos parejas, así que el layout vuelve a teselar EXACTO (9 columnas, 3 filas). Ojo: el ancho vive en DOS sitios que hay que mover juntos — el span del registry (que es lo que cuadra la retícula y lo que miden los tests) y la clase lg:col-span-* del bloque JSX en Dashboard.jsx. Con los widgets de gastos encendidos sobra 1 columna al final; lo que fija el test es que ningún widget parta una fila y que el hueco solo pueda estar en la ÚLTIMA — uno en medio de la retícula se lee como un widget que no cargó.
Wallet Map: el texto de cada baldosa lo decide layoutTileText (2026-10-15)
PortfolioTreemap.jsx → layoutTileText(label, w, h), pura y con tests (PortfolioTreemap.layout.test.js, medidas de una cartera real de MyInvestor). Prioridades: (1) el porcentaje se coloca primero, nunca más pequeño que el nombre ni por debajo de 10px, y es lo último que se quita; (2) el nombre se parte en hasta 3 líneas equilibradas y la letra baja hasta 9px antes de recortar con "…". Antes era una sola línea con tope de 15px: los nombres de fondo salían como "ISHARES ES…", las baldosas grandes llevaban letra diminuta y en las bajas desaparecía el porcentaje. SVG no mide texto sin pintarlo: la anchura sale de CHAR_WIDTH (0,62 em, estimación con margen); si se cambia la fuente de las baldosas, revisa esa constante. El tamaño de la baldosa es |variación diaria| (useDashboardData), no el valor: el subtítulo "Tamaño = movimiento" es correcto.
Ninguna baldosa sin nombre (2026-10-17): withMinTileSize sube cada baldosa al menos a un 25 % de la mayor (MIN_TILE_SHARE), sin alterar el orden de tamaños: un BTC-USD a −0,07 % junto a un META a −3,72 % era una franja de pocos píxeles sin texto. El tamaño deja de ser exactamente proporcional en las que apenas se movieron, y se acepta: el % de cada una sigue escrito. Si aun así no caben dos líneas, layoutTileText devuelve inline: true y la baldosa pinta nombre y % en la MISMA línea.
Color en degradado (getTileFill): de suave a intenso según la magnitud, satura en ±3 % (GRADIENT_FULL_AT) con raíz cuadrada para separar las variaciones pequeñas de una cartera de fondos. La leyenda es una barra con la MISMA escala (si cambias GAIN_SCALE/LOSS_SCALE o el umbral, la leyenda los sigue sola). getTileColor (sólido) queda para TEXTO —tooltip, chip "Mejor"—, donde un tono pálido no se leería.
Buscador de activos (barra superior → components/search/GlobalSearchBar.jsx)
Revisado a fondo el 2026-10-15. Vive en su propio componente (salió de DashboardLayout, −270 líneas); la ficha que abre es GlobalSearchOverlay.
Capas — no mezclarlas:
yahooFinance.searchTickers(q, signal, { strict })+mapYahooSearchResponse(puro, test con respuestas reales).strictlanza si TODOS los endpoints fallan; sin él devuelve[], que es lo que esperan los ~12 llamantes de los imports — no cambies el modo por defecto. El respaldo/v1/finance/lookupllevabatype=stock(400: "Valid types: equity, mutualfund…") y leíadata.resulten vez definance.result[0].documents: nunca había funcionado. El timeout se combina con la señal del llamante (AbortSignal.any): antes, con señal propia, no había timeout y un Yahoo colgado dejaba el spinner girando.marketDataService.searchTickers(solo lo usa el buscador): Yahoo strict → EODHD; si Yahoo FALLÓ y EODHD no da nada, lanza → la barra dice "Error al buscar" en vez de "Sin resultados". EODHD sin clave devuelve[], por eso decide el principal. Test:marketDataService.search.test.js.useTickerSearch: busca el término RECORTADO; apaga el spinner al cancelar (antes, borrar hasta una letra con una búsqueda en vuelo lo dejaba girando); no cachea vacíos (un 429 pasajero no puede decir "sin resultados" 2 min);enterSelectsFirstopcional (la barra sí; en un formulario Enter debe seguir enviando).lib/searchResults.js(puro, con tests):prepareSearchResults(sin filas sin símbolo, sin duplicados, ordenado — futuros/opciones al FINAL: "apple" metía SAAPL=F entre las acciones),resultLabels(NOMBRE delante si el símbolo es opaco,isOpaqueTickerenlib/tickerLabel.js),findMatchRange(ignora espacios: "s&p500" ↔ "S&P 500"),changeTone(gris si redondea a 0,00 %),typeLabelKey(etiquetas traducidas ensearch_types.*) yportfolioSymbols("En cartera" compara el ticker GUARDADO y el de COTIZACIÓN víaresolveQuoteSymbol: un fondo de MyInvestor se guarda "VANGUARD 20 (EUR)" y Yahoo lo da como 0P0000CV2T.F).AssetTypeBadge: la etiqueta de tipo única (antes copiada en 4 sitios y sin traducir).
UI: precio de TODAS las filas por runPooledSettled, pintado según llega y cortado al cambiar la búsqueda; mercado legible (exchDisp: NASDAQ / Toronto distingue AAPL de AAPL.TO); combobox ARIA (aria-activedescendant, región status con el nº de resultados); historial navegable con flechas, que guarda el OBJETO (elegir una reciente le borraba el nombre) y se puede vaciar; atajo / y Ctrl/Cmd+K (desactivado con la ficha abierta). En móvil el panel es fixed a todo el ancho bajo la cabecera: el campo mide ~90 px y un panel de su ancho era ilegible (ya pasaba antes de la revisión).
Ficha (GlobalSearchOverlay): Escape la cierra (salvo con el desplegable de watchlists abierto); la pantalla de carga tiene botón de cerrar; si la carga falla hay pantalla de error con "Reintentar" — antes devolvía null y dejaba el ticker "abierto", así que volver a elegir ese activo no hacía nada; el gráfico usa el símbolo RESUELTO (quoteSymbolRef) al cambiar de periodo — con un ISIN sin mapear pedía el histórico del ISIN y salía vacío — y solo pinta la última petición.
Verificación en navegador: guion de Playwright en modo demo (atajo, fondos, "apple", spinner tras borrar, flechas+Enter+Escape, historial, Yahoo caído con page.route → error, símbolo inexistente → "Reintentar" y se puede reabrir, móvil 390 px sin scroll horizontal).
Un widget con lista capada rellena su celda: flex-1 + scroller ABSOLUTO
Patrón compartido por PortfolioNewsWidget y EarningsCalendar (2026-09-20). El problema es el mismo en los dos y volverá en cualquier widget con lista: la celda del grid estira la card con h-full, la fila la marca el widget MÁS ALTO que la comparta, y una card en display:block con la lista clavada en un max-h deja el sobrante en blanco al final — medido en la demo: Noticias 183px de hueco sobre 678, Earnings 175px sobre 693. Y a la vez cortaba la lista a media fila, así que sobraba blanco y faltaba contenido.
La receta, que NO se puede simplificar a "quitar el max-h":
- La card es
flex flex-col h-full; cabecera y pie,shrink-0. - La lista va en un contenedor
relative flex-1 min-h-[N]con el scroller dentro enabsolute inset-0 overflow-y-auto overflow-x-hidden. - Lo absoluto no es decorativo: saca el contenido del flujo, así que su alto intrínseco NO cuenta para la fila. Sin eso, una lista larga (6 noticias con miniatura ≈ 530px) estiraría a los vecinos, que es justo lo que el
max-hprotegía. - El
min-h-[N]conserva la contribución que tenía elmax-h(380px en Noticias, 420px en Earnings). Sin él la lista colapsa a 0 en móvil, donde la fila mide su contenido y lo absoluto no aporta ninguno. - Un estado de carga con alto FIJO (
h-[400px]) pasa ah-full min-h-[400px], o la fila pega un salto al resolverse.
Verificación: el hueco baja a 2px (los bordes) y la fila mantiene su alto — que los vecinos no crezcan es la mitad del arreglo, así que se mide, no se supone.
Como comparte fila con Dividendos y Earnings, la lista de PortfolioNewsWidget no puede estirar la fila: 6 noticias con miniatura miden ~530 px y arrastraban a los dos vecinos. Pero capar su alto con un max-h fijo tampoco vale, y ese fue el bug (2026-09-20): la fila la marca el widget MÁS ALTO que la comparta (Previsión/Calendario, 678 px medidos en la demo) y la card estira con h-full, así que con la lista clavada en 380 px y la card en display:block quedaban 183 px de blanco al final de la card. La solución cumple las dos cosas a la vez: la card es flex flex-col h-full (cabecera y pie shrink-0) y la lista va en un contenedor relative flex-1 min-h-[380px] con el scroller absolute inset-0 — al estar fuera de flujo, su contenido no cuenta para el alto intrínseco de la fila, y el min-h conserva EXACTAMENTE la contribución del max-h anterior (sin él la lista colapsaría a 0 en móvil, donde la fila mide su contenido). El lote inicial es de 8 noticias y no 6 porque, ya rellenando la fila, seis dejaban 36 px sin pintar; a partir de ahí desborda y scrollea. overflow-x-hidden sigue siendo EXPLÍCITO (con overflow-y:auto el eje X computa a auto y pinta una barra horizontal).
Motor único en src/services/dashboardLayout.js (puro, testeado): registries DASHBOARD_WIDGETS, EXPENSES_WIDGETS (widgets de gastos del Dashboard, solo con la feature activa) y EXPENSES_PAGE_WIDGETS (pantalla de Gastos). resolveDashboardLayout(saved, registry) mergea el config guardado con el registry (el registry es la fuente de verdad: widgets nuevos aparecen al final visibles, ids desconocidos se dropean); moveWidget/toggleWidgetVisibility/serializeLayout completan el contrato.
- Parejas "mitad y mitad" (2026-07-25): los widgets con
half: trueen el registry (invested, allocation, score, watchlist, dividends, earnings, exp_summary) pueden ENLAZARSE de dos en dos: una pareja comparte UNA celda del grid apilada en vertical y se mueve como bloque en el personalizador (botón Enlazar/Separar entre filas adyacentes emparejables). Estado explícito enconfig.pairs([[a,b],…]);DEFAULT_PAIRSsolo aplica cuando el save no trae campopairs(ver "Orden inicial" para las parejas vigentes). Funciones:resolvePairs,applyPairAdjacency(el 2º miembro siempre sigue al 1º),togglePair(un widget solo puede estar en una pareja),computeRenderGroups(pareja visible = 1 grupo; miembro oculto degrada a single),moveWidgetWithPairs(mueve por UNIDADES). - Dentro de una pareja, el de ARRIBA mide su contenido y el de ABAJO absorbe el sobrante (
flex-initial/flex-1, 2026-09-10). Partir la celda en dos mitades exactas estiraba la card corta y le dejaba una banda vacía debajo: medido en demo, la card de INVERTIDO ocupaba 310 px para 276 px de contenido — 34 px de azul vacío. La CELDA sigue estirando (h-full), así que los bordes de la fila siguen alineados; lo único que cambia es el reparto interno. El antiguo widgetsummaryse partió eninvested+allocation; en Dashboard.jsx los 7 emparejables se renderizan víarenderHalfWidget+ map dewidgetGroups— NUNCA volver a darles bloques JSX independientes (perderían el emparejamiento). - Persistencia:
user_preferences.dashboard_widgetsyexpenses_widgets(jsonb{order:[ids], hidden:[ids], pairs:[[a,b]]}). Config malformado se tolera (fallback al registry). - UI:
components/dashboard/DashboardCustomizer.jsxes GENÉRICO (recibe layout, usat(w.labelKey)) — reutilízalo para cualquier pantalla nueva, no dupliques el diálogo. - Patrón de render: los widgets NO se mueven en el JSX; cada bloque se envuelve en
{isVisible(id) && (<div style={{ order: order(id) }}>…)}dentro de un grid CSS — el orden lo daorder, la anchuraspan(col-span). Añadir un widget = entrada en el registry + labelKey en ambos JSON + bloque gateado. - Política de retícula del Dashboard (2026-07-25): grid con
grid-flow-row-dense(rellena los huecos que deja ocultar/reordenar cuando los spans no suman 3) +lg:auto-rows-[minmax(280px,auto)](suelo de fila) + todas las celdas estiran su card con la cadena[&>div]:h-full(ErrorBoundary no envuelve en div; ExpandableWidget ya reenvíah-fulla su primer hijo) — los bordes de una misma fila quedan siempre alineados. Las listas largas capan con scroll interno (max-h-[380px] overflow-y-auto custom-scrollbar, patrón DividendCalendar). NUNCA volver alg:self-startpor-widget: con reordenación libre produce bordes desalineados.
Tailwind 4 (migrado el 2026-10-04) — lo que hay que saber
Migración con @tailwindcss/upgrade y comparación de capturas contra v3 (pantalla a pantalla, al píxel): todas las pantallas revisadas quedaron en 0,00 % salvo variaciones de datos en vivo. Para conseguirlo se añadió en src/index.css:
- Paleta de v3 en hex (
--color-<familia>-<tono>en@theme, generada desdetailwindcss@3/colors.js): v4 trae otra paleta OKLCH más saturada, y las decisiones de contraste del proyecto se midieron con la de v3. Una familia de color nueva hay que añadirla ahí. - Alturas de línea de v3 en rem (
--text-*--line-height): v4 las da como proporción y las pastillas pequeñas dentro de un texto mayor encogían. - Cursor de mano en botones y color de placeholder de v3, junto al bloque de color de borde que añade el migrador.
Y tres diferencias de comportamiento que ya no muerden pero conviene conocer al escribir clases nuevas:
space-y-*/space-x-*en v4 ponen margen ABAJO del hijo, no arriba del siguiente. Un primer hijofixedya no deja hueco (Dashboard y brokers llevanpt-*explícito para conservar el de siempre) y unmt-*en un hijo despace-yAHORA SÍ se aplica (en v3 lo anulaba la regla de space-y; se quitaron los cuatro que había).- Un
text-*responsive ya no pisa unleading-*base: donde v3 lo pisaba se añadió elsm:leading-*equivalente para no mover nada. - Navegadores: Safari 16.4+, Chrome 111+, Firefox 128+. Medido en los logs de nginx antes de migrar: 19/19 navegadores reales compatibles.
Botón de ampliar, porcentajes, noticias y demo (2026-10-15)
- El botón de ampliar de
ExpandableWidgetestá FUERA de la tarjeta (-top-2.5 -right-2.5, sobre el hueco de la retícula), aparece solo al pasar el ratón y se oculta en pantallas táctiles ([@media(hover:none)]:hidden). Dentro (top-2.5 right-2.5) tapaba la cabecera de cada widget. - Porcentajes:
formatPercent(lib/formatters.js), con coma como los importes.toFixed(2)+ "%" dejaba "+1.23%" junto a "1.896 €". - Noticias de cartera:
interleaveByTicker(lib/newsMix.js) las reparte por activo (antes salían 6 de 6 de Apple), los símbolos salen deresolveQuoteSymbol, la caché va atada a los activos pedidos y se vuelve a pedir al cambiar de broker. - Demo: toda tabla que el código consulta tiene que existir en
DEMO_STORE(ahora tambiénimported_data); una ausente devuelve error y el widget que ya no se lo traga lo enseña.
Modo privacidad en el Dashboard: importes Y porcentajes de la cartera (2026-10-15)
Misma regla que Gastos (expenses.md): se ocultan los importes y los porcentajes de TU cartera — variación total del día, % invertido, reparto del quesito, peso en el tooltip del Wallet Map, rendimiento (titular, eje, tooltip, ROI total, "vs S&P 500"). Se siguen viendo las variaciones de cada activo en el mercado (baldosas, Favoritos, movimientos del día): son públicas y no dicen nada de la cartera. En Dashboard.jsx va por formatShare (= formatPercent con privacidad). El tooltip del rendimiento en vista % enseñaba el valor de la cartera en euros aunque la privacidad estuviera activa; ya no.
Wallet Map — value lo pisa Recharts: el Treemap sobrescribe value de cada nodo con su dataKey (size = |variación|). El importe va en marketValue (lo añade PortfolioTreemap) y se formatea con formatMoney que pasa el Dashboard. Antes el tooltip decía "Valor 1" para un BTC de 33.016 €.
Tarjetas de widget: Dividendos y Earnings usan ya el estilo común (rounded-2xl, borde fino, shadow-xs, cabecera px-5 py-3.5 con título text-sm). No vuelvas a meter variantes con rounded-[2.5rem]/degradado/sombra grande: la fila no parecía del mismo panel. Y un título uppercase con truncate necesita leading-tight, no leading-none, o se corta la tilde de las mayúsculas.
Quesito (distribución): sectores, regiones y la etiqueta de cripto se traducen al pintar (sector_names.*, dashboard.region_*); eran literales en español. Las regiones de fondos y acciones usan las MISMAS etiquetas para fundirse en una porción, y REGION_MAP acepta alias de país ("USA", "US", "UK", "Europe"): con solo "United States", la demo pintaba "USA" 35 % y "Norteamérica" 11 % por separado. Las industrias siguen como las da Yahoo (son más de 140).
Dashboard de una cuenta sin posiciones (2026-10-15)
Sin ninguna posición invertida ni liquidez (vista general), el Dashboard pinta EmptyPortfolioHero (qué se verá aquí + "Añadir mi cartera" → /app/brokers?start=import, que abre el importador al llegar) y oculta los widgets que solo dirían "sin datos" con layoutForEmptyPortfolio (services/dashboardLayout, con tests). Se quedan Favoritos y los de gastos. Es el layout que se PINTA (shownLayout): el guardado y el personalizador no cambian, y en cuanto hay posiciones vuelve el del usuario.
Onboarding de una cuenta nueva (2026-10-17) — recorrido verificado con la persona demo vacía y cubierto por npm run test:e2e:onboarding (corre en el CI):
- Una sola guía en el Dashboard. Con la cartera vacía solo se pinta
EmptyPortfolioHero;OnboardingChecklistaparece cuando ya hay cartera. Antes salían las dos, y la lista BLOQUEABA "Importa tu cartera" hasta "Configura tus preferencias": un paso de más antes del único que importa. Importar ya no está bloqueado. - Brokers vacío =
cartera/BrokerEmptyState: un botón para importar, otro para añadir a mano, los brokers con importador propio (DEGIRO, IBKR, MyInvestor, Trading 212, Binance) y la lectura con IA para el resto. Sustituye a las tres tarjetas a cero, la tabla vacía, el "Análisis de Cartera" vacío y la guía de textoBrokerOnboardingGuide(borrada), que describía botones ("haz clic en el +…") en vez de darlos y nombraba un "Importar CSV" que no existía.isEmptyBrokerespera apositionsLoadedForpara no enseñar el estado vacío un instante a quien sí tiene cartera. - Divisa por defecto EUR en UN sitio (
lib/preferredCurrency.js:DEFAULT_CURRENCY,preferredCurrencyOf). Había cuatro defectos distintos: la cuenta nueva veía "0,00 US$" en Brokers y el Dashboard. - El broker que se crea solo se llama
cartera.default_broker_name(traducido; antes "Mi Broker" fijo). - Bienvenida (
onboarding/WelcomeSetupDialog, cuándo:lib/welcomeSetup): idioma, divisa (4 botones + desplegable con TODAS las de Ajustes;<select>nativo porque el portal deCurrencySelectorqueda fuera del Dialog modal y Radix le bloquea clics y foco), tema (se aplica al momento), avisos por correo y "¿cómo quieres empezar?": importar (?start=import) o añadir una posición a mano (?start=position), o explorar. Se guarda todo en UNA escritura de preferencias. La marca de hecha va enuser_metadata.welcome_completed_at(no enonboarding_completed, que oculta la lista "Primeros pasos"; ni enpreferred_currency, que tiene valor por defecto EUR en la BD). Solo cuentas de ≤ 30 días. - Persona demo
empty:/auth?demo_persona=emptyentra con una cuenta vacía, solo en desarrollo o en el build del CI (VITE_E2E=1). En producción la condición es falsa y el parámetro no hace nada.
Números según el idioma (2026-10-15)
formatNumber/formatPercent usan appLocale() (lib/formatters), que lee la instancia única de i18next: en-US con la app en inglés, es-ES si no. No escribas 'es-ES' ni toLocaleString() sin locale en una pantalla: el primero ignora el idioma y el segundo sigue al navegador. Excepciones a propósito: panel de admin (interno) y portfolioContextService (texto para la IA).
Pantalla de brokers: importes, textos y tarjetas (2026-10-16)
- Importes con
formatMoney(importe, moneda, { sign, decimals })(lib/formatters, Intl, sigue el idioma, separador de miles siempre): "-13,83 €", "1.200,56 €", "342,00 US$". Convivían "€-13,83", "1,50 $" y "+1200,56€" en la misma pantalla. No construyas${símbolo}${formatNumber(...)}a mano: pone el signo detrás del símbolo y en inglés el símbolo va delante. Para ejes de gráfico,formatMoneyCompact("1,4 mil €"): con "€1k" se repetía la etiqueta para 1.050 y 1.400. - Textos: "Activo", "Precio medio" (con explicación al pasar el ratón; antes "BEP"), "Objetivo" (antes "Target"); el desglose dice "Precio / Divisa / Realizado" con su explicación (antes letras P/FX/R); la asignación de escritorio dice "Actual: 14,4 %" y "Comprar/Vender X €" como en móvil; los tipos de operación salen de
transaction_types.*(antes BUY/SELL/FEE en crudo). - Tarjetas de análisis (
MonthlyBreakdownChart,TransactionListCard,RealizedPnLTable) con el estilo común. El gráfico mensual recibecurrency(código), nocurrencySymbol, y rotula los meses "ene 23".
Privacidad en brokers: usePrivateFormatters (2026-10-16)
Una pantalla que pinta la cartera toma formatMoney/formatNumber/formatPercent/formatMoneyCompact de hooks/usePrivateFormatters (enmascarados en privacidad) en vez de importarlos de lib/formatters: así no hay que acordarse de envolver cada cifra. La tabla de escritorio NUNCA había ocultado nada, y las listas de dividendos/comisiones/liquidez, los gráficos mensuales y las ventas realizadas tampoco (solo las tarjetas de arriba). Se oculta: importes, CANTIDADES (cantidad × precio público = tu valor) y porcentajes de la cartera. Se ve: el precio de mercado (formatPublicMoney) y lo que hace falta para operar (los formularios de alta reciben el formateador sin máscara). El signo va DENTRO del formateador ({ sign: true }): fuera, "+••••%" contaba si ganabas o perdías.