Social Farm
Plataforma integral para la gestion masiva de cuentas de redes sociales, proxies y campanas de automatizacion. Administra 800+ cuentas en multiples paises desde un solo panel.
Arquitectura del Sistema
Construido con Laravel 11, Filament 5, Redis y MySQL. Disenado para escalar a miles de cuentas.
Panel Admin Filament
Interfaz administrativa completa con 9 recursos CRUD: paises, proxies, perfiles, cuentas, actividades, campanas, asignaciones, alertas y configuracion. Dashboard con widgets de estadisticas en tiempo real.
9 Tablas Relacionales
Modelos Eloquent con SoftDeletes, relaciones, casts y metodos helper. Pivot campaign_accounts con seguimiento de acciones realizadas, exitosas y fallidas por cuenta.
Automatización Robusta
Peticiones HTTP con proxies, Rate Limiting nativo para respetar topes de campañas, chequeo constante de proxies activos y Alertas inteligentes ante fallos externos.
API REST con Sanctum
Endpoints protegidos con tokens de acceso: estadisticas del sistema, listado paginado de cuentas, campanas y proxies. Ideal para integraciones externas.
Roles y Permisos
Spatie Permission integrado con 3 roles predefinidos: Admin, Editor y Viewer. Control de acceso granular en todo el panel administrativo.
Alertas y Monitoreo
Sistema de alertas con tipos y severidades. Seguimiento de actividad por cuenta. Widgets de dashboard con graficos de plataforma y estado.
El Ecosistema (Paso a Paso)
Así funciona el Command Center de Social Farm desde que inicias sesión hasta que los bots hacen el trabajo.
🌍 La Infraestructura Base (El "Suelo")
Antes de crear nada, el sistema necesita saber de dónde se va a conectar y con qué IP:
- Países (Countries): Define las ubicaciones geográficas disponibles (Ej. Argentina, España).
- Proxies: Son las conexiones a internet prestadas. Cada proxy le da a nuestro sistema una dirección IP en ese país específico para que las redes sociales crean que la conexión es legítima y local.
🧠 La Identidad Digital (El "Dispositivo y el Cerebro")
Perfiles Anti-Detect (Profiles): Esto es el núcleo del sistema. Un perfil no es una cuenta de red social; es una simulación de un dispositivo físico y un cerebro.
- Dispositivo: El perfil guarda la "huella digital" (Cookies, navegador, sistema operativo Windows/Mac, etc.).
- Cerebro: El perfil contiene el
persona_promptde Gemini (Ej. "Eres Luis, 22 años de Perú..."). - Regla: Cada perfil se asocia a 1 País y usa 1 Proxy.
📱 Las Redes Sociales (Las "Manos")
Cuentas (Accounts): Son las cuentas reales en las plataformas (Twitter, Instagram, TikTok, etc.).
- Cada Cuenta "vive" dentro de un Perfil Anti-Detect.
- Una cuenta nace con estado
created. Luego pasa awarming(calentamiento, donde solo navega y da likes al azar para no levantar sospechas), hasta que llega aactive(lista para trabajar).
🎯 El Trabajo (La Misión)
Una vez que tienes un ejército de "Cuentas" en estado active, les damos órdenes:
- Campañas (Campaigns): Es la misión de marketing. Aquí configuras la plataforma objetivo, la URL o usuario objetivo, y el tipo de acción (Ej. Hacer un comentario inteligente usando Gemini).
- Asignación (CampaignAccounts): Es el puente que une la campaña con las cuentas. Seleccionas qué cuentas de tu ejército van a participar.
⚙️ La Ejecución y 🚨 Monitoreo
El sistema automático entra a trabajar en segundo plano (bots):
- Actividades (AccountActivities): Cada vez que una de tus cuentas hace cualquier cosa, queda registrado aquí (Logins, likes, comentarios generados por IA). Es la "caja negra".
- Alertas (Alerts): Las redes sociales son hostiles. Si algo falla (Instagram pide SMS, proxy caído), el sistema interrumpe la actividad y crea una Alerta para que intervengas. También avisa del éxito.
- Ajustes (Settings): Tuercas globales (tiempo de espera mínimo, límite de baneos tolerables).
Modelo de Datos
Estructura relacional completa del sistema
Entidades Principales
- Country — Paises (MX, CO, AR, CL, PE, ES)
- Proxy — Proxies HTTP/SOCKS5 por pais
- Profile — Perfiles de datos ficticios
- Account — Cuentas de redes sociales
- Campaign — Campanas de automatizacion
Relaciones Clave
- Account -> Proxy (1 a muchos)
- Account -> Profile (1 a 1)
- Account -> Country (N a 1)
- Campaign -> Account (N a M via pivot)
- Account -> AccountActivity (1 a muchos)
- Account -> Alert (1 a muchos)
Servicios Externos Necesarios
Para operar un sistema como Social Farm en el mundo real (y evitar bloqueos masivos), este motor debe conectarse a las siguientes APIs.
🔴 1. Proveedores de Proxies (Obligatorio)
Las plataformas detectarán inmediatamente si 100 cuentas inician sesión desde tu misma IP.
- Qué necesitas: Proxies Residenciales o Móviles. Evita los de Data Center (AWS, etc).
- Ejemplos: Bright Data, Smartproxy, IPRoyal.
🔴 2. APIs Anti-Detección
Las redes usan scripts JS avanzados. Las llamadas HTTP directas fallarán en producción.
- Nube: ScrapingBee, Apify (ejecutan navegadores reales por ti).
- Local: Laravel Dusk, Playwright con perfiles stealth.
🟡 3. Verificación SMS/Email
Para crear cuentas masivamente, te exigirán validar registros con teléfonos reales o correos.
- Qué necesitas: Teléfonos reales alquilados por minutos para recibir PIN.
- Ejemplos: 5SIM, SMS-Activate, Twilio.
🟢 4. Validación de IP Avanzada
Similar al CheckProxyHealthJob, pero verificando el "Fraud Score" antes de arriesgar cuentas.
- Ejemplos: IPQualityScore, Scamalytics.
Tecnologias
Stack tecnologico del proyecto
Laravel v11.54.0 (PHP v8.2.35) — Social Farm © 2026