POSpastel: punto de venta de la pastelería
3 screenshots

POSpastel: punto de venta de la pastelería

Caja de mostrador en producción para una pastelería familiar que sigue cobrando sin internet, con pedidos de pastel, cortes, producción, facturación CFDI y cámaras.

Qué es

El sistema con el que cobra a diario la Pastelería La Guadalupana, con dinero real, en una tienda donde la luz y el internet se caen varias veces por semana. La regla que manda: la caja nunca deja de cobrar. El repo también incluye una tienda en línea conectada al POS (en desarrollo) y una herramienta interna para leer estados de cuenta del banco.

En corto

  • Venta sin red: las escrituras se encolan en IndexedDB y se sincronizan con Firestore al volver la conexión.
  • Pedidos de pastel con anticipo, abonos, agenda, pantalla de cocina y bitácora de quién cambió qué.
  • Dinero y operación: corte de caja, gastos, préstamos a empleados, producción de pan y pastel, inventario y bodega con QR.
  • Facturación CFDI 4.0 con Facturapi, incluida la autofactura del cliente desde el QR del ticket.
  • Impresión: agentes en Python para la térmica de tickets, el cajón y etiquetas Brother.
  • Cámaras: un servicio en Node con ffmpeg habla con el DVR de la tienda para video en vivo, grabaciones, clips por pedido y una revisión por IA.

Módulo por módulo

Son 63 módulos, sacados de las rutas, el menú y los permisos del código. De cada uno: qué resuelve en la tienda, cómo está hecho y los datos concretos del repo. Las capturas son de una copia local con datos inventados («Cliente Demo 1», productos y precios de ejemplo), sin conexión a la tienda ni a ningún servicio. Algunos módulos van sin captura: los que dependen de WhatsApp, Facturapi o las cámaras solo dicen «no configurado» en una copia local, y otros traen datos reales de la tienda.

Cómo nació y creció

El repo no dice cuándo empezó el proyecto, pero deja huellas: la base ya tenía pedidos de pastel del 24 y 25 de diciembre de 2024, hay un volcado de clientes frecuentes de octubre de 2025 y el diseño original de la producción de pasteles está fechado el 6 de noviembre de 2025. Las cadenas de versión que quedaron en los docs («Versión 1.8 Dashboard», «POSv2.1») muestran que el POS creció a mano antes de tener un sistema de versiones; hoy package.json va en la 4.95.0 y cada despliegue sincroniza la versión entre la app, el service worker y el agente de impresión. La regla que ordena todo salió de la tienda misma: el internet se va varias veces por semana, así que la caja tiene que cobrar sin red y todo lo demás se encola. Las decisiones grandes quedaron escritas como ADRs (32 en el POS, del 0001 al 0032, más uno del repo que separa el producto multi-negocio en su propio repo). Desde mediados de 2026 el crecimiento viene de dos fuentes que el repo registra con fecha: peticiones del dueño citadas textualmente en docs/features/ (línea directa el 29-oct, pantalla sencilla el 30-oct, caja de teclado el 8-nov, cámaras y estados de cuenta el 10-nov, IA que contesta el 12-nov, reportes el 17-nov de 2026) y una lista de candidatos sacados de comparar el POS con Odoo y otros sistemas (docs/research/, con claves como C1 capacidad de pasteles o G3 bitácora de temperaturas). En septiembre de 2026 la PC de la tienda dejó de tener el repo: el POS es la PWA de Vercel y los agentes de impresión corren como programas compilados que se actualizan a distancia. El 19 de noviembre de 2026 una prueba de ataque propia llevó a endurecer las reglas de Firestore, las contraseñas del personal y el agente de tickets. Hay 583 archivos de pruebas unitarias, 80 de reglas de Firestore y 28 de integración contra el emulador. El historial de git no viene en la copia, así que las fechas salen solo de los documentos.

La caja y el cobro

Caja de mostrador

Caja de mostrador del POS con el catálogo de pan y pasteles y un carrito de seis piezasCaja de mostrador del POS con el catálogo de pan y pasteles y un carrito de seis piezas (teléfono)
La caja donde se cobra todo el día: catálogo por categoría a la izquierda y la orden a la derecha, con efectivo, tarjeta, link, pago mixto o fiado. Tres órdenes abiertas a la vez para no perder un carrito cuando llega otro cliente.

Es la pantalla donde la cajera cobra todo el día: catálogo por categorías, carrito, efectivo o tarjeta, ticket y cajón. La raíz de la app manda aquí. Permite atender a varios clientes a la vez con órdenes independientes, por ejemplo pausar un pedido de pastel mientras se cobra un pan.

Cómo está hecho. La regla del proyecto es que esta pantalla nunca deje de cobrar. La venta se guarda antes que todo lo demás (ADR-0003): impresión, cajón e inventario van después y pueden fallar sin perder la venta. Las ventas son append-only (ADR-0002): un error se compensa con un movimiento nuevo, nunca se edita ni se borra. La venta guarda cómo se pagó y no solo con qué (ADR-0009), y el dinero se redondea al escribirse en lugar de migrar a centavos (ADR-0008).

  • La medición de agosto de 2026 sobre 71,190 ventas y 3,405 pedidos encontró que el 99.67 % del dinero guardado ya era entero; de 906 decimales solo 26 diferían de su redondeo (PROJECT-CONTEXT.md).
  • Órdenes en paralelo guardadas por equipo, para no perder un carrito al cambiar de cliente.
  • Los ids cortos de venta son siempre los últimos 4 caracteres, en todas las pantallas, para que el buscador sirva.
  • La prueba Cypress OfflinePOS.cy.ts cubre la caja sin red.

Caja de teclado

Una segunda forma de la caja para quien cobra con el teclado y casi no toca el ratón: se busca escribiendo, Enter agrega y F12 cobra. Cada empleado escoge la clásica o esta. La pastelería no usa códigos de barras, así que todo se busca por nombre.

Cómo está hecho. Se trajo del producto multi-negocio, donde se hizo al estilo de Eleventa, dejando las dos versiones a escoger como pidió el dueño el 8 de noviembre de 2026. El modo vive por empleado (utils/modoDeCaja) y cada modo tiene su propio ámbito de atajos en el registro único de utils/atajos.ts; en este modo sus teclas ganan a las globales dentro de /orders.

  • F1 a F8 abren pantallas (Ventas, Gastos…) solo en este modo; Ctrl+P agrega un artículo libre y Ctrl+D un descuento.
  • Las letras se leen por la tecla física (code) y los signos por el carácter (key), porque la caja usa teclado latinoamericano y a veces uno de EE. UU.
  • 5 archivos de pruebas unitarias (cajaDeTeclado, modoDeCaja, modoDeCajaIrYVolver, busquedaDeLaCaja, enterDeLaCaja).

Cobro: descuentos, pago mixto, vales, devoluciones y fiado

Todo lo que le puede pasar al dinero de una venta entre el carrito y el cajón: descuentos, pagar con varias formas, vales de despensa, devoluciones y fiado con tope. Lo sensible (descontar, anular, fiar, pasar el tope) se enseña siempre y pide la contraseña de alguien que sí tenga el permiso, para no dejar al cliente esperando.

Cómo está hecho. Se documenta en un solo archivo (docs/features/cobro.md) porque es una sola cuenta: cambiar una pieza sin mirar las otras daba cifras distintas del mismo día. Los vales de despensa son venta pero nunca efectivo del cajón (ADR-0025). El cobro con tarjeta guarda solo la autorización y los últimos 4 (ADR-0017).

  • Si no hay nadie con el permiso en la tienda, la caja puede pedir la aprobación a la dueña en su teléfono (ver Aprobaciones a distancia).
  • Las acciones de mostrador piden contraseña; el resto de los permisos esconde el botón (alFaltar en utils/permisos.ts).
  • Pruebas unitarias dedicadas como descuentos, devoluciones, devolucionDeVenta, credito, vales, ventaConValesYRegalo y anulaciones.

Terminal Point de Mercado Pago

La caja manda el cobro con tarjeta a la Point Smart 2: la terminal enseña el monto, el cliente paga y el resultado vuelve solo al POS con la marca y los últimos 4. Se acabó teclear el monto en la terminal y copiar el voucher. En Administración se conecta, se hace un cobro de prueba y se revisan y devuelven los cobros de la semana.

Cómo está hecho. El cobro vive en su propia colección cobros_terminal y la venta solo lleva la marca (ADR-0024). El servidor cobra con idempotencia, una orden por terminal, y resuelve los cobros «por confirmar»; un webhook firmado trae el resultado y hay una terminal simulada para el emulador. La caja recupera cobros aprobados que no quedaron registrados, y anular una venta de la Point devuelve el cobro.

  • En producción desde el 8 de octubre de 2026, con un cobro de prueba de $10 aprobado y devuelto (PENDIENTES.md).
  • «Cobra en la Point» aparece en los cinco lugares de la caja que cobran con tarjeta.
  • El corte separa lo cobrado en la Point; la propina entra a Mercado Pago y no la suma.
  • 4 archivos de pruebas unitarias (terminalPoint, cobrarEnLaPoint, pasoDeLaTerminal, otraTerminalSinCobroDoble) y reglas en cobrosTerminal.

Lealtad, promociones y tarjetas de regalo

Sellos por lo cobrado, puntos o monedero con vencimiento, cupones y promociones con regla como «martes 3×2» que la caja aplica sola, sin motivo ni contraseña. Las tarjetas de regalo se configuran en la misma pantalla. Lo decide el dueño; la cajera la abre para ver qué promoción hay hoy.

Cómo está hecho. Es el «Diseño D» de la investigación de módulos de Odoo para la pastelería. Los puntos son un libro de movimientos, no un contador. Una venta lleva una sola promoción y nunca encima de un descuento manual. Vender una tarjeta de regalo no es venta (es ingreso de caja); gastarla sí, con el método regalo. Todo nace apagado: sin encenderlo, la caja es idéntica.

  • La escritura de config/lealtad solo la permiten las reglas a la cuenta del dueño, aunque la pantalla la vea cualquiera.
  • El corte cuenta la tarjeta de regalo en los dos momentos: al venderla y al gastarla.
  • Pruebas unitarias: lealtad, puntosDeLealtad, cupones, tarjetasDeRegalo, anularTarjetaDeRegalo; y reglas en lealtad, puntosLealtad, tarjetasRegalo y cupones.

Recargas y pago de servicios

Pantalla de recargas de tiempo aire en modo simulado
Tiempo aire y pago de servicios desde la misma caja. En esta captura corre en modo simulado contra el emulador: no hubo ninguna recarga real.

Tiempo aire, paquetes y pago de recibos (luz, teléfono, agua, cable) cobrados en efectivo en el mostrador y mandados por SIPREL. Tiene pestañas para recargar, pagar un servicio y ver lo de hoy; el historial y resolver a mano son del dueño.

Cómo está hecho. Es su propio apartado y no un renglón del carrito a propósito: el dinero de una recarga es de la compañía, así que no entra a orders, ni a los resúmenes, ni a las ganancias. Al corte llega solo como billete del cajón. Solo efectivo, porque la comisión del banco con tarjeta se come casi toda la ganancia. Una revisión de dinero cerró la vía de mandar dos veces una recarga cuyo resultado no se sabe.

  • Módulo publicado en la versión 4.35.0 del POS (7-oct-2026).
  • El estado de cada transacción se consulta cada 5 s (antes cada 2 s) y la comisión por omisión es 6 % (PENDIENTES.md).
  • La comisión de tarjeta citada en el doc es de ~3.5 %.
  • 5 archivos de pruebas unitarias (recargas, recargasTope, esqueletoDeRecargas, historialDeRecargas, ticketAutomaticoDeRecargas), uno de reglas y uno de integración.

Turno y bloqueo de caja

Caja bloqueada esperando que alguien abra turno con su contraseña
Una caja con personal registrado se bloquea hasta que alguien abre turno con su contraseña personal. A partir de ahí cada venta lleva su nombre; tras 15 minutos sin uso, se vuelve a bloquear.

La empleada abre turno con su contraseña al llegar y todo lo que hace queda firmado con su nombre. Si se aleja, la caja se bloquea sola y pide abrir turno otra vez. Separa quién está en el mostrador de qué equipo se usa.

Cómo está hecho. La cuenta de Firebase identifica la caja; el turno identifica a la persona (ADR-0005). El turno vive en localStorage y se sincroniza entre pestañas escuchando los cambios de almacenamiento. Sin ningún empleado dado de alta la app no se bloquea, para que un equipo nuevo no quede inservible sin forma de arreglarse desde dentro. authorLabel nunca cae al nombre de la cuenta: un ticket con el nombre de la cuenta cuando cobró otra persona es un error.

  • Se cierra a los 15 minutos de inactividad (SHIFT_IDLE_MS) y revisa el vencimiento cada 15 s.
  • La firma copia el nombre dentro del documento; se verificó el 18-ago-2026 que borrar un empleado no borra su firma.
  • Pruebas unitarias shift, candadoDeTurno, turnoEntrePestanas.

Pantalla sencilla

Pantalla sencilla con ocho accesos grandesPantalla sencilla con ocho accesos grandes (teléfono)
Una versión del POS con solo ocho cuadros grandes (hoy, cortes, dinero que sale, nómina, abasto, aprobaciones, reportes y banco) para quien solo quiere revisar desde el teléfono.
Resumen del día en la pantalla sencilla (teléfono)
Lo vendido hoy y el dinero que hay, en letra grande y sin menús.

Para la dueña, que lleva el dinero del negocio y no necesita el POS completo: su teléfono enseña ocho cuadros grandes (Hoy, Cortes, Dinero que sale, Nómina, Abasto, Aprobaciones, Reportes, Banco) y Salir. Ve cuánto se vendió y cómo, marca «Recibí el dinero» de los cortes, paga la nómina persona por persona y aprueba lo que piden las cajas.

Cómo está hecho. Es una marca por cuenta (vistaSencilla) que solo vale con papel de administrador, y esconde, no protege: las reglas siguen decidiendo por papel. No calcula nada propio: junta lo que ya calculan el panel, el estado de caja y los cortes, así las cifras cuadran con el resto del POS. La marca se guarda en el equipo para que el teléfono arrancando sin red no enseñe el POS completo. Lo que no se pudo leer sale como «no se sabe», no como cero.

  • Nació el 30-oct-2026; el doc dice que reemplaza un menú de treinta entradas por ocho cuadros.
  • «Dinero que sale» lee 14 días del historial de movimientos.
  • Pruebas unitarias pantallaSencilla y dineroRecibido (reglas).

Venta sin red

Caja cobrando con el aviso de sin conexión a internet
Con la red cortada la caja sigue cobrando: la venta se guarda en el navegador y se sube sola cuando vuelve internet. Aquí se simuló la caída de red en el navegador.

La caja cierra ventas con el módem muerto, el router reiniciando o Firestore sin contestar, y todo se sincroniza solo cuando vuelve la red. Es la regla que manda sobre el resto de la arquitectura, porque la tienda pierde internet varias veces por semana.

Cómo está hecho. Firestore arranca con caché persistente en IndexedDB y manejo multipestaña. La trampa es que en Firebase 11 la promesa de una escritura no se resuelve sin internet, así que lib/db/offlineWrite.ts genera el id localmente, dispara la escritura sin await y devuelve de inmediato, alimentando un registro de pendientes que se limpia cuando el servidor confirma. Las fechas se escriben con hora del cliente en lugar de serverTimestamp() para que un documento en cola tenga fecha. Las lecturas pasan por getDocsResilient, que compite el servidor contra un temporizador y cae a la caché, porque navigator.onLine miente con un WiFi conectado a un módem muerto.

  • El tiempo de espera por omisión de getDocsResilient es 8000 ms; el backoff propio de Firestore es de 10-15 s.
  • Se evitan índices compuestos y se filtra en memoria; un limit(n) sin orderBy ya había truncado resultados en silencio.
  • Pruebas unitarias agrupadorDeEscrituras, escrituraFallida, entregaRechazada, pendientesHuerfanas, seguimientoDePendientes, reconciliacionSinRed, cachePersistente, porQueNoSeGuardo; Cypress OfflinePOS.cy.ts.

Historial de la tienda

Historial de ventas del día con quién cobró y cómo
Todo lo que pasó en la tienda y quién lo hizo: cada venta firmada por la persona del turno, no por la cuenta de la computadora, con su forma de pago y el equipo desde el que se cobró.

Qué pasó, cuándo y quién lo hizo: ventas, movimientos de pedidos, gastos y acciones autorizadas en un solo lugar, con reimpresión de tickets. Es la respuesta a «¿quién hizo esto?», que antes no existía en la app.

Cómo está hecho. Antes el autor se guardaba literalmente como «sistema». Ahora cada acción se firma con la persona del turno, no con la cuenta del equipo (ADR-0005), y la firma es una copia del nombre dentro del documento: borrar a un empleado no deja en blanco lo que firmó. La bitácora del pedido guarda el término del dominio del campo que cambió y sus valores antes y después, no una foto del documento (ADR-0007), y las reglas la hacen de solo agregar.

  • Las reglas desplegadas llevan allow update, delete: if false en la bitácora de pedidos, verificado contra producción el 18-ago-2026.
  • Una venta sin turno abierto queda como «Sin registrar»; nunca cae al nombre de la cuenta.
  • Pruebas unitarias como orderEvents, orderLogState y filtrosDeActividad.

Corte de caja

Pantalla de corte de caja con el estado actual del cajón y los cobros con tarjetaPantalla de corte de caja con el estado actual del cajón y los cobros con tarjeta (teléfono)
Antes de contar, el corte enseña cuánto debería haber en el cajón y lo separa por efectivo, tarjeta, transferencia y anticipos. Los cobros con tarjeta salen uno por uno para cuadrarlos contra el banco.

Cuenta el efectivo del cajón contra lo que debería haber y cierra el periodo desde el corte anterior. Antes de contar, resuelve los pasteles del día que ya debían haberse entregado; luego una rejilla de denominaciones y la diferencia en palabras («Sobran $137.50», «Cuadra»). Es de la tienda, no de un equipo.

Cómo está hecho. Se calcula sobre la caché local para poder cerrar sin red (ADR-0004). La venta de un pedido se parte entre el corte del día del anticipo y el de la entrega (ADR-0001). La fórmula del efectivo esperado es una sola función pura (efectivoEnCaja) que comparte con «Efectivo en caja» del panel. Un corte cerrado se corrige con correcciones registradas, no se rehace (ADR-0031). Avisa si el equipo tenía operaciones sin sincronizar o si la hora de la computadora no cuadra.

  • Rejilla de denominaciones de $1000 a 50¢; una diferencia mayor a $20 pide nota, sin bloquear.
  • Opciones de corte ciego y umbral de firma de encargado (config/corte).
  • Aviso de tope de efectivo en la caja (topeDeEfectivo).
  • 18 archivos de pruebas unitarias del corte (cashCutTotals, corteDeCaja, editarCorte, bitacoraDelCorte, ticketDelCorte, entre otros) y reglas en cortes y editarCorte.

Gastos e ingresos del cajón

Gastos e ingresos del mes con préstamos de cajaGastos e ingresos del mes con préstamos de caja (teléfono)
Lo que sale o entra del cajón fuera de las ventas, separado entre negocio y casa, y quién le debe a la caja. Cada movimiento cuenta en el efectivo esperado del corte.

Apunta lo que sale o entra del cajón fuera de las ventas: el gas, el mandado, un cobro suelto. Así el corte sabe por qué falta o sobra efectivo.

Cómo está hecho. Gastos e ingresos viven en una sola colección (expenses) para que el corte lea un solo lugar. Un préstamo a empleado deja su «sombra» aquí para cuadrar el cajón, pero no se cuenta dos veces. Se separan los gastos del negocio de los de la casa; un script con ensayo y lista de exclusiones propone la clasificación de los gastos viejos.

  • 4 archivos de pruebas unitarias (correccionDeGasto, fechaDeGasto, sugerenciaDeGasto, ambitoDeGasto).
  • Los scripts que tocan producción se niegan a correr sin --si-es-real.
  • Un gasto nuevo sin «Del negocio / De la casa» no se guarda (#140): el corte resta los dos, pero las ganancias solo el del negocio; lo de la casa va a «Retiros del dueño».
  • La casa tiene 6 categorías propias (comida, escuela, salud, pagos_personales, retiro_dueno, otros_casa); los gastos viejos sin ámbito se leen como del negocio, sin migración forzada.

Pedidos de pastel y producción

Pedidos de pastel

Agenda de pedidos de pastel con tarjetas por pedidoAgenda de pedidos de pastel con tarjetas por pedido (teléfono)
Cada pedido de pastel con su entrega, sabor, tamaño, decoración, notas y lo que falta por cobrar. Desde la tarjeta se abona, se pasa a refrigeración, se entrega o se manda el comprobante.

Pasteles por encargo con sabor, tamaño, forma, decoración, fecha de entrega, anticipo y abonos. Incluye cotizaciones que apartan el precio sin anticipo, la hoja del decorador sin dinero, la lista de bizcochos a hornear por día y el comprobante por WhatsApp. Se pueden armar tres pedidos a la vez sin perder ninguno.

Cómo está hecho. Un pedido cancelado y uno borrado son cosas distintas a propósito; ninguno destruye el documento, los dos ponen una marca y se filtran en memoria (un where('campo', '!=', true) habría dejado fuera todos los pedidos anteriores al campo). Los tres borradores viven en localStorage y cada pestaña recuerda el suyo en sessionStorage. «Armar pedido» desde Mensajes deja el borrador en una pestaña libre.

  • Cotizaciones con precio apartado 30 días por omisión; vencida, sale con los precios de hoy.
  • Pruebas unitarias como abonos, abonosConcurrentes, cotizaciones, hojaDelDecorador, bizcochosDelDia y borradoresDeNuevoPedido.
  • Cypress chat-de-pedidos.cy.ts y pedidos-por-ia.cy.ts.

AI Directo: pedidos dictados con IA

La cajera pega o escribe el mensaje del cliente y la IA llena el formulario del pedido: tamaño, sabor, relleno, decoración, cuántos pasteles. Ahorra teclear y reduce errores cuando el mostrador está lleno. En Administración se ve la base de productos que conoce la IA.

Cómo está hecho. Una base vectorizada sustituyó un prompt fijo de 17 KB por búsquedas que solo incluyen los productos relevantes. Después de extraer, el servidor hace una segunda lectura con un modelo rápido que pregunta sí o no por campo si el mensaje dice otra cosa, y solo avisa, nunca cambia el pedido (ADR-0021). La llave del modelo nunca sale del servidor. Hay un plan documentado para una IA local de emergencia cuando no hay internet.

  • La segunda lectura contesta en ~200 ms según el ADR-0021.
  • npm run test:ia corre los casos de pedidos dictados en Cypress; cada caso es una llamada al modelo.
  • Pruebas unitarias como revisionDePedidoIA, rellenoEnAIDirecto y los seis archivos jev*.

Calendario de entregas

Calendario mensual de entregas de pastel
Las entregas del mes por día y hora, con su estado por color. Arriba, cuántas tocan hoy, esta semana y cuántas siguen pendientes.

La agenda de los pedidos de pastel por día de entrega, para ver de un vistazo qué sale cada día y entregar desde ahí. Respeta la capacidad por día cuando está configurada.

Cómo está hecho. Lee los mismos pedidos que /cakes y filtra en memoria los cancelados y borrados. Las fechas de entrega se manejan en hora de la tienda: new Date('2026-12-12') es medianoche UTC, la noche anterior en México, y el código usa startOfInputDate.

  • Pruebas unitarias como entregarDesdeElCalendario, dateRange y rangoDePedidos.
  • Las pruebas unitarias corren en la zona horaria de la tienda (test/zona.ts).
  • Usa FullCalendar en español con tres vistas (mes, semana y día), abre en el mes y la semana empieza en lunes.

Capacidad de pasteles por día

Cuántos pasteles caben en un día, qué fechas no se toman y con cuánta anticipación se puede pedir en línea. Sirve para que el 10 de mayo o Reyes no se sobrevendan sin que nadie lo note.

Cómo está hecho. Es el candidato C1 de la comparación con otros POS. Sin configurar no hay límites: la caja, el calendario y la tienda en línea se comportan igual que antes. La misma regla la consultan la caja y la tienda.

  • Prueba unitaria capacidadDePasteles.test.ts.
  • El tope va por día de la semana (topePorDia; 0 = ese día no se toman pasteles) y la anticipación mínima en horas solo aplica a la tienda en línea.
  • La tienda en línea lee los días llenos de hoy a 60 días; entre la memoria (60 s) y la CDN el dato puede traer hasta ~10 minutos de atraso, y el pedido que se pasa llega a «Pedidos de internet» con el aviso para que el mostrador decida.

Pantalla de cocina

Pantalla de cocina con los pasteles de hoy por hora de entrega
La pantalla de la pared de la cocina: los pasteles de hoy por hora de entrega, en letra que se lee de lejos, con los atrasados en rojo. Es un kiosco: no cobra ni escribe nada.

Una pantalla táctil en la pared de la cocina, donde antes se pegaban los tickets: los pedidos de pastel de hoy por hora de entrega, en vivo, con todo lo del pedido. Se puede ver otro día, abrir un pedido en grande y decir cómo va. La ruta vieja /kitchen está desactivada y solo manda a Pasteles.

Cómo está hecho. Tiene su propio papel de cuenta, cocina: un kiosco sin turno ni menú que solo puede estar en /cocina y entra con código de equipo. Las reglas no lo dejan escribir en ningún lado, y de lo que el POS monta para una caja (cola de impresión, recordatorios, avisos) no le toca nada.

  • Prueba unitaria pantallaDeCocina y prueba de reglas pantallaDeCocina.
  • El doc pantalla-de-cocina.md trae la guía para armarla paso a paso.
  • Si no caben todos los pedidos pasa de página sola cada 12 segundos; «Nuevo» o «Cambió» parpadea unos 45 segundos y, tras 75 segundos sin tocarla, regresa sola a «Hoy».
  • /kitchen está fuera de circulación: solo muestra un aviso con enlace a /cakes y no abre ningún listener de Firestore; el archivo se conserva para que la ruta guardada no dé 404.

Producción y vitrina de pasteles

Control de producción de pasteles con faltantes del día
Cruza los pedidos de pastel con lo que hay en refrigeración y avisa qué falta para hoy. La producción de mañana se imprime sola por la tarde.

Lleva la producción diaria de pasteles desde que se hornean hasta que se venden, se asignan a un pedido o se registran como merma. Responde cuántos pasteles hay en vitrina y de qué.

Cómo está hecho. Nació de un diseño fechado el 6-nov-2025 que juntó dos flujos que no se hablaban. Todo descuento de inventario es un delta o una transacción, nunca un número fijo escrito encima (ADR-0029), después de que la vitrina llegó a −716. La merma lleva valor en dinero, no solo piezas.

  • La impresión vespertina de hojas de producción se prende en Administración.
  • Pruebas unitarias vitrina, vitrinaRestock, escriturasDeVitrina, merma, guardiaDeProduccion; integración vitrinaDosEquiposEmulador.
  • La pantalla tiene 6 pestañas (inicio, asignar a pedidos, registrar producción, inventario de vitrina, gestión e historial); un pastel con más de 4 días en vitrina sale en rojo como «necesita revisión».

Panes: hoja de producción y sobrante

Registro de producción de pan del día y cierre del mostrador
La hoja de pan del día: qué se horneó, en kilos y piezas, para que entre al inventario. Al cerrar, se cuenta lo que sobró y a dónde va: pan de ayer, bolsa sorpresa o merma.

La hoja de pan de mañana, armada con la predicción, los pedidos y los mínimos, con lo que de verdad se vende ese día de la semana y lo que sobra. Al cerrar, registra el sobrante del día y a dónde va. También el menú rápido «¿Qué pan se lleva?» de la caja.

Cómo está hecho. La hoja solo puede crecer durante el día: nadie le quita piezas a lo que ya se pidió hornear. El pan de mayoreo entra a la hoja cuando el módulo está prendido. El sobrante dejó de ser una merma suelta o nada: ahora se sabe cuánto sobra y si parte se recupera en dinero.

  • Pruebas unitarias produccionSugerida, sobranteDePan, sobrantes, sobranteComoVenta, menuDePan, combosDePan, breadUtils; reglas hojaDePan y cierresDePan.
  • El cierre del mostrador manda lo que sobró a 5 destinos (pan de ayer, bolsa sorpresa, donación, personal o tirar); solo la donación y lo tirado cuentan como merma.
  • El conteo del sobrante no se llena solo: lo que el sistema cree que hay se enseña como pista, porque el «Pan surtido» se descuenta de los tipos al azar.

Productos, precios e inventario

Precios

Tabla de precios de pasteles por tamaño
Los precios de pastel por tamaño, normales y especiales, con el costo de la tabla. Al guardar aquí se actualiza el precio de cada producto ligado a esta tabla.

La única lista de precios de venta: pasteles normales y especiales por tamaño, tablas, rosca, gelatina, chocoflan, pay, galletas por pieza y pan por tipo, más los costos de producción por tamaño. Imprime la lista y el aviso de aumento.

Cómo está hecho. Tener una sola lista evita que la caja, los pedidos y la tienda en línea cobren distinto. Documenta qué pasa con una orden abierta que trae precios viejos. El costo «calculado» que enseña sale de las recetas.

  • 13 archivos de pruebas unitarias de precios (precioLigado, preciosEnBloque, tablaDePrecios, historialDePrecios, aumentoDePrecios, entre otros).
  • «Sugerir aumento» trae atajos de 2.5, 3 y 5 %, un porcentaje por grupo (0 = ese grupo no se toca) y redondeo por grupo (Auto, $1, $5 o $10), con vista previa de antes y después.
  • Cada cambio guardado queda en price_changes con su motivo (por ejemplo «aumento 2.5 % · pan 5 %») y después se puede imprimir la lista para el mostrador.

Catálogo de sabores y tamaños

Catálogo de sabores de pastel con relleno y precio por tamaño
Qué sabores existen, con qué relleno van y cuánto cuesta cada tamaño. Es la fuente de la que leen la caja, los pedidos y la tienda en línea.

La matriz de qué sabor se hace en qué tamaño, con su relleno por omisión. De aquí salen las opciones del formulario de pedido y el catálogo público de la tienda en línea.

Cómo está hecho. La pantalla marca los renglones cambiados sin guardar y no escribe una llave de relleno si sigue el valor por omisión. El catálogo público que consume la tienda sale sin costos, por una ruta firmada del POS (ADR-0014).

  • La tienda en línea muestra 11 tamaños con precio por producto (README de la tienda).
  • Pruebas unitarias catalogoParaPedido y tiendaCatalogo.
  • Se edita como una matriz: sabores en renglones y tamaños en columnas, con un filtro para ver aparte los especiales, que llevan otro precio; antes era una tarjeta por sabor con once botones.

Recetas y costos

El escandallo: qué lleva cada receta, cuánto cuesta hoy con el precio de bodega y cuánto deja cada pieza. Le dice al dueño qué productos le dejan margen y cuáles no.

Cómo está hecho. Se declara por masa y no por producto, porque así se trabaja. Una receta puede llevar otras recetas (bizcocho, relleno, betún) y el costo se calcula en cascada. Si falta un precio, el costo se pinta como piso con el nombre de lo que falta, aunque esté dos recetas abajo; una receta que se contiene a sí misma no tiene costo y se dice la ruta. Cada venta guarda su costo al vender, como Odoo, para que el margen de un mes cerrado no cambie cuando sube la harina.

  • Pruebas unitarias recetasMultinivel, costos, unidades, costoDeVenta.
  • Cada renglón guarda la cantidad siempre en la unidad base del insumo («250 g» se guarda como 0.25 kg); lo escrito se conserva aparte solo para enseñarlo igual.
  • Un renglón sin cantidad no cuesta $0: se marca como faltante en ámbar, y un pastel cuya receta suma $0 no se ofrece en /precios ni llega a la caja.

Inventario de mostrador

Inventario de productos con existencias, mínimos y precio
Existencias de cada producto contra su mínimo, con filtros de stock bajo, agotados y productos sin datos fiscales para facturar.

Qué hay, qué se está acabando y qué falta para facturar, con movimientos y merma con valor. Incluye «agotado hasta las 16:00», que se quita solo a esa hora, y los paquetes que se venden como un producto hecho de otros.

Cómo está hecho. La regla de «bajo» y «agotado» es una función pura (utils/existencias) y la pantalla solo pinta. Todo descuento es delta o transacción (ADR-0029). «Agotado hasta» lo respetan la caja y la tienda en línea, que antes seguían ofreciendo lo que ya no había.

  • Pruebas unitarias existencias, existenciasPorIncremento, kardex, agotados, kits; reglas agotados y mermas.
  • «Agotado hasta…» (candidato G1) marca un producto con la hora en que vuelve y se quita solo; las horas salen del horario del negocio guardado en el equipo, así que funciona sin red.
  • La pestaña «Agotados» de /stock sigue siendo stock ≤ 0; la marca de «agotado hasta» es aparte y no pide la contraseña del pan.

Bodega con códigos QR

El inventario de insumos de la bodega: entradas, salidas por QR, merma con motivo, lotes por caducar y recuento desde el teléfono. En Administración se ve quién consultó qué código y cuándo.

Cómo está hecho. El stock solo bajaba con una salida por QR, así que un costal sacado sin escanear no dejaba rastro. El recuento es lo que regresa el número a donde está la mercancía, y el faltante se resuelve como merma o como uso no registrado. La merma pide motivo obligatorio. Las salidas siguen FEFO, con ventana de caducidad por insumo. Encima se calculan el consumo teórico contra el real, los mínimos por consumo y las alzas de precio.

  • Pruebas unitarias recuentoDeBodega, reglasDeRecuento, cierreDeBodega, etiquetasQRDeBodega, teoricoContraReal, minimosSugeridos, alzasDeInsumos.
  • Reglas en bodegaProductos, recuentoBodega y cierresDeBodega.
  • En automático, el recuento de cada insumo se pide cada 7 días si caduca o es caro y cada 30 días el resto; la tarjeta del insumo dice hace cuántos días se contó.

Abasto: la surtida semanal

La lista de compras del viaje a surtir a Guadalajara: el mostrador la va llenando cuando ve que algo se acaba, y quien va la gasta en el pasillo desde el teléfono. Tiene cuatro pantallas: armar la lista, surtir (una tienda a la vez, marcar con un toque), la ruta de tiendas en orden y los tickets fotografiados que la IA lee.

Cómo está hecho. Armar y gastar son dos trabajos distintos y por eso no comparten pantalla. El teléfono del viaje tiene su propio papel, abasto, que solo entra a /abasto (dos papeles casi iguales se fusionaron en uno). Lo que la IA lee de un ticket es una propuesta guardada en IndexedDB del teléfono hasta que alguien la carga o la descarta, así que se puede fotografiar sin señal. El orden de las tiendas es el de la ruta y el del ticket impreso.

  • Un empleado apunta lo que falta sin ver costos; el papel de abasto ve y teclea costos.
  • Pruebas unitarias abasto, abastoEsperado, ticketsAbasto, surtidaSugerida; reglas abasto y ticketsAbasto.
  • Abrir /abasto lee como mucho 24 viajes (orderBy('fecha','desc') + limit(24)); antes leía la colección entera.
  • Las fotos de tickets se reducen en el teléfono a 1600 px de lado mayor y JPEG 0.85 (quedan en menos de 500 KB) antes de leerse con IA; cada vuelta al modelo se anota en los gastos de APIs.

Mayoreo: tienditas y cafeterías

El pedido de cada semana de cada cliente de mayoreo, sus niveles de precio y la hoja de reparto del día para quien entrega. Un empleado solo ve la hoja de reparto.

Cómo está hecho. El pedido se calcula al vuelo y entregar es vender (ADR-0028): no hay una venta guardada aparte que se pueda desincronizar. Todo nace apagado: sin niveles ni pedidos, la caja cobra igual y la hoja de pan sale igual. El módulo nace apagado también por empleado.

  • Candidato G4 de la comparación con otros POS.
  • Pruebas unitarias hojaDeReparto, precioPorNivel, repartoGuardado, puertaDelMayoreo, mayoreoEnLaHojaDePan, mayoreoEnLosResumenes; reglas mayoreo.
  • Decisiones en ADR-0028; todo viene apagado por omisión y, sin niveles ni pedidos, la caja cobra como siempre.
  • La venta de mayoreo en efectivo no cuenta en el efectivo esperado hasta «Entregar en caja»; un ingreso cubre a lo más 7 ventas por los límites de lectura de las reglas.

Clientes y mensajes

Clientes

Lista de clientes con ficha y su actividad (teléfono)
Clientes identificados por su teléfono, ordenados por su último pedido, por lo que compran o por lo que deben. Quien está en el mostrador busca aquí al cliente mientras suena el teléfono.

Quién encarga pasteles, qué lleva encargado y cómo avisarle que ya está listo. Está abierto a todos porque quien busca a un cliente es quien está en el mostrador con el teléfono sonando. Desde la ficha se llega a sus datos de facturación.

Cómo está hecho. El teléfono es la identidad del cliente. La portada sale de una consulta de grupo sobre una subcolección de días, en lugar de recorrer todos los pedidos (ADR-0019). Un script idempotente vincula pedidos viejos con clientes y sirve también para reparar contadores.

  • 7 archivos de pruebas unitarias (clientes, fichaDeCliente, clientesPorPeriodo, actividadCliente, origenDelCliente, customerPhone, telefonoParecido).
  • Reglas en clientesDias.
  • La ficha se identifica por el teléfono normalizado (normalizarTelefono), no por el nombre: quita +52, el 1 viejo y los prefijos 044/045; desde el 12-nov-2026 los números de Estados Unidos y Canadá se guardan con su 1 (once dígitos) solo si vienen con +1 o de WhatsApp.
  • No se crean fichas con teléfonos basura: en el emulador, 3,302 de 3,490 pedidos traían «0» o letras sueltas; los 188 restantes son 164 clientes.

Mensajes: WhatsApp, Instagram y Facebook

Los tres canales en una sola bandeja, con la ficha del cliente al lado cuando tiene pedidos en curso, métricas y «Armar pedido» que lleva la conversación a un borrador de pastel. La IA sugiere respuestas. Las llamadas de voz de WhatsApp desde el navegador están construidas y apagadas.

Cómo está hecho. La bandeja la escribe solo el servidor (ADR-0018): el webhook de Meta firma y guarda, y el navegador solo lee. La IA sugiere y no envía (ADR-0030). Hay un proveedor falso y un simulador para probar sin Meta; una llamada simulada nunca le habla a Meta. Importar el historial usa las mismas funciones que el webhook con el id de Meta, así que correrlo dos veces no duplica.

  • Hito M11, issue #137.
  • 25 archivos de pruebas unitarias mensajes* de la bandeja, 6 de llamadas, y reglas en mensajes, mensajesStorage y llamadas.
  • Integración contra el emulador en mensajesEmulador y llamadasEmulador.

Que la IA le conteste

La IA de Mensajes le escribe sola al cliente, o al que nadie contestó a tiempo, y le pregunta al equipo lo que no sabe. El dueño decide cuándo contesta, qué puede decir y sus topes.

Cómo está hecho. Amplía el ADR-0030 (la IA sugiere) con el ADR-0032 (puede contestar sola). Nace apagada. Tiene candados para no inventar precios ni sugerir lo que no debe, plantillas, modo de noche y mensajes internos al equipo. Lo pidió el dueño el 12-nov-2026: «si a los 5 min no se le contestó, que le conteste la IA».

  • 10 archivos de pruebas unitarias iaContesta* (candados de precios y de sugerir, calibración, plantillas, de noche…).
  • Integración iaContestaEmulador e iaContestaApagadaEmulador; reglas iaContesta.
  • Por omisión espera 20 s antes de contestar (ajustable de 5 a 45), calla 30 min después de que escribe una persona (no la IA) y espera 10 min la respuesta del equipo.
  • En la medición del 13-nov (~1,400 llamadas) tardó 170 ms de promedio, p95 de 210 ms; ninguna pasó del plazo de 2.5 s.

Avisos y mensajes automáticos por WhatsApp

Interruptores de los avisos automáticos por WhatsApp
Un interruptor por aviso: comprobante, pastel listo, entregado, pago recibido, en camino y cancelado. Solo salen a clientes que aceptaron recibirlos.

Dos pantallas: qué avisos de pedido salen solos (con un interruptor por aviso y el estado de cada plantilla en Meta) y los mensajes al cliente: cumpleaños, aniversario del pedido, «te extrañamos» y cobranza del fiado.

Cómo está hecho. Los mensajes al cliente siguen las acciones automáticas por fecha y la cobranza de Odoo. El dueño los aprobó con una condición: que nacieran apagados y que se pudiera ver a quién le saldrían hoy antes de prenderlos.

  • Pruebas unitarias mensajesAutomaticos, mensajesAvisosWhatsApp, sinWhatsApp; integración mensajesAutomaticosEmulador; reglas avisosWhatsApp y clientesMensajesAutomaticos.
  • La cobranza del fiado manda el estado de cuenta a los 7, 15 y 30 días de la compra fiada más vieja sin liquidar (plantilla UTILITY), y nunca más de uno cada 7 días.
  • A cada cliente le llega a lo más una promoción cada 14 días; no hay cron propio: corre al final del de los recordatorios, con tope de 45 s y de 60 envíos, para que un fallo no los tumbe.

Redes sociales

Publicar en la página de Facebook y en Instagram, ver lo publicado, contestar y moderar comentarios, ver cómo van los anuncios y qué ventas trajeron. Solo para quien maneja las redes.

Cómo está hecho. Todo pasa por el servidor con el token de la página (ADR-0020); el navegador nunca lo ve. Usa la misma app de Meta y el mismo token que Mensajes. Un comentario puede recibir respuesta privada por mensaje.

  • 16 archivos de pruebas unitarias redes* (anuncios, calendario, formatos, respuesta privada, sin conexión con Meta…).
  • Reglas redes, redesVideosStorage, instagramDeHoy, fotosPorSacar y respuestaPrivada.
  • Una publicación lleva hasta 10 imágenes (carrusel en Instagram), sale ahora o se programa de 15 min a 30 días; los reels aceptan video de 3 a 90 s.
  • El video no pasa por una función del servidor (Vercel corta el cuerpo en 4.5 MB): la pantalla lo sube directo, MP4 o MOV de menos de 100 MB, y luego pide confirmar.

Proveedores de IA y gasto de APIs

Configuración de proveedores de IA por uso
Qué IA atiende cada uso (Claude, OpenAI o Gemini) y con qué modelo, con una prueba antes de guardar. En esta captura el servidor no tiene llaves, así que no se llamó a ningún proveedor.

Qué IA atiende cada uso del POS (Claude, OpenAI o Gemini), con qué modelo y cuánto costaría al mes, con un botón «Probar». Aparte, lo que cobran por uso WhatsApp, OpenAI, Gemini, el buscador y los timbres, sumado por día y mes con un tope mensual que solo avisa.

Cómo está hecho. El gasto se anota del lado del servidor en cada llamada, no se estima en el navegador. Hay una capa común para los proveedores y la configuración nace igual que antes: nada cambia hasta que se toca. El buscador de imágenes tiene una capa para cambiar de Google Custom Search (que Google apaga el 1-ene-2027) a Serper o Brave con una variable de entorno.

  • Issue #179 (proveedores) y #178 (buscador).
  • Pruebas unitarias iaProveedorYPrecios, iaCapaComun, gastosDeApi, techoDeOtrasIA, buscadores; reglas gastosApi.
  • Anotar el gasto de una llamada nunca lanza error y se rinde a los 4 s: si falla el registro, la llamada a la IA no se cae por eso.

El negocio a distancia

Línea directa

El encargado ve qué cajas están abiertas y quién tiene el turno en cada una, les manda mensajes normales o urgentes y órdenes a distancia: cerrar el turno, abrírselo a alguien sin su contraseña o sacar el equipo de su cuenta. Las cajas también le escriben y le sale una tarjeta con sonido en cualquier pantalla.

Cómo está hecho. Todo lo que se manda pasa por el servidor, que es lo único que puede decir que de verdad lo mandó esa persona; desde una caja el empleado confirma su contraseña una vez para sacar su pase. Una orden no se ejecuta si alguien está a media venta (la misma regla que frena la actualización de la PWA). Lee con tres suscripciones acotadas: equipos de la semana, mensajes de tres días y órdenes del día.

  • Pedido del dueño del 29-oct-2026.
  • Pruebas unitarias lineaDirecta, adjuntosDeLinea, mensajeALaCaja; reglas lineaDirecta y lineaDirectaStorage; integración lineaDirectaAdjuntosEmulador.
  • Un mensaje urgente tapa todo (también el candado de turno), suena cada 6 s y hace parpadear el título de la pestaña hasta que alguien toca «Enterado».
  • Los adjuntos pueden ser fotos o un video MP4, MOV o WebM de hasta 60 segundos y 50 MB; si se pasa, la pantalla dice cuánto dura y cuál es el tope.

Aprobaciones a distancia

Lo que en la caja pide contraseña (un descuento, anular, fiar, pasar el tope, abrir el cajón) le llega a la dueña al teléfono y ella toca Aprobar o Rechazar. No quita la contraseña: va debajo, para cuando no hay nadie con el permiso en la tienda.

Cómo está hecho. La respuesta la escribe el servidor, que revisa que sea una cuenta de dueño con su propio turno y deja la bitácora a su nombre. El tiempo se mide con el reloj del servidor, no con el del teléfono. «Aprobar» pide confirmar con la cifra para que un toque de más no baste. El aviso llega por Web Push con la pantalla apagada y el POS cerrado.

  • Una solicitud vive 5 minutos (VIGENCIA_DE_SOLICITUD_MS) y la aprobación se puede usar durante 2 minutos (VIGENCIA_PARA_USARLA_MS).
  • Web Push desde la versión 4.55.0.
  • Prueba unitaria aprobaciones, reglas aprobaciones e integración aprobacionesEmulador.

Notificaciones al teléfono del dueño

Qué le avisa el POS al dueño en su teléfono con el POS cerrado (mensajes nuevos, pendientes del equipo, cámaras sin señal), equipo por equipo, y cuándo insiste la caja con los mensajes sin contestar.

Cómo está hecho. Web Push con un bloque aparte del service worker que no toca la caché; la suscripción es del registro y sobrevive a cada versión nueva. El aviso de cámaras sin video nació de un caso real: las cuatro dijeron «NO VIDEO» durante una hora por un cable suelto y nadie se enteró. El latido del vigía de cámaras hace también de reloj para los avisos de mensajes sin contestar.

  • Avisa cuando las cámaras llevan más de 10 minutos sin señal.
  • Pruebas unitarias notificaciones, pantallaDeNotificaciones, webPush, webPushCifrado; reglas notificaciones; integración notificacionesEmulador.
  • Una conversación sin contestar avisa por primera vez a los 15 min y luego a ×2, ×4, ×8, ×16 y ×32; entre avisos de la misma conversación pasan al menos 10 min.
  • En la caja, la tira se pone ámbar a los 5 min, roja y con sonido a los 15 min, y en rojo vuelve a sonar cada 3 min; «Posponer» la calla 10 min.

Los números del negocio

Panel

Panel del día con ventas, tickets, origen del dinero y estado de caja (teléfono)
El panel del dueño: lo vendido hoy contra un viernes normal a la misma hora, de dónde vino el dinero (mostrador, anticipos, pagos finales), cómo se cobró y qué pide atención, como pasteles por entregar.

Ventas del día, semana, mes y año, comparativas contra el periodo anterior, stock bajo, el historial de ventas y préstamos, y «Facturar esta venta». Exporta lo que se está viendo a Excel o a un PDF imprimible. La ruta vieja /admin/sales manda a la pestaña Historial.

Cómo está hecho. Los meses y semanas cerrados se guardan como resúmenes en hora de la tienda (sales_summaries) para no releer 70 mil ventas, y un script los recalcula. El reporte imprimible es una página sin sesión ni marco que recibe los datos por postMessage desde la pestaña que la abrió; «Guardar como PDF» del navegador es el PDF. services/dashboard/ sigue el mismo patrón de fachada que la impresión.

  • El Excel trae una hoja por tabla (resumen, ventas por periodo, por día, por hora, método de pago, productos, pasteles, stock bajo, transacciones).
  • Pruebas unitarias dashboardShared, reporteDashboard, reporteDetallado, resumenDiario, resumenesGuardados, comparacionDePeriodos.
  • Los resúmenes leídos se guardan en caché según la fecha: 2 minutos para hoy y 24 horas para un día ya cerrado, que no va a cambiar.
  • El PDF lo arma el servidor con Puppeteer abriendo /dashboard/reporte con los datos que mandó la pantalla: no vuelve a consultar Firestore y solo lo pide un admin.

Gráficas, pronóstico y finanzas

Pronóstico de venta de los próximos siete días con productos esperados
El modelo de demanda estima la venta de cada uno de los próximos siete días, con su rango, y los tres productos que más saldrán. Ayuda a planear la producción de pan.

Siete pestañas: resumen, ventas, horarios, productos, dinero, pronóstico y finanzas. El pronóstico dice qué se espera vender cada día por producto; finanzas responde si el aumento de precios ayudó al margen y cómo van los insumos contra el estándar.

Cómo está hecho. La predicción no usa regresión ni entrenamiento ni un servicio aparte: es un promedio por día de la semana hecho con cuidado, con su caché. Las ganancias cuentan el costo de personal como lo que de verdad se pagó cada semana (ADR-0012) y las inversiones restan cuando se pagan, no cuando se compran (ADR-0013). Las pestañas salen de la misma lista (RUTAS_DE_GRAFICAS) que ofrece la paleta.

  • El doc de proveedores cita que los insumos son ~66 % de la venta, contra el 25-35 % habitual.
  • Pruebas unitarias graficas, ventanaDeGrafica, salesChartData, prediccionesPorPeriodo, modeloDeDemanda, finanzas, ganancias, gananciasConInversiones.
  • El resumen junta 5 gráficas: tablero de KPIs, real contra esperado, este año contra el anterior, récords y calendario de ventas; con un periodo corto enseña los 60 días que terminan en él.
  • El pronóstico da los próximos 7 días y mide su precisión sin trampa: cada uno de los últimos 28 días abiertos se predice solo con los anteriores, sobre 90 días de resúmenes diarios.

Estados de cuenta del banco

Se sube el PDF del estado de cuenta de BBVA, el servidor lo lee y la pantalla lo pone junto a lo que el POS cobró con la terminal del banco en esas fechas: qué no llegó y qué llegó sin venta. La dueña lo revisa también desde su pantalla sencilla.

Cómo está hecho. La lectura del PDF y el contraste son funciones separadas y probadas. Solo admin, en la pantalla y en las reglas. Hay además una herramienta aparte en el repo (pythonEstadoDeCuenta) para estados de cuenta, sin relación con el POS.

  • Pedido del dueño del 10-nov-2026.
  • Pruebas unitarias estadoDeCuentaLector y estadoDeCuentaContraste; reglas estadosDeCuenta.
  • Se sube el PDF del banco, el servidor lo lee y se contrasta contra los cobros de la terminal del banco: qué no llegó, qué depositó el banco que el POS no tiene y cuánto se fue en comisión. Lo de la Point de Mercado Pago no entra.
  • Solo admin en tres lugares (reglas de estados_de_cuenta, la ruta que lee el PDF y la pantalla); la casilla admin_bancos nace apagada para quien abre turno.

Préstamos e inversiones

Adelantos a empleados y sus abonos, y también lo que alguien le prestó a la pastelería. Aparte, las compras grandes con plan de pagos (paneles solares, una moto) con enganche, cuotas y comprobantes.

Cómo está hecho. Una cuenta por persona y por dirección (le prestamos / nos prestó). La pantalla es la misma pieza que la pestaña Préstamos del panel, para no mantener dos copias. Las inversiones restan a la ganancia cuando se pagan (ADR-0013).

  • Pruebas unitarias prestamos, prestamosALaVista, prestamosCambiaron, prestamosMezclaDeEquipos, ajustesDePrestamos, loansPermissions, recordatorioDePrestamos, inversiones.
  • Reglas prestamos, inversiones e inversionesStorage.
  • El recordatorio de préstamos lee employee_loans solo en su horario (al entrar y cada 15 min); lo contestado y lo pospuesto (30 min) se guardan en el equipo, sin colección nueva.
  • El comprobante de una inversión es imagen o PDF de menos de 10 MB y solo se crea, no se reemplaza.

Facturación CFDI 4.0

Timbra facturas electrónicas con pestañas para nueva factura, historial, solicitudes de los clientes, factura global, productos sin clave SAT y datos del emisor. Se llega también desde una venta del panel y desde la constancia que manda un cliente por Mensajes.

Cómo está hecho. Primero con Facturapi como PAC y el servidor como único que escribe facturas (ADR-0011); luego Finkok como segundo PAC con XML, sello y cancelación firmada hechos en casa (ADR-0022); hoy el dueño factura por el portal del SAT: el POS arma la factura y la hoja de captura, una persona la emite y sube el XML (ADR-0023). La llave del PAC solo vive en services/facturapi, que el linter impide importar fuera de las rutas de API. La página que tenía 985 líneas se partió en componentes.

  • Mientras la página está abierta revisa con el SAT las timbradas sin confirmar al abrir y cada 10 min.
  • El historial pagina de 25 en 25 y cuesta una consulta.
  • 22 archivos de pruebas unitarias facturacion*, 6 facturapi*, 5 finkok* y portalSat; Cypress facturas.cy.ts; integración facturacion, finkok, portalSat y satPendientes.

Autofactura del cliente por QR

El ticket lleva un QR y un código corto. El cliente, en su teléfono y sin cuenta, ve su compra y captura sus datos fiscales o sube su constancia en PDF. La solicitud le llega al dueño en Facturas; al timbrarse, la venta sale de la próxima factura global.

Cómo está hecho. El código del ticket es la llave; la página vive en el POS, es pública y solo escribe el servidor (ADR-0026). La página no lee nada del lado del servidor: el teléfono le pregunta a /api/autofactura con el código, con límite de intentos, y el código se corta a 40 caracteres.

  • Prueba unitaria autofactura, reglas solicitudesFactura e integración autofacturaEmulador.
  • El código del ticket nace en la caja: 10 caracteres de un alfabeto de 31 (~49.5 bits), aleatorio.
  • Límites por IP en memoria: 10 códigos no encontrados por hora y 40 consultas, 12 envíos y 6 constancias por cada 10 minutos; un código mal escrito, uno inexistente y uno repetido responden igual.

El personal

Empleados, contraseñas y permisos

Lista de empleados con permisos por módulo
Cada empleado tiene su contraseña personal (guardada solo como huella cifrada) y sus permisos por módulo. Con ella abre su turno y firma lo que hace.

Las contraseñas personales del personal y qué puede hacer cada quien, en un árbol de módulos y acciones por secciones (mostrador, pedidos, producción, compras, mensajes, facturas, cámaras, administración). Dos personas que usan la misma caja no ven lo mismo.

Cómo está hecho. Sustituyó una variable de entorno con contraseñas que obligaba a redesplegar para cambiar una. Las contraseñas se guardan como huella PBKDF2-SHA256 con sal por empleado y se verifican en el navegador con Web Crypto, para que funcionen con el módem caído. Los permisos son de la persona del turno; el papel de la cuenta es del equipo, y las reglas de Firestore solo ven la cuenta (ADR-0010). Cada permiso nuevo nace con lo que esa persona ya podía hacer, y las claves guardadas nunca se renombran.

  • PBKDF2 con 100,000 vueltas desde el 19-nov-2026; en la caja cuesta ~80 ms por persona.
  • 8 secciones de permisos.
  • Pruebas unitarias staffAuth, permisos, permisosArbol, accionConPermiso.

Cuentas, papeles y alta de equipos

Cuentas del sistema con su papel
Las cuentas que entran al sistema son equipos, no personas: caja de mostrador, caja secundaria, pantalla de cocina, surtidor de abasto y administrador, cada una con lo que su papel permite.
Alta de equipos con código de un solo uso
Para activar una caja nueva el dueño genera un código de un solo uso; así nadie tiene que conocer la contraseña de la cuenta.

Las cuentas que entran al sistema y su papel (administrador, empleado, caja secundaria, visualizador, surtidor de abasto, pantalla de cocina). Una caja nueva se activa con un código de un solo uso que el dueño genera, sin darle la contraseña. Mi perfil sirve para cambiar la contraseña inicial; Avanzado borra lo guardado en los equipos y avisa antes cuántas ventas sin subir hay.

Cómo está hecho. El alta la hace el servidor: antes se hacía con el SDK del cliente, que iniciaba sesión con la cuenta nueva y sacaba al dueño de la suya. La contraseña inicial se enseña una sola vez. La baja deshabilita, no borra, para que lo firmado siga apuntando a alguien. El mapa de rutas por papel vive en utils/papeles.ts y lo usan el menú para esconder y la guarda para bloquear.

  • 6 papeles de cuenta.
  • El código de equipo tiene 8 caracteres y vale 10 minutos (altaDeEquipo.ts).
  • Pruebas unitarias papeles, altaDeEquipo, altaDeUsuario, estadoDeEquipos, entradaDeSesion, salidaDeSesion; reglas usuarios, equipos y lecturaPorPapel.

Asistencia y horarios del personal

Asistencia y puntualidad del personal con resumen por persona
Se importa el reporte de la checadora y el POS deduce el turno de cada quien: puntualidad, retardos, faltas, salidas tempranas y horas trabajadas.

La puntualidad del personal con las checadas del reloj de huella, y qué horario tiene cada quien cada día, contra el que se mide. Imprime el reporte en PDF.

Cómo está hecho. El archivo de la checadora se lee en el navegador y a Firestore va lo ya leído; cada importación agrega solo lo que no estaba, así que se puede ver cualquier periodo importado. Los turnos se deducen de las checadas o se configuran, y se editan en un borrador que se guarda todo junto para no dejar la puntualidad mal calculada a medias.

  • 7 archivos de pruebas unitarias (asistencia, checador, historialChecadas, inferirTurnos, reglasAsistencia, reporteAsistenciaPdf, turnos).
  • Bitácora de pruebas manuales del 8-sep-2026 en docs/.
  • Las checadas se importan del reporte estándar de la checadora de huella: el archivo se lee en el navegador y a la colección checadas solo va lo que no estaba.
  • Los turnos viven en config/turnos y se guardan todos juntos desde un borrador; cada persona puede tener una semana fija o dos que se alternan (A y B). Corregir checadas a mano queda en la bitácora con quién y qué había antes.

Nómina

Lo que se le paga al personal: el pago semanal de lunes a domingo, la quincena con las horas de la asistencia, los descuentos pactados de préstamos y el recibo impreso.

Cómo está hecho. El costo de personal es lo que de verdad se le dio a cada quien cada semana, no lo calculado por horas (ADR-0012). El descuento de un préstamo no puede pasar del saldo ni de lo que se paga, y si el abono entró pero la fila no, reintentar reusa el mismo abono para no descontar dos veces. Una prueba de ataque movió los sueldos fuera de la ficha del empleado, que lee cualquier caja.

  • Pruebas unitarias nomina, pagosSemanales, semanaDePago, costoDePersonal, sueldosDelPersonal, reporteNominaPdf; reglas pagosSemanales.
  • Tiene 2 pestañas: «Pago semanal» (pagos_semanales, un documento por semana de lunes a domingo con nombre ISO como 2026-W38) y «Cálculo por horas» (nominas, una por quincena cerrada), que sigue registrando los abonos de préstamos.
  • El costo de personal se guarda en caché según el periodo: 2 min si está en curso, 24 h si ya cerró con todas sus semanas cerradas y 30 min (provisional) si le falta alguna; guardar o cerrar una semana limpia la caché.

Horario y calendario del negocio

A qué hora abre y cierra cada día y los días distintos, y un calendario de qué días fueron atípicos y por qué. Con eso el corte de la noche sabe cuándo dejar de preguntar por pedidos y el POS avisa si se promete una entrega imposible.

Cómo está hecho. El horario no cierra la caja: si alguien cobra a las 22:05 porque quedó un cliente, el POS no se niega. En el calendario el sistema propone y una persona confirma, porque con un año de datos hay una sola muestra de cada fecha y detectar a secas sería ruido; nadie sabe mejor que la dueña por qué bajó una semana.

  • Issues #34, #39, #40 y #41.
  • Pruebas unitarias horarioNegocio, avisoDeHorario, origenDelHorario, calendarioNegocio, diaDelNegocio, ventasFueraDeHorario.
  • El horario vive en config/horario (solo lo escribe un admin) y se copia a localStorage para que el corte y el formulario de encargos sepan la hora de cierre sin internet; no cierra la caja: a las 22:05 se sigue cobrando.
  • En el calendario del negocio el sistema propone los días raros y una persona confirma el porqué; solo mira hasta ayer, porque el día en curso va a medias.

La tienda física: temperaturas, cámaras e impresoras

Temperaturas y mantenimiento (NOM-251)

Bitácora de temperaturas de refrigeradores y congeladorBitácora de temperaturas de refrigeradores y congelador (teléfono)
La bitácora que pide la norma sanitaria (NOM-251): la temperatura de cada equipo en cada toma del día, qué se hizo si salió de rango y cuándo toca su mantenimiento.

La bitácora que pide el verificador sanitario: la temperatura de cada equipo de frío todos los días, qué se hizo cuando estuvo fuera de rango y los mantenimientos. Cinco pestañas: cómo están los refris, anotar hoy, mantenimiento, la hoja del mes para imprimir y el catálogo de equipos.

Cómo está hecho. Lo que faltó se calcula al leer en lugar de programar tareas, y el rango se congela en cada lectura para que cambiarlo después no reescriba el pasado (ADR-0027). Sin equipos dados de alta está apagada. Si un equipo tiene sensor WiFi escucha su estado; para la semana y el mes lee un resumen mensual en vez de cada muestra.

  • Candidato G3 de la comparación con otros POS.
  • Historial de 1, 7 y 30 días; el mes cuesta de 1 a 3 lecturas.
  • 7 archivos de pruebas unitarias (temperaturas, avisosDeTemperatura, muestrasDeTemperatura, resumenDeTemperatura, sensores, refrisPantalla, hojaDelVerificador).

Cámaras de seguridad

Las cuatro cámaras de la pastelería desde el POS: en vivo, grabaciones del DVR con barra de 24 h, clips descargables, la revisión nocturna que hace una IA y nombres para los grupos de caras. Cada pestaña es un permiso aparte y el módulo nace apagado para todo empleado.

Cómo está hecho. El video nunca sale de la PC de la tienda: el servidor del POS firma un pase con lo que le toca a ese turno y la PC hace cumplir cada parte. Sin ninguna acción prendida, la pantalla no aparece ni en el menú, ni en Ctrl+K, ni tecleando la ruta. La detección corre de noche fuera del POS; en vivo no se detecta nada. Si el navegador no tiene MediaSource o el video se congela, cae a una foto periódica.

  • 4 cámaras en mosaico 2×2; foto de respaldo cada 2 s.
  • Clips de 30 s a 30 min, bajados a velocidad real (5 min de video tardan ~5 min).
  • 5 acciones de permiso (en vivo, grabaciones, clips, borrar clips, revisión IA).
  • Pedido del dueño del 10-nov-2026; 9 archivos de pruebas unitarias camaras*, reglas camarasArchivo, camarasIa y camarasPersonas.

Puerta de las cámaras (servicio en la PC)

Un servicio que corre en una PC de la tienda y es lo único que habla con el DVR. Entrega el video en vivo, las grabaciones y los clips a la pantalla de Cámaras, y un vigía revisa cada minuto si alguna cámara se quedó sin video para avisar al dueño.

Cómo está hecho. Node sin dependencias más ffmpeg: copia el substream H.264 a fMP4 para el navegador. Todo se autoriza con un pase HMAC firmado por el POS. Con el DVR caído no lo martilla: falla rápido y hace una sola prueba cada 15 a 30 s (de 5 a 30 min si rechaza la contraseña, para no bloquear la cuenta). Un ffmpeg que no da video en 15 s se mata y se reintenta con espera creciente. Solo se alcanza desde la red privada de la tienda. El análisis nocturno se pide desde el POS sin abrir un camino nuevo hacia la PC: viaja en la respuesta del latido del vigía.

  • Reintento de ffmpeg de 2 a 30 s; ping a quien mira cada 25 s; bitácora que rota a los 5 MB.
  • Una tarea programada la levanta cada 5 min si no contesta.
  • Pruebas unitarias puertaSalud y puertaConDvrDeMentira (la puerta entera contra un DVR falso), vigia, vigiaDeLaPuerta y analisisAPedido.

Impresiones: imágenes, dibujos y texto

Pantalla para preparar impresiones de oblea comestible
Prepara las imágenes que se imprimen en papel comestible para decorar pasteles: buscar, dibujar o subir una foto y acomodar una, dos, cuatro o un collage por hoja.

Una sola pantalla para llegar a una imagen (buscarla, buscar un dibujo para colorear, dibujarla o generarla con IA) o escribir un texto, y sacarla en hoja carta o en la térmica de tickets. Las rutas viejas /drawings y /text-print mandan a sus pestañas.

Cómo está hecho. Las imágenes generadas con Gemini las escribe solo el servidor, con su PNG en Storage, su costo por día y una caché de peticiones. Las rutas viejas se conservaron como redirecciones para no romper enlaces ni el acceso directo de la PWA.

  • Issue #66 juntó las tres pantallas.
  • Pruebas unitarias imageGen, generadorDeImagenes, busquedaDeImagenes, imagenesParaImprimir, hojaDeImpresion, borradorDeImpresion; reglas imagenesGeneradas y generadasStorage.
  • La generación con Gemini tiene plazo propio de 90 s (AbortController) y cancelar en la pantalla también la corta; acepta hasta 6 referencias, reducidas a 1536 px.
  • Toda generación se guarda en el historial (solo lo escribe el servidor) y la misma petición en 30 días devuelve la misma imagen sin llamar a Gemini; se guarda la URL, nunca el base64.

Etiquetas

Impresión de etiquetas para galletas por paquete
Etiquetas para la impresora Brother: galletas por paquete, productos, pedidos y códigos QR. Si el equipo no tiene la impresora conectada, la etiqueta viaja por la cola remota y sale en la PC que sí la tiene.

Imprime etiquetas en la Brother QL-800 para productos, pasteles de pedido y códigos QR. Antes se llamaba «StickerPr», que era el nombre del agente y no de la pantalla.

Cómo está hecho. A diferencia de los tickets, el agente de etiquetas todavía arma sus propias etiquetas, así que un cambio en lo que se manda necesita actualizar el agente y debe ser compatible hacia atrás: las llaves nuevas son opcionales y un agente viejo ignora las que no conoce.

  • Agente stickerconnect.py versión 1.1.0.
  • Se actualiza solo él con npm run caja:agentes -- --solo etiquetas.
  • La pantalla /stickers tiene 4 pestañas: galletas, productos, pedidos (los pasteles abiertos) y QR.

Agentes de impresión y cola

Interruptores de impresión automática
Qué se imprime solo y cuándo, como la producción del día siguiente por la tarde. Los cambios piden contraseña y valen para todas las cajas.

Dos agentes en Python corren en la PC de la caja: uno para tickets y cajón, otro para etiquetas. En Administración se configura el servidor de impresión para la caja secundaria, se revisa y reintenta la cola de solicitudes y se prenden las hojas de producción automáticas de la tarde. /clave-del-agente guarda en la caja secundaria la clave para imprimir.

Cómo está hecho. La impresión baja en cuatro escalones: agente local, IP remota, cola print_requests en Firestore y cola en IndexedDB (services/print/transport.ts). El que vacía la cola de Firestore se monta fuera del bloqueo de turno, para que la PC de la impresora siga imprimiendo con su pantalla bloqueada. Los agentes se compilan con PyInstaller, PM2 los mantiene vivos y se actualizan a distancia con vuelta atrás si /health no contesta. Desde la prueba de ataque, imprimir desde otro equipo pide la clave en un encabezado y solo se aceptan orígenes del POS.

  • Agente de tickets ticketConect.py versión 1.6.0, y otro aparte para etiquetas.
  • El escalón de Firestore espera 4 s (FIRESTORE_TIMEOUT_MS = 4000).
  • Guardar la clave del agente en la caja secundaria pide un código de un solo uso del dueño.
  • Pruebas unitarias como redLocalDeImpresion, diagnosticoDeImpresion, fallosDeImpresion, secretoDelAgente, claveDelAgenteEnLaPc2, reimprimirSolicitud.

Tickets armados en la PWA

Editor de tickets con vista previa de 58 mm
Encabezados, pies y qué lleva cada ticket, con la vista previa a tamaño real del papel térmico. El ticket se arma en la app y se manda a la impresora como bytes ESC/POS. Los datos de contacto de la tienda están tapados en esta captura.

Cómo se ve cada ticket impreso: encabezado del negocio, renglones de arriba, pie, modo compacto y lo que se puede apagar, con una vista previa de los mismos bytes que salen en la impresora.

Cómo está hecho. Desde la versión 1.5.0 del agente, el agente ya no formatea nada: la PWA arma cada ticket y el pulso del cajón como bytes ESC/POS (src/utils/escpos/) y los manda a /raw. Cambiar un ticket es un despliegue a Vercel y no hay que tocar la caja. La PWA se niega a imprimir con un agente que no anuncia raw (error IMP-07) en lugar de caer a rutas viejas.

  • El rechazo IMP-07 existe desde el POS 4.46.0.
  • 7 archivos de pruebas unitarias escpos* (codificador, cajón, ticket de venta, de anticipo, de corte, de producción y de reportes) y configDeTickets, editorDeTicketsRender, vistaPreviaDelTicketRender.
  • Hay dos rollos: el chico de 57/58 mm arma a 32 caracteres y el grande de 80 mm a 48; el ancho configurado viaja con todos los trabajos de impresión.
  • En /admin/tickets la vista previa sale de los mismos bytes que se imprimen, sobre el rollo elegido y a su tamaño real; se edita un borrador y nada llega a la caja hasta «Guardar».

Ingeniería por dentro

Arquitectura por capas

Diagrama de arquitectura del POS dentro de la propia app
Los diagramas del sistema viven dentro de la app y cada caja enlaza al código que la implementa: arquitectura, venta en caja, ciclo de vida de un pedido, tienda en línea y avisos.

Las reglas internas que permiten cambiar una pantalla sin saber cómo se guarda el dato y probar un servicio sin navegador ni Firestore. Es lo que deja crecer el POS sin que cada cambio rompa otra cosa.

Cómo está hecho. Cinco capas que solo importan hacia abajo (pantallas, hooks y contextos, servicios, infraestructura, funciones puras) y un linter que lo vigila; la lista de excepciones solo puede encoger. lib/db/refs.ts es la única puerta a Firestore: ningún servicio construye una colección a mano, y por eso el producto multi-negocio pudo colgar las mismas colecciones de tenants/{id}/ cambiando solo ese archivo. Las pruebas viven en las costuras puras de src/utils/.

  • Next.js 16, React 19, TypeScript, Tailwind, shadcn/ui y Firebase 11; despliegue en Vercel.
  • ~340 archivos TS/TSX y ~85 mil líneas según PROJECT-CONTEXT.md (escrito el 13-ago-2026).
  • La puerta a Firestore es un archivo de veinte líneas según ARQUITECTURA.md.

Reglas de Firestore

Lo que de verdad decide quién escribe qué en la base. Las pantallas y los permisos solo esconden; las reglas son las que niegan.

Cómo está hecho. Se despliegan aparte de la app con el CLI de Firebase, y el destino sale de la llave database de firebase.json, que cada rama fija a una base distinta; el doc explica por qué firestore debe ser objeto y no arreglo (en arreglo, el CLI no despliega nada y marca verde). La prueba de ataque del 19-nov-2026 encontró escrituras que las reglas todavía permitían; se cerraron en las reglas y, donde hacía falta distinguir lo legítimo, cambiando cómo escribe el código, en dos fases.

  • firestore.rules tiene 124 bloques match.
  • 80 archivos de pruebas de reglas contra un emulador propio (npm run test:rules), incluido pruebaDeAtaque.test.ts.
  • Verificado el 18-ago-2026 que las reglas de producción eran idénticas byte a byte al archivo en la rama principal.

PWA y actualización sola

El POS se instala como aplicación y abre sin internet, incluso en una tablet recién instalada que nunca visitó las pantallas. Cada despliegue llega solo, sin avisar, en un momento en que nadie está cobrando. La PC de la tienda ya no tiene repo: el POS ahí es esta PWA.

Cómo está hecho. Service worker escrito a mano porque Turbopack no corre plugins de PWA. Las navegaciones van red primero con plazo y caen a la copia guardada o a una página sin red; los chunks con hash van caché primero; Firestore, Auth y /api pasan de largo porque Firestore ya tiene su caché. La versión nueva espera y se aplica solo si ninguna ventana está a media venta, con un cobro sin guardar, esperando la Point o esperando una aprobación. Las cachés llevan la versión en el nombre y no se borra la que una ventana sigue sirviendo.

  • Plazo de red de 4 s para navegaciones; busca versión nueva al cargar, al volver a la pestaña y cada hora; revisa cada 30 s si es buen momento.
  • Desde el 28-sep-2026 (#149) la caja corre la PWA instalada por política de Chrome.
  • Pruebas unitarias swAvisos, swClic, swRutas, swSinRed y actualizacionSola.

Estado del entorno

Estado del entorno mostrando que la app escribe en el emulador local
Dice a qué base está escribiendo la pantalla y los scripts en este momento. Aquí confirma que todas las capturas se hicieron contra el emulador local, con datos de prueba.

Dice a qué base está escribiendo la app ahora mismo, antes de tocar nada. Va primero en Administración por eso.

Cómo está hecho. La pregunta tiene dos respuestas que pueden no coincidir: la app mira NEXT_PUBLIC_ENVIRONMENT y los scripts del Admin SDK miran FIRESTORE_EMULATOR_HOST; con la app en el emulador, un script sin esa variable reescribe producción. La pantalla pide un conteo de documentos a la base conectada, la única comprobación que no se falsea con una variable mal puesta, y permite cambiar de base sin salir. Del mismo cuidado salen npm run estado, el next dev que se niega a arrancar contra producción y el .env.local que sigue a la rama por un hook de git.

  • Producción tiene ~75 mil documentos, ~70 mil en orders (PROJECT-CONTEXT.md).
  • Entornos: producción, base de desarrollo con nombre en el mismo proyecto y emulador local.
  • Compara a qué base van el navegador (NEXT_PUBLIC_ENVIRONMENT) y los scripts de terminal (FIRESTORE_EMULATOR_HOST) con un semáforo: verde si es el emulador, rojo si es una base real; avisa si la app va al emulador y los scripts no.
  • Cuenta los documentos de orders, cake_orders y users en la base de delante, y las tareas eligen destino «Emulador» o «PRODUCCIÓN», con el emulador por omisión.

Tablero de revisión

Pantalla de revisión de discrepancias y fallos
Lo que no cuadra y lo que falló, con su explicación: patrones de diferencias en los cortes, ocasiones de los pedidos y los errores que la app anota sola cuando ocurren. El «Failed to fetch» de abajo es la app anotando que, en estas capturas, se le bloqueó la analítica.

Lo que no cuadra y lo que falló, con su explicación: discrepancias del negocio (cortes encimados, ventas que llegaron tarde) y fallos técnicos capturados en el momento. Cada hallazgo se resuelve y queda anotado.

Cómo está hecho. Dos maquinarias: las discrepancias se calculan con reglas puras sobre datos guardados, así que una regla nueva ve lo de hace tres meses; los fallos se capturan en el layout porque un error no deja datos para revisar después. Volver a correr las reglas no pisa lo que alguien anotó, para que sea bitácora y no alarma que se deja de mirar. Los umbrales viven en código y se calibran con su bitácora (ADR-0016).

  • Issue #50.
  • 7 archivos de pruebas unitarias (revisiones, umbralesDeRevision, calibracionDeUmbrales, modulosDeRevision, puertaDeRevision, calendarioDeRevision, paraRevisar).
  • Un Resguardo del dueño con más de 30 días guardado sale en la revisión, y es de prioridad alta desde $5,000.
  • Un día sin corte solo se acusa cuando ya pasó el cierre de config/horario y la última venta, más 60 min de margen, porque la tienda vende pasada su hora.

Reportes de fallas, ideas y dudas

El dueño y las empleadas reportan lo que no funciona, una idea o una duda, con capturas. Todas las cuentas ven todos los reportes; el estado solo lo mueve el dueño. El formulario se abre encima de cualquier pantalla con Alt+R.

Cómo está hecho. La lógica es pura (utils/reportesDelPos) y el reporte tiene borrador y cola para no perderse sin red. El módulo nace prendido y entra también en la pantalla sencilla.

  • Pedido del dueño del 17-nov-2026.
  • Pruebas unitarias reportesDelPos y reportesDelPosBorradorYCola; reglas reportesDelPos y reportesDelPosStorage.
  • Una sola suscripción trae los 200 reportes más nuevos y los filtros y la búsqueda son en memoria; el reporte abierto va en la dirección (?r=), así el aviso al teléfono del dueño abre el suyo.
  • Alt+R abre el formulario de reportes encima de la pantalla de ahora; lo escrito sin internet espera en el equipo, y cuando el dueño lo abre deja de ser «Nuevo».
Paleta de comandos abierta con Ctrl+K sobre la caja
Ctrl+K abre la paleta: acciones de la pantalla actual con su tecla y todas las pantallas que esa persona puede ver. Sale de la misma lista que el menú, así que nunca ofrece algo que el menú esconde.
Panel de administración agrupado por operación, personal y producción
Los accesos de administración agrupados por lo que se va a hacer: operar el día, la gente, lo que se produce, lo que se imprime y las herramientas.

El menú lateral, el índice de Administración agrupado por lo que se va a hacer (operación, personal, producción y ventas, impresión, herramientas), la paleta Ctrl+K para ir a cualquier pantalla escribiendo y los atajos Alt+letra. El dueño pidió poder usar el POS a puro teclado.

Cómo está hecho. El menú, los accesos de Administración, las gráficas y la paleta salen de una sola lista pura (utils/pantallas.ts), para que la paleta nunca le ofrezca a la cajera algo que el menú le esconde. Esconder no protege: quien cuida la ruta es la guarda del layout y las reglas. Todos los atajos viven en un registro (utils/atajos.ts) y una prueba avisa si dos ámbitos que viven a la vez se pisan una tecla. La búsqueda ignora acentos y ordena primero lo que empieza con lo escrito.

  • 33 entradas en el menú lateral y 28 accesos en 5 grupos de Administración.
  • Pruebas unitarias pantallas, atajos, atajosDeCaja, teclado, tecladoALaVista, teclasMasMenos, teclasReservadas.
  • Ctrl+K abre la paleta (también desde un campo), «?» o Ctrl+/ la ayuda, y Alt+letra va directo a una pantalla; la paleta usa el mismo filtro que el menú lateral, así que nunca ofrece lo que el menú esconde.
  • En la caja de teclado se suman F1 Ventas, F2 Clientes, F3 Pasteles, F4 Panes, F7 Recargas y F8 Gastos; con un cobro a medias no se cambia de pantalla ni con atajos ni desde la paleta.

Diagramas del sistema y centro de pruebas

Diagramas interactivos de cómo funciona el POS por dentro, donde cada caja enlaza a las líneas de código que la respaldan, y una pantalla para correr las pruebas del sistema desde el navegador.

Cómo está hecho. Los diagramas se generan con Archify y se pintan en un iframe en sandbox sin allow-same-origin, para que su JavaScript no vea la sesión de Firebase ni la cola offline. El centro de pruebas separa las unitarias, que corren en el servidor de desarrollo en segundos y sin costo (en un despliegue la ruta no existe y se dice), de las manuales del chat con IA, que llaman a OpenAI y cuestan dinero.

  • 583 archivos *.test.ts en test/unit, 80 de reglas y 28 de integración; 4 specs de Cypress.
  • npm run verify corre typecheck, lint, pruebas unitarias y build.
  • Prueba unitaria diagramas.

La tienda en línea

Tienda en línea

Portada de la tienda en línea de la pasteleríaPortada de la tienda en línea de la pastelería (teléfono)
La tienda en línea: el cliente elige sabor y tamaño, aparta su pedido y lo recoge en la tienda. Lo pagado llega solo al POS como pedido por revisar.
Catálogo de la tienda en líneaCatálogo de la tienda en línea (teléfono)
El catálogo público, con los mismos sabores y precios que la caja.
Configurador de pastel de la tienda en líneaConfigurador de pastel de la tienda en línea (teléfono)
El configurador: tamaño, sabor, decorado, texto y foto de referencia, con el pastel dibujado a escala.

El catálogo público de la pastelería: el cliente elige sabor y tamaño, arma su pastel en un configurador con vista a escala en dibujo o 3D, aparta su pedido para recogerlo en la tienda, paga con tarjeta u OXXO y lo sigue desde su cuenta. También cobra los enlaces de pago que genera la caja.

Cómo está hecho. Es una app aparte en el mismo repo, con su propio proyecto de Firebase y su propio glosario: «pedido» en la tienda es un checkout, no el pedido de pastel del POS. Cobra con Stripe Checkout alojado y un webhook firmado; al POS solo llega lo pagado. Apartar en línea nace apagado hasta que el dueño lo prenda con una variable. El catálogo sale del POS sin costos.

  • Next.js 15, React 19, Firebase 11 y Stripe 18 (package.json de la tienda).
  • 11 tamaños con precio por producto.
  • 20 archivos de pruebas con vitest, pruebas de reglas y 4 specs de Playwright contra emuladores y Stripe de prueba.

Pedidos y pagos en línea en el POS

Un pedido pagado en la tienda en línea llega al POS como pedido de pastel con revisión pendiente para que el mostrador lo confirme. La cajera también puede mandar un enlace de pago (tarjeta, Apple Pay, Google Pay) para un pedido o una venta, con el botón «Link o transf.».

Cómo está hecho. La tienda y el POS se hablan solo por rutas firmadas del servidor del POS, y nunca al revés (ADR-0014): el POS no llama a la tienda ni depende de ella, y la tienda ya no tiene credenciales del POS. El alta es idempotente por el id del pedido. Los pagos en línea son anticipos fuera de caja (ADR-0015): no suman al efectivo del cajón. El contrato vive en el POS y la tienda tiene una copia generada.

  • Firma HMAC-SHA256 con cinco minutos de tolerancia y comparación en tiempo constante.
  • La tienda consulta el estado con un cron cada 10 minutos.
  • Hitos M16 y M17; 7 archivos de pruebas unitarias tienda* más ventasConEnlace; integración pedidoWebEmulador, enlacePagoEmulador y ventasConEnlaceEmulador.

Más allá de la pastelería

La misma base se volvió un producto para varios negocios a la vez: POS multi-negocio (SaaS). Y la plataforma de ventas que nació aquí la presenté como CRM para los vendedores de Vitras:

La plataforma de ventas que nació en la pastelería, presentada como CRM para los vendedores de Vitras (2 min 50 s)

Estado

En producción en la tienda y en desarrollo continuo desde diciembre de 2024: más de 2,500 commits, 32 decisiones de arquitectura escritas (ADR), 583 archivos de pruebas unitarias, 80 de reglas de Firestore y 28 de integración, y la versión 4.95 en noviembre de 2026.

Screenshots

3 capturas