# Documentación técnica de Vantemio

Edición 0.14 · 7 de octubre de 2026 · Arquitectura, estados y aceptación

## 1. Alcance y estados

Este documento define arquitectura, contratos obligatorios y aceptación. Los apartados 2–11 fijan el estándar de desarrollo; los resultados de comprobación acreditan su ejecución.

| Estado | Significado |
|---|---|
| Actual | Función conectada dentro del alcance indicado |
| Componente existente | Parte del sistema; aceptación completa por separado |
| Requisito de aceptación | Conducta que necesita escenario y evidencia |
| Plan o investigación | No declarada disponible en producción |

El YouTube oficial está conectado, incluida publicación automatizada. Scopes actuales, IDs externos y resultados reconciliados deben figurar en el paquete de aceptación. La publicación pública multiusuario se desarrolla aparte.

## 2. Núcleo Station

Station controla admisión, colas, memoria, registros, grafo técnico y contabilidad de producción. Clientes y nodos ejecutan tareas limitadas; conservar historia no les convierte en controladores independientes.

Se amplían mecanismos existentes conservando identidades originales e historial. Una transferencia de autoridad exige reconciliar procesos, asignaciones y resultados. Reiniciar no equivale a reconciliar.

El registro admite expansión sin límite fijo de máquinas. Exige comprobación de identidad estable, capacidades y recursos, prevención de colisiones y reutilización de la identidad original de registro tras interrupción. Se consideran presupuestos y asignaciones pendientes; un heartbeat vencido no las libera. Consultar el registro paginado no inicia ejecutores.

## 3. Módulos y contratos

| Módulo | Entrada | Salida | Estado |
|---|---|---|---|
| Studio | Encargo, fuentes, estilo y límites | Versión e informe | Componentes existentes, integración continua |
| Social | Versión aceptada, canal y ajustes autorizados | Estado y análisis | YouTube conectado; ampliación en desarrollo |
| Marketing | Creatividad aceptada y presupuesto | Campaña y gasto | Plan |
| CRM | Contactos y eventos permitidos | Consultas, operaciones y relación con tareas | Plan |
| Market / Donations | Acciones comerciales y pagos acordados | Resultado verificable | Desarrollo o plan; sin lanzamiento público declarado |

Contrato mínimo propuesto: `task_id`, `operation_id`, `input_version`, `output_version`, `executor_id`, `status`, `started_at`, `completed_at`, `cost_record`, `evidence_ref`. Son requisitos, no nombres confirmados de la base actual. Se mapean al esquema existente sin crear otro registro paralelo.

## 4. Producción y audio

Studio enlaza investigación, guion, dirección, fuentes, gráficos, edición, audio y revisión. Se describen Remotion, Blender, FFmpeg y Vidra/MLT. La escena relaciona acción, intervalo, imagen, voz y sonido; una corrección conserva vínculos y crea una versión.

| Función | Componente descrito | Alcance de la afirmación |
|---|---|---|
| Voz | Qwen3-TTS 1.7B Base | Resultados descritos; pesos exactos por registrar |
| Habla e intervalos | Whisper large-v3-turbo, Silero VAD | Reconocimiento y análisis descritos |
| Semántica y eventos | LAION CLAP HTSAT, AST AudioSet, PANNs Cnn14 | Diagnóstico, no garantía artística |
| Procesamiento y mezcla | FFmpeg EQ, compresión y ducking | Ruta programática descrita |
| Sonido de movimiento | Vantemio Sound Recipes | Ocho procedimientos y capas A1–A4 descritos |
| Música | ACE-Step 1.5 turbo + LM1.7B | Integración y ensayos |
| Efectos generativos | MMAudio, AudioLDM 48k | Investigación; autorización comercial separada |
| Limpieza vocal | DeepFilterNet3 | Experimental |

El nombre no prueba la licencia de los pesos; se aplica la [política de licencias](licenses.md). Archivo WAV, render terminado, aceptación editorial y publicación son eventos distintos.

## 5. Proveedores y autenticación

Las fuentes existentes pueden no necesitar generación. Cuando es necesaria se verifican conector, interfaz permitida, acceso, costes de intentos y derechos. MCP es una interfaz, no garantía de acceso gratuito o autorizado.

En modo usuario, su cliente IA llama herramientas. En servidor, Station organiza llamadas con acceso permitido para ese producto. Gastos y permisos se contabilizan aparte; los secretos no se recogen por formulario ni entran en informes.

## 6. Contrato de publicación

Estados propuestos: `prepared → reviewed → authorized → transferring → processing → published`; también `rejected`, `cancelled`, `failed`, `unknown`. Cada adaptador mapea los estados reales.

La autorización vincula cuenta, versión/hash, texto, visibilidad, fecha y divulgaciones. Cambios sustanciales exigen revisión. La programación respeta reglas y facultades; un calendario no sustituye confirmaciones obligatorias.

Un corte de red no prueba fracaso. Ante `unknown`, se reconcilia la operación remota y se bloquea otra carga hasta aclararla. Publicar se confirma por la plataforma, no por bytes enviados. Revocar detiene nuevas acciones; borrar contenido ya publicado es otra operación.

## 7. Escenarios verificables

| ID | Escenario | Evidencia |
|---|---|---|
| PUB-01 | Envío normal autorizado | ID externo, estado y material coincidente |
| PUB-02 | Solicitud repetida | Una publicación, ambas tentativas registradas |
| PUB-03 | Corte tras enviar | Reconciliación sin carga ciega |
| PUB-04 | Cambio de archivo o ajustes | No reutilizar autorización anterior |
| PUB-05 | Acceso vencido o revocado | Rechazo claro, sin nuevas acciones ni secretos en logs |
| PUB-06 | Reinicio o cambio de ejecutor | Identidad e historia conservadas, sin repetir resultados |
| PUB-07 | Restricción de plataforma | Respeto del límite, sin evasión |
| PUB-08 | Destino equivocado | Detención hasta revisión |
| DATA-01 | Eliminación | Comprobar datos principales, logs y recuperación de copias |
| RIGHTS-01 | Licencia desconocida | Sin aceptación comercial antes de decidir |

Son requisitos de ensayo, no resultados aprobados. No exigen iniciar manualmente otra producción activa.

## 8. Análisis y comparaciones

Las pruebas fijan encargo, fuentes, duración, idiomas, complejidad gráfica y calidad iguales. Se conservan intentos, fallos y correcciones; excluir un ensayo necesita explicación.

Se miden tokens de entrada/salida/caché, llamadas y reintentos, generación multimedia, tiempo hasta aceptación, minutos humanos, cálculo, almacenamiento, entrega y coste completo. Se informa cómo se distribuyen suscripciones y depreciación. El objetivo 50–80% corresponde al asistente, no al coste total.

Cada métrica incluye fuente, período, zona horaria y actualización. Predicción, devengo y pago se separan. La rentabilidad no se deduce del número de llamadas o tests.

## 9. Evidencias y divulgación

El paquete redactado incluye versiones, calidad, revisión, costes, intervención humana, autorización y resultado. Excluye secretos, direcciones internas y datos personales. [Integraciones](integrations.md) · [Editorial](editorial.md) · [Licencias](licenses.md) · [Roadmap](roadmap.md).

### Contrato TikTok

[Permisos, flujo, consentimiento y admisión](tiktok.md) · [Desconexión y eliminación](data-deletion.md).

## 10. Perfil Home

[Home](home-edition.md) es una futura instalación separada del usuario. Su estación principal coordina esa instalación; Station conserva la autoridad de la producción existente. La aceptación cubre recursos, dependencias, derechos, instalador, activación, actualización, eliminación, copias y recuperación sin repetir trabajo terminado.

Cerca del mínimo requiere estación IA y al menos otro portátil o PC para edición, Blender, gráficos y render. Una máquina potente basta si dispone de margen. Dos, tres, cinco o más ejecutores se conectan mediante un registro común.

## 11. Perfil Cloud y memoria compartida

[Cloud](cloud-edition.md) conecta un cliente de portátil a un núcleo lógico en nube; Vantemio aporta IA y cargas pesadas. El mínimo Home no se aplica al cliente. Depende de financiación y pruebas de carga. La experiencia común mejora módulos, con proyectos y credenciales aislados y sin entrenamiento automático con contenido.