Loski Internacional es un exportador colombiano de café de especialidad. En cuatro semanas, en WebMinds, una empresa de desarrollo de software e IA con sede en Atlanta, Georgia, construimos LOSKI TRACE: un software de trazabilidad de café pensado para cumplir con la EUDR. Cada lote recibe un código estructurado y una cadena inmutable de eventos (cosecha, secado, empaque, despacho y entrega) ligada a fincas geo-referenciadas y a parcelas dibujadas sobre imagen satelital, con fotos, documentos y un código QR público que cualquier comprador puede escanear para verificar toda la historia con controles de integridad SHA-256. Todo corre sobre infraestructura que el cliente controla por completo.
Datos clave
- 4 semanas del inicio a producción: primer commit el 28 de febrero de 2026 y MVP en producción el 27 de marzo de 2026.
- 7 eventos inmutables del ciclo de vida: creación, cosecha, secado, empaque, despacho, entrega y corrección.
- 10 de 10 tablas con seguridad a nivel de fila, con puntos y polígonos en PostGIS e índices espaciales y de texto completo.
- 55 endpoints de API en 11 módulos de NestJS, con 56 códigos de error de dominio estables.
- Fincas con más de 30 campos (SICA, FNC, ICA y CAR) y marcas de libre de deforestación EUDR por parcela.
El contexto: prueba de origen exigida lote por lote
Los compradores internacionales de café de especialidad quieren saber con exactitud de dónde viene cada lote: qué productor, qué finca, qué parcela y cómo se procesó. Desde 2025, el Reglamento de la Unión Europea sobre productos libres de deforestación (EUDR) sumó una capa regulatoria: materias primas como el café que entran al mercado europeo deben poder rastrearse hasta parcelas geolocalizadas y demostrar que están libres de deforestación.
En Loski, esa información vivía en papel, fotos sueltas y hojas de cálculo, sin ninguna garantía de que no se hubiera editado después. El cliente fue claro con el alcance: el MVP no podía ser un prototipo. Tenía que ser el núcleo definitivo, listo para IoT, validación satelital y custodia inteligente de pagos (smart escrow) sin reescribir nada.
Los retos:
- Los compradores y la EUDR exigen prueba de origen, geolocalización y condición de libre de deforestación a nivel de lote.
- Los registros de la cadena de suministro vivían en papel y hojas de cálculo, editables por cualquiera y sin trazabilidad de cambios.
- Pequeños productores, fincas rurales y un equipo de campo que trabaja casi siempre desde el celular.
- El MVP tenía que ser el núcleo definitivo, propiedad total del cliente y listo para crecer sin reescribirse.
Por qué no bastaba una herramienta genérica de trazabilidad o una plantilla de Excel
En el mercado hay plataformas de trazabilidad y listas de chequeo para la EUDR, y las hojas de cálculo siempre están a mano. El problema es la confianza. Un registro que cualquiera puede editar después no es una prueba; es una afirmación. Loski necesitaba una historia en la que el orden de los eventos se hiciera cumplir, en la que nada pudiera cambiarse en silencio y en la que un comprador externo pudiera verificar la integridad sin tener acceso a datos privados.
El café, además, tiene su propio vocabulario: registros colombianos como SICA, FNC, ICA y CAR, etapas de proceso como el secado y el empaque, y documentos como certificados fitosanitarios y de origen. Una herramienta genérica habría obligado a meter todo eso en campos de texto libre. Por último, importaba la propiedad: el cliente quería el código, la base de datos, el hosting y el dominio en sus propias cuentas desde el primer día, no una suscripción a la plataforma de otro.
Por eso el proyecto empezó con una especificación de la arquitectura definitiva, acordada con el cliente, que combinó nuestro trabajo de consultoría y estrategia con el de desarrollo web y de aplicaciones.
Qué construimos: LOSKI TRACE, software de trazabilidad de café para la EUDR
Seis sistemas entregados como una sola plataforma en cuatro semanas, desplegados en las cuentas propias del cliente en Supabase, Vercel y Render, con su propio dominio.
Un motor de trazabilidad basado en eventos
Cada lote es una línea de tiempo de siete eventos del ciclo de vida, con orden obligatorio e inmutables a nivel de base de datos. Los errores se corrigen con un evento de corrección que referencia al original, nunca editando la historia.
La inmutabilidad la garantiza un trigger, no la buena voluntad: un trigger de PostgreSQL hace imposible editar o borrar un evento, incluso con acceso directo a la base de datos. El orden requerido de los eventos vive en un paquete compartido que usan tanto la API, que rechaza eventos fuera de orden, como el asistente móvil, que bloquea al usuario y le explica por qué.
Una capa de integridad SHA-256
Cada evento se sella en el servidor con un hash SHA-256 y cualquiera puede verificarlo, incluidos los compradores a través del QR. Hacerlo bien exigió resolver un problema sutil: Postgres y Node formatean las fechas de manera distinta, lo que generaba falsas alertas de "alterado". Normalizamos las fechas y ordenamos las claves de los metadatos antes de calcular el hash, y la verificación es retrocompatible para que ningún hash histórico quede invalidado.
Un registro geo-referenciado de productores, fincas y parcelas
Productores, fincas con más de 30 campos (incluidos datos de SICA, FNC, ICA y CAR) y parcelas dibujadas como polígonos sobre imagen satelital, con el área calculada en hectáreas y las marcas de libre de deforestación EUDR al lado. Es la base de datos sobre la que se apoya la debida diligencia que pide la EUDR.
Identidad del lote y QR público
Los códigos de lote estructurados se generan de forma atómica: un upsert sobre una tabla de secuencias por productor y por año crea cada código sin condiciones de carrera, y una versión con autorreparación se recupera si la secuencia llega a desfasarse. Cada lote tiene una historia pública que se verifica al escanear y que oculta los datos sensibles desde el diseño. El QR cuenta la historia, no los secretos: ni documentos de identidad, ni coordenadas, ni precios, ni compradores, ni documentos salen de la plataforma privada.
Evidencia y documentos
El equipo de campo registra cada paso con fotos y GPS desde un asistente móvil. Las fotos de los eventos y los documentos del lote (fitosanitario, origen, calidad, transporte y factura) suben directo al almacenamiento mediante URL firmadas.
Acceso solo por invitación y por rol
Tres roles (administrador, operador y productor), un tablero dedicado para el productor y correos transaccionales para invitaciones, nuevos eventos y lotes completados.
Lo que no se ve
LOSKI TRACE no es un tablero. Es un modelo de datos de trazabilidad con sus reglas de negocio encapsuladas en la base de datos (triggers, un RPC atómico y seguridad a nivel de fila) y en una API de NestJS con validación estricta. Cerca de un tercio del código, y la mayoría de las decisiones de ingeniería, están por debajo de la interfaz: 36 políticas de seguridad entre tablas y almacenamiento, 19 tipos enumerados propios del dominio del café en Postgres, 25 migraciones versionadas y 55 endpoints REST en 11 módulos.
También está hecho para crecer sin reescribirse. Cada evento ya registra su origen (manual, IoT o API) y una referencia externa, así que sensores, verificaciones satelitales o un ERP pueden conectarse como nuevos tipos de evento, tal como lo pedía la especificación.
Lo construimos con Hybrid AI Coding: ingenieros senior son dueños de la arquitectura, el modelo de datos y cada decisión con el cliente, mientras agentes de IA aceleran la implementación bajo revisión independiente. Así un núcleo definitivo, listo para producción, salió en cuatro semanas.
¿Exportas café, cacao u otra materia prima y tus compradores ya te preguntan por la EUDR? Solicita una evaluación gratuita y revisamos qué necesitan tus datos de trazabilidad.
Cronología
- Febrero de 2026: especificación del MVP arquitectónico definitivo, acordada con el cliente.
- 28 de febrero de 2026: monorepo, modelo de datos, seguridad a nivel de fila, triggers y el RPC atómico de códigos de lote; backend y tablero arrancan el mismo día.
- 3 de marzo de 2026: campos de SICA, FNC, ICA y EUDR en productores, fincas, parcelas y lotes.
- 11 de marzo de 2026: vista pública por QR, notificaciones por correo, perfiles y mapas.
- 14 de marzo de 2026: verificación de integridad retrocompatible, tableros por rol y la experiencia del productor.
- 27 de marzo de 2026: entrega del código, la base de datos, el hosting y el dominio en las cuentas propias del cliente.
Resultados
Prueba de origen incorporada
Cada lote lleva una historia a prueba de manipulaciones, desde el polígono de la parcela hasta el muelle de entrega, que un comprador puede verificar con la cámara del celular. La integridad la garantiza la propia base de datos, no un procedimiento.
Listo para la EUDR desde el primer día
Fincas geo-referenciadas, linderos de parcelas dibujados sobre satélite y marcas de libre de deforestación le dan a Loski la base de datos que hoy exigen los compradores y reguladores europeos, sin una herramienta de cumplimiento aparte.
Un núcleo que crece sin reescribirse
El modelo de eventos ya contempla sensores IoT, verificaciones satelitales y sistemas externos como nuevas fuentes de eventos, sobre infraestructura que Loski controla de punta a punta. Mira las pantallas en el caso de Loski.
Preguntas frecuentes
¿Qué necesita un software de trazabilidad de café para cumplir con la EUDR?
Como mínimo, un vínculo confiable entre cada lote y las parcelas geolocalizadas de las que proviene, además de evidencia de que esas parcelas están libres de deforestación. LOSKI TRACE guarda las parcelas como polígonos sobre imagen satelital con marcas EUDR y liga a ellas cada evento del lote.
¿Cómo confía un comprador en que la historia del lote no fue editada?
Los eventos no se pueden editar ni borrar, ni siquiera con acceso directo a la base de datos, porque un trigger lo impide. Cada evento se sella con SHA-256, y los compradores pueden verificar los hashes por su cuenta escaneando el QR del lote.
¿El QR público expone datos sensibles de la finca o comerciales?
No. La vista pública muestra la historia del lote, pero oculta por diseño los documentos de identidad, las coordenadas, los precios, los compradores y los documentos. Todo eso se queda en la plataforma privada.
¿El equipo de campo puede usarlo desde el celular?
Sí. El asistente de eventos está hecho para móvil, así que el equipo de campo registra cada paso con fotos y GPS, y el productor tiene su propio tablero.
¿Este tipo de plataforma sirve para otras cadenas de suministro?
En principio, la arquitectura no es exclusiva del café: un registro de eventos inmutable y sellado, ligado a orígenes geo-referenciados, aplica a muchas cadenas de suministro. Para otros proyectos de logística, mira nuestro motor de documentos de carga para Kila y el marketplace de carga de ANT Mobility.
Haz verificable tu cadena de suministro
Loski pasó de registros en papel a un núcleo de trazabilidad que los compradores pueden verificar por sí mismos, en cuatro semanas. Lee el caso completo de LOSKI TRACE para ver la arquitectura y las pantallas.
Solicita tu evaluación gratuita o agenda una llamada para conversar sobre tu trazabilidad.