Skip to main content

Documentation Index

Fetch the complete documentation index at: https://wiki.vivla.com/llms.txt

Use this file to discover all available pages before exploring further.

PostHog

Modulo global de analytics que envia eventos de usuario a PostHog para monitoreo y analisis de comportamiento.

Configuracion

Variable de entornoRequeridaDescripcion
POSTHOG_API_KEYSiAPI key de PostHog
POSTHOG_HOSTNoURL de la instancia. Default: https://eu.i.posthog.com
El modulo es global — disponible en toda la aplicacion.

Servicio

PostHogService expone un unico metodo fire-and-forget:
capture(params: {
  distinctId: string              // ID del usuario
  event: string                   // nombre del evento
  properties?: Record<string, any> // propiedades adicionales
}): void
La captura es asincrona pero no se espera su resultado (no bloquea el request).

Eventos rastreados

EventoModuloPropiedades
home_nps_survey_completedSurveyssurvey_type, survey_id, survey_version, home_id, source, filled_by, total_steps

MCP Server

PostHog tambien esta disponible como MCP server en Claude Code, permitiendo consultar datos de analytics directamente:
  • Feature flags
  • Dashboards
  • Experiments
  • Cohorts
  • Insights y queries
Ver la configuracion en .mcp.json del proyecto.

Estructura de modulo

apps/backend/src/shared/posthog/
  posthog.module.ts    # Global module
  posthog.service.ts   # PostHog Node client wrapper