EN

← Portfolio · Caso · SaaS para cafés

UNNA: sistema para cafés take away

Un café take away necesita vender rápido en el mostrador, cobrar con QR, facturar y controlar caja y stock sin pagar un sistema pensado para restaurantes grandes. UNNA es ese sistema, construido con arquitectura hexagonal y más de 1.400 tests.

Mauro José Ciappina · NestJS · Next.js · Prisma · PostgreSQL · Mercado Pago · ARCA · código en GitHub · demo en vivo

01El problema

Los sistemas de gastronomía existentes están pensados para salones grandes: demoran en el mostrador, complican el cobro simple y salen caros para un café que vende café para llevar. Del otro lado, armar algo propio sin arquitectura termina en un POS frágil donde el dinero depende de código frágil.

UNNA cubre el ciclo completo del café take away: catálogo, POS para vender en el mostrador, caja y stock, cobro con QR de Mercado Pago, facturación electrónica y pedido anticipado con pago online.

02La arquitectura

Monorepo con el dominio en un paquete propio

Un monorepo con NestJS, Prisma y PostgreSQL para la API y una web en Next.js. Las reglas del negocio (precios, pedidos, cobros, stock) viven en un paquete de dominio propio con arquitectura hexagonal: los controladores son adaptadores finos y toda decisión de dinero se tests primero. Con más de 1.400 tests entre dominio, API y web, y CI en GitHub Actions en cada PR.

Sesiones y concurrencia

Las sesiones usan tokens rotativos de un solo uso: un token reutilizado invalida la sesión. Donde dos concurrentes pueden chocar —pagos, stock, edición del negocio— hay bloqueos de fila en PostgreSQL, no promesas de JavaScript.

03Cobros con Mercado Pago

El problema

Cada café cobra con su cuenta de Mercado Pago. Un mistake acá no es un bug: es dinero que entra a la cuenta equivocada, o un pago que se registra dos veces.

Cada café conecta su cuenta por OAuth; los tokens se guardan cifrados. El webhook de mercado firma cada notificación con HMAC, se valida la firma antes de tocar la base y el pago se registra exactamente una vez: reintentos, duplicados y notificaciones fuera de orden terminan en el mismo estado final.

04Facturación y stock

La facturación electrónica con ARCA exige numeración correlativa sin huecos ni duplicados: el número de factura se emite con una resolución protegida por bloqueo de fila, y dos cajas cobrando a la vez no producen nunca el mismo número.

El pedido anticipado permite pedir con pago online antes de pasar a buscar; el modo hora pico y la pantalla pública de pedidos cubren el tramo del mostrador donde el café no puede frenar la fila.

05Lo que dejó

Resultado

Demo pública funcionando en Vercel, Render y Supabase. Más de 1.400 tests y CI en GitHub Actions. El documento ODD del proyecto, con el pedido y las decisiones registradas, es público: odd/tasks/unna-platform.md .