ADR-045 — Analytics and product metrics

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-045-analytics-metrics.md

ADR-045: Analytics and product metrics

Estado

Accepted — 2026-08-23 · Amendment 2026-08-25 (web analytics GTM/Clarity en marketing)

Contexto

El dashboard es el producto (Cash Recovered, DSO, promises). Eso no es GTM. IVPrior separó ops, analytics de negocio y web marketing (GTM → Clarity/GA4). IVPrior adopta la misma separación.

Decisión

Tres capas:

CapaDóndeV1
Operational productCash dashboard (DOC-021, S-010)Sí — queries a Postgres
SaaSMRR, churn, trialManual / spreadsheet hasta billing (ADR-036)
Web analyticsGTM → Clarity / GA4 / AdsSí en paths marketing públicos — ADR-081

Fórmulas de producto viven en DOC-021. Cambio de fórmula = PR a DOC-021 + tests.

No warehouse / BigQuery en V1. No event stream tipo Segment.

Producción: el container GTM, proyecto Clarity y propiedad GA4 MUST ser de IVPrior. No pegar IDs de IVPrior/IVPrior. Checklist: docs/ops/go-live/pre-prod-analytics-projects.md.

Consecuencias

  • Brief de S-010 debe citar DOC-021.
  • Marketing landing / signup / login pueden cargar GTM cuando NEXT_PUBLIC_GTM_ID está seteado.
  • Admin platform y Help/Docs: sin GTM.