Caso de Uso :: Producción Audiovisual (jg_filmmaker & jg_plugin_filmmaker)

"Una arquitectura de software no demuestra su solidez en diagramas conceptuales ni en demostraciones de laboratorio, sino cuando sostiene un flujo transaccional real de negocio con usuarios concurrentes, presupuestos comprometidos, reglas de dominio complejas y tolerancias a fallos de misión crítica."

Repositorio oficial e histórico de auditoría del frontend de gestión:
🔗 GitLab: gitlab.com/javiergalvez-ia/jg_filmmaker

1. El Desafío de Negocio: La Producción Cinematográfica

La industria de la producción audiovisual y cinematográfica representa uno de los entornos operacionales y logísticos más exigentes del sector industrial: cientos de profesionales coordinados en localizaciones remotas, calendarios milimétricos donde cada hora de rodaje cuesta decenas de miles de euros y cadenas de suministro estrictamente acopladas al avance diario del guion.

Films Production Manager (jg_filmmaker) es la implementación de referencia en producción del ecosistema javiergalvez-ia. Demuestra cómo un sistema transaccional de negocio desacoplado consume y explota las capacidades del runtime cognitivo (jg_agente) a través de un plugin especializado (jg_plugin_filmmaker) sin acoplar sus modelos de datos internos ni comprometer su soberanía operativa.

El Pipeline Integral de Producción Audiovisual:

$$\text{Idea / Bruto} \longrightarrow \text{Tratamiento} \longrightarrow \text{Guión Literario} \longrightarrow \text{Planos Técnicos} \longrightarrow \text{Rodaje / Tomas} \longrightarrow \text{Montaje / Pre-corte NLE}$$

2. Topología de Integración con el Ecosistema

La integración entre la aplicación de negocio (jg_filmmaker) y la plataforma de inteligencia artificial se articula mediante una topología distribuida de tres niveles, comunicada mediante protocolos sin estado y firmas criptográficas:

┌────────────────────────────────────────────────────────────────────────┐
│                      jg_filmmaker (Frontend & Core)                    │
│                        (Laravel 12 / Tailwind CSS)                     │
│                                                                        │
│  - Editor de Guion Continuo (Formato Fountain & Acordeón Gutenberg)   │
│  - Stripboard Interactivo con Reglas de Descanso Sindical (12h Turn)  │
│  - Gestión de Personajes, Localizaciones y Desglose de Atrezzo         │
│  - Pipeline NLE: Streaming de Vídeo y Concatenación Continua (FFmpeg)  │
│  - Autenticación Passwordless con OTP efímero en Base de Datos         │
└──────────────────────────────────┬─────────────────────────────────────┘
                                   │
                                   │ Invocación HTTP M2M asíncrona
                                   │ Cabeceras: X-Signature-SHA256, X-Nonce, X-Timestamp
                                   ▼
┌────────────────────────────────────────────────────────────────────────┐
│                      jg_agente (Plano de Ejecución)                    │
│                         (FastAPI / LangGraph)                          │
│                                                                        │
│   ┌────────────────────────────────────────────────────────────────┐   │
│   │                     jg_plugin_filmmaker                        │   │
│   │                 (Desarrollado con jg_agente_sdk)               │   │
│   │                                                                │   │
│   │  - FountainRefinementTool: Diálogo indirecto a réplica canónica│   │
│   │  - ScriptBreakdownTool: Extracción semántica de elementos      │   │
│   │  - ContinuityCheckTool: Auditoría de racord de atrezzo/luz     │   │
│   │  - RoughCutPlannerTool: Selección algorítmica de tomas buenas  │   │
│   └────────────────────────────────────────────────────────────────┘   │
└────────────────────────────────────────────────────────────────────────┘

Características de la Integración Criptográfica:

1. Autenticación Simétrica Sin Estado: Las peticiones desde jg_filmmaker hacia jg_agente se firman con HMAC-SHA256 utilizando una clave compartida de 32 bytes (FILMMAKER_HMAC_SECRET).
2. Defensa Anti-Replay Determinista: Cada solicitud incorpora un identificador único X-Nonce (UUIDv4) y una marca temporal X-Timestamp (ventana de validez estricta de 300 segundos).
3. Firmado Canónico del Payload: La firma se calcula sobre el método HTTP, la ruta solicitada, el timestamp y el hash SHA-256 del cuerpo JSON.

3. Capacidades Específicas del Plugin Audiovisual

El paquete jg_plugin_filmmaker, desarrollado siguiendo las directrices de jg_agente_sdk, encapsula la lógica analítica cinematográfica:

4. Pipeline NLE con FFmpeg y Sincronización Offline

jg_filmmaker procesa material rodado en set mediante workers asíncronos que ejecutan scripts optimizados de FFmpeg:

• Transcodificación a proxies ligeros H.264 para revisión inmediata del director en set.
• Concatenación de tomas seleccionadas por el asistente de IA para generar un premontaje de referencia (rough cut) en minutos tras el corte de claqueta.
• Modo de operación offline con caché local SQLite y sincronización bidireccional cuando se recupera conectividad en el campamento base.