0.3.1-beta

Resumen

Esta versión está enfocada en hacer Orkestria más cómodo en celular, más rápido para operar y más fácil de aprender. También estrenamos el centro de documentación que estás leyendo, con un asistente Faki integrado, una guía interactiva por rol y bastantes pulidos de QA.

Navegación en celular

• Nueva barra inferior con tus 4 accesos directos favoritos siempre a la mano.
• Personaliza tus accesos directos desde Perfil → Preferencias UI o manteniendo presionado el botón Más.
• Atajos agrupados: el botón Tomar pedido despliega opciones para mesa o domicilio. El botón Cobrar también despliega opciones según el tipo de orden.
• Tus preferencias te siguen entre dispositivos: si cambias de celular o de computador, tu configuración se conserva.
• Tres modos de navegación móvil: barra inferior, menú hamburguesa, o ambos al mismo tiempo (por defecto).
• Cierra el menú deslizando hacia abajo con un gesto natural.
• Búsqueda en el menú con botón para borrar lo escrito de un toque.
• Vuelve arriba automáticamente cuando cambias de sección.
• El footer ya no queda tapado por la barra inferior al hacer scroll hasta el final en celular.

Arrastrar y soltar

• Más cómodo de usar en celular: el sistema espera un instante antes de empezar a arrastrar, así no interrumpe el scroll normal.
• El elemento que arrastras sigue tu dedo con precisión, sin desfasarse.
• Scroll automático cuando arrastras hacia los bordes de la pantalla, incluso entre paneles distintos (por ejemplo, al asignar productos a días en el horario semanal).
• Sin selección de texto accidental al mantener presionado un elemento.

Pedidos en mesa

• Comensales por grupo: al iniciar una segunda ronda, el contador ya no se vuelve a sumar. Cada grupo de la mesa lleva su propio número de comensales.
• Controles rápidos de comensales con botones − y +, y un indicador en formato {seleccionados}/{disponibles}, restando los asientos ocupados por otros grupos.
• Cambio fluido entre grupos: al elegir un grupo existente, se restauran sus comensales; al crear un grupo nuevo, el contador arranca limpio.
• Los descuentos del día se aplican correctamente al agregar productos a una orden.
• Cliente "Nuevo cliente" directo en el selector: al tomar pedido, tomar domicilio o cobrar, ya no tienes que cambiar de sección para registrar un cliente nuevo. Lo creas en un modal rápido y queda seleccionado automáticamente.

Corregir pedido

• Rondas separadas por grupo: cuando una mesa tiene varios grupos, las rondas se cuentan dentro de cada grupo, no en una sola lista.
• Selector de grupo tipo pestaña arriba del listado para alternar entre los grupos activos de la mesa.
• Indicador de qué grupo estás viendo ("Mostrando Grupo X · N rondas · M comensales") para que no haya duda.
• Puedes volver a aumentar la cantidad de un producto desde cero cuando corriges una orden.
• Aviso a cocina al corregir un pedido: si modificas un producto que va a cocina, el chef se entera.

Caja y crédito (fiado)

• No se puede cerrar la mesa hasta que todas las rondas estén entregadas: incluso si se hizo precobro, el sistema espera a que cocina + mesero terminen para evitar cobrar comida que no llegó.
• Pre-cobro a crédito ahora cierra correctamente: al confirmar el cierre, la deuda queda registrada en la cuenta del cliente automáticamente.
• Selector "Nuevo cliente" inline en Cobrar orden y Cobrar domicilio, tanto al asignar cliente a la orden como al cargar a cuenta de crédito.
• Facturación de grupos separada: al cobrar mesas con varios grupos, cada grupo genera su propia factura/visita en Órdenes completadas. Antes se mezclaban los pedidos en una sola factura.
• Cobro mixto de grupos en la misma mesa: ya puedes cobrar un grupo a crédito y otro con tarjeta/efectivo sin que el sistema confunda los grupos. Los grupos ya cargados a crédito dejan de bloquear el cobro de los grupos restantes.

Facturación y tickets

• Adiciones y observaciones con cargo aparecen en factura, ticket y correo: cada extra que el cliente pidió (queso adicional, salsas, etc.) y las observaciones con costo se muestran como sub-líneas indentadas debajo del producto base. Ahora la suma de líneas coincide con el total cobrado.
• Métodos de pago con etiquetas claras: ya no se muestra credit ni mixed en inglés. Se ve "A cuenta del cliente" y "Pago mixto" en facturas, tickets y correos.
• Pago mixto desglosado: cuando un cobro se divide en dos métodos (ej. parte efectivo + parte tarjeta), la factura y el correo muestran cada método con su monto. Antes el correo enviaba un código de programación crudo.
• Correo de factura completo: cuando una visita tiene varias rondas, el correo enviado al cliente incluye TODAS las rondas como una sola factura combinada. Antes solo se enviaba la primera ronda.
• Rondas separadas visualmente en factura combinada: cuando una visita tiene varias rondas, la factura, el ticket térmico y el correo muestran un encabezado "Ronda N · fecha/hora" antes de los productos de cada una. Así se distingue claramente qué se pidió en cada momento.

Productos

• Acciones del producto agrupadas en un solo botón con menú: editar, programar días, gestionar adiciones, eliminar y más, sin saturar la fila.
• Aviso visual de stock bajo o agotado directamente en la lista.
• Adiciones se refresca al instante después de crearlas o editarlas (antes había que recargar).

Wizard de creación / edición en 3 pasos

• Nuevo flujo en 3 pasos con barra de progreso visible:
  1. Información: datos del producto (Tipo, Modo, nombre, precio, etc.).
  2. Combo: selección de componentes — solo aparece si el tipo es "Combo".
  3. Multimedia: galería de imágenes y videos.
• El paso 2 se omite automáticamente para productos individuales.
• Botón "Crear producto" / "Guardar cambios" deshabilitado hasta completar todos los pasos válidos (campos requeridos + ≥1 componente si es combo). Ya no es posible enviar formularios incompletos.
• Navegación libre hacia atrás para corregir cualquier paso.

Tipo y Modo: dos selectores independientes

• El selector único "Tipo" se separa en dos campos:
  • Tipo: Producto / Combo — define si se compone de otros productos o no.
  • Modo: Preparado / Bajo pedido — define si requiere pasar por cocina.
• Los combos también pueden ser "bajo pedido": antes los combos siempre se trataban como preparados.
• El enrutamiento a cocina ahora considera el modo del combo + el modo de cada componente: si alguno requiere cocina, la orden pasa por cocina.

Combos rediseñados

• El combo se compone de otros productos: al crearlo defines qué productos lo integran y cuántas unidades de cada uno. Antes el combo era un producto suelto sin componentes reales.
• Stock automático y en cascada: el stock del combo se calcula a partir del stock de sus componentes. Por ejemplo, si un combo lleva 2× Hamburguesa y quedan 10 hamburguesas, el combo "Alcanza para 5".
• Al pedir un combo se descuenta a los componentes, no al combo. Si un mismo producto está en un combo y también como producto suelto en la misma orden, se suma y valida una sola vez contra el stock real.
• Sin anidación: un combo no puede contener a otro combo (mantiene la lógica clara).
• No se puede crear un combo vacío: el sistema te exige al menos un componente antes de guardar.
• Restauración al cancelar: si una orden con combos se cancela, los componentes recuperan su stock correctamente (antes solo se restauraba el combo).
• Badge "Combo" visible en la carta digital junto al nombre, con prioridad Agotado > Combo > Popular.
• Composición visible en la carta: debajo de la descripción se lista "Incluye: 2× Hamburguesa, 1× Papas, 1× Bebida". La vista de detalle muestra una sección dedicada "Este combo incluye".
• Agotado de combo automático: si un componente con control de stock se acaba, el combo aparece como "Agotado" sin acción manual.

Productos "Sin categoría"

• Ya no se publican en la carta digital. Esta sección queda como espacio interno para borradores u organización temporal.
• Aviso visual en el dashboard: la sección "Sin categoría" del constructor de menú muestra una etiqueta "No se muestra en la carta" para evitar confusión.
• Para publicar un producto debes asignarle una categoría existente o crear una nueva.

Reservas

• Los meseros ya pueden arrastrar reservas entre días, no solo dueños y administradores.
• "Nuevo cliente" inline también disponible al editar una reserva, para no salir del flujo.

Carta digital

• Vista previa instantánea al activar la carta: ya no hay que esperar a que el caché se renueve para verla.
• Recomendaciones visibles al subir el banner (relación 21:9, resolución sugerida, formatos, tamaño máximo) para evitar imágenes mal recortadas.
• Código QR con el logo Orkestria al centro, ahora visible en todos los temas.

Mesas

• Crear o cambiar de zona desde el formulario ya no cierra el modal por accidente al interactuar con el selector.

Permisos y roles

• Meseros pueden crear clientes directamente desde la lista o desde el selector inline en pedidos/reservas.
• Dueño sin restricciones: arreglado el caso en que un dueño no podía abrir caja, eliminar invitaciones u operar acciones administrativas porque el sistema no lo reconocía como miembro de su propio restaurante. Ahora se le asigna automáticamente como dueño en el primer acceso.

Modales

• Modales más cómodos en celular: el contenido largo ahora puede desplazarse sin romper el diseño.
• El fondo del modal bloquea correctamente la interacción con la página detrás; ya no se puede hacer scroll por accidente.
• Los menús desplegables dentro de un modal (selectores, combobox, etc.) ya no lo cierran al hacer clic dentro.
• El menú hamburguesa no abre el teclado al abrirse.

Accesibilidad y legibilidad

• Nuevo ajuste de tamaño de texto: si el texto te parece pequeño, puedes elegir entre 4 tamaños — Compacto, Normal, Grande y Extra grande — y todo el dashboard escala de manera proporcional (texto, botones, espaciados).
• Wizard de bienvenida: la primera vez que entras al dashboard, Orkestria te pregunta qué tamaño de texto prefieres con una vista previa en vivo. Después no vuelve a aparecer.
• Cámbialo cuando quieras desde Perfil → Preferencias UI → Legibilidad. Tu elección queda guardada y te sigue entre dispositivos.
• Vista previa en vivo: mientras eliges, ves un ejemplo real de cómo quedará la interfaz (nombre de producto, descripción, stock, botón), así sabes lo que estás aplicando antes de confirmar.
• Pestaña dedicada en perfil: la sección antes llamada "Preferencias UI" ahora se llama "Accesibilidad e interfaz" para que sea fácil de encontrar.
• Encabezados del menú lateral más claros: los títulos de grupo (MENÚ, CAJA, etc.) tienen tamaño fijo y un separador superior, así no se confunden con las pestañas — sobre todo cuando usas tamaños de texto grandes.

Faki (asistente IA)

• En celular, el chat se hace pequeño cuando Faki te muestra un resultado, para que veas lo que hizo.
• El botón flotante de Faki ya no tapa la barra inferior.
• La guía visual se cancela automáticamente si te vas a otra sección de la app durante el proceso. Antes Faki seguía intentando avanzar sobre la pantalla nueva.
• Faki ya sabe crear combos: puedes pedirle "crea un combo X con 2 hamburguesas y 1 papas" y Faki lo arma con los componentes existentes. Si falta info, te la pregunta antes de invocar. Antes solo sabía crear productos individuales.
• Editar componentes de un combo desde el chat: nueva acción setComboItems permite a Faki cambiar, añadir o quitar productos de un combo ya creado, conservando todas las validaciones (mínimo 1 componente, sin combos anidados, sin auto-referencia).
• Modo de preparación independiente del tipo: Faki ahora distingue claramente entre "producto vs combo" y "preparado vs bajo pedido". Puede crear un combo que requiera cocina, o uno listo para servir, según le pidas.
• Fix de bucle infinito al marcar tareas: ocasionalmente Faki entraba en un loop intentando marcar una tarea con un ID que no existía en su lista — el sistema decía "✓" en verde pero la tarea no avanzaba. Ahora si el ID no existe, Faki lo sabe al instante y corrige sin reintentar.
• Faki conoce el menú completo en una sola llamada: nueva acción listMenu devuelve todas las categorías + productos de un restaurante en una operación. Antes Faki buscaba producto por producto con searchProduct, lo que era lento y propenso a duplicados. Ahora cuando le pides crear un menú o auditar el catálogo, primero ve qué existe y evita duplicar.
• Faki no repite lecturas innecesarias: cuando Faki emite varias veces la misma consulta (ej. dos listMenu con los mismos argumentos en la misma respuesta), el sistema deduplica antes de ejecutar — verás una sola tarjeta de actividad en el chat en lugar de varias. Si Faki insiste, tras 3 intentos recibe un STOP forzoso para que avance con lo que ya tiene.

Aviso de nueva versión

• Modal "Qué hay de nuevo": cuando se actualiza Orkestria, te aparece una sola vez un aviso con un resumen del cambio y un botón Ver cambios que te lleva directo al changelog.
• Una vez por versión, por usuario: lo cierras una vez y ya no vuelve a aparecer hasta la próxima release.
• Usuarios nuevos no se molestan: si entras por primera vez, solo ves el wizard de accesibilidad — el aviso de versión se omite para no acumular interrupciones.

Centro de documentación

• Sección dedicada en /docs con changelogs y manual de usuario, accesible para todos (no requiere iniciar sesión).
• Accesos desde toda la plataforma: enlace en el landing, footer y dentro del dashboard.
• Selector de versiones para ver el detalle completo de cada release.
• Cambio de tema dentro de docs (claro, azul oscuro, noche): se sincroniza con el resto de la plataforma.
• Asistente Faki integrado en docs:
  • Conoce toda la documentación y responde tus dudas en español con Markdown (negritas, listas, secciones).
  • Page-agent: te lleva al lugar exacto de la respuesta. Resalta la sección concreta con un anillo visual.
  • Dos modos: flotante (sobre el contenido) o inmersivo (empuja el contenido a un lado, configurable y redimensionable).
  • Abierto por defecto en computador, cerrado por defecto en celular.
  • Límite por dispositivo: 10 consultas al día, sin afectar tu cuota de Faki en el resto de la app.

Tour guiado por rol

• Primera vez que entras a un restaurante con un rol nuevo: Faki te ofrece una guía rápida con paso a paso interactivo (resaltado, tooltips, navegación entre pestañas).
• Por rol: dueño, administrador, mesero, chef, cajero, encargado de domicilios y encargado de inventario tienen tours adaptados a lo esencial de su trabajo.
• Se muestra una sola vez por rol, aunque pertenezcas a varios restaurantes.
• Si lo saltas, no vuelve a aparecer, pero siempre puedes preguntarle a Faki para repasarlo.

Temas

• Tema noche corregido en facturación y otras zonas que se veían en blanco sobre blanco.
• El cambio de tema se sincroniza entre el landing, la app y el centro de documentación.

Otros

• Video del landing ya no se solapa con la barra superior en celular.
• Programar días de disponibilidad de un producto desde su menú de acciones.
• Acceso desde red local: la app se puede probar desde otro dispositivo en la misma red sin configurar nada extra.
• Redirección automática al expirar la sesión: si el token caduca mientras usas el dashboard, te enviamos al login con un aviso "Tu sesión expiró". Antes solo aparecía un error 401 silencioso.
• Vuelta al inicio en navegación interna: cuando un tab tiene flujo en pasos (cobrar mesa, cobrar domicilio, corregir pedido, tomar pedido, tomar domicilio, sesiones de caja, órdenes completadas, cuentas de crédito), al avanzar o retroceder de pantalla la página vuelve arriba automáticamente. Antes quedabas mirando el footer y daba sensación de estar perdido.