Encabezado del panel (barra superior)

Ruta: la barra de arriba va en todas las pantallas del panel (/, /pedidos, /ajustes…) Quién la usa: todos los roles que entran al panel — cajero, cocina, gerente, dueño Permiso requerido: ninguno para verla; cada control tiene el suyo (client.view para que el buscador devuelva clientes; el botón Gift Card sólo si el plan incluye tarjetas de regalo) Capturas: docs/manual/screenshots/panel/

Qué es

La franja blanca que corona todas las pantallas del panel. De izquierda a derecha trae el nombre de la organización (Frankie's Sim), el buscador de clientes y pedidos, el botón Gift Card, el botón de modo claro/oscuro, el selector de sede y el avatar de la persona conectada, que es donde está Cerrar sesión. No es el menú lateral (ese lista las pantallas) ni la fila del POS con 🧾 Pedidos, 🔓 Abrir caja y 📋 EOD, que pertenece al POS y sólo se ve ahí.

Cuándo se usa

Todo el tiempo, sin pensarlo: al empezar el turno para confirmar en qué sede se está trabajando, durante el servicio para buscar un pedido por su número o consultar el saldo de una tarjeta de regalo que trae un cliente, y al terminar el turno para cerrar la sesión antes de entregar la estación.

Paso a paso

Confirme la sede en el botón 📍 <nombre de la sede> ▾. En frankies-sim dice Frankie's San Francisco y, al abrirlo, muestra esa única sede con su casilla marcada y deshabilitada: con una sola sede permitida no hay nada que cambiar.
Para buscar, escriba en Buscar cliente…. Con dos letras o más busca clientes por nombre o contacto; con un número (2, #2) busca el pedido de ese número diario y lo lista como «Pedido #2 · 6 sept 2026» con la etiqueta pedido. Presione un resultado: un cliente abre su ficha, un pedido abre la pestaña Compras de ese cliente en la compra correspondiente.
Para consultar una tarjeta de regalo, presione Gift Card, escriba el código en Código de la tarjeta… y presione Buscar (o Enter). Devuelve el código, el estado (Activa, Agotada, Vencida o Anulada), el saldo en grande y la fecha de vencimiento. En frankies-sim no hay tarjetas emitidas, así que cualquier código responde «Tarjeta no encontrada».
Cambie el tema con el botón de la luna: dice Modo oscuro en claro y Modo claro en oscuro. La elección es de ese dispositivo, no de la cuenta: la tablet de la cocina puede quedar en oscuro y la del mostrador en claro.
Al terminar el turno, presione el círculo con su inicial y luego Cerrar sesión. El menú muestra primero su correo, para que confirme con qué cuenta está trabajando antes de salir.

Campos y botones

Campo/Botón	Qué hace	Notas
Nombre de la organización	Rótulo, a la izquierda	Es el nombre del negocio, no el de la sede; no es enlace
Buscar cliente…	Busca clientes (2+ letras) y pedidos (por número diario)	Sólo se dibuja en pantallas anchas (a 820 px de ancho ya no aparece). Busca solo, sin botón, un quinto de segundo después de dejar de escribir
Resultado de cliente	Abre `/clientes/<id>`	Muestra nombre, correo y teléfono
Resultado de pedido	Abre la pestaña Compras del cliente de ese pedido	Lleva la etiqueta pedido. Al cajero le responde «404 · This page could not be found.», porque no puede abrir Clientes
Gift Card	Consulta el saldo de una tarjeta desde cualquier pantalla	Lo ven todos los roles, incluido el cajero, que no puede abrir Tarjetas de regalo. Se oculta en pantallas angostas
Código de la tarjeta… / Buscar	Buscan la tarjeta por su código	Buscar está apagado con el campo vacío; Enter hace lo mismo
Modo oscuro / Modo claro	Cambia el tema de la interfaz	Por dispositivo, no por cuenta; se recuerda en ese navegador
📍 Sede ▾	Muestra y elige la sede activa	Con una sola sede permitida la casilla sale marcada y deshabilitada. Manda en el POS, la caja, el EOD y los reportes
Avatar (círculo con la inicial)	Abre el menú de la cuenta	Su nombre accesible es el correo de la sesión
Cerrar sesión	Sale del panel y vuelve al login	Úselo al entregar una estación compartida. No hay aviso previo ni confirmación

Mensajes y errores

Ningún control del encabezado usa códigos NG_*.

"Sin resultados." — el buscador no encontró nada. Es también lo que ve un rol sin client.view aunque el cliente exista: en la simulación el cajero busca «ana» y recibe este texto con Ana Web cargada.

"Buscando…" — mientras la consulta está en curso.

"Ingresa un código" — se presionó Buscar de Gift Card sin escribir nada.

"Tarjeta no encontrada" — el código no corresponde a ninguna tarjeta.

"404 · This page could not be found." — la página a la que lleva el resultado del buscador cuando el rol no puede abrirla.

Lo que el encabezado no hace: no avisa de nada. No hay campana de notificaciones, no muestra el estado de la caja (eso está en el Panel de control y en el POS) y no dice qué permisos tiene su rol. Tampoco tiene ayuda ni acceso a soporte. Y no cambia de cuenta: para trabajar con otra persona hay que Cerrar sesión y volver a entrar.