SocialApp es una plataforma de gestión de redes sociales autoalojada similar a Hootsuite o Buffer, que permite controlar múltiples cuentas de Instagram/Facebook, X (Twitter), TikTok y LinkedIn desde un único panel. Diseñada con arquitectura de monorepo para máxima escalabilidad y cumplimiento RGPD.
Estructura del Monorepo
- apps/web: Interfaz principal con Next.js 15 (App Router), next-intl, Tailwind CSS y gestión de consentimiento de cookies.
- apps/worker: Workers para colas BullMQ sobre Redis (publicación y reintentos automáticos).
- apps/ingest: Servicio de webhooks e ingesta de eventos de redes sociales (Express).
- packages/db: Drizzle ORM con conexión y esquemas de base de datos.
- packages/adapters: Interfaz unificada con adaptadores específicos por red social y sus capacidades.
- packages/ui: Componentes compartidos con Tailwind y Radix/shadcn.
Funcionalidades
- Publicación programada en múltiples redes sociales.
- Métricas de rendimiento consolidadas.
- Inbox unificado (según permisos de API de cada red).
- Interfaz personalizable con soporte de internacionalización (i18n).
- Cumplimiento RGPD: cookies no esenciales bloqueadas hasta consentimiento del usuario.
Observabilidad
- Integración con OpenTelemetry (OTel).
- Métricas con Prometheus.
- Dashboards con Grafana.
- Logs con Loki y trazas con Tempo.
Inicio Rápido
# 1. Copiar configuración
cp .env.example .env
# 2. Instalar dependencias (requiere pnpm)
pnpm install
# 3. Iniciar servicios de infraestructura
docker compose up -d # PostgreSQL, Redis y MinIO
# 4. Arrancar en local
pnpm dev