GBM Investments

Objetivo

Sistema para administrar y analizar portafolios de inversión en cuentas de GBM (casa de bolsa mexicana). Automatiza la ingesta de estados de cuenta, el parseo de transacciones y la analítica del portafolio a través de un dashboard web. El sistema convierte documentos PDF en datos estructurados consultables, rastreando movimientos de renta variable, fondos, deuda, divisas, dividendos y retenciones fiscales tanto del mercado local (BMV) como del internacional (SIC).

Cómo funciona

1. Ingesta de estados de cuenta Un script descarga los estados de cuenta en PDF desde Google Drive usando credenciales OAuth2 con refresh tokens.
2. Parseo del formato GBM Un parser propio extrae movimientos, posiciones y datos fiscales del formato de estado de cuenta mexicano de GBM.
3. Persistencia en DynamoDB Los movimientos y posiciones se almacenan en tablas de DynamoDB organizadas por cuenta y fecha.
4. Exportación analítica a S3 Los datos se exportan a S3 como archivos Parquet particionados por cuenta, año y mes, listos para consultas SQL vía Athena.
5. Dashboard de portafolio Una API en Express consulta DynamoDB y Athena, y sirve un frontend en React que muestra la analítica y la reconciliación del portafolio.

Modelo de datos

El sistema rastrea movimientos (compra, venta, depósito, dividendo, impuesto), posiciones por ticker (snapshots periódicos por cuenta, año y mes) y agregados mensuales (flujos de efectivo y métricas de rendimiento). Los tipos de movimiento abarcan renta variable, fondos, deuda, divisas, dividendos y retenciones fiscales.

Servicios AWS

• DynamoDB Cinco tablas: movimientos, metadatos de archivos, resúmenes mensuales, registros fiscales y snapshots de posiciones.
• S3 Almacenamiento de PDFs originales y exportaciones Parquet particionadas para analítica.
• Amazon Athena Motor SQL que consulta los archivos Parquet vía catálogo de datos de Glue.
• Secrets Manager / SSM Gestión de credenciales OAuth2 y configuración de cuentas y clasificación de tickers.
• CloudFormation / CDK Infraestructura como código en TypeScript con CDK v2 para el despliegue de los stacks.

Servicios externos

• Google Drive API Descarga de los estados de cuenta en PDF mediante refresh tokens OAuth2.
• Banxico SIE API Tasa de inflación para ajustar y contextualizar el rendimiento del portafolio.

Stack