Consultoría AS
049d2133f9
- 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>
232 lines
8.3 KiB
Markdown
232 lines
8.3 KiB
Markdown
# 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.
|