← Volver al catálogo

📈 Weekly Executive Report

Archivo: agentes/supervisores/weekly-executive.ts · Plist: com.rifai.weekly-executive (solo cargado en ~/Library/LaunchAgents, no versionado en cron/) · Horario: domingos a las 20:00 (StartCalendarInterval Weekday 0, Hour 20, Min 0) + RunAtLoad

Qué hace

Cada domingo a las 20:00 compone el informe ejecutivo de la semana para el CEO: ventas (totales y reales paid+fulfilled), gasto Meta y ROAS real promedio, contenido publicado (posts FB/IG y blogs SEO), engagement (DMs y comentarios respondidos), progreso del Brain (patrones, aprendizajes, correcciones) y picks de trends comerciales. Añade alertas si el ROAS real es bajo o hay pedidos sin paid+fulfilled.

Cómo funciona

1. Ventana = últimos 7 días.

2. Ventas: consulta pedidos Shopify de la semana y suma total / real (paid+fulfilled) y nº de prepago.

3. Meta: lee data/metrics.db (daily_metrics) para sumar gasto y promediar ROAS real de la semana.

4. Brain: cuenta learnings, success_patterns y corrections de la semana en brain/brain.db.

5. Contenido: posts de la semana en metrics.db (social_posts) y blogs publicados en Shopify.

6. Engagement: DMs y comentarios respondidos leyendo data/dm-responder-state.json y data/comment-responder-state.json.

7. Intel: picks de data/trends-hunter-state.json.

8. Renderiza el informe, lo imprime y lo envía con event: 'finance_pl_daily' (→ Fernando + CEOSEC) vía notify-router.

Datos/APIs

  • Shopify Admin API (/orders.json, /articles.json). Vars: SHOPIFY_STORE, SHOPIFY_ACCESS_TOKEN.
  • SQLite: data/metrics.db y brain/brain.db (vía better-sqlite3).
  • Sistema de archivos: estados de dm-responder / comment-responder / trends-hunter en data/.
  • Telegram vía tools/notify-router.ts (finance_pl_daily).

Cómo probarlo

cd /Users/user/rifai-agents && npx tsx agentes/supervisores/weekly-executive.ts

Esperar: 📈 Weekly Executive Report …, el informe renderizado en consola y ✅ Reporte enviado a Fernando + CEOSEC. Se ejecuta cualquier día (no tiene guard de domingo en el código). Para evitar el envío real, comenta la llamada notify durante pruebas.

Si se rompe / recuperar

launchctl unload ~/Library/LaunchAgents/com.rifai.weekly-executive.plist && launchctl load ~/Library/LaunchAgents/com.rifai.weekly-executive.plist

Logs: /Users/user/rifai-agents/logs/weekly-executive.log.

Cómo replicarlo

Agregación semanal desde Shopify (ventas/blogs) + SQLite (Meta/Brain) + estados JSON (engagement/trends), render del informe y envío con event: finance_pl_daily. Requiere better-sqlite3 y que los agentes de la flota hayan poblado metrics.db, brain.db y sus state files.