SRV-03 · ANALYTICS ENGINEERING

Modelado, tests y docs como código

Analytics engineering es una disciplina de ingeniería. Todo versionado, revisado, testeado.

APPROACH

Enfoque

Trabajamos sobre el stack moderno: dbt para transformación, un orquestador (Airflow o Dagster), tests en CI y un glosario de métricas tratado como documentación viva. Cada pull request trae preview y plan de impacto.

Capas claras: staging aísla fuentes, intermediate crea bloques reusables, marts expone modelos listos para BI y reverse-ETL.

Revisión de código obligatoria. Ningún modelo crece sin dueño ni tests.

Docs generadas desde el código, no escritas aparte: si el modelo cambia, el doc cambia.

TESTS · DOCS

Tests & documentación

T-01Schema tests (unique, not_null, relationships) en cada tabla crítica
T-02Contract tests en los marts: breaking changes rompen el CI
T-03Freshness tests por SLA de tabla
T-04Docs generadas vía dbt-docs con lineage completo
T-05Exposure tracking: cada dashboard linkeado al modelo que lo alimenta

EXAMPLE · MART

How a mart actually looks

A typical revenue mart with an enforced contract, a 2-day late-arrival window, and an incremental key. Every PR runs the contract test; a breaking change fails CI.

fct_revenue.sqlSQL

0
{{
  config(
    materialized = 1,
    unique_key   = 2,
    on_schema_change = 3,
    contract     = { 4: true }
  )
}}

WITH paid AS (
  SELECT
    date_trunc(5, order_ts) AS period,
    customer_id,
    SUM(amount_cents) / 100.0   AS revenue_usd
  FROM {{ ref(6) }}
  WHERE status = 7
  {% if is_incremental() %}
    AND order_ts >= (SELECT max(period) - interval 8 FROM {{ this }})
  {% endif %}
  GROUP BY 1, 2
)

SELECT
  period,
  COUNT(DISTINCT customer_id) AS customers,
  SUM(revenue_usd)            AS revenue_usd
FROM paid
GROUP BY period;

GLOSSARY · EXAMPLE

Glosario de métricas

Cada proyecto empieza con un glosario acordado. Mantenemos un ejemplo público para que veas el formato.

→ Abrir glosario

Conectá un pipeline real a tu warehouse

Revisión de stack de 30 min. Volvemos con scope, owner y contrato de frescura. Sin SDR, sin slide deck.

Agendar revisión de 30 min Abrir el playground