Decoracio Virtual Manager

Que hace Decoracio Virtual Manager

Gestiona el ciclo de vida completo de los archivos de decoracion virtual: desde que un colaborador sube imagenes hasta que se archivan en el historico, con monitorizacion, limpieza y reportes automaticos.

Stack tecnologico

Servicio Windows con webapp Flask, reverse proxy Nginx con HTTPS, autenticacion Azure AD SSO, y conexion a OneDrive via Microsoft Graph API.

Deteccion y copia en tiempo real

La funcionalidad principal del sistema. Detecta subidas de colaboradores externos y las replica automaticamente en la estructura de produccion.

FLUJO SYNC UPLOADS

1. detect_new_uploads()
   Delta Query a /sincronitzacio/UPLOADS
   Busca cambios en carpetas PARA_ENTREGAR con contenido
   Parsea: UPLOADS/{colaborador}/PAISES/{pais}/{proyecto}/PARA_ENTREGAR
   → INSERT INTO pending_projects (attempts=0)

2. process_pending_projects()  [ThreadPoolExecutor, 5 hilos]
   Espera wait_minutes (10 min) desde deteccion
   Para cada proyecto pendiente:
   → merge_copy_folder() PARA_ENTREGAR → IDEALISTA/{pais}/{proyecto}
      Crea carpeta destino si no existe
      Copia archivos con replace si origen es mas reciente
      Preserva archivos solo-destino
   → OK:   INSERT INTO processed_projects (COPIED/OVERWRITTEN)
          send_copy_notification() email con lista de archivos
   → FAIL: attempts++ → retry (max 3) → si agotado: FAILED

3. cleanup_copied_sources()
   Elimina origen de proyectos copiados con >30 dias
   Marca source_deleted=1 en processed_projects

Calidad + Recopilacion

Se ejecutan en cada ciclo del scheduler (~5 min). Mueven archivos de las carpetas de entrada a la estructura de produccion.

Archivado diario + Limpieza

Se ejecutan automaticamente en el dia y hora configurados. Tambien se pueden lanzar on-demand desde el dashboard (solo admins).

Las tareas de archivo usan cross-drive copy: copian de la cuenta de trabajo (decoraciovirtual@) a la cuenta historica (decoraciovirtualhistoric@) via Graph API, resolviendo el drive ID de destino dinamicamente. Tras la copia exitosa, eliminan el origen. Cada ejecucion envia un email de reporte inmediato con estadisticas. El Archivo Produccion desciende a subcarpetas de colaborador (#PRODUCCIO/{colaborador}/{proyecto}) replicando la estructura en destino.

Interfaz de gestion

Accesible via HTTPS con Azure AD SSO. Roles User y Admin. Dark theme responsive.

Cada card de tarea tiene un icono ⚙ que abre un modal de settings inline donde el admin puede cambiar configuracion especifica (intervalos, umbrales, dias, destinatarios email) sin necesidad de acceder al servidor. Los cambios se guardan en app-config.json y el scheduler los recoge en el siguiente ciclo.

6 tipos de email

Todos los emails son HTML con estadisticas visuales. Destinatarios configurables por tipo. SMTP interno sin autenticacion.

Monitorizacion proactiva

Comprueba umbrales cada ciclo del scheduler. Solo alerta por errores definitivos (post-retry). Maximo una alerta por tipo y dia.

Azure AD SSO + Roles

Single Sign-On con Microsoft Entra ID. Dos niveles de acceso basados en roles del App Registration.

FLUJO DE LOGIN

1. Usuario accede a https://decomanager.sys.idealista
2. @login_required redirige a /auth/login
3. MSAL genera authorization URL → redirige a Azure AD
4. Usuario se autentica con credenciales corporativas
5. Azure AD callback a /auth/callback con auth code
6. MSAL adquiere token → extrae id_token_claims
     → name, email, roles[], oid
7. Sesion Flask con expiracion configurable (12h default)

ROLES
  User   → Dashboard, Sync, Monitors, Archivo, Limpieza (solo lectura)
  Admin  → Todo lo anterior + Settings, Ejecutar on-demand, Gear icons

SQLite con WAL + Autocommit

Base de datos ligera, sin servidor. WAL mode para lecturas concurrentes, autocommit para evitar locks entre threads.

Mantenimiento automatico: El scheduler purga registros antiguos periodicamente. Procesados se retienen 30 dias, fallidos 180 dias. Intervalo de purga configurable (default 24h). Migraciones: Auto-migracion al arrancar. Detecta esquema actual y aplica cambios incrementales (v2: status SIMULATED, v3: source_deleted, v4: report_type).

Operaciones OneDrive

Todas las operaciones sobre OneDrive Business se realizan via Microsoft Graph REST API v1.0 con autenticacion por certificado X.509 desde el almacen de Windows.

Servicio Windows con Nginx

Dos servicios Windows (WinSW): uno para la aplicacion Python y otro para Nginx como reverse proxy HTTPS.

ESTRUCTURA DE ARCHIVOS

decoracio-virtual-manager/
├── config/
│   ├── app-config.json          Configuracion runtime
│   └── app-config.example.json  Template
├── db/
│   ├── database.py              Conexion + migraciones
│   └── schema.sql               Esquema DDL
├── services/
│   ├── graph_auth.py            MSAL autenticacion
│   ├── graph_onedrive.py        Graph API operations
│   ├── scheduler.py             Orquestador daemon
│   ├── sync_processor.py        Core sync logic
│   ├── calidad_monitor.py       Monitor imagenes
│   ├── recopilacion_monitor.py  Monitor archivos
│   ├── archive_projects.py      Archivado diario (nested collaborators)
│   ├── archive_recopilacion.py  Archivado recopilacion
│   ├── cleanup_uploads.py       Limpieza UPLOADS
│   ├── s3_sync_processor.py     Deteccion + subida tours 360
│   ├── s3_client.py             Wrapper boto3 con filtro since_dt
│   ├── email_reporter.py        6 tipos de email
│   └── error_alerts.py          Alertas por umbral
├── db/
│   ├── database.py              Conexion + migraciones
│   ├── schema.sql               Esquema DDL
│   └── log_db.py                SQLiteLogHandler + query_logs()
├── logs/
│   ├── dvm.log                  Log rotativo aplicacion
│   └── logs.db                  SQLite logs (separada de la DB principal)
├── webapp/
│   ├── app.py                   Flask factory
│   ├── routes/                  9 blueprints (incl. s3_sync, logs)
│   ├── templates/               12 templates Jinja2
│   └── utils/auth.py            Decorators + helpers (admin_required)
├── run_webapp.py                Entry point
├── requirements.txt             7 dependencias
├── deploy.ps1                   Script de despliegue
├── nginx.conf                   Reverse proxy config
└── *-service.xml                Definiciones WinSW

Todo configurable sin tocar codigo

Un unico archivo app-config.json gobierna todo el comportamiento. Editable desde la web (admins) o directamente en disco. El scheduler recarga cada ciclo.

De PowerShell scripts a plataforma

Lo que empezo como 3 scripts independientes se ha convertido en un servicio completo con interfaz web.