dtic-DIIAA/docs/ambito/dtic-BKPs/A03.P001_Migracion_ADN.md

# Plan: Migración dtic-BKPs a Tools ADN

> **Grupo de Trabajo:** dtic-BKPs (Respaldos de Infraestructura)

**Código:** A03.P001  
**Fecha:** 06 de abril de 2026  
**Autor:** Sistema ADN  
**Versión:** 1.0  
**Estado:** ✅ COMPLETADO  

## 📋 Resumen Ejecutivo

La herramienta `dtic-BKPs v6.0` actualmente reside en el directorio raíz del repositorio (`dtic-BKPs/`) como un sistema independiente con su propio entrypoint (`dtic-BKPs.rb`), configuración YAML, librería interna (`lib/`) y logs propios. Esto contradice el principio de **Armonía Integral** del ADN, donde todas las herramientas deben integrarse bajo `./adn/tools/run <subcomando>`.

Ya existe un intento previo parcial en `adn/tools/cli/backup.rb` (25KB) y `adn/tools/cli/backup/configurador.rb`, pero tiene bugs (el `--help` falla con `undefined local variable or method 'mostrar_ayuda'`).

El objetivo es **completar la migración** integrando la lógica probada de `dtic-BKPs v6.0` en el ecosistema ADN, preservando la configuración YAML y los procesadores funcionales.

## 🎯 Objetivo

Migrar `dtic-BKPs/` completamente a `adn/tools/cli/` para que:
1. Se invoque vía `./adn/tools/run bkps <subcomando>` (consistente con el ecosistema).
2. La configuración YAML se centralice en `adn/tools/config/bkps.yml`.
3. Los procesadores (Proxmox, Xen, Rclone) se integren como módulos ADN.
4. Los logs se unifiquen con el sistema de logging ADN (`adn/tools/core/logger`).
5. El directorio `dtic-BKPs/` raíz quede deprecado y eventualmente archivado.

## 📊 Inventario Actual

### Fuente: `dtic-BKPs/` (a migrar)
| Archivo | Tamaño | Función |
| :--- | :--- | :--- |
| `dtic-BKPs.rb` | 5.6 KB | Entrypoint, dispatcher, menú, auto-screen |
| `dtic-BKPs.yml` | 2.3 KB | Configuración de tareas y comandos |
| `lib/config.rb` | 1.7 KB | Parser de configuración YAML |
| `lib/logger.rb` | 1.7 KB | Logger propio (duplica ADN Logger) |
| `lib/menu.rb` | 5.9 KB | Menú interactivo con auto-avance |
| `lib/proc_proxmox.rb` | 5.0 KB | Procesador de dumps Proxmox |
| `lib/proc_xen.rb` | 2.7 KB | Procesador de backups XenServer |
| `lib/sync_rclone.rb` | 1.5 KB | Sincronización rclone |

### Destino: `adn/tools/cli/` (existente parcial)
| Archivo | Tamaño | Estado |
| :--- | :--- | :--- |
| `backup.rb` | 25.5 KB | ⚠️ Incompleto, `--help` roto |
| `backup/configurador.rb` | 1.2 KB | ⚠️ Solo configurador |

## 📅 Fases de Implementación

### ✅ FASE 1: Auditoría y Diagnóstico (Completada 2026-04-06)
- **1.1:** ✅ Analizado `adn/tools/cli/backup.rb` — 25KB con bugs (`mostrar_ayuda` undefined).
- **1.2:** ✅ Comparado con `dtic-BKPs v6.0` — funcionalidad probada y estable.
- **1.3:** ✅ Dependencias verificadas: rclone ✔, pv ✔, screen ✔.

### ✅ FASE 2: Migración a adn/tools/bkps/ (Completada 2026-04-06)
- **2.1:** ✅ Creado `adn/tools/bkps/bkps.rb` — CLI `SubcomandoBkps` con subcomandos: help, list, run, status, menu.
- **2.2:** ✅ Migrados procesadores a `adn/tools/bkps/lib/` — proc_proxmox.rb, proc_xen.rb, sync_rclone.rb, config.rb, menu.rb.
- **2.3:** ✅ Configuración YAML copiada a `adn/tools/bkps/bkps.yml`.
- **2.4:** ✅ Logger propio reemplazado por ADN Logger nativo.
- **2.5:** ✅ Dispatcher (`adn/tools/run`) actualizado con ruta `'bkps'` → `ADN::SubcomandoBkps`.

### ✅ FASE 3: Auditoría de backup.rb legacy (Completada 2026-04-06)

Análisis de `adn/tools/cli/backup.rb` (659 líneas, 25KB) — funcionalidades **diferentes** a las de dtic-BKPs v6.0:

| Funcionalidad | Descripción | Asimilar? |
| :--- | :--- | :---: |
| `ejecutar_backup(nodo)` | Backup remoto individual vía vzdump+SSH+candados, auto-detección VMID/host desde nodos/*.md | ✅ |
| Bitácora-First integrado | Auto-crear/actualizar evento en DB durante ejecución | ✅ |
| `comando_estados` | Consulta en tiempo real de tareas vzdump en cluster Proxmox vía API JSON | ✅ |
| `comando_sanear` | Saneamiento con retención configurable, exclusiones interactivas, borrado remoto | ✅ |
| `predeterminar` | Persistencia de defaults vía Configurador | ⏳ |
| `auto_reconciliar_bitacora` | Cierre automático de entradas pendientes cruzando con API Proxmox | ✅ |

**Bugs encontrados:** `mostrar_ayuda` mal anidado (fuera de scope private), `end` desbalanceados (L620-658).

### ✅ FASE 4: Asimilación de funcionalidades de backup.rb (Completada 2026-04-06)
- **4.1:** ✅ `bkps backup <nodo>` — backup remoto individual vía vzdump+SSH+candados con auto-detección de VMID/host.
- **4.2:** ✅ `bkps estados` — consulta estado Proxmox en tiempo real vía API JSON.
- **4.3:** ✅ `bkps sanear --dias N` — saneamiento con retención configurable, `--dry-run`, borrado remoto.
- **4.4:** ✅ Auto-cierre de bitácora implementado como tool ADN `dron` (reutilizable para cualquier ámbito).

### ✅ FASE 5: Validación, Documentación y Deprecación (Completada 2026-04-06)
- **5.1:** ✅ Pipeline C4 ejecutado exitosamente vía `./adn/tools/run bkps run C4 --batch` (23 sets, ~26min).
- **5.2:** ✅ Armonía Integral aplicada: ámbito, contexto y plan actualizados.
- **5.3:** ✅ Archivado: `dtic-BKPs/` → `_hist/dtic-BKPs/`, `backup.rb` → `adn/tools/cli/_hist/`.

## 🛠 Estructura Final

```
adn/tools/bkps/                    # Tool principal (A03)
├── bkps.rb                        # CLI (11 subcomandos)
├── bkps.yml                       # Configuración YAML (tareas, retención 3 tiers)
├── cron-bkps.sh                   # Wrapper cron con lockfile + dron
└── lib/
    ├── config.rb                  # Parser YAML
    ├── menu.rb                    # Menú TUI interactivo
    ├── proc_proxmox.rb            # Procesador Proxmox
    ├── proc_xen.rb                # Procesador XEN
    └── sync_rclone.rb             # Sincronización rclone

adn/tools/cli/dron.rb            # Dron de tareas largas (reutilizable)
```

## 📌 Notas
- Pipeline C4 ejecutado exitosamente el 2026-04-06 (23 sets Proxmox, ~26min).
- Tool `dron` creada como herramienta ADN genérica: `./adn/tools/run dron {lanzar|vigilar|estado|limpiar}`.
- Legacy archivado en `_hist/dtic-BKPs/` (standalone) y `adn/tools/cli/_hist/backup.rb` (intento previo).