import sys; sys.path.insert(0, '/tmp/manuales') from manual_lib import * c = [] c += [H1('1. El perfil Administrador'), P('El Administrador (Admon) tiene acceso a toda la operación de recepción y, además, a la gestión de usuarios, la edición y anulación de registros, ' 'los traslados, el módulo de apartamentos con el portal de propietarios, las manillas y los reportes.'), P('Todo el trabajo diario de recepción (check-in, acompañantes, check-out, visitantes, empleados y paquetes) se explica en el ' 'Manual de Recepción. Este manual cubre solo lo propio del Administrador.'), H2('Perfiles del sistema'), *tabla(['Perfil', 'Qué puede hacer'], [ ['Soporte', 'Todo lo del Administrador, más la pantalla de Configuración (nombre de la entidad, logo, SIRE, correo, casilla de manilla).'], ['Administrador (Admon)', 'Toda la operación, usuarios, edición, anulación y traslado, apartamentos y portal de propietarios, reportes.'], ['Funcionario Lobby', 'Operación de recepción: check-in, acompañantes, check-out, visitantes, empleados, paquetes, consultas.'], ['Operador de Garita', 'Registro y salida de empleados y visitantes, y paquetes.'], ['Operador zona común', 'Reservas y control de zonas comunes.'], ], [0.3, 0.7]), caja('Cada perfil ve solo sus opciones de menú, y el sistema lo verifica también en el servidor: aunque alguien conozca la dirección de una página, ' 'si su perfil no tiene permiso recibe "Acceso denegado".', 'nota')] c += [H1('2. Usuarios del sistema'), P('Menú de su nombre (arriba a la derecha) › Usuarios.'), captura('usuarios', 'Listado de usuarios del sistema.'), H2('Crear un usuario'), pasos(['Pulse Nuevo usuario.', 'Diligencie tipo y número de identificación, rol, nombres, apellidos, usuario de ingreso, contraseña, dirección y correo.', 'Indique si el usuario queda Bloqueado (NO para que pueda ingresar).', 'Pulse Crear usuario.']), captura('usuario_nuevo', 'Ventana de nuevo usuario.', 0.5), H2('Editar, bloquear o eliminar'), P('En la columna Acciones: el primer botón edita (datos, rol, contraseña o bloqueo) y el segundo elimina. ' 'Para retirar temporalmente a alguien, prefiera bloquear en lugar de eliminar: se conserva el historial de lo que hizo.'), caja('Las contraseñas se guardan cifradas (bcrypt): nadie, ni siquiera el Administrador, puede verlas. Si un usuario la olvida, asígnele una nueva. ' 'Use contraseñas de al menos 10 caracteres con letras y números, y una distinta por persona.', 'ok'), caja('Solo un usuario Soporte puede crear, editar o eliminar a otro usuario Soporte.', 'nota')] c += [H1('3. Editar, anular y trasladar registros'), H2('Editar un check-in'), P('Menú Edición › Check-in. Elija el registro y pulse Buscar. Puede modificar apartamento, vehículo, parqueo, ocupación y fecha de salida, ' 'y los datos de cada huésped del registro (tipo y número de documento, país, ciudad, nombres, apellidos, salida y observaciones).'), captura('edit_checkin', 'Edición de un registro.'), caja('Por seguridad, la fecha de ingreso no se puede modificar desde ningún perfil.', 'aviso'), H2('Anular un registro'), P('En la edición del registro, o en Check-out, pulse ANULAR y confirme. Un registro anulado deja de contar en ocupación y reportes. ' 'Para habilitarlo de nuevo, pulse el mismo botón y confirme.'), H2('Trasladar de apartamento'), P('En Check-out, con el registro seleccionado, pulse TRASLADO, elija el apartamento de destino y la fecha de salida. ' 'El sistema crea un nuevo número de registro para la estadía trasladada.'), H2('Editar huéspedes, visitantes y empleados'), P('Menú Edición › Huésped(es), Visitantes, Empleados. Permite corregir datos y bloquear personas con una observación puntual.')] c += [H1('4. Apartamentos y portal de propietarios'), P('Menú Edición › Apartamento (o Ingresos › Ingreso de apartamento, que abre el mismo módulo con el formulario de nuevo apartamento).'), captura('apartamentos', 'Módulo de apartamentos.'), P('Arriba verá los indicadores (apartamentos, con acceso al portal, usuarios del portal, sin correo, con token TRA y bloqueados), el buscador, el filtro por torre ' 'y los filtros rápidos Sin usuario, Sin correo, Bloqueados y Sin token TRA.'), H2('Crear o editar un apartamento'), pasos(['Pulse Nuevo apartamento o Editar en la fila.', 'Diligencie número (obligatorio y único), torre, vista, parqueadero, capacidad, habitaciones, adicionales, propietario, tipo de administración, ' 'registro de turismo y su vigencia, bloqueo y observación.', 'Pegue el Token TRA si ya lo tiene (ver la sección 5).', 'Pulse Guardar.']), caja('No se puede eliminar un apartamento con una estadía activa, ni cambiar el número de uno que ya tiene reservas registradas. ' 'Al eliminar un apartamento con usuarios del portal, el sistema pide confirmación y elimina también esos usuarios con sus permisos.', 'aviso'), H2('Eliminar varios apartamentos a la vez'), pasos(['Marque la casilla de cada apartamento, o la casilla del encabezado para seleccionar todos los que muestra el filtro actual ' '(por ejemplo, una torre completa o el resultado de una búsqueda).', 'Pulse Eliminar seleccionados en la barra azul.', 'Revise el resumen: cuántos se eliminarán, cuántos usuarios del portal se perderán y cuáles quedan excluidos por tener estadía activa.', 'Escriba ELIMINAR y pulse Eliminar definitivamente.']), caja('La acción no se puede deshacer y arrastra los usuarios del portal de esos apartamentos con sus permisos. Los apartamentos con estadía activa ' 'nunca se eliminan, y el historial de reservas se conserva. Antes de un borrado grande, pida al Soporte una copia de respaldo de la base de datos.', 'peligro'), H2('Usuarios del portal de propietarios'), P('Botón Usuarios en la fila del apartamento. Cada apartamento puede tener varios usuarios (propietario, administrador del apartamento, autorizado).'), captura('portal_usuarios', 'Usuarios del portal de un apartamento, con sus permisos.'), *vinetas(['Agregar usuario / Editar: nombres, identificación, uno o varios correos separados por punto y coma, rol, observación, bloqueo y notificaciones automáticas.', 'Permisos en el portal: interruptores por módulo (reservas, reportes, circulares, registros, usuarios) y por opción. Si apaga un módulo, sus opciones se desactivan.', 'Cambiar clave: escriba o genere una clave (mínimo 4 caracteres, sin espacios; se recomiendan 8 o más) y, si quiere, envíela por correo.', 'Enviar clave: genera una clave temporal nueva y la envía por correo. La clave anterior deja de funcionar. Si el correo falla, la clave no se cambia.', 'Bloquear / Eliminar: retira el acceso al portal.']), caja('El primer correo del usuario recibe la clave; los demás reciben copia. La clave se guarda en el mismo formato que usa el portal, por lo que el propietario puede ingresar de inmediato.', 'nota'), H2('Importar apartamentos desde Excel'), pasos(['Descargue la Plantilla Excel, o use Exportar para editar los apartamentos actuales.', 'Complete una fila por apartamento. Solo num_apto es obligatorio; las columnas usuario_ crean el acceso al portal.', 'Pulse Importar Excel y elija el archivo (.xlsx o .csv, máximo 5 MB).', 'Revise la vista previa: filas nuevas, actualizaciones y errores explicados por fila. Las filas con error no se guardan.', 'Elija las opciones (actualizar existentes, crear usuarios del portal, enviar clave) y pulse Importar.']), captura('importar', 'Vista previa de una importación.'), caja('Al actualizar apartamentos existentes, una celda vacía no borra el dato actual: solo se cambian las celdas con valor.', 'ok'), H2('Cargar claves del portal desde el Excel'), P('La plantilla incluye la columna usuario_clave, que guarda la clave de acceso al portal en la ficha del usuario:'), *vinetas(['Si el usuario es nuevo, se crea con esa clave.', 'Si el usuario ya existe (mismo correo en ese apartamento), se le actualiza la clave.', 'La clave debe tener al menos 4 caracteres y no puede contener espacios; si no, la fila se marca con error y no se guarda.', 'Con la casilla Enviar clave por correo, se envía exactamente la clave del archivo, no una temporal.', 'La columna nunca se llena al exportar: las claves guardadas no se pueden leer.']), caja('El archivo de Excel queda con las claves escritas en texto plano: guárdelo en un lugar seguro o bórrelo después de importar.', 'aviso')] c += [H2('Bloqueo de zonas comunes'), P('La columna Zonas comunes del listado indica si el apartamento puede reservar zonas comunes (piscina, zonas húmedas y demás áreas). ' 'Con el interruptor en Bloqueadas, ni sus huéspedes ni sus propietarios pueden reservar: la pantalla de reserva muestra un aviso ' 'y deshabilita el formulario, y el sistema rechaza cualquier intento de reserva.'), *vinetas(['Cambie el bloqueo directamente en el listado (pide confirmación al bloquear) o en el formulario del apartamento (campo Bloqueo de zonas comunes).', 'El filtro Zonas bloqueadas muestra los apartamentos bloqueados.', 'En la plantilla de Excel, la columna bloqueo_zona acepta SI o NO.']), caja('Este bloqueo es distinto del campo Bloqueado del apartamento: solo impide la reserva de zonas comunes; el apartamento sigue operando normalmente.', 'nota')] c += [H1('5. Token TRA'), P('La columna Token TRA guarda por apartamento el token de la Tarjeta de Registro Hotelero exigida en Colombia. En el listado solo se ve si está ' 'Configurado o Pendiente; el token nunca se muestra en pantalla.'), captura('apto_editar', 'Formulario del apartamento con el campo Token TRA.'), *vinetas(['Para cargarlo, edite el apartamento y pegue el token. Los espacios y saltos de línea se quitan solos.', 'Para conservar el token guardado, deje el campo vacío al editar.', 'Para quitarlo, marque Borrar el token guardado.', 'También se puede cargar en bloque con la columna token_tra de la plantilla de Excel.', 'El filtro Sin token TRA muestra los apartamentos pendientes.']), caja('Si la columna Token TRA no aparece, la base de datos aún no la tiene: un usuario Soporte la crea en Configuración › Base de datos.', 'nota')] c += [H1('6. Probador de correo'), P('Botón Probador de correo del módulo de apartamentos, o Probar correo en la fila de un apartamento (trae los correos de sus usuarios).'), captura('probador', 'Resultado del probador de correo.'), *tabla(['Revisión', 'Qué indica'], [ ['Formato', 'Que la dirección esté bien escrita.'], ['Dominio', 'Que el dominio del correo tenga servidor de correo (por ejemplo, que gmail.com exista).'], ['Listas SendGrid', 'Si la dirección rebotó antes, fue bloqueada, es inválida o reportó spam. Mientras esté en una lista, SendGrid no le entrega mensajes.'], ['Envío de prueba', '"Aceptado (202)" significa que SendGrid recibió el mensaje para entregarlo, con su identificador. Si el buzón no existe, el rebote aparece en unos minutos.'], ], [0.25, 0.75]), caja('Límite: 20 envíos de prueba cada 10 minutos por sesión. Si un correo está en una lista de supresión, no se le envía la prueba; ' 'el Soporte puede retirarlo de la lista desde la cuenta de SendGrid.', 'nota')] c += [H1('7. Reportes, migración y manillas'), H2('Reportes'), *vinetas(['Reportes › Reporte por apartamento: elija apartamento y rango de fechas, y pulse Buscar.', 'Reporte edificio, estadístico, de registros, de visitas y de empleados.', 'Huésped en casa y Checkout today: quién está alojado y quién sale hoy.']), captura('reporte_apto', 'Filtro del reporte por apartamento.'), H2('Migración (SIRE)'), P('Consultas › Migración y Migración salida generan el archivo para el reporte a Migración Colombia. ' 'Los códigos del establecimiento y de la ciudad los configura el perfil Soporte.'), H2('Manillas'), P('Menú Manillas: crear rangos de manillas, consultar manillas por color o por apartamento y sus reportes. ' 'Si la copropiedad no usa manillas, el Soporte puede ocultar la casilla en todos los formularios; los registros se guardan con manilla 0000.')] c += [H1('8. Buenas prácticas de seguridad'), *vinetas(['Cree un usuario por persona. No comparta usuarios.', 'Bloquee de inmediato a quien deje de trabajar en la copropiedad.', 'Revise periódicamente los usuarios activos y sus perfiles.', 'Cierre la sesión al terminar el turno.', 'Los datos de huéspedes son personales: úselos solo para la operación y el reporte de ley.', 'Ante cualquier comportamiento extraño del sistema, avise al Soporte.']), caja('El sistema bloquea un usuario por 15 minutos tras 5 intentos fallidos de ingreso, y cierra la sesión tras varias horas sin actividad.', 'nota')] construir(sys.argv[1], 'Administrador', 'Perfil Administrador (Admon)', 'Gestión de usuarios, edición, anulación y traslado de registros, apartamentos y portal de propietarios, importación desde Excel, token TRA, probador de correo y reportes.', c) print('ok')