85 lines
6.0 KiB
Markdown
85 lines
6.0 KiB
Markdown
# 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:
|
|
|
|
1. **Apuntar y conectar con el servidor central de backup** (URL del servidor + Código de registro con test de latencia).
|
|
2. **Elegir carpetas de backup locales visualmente** mediante el explorador de Windows (`QFileDialog`), estableciendo filtros (`*.bak`, `*.mdf`), frecuencia y estabilidad de archivos.
|
|
3. **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
|
|
|
|
```text
|
|
┌────────────────────────────────────────────────────────────────────────┐
|
|
│ 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.
|
|
- **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:8000` o `https://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 ID` y 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`](file:///c:/Workspaces/onever_drive/windows-agent/dist/OnEverDriveAgent-Standalone.exe)
|
|
- **Carpeta de Distribución:**
|
|
[`windows-agent/dist/OnEverDriveAgent/OnEverDriveAgent.exe`](file:///c:/Workspaces/onever_drive/windows-agent/dist/OnEverDriveAgent/OnEverDriveAgent.exe)
|
|
- **Lanzador rápido con doble clic:**
|
|
[`windows-agent/start_tray_agent.bat`](file:///c:/Workspaces/onever_drive/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.
|