Estudio de Caso · Finanzas & Agente IA En Producción

Anotalo

Plataforma de finanzas personales asistida por inteligencia artificial, diseñada para registrar gastos e ingresos en lenguaje natural mediante un bot de Telegram y gestionarlos desde un panel web con control multimoneda y balances en tiempo real.

Estructura del Sistema

La solución opera mediante tres componentes desacoplados que intercambian información sobre una base de datos PostgreSQL unificada:

01

Panel Web & Dashboard

anotalo-ecru.vercel.app

Interfaz de usuario para visualizar balances consolidados por moneda, historial detallado con filtros de fecha y origen, y gestión manual de cuentas financieras.

Next.js 16 React 19 Prisma ORM NextAuth Tailwind v4
02

Motor de Inferencia IA

Servicio Bun & Modelos LLM

Microservicio en tiempo real que procesa mensajes de texto en lenguaje natural y extrae estructuras JSON estrictas con montos, monedas, orígenes y conceptos.

Bun Runtime Groq API Gemini GenAI Cerebras JSON Schema
03

Bot Asistente Telegram

@AnotaMiGastoBot

Canal conversacional directo para capturar transacciones al instante, consultar saldos disponibles y vincular la cuenta mediante enlaces de acceso rápido.

Grammy Framework TypeScript Magic Link Auth PostgreSQL

Flujo de Datos y Conexión de Servicios

TIER 01 Capa de Entrada e Interacción (Frontends y Canales)
Dashboard Web Next.js 16 App Router
React 19

Gestión completa de movimientos, filtros dinámicos por cuenta/fecha y panel de administración de orígenes de fondos.

Bot en Telegram @AnotaMiGastoBot
Grammy

Recepción de notas y mensajes en lenguaje cotidiano con confirmación inmediata de saldo y categorización automática.

Acceso & Magic Link Auth.js & Tokens Temporales
NextAuth

Autenticación sin contraseñas mediante sincronización de PIN con Telegram y soporte para proveedores OAuth de Google.

Webhooks Telegram & Invocación de Inferencia
TIER 02 Capa de Lógica e Inteligencia Artificial (Backend Bun)
Motor de Inferencia & Orquestador IA
Servidor en Bun Runtime con extracción estructurada JSON
Bun v1.2 Groq Llama-3 Google GenAI Grammy Bot
Parser de Lenguaje Natural
Interpreta expresiones cotidianas como "gasté 20$ en pizza con BNC" y mapea cuentas activas.
Esquema Estricto JSON
Normaliza variables clave: tipo, concepto, monto, moneda de origen y cuenta destino.
Gestor de Sesiones & Magic Auth
Valida tokens de acceso temporal y asocia identificadores de Telegram al perfil web.
Prisma Client & Database Pool PostgreSQL
TIER 03 Capa de Datos y Persistencia Relacional
PostgreSQL Base de Datos Principal
Registro de transacciones con integridad referencial ACID
Cuentas de origen con balances actualizados automáticamente
Historial de operaciones de cambio con tasa y moneda destino
Perfiles & Cuentas anotalo_user & auth_sessions
Vinculación de Telegram User ID y nombres de usuario
Soporte para sesiones NextAuth con tokens de verificación
Aislamiento estricto de registros y cuentas por usuario
Soporte Multidivisa VES, USD, USDT, EUR & Tasas
Cálculo automático de conversiones y montos equivalentes
Desglose simultáneo de saldos en moneda nacional y divisas
Trazabilidad de transferencias entre cuentas de distinta moneda
Módulo Principal

Gestión Centralizada de Movimientos y Transacciones

El panel principal reúne en una sola vista todos los registros de gastos, ingresos, transferencias entre cuentas y operaciones de cambio cambiario.

Calcula automáticamente los montos equivalentes según la tasa de cambio asignada, permitiendo ver el valor tanto en bolívares como en dólares sin necesidad de cálculos externos.

Filtro por Origen Rango de Fechas Conversión en Vivo Edición Rápida
Vista de Movimientos Panel de Control
Almuerzo Restaurante
BNC Débito · Hoy, 1:30 PM
- $14.50 Bs. 841.00
Pago de Honorarios
Banesco · Ayer
+ $320.00 Bs. 18,560.00
Transferencia a Efectivo
BNC a Efectivo USD
$50.00 Reubicación

Cuentas y Orígenes de Fondos

Módulo dedicado para crear y organizar cuentas bancarias, billeteras digitales (Zelle, Binance Pay) y efectivo con su moneda designada.

Permite activar o pausar cuentas, consultar saldos individuales y ver el balance global acumulado por cada tipo de divisa.

Comprensión de Lenguaje Natural con IA

Procesador de texto respaldado por modelos de lenguaje que identifica la intención, el monto numérico, el concepto del gasto y la cuenta involucrada sin requerir formatos rígidos.

Reconoce tanto nombres formales de bancos como alias o descripciones guardadas por el usuario para una asignación precisa.

Acceso Rápido por Magic Link

Sistema de inicio de sesión sin contraseñas mediante un enlace interactivo al bot de Telegram con token efímero de validación.

Al confirmar en la aplicación de mensajería, la sesión web se activa automáticamente en el navegador mediante polling reactivo.

Soporte Multimoneda y Cambios

Estructura preparada para manejar economías con múltiples monedas en circulación (bolívares, dólares en efectivo, transferencias en divisas y euros).

Permite registrar operaciones de cambio con tasa acordada, debitando el origen y acreditando el destino con total precisión decimal.

Chat en Telegram @AnotaMiGastoBot
Ayer gasté 8.50$ en café con BNC 09:42 AM
Transacción Registrada
Tipo: Gasto
Concepto: café
Monto: $8.50
Cuenta: BNC Débito
09:42 AM
/balances 09:45 AM
Tus Balances
• BNC: 142.50 USD
• Efectivo: 50.00 USD
• Banesco: 1,450.00 VES
09:45 AM
Canal Móvil Ágil

Registro Inmediato sin Formularios Pesados

El bot de Telegram permite registrar movimientos en el mismo instante en que ocurren, evitando el olvido de pequeños gastos que suelen desajustar el presupuesto.

Admite comandos rápidos como /balances para conocer el estado actual de las cuentas y /saldo [cuenta] [monto] para ajustes manuales de balance.

Grammy TS Entrada Móvil Zero Friction Feedback Inmediato

Validación Estricta con JSON Schema

La respuesta del modelo de lenguaje se fuerza a cumplir un contrato JSON estricto con tipos definidos, evitando alucinaciones y asegurando inserciones limpias en la base de datos.

Filtros Facetados y Búsqueda

El historial web permite filtrar transacciones por rango de fechas (desde/hasta), por origen de cuenta específico o por límite de registros para facilitar auditorías personales.