platform-marketing-content/docs/00-vision-general/VISION-GENERAL.md

id	title	type	status	project	version	created_date	updated_date
VISION-GENERAL	Platform Marketing Content - Plataforma SaaS de Generaci贸n de Contenido y CRM Creativo	Vision	Active	platform_marketing_content	1.0.0	2026-01-04	2026-01-04

Platform Marketing Content - Plataforma SaaS de Generaci贸n de Contenido y CRM Creativo

Versi贸n: 1.0.0 Fecha: 2025-12-08 Estado: Fase de An谩lisis y Documentaci贸n Modelo de Negocio: SaaS Multi-tenant (uso interno inicial)

---

1. Resumen Ejecutivo

1.1 Visi贸n del Producto

Platform Marketing Content es una plataforma SaaS interna para agencias de publicidad y generaci贸n de contenido que combina:

1. Motor de Generaci贸n de Contenido con IA - Im谩genes, copys, posts para redes sociales
2. CRM Integrado - Gesti贸n de clientes, marcas, campa帽as y oportunidades
3. Automatizaci贸n Creativa - Flujos desde brief 鈫? contenido 鈫? aprobaci贸n 鈫? entrega
4. DAM (Digital Asset Management) - Biblioteca centralizada de activos generados

1.2 Propuesta de Valor

Problema Actual	Soluci贸n Propuesta
Creaci贸n manual de contenido visual costosa y lenta	Generaci贸n autom谩tica con IA (Stable Diffusion, ComfyUI)
Dependencia de fot贸grafos y sets f铆sicos	Fotograf铆a sint茅tica de productos hiperrealista
Inconsistencia de marca entre campa帽as	LoRAs entrenados por marca/producto
Gesti贸n fragmentada de clientes y campa帽as	CRM integrado con motor de generaci贸n
Costos elevados por APIs comerciales (Midjourney, DALL-E)	Modelos open-source auto-hosteados
Flujos manuales de aprobaci贸n	Automatizaci贸n con n8n + workflows predefinidos

1.3 Diferenciadores Clave

鉁? Modelos Open Source + Auto-hosting = Costos controlados
鉁? LoRAs personalizados por marca = Consistencia visual
鉁? CRM + Generaci贸n integrados = Flujo end-to-end
鉁? ComfyUI como orquestador = Workflows visuales y escalables
鉁? Arquitectura preparada para multi-tenant = Escalabilidad futura

---

2. Objetivos del MVP

2.1 Objetivos de Negocio

Objetivo	M茅trica de 脡xito	Plazo
Reducir tiempo de creaci贸n de contenido	-70% tiempo vs proceso manual	MVP
Eliminar dependencia de servicios externos	100% generaci贸n local	MVP
Centralizar gesti贸n de clientes y campa帽as	1 plataforma unificada	MVP
Habilitar personalizaci贸n por marca	LoRAs entrenados por cliente	Fase 2

2.2 Objetivos T茅cnicos

Objetivo	Descripci贸n
Auto-hosting	Ejecutar modelos en GPU dedicada (12-24GB VRAM)
Arquitectura modular	Separaci贸n clara: CRM, Motor IA, DAM, Automatizaci贸n
Multi-tenant ready	Estructura preparada para m煤ltiples tenants
API-first	Todos los servicios expuestos v铆a REST/GraphQL
Escalabilidad	Colas de tareas, distribuci贸n en GPUs

---

3. Alcance del MVP

3.1 Incluido en MVP (Fase 1)

M贸dulo	Funcionalidades Core
CRM Integrado	Clientes, marcas, productos, campa帽as, oportunidades
Motor de Generaci贸n	Text-to-image (SDXL), copys con LLM, upscaling
Workflows Creativos	Fotograf铆a de producto, posts para redes, variaciones
DAM B谩sico	Repositorio de im谩genes, b煤squeda, estados (borrador/aprobado)
Automatizaci贸n B谩sica	Triggers CRM 鈫? Generaci贸n
Admin SaaS	Usuarios, roles, configuraci贸n global

3.2 Fuera de Alcance MVP (Fases Posteriores)

Feature	Fase Planificada
Generaci贸n de video avanzada (SORA, Seedream)	Fase 3
Entrenamiento self-service de LoRAs	Fase 2
Marketplace multi-tenant p煤blico	Fase 4
Integraciones profundas con CRMs externos	Fase 2
Avatares parlantes (HeyGen, etc.)	Fase 3
Texto perfecto en im谩genes (Gemini API)	Fase 2 (opcional)

---

4. Perfiles de Usuario

4.1 Usuarios Internos (MVP)

Perfil	Descripci贸n	Permisos Principales
S煤per Admin SaaS	Due帽o/CTO de la plataforma	Acceso ilimitado, configuraci贸n global, modelos
Admin de Agencia	Configura clientes, equipos, plantillas	Gesti贸n de usuarios, workflows, aprobaciones
Creativo/Media Buyer	Lanza generaciones, itera versiones	Crear proyectos, generar contenido, solicitar LoRAs
Analista/CRM	Gestiona leads, campa帽as, m茅tricas	CRM completo, triggers de automatizaci贸n

4.2 Usuarios Externos (Opcional MVP)

Perfil	Descripci贸n	Permisos
Cliente (portal ligero)	Revisa piezas, aprueba/rechaza	Solo lectura + aprobaci贸n

---

5. M贸dulos Funcionales

5.1 M贸dulo 1: Gesti贸n de Cuentas y Tenants (PMC-001)

Objetivo: Arquitectura multi-tenant preparada para escalar.

Funcionalidades:
  - Tenant principal "Agencia Propia"
  - Estructura para futuros tenants externos
  - Configuraci贸n por tenant: branding, l铆mites, conexiones
  - L铆mites de uso (im谩genes/mes, entrenamientos)

5.2 M贸dulo 2: CRM Integrado (PMC-002)

Objetivo: Gestionar clientes, marcas y campa帽as con conexi贸n directa al motor de generaci贸n.

Entidades:
  - Contactos (personas)
  - Empresas/Clientes
  - Marcas (brand identity, tono, restricciones)
  - Productos/Servicios
  - Oportunidades/Deals
  - Campa帽as de Marketing

Funcionalidades:
  - Alta/edici贸n de clientes y contactos
  - Segmentaci贸n de leads
  - Historial de interacciones
  - Campos para generaci贸n: fotos referencia, identidad marca, tono
  - API interna 鈫? motor de generaci贸n

5.3 M贸dulo 3: Proyectos y Campa帽as (PMC-003)

Objetivo: Organizar el trabajo creativo por iniciativa.

Proyectos:
  - Agrupan campa帽as y assets por cliente
  - Estados: Borrador, En curso, En revisi贸n, Cerrado

Campa帽as:
  - Tipos: redes sociales, performance ads, cat谩logos, landing pages
  - Brief estructurado:
    - Objetivo de campa帽a
    - P煤blico objetivo
    - Tono de voz
    - Canales (IG, FB, TikTok, Google Ads)
    - Restricciones (palabras prohibidas, colores marca)

Flujos:
  - Crear campa帽a 鈫? seleccionar plantillas 鈫? disparar generaci贸n 鈫? revisi贸n 鈫? entrega

5.4 M贸dulo 4: Motor de Generaci贸n de Contenido IA (PMC-004)

Objetivo: N煤cleo de generaci贸n de im谩genes y copys.

4.1 Modelos Locales (Open Source):
  Imagen:
    - Stable Diffusion XL (principal)
    - Checkpoints especializados:
      - Fotograf铆a de producto (e-commerce)
      - Rostros humanos realistas
      - Estilos ilustrados (publicidad, vintage)
    - ControlNets: OpenPose, segmentaci贸n, canny, depth
    - Upscaling: 2x-4x
    - Inpainting: correcciones localizadas

  Texto (NLP):
    - LLM para copys, t铆tulos, hashtags
    - Ajuste de tono seg煤n brief
    - OpenAI API (bajo costo) o modelo local

4.2 Workflows ComfyUI:
  Predefinidos:
    - Fotograf铆a sint茅tica de producto
    - Post redes sociales (imagen + copy)
    - Variaciones de anuncio (A/B testing)
    - Influencer virtual / avatar de marca

  Caracter铆sticas:
    - Exposici贸n como APIs internas (ComfyDeploy)
    - Workflows personalizables por usuario

4.3 Personalizaci贸n (LoRAs):
  - Entrenamiento dirigido por equipo t茅cnico:
    - Estilos de marca
    - Productos espec铆ficos
    - Avatares/influencers virtuales
  - Interfaz para registrar y asignar modelos personalizados
  - Consistencia de personajes (IP-Adapters, Consistent Characters)

4.4 Texto en Im谩genes:
  Modo base:
    - SDXL + t茅cnicas complementarias
    - Superposici贸n vectorial (HTML/CSS/Canvas)
  Modo premium (opcional):
    - API Gemini 3 Pro Image para tipograf铆a perfecta

5.5 M贸dulo 5: Automatizaci贸n Creativa (PMC-005)

Objetivo: Conectar CRM con motor de generaci贸n mediante flujos automatizados.

Orquestador: n8n (o similar)

Flujos MVP:
  1. Nuevo producto en CRM 鈫? Generar Kit de Assets
     - Dispara workflow de fotograf铆a + posts base

  2. Nueva campa帽a 鈫? Generar lote de creatividades
     - Crea assets iniciales para revisi贸n

  3. Cambio estado campa帽a (Aprobada) 鈫? Notificaci贸n/Entrega
     - Notifica responsables
     - Genera zip descargable

Sistema de Colas:
  - Distribuci贸n de jobs en GPU(s)
  - Manejo de prioridades (urgente vs batch)

5.6 M贸dulo 6: Biblioteca de Activos DAM (PMC-006)

Objetivo: Repositorio central de contenido generado.

Contenido:
  - Im谩genes generadas
  - Copys, prompts, briefs
  - Modelos personalizados (LoRAs, checkpoints, presets)

Funciones:
  - B煤squeda avanzada (cliente, campa帽a, tags, tipo, fecha)
  - Versionado de assets
  - Estados: borrador, en revisi贸n, aprobado, publicado
  - Descarga individual o en paquetes

5.7 M贸dulo 7: Administraci贸n SaaS (PMC-007)

Objetivo: Panel de control de la plataforma.

Gesti贸n:
  - Usuarios, roles, permisos (RBAC)
  - Tenants (al menos "Agencia Propia" en MVP)
  - Par谩metros globales:
    - L铆mites de tama帽o/formatos
    - Modelos activos/inactivos
    - Pol铆tica de retenci贸n de assets

Auditor铆a:
  - Log de acciones (generaciones, entrenamientos, cambios)
  - M茅tricas de uso por usuario y campa帽a

Preparaci贸n para planes:
  - Estructura: Free, Pro, Enterprise, Interno Ilimitado
  - Par谩metros por plan: generaciones/mes, entrenamientos, etc.

5.8 M贸dulo 8: Anal铆tica y Reporting (PMC-008)

Objetivo: Visibilidad del rendimiento y uso.

Dashboards:
  - Volumen generado por periodo/cliente/campa帽a
  - Tiempo promedio de generaci贸n y aprobaci贸n
  - Uso de modelos personalizados
  - Relaci贸n campa帽as-assets

KPIs Iniciales:
  - N煤mero de campa帽as activas
  - Assets por campa帽a
  - % assets aprobados en primera iteraci贸n

Exportaci贸n:
  - CSV/Excel
  - API para herramientas BI

5.9 Modulo 9: Pagos y Suscripciones (PMC-009)

Objetivo: Monetizacion SaaS con Stripe.

Integracion Stripe:
  - Checkout con Stripe Elements
  - Suscripciones mensuales/anuales
  - Webhooks automatizados
  - Facturacion automatica

Planes:
  - Free: $0/mes (50 generaciones, 1GB, 1 usuario)
  - Pro: $79/mes (500 generaciones, 25GB, 5 usuarios)
  - Enterprise: $249/mes (ilimitado)
  - Internal: Sin limite (uso interno)

Productos Adicionales:
  - Pack 100 generaciones: $19 (one-time)

Funcionalidades:
  - Seleccionar y cambiar plan
  - Upgrade/downgrade automatico
  - Comprar creditos adicionales
  - Ver facturas e historial
  - Portal de billing

---

5.10 Estructura de Portales

La plataforma ofrece 3 portales diferenciados segun el tipo de usuario:

Portal 1: Usuario General (Creative/Viewer)

Acceso: Usuarios con rol creative, analyst, viewer
Funcionalidades:
  - Dashboard de proyectos asignados
  - Generacion de contenido IA
  - Biblioteca de assets
  - Perfil personal
  - Historial de actividad
URL: app.{tenant}.platform-marketing.com

Portal 2: Admin Cliente (Tenant Admin)

Acceso: Usuarios con rol tenant_admin
Funcionalidades:
  - Dashboard de organizacion
  - Gestion de usuarios del tenant
  - Configuracion del tenant (branding, limites)
  - Reportes de uso
  - Facturacion y suscripcion
  - Integraciones (n8n, CRM externo)
URL: admin.{tenant}.platform-marketing.com

Portal 3: Admin SaaS (Super Admin)

Acceso: Usuarios con rol super_admin
Funcionalidades:
  - Dashboard global de todos los tenants
  - Gestion de planes y precios
  - Monitoreo de sistema y recursos
  - Configuracion global
  - Soporte y tickets
  - Analytics de uso global
  - Auditoria y logs
URL: admin.platform-marketing.com

---

6. Requisitos T茅cnicos

6.1 Stack Tecnol贸gico

Backend:
  - Node.js 20+ / NestJS + TypeScript
  - PostgreSQL 15+ (multi-tenant ready)
  - Redis (caching, colas)
  - Bull/BullMQ (jobs de generaci贸n)

Frontend:
  - React 18 + Vite + TypeScript
  - TailwindCSS / Shadcn UI
  - React Query (data fetching)

Motor IA:
  - ComfyUI (orquestaci贸n de workflows)
  - ComfyDeploy (API de inferencia)
  - Stable Diffusion XL + checkpoints
  - Python 3.10+ / Diffusers (alternativa)

Automatizaci贸n:
  - n8n (flujos entre m贸dulos)

Almacenamiento:
  - S3 / MinIO (assets e im谩genes)
  - PostgreSQL (metadata, CRM)

Infraestructura:
  - Docker / Docker Compose
  - GPU: NVIDIA 12-24GB VRAM (L4, RTX 3090/4090, A5000)

6.2 Arquitectura de Alto Nivel

鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
鉁?          Frontend (React + Vite)             鉁?
鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
                        鉁?
                        鈻?
鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
鉁?         Backend API (NestJS)                鉁?
鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁?
鉁?  鉁? CRM   鉁?  鉁? Projects鉁?  鉁? Assets 鉁?  鉁?
鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁?
鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
        鉁?              鉁?               鉁?
        鈻?              鈻?               鈻?
鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
鉁? PostgreSQL 鉁?  鉁?  ComfyUI   鉁?  鉁?    n8n      鉁?
鉁?  + Redis   鉁?  鉁? (GPU GPU) 鉁?  鉁? (Workflows) 鉁?
鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?  鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
                        鉁?
                        鈻?
                鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?
                鉁?    S3/MinIO   鉁?
                鉁?   (Assets)    鉁?
                鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁斺攢鉁?

6.3 Integraciones Clave

Integraci贸n	Prioridad	Descripci贸n
ComfyUI / ComfyDeploy	Alta	Motor de workflows de generaci贸n
n8n	Alta	Orquestaci贸n de automatizaciones
OpenAI API	Media	LLM para generaci贸n de copys
Gemini API	Baja	Texto perfecto en im谩genes (opcional)
CRM Externo	Baja	Sincronizaci贸n b谩sica via webhooks

---

7. Roadmap

Fase 1: MVP Core (Semanas 1-8)

Entregables:
  - Arquitectura base (backend + frontend)
  - CRM b谩sico (clientes, marcas, productos)
  - Motor de generaci贸n con 2-3 workflows
  - DAM b谩sico
  - Admin de usuarios y roles

M茅trica de 脡xito:
  - Generar 100 im谩genes de producto
  - 3 campa帽as completas end-to-end

Fase 2: Personalizaci贸n Avanzada (Semanas 9-14)

Entregables:
  - Entrenamiento de LoRAs por marca
  - Avatares/influencers virtuales consistentes
  - Integraci贸n profunda CRM 鈫? Generaci贸n
  - Workflows adicionales

M茅trica de 脡xito:
  - 5 LoRAs entrenados por marca
  - 90% consistencia en personajes

Fase 3: Contenido Enriquecido (Semanas 15-22)

Entregables:
  - GIFs/cinemagraphs
  - Integraci贸n de video b谩sico
  - APIs premium opcionales (Gemini para texto)
  - Portal cliente externo

M茅trica de 脡xito:
  - 50% de campa帽as con contenido animado
  - 3 clientes externos usando portal

Fase 4: Multi-tenant Comercial (Semanas 23+)

Entregables:
  - Apertura a clientes externos (SaaS completo)
  - Planes de suscripci贸n y l铆mites
  - Marketplace de extensiones

M茅trica de 脡xito:
  - 10 tenants activos
  - MRR positivo

---

8. Riesgos y Mitigaciones

Riesgo	Impacto	Probabilidad	Mitigaci贸n
Calidad de generaci贸n insuficiente	Alto	Media	Checkpoints especializados, postprocesado
Requisitos de GPU elevados	Medio	Alta	Optimizaci贸n de modelos, colas de prioridad
Texto ilegible en im谩genes	Medio	Alta	Modo h铆brido (IA + superposici贸n)
Inconsistencia de personajes	Medio	Media	LoRAs + IP-Adapters + image prompts
Complejidad de ComfyUI	Medio	Media	Workflows pre-construidos, documentaci贸n

---

9. Referencias

9.1 Documentaci贸n del Proyecto

• MVP Original - Definici贸n inicial
• Investigaci贸n Morfeo Academy - An谩lisis de referencia

9.2 Tecnolog铆as de Referencia

• Morfeo Academy - Referencia de plataforma similar
• ComfyUI - Motor de workflows
• ComfyDeploy - API de inferencia
• Stable Diffusion XL - Modelo base de generaci贸n

---

Documento generado por: Requirements-Analyst Fecha: 2025-12-08 Pr贸xima revisi贸n: Al completar Fase 1