consultoria-as/social-media-automation
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
11b0ba46fa1cea965fa5946b8ce7292a2bc2c898
social-media-automation/docs/FEATURES_OVERVIEW.md
Consultoría AS e2882ce72b docs: Add comprehensive documentation for all new features 
- FEATURES_OVERVIEW.md: Complete summary of all system features
- ANALYTICS.md: Analytics and reporting system documentation
- ODOO_INTEGRATION.md: Odoo ERP integration guide
- AB_TESTING.md: A/B testing system documentation
- CONTENT_RECYCLING.md: Content recycling system docs
- THREAD_SERIES.md: Thread series and scheduled posts
- IMAGE_TEMPLATES.md: Visual template system documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 03:17:23 +00:00

219 lines
6.6 KiB
Markdown
Raw Blame History

# Features Overview
Sistema de automatización de redes sociales para Consultoría AS.
## Tabla de Contenidos
1. [Analytics y Reportes](#analytics-y-reportes)
2. [Integración Odoo](#integración-odoo)
3. [A/B Testing](#ab-testing)
4. [Reciclaje de Contenido](#reciclaje-de-contenido)
5. [Thread Series](#thread-series)
6. [Image Templates](#image-templates)
---
## Analytics y Reportes
Sistema completo de métricas y análisis de rendimiento.
**Documentación completa:** [ANALYTICS.md](./ANALYTICS.md)
### Características principales:
- Dashboard interactivo con métricas en tiempo real
- Tracking de engagement por post y plataforma
- Análisis de mejores horarios para publicar
- Reportes semanales automáticos vía Telegram
- Histórico de métricas por post
### Endpoints API:
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/api/analytics/dashboard` | Datos del dashboard |
| GET | `/api/analytics/top-posts` | Posts con mejor rendimiento |
| GET | `/api/analytics/optimal-times` | Mejores horarios |
| GET | `/api/analytics/engagement-trend` | Tendencia de engagement |
| GET | `/api/analytics/reports` | Reportes históricos |
| POST | `/api/analytics/reports/generate` | Generar reporte |
| POST | `/api/analytics/reports/send-telegram` | Enviar reporte a Telegram |
---
## Integración Odoo
Sincronización bidireccional con Odoo ERP.
**Documentación completa:** [ODOO_INTEGRATION.md](./ODOO_INTEGRATION.md)
### Características principales:
- Sincronización de productos desde Odoo
- Sincronización de servicios desde Odoo
- Exportación de leads al CRM de Odoo
- Gestión de leads desde interacciones sociales
- Logs de sincronización
### Endpoints API:
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/api/odoo/status` | Estado de conexión |
| POST | `/api/odoo/sync/products` | Sincronizar productos |
| POST | `/api/odoo/sync/services` | Sincronizar servicios |
| POST | `/api/odoo/sync/leads` | Exportar leads |
| GET | `/api/odoo/sync/logs` | Historial de sync |
| GET | `/api/leads/` | Listar leads |
| POST | `/api/leads/` | Crear lead |
| POST | `/api/leads/from-interaction/{id}` | Lead desde interacción |
---
## A/B Testing
Sistema de pruebas A/B para optimizar contenido.
**Documentación completa:** [AB_TESTING.md](./AB_TESTING.md)
### Características principales:
- Crear tests con 2-4 variantes
- Publicación automática de variantes
- Seguimiento de métricas por variante
- Análisis estadístico (chi-square)
- Determinación automática de ganador
### Endpoints API:
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/api/ab-tests/` | Listar tests |
| POST | `/api/ab-tests/` | Crear test |
| POST | `/api/ab-tests/{id}/start` | Iniciar test |
| POST | `/api/ab-tests/{id}/evaluate` | Evaluar resultados |
| GET | `/api/ab-tests/{id}/results` | Ver resultados |
| POST | `/api/ab-tests/{id}/cancel` | Cancelar test |
---
## Reciclaje de Contenido
Republica contenido exitoso automáticamente.
**Documentación completa:** [CONTENT_RECYCLING.md](./CONTENT_RECYCLING.md)
### Características principales:
- Identificación de posts reciclables por engagement
- Sistema de puntuación para candidatos
- Modificaciones opcionales al reciclar
- Límite de reciclajes por post
- Reciclaje automático programado
### Endpoints API:
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/api/recycling/candidates` | Posts candidatos |
| POST | `/api/recycling/{post_id}` | Reciclar post |
| POST | `/api/recycling/auto` | Reciclaje automático |
| GET | `/api/recycling/history` | Historial |
| POST | `/api/recycling/{post_id}/disable` | Deshabilitar reciclaje |
---
## Thread Series
Publica hilos de múltiples posts programados.
**Documentación completa:** [THREAD_SERIES.md](./THREAD_SERIES.md)
### Características principales:
- Crear series de posts conectados
- Generación con IA
- Programación con intervalos configurables
- Soporte para reply chains
- Seguimiento de progreso
### Endpoints API:
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/api/threads/` | Listar series |
| POST | `/api/threads/` | Crear serie manual |
| POST | `/api/threads/generate` | Generar con IA |
| POST | `/api/threads/{id}/schedule` | Programar serie |
| POST | `/api/threads/{id}/publish-next` | Publicar siguiente |
| POST | `/api/threads/{id}/cancel` | Cancelar serie |
---
## Image Templates
Sistema de plantillas para generar imágenes.
**Documentación completa:** [IMAGE_TEMPLATES.md](./IMAGE_TEMPLATES.md)
### Características principales:
- Plantillas HTML/CSS inline
- Variables dinámicas
- Múltiples tamaños de salida
- Categorías y tipos de plantillas
- Preview antes de generar
### Endpoints API:
| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | `/api/templates/` | Listar plantillas |
| POST | `/api/templates/` | Crear plantilla |
| PUT | `/api/templates/{id}` | Actualizar |
| DELETE | `/api/templates/{id}` | Eliminar |
| POST | `/api/templates/preview` | Previsualizar |
---
## Tareas Programadas (Celery Beat)
| Tarea | Frecuencia | Descripción |
|-------|------------|-------------|
| `check_scheduled_posts` | Cada minuto | Publica posts programados |
| `check_thread_schedules` | Cada minuto | Publica posts de hilos |
| `fetch_post_metrics` | Cada 15 min | Actualiza métricas |
| `sync_interactions` | Cada 15 min | Sincroniza interacciones |
| `export_leads_to_odoo` | Cada hora | Exporta leads |
| `evaluate_ab_tests` | Cada hora | Evalúa tests A/B |
| `generate_daily_content` | 6:00 AM | Genera contenido |
| `sync_products_from_odoo` | 6:00 AM | Sincroniza productos |
| `sync_services_from_odoo` | 6:05 AM | Sincroniza servicios |
| `auto_recycle_content` | 2:00 AM | Recicla contenido |
| `recalculate_optimal_times` | Lunes 2:00 AM | Recalcula horarios |
| `generate_weekly_report` | Domingo 9:00 AM | Genera reporte |
| `send_daily_summary` | 9:00 PM | Resumen diario |
| `cleanup_old_data` | Domingo 3:00 AM | Limpieza de datos |
---
## Configuración
Variables de entorno requeridas en `.env`:
```bash
# Analytics
ANALYTICS_FETCH_INTERVAL=15
TELEGRAM_REPORT_ENABLED=true
TELEGRAM_REPORT_DAY=6
# Odoo
ODOO_URL=https://tuempresa.odoo.com
ODOO_DB=nombre_bd
ODOO_USERNAME=usuario
ODOO_PASSWORD=api_key
ODOO_SYNC_ENABLED=false
```
---
## Dashboard URLs
| URL | Descripción |
|-----|-------------|
| `/dashboard` | Panel principal |
| `/dashboard/analytics` | Analytics |
| `/dashboard/leads` | Gestión de leads |
| `/dashboard/posts` | Gestión de posts |
| `/dashboard/calendar` | Calendario |
| `/dashboard/interactions` | Interacciones |
| `/api/docs` | Documentación Swagger |
Reference in New Issue View Git Blame Copy Permalink