Plataforma de Comercio de Granos

Un marketplace digital full-stack para el mercado de commodities de granos. La plataforma automatiza todo el ciclo de vida de las operaciones — desde el descubrimiento automatizado de precios y la verificación de contrapartes hasta la firma de contratos, el transporte de carga y la generación de documentos — sirviendo a productores agrícolas, compradores de commodities y proveedores de logística.

El sistema comprende tres aplicaciones cliente que comparten un backend común: un portal web para vendedores y compradores, una aplicación móvil para transportistas para logística de campo, y una aplicación móvil para vendedores para gestión de operaciones en movimiento.

Backend — 15 microservicios, cada uno propietario de un dominio de negocio distinto: Registration Service — incorporación de usuarios, KYC, verificación de entidad legal. Deal Service — gestión del ciclo de vida de operaciones, generación de contratos, seguimiento de estado. Account Service — perfil de empresa, requisitos, gestión de claves API. Freight Forwarding Service — flujo de trabajo de transporte, generación de documentos (guías de remesa, informes de expedición). Best Price Search — conversión de base, estimación de costos de flete, emparejamiento automatizado de precios. Carrier Uberization — cálculo de costos de flete basado en ML con modelado de demanda estacional; integración con plataformas logísticas para pedido de transporte y seguimiento de envíos. Counterparty Accreditation — preparación de documentos y flujo de trabajo de acreditación automatizado. Financial Partner Service — integración con organizaciones financieras para monitoreo de operaciones y seguimiento de etapas.

Los servicios se comunican de forma asíncrona a través de Apache Kafka. Los procesos de negocio de larga duración — firma de operaciones, transporte de carga — están orquestados con Camunda BPMN, permitiendo ejecución confiable, recuperación de errores y observabilidad a nivel de proceso.

La autenticación y gestión de roles se ejecutan en una instancia auto-hospedada de Keycloak. Los secretos se gestionan centralmente en HashiCorp Vault. La observabilidad está construida sobre OpenSearch con trazado distribuido vía Spring Cloud Sleuth y alertas en tiempo real a canales de Telegram.

Portal Web — Angular 17 / TypeScript. Funcionalidades principales: búsqueda automatizada del mejor precio, creación y gestión de operaciones, generación de documentos primarios.

App de Transportista — Capacitor + Angular + TypeScript. iOS y Android. Tres secciones: solicitudes de transporte abiertas, expediciones activas (con generación de documentos y modo offline con sincronización en segundo plano), archivo de trabajo completado.

App de Vendedor — Capacitor + Angular + TypeScript. iOS y Android. Dashboard de precios en las principales bases de compradores, ejecución de operaciones con un toque desde el móvil, seguimiento del estado de operaciones. Dirigida a gerentes de empresas agrícolas.

La base de código compartida Angular/TypeScript en las tres aplicaciones cliente redujo significativamente la duplicación y mantuvo al equipo alineado en una única biblioteca de componentes.

Tres ingenieros, composición de equipo estándar. Sin orquestación de IA en este proyecto — ejecución de ingeniería pura. El resultado demuestra lo que un equipo enfocado y bien estructurado entrega cuando las decisiones de arquitectura se toman desde el inicio y los límites del dominio están claramente definidos.

Sirviendo como punto de comparación directo con el Registro de Almacén de Granos: un ingeniero con orquestación de IA entregó 13 servicios en 12 días. Tres ingenieros sin ella entregaron 15 servicios en 3 meses. Diferentes equipos, diferentes contextos — pero ambos resultados son verificables.

15 microservicios independientes, un portal web y dos aplicaciones móviles multiplataforma entregados en 3 meses por un equipo de 3. El stack compartido Angular/TypeScript en el portal y ambas apps móviles fue una decisión de arquitectura deliberada que dio resultados en velocidad y consistencia.

Camunda BPMN para procesos de negocio de larga duración resultó esencial: la firma de operaciones y el transporte de carga involucran demasiados modos de fallo para una máquina de estados simple. Tener definiciones visuales de procesos y recuperación/reintentos integrados hizo que el sistema fuera resiliente desde el primer día.