Initial commit: CloudRestoreAS v1.0.0 - Aplicación completa de restauración automática SQL Server

2026-01-25 16:53:00 -07:00
commit 854ffa116f
43 changed files with 6357 additions and 0 deletions
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -0,0 +1,123 @@
+# CloudRestoreAS - Guía Rápida de Inicio
+
+## Instalación Express (5 minutos)
+
+### 1. Pre-requisitos
+```powershell
+# Verifica Python 3.11+
+python --version
+
+# Verifica ODBC Driver
+Get-OdbcDriver | Where-Object {$_.Name -like "*SQL Server*"}
+```
+
+### 2. Instala y Ejecuta
+```powershell
+# Ejecuta el script de instalación
+.\install.ps1
+
+# Ejecuta la aplicación
+.\venv\Scripts\python.exe runner.py
+```
+
+### 3. Configuración Básica (en la aplicación)
+
+1. **Tab Configuración**:
+   - Carpeta Entrada: `C:\Backups\Entrada`
+   - Carpeta Procesados: `C:\Backups\Procesados`
+   - Carpeta Fallados: `C:\Backups\Fallados`
+   - Carpeta Extracción: `C:\Temp\CloudRestore`
+   - Carpeta Data SQL: `C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA`
+   - 7-Zip: Click "Detectar"
+   - SQL Server: `localhost` (Windows Auth)
+   - Click "Guardar Configuración"
+
+2. **Tab Nodos** (ejemplo):
+   ```
+   Nuevo Nodo:
+   - Nombre: BACKUP_VENTAS.ZIP
+   - DB: Ventas_DB
+   - Activo: ✓
+   ```
+
+3. **Menú Motor → Iniciar**
+
+4. **Prueba**: Copia `BACKUP_VENTAS.ZIP` a la carpeta de entrada
+
+## Flujo Típico
+
+```
+📁 Carpeta Entrada
+   └── BACKUP_VENTAS.ZIP    ← Copias el archivo aquí
+
+↓ (10 segundos - verificación de estabilidad)
+
+🔄 Procesamiento Automático
+   1. ✓ Detectar archivo estable
+   2. ✓ Mapear BACKUP_VENTAS.ZIP → Ventas_DB
+   3. ✓ Extraer .bak con 7-Zip
+   4. ✓ Obtener estructura lógica (FILELISTONLY)
+   5. ✓ Restaurar Ventas_DB (REPLACE)
+   6. ✓ Limpiar archivos temporales
+
+↓
+
+📁 Carpeta Procesados/2026-01-25
+   └── BACKUP_VENTAS.ZIP    ← Movido automáticamente
+
+✅ Job Completado (ver Dashboard/Jobs)
+```
+
+## Comandos Útiles
+
+```powershell
+# Ejecutar aplicación
+.\venv\Scripts\python.exe runner.py
+
+# Verificar instalación
+.\venv\Scripts\python.exe test_installation.py
+
+# Generar ejecutable
+.\build.ps1
+
+# Ver logs en tiempo real
+Get-Content .\logs\app.log -Wait -Tail 50
+```
+
+## Estructura de Directorios Recomendada
+
+```
+C:\CloudRestore\
+├── Entrada\           ← ZIP entrantes
+├── Procesados\        ← ZIP exitosos (por fecha)
+│   ├── 2026-01-25\
+│   └── 2026-01-26\
+├── Fallados\          ← ZIP que fallaron
+└── Temp\             ← Extracción temporal
+```
+
+## Troubleshooting Express
+
+| Problema | Solución |
+|----------|----------|
+| Archivo no se procesa | Espera 10s o click "Escanear Ahora" |
+| NODE_NOT_MAPPED | Crea el nodo exacto en Tab Nodos |
+| Error SQL | Verifica permisos y conexión en Tab Config |
+| 7-Zip falla | Verifica que el ZIP no esté corrupto |
+
+## Monitoreo
+
+- **Dashboard**: Contadores en tiempo real
+- **Jobs**: Historial y detalles
+- **Logs**: Eventos del sistema
+
+## Para Ejecutar 24/7
+
+1. Inicia la aplicación
+2. Menú Motor → Iniciar
+3. Minimiza (se va a la bandeja del sistema)
+4. La app continuará monitoreando en segundo plano
+
+---
+
+**Tip**: Lee el [README.md](README.md) completo para configuración avanzada.