diff --git a/README.md b/README.md index 776dd1c..2da5017 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ ![CI](https://github.com/mbarradev-debug/pulso/actions/workflows/ci.yml/badge.svg) -Dashboard que consume la API pública de [mindicador.cl](https://mindicador.cl) para mostrar en tiempo (casi) real los 12 indicadores económicos de Chile: UF, dólar, euro, IPC, UTM, IMACEC, TPM, libra de cobre, tasa de desempleo, bitcoin, IVP y dólar acuerdo. Incluye gráfico histórico por indicador, favoritos persistentes y un conversor de monto entre CLP y cualquier indicador. +Dashboard que consume la API SI3 del [Banco Central de Chile](https://si3.bcentral.cl) para mostrar en tiempo (casi) real 10 indicadores económicos de Chile: UF, IVP, dólar, euro, IPC, UTM, IMACEC, TPM, libra de cobre y tasa de desempleo. Incluye gráfico histórico por indicador, favoritos persistentes y un conversor de monto entre CLP y cualquier indicador. ![Vista general del dashboard](docs/dashboard-screenshot.jpg) @@ -46,33 +46,33 @@ Otros scripts disponibles: ``` app/ page.tsx → home, renderiza DashboardHome - api/indicadores/route.ts → GET snapshot de los 12 indicadores - api/indicadores/[codigo]/[anio]/ → GET histórico anual de un indicador + api/indicadores/route.ts → GET snapshot de los 10 indicadores (fallback por indicador si alguno falla) + api/indicadores/[codigo]/[anio]/ → GET histórico anual de un indicador (rango de fechas explícito hacia Banco Central) dev/ui/ → catálogo interno de componentes (solo en dev, bloqueado en prod) components/ → DashboardHome, IndicatorCard, HistoryChart, Converter, etc. hooks/ → useIndicadores, useIndicadorHistory, useFavoritos -lib/mindicador-client.ts → cliente HTTP hacia mindicador.cl (timeout, manejo de errores) -types/indicador.ts → tipos y los 12 códigos de indicador soportados +lib/bcentral-client.ts → cliente HTTP hacia la API SI3 del Banco Central (encoding Latin-1, timeout, manejo de errores) +types/indicador.ts → tipos y los 10 códigos de indicador soportados ``` -La app nunca llama a `mindicador.cl` desde el navegador: los componentes cliente consumen `/api/indicadores*` vía SWR, y esos Route Handlers son los que hacen el `fetch` server-side hacia mindicador.cl (con cache/`revalidate` de Next.js y un fallback al último snapshot bueno si la API externa falla). +La app nunca llama a la API del Banco Central desde el navegador: los componentes cliente consumen `/api/indicadores*` vía SWR, y esos Route Handlers son los que hacen el `fetch` server-side (con un cache por indicador en memoria y fallback al último valor bueno conocido si la API externa falla). `proxy.ts` bloquea `/dev/ui` en producción (devuelve 404), ya que es una ruta de desarrollo interna. -### Particularidades de los datos de mindicador.cl +### Particularidades de los datos del Banco Central No todos los indicadores se actualizan igual — esto afecta cómo se calculan rangos y variaciones en `HistoryChart`/`useIndicadorHistory`: - **Diarios**: `uf`, `ivp` - **Diarios hábiles** (solo días de mercado): `dolar`, `euro`, `libra_cobre`, `tpm` -- **Semanal aprox.**: `bitcoin` (~52 puntos/año pese a ser un mercado 24/7) - **Mensuales**: `ipc`, `utm`, `imacec`, `tasa_desempleo` -- **Descontinuado**: `dolar_intercambio` — sin datos reales desde 2014-11-13 + +La API del Banco Central (SI3) tiene además varios comportamientos no obvios que `lib/bcentral-client.ts` encapsula — el detalle completo está en `docs/migracion-banco-central.md`, pero en resumen: la respuesta viene codificada en Latin-1 (no UTF-8), las fechas vienen como `DD-MM-YYYY`, los errores se señalizan con `Codigo != 0` en el body aunque el HTTP sea 200, y los días sin dato no se marcan de forma uniforme entre series (algunas usan `statusCode: "ND"`, otras directamente omiten la fecha). ## Testing - **Unitarios/componentes** (`npm run test`): Vitest + Testing Library, cubren hooks, componentes de UI y los Route Handlers. -- **E2E** (`npm run test:e2e`): Playwright contra el build de producción (`playwright.config.ts` levanta `next build && next start` automáticamente). Los mocks de red interceptan las rutas propias de la app (`/api/indicadores*`), no `mindicador.cl`, para que los tests no dependan de la API externa. +- **E2E** (`npm run test:e2e`): Playwright contra el build de producción (`playwright.config.ts` levanta `next build && next start` automáticamente). Los mocks de red interceptan las rutas propias de la app (`/api/indicadores*`), no el Banco Central, para que los tests no dependan de la API externa. ## Git hooks diff --git a/app/api/indicadores/[codigo]/[anio]/route.ts b/app/api/indicadores/[codigo]/[anio]/route.ts index 1fa78eb..bae42d4 100644 --- a/app/api/indicadores/[codigo]/[anio]/route.ts +++ b/app/api/indicadores/[codigo]/[anio]/route.ts @@ -13,10 +13,9 @@ function fechaISO(date: Date): string { } // Banco Central pide rangos de fechas explicitos (firstdate/lastdate), no -// anios calendario como mindicador.cl. Se deriva el rango del anio pedido: 1 -// de enero a 31 de diciembre, salvo que sea el anio en curso, donde se corta -// en "hoy" para no pedir fechas futuras sin necesidad (ver -// docs/migracion-banco-central.md). +// anios calendario. Se deriva el rango del anio pedido: 1 de enero a 31 de +// diciembre, salvo que sea el anio en curso, donde se corta en "hoy" para no +// pedir fechas futuras sin necesidad (ver docs/migracion-banco-central.md). function rangoDelAnio(anio: number): { firstdate: string; lastdate: string } { const hoy = new Date(); const firstdate = `${anio}-01-01`; diff --git a/app/api/indicadores/route.ts b/app/api/indicadores/route.ts index 4cd8166..df4d92f 100644 --- a/app/api/indicadores/route.ts +++ b/app/api/indicadores/route.ts @@ -7,11 +7,11 @@ import { type IndicadoresSnapshot, } from '@/types/indicador'; -// Cache por indicador (no un snapshot unico como con mindicador.cl): cada -// codigo guarda su ultimo valor exitoso de forma independiente. Con Banco -// Central el snapshot son 10 llamadas independientes en vez de 1 - si una -// falla, se sirve el ultimo valor cacheado de ESE indicador sin afectar al -// resto (ver docs/migracion-banco-central.md, decision de resiliencia). +// Cache por indicador (no un snapshot unico): cada codigo guarda su ultimo +// valor exitoso de forma independiente. El snapshot son 10 llamadas +// independientes a Banco Central - si una falla, se sirve el ultimo valor +// cacheado de ESE indicador sin afectar al resto (ver +// docs/migracion-banco-central.md, decision de resiliencia). const cachePorIndicador = new Map(); async function obtenerConFallback(codigo: IndicadorCodigo): Promise { diff --git a/app/layout.tsx b/app/layout.tsx index f2175d7..90d6bef 100644 --- a/app/layout.tsx +++ b/app/layout.tsx @@ -16,7 +16,7 @@ const firaCode = Fira_Code({ }); const SITE_URL = 'https://pulso-cyan-zeta.vercel.app'; -const TITLE = 'Dashboard mindicador.cl'; +const TITLE = 'Pulso — Indicadores económicos de Chile'; const DESCRIPTION = 'Panel de indicadores económicos de Chile en tiempo real: UF, dólar, euro, IPC, TPM y más.'; diff --git a/app/page.tsx b/app/page.tsx index b0a9fb2..9f0a737 100644 --- a/app/page.tsx +++ b/app/page.tsx @@ -2,7 +2,7 @@ import type { Metadata } from 'next'; import { DashboardHome } from '@/components/DashboardHome'; export const metadata: Metadata = { - title: 'Dashboard mindicador.cl — Vista general', + title: 'Pulso — Vista general', description: 'Vista general de los indicadores economicos de Chile en tiempo real.', }; diff --git a/components/DashboardHome.tsx b/components/DashboardHome.tsx index c37c9a7..de8ad76 100644 --- a/components/DashboardHome.tsx +++ b/components/DashboardHome.tsx @@ -51,7 +51,7 @@ export function DashboardHome() {

Indicadores Chile

-

mindicador.cl

+

Banco Central de Chile

diff --git a/e2e/dashboard.spec.ts b/e2e/dashboard.spec.ts index 936f5c0..3cc1434 100644 --- a/e2e/dashboard.spec.ts +++ b/e2e/dashboard.spec.ts @@ -1,10 +1,10 @@ import { expect, test } from '@playwright/test'; -import { mockMindicadorApi } from './mocks'; +import { mockIndicadoresApi } from './mocks'; test.beforeEach(async ({ page }) => { - // Toda la API de mindicador.cl queda mockeada a nivel de Playwright: estos + // Toda la API de indicadores queda mockeada a nivel de Playwright: estos // tests nunca dependen de que el servicio externo este disponible. - await mockMindicadorApi(page); + await mockIndicadoresApi(page); }); test('carga el dashboard y muestra al menos un indicador con valor visible', async ({ page }) => { diff --git a/e2e/mocks.ts b/e2e/mocks.ts index 103759c..43c83f6 100644 --- a/e2e/mocks.ts +++ b/e2e/mocks.ts @@ -3,8 +3,8 @@ import type { Page } from '@playwright/test'; // Snapshot mockeado: valores redondos para que los calculos del conversor en // los tests sean predecibles (ej. UF en 40.000 -> 100.000 / 40.000 = 2,5). const SNAPSHOT_MOCK = { - version: '1.7.0', - autor: 'mindicador.cl', + version: '2.0', + autor: 'Banco Central de Chile', fecha: '2026-07-25T00:00:00.000Z', uf: { codigo: 'uf', @@ -92,8 +92,8 @@ function serieMockPara(codigo: string) { // Mockea la API a nivel de Playwright (interceptando lo que pide el navegador // a nuestras propias rutas /api/*) para que los tests E2E nunca dependan de -// que mindicador.cl este disponible. -export async function mockMindicadorApi(page: Page) { +// que el Banco Central este disponible. +export async function mockIndicadoresApi(page: Page) { await page.route('**/api/indicadores', async (route) => { await route.fulfill({ json: SNAPSHOT_MOCK }); }); diff --git a/hooks/useIndicadores.test.tsx b/hooks/useIndicadores.test.tsx index 66c42fc..34cf636 100644 --- a/hooks/useIndicadores.test.tsx +++ b/hooks/useIndicadores.test.tsx @@ -32,7 +32,7 @@ describe('useIndicadores', () => { it('retorna el snapshot cuando el fetch es exitoso', async () => { const snapshot = { version: '1.0', - autor: 'mindicador.cl', + autor: 'Banco Central de Chile', fecha: '2026-07-25T00:00:00.000Z', uf: { codigo: 'uf', @@ -58,7 +58,7 @@ describe('useIndicadores', () => { vi.mocked(fetch).mockResolvedValue({ ok: false, status: 502, - json: async () => ({ error: 'mindicador.cl no responde' }), + json: async () => ({ error: 'Banco Central no responde' }), } as Response); const { result } = renderHook(() => useIndicadores(), { wrapper }); @@ -66,6 +66,6 @@ describe('useIndicadores', () => { await waitFor(() => expect(result.current.isLoading).toBe(false)); expect(result.current.data).toBeUndefined(); expect(result.current.error).toBeInstanceOf(Error); - expect((result.current.error as Error).message).toBe('mindicador.cl no responde'); + expect((result.current.error as Error).message).toBe('Banco Central no responde'); }); }); diff --git a/lib/bcentral-client.ts b/lib/bcentral-client.ts index caab0bc..298105c 100644 --- a/lib/bcentral-client.ts +++ b/lib/bcentral-client.ts @@ -78,8 +78,8 @@ interface RespuestaGetSeries { }; } -// "DD-MM-YYYY" (formato de Banco Central) -> ISO 8601. No es el mismo formato -// que devolvia mindicador.cl, hay que parsearlo explicitamente. +// "DD-MM-YYYY" (formato de Banco Central) -> ISO 8601. Hay que parsearlo +// explicitamente, no es el formato ISO estandar. function parseFechaBanco(indexDateString: string): string { const [dia, mes, anio] = indexDateString.split('-'); return new Date(Date.UTC(Number(anio), Number(mes) - 1, Number(dia))).toISOString(); diff --git a/lib/mindicador-client.ts b/lib/mindicador-client.ts deleted file mode 100644 index b975c02..0000000 --- a/lib/mindicador-client.ts +++ /dev/null @@ -1,61 +0,0 @@ -import type { IndicadorCodigo, IndicadoresSnapshot, SerieHistorica } from '@/types/indicador'; - -const BASE_URL = 'https://mindicador.cl/api'; -const REQUEST_TIMEOUT_MS = 8000; - -export class MindicadorApiError extends Error { - readonly url: string; - readonly status?: number; - - constructor(message: string, url: string, status?: number) { - super(message); - this.name = 'MindicadorApiError'; - this.url = url; - this.status = status; - } -} - -async function fetchJson(url: string, options?: { revalidate?: number }): Promise { - const controller = new AbortController(); - const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS); - - let response: Response; - try { - response = await fetch(url, { - signal: controller.signal, - ...(options?.revalidate !== undefined && { next: { revalidate: options.revalidate } }), - }); - } catch (error) { - if (error instanceof Error && error.name === 'AbortError') { - throw new MindicadorApiError(`Tiempo de espera agotado al consultar ${url}`, url); - } - throw new MindicadorApiError( - `Error de red al consultar ${url}: ${error instanceof Error ? error.message : String(error)}`, - url, - ); - } finally { - clearTimeout(timeoutId); - } - - if (!response.ok) { - throw new MindicadorApiError( - `mindicador.cl respondio con estado ${response.status} para ${url}`, - url, - response.status, - ); - } - - return (await response.json()) as T; -} - -export function getSnapshot(options?: { revalidate?: number }): Promise { - return fetchJson(BASE_URL, options); -} - -export function getHistorico( - codigo: IndicadorCodigo, - anio: number, - options?: { revalidate?: number }, -): Promise { - return fetchJson(`${BASE_URL}/${codigo}/${anio}`, options); -}