6.0 KiB
6.0 KiB
OnEver Drive — Manual del Agente Windows (PyQt6 & System Tray)
1. Visión General
El Agente de Windows de OnEver Drive es una aplicación de escritorio nativa moderna desarrollada en PyQt6, empaquetada como ejecutable .exe y diseñada para ejecutarse silenciosamente en el Área de Notificaciones (System Tray) de Windows con interfaz gráfica completa para:
- Apuntar y conectar con el servidor central de backup (URL del servidor + Código de registro con test de latencia).
- Elegir carpetas de backup locales visualmente mediante el explorador de Windows (
QFileDialog), estableciendo filtros (*.bak,*.mdf), frecuencia y estabilidad de archivos. - Monitorear transferencias por bloques (chunks de 4 MB) en tiempo real con barras de progreso, cálculo de hash SHA-256 y notificaciones nativas de Windows.
2. Interfaz Gráfica PyQt6
┌────────────────────────────────────────────────────────────────────────┐
│ OnEver Drive — Agente de Backup Windows ● Conectado │
├────────────────────────────────────────────────────────────────────────┤
│ [Dashboard] [Carpetas de Backup] [Servidor & Config] [Historial] │
├────────────────────────────────────────────────────────────────────────┤
│ │
│ Transferencia en Vivo (Motor de Chunks) │
│ Subiendo database_production.bak... │
│ [████████████████████████████░░░░░░░░] 68.4% (17 / 25 Chunks) │
│ Chunks: 17/25 | Velocidad: 42.1 MB/s | SHA-256: e3b0c44298fc... │
│ │
│ Información del Dispositivo │
│ • Cliente ID: CLIENT-0001 (Servidor SQL Producción) │
│ • Servidor Proxmox: https://backup.midominio.com │
│ • Carpetas en Monitoreo: 3 carpetas locales │
│ │
│ [ ▶ Iniciar Sincronización Manual Ahora ] │
└────────────────────────────────────────────────────────────────────────┘
3. Pestañas y Funcionalidades
📁 Pestaña 1: Carpetas de Backup (Selector Visual)
Permite gestionar las carpetas de Windows que el agente respaldará automáticamente:
- Añadir Carpeta...: Abre el selector visual de Windows para elegir la carpeta deseada (ej.
C:\SQLBackups,D:\DatosEmpresa). - Configuración de la Carpeta:
- Filtros de Archivo:
*.bak,*.mdf(o*.*). - Frecuencia de Sondeo: Intervalo en minutos (ej. cada 60 min).
- Estabilidad de Archivo (Locks): Ventana de seguridad en segundos (ej. 60s) para garantizar que SQL Server finalizó el volcado antes de iniciar la transferencia por bloques.
- Filtros de Archivo:
- Respaldar / Eliminar: Botones dedicados para iniciar un respaldo inmediato de la carpeta o eliminarla del monitoreo.
🌐 Pestaña 2: Servidor & Configuración
- URL Servidor: Ingrese la dirección del servidor Proxmox VE (ej.
http://192.168.1.100:8000ohttps://backup.midominio.com). - Probar Conexión: Comprueba la conectividad de red con el backend y muestra la latencia en milisegundos.
- Código de Registro: Ingrese el código de un solo uso generado en el Dashboard Web (
OED-XXXX-XXXX). - Registrar Dispositivo: Vincula criptográficamente la máquina Windows generando un
Device IDy token secreto único. - Preferencias de Notificaciones (No Invasivas):
[x] Habilitar notificaciones en el Área de Notificaciones (System Tray)[x] Notificar únicamente cuando INICIA un proceso de respaldo[x] Notificar únicamente cuando FINALIZA con éxito (Confirmación SHA-256)[x] Notificar en caso de error o pérdida de conexión(Las actualizaciones de progreso intermedias se visualizan de manera silenciosa en la barra de la interfaz sin emitir globos emergentes).
📊 Pestaña 3: Dashboard & Telemetría
- Medidor en tiempo real del progreso de subida por bloques.
- Notificaciones de confirmación de integridad SHA-256 tras cada ensamblado.
📜 Pestaña 4: Historial de Archivos
- Registro histórico de todos los archivos respaldados localmente con su tamaño, fecha y checksum SHA-256.
4. Ejecutables Disponibles
Los ejecutables listos para su distribución se ubican en:
- Standalone Portable (Un solo archivo):
windows-agent/dist/OnEverDriveAgent-Standalone.exe - Carpeta de Distribución:
windows-agent/dist/OnEverDriveAgent/OnEverDriveAgent.exe - Lanzador rápido con doble clic:
windows-agent/start_tray_agent.bat
5. Comportamiento en la Bandeja del Sistema (System Tray)
- Al cerrar la ventana principal (botón
X), la aplicación se minimiza al área de notificaciones junto al reloj sin interrumpir las transferencias programadas. - Al hacer doble clic o clic derecho en el icono de OnEver Drive en el System Tray, se abre instantáneamente el panel de control.