RaW Suite: Singularity Core

"Transforming chaos into order. One bit at a time."

Singularity Core Banner

Bienvenido a Singularity Core, la suite definitiva de orquestación y automatización para la gestión de medios P2P. Diseñada originalmente para la comunidad española (EMUWAREZ/MILNU), esta herramienta ha evolucionado hasta convertirse en un ecosistema completo para la normalización, auditoría y distribución masiva de contenido.

🎯 ¿Para qué sirve?

Singularity resuelve el problema de las bibliotecas de medios fragmentadas, corruptas o en formatos obsoletos. Proporciona un pipeline unificado que: 1. Sanea tu biblioteca (ISO -> MKV, Legacy -> MKV). 2. Verifica la integridad forense de cada archivo. 3. Clasifica el contenido por calidad y codec. 4. Distribuye automáticamente a trackers privados (UNIT3D).

🛠️ ¿Cómo usarlo?

La suite está diseñada para ejecutarse principalmente a través de su interfaz TUI (Terminal User Interface).

Docker (Recomendado):

make install
make up
make attach
singularity

Manual:
```
python3 singularity.py
```

Desde el menú principal, puedes acceder a los módulos individuales o lanzar el SINGULARITY MODE (Opción 5) para una automatización total.

🏗️ Arquitectura y Funcionamiento

El sistema se basa en un diseño modular donde cada componente cumple una función específica dentro del ciclo de vida del contenido:

graph TB
    subgraph Core [Singularity Core TUI]
        UI[Menu Interface]
        SM[Singularity Mode Pipeline]
        DM[Dashboard Monitor]
    end

    subgraph MKV [MKVerything - Normalización]
        V4[Verifier 4-Capas]
        RS[Universal Rescuer]
        MM[MakeMKV Engine]
    end

    subgraph RLD [RawLoadrr - Distribución]
        TG[Triage Engine]
        MT[Metadata Injection]
        UL[Auto-Uploader]
    end

    subgraph UNT [UNIT3D Mass-Edition - Curación]
        SC[Scraper/Indexer]
        MU[Mass Updater]
        IR[Image Resurrector]
    end

    Data[(Almacenamiento Local)] --> MKV
    MKV --> |Archivos Limpios| Data
    Data --> TG
    TG --> |Listas de Subida| UL
    UL --> |Torrents| Trackers((Trackers UNIT3D))
    Trackers --> SC
    SC --> MU
    MU --> Trackers

    SM --> MKV
    SM --> RLD
    SM --> UNT

Módulo	Acción	Objetivo
MKVerything	Normalización	Convierte todo a MKV limpio y verificado.
RawLoadrr	Inyección	Sube el contenido a trackers con metadatos perfectos.
UNIT3D Orch	Mantenimiento	Gestiona y actualiza torrents ya existentes en masa.
Singularity Core	Orquestación	El "Cerebro" que conecta todas las fases.

Medidas de Seguridad y Resiliencia

Singularity ha sido construido bajo una filosofía de cero pérdida de datos y resiliencia operativa:

Verificación en 4 Capas: Antes de dar un archivo por "bueno" o eliminar un original, se comprueba su estructura (mkvmerge), sus metadatos (ffprobe), su capacidad de decodificación completa (ffmpeg null-scan) y se compara con el original.
Persistencia de Estado: Todos los módulos utilizan archivos de estado (states/) para saber qué archivos se han procesado. Si el sistema se apaga, resume exactamente donde se quedó.
Aislamiento Docker: Todo el entorno (incluyendo dependencias complejas como makemkvcon y vapoursynth) está encapsulado, evitando conflictos con el sistema host.
Logs Forenses: Cada decisión tomada por el sistema queda registrada en logs/, permitiendo auditorías posteriores si algo no sale como se esperaba.

🧭 Guía de Navegación

Módulo	Descripción
Instalación	Configuración inicial y secretos
Singularity	Pipeline automático completo
Módulos	MKVerything, RawLoadrr, UNIT3D
Mass Editor	Suite de curación y restauración
Dashboard	Monitorización en vivo
Utilidades	Scripts y utilidades auxiliares
Notas	Arquitectura y decisiones técnicas
RawLoadrr	Wiki completa sobre distribución
MKVerything	Wiki completa sobre normalización