Skip to content
mbarradev-debugPublic

About

Dashboard de indicadores económicos chilenos

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

116 Commits

Folders and files

Repository files navigation

Pulso — Dashboard de indicadores económicos de Chile

CI

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.

Vista general del dashboard

Stack

  • 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)

Cómo correrlo localmente

Requisitos: Node 26+, npm.

npm install
cp .env.example .env.local
npm run dev

Completar .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)

Arquitectura

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.

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
  • 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).

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 el Banco Central, para que los tests no dependan de la API externa.

Git hooks

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-verify

Usar esto con moderación — código que se pushea sin pasar lint/format puede fallar en CI o ser marcado en la revisión.

CI/CD

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.

About

Dashboard de indicadores económicos chilenos

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages