import sys; sys.path.insert(0, '/tmp/manuales')
from manual_lib import *
c = []
# 1
c += [H1('1. Bienvenida'),
P('Este manual explica el trabajo diario en recepción con Huésped Manager PMS: el ingreso de huéspedes (check-in), los acompañantes, '
'la salida (check-out), los visitantes, los empleados y los paquetes. Está pensado para el perfil Funcionario Lobby; '
'el perfil Operador de Garita encontrará lo suyo en las secciones de visitantes, empleados y paquetes.'),
P('Las pantallas muestran los datos de su copropiedad. Los nombres, apartamentos y fechas de las imágenes son de ejemplo.'),
caja('Algunas opciones solo aparecen para el Administrador (por ejemplo anular un registro o trasladarlo de apartamento). '
'Si no ve una opción que este manual menciona, es porque su perfil no la tiene habilitada.', 'nota')]
# 2
c += [H1('2. Ingreso y salida del sistema'),
H2('Iniciar sesión'),
pasos(['Abra la dirección del sistema en el navegador (Chrome, Edge o Firefox actualizados).',
'Escriba su usuario y su contraseña y pulse Acceder.',
'El sistema abre el Panel de recepción.']),
captura('login', 'Pantalla de ingreso.', 0.78),
caja('Después de 5 intentos fallidos en 15 minutos el usuario queda bloqueado por 15 minutos, aunque luego escriba la clave correcta. '
'Espere o pida ayuda al Administrador. Nunca comparta su contraseña: cada acción queda registrada con su usuario.', 'aviso'),
H2('Cerrar sesión'),
P('Abra el menú de su nombre (arriba a la derecha) y elija Salir. Cierre siempre la sesión al terminar el turno o al dejar el equipo. '
'Si deja la sesión abierta sin actividad por varias horas (4 horas por defecto), el sistema la cierra solo y le pedirá ingresar de nuevo.')]
# 3
c += [H1('3. La pantalla principal'),
P('Todas las páginas comparten la misma barra superior y el mismo menú horizontal:'),
*vinetas(['Barra superior: nombre de la copropiedad, fecha y hora, y el menú de su usuario (Mi perfil, Minuta digital, Manual, Salir).',
'Menú horizontal: Manillas, Ingresos, Salidas, Edición, Consultas, Registros, Reportes, Parqueadero y Reservas. '
'Cada opción despliega sus submenús al pasar el mouse o al hacer clic.']),
captura('menu_ingresos', 'Menú Ingresos desplegado.'),
H2('Panel de recepción'),
P('Es la página de inicio. Resume la operación del día:'),
*vinetas(['Indicadores: apartamentos ocupados y disponibles, llegadas y salidas de hoy, y huéspedes en casa.',
'Estado de apartamentos: una tarjeta por apartamento, Ocupado (coral) o '
'Disponible (verde), con el número de huéspedes y la fecha de salida. Elija la torre, filtre por estado '
'o escriba en el buscador un apartamento o un nombre. Un clic en un apartamento ocupado abre su check-out; en uno disponible, el check-in.',
'Llegadas pendientes: reservas en línea que llegan hoy. El enlace Verificar reservas lleva a la lista para hacer su check-in.',
'Salidas pendientes: estadías que salen hoy o que ya vencieron (en rojo), con acceso directo al check-out.',
'Calendario de reservas: dos semanas por apartamento: en casa, llega hoy, sale hoy o vencida, confirmada y finalizada.',
'Accesos rápidos: Paquete, Ingreso de invitado, Check-out y Nuevo check-in.']),
captura('dashboard', 'Panel de recepción.'),
captura('calendario', 'Calendario de reservas del panel.')]
# 4
c += [H1('4. Check-in (ingreso de huéspedes)'),
P('Menú Ingresos › CHECK-IN o el botón Nuevo check-in del panel.'),
H2('Datos del registro'),
pasos(['Elija el Apartamento. Si está ocupado, el sistema lo avisa.',
'Indique la Ocupación (Huésped, Propietario o Familiar) y la cantidad de Huésped(es).',
'Marque si llegan con Vehículo y escriba las placas separadas por coma.',
'Escriba las Noches: la fecha de Salida se calcula sola. Revise la fecha y la hora de ingreso.',
'Pulse Checkin. El sistema crea un número de registro (folio) único que identifica esta estadía en todo el sistema.']),
captura('checkin', 'Formulario de check-in.'),
caja('Para el tipo de ocupación Huésped existe un límite según la capacidad del apartamento. Para propietarios y familiares no aplica.', 'nota'),
H2('Datos del huésped titular'),
P('Al confirmar el registro se abre la ventana Datos de usuario titular. Al escribir la identificación, el sistema busca al huésped '
'y completa sus datos si ya estuvo antes.'),
*tabla(['Campo', 'Cómo diligenciarlo'], [
['Tipo ID', 'CC (cédula), CC nuevo formato, CE (cédula de extranjería), PA (pasaporte), TI (tarjeta de identidad), CD (carné diplomático), DE (documento extranjero) o RC (registro civil).'],
['Identificación', 'Número del documento, sin puntos ni espacios. Es único en el sistema.'],
['Apellidos y nombres', 'Primer apellido y primer nombre son obligatorios.'],
['Género', 'M (masculino) o F (femenino).'],
['Fecha de nacimiento', 'Formato ddmmaaaa, sin puntos ni barras. Ejemplo: 28041989 = 28 de abril de 1989.'],
['País y ciudades', 'País, ciudad de residencia y ciudad de procedencia (exigidos para migración).'],
['Contacto', 'Dirección, celular, correo y contactos de emergencia.'],
['Manilla (#M)', 'Número de la manilla entregada. Si la copropiedad no usa manillas, esta casilla no aparece.'],
['Fotografía', 'Botón Cámara: tome la foto del huésped.'],
], [0.27, 0.73]),
captura('checkin_titular', 'Ventana de datos del huésped titular.'),
caja('Tome siempre la fotografía y verifique el documento físico. No solicite RH ni otros datos que el escáner de cédulas ya trae.', 'ok')]
# 5
c += [H1('5. Acompañantes (Adicionar)'),
P('Menú Ingresos › Adicionar Huésped. Sirve para agregar huéspedes a un registro que ya existe.'),
pasos(['Elija el Apartamento (registro) en la lista.',
'Revise Datos del registro y Huéspedes registrados, con el resumen de total de huéspedes, menores de 2 años y ocupación de adultos.',
'Pulse + Huésped para agregar una fila por cada acompañante y diligencie sus datos.',
'Pulse Guardar. Limpiar vacía los campos; Borrar campos quita las filas agregadas.']),
captura('adicionar', 'Adicionar acompañantes a un registro.'),
caja('Tenga en cuenta la cantidad de huéspedes declarada en el check-in y la capacidad del apartamento.', 'aviso')]
# 6
c += [H1('6. Check-out (salida)'),
P('Menú Salidas › CHECK-OUT, o desde el panel: Salidas pendientes › Check-out o un clic en un apartamento ocupado.'),
pasos(['Elija el Apartamento (registro) y pulse Buscar.',
'Revise los datos del registro y la lista de huéspedes.',
'Use OBS para dejar observaciones de la salida.',
'Pulse CHECKOUT para la salida del registro completo, o el botón de salida de cada huésped si salen en momentos distintos.',
'Confirme en la ventana de aviso.']),
captura('checkout', 'Check-out de un registro.'),
captura('alerta', 'Confirmación antes de una acción importante.', 0.62),
caja('Las salidas vencidas (fecha de salida anterior a hoy) aparecen en rojo en el panel: regístrelas cuanto antes para que el apartamento vuelva a estar disponible.', 'aviso')]
# 7
c += [H1('7. Visitantes'),
H2('Ingreso de un visitante'),
pasos(['Menú Ingresos › Ingreso de Invitados o el botón Ingreso de invitado del panel.',
'Elija el Apartamento y pulse Buscar. Verá los ocupantes del registro para confirmar la visita.',
'Diligencie los datos del visitante (y la manilla, si aplica) y pulse Ingresar visita.']),
captura('visitante', 'Selección del apartamento para el ingreso de un visitante.'),
H2('Salida de un visitante'),
P('Menú Salidas › Salida de visitantes. Ubique al visitante y use el primer botón de Acciones. '
'Registre la salida a tiempo: el sistema lleva el control de quién está dentro de la copropiedad.')]
# 8
c += [H1('8. Empleados y paquetes'),
H2('Empleados (personal de servicio)'),
P('Menú Ingresos › Ingreso de empleados: elija el apartamento, diligencie los datos, seleccione la actividad y pulse Ingresar. '
'Para la salida: Salidas › Salida de empleados; el primer botón registra la salida y el segundo muestra o toma la fotografía.'),
H2('Paquetes y mensajería'),
P('Botón Paquete del panel (o el menú de Ingresos de Garita): registre el paquete con su apartamento. Si el apartamento tiene correo '
'registrado, el propietario recibe la notificación. Consulte los paquetes pendientes en Consultas › Consultar paquetes y registre la entrega.')]
# 9
c += [H1('9. Reservas y consultas'),
*vinetas(['Reservas › Verificar reserva: reservas hechas por los propietarios en el portal. Desde allí se realiza el check-in de quienes llegan.',
'Consultas › General: listado de apartamentos, huéspedes, visitantes y otros datos, con buscador.',
'Consultas › Reporte de ocupación y Ocupación actual por torres.',
'Reportes › Huésped en casa: quién está alojado hoy.']),
caja('Las tablas largas se pueden desplazar hacia los lados dentro de su recuadro. En pantallas pequeñas, deslice la tabla con el dedo o con la rueda del mouse + Shift.', 'nota')]
# 10
c += [H1('10. Mensajes frecuentes y qué hacer'),
*tabla(['Mensaje o situación', 'Qué significa y qué hacer'], [
['La página vuelve a la pantalla de ingreso', 'La sesión expiró por inactividad. Ingrese de nuevo.'],
['"Recargue la página e intente de nuevo"', 'La página llevaba mucho tiempo abierta o se inició sesión en otra pestaña. Recargue (F5) y repita la acción.'],
['"Acceso denegado"', 'Su perfil no tiene permiso para esa opción. Si la necesita, consulte al Administrador.'],
['Demasiados intentos fallidos', 'Espere 15 minutos o pida al Administrador que revise su usuario.'],
['El apartamento aparece ocupado', 'Ya tiene un registro activo. Verifique en el panel o en Check-out antes de crear otro.'],
['Manilla 0000', 'Registro sin manilla: la copropiedad no usa manillas o es una excepción (por ejemplo, menores).'],
['No aparece una opción del manual', 'Su perfil no la tiene habilitada.'],
], [0.36, 0.64])]
# 11
c += [H1('11. Glosario'),
*tabla(['Término', 'Significado'], [
['Registro / folio', 'Número único de cada estadía. Agrupa al titular y sus acompañantes.'],
['Check-in', 'Ingreso del registro y de sus huéspedes.'],
['Check-out', 'Salida del registro o de un huésped.'],
['Titular', 'Primer huésped del registro.'],
['Acompañante', 'Huésped agregado a un registro existente.'],
['Ocupación', 'Huésped, propietario o familiar.'],
['Manilla (#M)', 'Brazalete de identificación entregado al huésped o visitante.'],
['Salida vencida', 'Estadía cuya fecha de salida ya pasó sin registrar el check-out.'],
], [0.3, 0.7])]
construir(sys.argv[1], 'Recepción', 'Perfil Funcionario Lobby y Operador de Garita',
'Guía del trabajo diario en recepción: panel de recepción, check-in, acompañantes, check-out, visitantes, empleados, paquetes y consultas.', c)
print('ok')