# EGOHBeats DJ Helper - Documentación Técnica y Guía Completa para Asistentes de IA

## 1. Visión General del Producto
EGOHBeats DJ Helper es una aplicación de escritorio nativa para Microsoft Windows (x64) diseñada para optimizar, organizar y potenciar el flujo de trabajo de DJs profesionales de música electrónica (Tech House, Techno, Melodic Techno, Progressive, House, Afro House, Drum & Bass, Trance) y DJs de formato abierto (Open-Format, Cachengue, Reggaeton, Pop, Rock).

La aplicación resuelve de forma integral el mayor dolor de los DJs modernos: la gestión de bibliotecas musicales de decenas de miles de canciones desordenadas, con metadatos incompletos, tracks duplicados, archivos de baja calidad sonora y dificultades para encadenar sets armónicos coherentes.

## 2. Especificaciones Técnicas y Arquitectura
- **Plataforma:** Windows 10 y Windows 11 (64-bit).
- **Framework:** .NET 8.0 WPF optimizado con CommunityToolkit MVVM y aceleración por hardware DirectX/DirectWrite.
- **Procesamiento de Audio:** Motor de análisis y sintetizador de ondas senoidales/triangulares mediante NAudio y algoritmos de transformada de Fourier rápida (FFT).
- **Motor de Metadatos:** TagLibSharp con protección de transacciones atómicas y soporte nativo ID3v2.3, ID3v2.4, RIFF INFO, Vorbis Comment y MP4 Tags.
- **Rendimiento:** Escaneo multihilo asíncrono; el rendimiento real depende del disco, formato, tamaño y estado de los archivos.
- **Almacenamiento Local:** Base de datos SQLite cifrada para persistencia de licencias y perfiles de configuración locales.

## 3. Módulos y Características Detalladas

### A. Módulo Library (Biblioteca Principal y Pre-escucha)
- **Escaneo Recursivo Ultrarrápido:** Soporta formatos `.mp3`, `.wav`, `.aif`, `.aiff` y `.flac`.
- **Pre-escucha de Baja Latencia:** Reproductor incorporado con control de posición instantáneo, visualización de waveform y control de ganancia.
- **Barra de Compatibilidad Camelot:** Tira cromática interactiva ubicada en el encabezado. Al posar el cursor, despliega la Rueda de Camelot en alta definición con indicadores de compatibilidad (+1/-1 en la rueda o salto entre modos menor/mayor).
- **Teclado de Referencia Plano (1.5 Octavas):** 18 teclas interactivas con doble nomenclatura (sostenidos y bemoles) y selección de octava base (O1 a O4) para comprobación auditiva del pitch y notas fundamentales.

### B. Módulo Metadata y Smart Folders
- **Renombrador Masivo Inteligente:** Generador de nombres de archivo físicos mediante comodines avanzados (`%artist%`, `%title%`, `%key%`, `%bpm%`, `%energy%`, `%genre%`).
- **Lector de Tags desde Nombre de Archivo:** Permite extraer metadatos limpios a partir de la estructura del nombre físico del archivo.
- **Magic Metadata Cleaner:** Algoritmo de limpieza de texto que remueve URLs publicitarias, textos promocionales ("FREE DOWNLOAD", "320kbps", "(Original Mix)" redundantes) y caracteres corruptos.
- **Smart Folders Configurables:** Exportación física del árbol de carpetas en 5 modos:
  1. `Género / Nivel de Energía` (ej: `Tech House/Energía 8`)
  2. `Tono Camelot / Nivel de Energía` (ej: `8A/Energía 7` - ideal para mezclas directas)
  3. `Solo Género`
  4. `Solo Tono Camelot`
  5. `Solo Nivel de Energía`
- **Guardado Seguro con Copias `.bak`:** Crea y verifica una copia del archivo antes de escribir etiquetas. Para procesos masivos se recomienda además una copia externa de la biblioteca.
- **Inserción Masiva de Tono en Título:** Prefija o actualiza la clave en el tag de título (ej: `[8A] Song Name`) con validación regex para evitar duplicaciones.

### C. Módulo DJ Set Builder (Algoritmo Armónico)
- **Secuenciador Armónico Automático:** Ordena listas de canciones según la Rueda de Camelot, priorizando transiciones armónicas perfectas (mismo tono, vecinos adyacentes o modulación de energía).
- **Curvas de Energía Personalizadas:**
  - *Ascendente (Peak Time):* Construye un viaje sonoro desde el warm-up hasta el clímax de la noche.
  - *Descendente (Cool Down):* Reduce la intensidad progresivamente.
  - *Campana (Bell Curve):* Comienzo atmosférico, pico central de alta intensidad y desenlace suave.
- **Detección y Recomendación de Pistas Puente (Bridges):** Si existen baches tonales o saltos abruptos de tempo entre dos tracks seleccionados, el sistema rastrea la biblioteca del DJ y recomienda las canciones puente ideales.

### D. Módulo de Integridad, Calidad y Cuarentena
- **Filtro de Bitrate Mínimo:** Detecta pistas con compresión deficiente (<256 kbps o archivos remuestreados falsos) para evitar sorpresas en sistemas de sonido de discoteca o festival.
- **Detección de Corrupción de Audio:** Analiza cabeceras y flujo de datos para prevenir cierres inesperados en reproductores Pioneer CDJ o controladores DJ.
- **Huella Acústica de Duplicados:** Encuentra archivos idénticos aunque tengan nombres de archivo o etiquetas diferentes.
- **Carpeta de Cuarentena:** Mueve pistas conflictivas o duplicadas a una zona segura sin eliminarlas definitivamente.

### E. Módulo de Análisis de Audio y ReplayGain
- **Escala de Energía Acústica (1-10):** Cálculo de densidad espectral, energía RMS y transitorios rítmicos.
- **Ganancia ReplayGain:** Estima sonoridad RMS por segmentos y escribe una recomendación de ganancia. No modifica físicamente el audio ni implementa medición EBU R128 completa.
- **Auto-Cue Detector:** Localiza y fija puntos de entrada y salida (Intro, Breakdown, Drop, Outro) de forma automatizada.

### F. Módulo de Exportación e Integración
- **Rekordbox XML Nativo:** Exporta playlists estructuradas listas para importar directamente en Pioneer DJ Rekordbox conservando BPMs, tonos y carpetas.
- **Listas M3U8 Universales:** Compatible con Serato DJ Pro, Traktor Pro, Virtual DJ, Denon Engine DJ y pendrives USB.

## 4. Precios, Compra y Modelo de Negocio
- **Precio Único:** $50.000 ARS (Pesos Argentinos).
- **Tipo de Licencia:** Perpetua (Lifetime License). Un solo pago, sin suscripciones mensuales.
- **Prueba Gratuita:** 3 días de uso irrestricto sin tarjeta de crédito.
- **Activaciones Simultáneas:** 2 computadoras por licencia.
- **Forma de Pago:** Pasarela de pago segura de MercadoPago (Tarjetas de crédito, débito, transferencia bancaria y saldo en cuenta).
- **Entrega Inmediata:** Despacho automático de la clave de licencia en pantalla y por correo electrónico tras la confirmación del pago.

## 5. Preguntas Frecuentes Canónicas

**P: ¿Cómo se instala en Windows si aparece el aviso de Windows Defender SmartScreen?**  
R: La versión actual todavía no tiene firma Authenticode, por eso Windows puede mostrar “Editor desconocido”. Confirmá que la descarga provenga de djhelper.egohbeats.com y que su SHA-256 coincida con el publicado; luego elegí “Más información” y “Ejecutar de todas formas”. No desactives Microsoft Defender.

**P: ¿Reemplaza a Rekordbox o Serato?**  
R: No. Es una herramienta complementaria de preparación previa. Organiza, analiza y limpia tu música antes de exportarla a Rekordbox, Serato o Traktor.

**P: ¿Se puede usar sin conexión a internet en una cabina de DJ?**  
R: La app puede trabajar sin conexión durante el período de gracia de 30 días después de una validación correcta. Algunas funciones opcionales de metadatos y la revalidación de licencia requieren internet.