docs: add sm_utils pages and fix semantic metric catalog docs

data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog.mdx

@@ -1,5 +1,5 @@
 ---
 title: 'dim_semantic_metric_catalog'
 description: 'Self-documenting catalog of all semantic layer metrics with their calculations, categories, and dependencies.'
 icon: "book-open"
 ---
@@ -78,8 +78,9 @@
 
       - name: filter_condition
         description: >
-          The actual filter condition applied to the metric, if any.
-          NULL if no filter is applied.
+          Filter condition applied to the metric, if any.
+          Extracted from MetricFlow/dbt metric definitions.
+          NULL if no filter is applied (or if the filter cannot be extracted).
 
       - name: metric_time_grains
         description: >
@@ -90,7 +91,7 @@
         description: >
           Configuration for cumulative metrics:
           - "month", "quarter", "year" for grain-to-date (MTD, QTD, YTD)
-          - "30 day", "90 day", "365 day" for trailing windows
+          - "30 days", "90 days", "365 days" for trailing windows
           - "all_time" for unbounded cumulative from the beginning
           - NULL for non-cumulative metrics
 
@@ -319,7 +320,7 @@
 | `mer` | `marketing_efficiency_ratio` | Marketing Efficiency Ratio (blended ROAS) |
 | `cac` | `customer_acquisition_cost` | Customer Acquisition Cost |
 | `cpc` | `cost_per_click` | Cost Per Click |
 | `cpm` | `cost_per_thousand_impressions` | Cost Per Mille (thousand impressions) |
 | `cpo` | `cost_per_order` | Cost Per Order |
 | `roas` | `return_on_ad_spend` | Return on Ad Spend |
 | `ctr` | `click_through_rate` | Click-Through Rate |

data-activation/data-tables/sm_utils/currency_conversion_rates_daily.mdx

@@ -0,0 +1,14 @@
+---
+title: 'currency_conversion_rates_daily'
+sidebarTitle: 'currency_conversion_rates_daily'
+description: 'Daily foreign exchange rates used for currency normalization.'
+icon: 'table'
+---
+
+## Overview
+
+`currency_conversion_rates_daily` provides daily FX rates used to convert amounts to a standard currency (typically USD) for cross-market reporting.
+
+## Common uses
+
+- Converting `order_*` revenue fields to a standardized currency for aggregated reporting

data-activation/data-tables/sm_utils/dim_dates.mdx

@@ -0,0 +1,15 @@
+---
+title: 'dim_dates'
+sidebarTitle: 'dim_dates'
+description: 'Date spine + date attributes used for time-based analysis.'
+icon: 'table'
+---
+
+## Overview
+
+`dim_dates` is a shared date dimension used for consistent week/month/quarter/year rollups and “to-date” calculations.
+
+## Common uses
+
+- Joining daily fact tables to derive `week_start_date`, `month_start_date`, `quarter_start_date`
+- Time-series charting and period comparisons

data-activation/data-tables/sm_utils/geo_countries.mdx

@@ -0,0 +1,14 @@
+---
+title: 'geo_countries'
+sidebarTitle: 'geo_countries'
+description: 'Reference table for country codes and names.'
+icon: 'table'
+---
+
+## Overview
+
+`geo_countries` is a shared reference table for country names and codes.
+
+## Common uses
+
+- Normalizing country fields from different source systems

data-activation/data-tables/sm_utils/index.mdx

@@ -0,0 +1,16 @@
+---
+title: 'sm_utils'
+sidebarTitle: 'sm_utils'
+description: 'Utility tables shared across reporting (dates, FX rates, geo).'
+icon: 'database'
+---
+
+## Overview
+
+`sm_utils` contains shared utility tables used across multiple reports and analyses. These tables are designed to be broadly reusable and stable.
+
+## Tables
+
+- [`dim_dates`](/data-activation/data-tables/sm_utils/dim_dates) — Date spine + common date attributes (week/month/quarter starts, etc.)
+- [`currency_conversion_rates_daily`](/data-activation/data-tables/sm_utils/currency_conversion_rates_daily) — Daily FX conversion rates
+- [`geo_countries`](/data-activation/data-tables/sm_utils/geo_countries) — Country reference data

docs.json

@@ -597,6 +597,15 @@
               "data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog"
             ]
           },
+          {
+            "group": "Utility Tables",
+            "pages": [
+              "data-activation/data-tables/sm_utils/index",
+              "data-activation/data-tables/sm_utils/dim_dates",
+              "data-activation/data-tables/sm_utils/currency_conversion_rates_daily",
+              "data-activation/data-tables/sm_utils/geo_countries"
+            ]
+          },
           {
             "group": "Experimental Tables",
             "pages": [

onboarding/data-docs/metrics.mdx

@@ -94,7 +94,7 @@
 | Metric | Description | Type |
 |--------|-------------|------|
 | **Total Products** | Total count of unique products in catalog | Simple |
 | **Total SKUs** | Total count of product variants/SKUs | Simple |
 | **Product Page Views** | Count of product page views | Simple |
 | **Product Cost (COGS)** | Total cost of goods sold | Simple |
 | **SKUs per Product** | Average number of variants per product | Ratio |
@@ -111,12 +111,12 @@
 | `mer` | `marketing_efficiency_ratio` | Marketing Efficiency Ratio |
 | `cac` | `customer_acquisition_cost` | Customer Acquisition Cost |
 | `cpc` | `cost_per_click` | Cost Per Click |
 | `cpm` | `cost_per_thousand_impressions` | Cost Per Mille |
 | `roas` | `return_on_ad_spend` | Return on Ad Spend |
 | `ctr` | `click_through_rate` | Click-Through Rate |
 | `cpo` | `cost_per_order` | Cost Per Order |
 | `cvr` | `conversion_rate` | Conversion Rate |
-| `cpa` | `customer_acquisition_cost` | Cost Per Acquisition (same as CAC) |
+| `cpa` | `customer_acquisition_cost` | Cost Per Acquisition (often used similarly to CAC; confirm your internal definition) |
 
 ### AOV Variants