onever_drive/docs/roadmap_karens_replicator.md

Hoja de Ruta: Hacia un "Karen's Replicator" Centralizado y Web

Este documento establece la visión técnica y el plan de desarrollo para evolucionar OnEver Drive desde su arquitectura actual hasta convertirse en un clon moderno, centralizado y gestionado vía web del clásico Karen's Replicator, conservando su robustez y simplicidad de copia pero con las ventajas del almacenamiento en la nube y el monitoreo multi-inquilino.

---

🎯 Tabla de Equivalencia de Características

Característica de Karen's Replicator	Estado Actual en OnEver Drive	Meta de Desarrollo / Brecha a Cubrir
Copia de Archivos y Carpetas	Soportado (Monitoreo de directorios)	Soportado.
Filtros por Patrón de Archivo	Soportado (Solo inclusiones, ej: *.bak)	Añadir Patrones de Exclusión (ej: ignorar *.tmp, thumbs.db, carpetas node_modules).
Copia de Archivos Especiales	Copia todo lo legible	Opción de omitir archivos de Sistema, Ocultos o de Solo Lectura.
Modo Réplica (Mirroring)	Solo incremental (No elimina en destino)	Agregar la opción "Eliminar archivos en destino si ya no existen en origen" (Sincronización exacta).
Detección de Cambios Inteligente	Basada en SHA-256 (Chunks)	Soportado y superior a Karen's (evita transferencias duplicadas de bloques de 4MB).
Planificación Detallada	Simplificada (hourly, daily, etc.)	Planificaciones calendarizadas complejas (ej. "Lunes a Viernes a las 22:00", "Sábados a las 14:00").
Historial y Reportes	logs generales de eventos	Reporte de Ejecución por Job (Web): Lista detallada de archivos copiados, omitidos por no tener cambios y errores de lectura.
Destino de Red / NAS / Local	Solo al servidor centralizado	Configurar en el Servidor almacenamiento en NAS montado, y en el cliente opción de duplicar la copia a un disco local USB o ruta UNC de red (Copia local adicional).

---

📅 Plan de Desarrollo por Fases

Fase 1: Filtros de Exclusión y Atributos de Archivo (Corto Plazo)

• Objetivo: Aumentar la granularidad sobre qué archivos se respaldan.
• Acciones:
  1. Modificar el modelo de BackupJob en la base de datos para añadir exclude_patterns (cadena de exclusiones separadas por comas).
  2. Actualizar el motor de escaneo del cliente DirectoryScanner en agent/scanner.py para ignorar los archivos que coincidan con las exclusiones.
  3. Agregar checkboxes en el cliente y en la Web para:
     • Omitir archivos ocultos (Hidden).
     • Omitir archivos de sistema (System).
     • Conservar/Ignorar permisos de solo lectura.

Fase 2: Modo Réplica Exacta (Mirror / Purge)

• Objetivo: Mantener el destino idéntico al origen (eliminación de huérfanos).
• Acciones:
  1. Añadir el flag sync_deletions (Booleano) a los trabajos de backup.
  2. Implementar en el cliente la detección de archivos eliminados localmente.
  3. Enviar una llamada de purga al backend (POST /api/backups/purge-orphans) para que marque como inactivos o elimine físicamente del almacenamiento del servidor los archivos que ya no existen en el cliente físico.

Fase 3: Planificación Calendarizada Avanzada (Calendar Events)

• Objetivo: Permitir configurar ventanas de mantenimiento específicas como lo hace Proxmox/Systemd/Karen's.
• Acciones:
  1. Expandir el soporte de strings de planificación para comprender formato de eventos calendario (ej. mon..fri 22:00, sat 18:00).
  2. Implementar un parseador de eventos en el Agente de Windows que evalúe si la hora actual está dentro de la ventana de ejecución programada.
  3. Mejorar la interfaz web con un constructor visual de planificaciones semanales/diarias.

Fase 4: Reportes de Ejecución y Auditoría Visual (Dashboard)

• Objetivo: Ver en un clic qué se copió, qué falló y qué se omitió en cada corrida de backup.
• Acciones:
  1. Crear la tabla job_runs en la base de datos para registrar cada sesión de ejecución.
  2. Almacenar métricas detalladas por ejecución:
     • Archivos totales escaneados.
     • Archivos copiados (nuevos/modificados).
     • Archivos omitidos (sin cambios).
     • Errores de lectura (archivos bloqueados sin acceso).
  3. Crear una vista en la web de "Historial de Ejecuciones" interactiva para cada cliente y trabajo.

Fase 5: Copia Local Duplicada (Paridad Completa)

• Objetivo: Permitir que el agente realice copias locales (ej. a un disco externo USB o carpeta compartida de red de la oficina) de forma simultánea a la subida al servidor central.
• Acciones:
  1. Añadir el campo opcional local_destination_path en la configuración de los trabajos.
  2. Al ejecutar un backup, el Agente realiza un mirroring local (estilo Karen's clásico directo de disco a disco) además de la subida segmentada de chunks al servidor cloud.