Archivo · bitácora de un proyecto en curso: las dos primeras versiones se archivan, el desarrollo sigue como TOSTA · volver a nllsn.net
nllsn.net / archivo / tosta 2 oct — 17 nov 2026
Bitácora de desarrollo

De una curva de tueste a un ERP

TOSTA es el sistema de gestión que estoy construyendo para tostadurías de café de especialidad, empezando por ASUNTO. El nombre es un acrónimo: Tostaduría: Operación, Stock, Trazabilidad y Administración. Esta página reúne cómo llegó hasta aquí, con capturas de cada etapa.

En las capturas, los montos, las cifras, las fechas y los nombres aparecen como XX o XXXX.

Qué quiero lograr

IntenciónCómo se ve en TOSTA
Crear valor que hoy no está en el mercadoUna herramienta pensada desde cómo trabaja una tostaduría de especialidad, no adaptada desde un sistema genérico.
TransparenciaCada envase lleva un QR que muestra el origen del café, su cata y la curva de su tueste.
Comunicación real con los clientesLos clientes hacen sus pedidos, siguen su estado, reciben avisos y conversan con la tostaduría desde el mismo portal.
Una herramienta para los dos ladosLa tostaduría la usa para operar y sus clientes para comprar y saber qué compran. Quiero que ambos la valoren y le den uso.

Commits por día

Cinco repositorios · los números marcan los hitos
Commits por día, del 1 de octubre al 17 de noviembre de 2026 93 commits en total. Picos el 2 de octubre (17), el 5 de octubre (21) y el 25 de octubre (38). Los siete hitos de la bitácora están marcados sobre la fecha en que ocurrieron. 0 10 20 30 40 1 oct 5 oct 12 oct 19 oct 26 oct 2 nov 9 nov 16 nov 1 2 3 4 5 6 7 17 21 1 38 2 1 4 1 5 3

Un commit puede ser una línea o un módulo entero: el fork de noviembre cabe en seis. El gráfico muestra el ritmo del trabajo, no su tamaño. Las semanas sin barras fueron de conversación y definición.

  1. 12 octVisor de curvas
  2. 25 octERP en un día
  3. 324 octDefinir antes de construir
  4. 425 octPortal y estación
  5. 51 novLenguaje visual
  6. 611 novTodos los módulos
  7. 717 novTOSTA
01 2 — 5 oct 2026
Artisan.alogarchivado

Todo partió por querer ver los tuestes

La tostadora, una Giesen W6A, registra cada tueste en Artisan, que guarda un archivo .alog por bache. Con Hermes, el agente que corre en mi servidor, armé un visor que leía esos archivos desde Nextcloud y mostraba los últimos diez tuestes, cada uno con su curva y su control de calidad.

La curva muestra la temperatura del grano y del aire, la tasa de subida, el gas y el ventilador, y marca los hitos del tueste: carga, punto de retorno, primer crack y descarga. A partir de esos hitos calcula el secado, la fase de Maillard y el desarrollo.

Con datos reales aparecieron detalles que no se ven en una prueba: Safari no dibujaba la curva hasta que se cambió la forma de trazarla, y en los archivos de la Giesen los canales del grano y del aire venían invertidos.

Gráfico de un tueste en el visor, con las cifras ocultas: temperatura del grano en naranjo, del aire en azul y tasa de subida en verde; abajo, las líneas de gas y ventilador y los hitos del tueste.
fig 1Un tueste en el visor, con las temperaturas, los tiempos y los porcentajes ocultos.
02 5 oct 2026
PythonSQLitearchivado

Un ERP completo en un día

Con los baches ya a la vista, la idea creció hacia el resto de la tostaduría. Hermes generó en un día un ERP con inventario, tueste, calidad, logística y facturación, unidos por una sola cadena de estados, escrito en Python sin dependencias y con SQLite.

Funcionaba, pero se construyó antes de definir cómo trabaja la tostaduría, y buena parte de su modelo no calzaba con la operación real. Casi todo cambió cuando lo conversamos en detalle.

Pantalla de ingreso del ERP Tostadurías, en inglés: campos de usuario y contraseña y un botón naranjo de Sign in sobre fondo oscuro.
fig 2La entrada del ERP Tostadurías. El código quedó en inglés, con una capa de traducción al español encima.
03 5 — 25 oct 2026
definicióndocumentos

Definir antes de volver a construir

Entre el 5 y el 7 de octubre conversé con Hermes la definición completa: los módulos de operación y de administración, lo que cada tostaduría debe poder configurar, un portal para clientes HORECA y la página pública que abre el QR de cada envase. El documento final pasó de 1.500 líneas.

El 24 de octubre llevé ese material a Claude. Lo primero fue ordenarlo: una definición funcional por módulo, un glosario, la lista de parámetros y un documento con cada contradicción entre el ERP anterior y la conversación, que se fueron cerrando una por una.

Los dos desarrollos anteriores quedaron como referencia de lo que funcionó y lo que no. De ellos no se copió código.

04 25 oct — 10 nov 2026
FastAPIPostgrespreproducción

El portal HORECA y la estación del tostador

La primera pieza construida sobre la definición fue el portal para cafeterías y restaurantes: catálogo, un carrito que se guarda solo, condiciones por cliente, documentos, pedidos recurrentes y un foro. El 26 de octubre quedó aprobado para preproducción; hasta el 10 de noviembre se le sumaron avisos por correo, cambios de fecha con motivo y respuestas en el foro.

Ese mismo 26 de octubre se definió la estación del tostador: una cola con los pedidos de todos los canales, una lista de trabajo que calcula los tuestes en orden y una pantalla para ejecutar cada tueste junto a Artisan e imprimir la etiqueta del bache en una Zebra. Desde ahí, el bache deja de ser un formulario: nace del tueste.

Portal HORECA, pantalla Nuevo pedido con los datos ocultos: los últimos pedidos con botón para repetirlos, local de destino, fecha de entrega y una línea para elegir café, formato, molienda y curva.
fig 3El cliente arma su pedido o repite uno anterior.
Cola del tostador, con los datos ocultos: tabla de pedidos por tostar con cliente, café, formato y molienda, curva, kilos y fecha, filtrable por canal.
fig 4La cola del tostador junta los pedidos HORECA y los de la tienda en línea.
05 1 nov 2026
IBM Plexdos versiones

Una dirección visual propia

Hasta aquí las pantallas tenían colores y temas, pero no una dirección. Comparé dos versiones de la misma cola con datos ficticios. La primera partía de una planilla de tueste que en la operación real no existe. La elegida, «Etiqueta y curva», toma lo que sí está en la tostaduría: la etiqueta impresa del bache y la curva de Artisan.

Quedó con la tipografía IBM Plex, un fondo neutro y un solo color de marca que cada tostaduría puede cambiar sin tocar el resto.

Versión A de la cola: fondo crema, texto pequeño y un panel lateral con los tuestes que resultan.
fig 5Versión A, descartada.
Versión B de la cola: fondo blanco, filas más altas y una barra inferior con el botón Enviar a tostar.
fig 6Versión B, «Etiqueta y curva», la que quedó.
06 11 — 15 nov 2026
todos los módulosdatos ficticios

Todos los módulos, en paralelo

Para no tocar el portal en preproducción, el 11 de noviembre armé con Claude una copia interna con todos los módulos de la definición y datos ficticios: café verde con su costo, tueste, calidad, envasado con etiquetas QR, pedidos de todos los canales, despachos, documentos tributarios, cuentas por cobrar y por pagar, conciliación bancaria, costos y márgenes, permisos por rol y 76 parámetros.

Nada propio de ASUNTO está escrito en el código: el nombre, el logo, los colores y el RUT salen de la configuración de la empresa. La validación final corrió 497 chequeos automáticos y dos vueltas de revisión independiente, que encontraron 15 problemas de permisos, costos y pagos antes de cerrar.

Pantalla Hoy, en tema oscuro con la marca amarilla de ASUNTO y las cifras ocultas: pendientes por tostar, en la lista, por catar, por envasar y por despachar; una lista de diez alertas y, abajo, indicadores de ventas, tiempos de despacho, cuentas por cobrar y café en stock.
fig 7«Hoy»: lo pendiente en cada etapa, las alertas del día y los indicadores.
Página pública del bache en el teléfono, con los datos ocultos: café, fecha y tostadora, origen y secciones de cata y curva de tueste.
fig 8Lo que ve quien escanea el QR del envase.
07 17 nov 2026

Dónde va hoy

El ERP ya tiene nombre: TOSTA. El portal sigue en preproducción y la copia completa se revisa parte por parte para decidir qué pasa a la versión oficial. Entre lo pendiente están la conexión con el SII para los documentos tributarios y volver a hacer el módulo de curvas, esta vez conectado al bache, al saco y a la cata.

Las dos primeras versiones dejan de mantenerse. Esta página es su registro:

  • Visor de curvas 2 — 25 oct · 19 commits
  • ERP Tostadurías 5 — 25 oct · 22 commits
Conversemos

¿Sabes qué necesita tu negocio? Yo lo construyo.

TOSTA existe porque la tostaduría es mi negocio y la conozco por dentro. Si tú conoces el tuyo y sabes lo que necesitas, pero no sabes cómo hacerlo, yo lo hago. Conversemos.

Solo guardo nombre, correo y mensaje para responderte. Nada de listas ni terceros.