# 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

```sql
-- 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

```yaml
# 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.