Capa	Tecnología
Runtime	Bun
Backend	Hono + TypeScript
Frontend	React 19 + Vite
Routing	TanStack Router (file-based)
Data Fetching	TanStack Query
Estilos	Tailwind CSS v4 + shadcn/ui
Base de datos	PostgreSQL + Prisma ORM
Tiempo real	Server-Sent Events (SSE)
Contenedor	Docker (multi-stage build)

Estructura

├── apps/
│   ├── backend/       # API server (Hono) + cron jobs
│   │   └── src/modules/quotes/   # Módulo de cotizaciones
│   │       ├── bna.service.ts    # USD oficial (dolarito.ar)
│   │       ├── blue.service.ts   # USD blue (dolarito.ar)
│   │       └── belo.service.ts   # USDC/ARS Belo (criptoya.com)
│   └── frontend/      # SPA React con TanStack Router
│       └── src/
│           ├── routes/           # Páginas (file-based routing)
│           ├── features/         # Componentes de cada feature
│           ├── components/ui/    # shadcn/ui components
│           └── lib/              # Hooks, API client, utils
├── packages/
│   └── common/        # Tipos y utilidades compartidas
└── Dockerfile         # Multi-stage build

Requisitos

Bun >= 1.x
PostgreSQL (local o remota)

Setup local

# Instalar dependencias
bun install

# Configurar base de datos
cp apps/backend/.env apps/backend/.env.local
# Editar DATABASE_URL en .env.local

# Generar Prisma client
bun run --cwd apps/backend prisma:generate

# Correr migraciones
bun run --cwd apps/backend prisma:migrate

# Iniciar dev (backend + frontend simultáneamente)
bun run dev

El backend corre en http://localhost:3000 y el frontend en http://localhost:5173 (con proxy a /api → :3000).

Scripts

Root

Comando	Descripción
`bun run dev`	Inicia backend y frontend en paralelo
`bun run build`	Build de frontend

Backend (`apps/backend`)

Comando	Descripción
`bun run dev`	Dev con watch
`bun run prisma:generate`	Generar Prisma client
`bun run prisma:migrate`	Migraciones de desarrollo
`bun run prisma:migrate:deploy`	Migraciones en producción
`bun run prisma:studio`	Prisma Studio (GUI DB)

Frontend (`apps/frontend`)

Comando	Descripción
`bun run dev`	Vite dev server con HMR
`bun run build`	Build a `../backend/web/`
`bun run typecheck`	TypeScript type check

API

Todas las rutas bajo /api/quotes:

Ruta	Descripción
`GET /api/quotes`	Cotizaciones actuales
`GET /api/quotes/events`	SSE — actualizaciones en vivo
`GET /api/quotes/fetch`	Forzar actualización manual
`GET /api/quotes/:type/history`	Historial paginado
`GET /api/quotes/:type/daily`	Agregados diarios
`GET /api/quotes/:type/min-max`	Mínimo y máximo diario

Tipos: belo, blue, bna

Docker

docker build -t personal-admin-2026 .
docker run -p 3000:3000 \
  -e DATABASE_URL=postgres://user:pass@host:5432/personal-admin-2026 \
  personal-admin-2026

El entrypoint corre las migraciones automáticamente (con reintentos) antes de iniciar el server.

Tasks periódicas

Un cron job ejecuta cada 10 minutos la consulta de las 3 cotizaciones desde fuentes externas y las persiste en la DB. Las actualizaciones se notifican a los clientes conectados via SSE.

Languages

TypeScript 98.3%

CSS 1.2%

Dockerfile 0.3%

HTML 0.1%

Shell 0.1%

README.md

Personal Admin 2026

Stack