Implementación inicial del sistema de automatización de redes sociales
- Estructura completa del proyecto con FastAPI - Modelos de base de datos (productos, servicios, posts, calendario, interacciones) - Publishers para X, Threads, Instagram, Facebook - Generador de contenido con DeepSeek API - Worker de Celery con tareas programadas - Dashboard básico con templates HTML - Docker Compose para despliegue - Documentación completa Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
231
docs/plans/2025-01-28-social-media-automation-design.md
Normal file
231
docs/plans/2025-01-28-social-media-automation-design.md
Normal file
@@ -0,0 +1,231 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user