Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down Expand Up @@ -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

Expand Down
7 changes: 3 additions & 4 deletions app/api/indicadores/[codigo]/[anio]/route.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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`;
Expand Down
10 changes: 5 additions & 5 deletions app/api/indicadores/route.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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<IndicadorCodigo, Indicador>();

async function obtenerConFallback(codigo: IndicadorCodigo): Promise<Indicador | undefined> {
Expand Down
2 changes: 1 addition & 1 deletion app/layout.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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.';

Expand Down
2 changes: 1 addition & 1 deletion app/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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.',
};

Expand Down
2 changes: 1 addition & 1 deletion components/DashboardHome.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ export function DashboardHome() {
<h1 className="text-lg font-semibold tracking-tight text-foreground">
Indicadores Chile
</h1>
<p className="mono text-xs text-foreground-secondary">mindicador.cl</p>
<p className="mono text-xs text-foreground-secondary">Banco Central de Chile</p>
</div>
<div className="flex flex-col gap-2 sm:flex-row sm:flex-wrap sm:items-center">
<span className="mono text-2xs text-foreground-secondary">
Expand Down
6 changes: 3 additions & 3 deletions e2e/dashboard.spec.ts
Original file line number Diff line number Diff line change
@@ -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 }) => {
Expand Down
8 changes: 4 additions & 4 deletions e2e/mocks.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand Down Expand Up @@ -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 });
});
Expand Down
6 changes: 3 additions & 3 deletions hooks/useIndicadores.test.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand All @@ -58,14 +58,14 @@ 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 });

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');
});
});
4 changes: 2 additions & 2 deletions lib/bcentral-client.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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();
Expand Down
61 changes: 0 additions & 61 deletions lib/mindicador-client.ts

This file was deleted.

Loading