TAKU GO

Taku Go es una plataforma web completa para la gestión integral de restaurantes. Desde la apertura de caja por la mañana hasta el cierre financiero del día, Taku Go centraliza todas las operaciones de tu negocio en un solo lugar accesible desde cualquier navegador web.

¿Para quién es Taku Go?

Para el Usuario

• Navegador moderno: Google Chrome, Firefox, Microsoft Edge o Safari (versiones actualizadas).
• Conexión a internet: para acceder al sistema.
• Resolución mínima: 320px (celular). Recomendado: 1024px o superior para administración.

Para el Servidor

• Apache 2.4+ con PHP 7.4 o superior.
• MySQL 5.7+ o MariaDB 10.3+.
• XAMPP, WAMP, LAMP o cualquier stack compatible.

Registrar un Restaurante Nuevo

El proceso de registro crea simultáneamente tu restaurante y tu cuenta de administrador.

1. Accede a la pantalla de inicio y haz clic en "Registrarse".
2. Paso 1 — Datos del Restaurante: Ingresa el nombre del restaurante, dirección completa, teléfono de contacto.
3. Paso 2 — Cuenta de Administrador: Ingresa tu nombre completo, correo electrónico y crea una contraseña segura. Un medidor de fortaleza te indicará si es lo suficientemente robusta.
4. Haz clic en "Crear Restaurante". El sistema te redirigirá automáticamente al Dashboard y recibirás un correo de bienvenida.

Iniciar Sesión

1. Ingresa tu correo electrónico y contraseña.
2. Haz clic en "Entrar". El sistema te dirigirá según tu rol:
   • Admin → Dashboard
   • Mesero → Órdenes
   • Cocina → Pantalla de Cocina

Recuperación de Contraseña

1. Haz clic en "¿Olvidaste tu contraseña?" en la pantalla de login.
2. Ingresa tu correo electrónico registrado.
3. Recibirás un código de 6 dígitos en tu correo.
4. Ingresa el código y establece tu nueva contraseña.

Taku Go implementa un sistema de control de acceso basado en roles (RBAC). Cada usuario tiene un rol que determina qué módulos puede ver y qué acciones puede realizar.

Taku Go es una Single Page Application (SPA): toda la navegación ocurre sin recargar la página, proporcionando una experiencia rápida y fluida.

Barra Lateral (Sidebar)

• Ubicada a la izquierda, muestra los módulos disponibles según tu rol.
• Cada módulo tiene un ícono y un nombre descriptivo.
• El módulo activo se resalta con un borde rojo a la izquierda.
• En dispositivos móviles, la barra lateral se oculta y se accede con el botón ☰.

Barra Superior

• Muestra el nombre del restaurante, el nombre del usuario y su rol.
• Indicador de estado de caja (abierta/cerrada).
• Botón de cerrar sesión.

Notificaciones y Alertas

• Las alertas aparecen como toasts en esquina superior derecha.
• Se cierran automáticamente a los 4 segundos o al hacer clic.
• Colores: verde = éxito, rojo = error, amarillo = advertencia, azul = información.

Es la primera pantalla que ve el administrador al ingresar. Presenta un resumen ejecutivo de la operación del día.

La Caja Registradora permite controlar todo el flujo de dinero físico durante tu jornada. Cada turno de trabajo debe abrir y cerrar caja para un correcto control financiero.

Flujo de Trabajo

Abrir Caja

1. Haz clic en "Abrir Caja".
2. Ingresa el monto de apertura (dinero físico con el que inicias el turno).
3. Opcionalmente agrega notas (ej: "Turno mañana, fondo de cambio").
4. Confirma. La caja quedará en estado Abierta y se mostrará un banner indicador.

Registrar Movimientos

Durante la operación puedes registrar movimientos manuales de caja:

Cerrar Caja

1. Haz clic en "Cerrar Caja".
2. Ingresa el monto de cierre real (conteo manual del efectivo en caja).
3. El sistema calcula automáticamente:
   • Monto esperado = Apertura + ingresos − egresos
   • Diferencia = Cierre real − Monto esperado
4. Agrega notas de cierre si es necesario.
5. Confirma el cierre.

Resumen de Caja

El resumen muestra tres tarjetas principales:

• Saldo actual: monto de apertura + ingresos − egresos.
• Total ingresos: suma de todos los movimientos tipo ingreso.
• Total egresos: suma de todos los movimientos tipo egreso.

Historial de Cajas

Desde la pestaña "Historial" puedes consultar todas las cajas anteriores con su fecha de apertura, cierre, montos y diferencia. Las diferencias negativas se resaltan en rojo.

Administra las mesas físicas de tu restaurante. El sistema controla automáticamente el estado de cada mesa a lo largo del ciclo orden → factura.

Propiedades de una Mesa

Ciclo Automático de Estado

Las órdenes son el corazón de la operación. Registran qué pidió el cliente, en qué mesa y su estado de preparación.

Crear una Orden

1. Haz clic en "Nueva Orden".
2. Selecciona la mesa del cliente (solo se muestran mesas libres).
3. Agrega ítems del menú: selecciona la receta, indica la cantidad. El subtotal se calcula automáticamente.
4. Opcionalmente agrega notas (ej: "Sin cebolla", "Extra picante").
5. Haz clic en "Crear Orden". La mesa cambiará a "ocupada" automáticamente.

Flujo de Estados

Auto-Actualización

La lista de órdenes se actualiza automáticamente cada 10 segundos para mantenerte al día con los cambios realizados por cocina u otros meseros.

Vista diseñada para monitores o tablets en la cocina. Muestra los pedidos que se necesitan preparar en formato de tarjetas visuales.

Funcionamiento

• Se actualiza automáticamente cada 10 segundos (polling).
• Las tarjetas están codificadas por color según su estado.
• Se reproduce una alerta sonora cuando llega un pedido nuevo.

Acciones Disponibles

Información en cada Tarjeta

• Número de orden y mesa
• Lista de ítems con cantidades
• Notas especiales del cliente
• Tiempo transcurrido desde que se creó la orden

Las facturas se generan a partir de órdenes en estado "servido". El proceso cierra el ciclo de la orden y libera la mesa.

Generar Factura

1. En el listado de órdenes, localiza una orden en estado "Servido" y haz clic en "Facturar".
2. Ingresa el porcentaje de impuesto aplicable.
3. Selecciona la forma de pago: Efectivo, Tarjeta, Transferencia u Otro.
4. Confirma. El sistema calcula: Total = Subtotal + (Subtotal × Impuesto%).

Vista de Facturas

• Listado paginado con filtros por fecha.
• Detalle: ítems, subtotal, impuesto, total, forma de pago, cajero, fecha y hora.
• Identificación del cajero que generó cada factura.

Módulo para administrar pedidos a domicilio con seguimiento de estado tipo Kanban y gestión de repartidores.

Tablero Kanban

Visualiza los pedidos de domicilio en cinco columnas:

Gestión de Repartidores

• Agregar / editar / eliminar repartidores.
• Ver disponibilidad de cada repartidor.
• Asignar un repartidor a un pedido.

Estadísticas del Día

El tablero se auto-actualiza cada 15 segundos para reflejar cambios en tiempo real.

Administra las reservaciones de tus clientes con código QR único, vistas de lista y calendario, y estadísticas integradas.

Crear Reserva

1. Haz clic en "Nueva Reserva".
2. Completa: nombre del cliente, teléfono, fecha, hora, número de personas.
3. Opcionalmente indica ocasión especial (cumpleaños, aniversario, etc.).
4. Asigna una mesa específica (opcional).
5. Confirma. Se genera automáticamente un código QR único para la reserva.

Estados de Reserva

En cualquier momento una reserva puede pasar a Cancelada.

Vistas Disponibles

• Lista: tabla con filtros y paginación.
• Calendario: vista visual por día/semana.

Estadísticas

Búsqueda por QR

Cuando un cliente llega, usa el campo "Buscar por código QR" para localizar instantáneamente su reserva escaneando o ingresando el código.

Reservas Online (Clientes)

Los clientes pueden hacer reservas directamente desde la Página Web Pública de tu restaurante, sin necesidad de llamar. Ver sección Página Web Pública.

El módulo de inventario es uno de los más completos. Permite gestionar materias primas, proveedores, lotes con rotación FIFO/FEFO, movimientos de stock y alertas de desabastecimiento.

Familias de Inventario

Agrupa las materias primas en categorías lógicas para organizar tu inventario:

• Proteínas (carnes, pollo, mariscos)
• Verduras y Frutas
• Lácteos y Huevos
• Secos y Granos
• Bebidas
• Limpieza y Desechables

Materias Primas

Lotes

Si una materia prima es perecedera, cada compra se registra como un lote con:

• Número de lote (generado o manual)
• Fecha de vencimiento
• Cantidad
• Estado: Activo, Agotado, Vencido

El sistema marca automáticamente como Vencido los lotes que superen su fecha de vencimiento.

Movimientos de Stock

Cada cambio en el inventario queda registrado como un movimiento:

Alertas de Stock Bajo

Cuando el stock actual de una materia prima cae por debajo de su stock mínimo, aparece una alerta en:

• El Dashboard (sección de alertas críticas).
• El módulo de Inventario (pestaña "Alertas").
• Se puede generar una Orden de Compra automática desde las alertas (ver módulo Compras).

Proveedores

Directorio de proveedores con nombre, persona de contacto y teléfono. Cada proveedor puede vincularse a materias primas específicas.

Las recetas son los platos que ofrece tu restaurante. Cada receta tiene ingredientes con cantidades exactas, lo que permite calcular automáticamente el Food Cost (costo de materias primas).

Datos de una Receta

Cálculo de Food Cost

El sistema calcula automáticamente:

• Costo de ingredientes: suma del costo de cada ingrediente × su cantidad.
• Food Cost %: (Costo ingredientes / Precio de venta) × 100.

Indicadores visuales de semáforo:

• ● Verde — Food Cost < 30% (excelente)
• ● Amarillo — Food Cost 30-35% (aceptable)
• ● Rojo — Food Cost > 35% (revisar precio o ingredientes)

Duplicar Receta

Crea una copia de una receta existente con todos sus ingredientes. Útil para crear variantes (ej: "Hamburguesa Doble" a partir de "Hamburguesa Clásica").

Los menús agrupan recetas para organizar tu oferta gastronómica. Puedes tener múltiples menús activos al mismo tiempo.

Tipos de Menú

Horarios

Cada menú puede asociarse a un horario: Todo el día, Desayuno, Almuerzo o Cena.

Categorías del Menú

Dentro de cada menú puedes crear categorías (Entradas, Platos Fuertes, Postres, Bebidas) con ícono y color personalizables. Las categorías se pueden reordenar arrastrándolas.

Funcionalidades Adicionales

• Destacados: marca recetas como "recomendación del chef".
• Precio override: asigna un precio diferente al de la receta base para un menú específico.
• Duplicar menú: crea una copia completa de un menú con todas sus recetas.
• Activar/Desactivar: oculta menús sin eliminarlos.

Formaliza el proceso de abastecimiento con órdenes de compra que rastrean desde la solicitud hasta la recepción de mercancía.

Flujo de una Orden de Compra

En cualquier punto antes de recibir se puede cancelar la orden.

Crear Orden de Compra

1. Haz clic en "Nueva OC".
2. Selecciona el proveedor.
3. Agrega ítems: materia prima, cantidad solicitada, precio unitario.
4. Indica la fecha esperada de entrega.
5. Guarda como borrador o envía directamente.

Recibir Mercancía

Al hacer clic en "Recibir":

• El stock de cada materia prima se actualiza automáticamente.
• Se crea un movimiento de inventario tipo "compra" por cada ítem.
• Se crea un lote nuevo si la materia prima es perecedera.
• Se actualiza el historial de precios.

Generar OC desde Alertas

El botón "Generar desde alertas" crea automáticamente una orden de compra con todas las materias primas que están por debajo de su stock mínimo. El sistema calcula la cantidad necesaria para llegar al nivel mínimo.

Historial de Precios

Consulta la evolución del precio de cada materia prima a lo largo del tiempo. Útil para negociar con proveedores y detectar aumentos.

Registra y analiza las pérdidas de materia prima para identificar áreas de mejora y reducir costos.

Registrar Merma

1. Haz clic en "Registrar Merma".
2. Selecciona la materia prima afectada.
3. Ingresa la cantidad perdida.
4. Selecciona el motivo:
   • Vencimiento: producto expirado
   • Daño: daño durante almacenamiento/transporte
   • Preparación: desperdicio normal durante cocina
   • Accidente: derrame, caída, etc.
   • Robo: faltante por hurto
   • Otro
5. Agrega una descripción opcional.
6. Confirma. El stock se descuenta automáticamente.

Dashboard de Mermas

Gestiona la relación con tus clientes: lleva un registro de sus datos, consumo, etiquetas y cumpleaños.

Datos del Cliente

Funcionalidades

• Buscar clientes: búsqueda en tiempo real por nombre, teléfono o email.
• Top clientes: ranking por total consumido y número de visitas.
• Cumpleaños del mes: lista de clientes que cumplen años este mes — ideal para enviar felicitaciones o descuentos.

Registra todos los gastos de tu operación (arriendo, servicios, mantenimiento, nómina, etc.) para tener visibilidad real sobre la rentabilidad del negocio.

Categorías de Gastos

Primero, crea las categorías que aplican a tu negocio:

• Tipo: Fijo (arriendo, seguros) o Variable (insumos de limpieza).
• Presupuesto mensual: meta de gasto por categoría.
• Ícono y color: para identificación visual rápida.

Registrar un Gasto

1. Haz clic en "Nuevo Gasto".
2. Selecciona la categoría.
3. Opcionalmente vincula a un proveedor.
4. Ingresa: descripción, monto, fecha y forma de pago.
5. Si el gasto es a crédito, marca como pendiente e indica la fecha de vencimiento.
6. Si es recurrente, activa la opción e indica la frecuencia en días.

Gastos Pendientes

Visualiza todos los gastos pendientes de pago (crédito, servicios por pagar). Márcalos como pagados con un clic.

Resumen de Gastos

Vista consolidada de los últimos 30 días:

• Total gastado
• Total gastos fijos vs variables
• Comparativa contra presupuesto por categoría

El módulo de Finanzas te da la visión ejecutiva de la salud financiera de tu restaurante con un Estado de Resultados (P&L) automático.

Estado de Resultados (P&L)

Indicadores Clave (KPIs)

Los indicadores usan un sistema de semáforo: verde si estás dentro de la meta, amarillo si estás cerca del límite, rojo si superas la meta negativamente.

Flujo de Caja

Visualiza el movimiento de dinero (ingresos vs egresos) del período seleccionado.

Filtro por Período

Todas las vistas permiten filtrar por rango de fechas para analizar períodos específicos (semana, mes, trimestre, año).

Las notas de crédito permiten registrar devoluciones totales o parciales sobre facturas emitidas.

Tipos de Nota de Crédito

Define metas medibles para tu restaurante y monitorea el progreso en tiempo real.

Tipos de Metas

Progreso

La vista de "Progreso" muestra para cada meta:

• Valor actual calculado desde datos reales del período.
• Valor meta definido por ti.
• Barra de progreso con colores:
  • ● Rojo — menos del 50% de la meta
  • ● Amarillo — entre 50% y 80%
  • ● Verde — 80% o más de la meta

Reportes analíticos para tomar decisiones basadas en datos.

Reportes Disponibles

Ventas por Período

Selecciona un rango de fechas y consulta: total vendido, número de facturas, ticket promedio y detalle día a día. Disponible para exportar en PDF y Excel.

Productos Más Vendidos

Ranking de recetas por cantidad vendida e ingresos generados. Identifica tus platos estrella y los que necesitan promoción. Disponible en PDF y Excel.

Consumo de Insumos

Detalle de cuánto de cada materia prima se ha consumido en el período. Útil para proyectar compras y detectar consumos anómalos.

Ventas del Día

Resumen rápido de las ventas de hoy con desglose por hora.

Administra las cuentas de acceso al sistema. Cada persona que necesite usar Taku Go debe tener su propio usuario.

Crear Usuario

1. Haz clic en "Nuevo Usuario".
2. Ingresa: nombre completo, correo electrónico y contraseña.
3. Asigna un rol: Admin, Mesero o Cocina.
4. Confirma.

Gestión

• Editar: cambiar nombre, correo, rol o contraseña.
• Activar/Desactivar: desactiva temporalmente una cuenta sin eliminarla (ej: empleado de vacaciones).
• Eliminar: elimina la cuenta permanentemente.

Controla los horarios de tu equipo, registra asistencia, gestiona salarios y analiza el rendimiento de cada empleado.

Programar Turnos

1. Haz clic en "Nuevo Turno".
2. Selecciona el empleado.
3. Define fecha, hora de entrada y hora de salida.
4. Opcionalmente agrega notas (ej: "Encargado de cierre").

Check-in / Check-out

Cuando el empleado llega y sale, registra:

• Check-in: registra la hora real de llegada.
• Check-out: registra la hora real de salida.

Esto permite comparar horario programado vs horario real y detectar tardanzas.

Gestión de Salarios

Resumen de Horas

Consulta por período: horas programadas vs horas trabajadas, horas extra y ausencias por empleado.

Rendimiento del Personal

Cruza datos de turnos trabajados con facturas generadas para medir la productividad de cajeros y meseros:

• Horas trabajadas en el período.
• Facturas atendidas y monto total facturado.
• Venta promedio por hora trabajada.

Centro de configuración de tu restaurante organizado en 9 pestañas:

1. Información General

Nombre del restaurante, eslogan, dirección completa y número de teléfono. Esta información se muestra en la página web pública y en los documentos generados.

2. Contacto y Redes Sociales

Configura los enlaces a tus redes sociales: Facebook, Instagram, TikTok, YouTube, correo electrónico y sitio web externo. Estos se muestran en tu página web pública.

3. Información Fiscal

NIT/RUT, régimen tributario y dirección fiscal para facturación. Estos datos aparecen en las facturas generadas.

4. Operación

Configuración operativa del restaurante:

• Moneda: símbolo y nombre de la moneda local.
• Tasa de impuesto por defecto: porcentaje que se aplica automáticamente al facturar.
• Prefijo de numeración: prefijo para las facturas (ej: "FC-").

5. Horarios

Define el horario de operación para cada día de la semana (apertura y cierre). Esto se muestra en la página web pública.

6. Mensajes Personalizados

Configura los textos de:

• Mensaje de bienvenida (login)
• Confirmación de reserva
• Alerta de pedido listo
• Recordatorio de reserva

7. Configuración de Email

Configura tu servidor SMTP para enviar correos desde el sistema (confirmaciones, recuperación de contraseña, notificaciones). Incluye botón de enviar correo de prueba.

8. Marca (Branding)

Acceso rápido al módulo de personalización de marca. Ver sección Marca y Colores.

9. Página Web

Configuración de la página web pública. Ver sección Página Web Pública.

Personaliza la apariencia de Taku Go para reflejar la identidad de tu restaurante.

Elementos Personalizables

Restablecer Colores

El botón "Restaurar valores por defecto" devuelve todos los colores y la tipografía al tema estándar de Taku Go (rojo, negro y dorado).

Cada restaurante en Taku Go obtiene automáticamente una página web pública accesible para sus clientes. No necesitas dominio ni hosting adicional.

URL de tu Página

Tu página estará disponible en:

tu-dominio.com/Taku_go/frontend/menu.html#/tu-slug

Donde tu-slug es el identificador único de tu restaurante (ej: "lacasona", "el-buen-sabor").

Secciones de la Página

1. Hero / Banner Principal

Imagen de banner con el nombre de tu restaurante, eslogan y un efecto visual de partículas animadas. Configurable desde Mi Restaurante.

2. Navegación Sticky

Barra de navegación fija con secciones: Inicio, Menú, Promos, Info.

3. Menú Digital

Tus menús activos se muestran automáticamente con:

• Categorías organizadas
• Nombre, descripción y precio de cada plato
• Imágenes de platos
• Indicadores de destacados

4. Promociones

Sección de promociones activas con imagen, título, descripción y vigencia. Adminístralas desde la pestaña "Página Web" de Mi Restaurante:

• Crear promociones con título, descripción, imagen, fecha inicio y fecha fin.
• Subir imágenes de promociones.
• Las promociones vencidas se ocultan automáticamente.

5. Información del Restaurante

Datos de contacto, dirección, horarios de operación, enlaces a redes sociales.

6. Reservas Online

Los clientes pueden hacer reservas directamente desde la web:

1. El cliente ingresa: nombre, fecha, hora y número de personas.
2. Envía la solicitud.
3. La reserva aparece en tu módulo de Reservas con estado Pendiente.
4. Tú la confirmas, y opcionalmente el sistema envía un correo de confirmación.

Taku Go es un sistema multi-tenant: una sola instalación puede servir a múltiples restaurantes, cada uno con sus datos completamente aislados.

¿Cómo funciona?

• Cada restaurante es un "Tenant" con un ID único.
• Todas las entidades (usuarios, inventario, recetas, órdenes, facturas, etc.) están asociadas a su tenant mediante un tenant_id.
• Cada consulta a la base de datos filtra automáticamente por el tenant del usuario autenticado.
• Es imposible que un usuario de "La Casona" vea datos de "El Buen Sabor" y viceversa.

Gestión de Tenants (Superadmin)

El Superadmin puede:

• Ver todos los restaurantes registrados.
• Activar/Desactivar un restaurante (un restaurante desactivado no permite login a sus usuarios).
• Eliminar un restaurante (desactivación lógica).

Taku Go implementa múltiples capas de seguridad para proteger los datos de tu restaurante.

¿No puedo iniciar sesión?

• Verifica que el correo y la contraseña sean correctos.
• Si olvidaste tu contraseña, usa la opción "¿Olvidaste tu contraseña?".
• Si tu cuenta fue desactivada, contacta al administrador de tu restaurante.
• Si el restaurante fue desactivado, contacta al superadmin de la plataforma.

¿No puedo facturar?

• Verifica que la orden esté en estado "Servido".
• Verifica que haya una caja abierta (si tu restaurante lo requiere).

¿El inventario no se actualiza?

• El inventario se descuenta automáticamente al marcar una orden como "Servido".
• Para ajustes manuales, usa el módulo de Inventario → Movimientos.
• Las mermas se registran desde el módulo Mermas.

¿Cómo exporto datos?

• Ve a Reportes → selecciona el tipo de reporte.
• Haz clic en el botón PDF o Excel según necesites.

¿Puedo usar Taku Go en el celular?

Sí. La interfaz es responsiva y se adapta automáticamente a pantallas de celular y tablet. Es especialmente útil para meseros (toma de pedidos) y cocina (pantalla KDS).

Este es el flujo típico de un día de operación en tu restaurante con Taku Go:

1. Apertura de Caja — El cajero/admin abre la caja registradora con el fondo de cambio del día.
2. Revisión del Dashboard — Verificar alertas de stock bajo, reservas del día y metas pendientes.
3. Recepción de mercancía — Si llegan pedidos de proveedores, registrar la recepción en Compras para actualizar inventario.
4. Atender clientes — Los meseros crean órdenes seleccionando mesa e ítems del menú.
5. Cocina prepara — El personal de cocina ve los pedidos en la pantalla KDS, los marca como "en preparación" y luego "listo".
6. Mesero sirve — Marca la orden como "servida". El inventario se descuenta automáticamente.
7. Facturación — Se genera la factura con forma de pago e impuesto. La mesa se libera.
8. Delivery — Los pedidos a domicilio se gestionan desde el tablero Kanban.
9. Registrar gastos — Pagos de servicios, compras menores, etc.
10. Registrar mermas — Productos vencidos, dañados o desperdiciados.
11. Cierre de caja — Conteo manual de efectivo, comparación con el sistema, registro de diferencias.
12. Revisión financiera — Consultar el P&L del día, verificar indicadores y progreso de metas.