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

467 lines
16 KiB
Markdown

# 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.
```yaml
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.
```yaml
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.
```yaml
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.
```yaml
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.
```yaml
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.
```yaml
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.
```yaml
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.
```yaml
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
```
---
## 6. Requisitos T茅cnicos
### 6.1 Stack Tecnol贸gico
```yaml
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)
```yaml
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)
```yaml
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)
```yaml
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+)
```yaml
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](./MVP_Plataforma_SaaS_Contenido_CRM.md) - Definici贸n inicial
- [Investigaci贸n Morfeo Academy](./Investigaci贸n%20Profunda_%20Plataforma%20de%20Generaci贸n%20de%20Contenido%20de%20Morfeo%20Academy%20y%20Desarrollo%20de%20una%20.pdf) - An谩lisis de referencia
### 9.2 Tecnolog铆as de Referencia
- [Morfeo Academy](https://www.morfeoacademy.com/) - Referencia de plataforma similar
- [ComfyUI](https://github.com/comfyanonymous/ComfyUI) - Motor de workflows
- [ComfyDeploy](https://www.comfydeploy.com/) - API de inferencia
- [Stable Diffusion XL](https://stability.ai/) - Modelo base de generaci贸n
---
**Documento generado por:** Requirements-Analyst
**Fecha:** 2025-12-08
**Pr贸xima revisi贸n:** Al completar Fase 1