# Piqero

**Pedir y pagar desde la mesa.**

Piqero es una plataforma para restaurantes y para los locales que comparten un mismo lugar: pedidos, mesas, cocina y caja. Lo cofundé y lo construyo entero — producto, diseño y código. Está en producción y todavía no lo usa ningún local.

- Rol: Cofundador y developer.
- Período: 2026 — hoy
- Estado: Activo
- Trabajo: Producto, Full-stack, Diseño, Negocio
- Sitio: https://piqero.app

## El problema

Un restaurante funciona sobre información que no se queda quieta. Qué pidió
cada mesa. Qué empezó la cocina de verdad. Qué se cobró y qué no. Quién tiene
permiso para anular una línea.

La mayoría de los locales tiene todo eso en una mezcla de papel, grito y un
sistema de punto de venta diseñado antes de los smartphones. Funciona, en el
sentido de que la gente come. Falla de una forma concreta: nadie puede
contestar una pregunta sobre la última hora sin caminar a algún lado y
preguntarle a una persona.

El software que existe para arreglarlo está hecho para una cadena de
doscientos locales y cuesta lo que eso implica, o es un menú en PDF.

## De dónde salió

En tercer año del colegio, un equipo de cuatro armamos **Pedilo**: una carta
para pedir desde la mesa, que servía para un solo restaurante. De ahí salió
**Restoman**, la versión para muchos locales, que lanzamos en Bibi's en
septiembre de 2026.

La idea de muchos locales salió de una cena. Alguien me explicó cómo funcionan
los centros comerciales, y volviendo a casa entendí que lo interesante no era
un restaurante, sino unir a los restaurantes que comparten un mismo lugar:
cada uno con sus pedidos, y un solo sistema que los conecta.

En octubre de 2026 el equipo se separó, y Piqero es lo que construyo desde
entonces.

## Las restricciones

Todavía en el secundario. Sin inversión. Y la que marca cada decisión: **un
local tiene que seguir atendiendo mientras lo instalamos.** Nada puede
requerir que el personal pare y aprenda un sistema, y nada puede tener un paso
que solo funciona si alguien se acuerda de hacerlo.

## Qué es, en realidad

No una app. Cinco, en un monorepo de Turborepo sobre workspaces de Bun:

- **`api`** — todo el dominio. **Elysia**, tipada de punta a punta, con un
  documento OpenAPI que los frontends consumen por **Eden Treaty**, así un
  cambio en una ruta es un error de tipos en la consola y no un bug en
  producción. **Better Auth**, **Drizzle** sobre **Postgres**, **Redis**.
- **`operator`** — Next 16 y React 19. Lo que usa el negocio: locales, carta,
  pedidos, estaciones de cocina, caja, plano del salón, roles y planes. Una
  sola consola que se adapta del teléfono en el pase a la computadora de la
  oficina.
- **`diner`** — Next 16. Lo que usa el comensal. Entrás escaneando el QR de tu
  mesa. Anda como invitado anónimo o con cuenta por OTP, porque pedirle a
  alguien que se cree una cuenta antes de poder pedir una hamburguesa es como
  se pierde el pedido.
- **`admin`** — donde manejamos planes, períodos de prueba y clientes.
- **`landing`** — el sitio público, con una demo que se recorre con el
  scroll: un pedido va del teléfono del cliente a la cocina y a la caja, y
  podés tomar el control en cualquier paso.

Más paquetes compartidos que existen porque dos apps necesitaban la misma
respuesta: `permissions` (el vocabulario de RBAC y un resolver puro, usado por
la API y por el editor de roles, así lo que otorga acceso y lo que dibuja la
UI no pueden estar en desacuerdo), `ui` (el design system — Base UI, CVA,
Motion, tokens espejados de Figma), `features` (feature flags), `schemas`,
`i18n`, `logger`.

## Qué decidí

Cinco decisiones que tomé y que defiendo.

### Organizaciones y RBAC propios, en vez del plugin de auth

El plugin modela una empresa plana: miembros, roles, listo. Un grupo
gastronómico es una jerarquía — grupo, local, piso, estación — y un permiso
tiene que heredar hacia abajo **sin** escalar nunca hacia arriba ni al costado.

La alternativa era dejar el plugin y modelar la jerarquía al lado,
consultándola después de que el plugin contestara. Habría funcionado, y habría
significado dos fuentes de verdad para una pregunta. Cada chequeo habría
tenido que preguntarle a las dos y reconciliar, y la primera vez que no
coincidieran tendríamos un bug de seguridad y no uno de renderizado.

Así que es nuestro schema, con la herencia resuelta **por permiso** y no por
rol: no "un encargado puede hacer X", sino "este permiso hereda hacia abajo
desde el scope donde se otorgó". Más código, y es nuestro. Vale la pena,
porque los permisos son la única parte de este sistema donde aproximadamente
bien y mal son lo mismo.

### La posición de un plato es de la relación, no del plato

Un ítem aparece en varios contextos — la carta, una sección, una estación de
cocina — y puede estar ordenado distinto en cada uno. Hacer que la posición sea
una columna del ítem fuerza un orden global. Hacerla una propiedad del par
contexto-ítem significa que **no ordenar es simplemente heredar**.

Esa está implementada y marcada para rehacer. Funciona, y mover un solo ítem
escribe N filas. Prefiero decirlo acá que alguien lo encuentre.

### El cache es fail-open, asimétricamente

Un miss de cache degrada a una lectura más lenta. Un error de cache no puede
degradar nunca a un permiso equivocado. Y los tokens efímeros viven fuera del
cache, porque no son cache: son estado que además expira.

### Los overlays del comensal portalean dentro del scope de tema del local

Cada local tematiza su propia app del comensal. Los modales renderizados en la
raíz del documento se escapaban de ese scope y salían sin estilos. El arreglo
es chico; lo útil es la regla que dejó, y está escrita para que no se
redescubra.

### La caja es una pantalla para cobrar, no un reporte

Investigada contra Toast, Fudo y Mercado Pago antes de dibujar nada. Lo que las
tres aciertan es que la persona en la caja está apurada y todo lo que está en
pantalla o es el monto o está estorbando.

## Dónde está

En producción en **piqero.app**: la consola, la app del comensal, el admin y
la API. **Todavía no lo usa ningún local.**

El próximo local entra como nos enseñó
[el lanzamiento en Bibi's](/es/notes/restoman-bibis-launch): alguien ahí mientras
pasa, el flujo completo probado antes del primer servicio, y los pagos
conectados y probados antes del día de lanzamiento, no descubiertos ese día.

## Qué haría distinto

Empezar el design system antes de las pantallas, no después. Volver a mirar el
orden por contexto antes de que le creciera una segunda implementación encima.
Y armar el monitor que toca la base antes del primer cliente, no después de la
primera noche en que habría detectado algo.

---

Página: https://eitanf.com/es/work/piqero · English: https://eitanf.com/work/piqero.md · llms.txt: https://eitanf.com/llms.txt
