# 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 |