roastbook

Roastbook actúa como un diario digital para la cafetería en casa, gestionando todo el ciclo de vida del café: desde la compra de bolsas hasta el análisis de extracciones. Su arquitectura se basa en un stack TypeScript seguro (TanStack Start, Zod) que separa estrictamente la lógica del servidor del cliente. La aplicación permite escanear etiquetas de granos mediante IA para extraer origen y proceso, investigar perfiles de tostadores y recuperar especificaciones técnicas de máquinas de espresso desde manuales oficiales.

Para el despliegue, se recomienda usar Docker Compose con PostgreSQL y almacenamiento local o S3-compatible. Incluye un proxy de autenticación Hodor por defecto para proteger la base de datos y los recursos de almacenamiento. La interfaz es responsiva, optimizada tanto para uso móvil en la máquina como para análisis detallado en escritorio mediante gráficos y estadísticas filtrables.

Las funcionalidades avanzadas incluyen gestión de recetas editables, seguimiento de visitas a cafeterías con mapas y análisis de consistencia (grano, método, equipo). La IA opera de forma opcional, requiriendo una clave API compatible con OpenAI para funciones de extracción e investigación, mientras que el núcleo de la aplicación funciona sin ella.