Cacao Trazable · Maicao — Trazabilidad con QR
Bitácora del proyecto. Autor: Carlos Alberto Rojas Domínguez.
Dirección publicada
Qué es
App web de un solo archivo (index.html) para seguir un lote de cacao desde la finca
hasta el país de destino. Cada etapa se guarda como un "bloque" encadenado al anterior
con una huella SHA-256, igual que en una blockchain. Cada lote genera un código QR.
Etapas registradas
Cultivo → Cosecha → Fermentación → Secado → Acopio y venta → Transformación →
Exportación → Llegada a destino. Cada una guarda fecha, responsable, documento/NIT,
lugar y datos técnicos propios (kg, humedad, precio, puerto, destino, contenedor…).
Cómo usarla
- Abrir
index.html en Chrome o Edge.
- "Cargar lote de ejemplo" para ver un lote completo (Dibulla → Maicao → Santa Marta → Hamburgo).
- "Registrar etapa" para agregar etapas a lotes propios.
- "Trazabilidad y QR": ver la línea de tiempo, la verificación y descargar o imprimir el QR.
- "Simular manipulación" muestra cómo la cadena detecta un dato alterado (para la exposición).
Para que el QR funcione en un celular
El QR contiene el lote completo comprimido más las huellas, y abre esta misma página.
Hay que publicar index.html en internet (por ejemplo GitHub Pages o Netlify, gratis)
y escribir esa dirección en el campo "Dirección pública" antes de generar el QR.
Decisiones
- 2026-10-27 — Sin servidor ni base de datos: los datos viven en el navegador
(localStorage) y viajan dentro del QR. Suficiente para la demostración académica.
- 2026-10-27 — El QR lleva los datos, los primeros 8 caracteres de cada huella y la
huella final completa; al abrirlo se recalcula toda la cadena y se compara.
- 2026-10-27 — Alcance: es una cadena de hashes, no una blockchain distribuida. En
producción se anclarían las huellas en una red pública (Polygon/Ethereum) o
permisionada (Hyperledger Fabric).
- 2026-10-27 — Publicada en GitHub Pages; el lote de ejemplo se carga solo si el
navegador no tiene lotes guardados, para que la página nunca se vea vacía.
- 2026-10-27 — Logo MA&CAO, modo claro/oscuro, lote de ejemplo en Ecuador (Vinces → Guayaquil → Hamburgo).
- 2026-10-27 — Desplegada en Vercel (equipo Ventas); los QR generados fuera de un sitio web apuntan a cacao-trazable.vercel.app.
- 2026-10-27 — Vistas por actor al escanear (comprador/importador, entidad de control, productor),
verificaciones automáticas para control (integridad, fechas, geolocalización UE 2023/1115,
humedad NTE INEN 176, balance de kilos, DAE/contenedor), etiquetas de sacos con QR propio
(
&s=N&n=TOTAL en el enlace) y 14 lotes de ejemplo (001–014), algunos con fallas a propósito.
- 2026-10-27 — Códigos de trazabilidad alineados con la presentación: productor PRD-provincia-nº,
guía de compra COM-año-nº, lote MAC-EC-año-nº, saco lote-Snn, contenedor ISO 6346 con dígito de
control calculado y verificado (ej. MSCU 000014-1), precinto y recepción REC-puerto-año-nº.
Los lotes de ejemplo se regeneran al cambiar VERSION_EJEMPLOS; los lotes propios no se tocan.
- 2026-10-28 — Acceso por rol: el precio pagado al productor se sella con huella con sal y viaja
cifrado (AES-GCM, clave derivada con PBKDF2) dentro del QR, una copia por rol. El comprador no lo
ve; productor y entidad de control entran con su clave. Claves de demostración:
productor
FINCA-2026, control CONTROL-2026 (se cambian en la pestaña Lotes).
- Los nombres del lote de ejemplo son ficticios.
