social-media-automation/docs/plans/2025-01-28-social-media-automation-design.md

Sistema de Automatización de Redes Sociales - Consultoría AS

Resumen Ejecutivo

Sistema automatizado para la creación y publicación de contenido en redes sociales (X, Threads, Instagram, Facebook) para Consultoría AS, empresa de tecnología en Tijuana especializada en soluciones de IA, automatización y venta de equipos de cómputo e impresión 3D.

Objetivos

• Automatizar la generación de contenido educativo (tips tech, datos curiosos)
• Promocionar productos del catálogo (equipos de cómputo, impresoras 3D)
• Destacar servicios de consultoría (IA, chatbots, sistemas a medida)
• Mantener presencia constante en redes con contenido de valor
• Gestionar interacciones con la audiencia desde un dashboard centralizado

---

Arquitectura General

┌─────────────────────────────────────────────────────────────────┐
│                    SOCIAL MEDIA AUTOMATION                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────────┐  │
│  │   FUENTES    │───▶│  GENERADOR   │───▶│   PUBLICADOR     │  │
│  │  DE DATOS    │    │  DE CONTENIDO│    │   MULTI-PLAT     │  │
│  └──────────────┘    └──────────────┘    └──────────────────┘  │
│        │                    │                     │             │
│   • Catálogo productos     │ DeepSeek API        │ • X API     │
│   • Tips tech (DB)         │                     │ • Threads   │
│   • Perfiles inspiración   │ ┌──────────────┐    │ • Instagram │
│   • Input manual           └▶│  GENERADOR   │    │ • Facebook  │
│                              │  DE IMÁGENES │    │             │
│                              └──────────────┘    │             │
│                                                  │             │
│  ┌──────────────────────────────────────────────┘             │
│  │                                                             │
│  │  ┌──────────────┐    ┌──────────────┐                      │
│  └─▶│ SCHEDULER    │    │   DASHBOARD  │◀── Revisión manual   │
│     │ (Celery)     │    │   (FastAPI)  │                      │
│     └──────────────┘    └──────────────┘                      │
│                                                                │
└─────────────────────────────────────────────────────────────────┘

---

Stack Tecnológico

Componente	Tecnología	Justificación
Backend	Python + FastAPI	Async, rápido, ideal para IA
Base de datos	PostgreSQL	Robusto, JSON support
Cola de tareas	Celery + Redis	Tareas programadas confiables
ORM	SQLAlchemy	Maduro, bien documentado
Imágenes	Pillow + html2image	Flexible, sin dependencias externas
IA	DeepSeek API	Económico (~$0.27/M tokens), buena calidad
Contenedores	Docker Compose	Despliegue reproducible

---

Plataformas y Frecuencia

Plataforma	Frecuencia	Posts/Mes	Límite API
X (Twitter)	Alta (1-2/día)	~80-100	1,500/mes (Free) ✅
Threads	Alta (1-2/día)	~80	250/día ✅
Instagram	Alta (1-2/día)	~66	25/día ✅
Facebook	Media (3-5/sem)	~36	Sin límite práctico ✅

Total aproximado: ~280-300 posts/mes

---

Tipos de Contenido

Automático (sin revisión)

Tipo	Frecuencia	Plataformas
Tips tech	Diario	X, Threads, IG
Datos curiosos	Diario	X, Threads
Frases motivacionales	3x semana	IG, FB
Efemérides tech	Variable	X, Threads

Semi-automático (revisión rápida)

Tipo	Frecuencia	Plataformas
Productos del catálogo	3x semana	FB, IG
Servicios destacados	2x semana	FB, IG, X
Hilos educativos	1x semana	X, Threads

Manual (contenido importante)

Tipo	Frecuencia	Plataformas
Casos de éxito	Mensual	Todas
Promociones especiales	Variable	Todas
Anuncios importantes	Variable	Todas

---

Estructura de Base de Datos

Tablas Principales

-- Catálogo de productos
products (
    id, name, description, price, category,
    specs JSON, images[], stock, created_at
)

-- Servicios de consultoría
services (
    id, name, description, target_sector,
    benefits[], case_studies[], created_at
)

-- Banco de tips
tip_templates (
    id, category, template, variables,
    used_count, last_used, created_at
)

-- Posts generados
posts (
    id, content, content_type, platforms[],
    status, scheduled_at, published_at,
    image_url, approval_needed, platform_ids JSON
)

-- Calendario de contenido
content_calendar (
    id, day_of_week, time, platform,
    content_type, is_active
)

-- Plantillas de imágenes
image_templates (
    id, name, template_file, variables[], category
)

-- Interacciones
interactions (
    id, platform, type, post_id, external_id,
    author_username, author_name, content,
    responded, response_content, responded_at,
    is_lead, created_at
)

---

Flujo de Generación de Contenido

1. Scheduler revisa calendario cada hora
2. Selecciona fuente según tipo (tips, productos, servicios)
3. Genera contenido con DeepSeek API usando prompts especializados
4. Adapta por plataforma (caracteres, hashtags, estilo)
5. Genera imagen si aplica (plantilla o foto de catálogo)
6. Decide flujo: auto-programar o enviar a aprobación

---

Dashboard de Gestión

Funcionalidades

• Home: Resumen, métricas, alertas
• Posts: Historial, filtros, estados
• Productos: CRUD del catálogo
• Calendar: Vista visual, reprogramación drag-and-drop
• Queue: Cola de publicación, pausar/reanudar
• Interacciones: Responder comentarios, DMs, menciones

Gestión de Interacciones

• Ver todas las interacciones en un solo lugar
• Respuestas sugeridas por IA
• Marcar leads potenciales
• Filtrar por plataforma, tipo, estado

---

Arquitectura de Despliegue

# Docker Compose - Servicios
services:
  - app (FastAPI :8000)
  - worker (Celery Worker)
  - beat (Celery Beat Scheduler)
  - flower (Monitor :5555)
  - db (PostgreSQL :5432)
  - redis (Redis :6379)
  - nginx (Reverse Proxy :80/:443)

---

APIs Externas Requeridas

API	Propósito	Costo	Estado
DeepSeek	Generación de contenido	~$0.27/M tokens	Pendiente
X API v2	Publicar en Twitter	Free tier	Pendiente
Meta Graph API	FB, IG, Threads	Gratis	Pendiente

---

Estimación de Costos Mensuales

Concepto	Costo
DeepSeek API (~300 posts)	~$5-10
X API (Free tier)	$0
Meta API	$0
Servidor (ya existente)	$0
Total	~$5-10/mes

---

Referencias de Estilo

Perfiles de inspiración para el tono y tipo de contenido:

• @midudev - Tips desarrollo web, hilos educativos
• @MoureDev - Python, retos, comunidad
• @SoyDalto - Contenido accesible, motivacional
• @SuGE3K - Tips tech prácticos
• @FrankSanabria - Desarrollo y emprendimiento

Tono Consultoría AS: Profesional pero cercano, educativo, orientado a soluciones.