Empleados, Roles y Permisos por Sucursal

El sistema de empleados de Emelit Express te permite dar acceso al panel de negocio a todo tu personal — desde el cocinero hasta el administrador — controlando exactamente que puede ver y hacer cada persona, y desde que sucursal puede hacerlo. Despues del refactor de sucursales, cada empleado PERTENECE a una sucursal obligatoria y los dueos pueden administrar todas sus sucursales desde un solo panel.

Antes de empezar

Antes de crear empleados en el sistema, necesitas tener listo lo siguiente:

Tu negocio ya debe estar creado en Emelit Express y al registrar el negocio el sistema crea automaticamente la sucursal Matriz (is_main=1). Esta Matriz no se puede eliminar.
Debes tener al menos una sucursal configurada. La Matriz cuenta como tu primera sucursal. Si tienes mas, el sistema las administra con el composable useManagerBranch que gestiona la sucursal activa en cada momento.
Debes tener acceso como Dueno. Los empleados NO pueden crear ni editar a otros empleados aunque tengan permisos de administracion interna; solo el dueno del negocio gestionan el personal. Esto evita que un encargado de una sucursal mueva personal a otra sucursal sin autorizacion.
Ten a la mano la informacion de cada empleado:
- Nombre completo (tal como aparece en su identificacion oficial).
- Correo electronico (puede ser Gmail, Outlook, Hotmail o cualquier otro).
- La sucursal donde trabajara de forma FIJA (no podra cambiarla por si mismo).
- Que funciones necesitara hacer en el sistema (para elegir o crear el rol adecuado).
Entiende el modelo de sucursal del empleado:
- El campo sucursal_id del usuario es OBLIGATORIO. Sin sucursal no se puede crear un empleado.
- Los empleados estan FIJOS en su sucursal asignada. No pueden cambiar de sucursal solos.
- Al crear un empleado desde una sucursal especifica (no en “Todas”), el sistema auto-asigna esa sucursal al nuevo empleado.
- En la vista “Todas” (solo para el dueno), los empleados se agrupan por sucursal usando groupedEmployees.
- El filtro visibleEmployees ajusta la lista segun la sucursal activa del selector.

Conceptos importantes que debes conocer

Empleado: Es la cuenta de acceso al sistema para una persona que trabaja en tu negocio. Cada empleado esta obligatoriamente ligado a una sucursal (user.sucursal_id).
Rol: Es un conjunto de permisos que define que pantallas y botones puede ver y usar un empleado. Un rol se puede asignar a muchos empleados. Ejemplo: todos los meseros comparten el rol “Mesero”.
Permiso: Es cada funcion especifica que se puede activar o desactivar. Ejemplo: “Ver pedidos”, “Gestionar inventario”, “Ver reportes”.
Sucursal activa: La sucursal seleccionada en el selector superior del panel (gestionada por useManagerBranch). Determina que datos se ven y que datos se crean en cada peticion mediante el header X-Manager-Branch-Id.
Selector de sucursal: Menu desplegable superior. Los dueos ven “Todas” o una sucursal especifica. Los empleados no ven el selector porque su sucursal ya esta fija.
Credenciales: Son el correo electronico (usuario) y la contrasena que el empleado usa para iniciar sesion.

Paso a paso detallado

Como entrar a la seccion de Empleados

Abre tu navegador de internet (Chrome, Firefox, Edge, Safari o el que uses normalmente) en tu computadora, laptop o tableta.
Escribe en la barra de direcciones la direccion web de tu panel de negocio. Generalmente es algo como https://app.emelitexpress.com. Presiona la tecla Enter.
Aparecera la pantalla de inicio de sesion. Escribe tu correo electronico (el que registraste como dueno del negocio) en el primer campo.
Escribe tu contrasena en el segundo campo.
Haz clic en el boton “Iniciar sesion”.
Una vez dentro del panel, localiza la barra lateral izquierda y la seccion “Equipo”.
Debajo de “Equipo” veras la opcion “Empleados”. Haz clic ahi.
Si eres el dueno y tienes varias sucursales, en la parte superior veras el selector de sucursal. Ahi puedes elegir:
- “Todas” para ver el personal de todas las sucursales agrupadas (vista consolidada del dueno).
- Cualquier sucursal especifica (ej. “Sucursal Centro”) para ver unicamente los empleados de esa sucursal.
Si eres un empleado (no dueno), no veras el selector de sucursal porque tu sucursal ya esta fija en el sistema y solo ves tu propia sucursal.
La pantalla principal mostrara:
- En la parte superior: tarjetas de resumen (total de empleados, activos, por sucursal).
- Dos pestanas: “Empleados” y “Roles”.
- Una tabla con la lista de empleados. En la vista “Todas” aparecen agrupados por sucursal gracias a groupedEmployees. En una sucursal especifica, visibleEmployees filtra solo los que pertenecen a esa sucursal.
- Un boton para agregar un nuevo empleado (generalmente dice “Agregar empleado” y esta en la esquina superior derecha). Solo el dueno ve este boton.

Como crear un empleado nuevo — instrucciones detalladas

Ejemplo: Acabas de contratar a Maria Guadalupe Garcia Hernandez como mesera en tu restaurante “Mariscos El Patron”, sucursal Centro de Veracruz.

Paso 1: Selecciona la sucursal correcta en el selector

Como eres el dueno y tienes varias sucursales:

En el selector de sucursal superior, elige “Sucursal Centro Veracruz” (la sucursal donde trabajara Maria).
Por que es importante hacerlo ANTES de abrir el formulario: Al crear el empleado desde una sucursal especifica, el sistema auto-asigna esa sucursal al campo sucursal_id del nuevo empleado. Asi no tienes que seleccionarla manualmente y se evitan errores de asignacion.
Si tienes el selector en “Todas”, el formulario te pedira elegir la sucursal manualmente, pero siempre es mas seguro preseleccionarla.

Paso 2: Abrir el formulario de creacion

Haz clic en el boton “Agregar empleado”. Esta en la parte superior derecha de la pantalla, generalmente de color azul o verde.
Se abrira un panel lateral que se desliza desde la derecha o una ventana emergente (modal) en el centro.

Paso 3: Llenar el nombre completo

Busca el campo de texto con la etiqueta “Nombre completo”.
Haz clic dentro del rectangulo y escribe: Maria Guadalupe Garcia Hernandez.
Consejo: Usa nombres y apellidos completos. Evita apodos como “Lupita” o “Mari”.

Paso 4: Llenar el correo electronico

Busca el campo “Correo electronico” o “Email”.
Escribe el correo. Ejemplo: maria.garcia.trabajo@gmail.com.
MUY IMPORTANTE: Revisa que el correo este perfectamente escrito. Un error tipografico hara que el empleado no pueda iniciar sesion ni recibir notificaciones.
Cada empleado debe tener un correo UNICO. El sistema no permite dos empleados con el mismo correo.

Paso 5: Asignar una contrasena temporal

Busca el campo “Contrasena”.
Escribe una contrasena temporal de al menos 8 caracteres. Combina mayusculas, minusculas y numeros. Ejemplos: Mesera2024!, MariscosV01, Bienvenido1$.
EVITA: 123456, password, empleado, el nombre del negocio o del empleado solos.
Anota esta contrasena en un papel o en una nota privada. El sistema no te la mostrara de nuevo despues de guardar.

Paso 6: Verificar la sucursal asignada

Si preseleccionaste la sucursal en el selector (Paso 1), el campo “Sucursal” del formulario ya estara auto-asignado con Sucursal Centro Veracruz.
Verifica que sea la correcta. Es OBLIGATORIO: no puedes dejar el campo vacio.
El empleado quedara FIJO en esta sucursal. No podra cambiarla por si mismo. Si en el futuro necesitas cambiarlo de sucursal, tu como dueno tendras que editar el empleado y reasignarlo manualmente.
Si llegaste al formulario con el selector en “Todas”, el formulario te exigira elegir una sucursal antes de dejarlo guardar.

Paso 7: Asignar un rol

Busca el selector “Rol”.
Elige el rol que corresponda a las funciones del empleado. Ejemplo: Mesero.
Si no ves el rol que necesitas, primero debes crearlo en la pestana Roles (lee mas abajo “Como crear un rol personalizado”).
Que puede hacer cada rol tipico:

Rol	Funciones principales	Puede ver dinero y reportes?
Administrador	ACCESO TOTAL: empleados, inventario, reportes, configuracion, pedidos, caja.	Si, todo.
Cajero	Punto de venta (POS), cobrar pedidos, ver historial de ventas del dia.	Solo ventas del dia.
Cocinero	Ver pedidos pendientes, marcar “En preparacion” y “Listo para servir”.	No.
Mesero	Tomar pedidos, asignar mesas, ver cuentas abiertas, generar tickets.	No.
Almacenista	Gestionar inventario, registrar compras, registrar mermas, ver stock.	No (solo costos de inventario).
Repartidor Interno	Ver pedidos para entrega propia, marcar como entregado.	No.

Paso 8: Guardar el empleado

Revisa cuidadosamente antes de guardar:
- El nombre esta bien escrito.
- El correo esta correcto (sin errores de dedo).
- La sucursal es la correcta (es la que se auto-asigno o la que elegiste). Este campo no puede quedar vacio.
- El rol es el adecuado.
Haz clic en “Guardar” o “Crear empleado”.
Veras un mensaje verde: “Empleado creado exitosamente”.
El formulario se cerrara.
El nuevo empleado aparecera en la tabla dentro del grupo de su sucursal.

Paso 9: Entregar las credenciales al empleado

Dile al empleado la direccion web donde debe iniciar sesion. Ejemplo: https://app.emelitexpress.com/manager/authenticate
Dile su correo electronico (usuario): maria.garcia.trabajo@gmail.com
Dile su contrasena temporal: Mesera2024!
Recomendacion: Entrega las credenciales en persona o por mensaje privado. Nunca las compartas en grupos de WhatsApp ni las dejes escritas en un papel pegado en la pared.
La primera vez que el empleado inicie sesion, el sistema le pedira cambiar su contrasena.

Como crear un rol personalizado

Imagina que necesitas un rol especial para “Supervisor de Piso”: alguien que es mesero pero ademas puede ver los reportes de ventas del dia y revisar el inventario (sin modificarlo).

Paso 1: Ir a la seccion de Roles

En la pantalla de Empleados, mira la parte superior. Veras dos pestanas: “Empleados” y “Roles”.
Haz clic en la pestana “Roles”. La tabla cambiara para mostrar los roles existentes.

Paso 2: Abrir el formulario de creacion

Haz clic en el boton “Crear rol” o ”+ Nuevo rol” (esquina superior derecha).

Paso 3: Nombrar el rol

En el campo “Nombre del rol”, escribe un nombre claro y descriptivo. Ejemplos:
- Supervisor de Piso
- Cocinero Turno Matutino
- Encargado de Sucursal
- Auxiliar Administrativo
Evita nombres genericos como “Rol 1” o “Nuevo” que despues no sabras que significan.

Paso 4: Seleccionar los permisos

Veras los permisos organizados en tres modulos principales. Cada modulo tiene un interruptor (switch) general y dentro puede tener permisos individuales:

Modulo Operacion:

Ver pedidos: El empleado puede entrar a la pantalla de pedidos y ver la lista de ordenes activas y pasadas (de su sucursal).
Gestionar pedidos: Puede cambiar el estado de los pedidos, cancelar y editarlos dentro de su sucursal.
Punto de venta (POS): Puede abrir la caja virtual, cobrar en efectivo o tarjeta, aplicar descuentos, generar tickets de venta. opera siempre en la sucursal donde esta asignado.
Gestionar menu: Puede agregar, editar o desactivar productos del menu, cambiar precios y descripciones.
Gestionar mesas: Puede usar la vista de mesas del restaurante (de su sucursal), asignar comensales, mover mesas, liberar mesas.
Ver inventario: Puede consultar el stock de productos e ingredientes de su sucursal (solo lectura).
Gestionar inventario: Puede crear items nuevos, ajustar cantidades de stock, registrar compras, mermas y recetas, siempre dentro de su sucursal.

Modulo Equipo:

Ver empleados: Puede ver la lista de empleados (de su sucursal), sus roles y estado (no puede crear ni editar).
Gestionar repartidores: Puede desvincular o eliminar repartidores de su sucursal.
Gestionar empleados: Reservado para el dueno. Un empleado con permisos de administracion interna puede editar datos menores de su personal, pero los movimientos de alta (crear, eliminar, reasignar sucursal) quedan bloqueados para el dueno.

Modulo Administracion:

Ver analiticas y reportes: Puede acceder a graficas de ventas, productos mas vendidos, reportes de ingresos por dia/semana/mes (filtrados por su sucursal).
Configuracion del negocio: Puede cambiar nombre, logo, horarios, impuestos, metodos de pago y otras configuraciones del negocio.
Gestionar sucursales: Reservado para el dueno. Permite crear sucursales nuevas y editar datos.
Gestionar integraciones: Puede conectar el sistema con apps de delivery y pasarelas de pago.

Para cada permiso que necesites, haz clic en el interruptor para activarlo (se pondra de color verde o azul). Para los que no necesites, dejalos apagados (color gris).

Paso 5: Guardar el rol

Haz clic en “Guardar” o “Crear rol”.
Veras “Rol creado exitosamente”.
El nuevo rol ya esta disponible para asignar a cualquier empleado.

Permisos adicionales por empleado (excepciones)

Que pasa si tienes un mesero de mucha confianza que, ademas de sus funciones normales de mesero, necesitas que pueda ver los reportes de ventas? No quieres cambiar el rol de TODOS los meseros, solo el de esta persona.

Busca al empleado en la tabla de empleados (asegurate de estar en la sucursal del empleado o en “Todas”).
Haz clic en su nombre o en el icono de editar (lapiz). Solo el dueno puede editar empleados.
En el formulario de edicion, ademas del campo de Rol, busca la seccion “Permisos adicionales” o “Permisos extra”.
Activa UNICAMENTE los permisos extra que esta persona necesita. Ejemplo: activa “Ver analiticas y reportes”.
Haz clic en “Guardar”.
Estos permisos adicionales se suman a los que ya tiene por su rol. No reemplazan al rol, solo lo complementan.

Como buscar, filtrar y gestionar empleados

Buscar un empleado por nombre

En la parte superior de la tabla de empleados, busca un campo de texto con un icono de lupa y el texto “Buscar empleado…”.
Escribe el nombre o apellido del empleado. La tabla se filtrara automaticamente mostrando solo los empleados que coincidan, dentro del alcance de tu sucursal activa.

Filtrar por sucursal (solo el dueno)

Si eres el dueno y tienes el selector de sucursal en “Todas”, la tabla muestra todos los empleados agrupados por sucursal (groupedEmployees).
Si cambias el selector a una sucursal especifica, visibleEmployees filtra y solo veras los empleados de esa sucursal.
Los empleados (no duenos) NO pueden cambiar el selector, asi que siempre ven unicamente los empleados de su propia sucursal.

Filtrar por rol

Busca un menu desplegable con la etiqueta “Rol” o “Todos los roles”.
Selecciona un rol especifico (ej. “Mesero”).
La tabla mostrara solo los empleados con ese rol, dentro del alcance de tu sucursal activa.

Filtrar por estado (activo / inactivo)

Busca un menu desplegable “Estado” o un grupo de botones: “Todos”, “Activos”, “Inactivos”.
Los empleados Activos pueden iniciar sesion y usar el sistema.
Los empleados Inactivos NO pueden iniciar sesion, aunque sus datos y contrasena se conservan.

Activar o desactivar un empleado

En cada fila de la tabla, busca un interruptor en la columna “Estado” o “Activo”.
Si el interruptor esta a la derecha y de color verde/azul, el empleado esta ACTIVO.
Si esta a la izquierda y gris, esta INACTIVO.
Haz clic en el interruptor para cambiar de un estado a otro.
Usa la desactivacion para empleados que salen de vacaciones, empleados temporales fuera de temporada, o cuando alguien deja de trabajar pero quieres conservar su historial.

Restablecer la contrasena de un empleado

Busca la fila del empleado en la tabla.
En la columna de “Acciones”, busca un boton con tres puntos (…) o un icono de engrane.
Haz clic y selecciona “Restablecer contrasena”.
El sistema generara automaticamente una nueva contrasena temporal y la mostrara en pantalla.
Copia la contrasena y entregasela al empleado de forma segura.
El empleado debera usar esta contrasena temporal para iniciar sesion. El sistema le pedira que la cambie inmediatamente.

Eliminar un empleado

Busca la fila del empleado. Solo el dueno puede eliminar empleados.
En la columna “Acciones”, busca el icono de bote de basura o la opcion “Eliminar”.
Haz clic. Aparecera una ventana de confirmacion: “Esta seguro de eliminar a este empleado? Esta accion no se puede deshacer.”
Si estas COMPLETAMENTE SEGURO, haz clic en “Confirmar”.
IMPORTANTE: Eliminar es permanente. Si solo necesitas que alguien deje de acceder temporalmente, usa la opcion de DESACTIVAR en lugar de eliminar.

Ejemplo practico

Negocio: Taqueria “El Trompo Feliz”

Dueno: Sr. Juan Manuel Ortega. Sucursales: Coyoacan (CDMX) y Roma Norte (CDMX). La sucursal Coyoacan es la Matriz (is_main=1) y se creo automaticamente al registrar el negocio. Empleados a configurar: 5 personas.

Situacion real:

El Sr. Ortega acaba de abrir su segunda sucursal en la Roma Norte y necesita dejar todo el sistema configurado. Despues del refactor de sucursales, cada empleado se asigna a una sucursal OBLIGATORIA y se mantiene fijo en ella.

Persona 1: Ana Laura Mendez — Encargada de la sucursal Coyoacan

Necesita hacer de todo en su sucursal: ver pedidos, gestionar el menu, ver reportes de ventas, revisar inventario y administrar el dia a dia.
Esta ASIGNADA de forma fija a la sucursal Coyoacan. No puede ver ni modificar datos de la sucursal Roma Norte.
Rol creado: Encargado de Sucursal
Permisos asignados: Todos los del modulo Operacion + Ver empleados + Ver analiticas y reportes. NO puede crear empleados ni gestionar sucursales (esos permisos son del dueno).

Persona 2 y 3: Pedro Martinez y Luis Hernandez — Cocineros (Sucursal Coyoacan)

Solo necesitan ver los pedidos que van llegando en tiempo real, con los detalles de que lleva cada orden.
Cambiar el estado: “Recibido” → “En preparacion” → “Listo para servir”.
Estan asignados de forma fija a la sucursal Coyoacan.
Rol creado: Cocinero
Permisos asignados: Ver pedidos + Gestionar pedidos (solo cambiar estado). Nada mas.

Persona 4: Karla Ramirez — Cajera (Sucursal Roma Norte)

Usa el punto de venta (POS) para cobrar en caja, recibir efectivo y tarjetas, y entregar tickets.
Antes del refactor Karla trabajaba en Coyoacan, pero ahora fue movida de forma fija a la sucursal Roma Norte. El Sr. Ortega edito su empleado y cambio su sucursal_id a Roma Norte porque los empleados no pueden moverse solos.
Rol creado: Cajero
Permisos asignados: POS + Ver historial de ventas del dia.

Persona 5: Sr. Juan Manuel Ortega — Dueno

Usa el rol “Dueno” que viene por defecto. Acceso total a TODO: ambas sucursales, todos los empleados, toda la configuracion, todos los reportes.
En el selector de sucursal ve “Todas” y puede alternar entre Coyoacan, Roma Norte o la vista consolidada agrupada por sucursal.
El NUNCA comparte su contrasena con nadie. Si necesita que alguien haga algo administrativo, lo hace el mismo porque es el unico que puede crear/editar empleados.

Proceso que siguio el Sr. Ortega:

Dia lunes, 9:00 AM: Entro al sistema desde su laptop en la oficina.
En el selector de sucursal superior, selecciono “Sucursal Coyoacan” para crear alli a sus primeros empleados. Al tener el selector en esa sucursal, el sistema auto-asignaria sucursal_id = Coyoacan a los nuevos empleados.
Fue a Equipo > Empleados > Pestana Roles y creo los roles Encargado de Sucursal, Cocinero y Cajero.
Regreso a la Pestana Empleados (sigue en el selector Coyoacan) y creo:
- Ana Laura Mendez — correo ana.laura.el.trompo@gmail.com, sucursal Coyoacan (auto-asignada), rol Encargado de Sucursal.
- Pedro Martinez — correo pedro.cocina@gmail.com, sucursal Coyoacan (auto-asignada), rol Cocinero.
- Luis Hernandez — correo luis.cocina@gmail.com, sucursal Coyoacan (auto-asignada), rol Cocinero.
Cambio el selector de sucursal a “Sucursal Roma Norte” y creo:
- Karla Ramirez — correo karla.caja@outlook.com, sucursal Roma Norte (auto-asignada), rol Cajero.
3:00 PM: Se reunio con cada empleado, les entrego sus credenciales en persona y les pidio que iniciaran sesion frente a el.
Pedro inicio sesion en la tablet de la cocina y solo pudo ver los pedidos de Coyoacan. Correcto.
Karla inicio sesion en la computadora de caja y solo vio datos de Roma Norte. Correcto.
El Sr. Ortega, desde su cuenta de dueno, puso el selector en “Todas” y vio la lista completa de los 5 empleados agrupados por sucursal (Coyoacan: Ana, Pedro, Luis; Roma Norte: Karla). Todo quedo funcionando.

Flujo de trabajo recomendado

Para configurar un negocio desde cero:

SEMANA 1: PLANEACION
  Lunes:
    └─ Sientate con papel y lapiz.
    └─ Haz una lista de TODAS las personas que trabajaran contigo.
    └─ Al lado de cada nombre, escribe a QUE SUCURSAL pertenecera.
    └─ Agrupa a las personas por funcion similar (todos los cocineros juntos,
       todos los meseros juntos) DENTRO de cada sucursal.
  Martes:
    └─ Define los ROLES basados en las funciones que agrupaste.
    └─ No crees un rol por persona. Crea un rol por PUESTO.
  Miercoles:
    └─ Recolecta los correos electronicos de todos.
    └─ Prepara las contrasenas temporales (diferentes para cada quien).

SEMANA 2: CONFIGURACION EN EL SISTEMA
  Jueves (2-3 horas):
    └─ Entra al sistema.
    └─ Ve a Equipo > Empleados > Pestana Roles.
    └─ Crea TODOS los roles que planeaste, uno por uno.
    └─ Ve a la Pestana Empleados.
    └─ POR CADA SUCURSAL: selecciona la sucursal en el selector superior,
       crea los empleados que perteneceran a esa sucursal. El sistema
       auto-asignara la sucursal activa al nuevo empleado.
    └─ Entrega las credenciales a cada persona.
  Viernes (PRUEBA OBLIGATORIA):
    └─ Pidele a CADA empleado que inicie sesion frente a ti.
    └─ Verifica que cada quien vea SOLO lo de SU SUCURSAL.
    └─ Como dueno, pon el selector en "Todas" y verifica que se ven
       todos los empleados agrupados por sucursal.

Para la operacion del dia a dia:

CUANDO CONTRATAS A ALGUIEN NUEVO:
  └─ Primero elige la sucursal correcta en el selector superior.
  └─ Solo despues abre el formulario "Agregar empleado".
  └─ El sistema auto-asignara la sucursal activa al nuevo empleado.
  └─ Entrega las credenciales en persona.

CUANDO ALGUIEN SE MUDA DE SUCURSAL (REASIGNACION):
  └─ Como dueno, edita el empleado y cambia manualmente su sucursal.
  └─ Recuerda que el empleado NO puede hacer este cambio por si mismo.
  └─ Avisa al empleado para que cierre sesion y vuelva a entrar; vera
     los datos de su nueva sucursal la proxima vez que inicie sesion.

CUANDO ALGUIEN RENUNCIA O ES DESPEDIDO:
  └─ DESACTIVA su cuenta INMEDIATAMENTE. No esperes.

CADA PRIMER LUNES DE MES (MANTENIMIENTO):
  └─ Como dueno, pon el selector en "Todas" y revisa el personal
     agrupado por sucursal.
  └─ Preguntate: todas estas personas siguen trabajando en esa sucursal?
  └─ Si alguien cambio de puesto o de sucursal, actualizalo.

Errores comunes y soluciones

Error que te aparece en pantalla o problema	Causa mas probable	Como resolverlo paso a paso
”El empleado no puede iniciar sesion” / “Credenciales invalidas”	Escribio mal su correo o contrasena. O tu escribiste mal el correo al crearlo.	1. Revisa en la tabla de empleados que el correo registrado sea EXACTAMENTE el que esta intentando usar. 2. Fijate en puntos, mayusculas y minusculas. 3. Si el correo esta bien, restablece su contrasena y dale la nueva.
”No me aparece el boton de Agregar empleado”	No eres el dueno. Despues del refactor, solo el dueno puede crear y editar empleados.	1. Si eres un empleado con permisos de administracion, pidele al dueno que cree el empleado por ti o que lo asigne como tarea administrativa. 2. Si eres el dueno y aun asi no lo ves, revisa tu plan contratado en la seccion de Facturacion.
”El formulario no me deja guardar, dice que falta la sucursal”	Llegaste al formulario con el selector en “Todas” y no elegiste una sucursal especifica.	1. Cierra el formulario. 2. En el selector superior, elige la sucursal donde trabajara el empleado. 3. Vuelve a abrir el formulario. Ahora la sucursal estara auto-asignada.
”Cree un empleado pero no aparece en la lista”	Los filtros de busqueda, rol o estado estan ocultandolo, o estas en una sucursal distinta a la del empleado.	1. Como dueno, pon el selector en “Todas” para ver a todos los empleados agrupados por sucursal. 2. Borra cualquier texto en el campo de busqueda. 3. Cambia el filtro de estado a “Todos” o “Activos”.
”Edite a un empleado y le cambie la sucursal pero sigue viendo la antigua”	El empleado tiene la sesion abierta y el cambio de `sucursal_id` solo aplica al recargar.	Pidele al empleado que cierre sesion y vuelva a iniciar sesion. El header `X-Manager-Branch-Id` se recalcula con la nueva sucursal asignada.
”Un empleado me dice que ve opciones del menu lateral que no deberia ver”	Su rol tiene permisos activos que no corresponden a su puesto.	1. Ve a la pestana Roles. 2. Busca el rol de ese empleado. 3. Revisa los permisos. 4. Desactiva lo que no necesita.
”La contrasena temporal no funciona” / “El sistema dice que la contrasena ya expiro”	Las contrasenas temporales pueden tener un tiempo limitado de validez.	Simplemente restablece la contrasena de nuevo.
”Elimine un empleado por accidente”	Hiciste clic en Eliminar y confirmaste sin querer.	Lamentablemente no se puede recuperar. Deberas crear al empleado nuevamente desde cero, incluyendo la seleccion de su sucursal. Moraleja: Siempre prefiere DESACTIVAR en lugar de ELIMINAR.
”Dos empleados me dicen que tienen el mismo correo y no pueden entrar”	Intentaste crear dos empleados con la misma direccion de correo.	El sistema no permite correos duplicados. Cada empleado debe tener un correo UNICO.

Preguntas frecuentes

P: Puedo tener empleados sin sucursal asignada? R: No. Despues del refactor de sucursales, el campo sucursal_id es OBLIGATORIO. No se puede crear un empleado sin sucursal. Si intentas guardarlo sin elegir sucursal, el sistema te bloqueara.

P: Un empleado puede cambiar de sucursal por si mismo? R: No. Los empleados son FIJOS en su sucursal. Solo el dueno puede mover a un empleado de sucursal editando su ficha y cambiando el valor de sucursal_id. Esto evita que el personal salte entre sucursales y vea datos que no le corresponden.

P: Puedo ver los empleados de todas mis sucursales a la vez? R: Si, siempre que seas el dueno. En el selector superior elige “Todas” y la tabla agrupara a todos los empleados por sucursal (groupedEmployees). Si eres un empleado, solo veras los empleados de tu sucursal asignada.

P: Si creo un empleado desde el selector “Todas”, que sucursal se le asigna? R: Cuando el selector esta en “Todas”, el formulario te pedira elegir manualmente la sucursal. Para evitar errores, te recomendamos preseleccionar la sucursal correcta en el selector ANTES de abrir el formulario, asi el sistema auto-asignara esa sucursal.

P: Puedo tener empleados sin correo electronico? R: No. El correo electronico es OBLIGATORIO porque funciona como nombre de usuario para iniciar sesion. Si un empleado no tiene correo, ayudale a crear uno gratuito en Gmail.

P: Cuantos empleados puedo crear? R: Depende del plan que hayas contratado. El plan basico incluye cierta cantidad de empleados. Para conocer tu limite exacto, ve a la seccion de Facturacion o contacta a soporte.

P: Si desactivo a un empleado, se borra su historial? R: No. Todo el historial de acciones que hizo ese empleado se conserva. Solo se bloquea su acceso al sistema. Puedes reactivarlo cuando quieras y retomara justo donde se quedo.

P: Un empleado puede estar asignado a dos sucursales al mismo tiempo? R: No. Cada empleado pertenece a UNA sucursal de forma fija. Si una persona trabaja en dos sucursales, tienes tres opciones: (a) crear dos cuentas de empleado separadas, una por sucursal; (b) cambiar su sucursal manualmente cada vez que se mueva (solo el dueno); o (c) darle permisos adicionales que le permitan ver datos de su sucursal con accesso limitado a informacion extra.

P: Que diferencia hay entre el rol “Dueno” y el rol “Administrador”? R: El Dueno es la cuenta con la que registraste el negocio. Tiene acceso ABSOLUTO a todo, incluyendo crear/editar empleados, gestionar sucursales y ver “Todas” en el selector. El Administrador tiene acceso a casi todo, pero despues del refactor, la creacion y edicion de empleados y la gestion de sucursales quedaron reservadas para el dueno.

P: Que hace exactamente el composable useManagerBranch? R: Es el mecanismo interno del panel que gestiona la sucursal activa en cada momento. Cuando el dueno cambia el selector de sucursal, useManagerBranch actualiza la sucursal activa y envia el header X-Manager-Branch-Id en cada peticion al servidor para que los datos que se muestran y se crean correspondan a esa sucursal. Los empleados no interactuan con este composable porque su sucursal es fija.

P: Puedo evitar que un empleado vea los precios de compra de los ingredientes? R: Si, configurando los permisos adecuadamente en su rol. Si su rol solo tiene “Ver inventario” (no “Gestionar inventario”), generalmente solo vera cantidades de stock, pero no costos.

Lista de verificacion rapida: Nuevo empleado

Elegir la sucursal en el selector superior ANTES de abrir el formulario.
Nombre completo bien escrito, sin apodos.
Correo electronico unico y correcto (revisar dos veces).
Contrasena temporal anotada en un papel seguro.
Sucursal asignada correctamente (es obligatoria y fija).
Rol adecuado a las funciones del empleado.
Entregar credenciales en persona o por mensaje privado.
Pedir al empleado que inicie sesion y cambie su contrasena el primer dia.
Verificar que el empleado solo vea los datos de SU sucursal.