Dashboard que consume la API SI3 del Banco Central de Chile 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.
- Next.js 16 (App Router, Turbopack) + React 19 + TypeScript
- Tailwind CSS 4
- SWR para fetching y revalidación en el cliente
- Chart.js / react-chartjs-2 para el histórico
- Vitest + Testing Library (unitarios/componentes), Playwright (E2E)
Requisitos: Node 26+, npm.
npm install
cp .env.example .env.local
npm run devCompletar .env.local con BCENTRAL_USER/BCENTRAL_PASS — credenciales de la API SI3 del Banco Central de Chile (requiere registro en si3.bcentral.cl). Son server-only: se leen únicamente en Route Handlers/lib del lado del servidor, nunca en componentes cliente.
Abrir http://localhost:3000.
Otros scripts disponibles:
| Script | Qué hace |
|---|---|
npm run build |
Build de producción |
npm run start |
Sirve el build de producción |
npm run lint |
ESLint |
npm run format |
Formatea con Prettier |
npm run format:check |
Verifica formato sin escribir |
npm run test |
Tests unitarios/componentes (Vitest) |
npm run test:watch |
Vitest en modo watch |
npm run test:e2e |
Tests E2E (Playwright) |
app/
page.tsx → home, renderiza DashboardHome
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/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 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.
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 - Mensuales:
ipc,utm,imacec,tasa_desempleo
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).
- 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.tslevantanext build && next startautomá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.
Este repo usa Husky y lint-staged para correr ESLint y Prettier sobre los archivos staged antes de cada commit. Si el hook reporta errores, hay que corregirlos antes de commitear — ese es el camino esperado.
En casos excepcionales (ej. un commit WIP en una rama local) se puede saltar el hook con:
git commit --no-verifyUsar esto con moderación — código que se pushea sin pasar lint/format puede fallar en CI o ser marcado en la revisión.
Cada Pull Request hacia main corre un workflow de GitHub Actions (.github/workflows/ci.yml) con jobs separados de lint, type-check, tests unitarios, tests E2E y build, con cache de dependencias npm. Cualquier fallo bloquea la PR.
El deploy en Vercel (preview por PR y producción en main) está planificado como próximo paso del proyecto.
