diff --git a/examples/explore/dag.html b/examples/explore/dag.html
index da5ffa67..279b1524 100644
--- a/examples/explore/dag.html
+++ b/examples/explore/dag.html
@@ -709,6 +709,16 @@
 .lineage-legend { color: var(--text-muted); font-size: 0.85rem; margin-top: 0.5rem; }
 .lineage-legend .legend-chip { display: inline-block; padding: 0 0.4rem; border: 1.5px solid var(--dag-import-stroke); border-radius: 4px; background: var(--dag-import-fill); color: var(--dag-node-text); }
 .lineage-legend .legend-chip.notcompiled { border-color: #b07400; border-style: dashed; background: var(--dag-transform-fill); }
+/* cute-dbt#253 — the typed-node vocabulary. Canvas-paired chips: these
+   exact fills/strokes are what explore-lineage.js draws per node type
+   (redundant shape+color coding on canvas; the chips mirror the colors
+   and approximate the shapes via border-radius). Shared by the legend
+   and the detail card's type chip. */
+.legend-chip.type-model, .detail-type.type-model { border-color: #0072B2; background: #e8f1f8; }
+.legend-chip.type-snapshot, .detail-type.type-snapshot { border-color: #7b5ea7; background: #f1ecf9; border-radius: 2px; }
+.legend-chip.type-seed, .detail-type.type-seed { border-color: #00756d; background: #e6f4f2; border-radius: 10px; }
+.legend-chip.type-source, .detail-type.type-source { border-color: #1f8a5b; background: #eef7ee; border-radius: 999px; }
+.legend-chip.type-exposure, .detail-type.type-exposure { border-color: #6b6b76; background: #f4f4f5; border-radius: 4px 12px 12px 4px; }
 /* cute-dbt#106 — the PR-diff change-context treatment: an amber halo
    mirroring the canvas underlay glow. A separate visual channel from
    the highlight vocabulary (border = selected, opacity = dim/trace)
@@ -764,6 +774,9 @@
 /* canvas-paired status chips (fixed across themes; dark fixed text on the
    fixed light fills stays readable on every theme by construction) */
 .model-detail-card .detail-notcompiled { display: inline-block; padding: 0 0.4rem; border: 1.5px dashed #b07400; border-radius: 4px; background: var(--dag-transform-fill); color: var(--dag-node-text); font-size: 0.8rem; }
+/* cute-dbt#253 — the detail card's node-type chip (non-model nodes only;
+   per-type colors above). */
+.model-detail-card .detail-type { display: inline-block; margin-right: 0.35rem; padding: 0 0.4rem; border: 1.5px solid var(--dag-import-stroke); border-radius: 4px; color: var(--dag-node-text); font-size: 0.8rem; }
 /* cute-dbt#106 — the detail card's "changed in this diff" chip (the
    change-context twin of .detail-notcompiled; both can show at once). */
 .model-detail-card .detail-changed { display: inline-block; margin-left: 0.35rem; padding: 0 0.4rem; border: 1.5px solid var(--dag-import-stroke); border-radius: 4px; background: var(--dag-import-fill); color: var(--dag-node-text); box-shadow: 0 0 0 2px rgba(230, 159, 0, 0.55); font-size: 0.8rem; }
@@ -776,7 +789,8 @@
 <header class="explore-header">
   <div>
     <h1>Model lineage</h1>
-    <p class="explore-counts">full manifest — 34 models, 60 edges</p>
+    
+    <p class="explore-counts">full manifest — 34 models, 1 snapshot, 16 sources, 1 exposure, 72 edges</p>
   </div>
   <nav class="explore-nav" aria-label="Explore pages">
     <a href="tests.html">Unit tests &rarr;</a>
@@ -786,11 +800,11 @@ <h1>Model lineage</h1>
 <section class="lineage" aria-label="Model lineage DAG">
   <div class="lineage-toolbar">
     <div class="lineage-search">
-      <input type="search" class="lineage-search-input" placeholder="Search models&hellip;"
-             aria-label="Search models" role="combobox" aria-expanded="false"
+      <input type="search" class="lineage-search-input" placeholder="Search nodes&hellip;"
+             aria-label="Search lineage nodes" role="combobox" aria-expanded="false"
              aria-controls="lineage-search-results" autocomplete="off" spellcheck="false">
       <ul class="lineage-search-results" id="lineage-search-results" role="listbox"
-          aria-label="Matching models" hidden></ul>
+          aria-label="Matching nodes" hidden></ul>
     </div>
     
     <div class="view-toggle" role="group" aria-label="Graph view">
@@ -806,8 +820,12 @@ <h1>Model lineage</h1>
   
   <div class="lineage-tooltip" role="tooltip" aria-hidden="true" hidden></div>
   <p class="lineage-empty" hidden>No models in this manifest.</p>
+  
   <div class="lineage-legend">
-    <span class="legend-chip">model</span>
+    <span class="legend-chip type-model">model</span>
+    <span class="legend-chip type-snapshot">snapshot</span>
+    <span class="legend-chip type-source">source</span>
+    <span class="legend-chip type-exposure">exposure</span>
     <span class="legend-chip notcompiled">not compiled</span>
     &mdash; a dashed node has no compiled SQL in this manifest (<code>dbt parse</code>); run <code>dbt compile</code> to fill it in. The explorer renders it anyway (fail-open).
   </div>
@@ -829,7 +847,7 @@ <h1>Model lineage</h1>
   <aside class="model-detail-card" aria-label="Model detail" hidden></aside>
 </section>
 
-<script type="application/json" id="explore-dag-data">{"nodes":[{"id":"model.healthcare_analytics.dim_conditions","name":"dim_conditions","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Master condition dimension for healthcare analytics.\nOne row per unique ICD/SNOMED condition code, deduplicated from staging.\nUse for filtering and grouping by condition across fact tables.\n\nUse cases:\n- Condition-based cohort analysis\n- Disease prevalence tracking\n- Condition frequency and distribution reporting\n- Join target for condition-related facts\n","materialized":"table","tags":["analytics","marts","dimension"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Identify the most prevalent conditions in the patient population\",\"name\":\"Top 10 most common conditions\",\"sql\":\"select\\n    condition_code\\n    , condition_description\\n    , patient_count\\n    , encounter_count\\nfrom main_marts.dim_conditions\\norder by patient_count desc\\nlimit 10\"},{\"description\":\"Find conditions that drive the most healthcare utilization\",\"name\":\"Conditions by encounter frequency\",\"sql\":\"select\\n    condition_code\\n    , condition_description\\n    , encounter_count\\n    , patient_count\\n    , round(encounter_count * 1.0 / patient_count, 2) as avg_encounters_per_patient\\nfrom main_marts.dim_conditions\\nwhere patient_count > 0\\norder by encounter_count desc\\nlimit 20\"},{\"description\":\"Find conditions first diagnosed in the last year\",\"name\":\"Recently diagnosed conditions\",\"sql\":\"select\\n    condition_code\\n    , condition_description\\n    , first_occurrence_date\\n    , last_occurrence_date\\n    , patient_count\\nfrom main_marts.dim_conditions\\nwhere first_occurrence_date >= current_date - interval '1 year'\\norder by first_occurrence_date desc\"}]"},{"key":"grain","value":"condition_code"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Condition lookup and filtering\",\"Cohort analysis by diagnosis\",\"Disease prevalence reporting\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"condition_code","data_type":null,"description":"ICD/SNOMED code (natural key)"},{"name":"condition_description","data_type":null,"description":"Full condition name/description"},{"name":"condition_key","data_type":null,"description":"Surrogate key (row_number)"},{"name":"encounter_count","data_type":null,"description":"Total number of encounters with this condition"},{"name":"first_occurrence_date","data_type":null,"description":"Earliest date this condition was diagnosed in the dataset"},{"name":"last_occurrence_date","data_type":null,"description":"Most recent date this condition was diagnosed"},{"name":"patient_count","data_type":null,"description":"Number of unique patients with this condition"}],"grain":{"value":"condition_code","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"condition_code","origin":"config.meta.grain"},{"kind":"unique test","value":"condition_code","origin":"test.healthcare_analytics.unique_dim_conditions_condition_code.99cd9f3457"},{"kind":"unique test","value":"condition_key","origin":"test.healthcare_analytics.unique_dim_conditions_condition_key.93802fac5a"}]}},"paths":{"sql":"models/marts/analytics/dim_conditions.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_date","name":"dim_date","not_compiled":false,"data_tests":31,"unit_tests":0,"badge":"31 data-tests · 0 unit-tests","detail":{"description":"Calendar dimension covering 1909-01-01 to 2025-12-31. Provides date attributes, day/week/month/quarter/year hierarchies, weekend flags, and US holiday identification.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"date_actual","data_type":null,"description":"The actual date value"},{"name":"date_key","data_type":null,"description":"Surrogate key in YYYYMMDD integer format (e.g., 20240115)"},{"name":"day_name","data_type":null,"description":"Full day name (e.g., Monday, Tuesday)"},{"name":"day_name_short","data_type":null,"description":"Abbreviated day name (e.g., Mon, Tue)"},{"name":"day_of_month","data_type":null,"description":"Day of the month (1-31)"},{"name":"day_of_week","data_type":null,"description":"Day of week number (US convention - Sunday=1, Saturday=7)"},{"name":"day_of_year","data_type":null,"description":"Day of the year (1-366)"},{"name":"holiday_name","data_type":null,"description":"Name of the US holiday (null if not a holiday)"},{"name":"is_us_holiday","data_type":null,"description":"Boolean flag indicating if date is a recognized US holiday"},{"name":"is_weekend","data_type":null,"description":"Boolean flag indicating if date falls on Saturday or Sunday"},{"name":"month_actual","data_type":null,"description":"Month number (1-12)"},{"name":"month_name","data_type":null,"description":"Full month name (e.g., January, February)"},{"name":"month_name_short","data_type":null,"description":"Abbreviated month name (e.g., Jan, Feb)"},{"name":"quarter_actual","data_type":null,"description":"Quarter number (1-4)"},{"name":"quarter_name","data_type":null,"description":"Quarter name (Q1, Q2, Q3, Q4)"},{"name":"week_of_year","data_type":null,"description":"Week of the year (1-53)"},{"name":"year_actual","data_type":null,"description":"Year number"}],"grain":{"value":"date_actual","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"date_actual","origin":"test.healthcare_analytics.unique_dim_date_date_actual.107fe1b6a2"},{"kind":"unique test","value":"date_key","origin":"test.healthcare_analytics.unique_dim_date_date_key.0869fd48f9"}]}},"paths":{"sql":"models/marts/core/dim_date.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_organizations","name":"dim_organizations","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Organization dimension containing healthcare facilities. Includes an unknown member row (organization_key = -1) for handling missing lookups.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier (UUID)"},{"name":"organization_key","data_type":null,"description":"Surrogate key (-1 for unknown member)"},{"name":"organization_name","data_type":null,"description":"Name of the healthcare organization"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"organization_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"organization_key","origin":"test.healthcare_analytics.unique_dim_organizations_organization_key.096582bf56"}]}},"paths":{"sql":"models/marts/core/dim_organizations.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_patients","name":"dim_patients","not_compiled":false,"data_tests":20,"unit_tests":0,"badge":"20 data-tests · 0 unit-tests","detail":{"description":"Patient dimension with SCD Type 2 history tracking. Each row represents a specific version of a patient's record. Includes an unknown member row (patient_key = -1) for handling missing lookups.\nSCD Type 2 columns: patient_key (surrogate), patient_id (natural), valid_from, valid_to, is_current.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"age_years","data_type":null,"description":"Current age or age at death (in years)"},{"name":"birth_date","data_type":null,"description":"Patient date of birth"},{"name":"city","data_type":null,"description":"City of residence"},{"name":"county","data_type":null,"description":"County of residence"},{"name":"death_date","data_type":null,"description":"Patient date of death (null if alive)"},{"name":"ethnicity","data_type":null,"description":"Patient ethnicity (hispanic or nonhispanic)"},{"name":"first_name","data_type":null,"description":"Patient's first name"},{"name":"full_name","data_type":null,"description":"Patient's full name (first + last)"},{"name":"gender","data_type":null,"description":"Patient gender (M or F)"},{"name":"healthcare_coverage","data_type":null,"description":"Total healthcare coverage received"},{"name":"healthcare_expenses","data_type":null,"description":"Total healthcare expenses incurred"},{"name":"is_current","data_type":null,"description":"Boolean flag indicating if this is the current version"},{"name":"is_deceased","data_type":null,"description":"Boolean flag indicating if patient has died"},{"name":"last_name","data_type":null,"description":"Patient's last name"},{"name":"latitude","data_type":null,"description":"Latitude coordinate of residence"},{"name":"longitude","data_type":null,"description":"Longitude coordinate of residence"},{"name":"marital_status","data_type":null,"description":"Marital status (M=Married, S=Single, or blank)"},{"name":"name_prefix","data_type":null,"description":"Name prefix (Mr., Mrs., Ms., etc.)"},{"name":"name_suffix","data_type":null,"description":"Name suffix (Jr., Sr., III, etc.)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier (UUID), same across SCD2 versions"},{"name":"patient_key","data_type":null,"description":"Surrogate key (unique per version, -1 for unknown member)"},{"name":"race","data_type":null,"description":"Patient race"},{"name":"state","data_type":null,"description":"State of residence (full state name)"},{"name":"valid_from","data_type":null,"description":"Date when this SCD2 version became active"},{"name":"valid_to","data_type":null,"description":"Date when this SCD2 version was superseded (null = current)"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"patient_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"patient_key","origin":"test.healthcare_analytics.unique_dim_patients_patient_key.a372c8896a"}]}},"paths":{"sql":"models/marts/core/dim_patients.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_payers","name":"dim_payers","not_compiled":false,"data_tests":8,"unit_tests":1,"badge":"8 data-tests · 1 unit-test","detail":{"description":"Payer dimension containing insurance payers. Includes an unknown member row (payer_key = -1) for handling missing lookups.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"amount_covered","data_type":null,"description":"Total amount covered by payer"},{"name":"amount_uncovered","data_type":null,"description":"Total amount not covered by payer"},{"name":"average_quality_of_life_score","data_type":null,"description":"Average quality of life score for members"},{"name":"city","data_type":null,"description":"City"},{"name":"coverage_rate","data_type":null,"description":"Derived coverage rate (amount_covered / total amount)"},{"name":"covered_encounters","data_type":null,"description":"Number of encounters covered"},{"name":"covered_immunizations","data_type":null,"description":"Number of immunizations covered"},{"name":"covered_medications","data_type":null,"description":"Number of medications covered"},{"name":"covered_procedures","data_type":null,"description":"Number of procedures covered"},{"name":"member_months","data_type":null,"description":"Total member months"},{"name":"payer_id","data_type":null,"description":"Natural payer identifier (UUID)"},{"name":"payer_key","data_type":null,"description":"Surrogate key (-1 for unknown member)"},{"name":"payer_name","data_type":null,"description":"Name of the insurance payer"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue collected"},{"name":"state","data_type":null,"description":"State"},{"name":"uncovered_encounters","data_type":null,"description":"Number of encounters not covered"},{"name":"uncovered_immunizations","data_type":null,"description":"Number of immunizations not covered"},{"name":"uncovered_medications","data_type":null,"description":"Number of medications not covered"},{"name":"uncovered_procedures","data_type":null,"description":"Number of procedures not covered"},{"name":"unique_customers","data_type":null,"description":"Number of unique customers"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"payer_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"payer_key","origin":"test.healthcare_analytics.unique_dim_payers_payer_key.953b1f5fd2"}]}},"paths":{"sql":"models/marts/core/dim_payers.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[{"name":"test_dim_payers_injects_unknown_sentinel","yaml":"models/marts/core/_core__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.dim_providers","name":"dim_providers","not_compiled":false,"data_tests":10,"unit_tests":0,"badge":"10 data-tests · 0 unit-tests","detail":{"description":"Provider dimension containing healthcare providers (doctors, nurses, etc.). Includes an unknown member row (provider_key = -1) for handling missing lookups.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"gender","data_type":null,"description":"Provider gender (M or F)"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations (-1 for unknown)"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier (UUID)"},{"name":"provider_key","data_type":null,"description":"Surrogate key (-1 for unknown member)"},{"name":"provider_name","data_type":null,"description":"Full name of the provider"},{"name":"specialty","data_type":null,"description":"Medical specialty"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"provider_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"provider_key","origin":"test.healthcare_analytics.unique_dim_providers_provider_key.02ac65c919"}]}},"paths":{"sql":"models/marts/core/dim_providers.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_clinical_events","name":"fct_clinical_events","not_compiled":false,"data_tests":22,"unit_tests":0,"badge":"22 data-tests · 0 unit-tests","detail":{"description":"Unified clinical events fact table combining conditions, medications, and procedures. Each row represents a single clinical event with standardized structure. Links to patient and encounter dimensions.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"clinical_event_key","data_type":null,"description":"Surrogate key for the clinical event"},{"name":"code","data_type":null,"description":"Clinical code (SNOMED-CT or RxNorm)"},{"name":"code_system","data_type":null,"description":"Code system (SNOMED-CT or RXNORM)"},{"name":"description","data_type":null,"description":"Description of the clinical event"},{"name":"encounter_id","data_type":null,"description":"Natural encounter identifier"},{"name":"encounter_key","data_type":null,"description":"Foreign key to fct_encounters (-1 for unknown)"},{"name":"event_cost","data_type":null,"description":"Cost of the clinical event"},{"name":"event_date_key","data_type":null,"description":"Foreign key to dim_date for event start"},{"name":"event_end_date","data_type":null,"description":"End date of the clinical event (null if ongoing or one-time)"},{"name":"event_id","data_type":null,"description":"Natural event identifier (condition_id, medication_id, or procedure_id)"},{"name":"event_start_date","data_type":null,"description":"Start date of the clinical event"},{"name":"event_type","data_type":null,"description":"Type of clinical event (CONDITION, MEDICATION, PROCEDURE)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients (-1 for unknown)"},{"name":"reason_code","data_type":null,"description":"Clinical code for the reason of the event"},{"name":"reason_description","data_type":null,"description":"Description of the reason for the event"}],"grain":{"value":"clinical_event_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"clinical_event_key","origin":"test.healthcare_analytics.unique_fct_clinical_events_clinical_event_key.2af827606b"}]}},"paths":{"sql":"models/marts/core/fct_clinical_events.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_condition_cohorts","name":"fct_condition_cohorts","not_compiled":false,"data_tests":15,"unit_tests":0,"badge":"15 data-tests · 0 unit-tests","detail":{"description":"Patient-condition cohort analysis for disease management and population health.\nOne row per unique patient-condition combination with timeline and encounter details.\nGrain: (patient_id, condition_code)\n\nUse cases:\n- Disease management program enrollment\n- Cohort identification for clinical trials\n- Chronic condition tracking\n- Care gap analysis\n- Risk stratification by condition\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Find conditions with the most patients for population health programs\",\"name\":\"Largest condition cohorts\",\"sql\":\"select\\n    fcc.condition_code\\n    , fcc.condition_description\\n    , count(distinct fcc.patient_id) as patient_count\\n    , sum(fcc.encounter_count) as total_encounters\\n    , round(avg(fcc.months_with_condition), 1) as avg_months_with_condition\\n    , sum(case when fcc.is_active then 1 else 0 end) as active_patients\\nfrom main_marts.fct_condition_cohorts fcc\\ngroup by 1, 2\\norder by patient_count desc\\nlimit 15\"},{\"description\":\"Identify patients with long-standing conditions for care management\",\"name\":\"Chronic condition patients (long duration)\",\"sql\":\"select\\n    p.patient_id\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , fcc.condition_description\\n    , fcc.first_diagnosis_date\\n    , fcc.months_with_condition\\n    , fcc.encounter_count\\n    , fcc.is_active\\nfrom main_marts.fct_condition_cohorts fcc\\njoin main_marts.dim_patients p\\n    on fcc.patient_key = p.patient_key\\nwhere fcc.months_with_condition >= 24\\n    and fcc.is_active = true\\norder by fcc.months_with_condition desc\\nlimit 50\"},{\"description\":\"Find patients with comorbidities for complex care programs\",\"name\":\"Patients with multiple conditions\",\"sql\":\"with patient_condition_counts as (\\n    select\\n        patient_id\\n        , patient_key\\n        , count(distinct condition_code) as condition_count\\n        , sum(case when is_active then 1 else 0 end) as active_condition_count\\n    from main_marts.fct_condition_cohorts\\n    group by 1, 2\\n)\\nselect\\n    p.patient_id\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , pcc.condition_count\\n    , pcc.active_condition_count\\nfrom patient_condition_counts pcc\\njoin main_marts.dim_patients p\\n    on pcc.patient_key = p.patient_key\\nwhere pcc.condition_count >= 3\\norder by pcc.condition_count desc\\nlimit 25\"}]"},{"key":"grain","value":"patient_id + condition_code"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Disease management programs\",\"Cohort identification\",\"Chronic condition tracking\",\"Care gap analysis\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"condition_code","data_type":null,"description":"ICD/SNOMED condition code"},{"name":"condition_cohort_key","data_type":null,"description":"Surrogate key (MD5 hash of patient_id + condition_code)"},{"name":"condition_description","data_type":null,"description":"Full condition name"},{"name":"condition_key","data_type":null,"description":"Foreign key to dim_conditions"},{"name":"encounter_count","data_type":null,"description":"Number of encounters with this condition"},{"name":"first_diagnosis_date","data_type":null,"description":"Date of first diagnosis"},{"name":"first_diagnosis_year","data_type":null,"description":"Year of first diagnosis"},{"name":"is_active","data_type":null,"description":"True if condition has no end date (currently active)"},{"name":"last_diagnosis_date","data_type":null,"description":"Date of most recent diagnosis (null if first occurrence only)"},{"name":"months_with_condition","data_type":null,"description":"Months between first and last diagnosis (0 if single occurrence)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"}],"grain":{"value":"patient_id + condition_code","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"patient_id + condition_code","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"patient_id, condition_code","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_fct_condition_cohorts_patient_id__condition_code.48b30357e0"},{"kind":"unique test","value":"condition_cohort_key","origin":"test.healthcare_analytics.unique_fct_condition_cohorts_condition_cohort_key.f8c8f721d9"}]}},"paths":{"sql":"models/marts/analytics/fct_condition_cohorts.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_cost_analysis","name":"fct_cost_analysis","not_compiled":false,"data_tests":17,"unit_tests":0,"badge":"17 data-tests · 0 unit-tests","detail":{"description":"Detailed cost breakdown for financial analysis and revenue cycle management.\nOne row per encounter with cost allocation details across payer and patient.\nGrain: encounter_id\n\nUse cases:\n- Financial performance reporting\n- Payer mix analysis\n- Patient out-of-pocket tracking\n- Cost driver identification\n- Revenue cycle optimization\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Analyze cost distribution across different insurance payers\",\"name\":\"Cost breakdown by payer\",\"sql\":\"select\\n    py.payer_name\\n    , count(distinct fca.encounter_id) as encounter_count\\n    , round(sum(fca.total_cost), 2) as total_cost\\n    , round(sum(fca.payer_coverage), 2) as total_payer_coverage\\n    , round(sum(fca.patient_responsibility), 2) as total_patient_responsibility\\n    , round(avg(fca.coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_cost_analysis fca\\njoin main_marts.dim_payers py\\n    on fca.payer_key = py.payer_key\\ngroup by py.payer_name\\norder by total_cost desc\"},{\"description\":\"Track cost trends over time for financial forecasting\",\"name\":\"Monthly cost trends\",\"sql\":\"select\\n    strftime(fca.encounter_date, '%Y-%m') as year_month\\n    , count(distinct fca.encounter_id) as encounter_count\\n    , round(sum(fca.total_cost), 2) as total_cost\\n    , round(avg(fca.total_cost), 2) as avg_cost_per_encounter\\n    , round(sum(fca.payer_coverage), 2) as total_payer_coverage\\n    , round(avg(fca.coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_cost_analysis fca\\nwhere fca.year_actual >= 2023\\ngroup by 1\\norder by 1 desc\"},{\"description\":\"Compare costs across different encounter classes\",\"name\":\"Cost by encounter type\",\"sql\":\"select\\n    fca.encounter_class\\n    , count(distinct fca.encounter_id) as encounter_count\\n    , round(sum(fca.total_cost), 2) as total_cost\\n    , round(avg(fca.total_cost), 2) as avg_cost\\n    , round(avg(fca.procedure_count), 2) as avg_procedures\\n    , round(avg(fca.cost_per_procedure), 2) as avg_cost_per_procedure\\n    , round(avg(fca.coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_cost_analysis fca\\ngroup by fca.encounter_class\\norder by total_cost desc\"},{\"description\":\"Identify individual high-cost encounters for review\",\"name\":\"High-cost encounters\",\"sql\":\"select\\n    fca.encounter_id\\n    , fca.encounter_date\\n    , fca.encounter_class\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , py.payer_name\\n    , fca.total_cost\\n    , fca.payer_coverage\\n    , fca.patient_responsibility\\n    , fca.procedure_count\\nfrom main_marts.fct_cost_analysis fca\\njoin main_marts.dim_patients p\\n    on fca.patient_key = p.patient_key\\njoin main_marts.dim_payers py\\n    on fca.payer_key = py.payer_key\\norder by fca.total_cost desc\\nlimit 25\"}]"},{"key":"grain","value":"encounter_id"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Financial reporting\",\"Payer mix analysis\",\"Cost allocation tracking\",\"Revenue cycle management\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"cost_analysis_key","data_type":null,"description":"Surrogate key (MD5 hash of encounter_id)"},{"name":"cost_per_procedure","data_type":null,"description":"Average cost per procedure (null if no procedures)"},{"name":"coverage_pct","data_type":null,"description":"Percentage covered by insurance (0-100)"},{"name":"encounter_class","data_type":null,"description":"Type of encounter (ambulatory, wellness, etc.)"},{"name":"encounter_date","data_type":null,"description":"Date of the encounter"},{"name":"encounter_date_key","data_type":null,"description":"Foreign key to dim_date"},{"name":"encounter_id","data_type":null,"description":"Natural encounter identifier"},{"name":"encounter_key","data_type":null,"description":"Foreign key to fct_encounters"},{"name":"patient_cost_pct","data_type":null,"description":"Percentage owed by patient (0-100)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"},{"name":"patient_responsibility","data_type":null,"description":"Amount owed by patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"payer_id","data_type":null,"description":"Natural payer identifier"},{"name":"payer_key","data_type":null,"description":"Foreign key to dim_payers"},{"name":"procedure_count","data_type":null,"description":"Number of procedures in the encounter"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers"},{"name":"total_cost","data_type":null,"description":"Total claim cost"},{"name":"year_actual","data_type":null,"description":"Calendar year of encounter"}],"grain":{"value":"encounter_id","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"encounter_id","origin":"config.meta.grain"},{"kind":"unique test","value":"cost_analysis_key","origin":"test.healthcare_analytics.unique_fct_cost_analysis_cost_analysis_key.2aecf62159"},{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_fct_cost_analysis_encounter_id.c11ffc0f22"}]}},"paths":{"sql":"models/marts/analytics/fct_cost_analysis.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_encounters","name":"fct_encounters","not_compiled":false,"data_tests":30,"unit_tests":0,"badge":"30 data-tests · 0 unit-tests","detail":{"description":"Encounter fact table containing healthcare visits/encounters. Links to patient, provider, organization, and payer dimensions. Includes date keys, costs, and derived duration.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"base_encounter_cost","data_type":null,"description":"Base cost of the encounter"},{"name":"duration_minutes","data_type":null,"description":"Duration of encounter in minutes"},{"name":"encounter_class","data_type":null,"description":"Type of encounter (ambulatory, wellness, emergency, etc.)"},{"name":"encounter_code","data_type":null,"description":"SNOMED CT code for the encounter type"},{"name":"encounter_description","data_type":null,"description":"Description of the encounter type"},{"name":"encounter_end_at","data_type":null,"description":"End timestamp of the encounter"},{"name":"encounter_end_date_key","data_type":null,"description":"Foreign key to dim_date for encounter end"},{"name":"encounter_id","data_type":null,"description":"Natural encounter identifier (UUID)"},{"name":"encounter_key","data_type":null,"description":"Surrogate key for the encounter"},{"name":"encounter_start_at","data_type":null,"description":"Start timestamp of the encounter"},{"name":"encounter_start_date_key","data_type":null,"description":"Foreign key to dim_date for encounter start"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations (-1 for unknown)"},{"name":"patient_age_at_encounter","data_type":null,"description":"Patient's age at the time of the encounter"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients (-1 for unknown)"},{"name":"patient_responsibility","data_type":null,"description":"Amount patient is responsible for (total_claim_cost - payer_coverage)"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by payer"},{"name":"payer_id","data_type":null,"description":"Natural payer identifier"},{"name":"payer_key","data_type":null,"description":"Foreign key to dim_payers (-1 for unknown)"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers (-1 for unknown)"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of visit"},{"name":"reason_description","data_type":null,"description":"Description of the reason for visit"},{"name":"total_claim_cost","data_type":null,"description":"Total claim cost"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_fct_encounters_encounter_id.ce88bae928"},{"kind":"unique test","value":"encounter_key","origin":"test.healthcare_analytics.unique_fct_encounters_encounter_key.a3b77e9141"}]}},"paths":{"sql":"models/marts/core/fct_encounters.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_encounters_incremental","name":"fct_encounters_incremental","not_compiled":false,"data_tests":2,"unit_tests":1,"badge":"2 data-tests · 1 unit-test","detail":{"description":"Incremental fact table of encounter events. Appends encounters newer than the latest already-loaded start_time via an is_incremental() filter.","materialized":"incremental","tags":[],"meta":[],"columns":[{"name":"encounter_id","data_type":null,"description":"Natural key of the encounter (unique per visit)"},{"name":"encounter_type","data_type":null,"description":"Visit class (wellness, emergency, ...)"},{"name":"patient_id","data_type":null,"description":"Patient the encounter belongs to"},{"name":"start_time","data_type":null,"description":"Encounter start timestamp - the incremental high-water mark"},{"name":"total_cost","data_type":null,"description":"Total claim cost for the encounter"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_fct_encounters_incremental_encounter_id.a165c01d01"}]}},"paths":{"sql":"models/marts/core/fct_encounters_incremental.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[{"name":"test_fct_encounters_incremental_appends_new_encounters","yaml":"models/marts/core/_core__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.fct_encounters_monthly","name":"fct_encounters_monthly","not_compiled":false,"data_tests":17,"unit_tests":0,"badge":"17 data-tests · 0 unit-tests","detail":{"description":"Monthly aggregated encounter statistics by encounter class. Provides counts, costs, and patient metrics grouped by year-month and encounter type.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"avg_duration_minutes","data_type":null,"description":"Average encounter duration in minutes"},{"name":"encounter_class","data_type":null,"description":"Type of encounter"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the month"},{"name":"month_actual","data_type":null,"description":"Month number (1-12)"},{"name":"total_claim_cost","data_type":null,"description":"Sum of total claim costs"},{"name":"total_patient_responsibility","data_type":null,"description":"Sum of patient responsibility amounts"},{"name":"total_payer_coverage","data_type":null,"description":"Sum of payer coverage amounts"},{"name":"unique_patients","data_type":null,"description":"Number of unique patients with encounters"},{"name":"year_actual","data_type":null,"description":"Year number"},{"name":"year_month","data_type":null,"description":"Year-month string (YYYY-MM format)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/marts/core/fct_encounters_monthly.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_encounters_yearly","name":"fct_encounters_yearly","not_compiled":false,"data_tests":14,"unit_tests":0,"badge":"14 data-tests · 0 unit-tests","detail":{"description":"Yearly aggregated encounter statistics by encounter class. Provides counts, costs, patient metrics, and encounters per patient ratio.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"avg_duration_minutes","data_type":null,"description":"Average encounter duration in minutes"},{"name":"encounter_class","data_type":null,"description":"Type of encounter"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the year"},{"name":"encounters_per_patient","data_type":null,"description":"Average number of encounters per patient"},{"name":"total_claim_cost","data_type":null,"description":"Sum of total claim costs"},{"name":"total_patient_responsibility","data_type":null,"description":"Sum of patient responsibility amounts"},{"name":"total_payer_coverage","data_type":null,"description":"Sum of payer coverage amounts"},{"name":"unique_patients","data_type":null,"description":"Number of unique patients with encounters"},{"name":"year_actual","data_type":null,"description":"Year number"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/marts/core/fct_encounters_yearly.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_patient_summary","name":"fct_patient_summary","not_compiled":false,"data_tests":19,"unit_tests":0,"badge":"19 data-tests · 0 unit-tests","detail":{"description":"Annual patient-level aggregations for outcomes tracking and population health analysis.\nOne row per patient per calendar year with comprehensive utilization and cost metrics.\nGrain: (patient_id, year_actual)\n\nUse cases:\n- Patient outcomes tracking over time\n- Annual cost summaries and trends\n- Cohort analysis and patient stratification\n- Health trajectory visualization\n- High-cost patient identification\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Identify high-cost patients for care management programs\",\"name\":\"Top 10 costliest patients by year\",\"sql\":\"select\\n    p.patient_id\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , fps.year_actual\\n    , fps.total_cost\\n    , fps.encounter_count\\n    , fps.condition_count\\n    , fps.payer_coverage_pct\\nfrom main_marts.fct_patient_summary fps\\njoin main_marts.dim_patients p\\n    on fps.patient_key = p.patient_key\\nwhere fps.year_actual = 2024\\norder by fps.total_cost desc\\nlimit 10\"},{\"description\":\"Analyze patient population distribution and costs by age cohort\",\"name\":\"Patient count and cost by age group\",\"sql\":\"select\\n    case\\n        when fps.patient_age_at_year_end < 18 then '0-17'\\n        when fps.patient_age_at_year_end < 35 then '18-34'\\n        when fps.patient_age_at_year_end < 50 then '35-49'\\n        when fps.patient_age_at_year_end < 65 then '50-64'\\n        else '65+'\\n    end as age_group\\n    , count(distinct fps.patient_id) as patient_count\\n    , round(avg(fps.total_cost), 2) as avg_annual_cost\\n    , round(sum(fps.total_cost), 2) as total_cost\\n    , round(avg(fps.encounter_count), 2) as avg_encounters\\nfrom main_marts.fct_patient_summary fps\\nwhere fps.year_actual = 2024\\ngroup by 1\\norder by 1\"},{\"description\":\"Year-over-year comparison of costs and utilization metrics\",\"name\":\"Cost and utilization trends over time\",\"sql\":\"select\\n    fps.year_actual\\n    , count(distinct fps.patient_id) as patient_count\\n    , round(avg(fps.encounter_count), 2) as avg_encounters_per_patient\\n    , round(avg(fps.condition_count), 2) as avg_conditions_per_patient\\n    , round(avg(fps.total_cost), 2) as avg_annual_cost\\n    , round(sum(fps.total_cost), 2) as total_population_cost\\n    , round(avg(fps.payer_coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_patient_summary fps\\ngroup by fps.year_actual\\norder by fps.year_actual desc\"},{\"description\":\"Find patients with above-average encounters and conditions\",\"name\":\"High utilization patients\",\"sql\":\"with averages as (\\n    select\\n        avg(encounter_count) as avg_encounters\\n        , avg(condition_count) as avg_conditions\\n    from main_marts.fct_patient_summary\\n    where year_actual = 2024\\n)\\nselect\\n    fps.patient_id\\n    , fps.encounter_count\\n    , fps.condition_count\\n    , fps.total_cost\\n    , fps.unique_providers\\nfrom main_marts.fct_patient_summary fps\\ncross join averages a\\nwhere fps.year_actual = 2024\\n    and fps.encounter_count > a.avg_encounters * 2\\n    and fps.condition_count > a.avg_conditions\\norder by fps.total_cost desc\\nlimit 25\"}]"},{"key":"grain","value":"patient_id + year_actual"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Population health reporting\",\"Cost and utilization analysis\",\"Patient stratification\",\"Year-over-year trending\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"condition_count","data_type":null,"description":"Number of distinct conditions diagnosed in the year"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the year"},{"name":"patient_age_at_year_end","data_type":null,"description":"Patient age as of December 31 of the year"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"},{"name":"patient_responsibility","data_type":null,"description":"Amount owed by patient (copay + coinsurance)"},{"name":"patient_summary_key","data_type":null,"description":"Surrogate key (MD5 hash of patient_id + year_actual)"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"payer_coverage_pct","data_type":null,"description":"Percentage of costs covered by insurance (0-100)"},{"name":"procedure_count","data_type":null,"description":"Number of procedures in the year"},{"name":"total_cost","data_type":null,"description":"Total claim cost for the year"},{"name":"unique_organizations","data_type":null,"description":"Number of distinct organizations visited"},{"name":"unique_providers","data_type":null,"description":"Number of distinct providers seen"},{"name":"year_actual","data_type":null,"description":"Calendar year of the summary"}],"grain":{"value":"patient_id + year_actual","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"patient_id + year_actual","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"patient_id, year_actual","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_fct_patient_summary_patient_id__year_actual.cdb3418166"},{"kind":"unique test","value":"patient_summary_key","origin":"test.healthcare_analytics.unique_fct_patient_summary_patient_summary_key.e532e1ff45"}]}},"paths":{"sql":"models/marts/analytics/fct_patient_summary.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_provider_metrics","name":"fct_provider_metrics","not_compiled":false,"data_tests":20,"unit_tests":0,"badge":"20 data-tests · 0 unit-tests","detail":{"description":"Monthly provider-level utilization and performance metrics.\nOne row per provider per calendar month with patient volumes, costs, and efficiency metrics.\nGrain: (provider_id, year_actual, month_actual)\n\nUse cases:\n- Provider performance tracking\n- Workload distribution analysis\n- Cost efficiency comparisons\n- Capacity planning and staffing\n- Quality improvement initiatives\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Identify highest-volume providers for capacity planning\",\"name\":\"Top providers by patient volume\",\"sql\":\"select\\n    p.provider_id\\n    , p.name as provider_name\\n    , p.specialty\\n    , sum(fpm.encounter_count) as total_encounters\\n    , sum(fpm.unique_patient_count) as total_patients\\n    , round(avg(fpm.avg_cost_per_encounter), 2) as avg_cost_per_encounter\\nfrom main_marts.fct_provider_metrics fpm\\njoin main_marts.dim_providers p\\n    on fpm.provider_key = p.provider_key\\nwhere fpm.year_actual = 2024\\ngroup by 1, 2, 3\\norder by total_encounters desc\\nlimit 15\"},{\"description\":\"Track provider productivity over time\",\"name\":\"Provider metrics trend by month\",\"sql\":\"select\\n    fpm.year_month_str\\n    , count(distinct fpm.provider_id) as active_providers\\n    , sum(fpm.encounter_count) as total_encounters\\n    , sum(fpm.unique_patient_count) as total_patients\\n    , round(avg(fpm.avg_cost_per_encounter), 2) as avg_cost_per_encounter\\n    , round(avg(fpm.avg_encounter_duration_minutes), 2) as avg_duration_minutes\\nfrom main_marts.fct_provider_metrics fpm\\nwhere fpm.year_actual >= 2023\\ngroup by fpm.year_month_str\\norder by fpm.year_month_str desc\"},{\"description\":\"Compare providers by cost and volume efficiency\",\"name\":\"Provider efficiency comparison\",\"sql\":\"select\\n    p.provider_id\\n    , p.name as provider_name\\n    , p.specialty\\n    , sum(fpm.encounter_count) as total_encounters\\n    , round(sum(fpm.total_cost), 2) as total_cost\\n    , round(avg(fpm.avg_cost_per_encounter), 2) as avg_cost_per_encounter\\n    , round(avg(fpm.encounters_per_patient_avg), 2) as avg_encounters_per_patient\\n    , round(sum(fpm.total_procedures) * 1.0 / sum(fpm.encounter_count), 2) as procedures_per_encounter\\nfrom main_marts.fct_provider_metrics fpm\\njoin main_marts.dim_providers p\\n    on fpm.provider_key = p.provider_key\\nwhere fpm.year_actual = 2024\\ngroup by 1, 2, 3\\nhaving sum(fpm.encounter_count) >= 10\\norder by avg_cost_per_encounter\"}]"},{"key":"grain","value":"provider_id + year_month_str"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Provider productivity reporting\",\"Workload balancing\",\"Cost efficiency analysis\",\"Capacity planning\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"avg_cost_per_encounter","data_type":null,"description":"Average cost per encounter"},{"name":"avg_encounter_duration_minutes","data_type":null,"description":"Average encounter duration in minutes"},{"name":"avg_patient_age","data_type":null,"description":"Average age of patients seen"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the month"},{"name":"encounters_per_patient_avg","data_type":null,"description":"Average encounters per patient"},{"name":"month_actual","data_type":null,"description":"Calendar month (1-12)"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers"},{"name":"provider_metrics_key","data_type":null,"description":"Surrogate key (MD5 hash of provider_id + year_month_str)"},{"name":"total_cost","data_type":null,"description":"Total claim cost for the month"},{"name":"total_payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"total_procedures","data_type":null,"description":"Total procedures performed"},{"name":"unique_patient_count","data_type":null,"description":"Number of distinct patients seen"},{"name":"year_actual","data_type":null,"description":"Calendar year"},{"name":"year_month_str","data_type":null,"description":"Year-month string (YYYY-MM)"}],"grain":{"value":"provider_id + year_month_str","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"provider_id + year_month_str","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"provider_id, year_actual, month_actual","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_fct_provider_metrics_provider_id__year_actual__month_actual.a5b2cee14a"},{"kind":"unique test","value":"provider_metrics_key","origin":"test.healthcare_analytics.unique_fct_provider_metrics_provider_metrics_key.d58939d602"}]}},"paths":{"sql":"models/marts/analytics/fct_provider_metrics.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_dq_quarantine__encounters","name":"int_dq_quarantine__encounters","not_compiled":false,"data_tests":5,"unit_tests":0,"badge":"5 data-tests · 0 unit-tests","detail":{"description":"Encounters that failed data quality validations and are excluded from downstream marts.\n\nRecords are quarantined when any of the following validations fail:\n- valid_encounter_timestamps: encounter_end_at >= encounter_start_at\n- no_future_encounter_dates: encounter_start_at <= current_timestamp\n- end_after_1900: encounter_end_at >= timestamp '1900-01-01'\n- start_after_1900: encounter_start_at >= timestamp '1900-01-01'\n\nThis table preserves data quality violations for investigation without polluting fact tables.\n","materialized":"table","tags":["intermediate","quarantine","data_quality"],"meta":[],"columns":[{"name":"encounter_id","data_type":null,"description":"Natural key for the encounter (from source system)"},{"name":"end_after_1900","data_type":null,"description":"Flag: encounter_end_at >= timestamp '1900-01-01'"},{"name":"failed_dq_tests","data_type":null,"description":"Array of failed validation test names"},{"name":"is_dq_valid","data_type":null,"description":"Data quality validity flag - should always be false in quarantine"},{"name":"no_future_encounter_dates","data_type":null,"description":"Flag: encounter_start_at <= current_timestamp"},{"name":"start_after_1900","data_type":null,"description":"Flag: encounter_start_at >= timestamp '1900-01-01'"},{"name":"valid_encounter_timestamps","data_type":null,"description":"Flag: encounter_end_at >= encounter_start_at"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_int_dq_quarantine__encounters_encounter_id.31321ef55a"}]}},"paths":{"sql":"models/intermediate/quarantine/int_dq_quarantine__encounters.sql","schema_yaml":"models/intermediate/quarantine/_quarantine__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_dq_quarantine__medications","name":"int_dq_quarantine__medications","not_compiled":false,"data_tests":5,"unit_tests":0,"badge":"5 data-tests · 0 unit-tests","detail":{"description":"Medications that failed data quality validations and are excluded from downstream marts.\n\nRecords are quarantined when any of the following validations fail:\n- valid_medication_dates: medication_end_at is null or medication_end_at >= medication_start_at\n- no_future_medication_dates: cast(medication_start_at as date) <= current_date\n- start_after_1900: medication_start_at >= timestamp '1900-01-01'\n- end_after_1900_if_present: medication_end_at is null or medication_end_at >= timestamp '1900-01-01'\n\nThis table preserves data quality violations for investigation without polluting fact tables.\n","materialized":"table","tags":["intermediate","quarantine","data_quality"],"meta":[],"columns":[{"name":"end_after_1900_if_present","data_type":null,"description":"Flag: medication_end_at is null or medication_end_at >= timestamp '1900-01-01'"},{"name":"failed_dq_tests","data_type":null,"description":"Array of failed validation test names"},{"name":"is_dq_valid","data_type":null,"description":"Data quality validity flag - should always be false in quarantine"},{"name":"medication_id","data_type":null,"description":"Surrogate key for the medication record"},{"name":"no_future_medication_dates","data_type":null,"description":"Flag: cast(medication_start_at as date) <= current_date"},{"name":"start_after_1900","data_type":null,"description":"Flag: medication_start_at >= timestamp '1900-01-01'"},{"name":"valid_medication_dates","data_type":null,"description":"Flag: medication_end_at is null or medication_end_at >= medication_start_at"}],"grain":{"value":"medication_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"medication_id","origin":"test.healthcare_analytics.unique_int_dq_quarantine__medications_medication_id.06d855118f"}]}},"paths":{"sql":"models/intermediate/quarantine/int_dq_quarantine__medications.sql","schema_yaml":"models/intermediate/quarantine/_quarantine__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_encounters__enriched","name":"int_encounters__enriched","not_compiled":false,"data_tests":19,"unit_tests":0,"badge":"19 data-tests · 0 unit-tests","detail":{"description":"Enriched encounter model that aggregates clinical event counts and costs per encounter. Joins conditions, medications, and procedures to provide a complete view of each encounter's clinical activity and associated costs.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"condition_count","data_type":null,"description":"Number of conditions diagnosed during this encounter"},{"name":"encounter_id","data_type":null,"description":"Unique encounter identifier (UUID), sourced from fct_encounters"},{"name":"medication_count","data_type":null,"description":"Number of medications prescribed during this encounter"},{"name":"procedure_count","data_type":null,"description":"Number of procedures performed during this encounter"},{"name":"total_condition_cost","data_type":null,"description":"Total cost associated with conditions (currently always 0 per model logic)"},{"name":"total_event_cost","data_type":null,"description":"Total cost of all clinical events (conditions + medications + procedures). Note: Condition costs are currently set to 0 in the model.\n"},{"name":"total_event_count","data_type":null,"description":"Total count of all clinical events (conditions + medications + procedures)"},{"name":"total_medication_cost","data_type":null,"description":"Total cost of medications prescribed during this encounter"},{"name":"total_procedure_cost","data_type":null,"description":"Total cost of procedures performed during this encounter"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_int_encounters__enriched_encounter_id.fdad6d4f82"}]}},"paths":{"sql":"models/intermediate/healthcare/int_encounters__enriched.sql","schema_yaml":"models/intermediate/healthcare/_healthcare__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_patients__never_admitted","name":"int_patients__never_admitted","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"0 data-tests · 0 unit-tests","detail":{"description":"Patients with no encounter on record — the correlated NOT EXISTS anti-join idiom (cute-dbt#196 dogfood). Deliberately carries no unit test so the golden report shows the join.anti-join finding UNCOVERED with its inverted (matching-row) given sketch.","materialized":"table","tags":["intermediate","anti_join"],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/intermediate/int_patients__never_admitted.sql","schema_yaml":null,"unit_tests":[]}},{"id":"model.healthcare_analytics.int_patients__with_conditions","name":"int_patients__with_conditions","not_compiled":false,"data_tests":17,"unit_tests":0,"badge":"17 data-tests · 0 unit-tests","detail":{"description":"Patient-level condition history with aggregated statistics and chronic disease flags. Provides counts of total and active conditions, condition date ranges, and boolean flags for common chronic conditions (diabetes, hypertension, heart disease).\nIMPORTANT: Chronic condition flags use simplified text matching on condition descriptions. This is for analytics/reporting only, not clinical decisions.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"active_conditions","data_type":null,"description":"Number of currently active conditions (no end date)"},{"name":"chronic_condition_count","data_type":null,"description":"Count of tracked chronic conditions (0-3, based on diabetes + hypertension + heart disease flags)"},{"name":"first_condition_date","data_type":null,"description":"Date of earliest condition diagnosis for this patient"},{"name":"has_diabetes","data_type":null,"description":"Boolean flag indicating if patient has any diabetes-related condition"},{"name":"has_heart_disease","data_type":null,"description":"Boolean flag indicating if patient has any heart disease condition"},{"name":"has_hypertension","data_type":null,"description":"Boolean flag indicating if patient has hypertension or high blood pressure"},{"name":"last_condition_date","data_type":null,"description":"Date of most recent condition diagnosis for this patient"},{"name":"patient_id","data_type":null,"description":"Unique patient identifier (UUID), sourced from current dim_patients records"},{"name":"total_conditions","data_type":null,"description":"Total number of conditions ever diagnosed for this patient"}],"grain":{"value":"patient_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"patient_id","origin":"test.healthcare_analytics.unique_int_patients__with_conditions_patient_id.dbb08a220b"}]}},"paths":{"sql":"models/intermediate/healthcare/int_patients__with_conditions.sql","schema_yaml":"models/intermediate/healthcare/_healthcare__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.mart_date_state_grid","name":"mart_date_state_grid","not_compiled":false,"data_tests":5,"unit_tests":1,"badge":"5 data-tests · 1 unit-test","detail":{"description":"Dense month x state reporting scaffold.\nOne row per (calendar month x patient state) combination — the full\ncartesian product of dim_date months and the non-null states observed\nin patient staging. Left-join sparse activity facts against this grid\nso zero-activity cells render as explicit zeros.\nGrain: month_key x state\n\nUse cases:\n- Dense time-series dashboards (no missing month/state cells)\n- Zero-activity gap detection\n- cute-dbt cross-join CTE-edge demo (cute-dbt#64)\n","materialized":"table","tags":["analytics","reporting","marts"],"meta":[{"key":"grain","value":"month_key x state"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Dense reporting grids\",\"Zero-activity gap detection\"]"}],"columns":[{"name":"month_actual","data_type":null,"description":"Calendar month number (1-12) of the grid cell"},{"name":"month_key","data_type":null,"description":"Month surrogate key in YYYYMM integer form (e.g., 202401)"},{"name":"month_name","data_type":null,"description":"Full month name (e.g., January)"},{"name":"state","data_type":null,"description":"Patient state, distinct and non-null from staging"},{"name":"year_actual","data_type":null,"description":"Calendar year of the grid cell"}],"grain":{"value":"month_key x state","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"month_key x state","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"month_key, state","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_mart_date_state_grid_month_key__state.507f3592d3"}]}},"paths":{"sql":"models/marts/analytics/mart_date_state_grid.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[{"name":"test_mart_date_state_grid_cross_joins_months_and_states","yaml":"models/marts/analytics/_analytics__models.yml","fixtures":["tests/fixtures/mart_date_state_grid_patients.csv"]}]}},{"id":"model.healthcare_analytics.mart_dq_summary","name":"mart_dq_summary","not_compiled":false,"data_tests":5,"unit_tests":2,"badge":"5 data-tests · 2 unit-tests","detail":{"description":"Data quality summary metrics for monitoring quarantine rates and validation failures.\nOne row per entity type (encounters, medications) with quarantine counts and failure breakdowns.\nGrain: entity_type\n\nUse cases:\n- Data quality monitoring dashboards\n- Quarantine rate trending\n- Validation failure root cause analysis\n- Data quality SLA tracking\n","materialized":"table","tags":["analytics","data_quality","marts"],"meta":[{"key":"grain","value":"entity_type"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Data quality dashboards\",\"Quarantine monitoring\",\"Data quality alerting\"]"}],"columns":[{"name":"_generated_at","data_type":null,"description":"Timestamp when summary was generated"},{"name":"entity_type","data_type":null,"description":"Type of entity being measured (encounters, medications)"},{"name":"failed_future_date_validations","data_type":null,"description":"Count of records with future dates"},{"name":"failed_historical_end_validations","data_type":null,"description":"Count of records with end dates before 1900"},{"name":"failed_historical_start_validations","data_type":null,"description":"Count of records with start dates before 1900"},{"name":"failed_timestamp_validations","data_type":null,"description":"Count of records failing timestamp/date sequence validations"},{"name":"quarantine_rate_pct","data_type":null,"description":"Percentage of records quarantined (quarantined_count / total_count * 100)"},{"name":"quarantined_count","data_type":null,"description":"Number of records failing data quality validations"},{"name":"total_count","data_type":null,"description":"Total number of records (valid + quarantined)"}],"grain":{"value":"entity_type","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"entity_type","origin":"config.meta.grain"}]}},"paths":{"sql":"models/marts/analytics/mart_dq_summary.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[{"name":"test_mart_dq_summary_combines_encounter_and_medication_metrics","yaml":"models/marts/analytics/_analytics__models.yml","fixtures":[]},{"name":"test_mart_dq_summary_zero_quarantined_when_all_valid","yaml":"models/marts/analytics/_analytics__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.stg_synthea__conditions","name":"stg_synthea__conditions","not_compiled":false,"data_tests":12,"unit_tests":0,"badge":"12 data-tests · 0 unit-tests","detail":{"description":"Staging model for patient conditions/diagnoses. One row per condition instance with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"condition_code","data_type":null,"description":"SNOMED CT code for the condition"},{"name":"condition_description","data_type":null,"description":"Description of the condition"},{"name":"condition_end_date","data_type":null,"description":"Date when condition resolved (null if ongoing)"},{"name":"condition_id","data_type":null,"description":"Surrogate key for the condition record"},{"name":"condition_start_date","data_type":null,"description":"Date when condition was diagnosed"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"}],"grain":{"value":"condition_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"condition_id","origin":"test.healthcare_analytics.unique_stg_synthea__conditions_condition_id.46692af443"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__conditions.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__encounters","name":"stg_synthea__encounters","not_compiled":false,"data_tests":19,"unit_tests":0,"badge":"19 data-tests · 0 unit-tests","detail":{"description":"Staging model for healthcare encounters/visits. One row per encounter with patient, provider, organization, and payer relationships.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"base_encounter_cost","data_type":null,"description":"Base cost of the encounter"},{"name":"encounter_class","data_type":null,"description":"Type of encounter (ambulatory, wellness, emergency, etc.)"},{"name":"encounter_code","data_type":null,"description":"SNOMED CT code for the encounter type"},{"name":"encounter_description","data_type":null,"description":"Description of the encounter type"},{"name":"encounter_end_at","data_type":null,"description":"End timestamp of the encounter"},{"name":"encounter_id","data_type":null,"description":"Unique encounter identifier (UUID)"},{"name":"encounter_start_at","data_type":null,"description":"Start timestamp of the encounter"},{"name":"organization_id","data_type":null,"description":"Foreign key to the organization"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by payer"},{"name":"payer_id","data_type":null,"description":"Foreign key to the payer"},{"name":"provider_id","data_type":null,"description":"Foreign key to the provider"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of visit"},{"name":"reason_description","data_type":null,"description":"Description of the reason for visit"},{"name":"total_claim_cost","data_type":null,"description":"Total claim cost"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_stg_synthea__encounters_encounter_id.12bf18bf09"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__encounters.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__medications","name":"stg_synthea__medications","not_compiled":false,"data_tests":18,"unit_tests":0,"badge":"18 data-tests · 0 unit-tests","detail":{"description":"Staging model for prescribed medications. One row per medication prescription with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"base_cost","data_type":null,"description":"Base cost per dispense"},{"name":"dispenses","data_type":null,"description":"Number of times medication was dispensed"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter"},{"name":"medication_code","data_type":null,"description":"RxNorm code for the medication"},{"name":"medication_description","data_type":null,"description":"Description of the medication"},{"name":"medication_end_at","data_type":null,"description":"Timestamp when medication ended (null if ongoing)"},{"name":"medication_id","data_type":null,"description":"Surrogate key for the medication record"},{"name":"medication_start_at","data_type":null,"description":"Timestamp when medication was prescribed"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by payer"},{"name":"payer_id","data_type":null,"description":"Foreign key to the payer"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of medication"},{"name":"reason_description","data_type":null,"description":"Description of the reason for medication"},{"name":"total_cost","data_type":null,"description":"Total cost of all dispenses"}],"grain":{"value":"medication_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"medication_id","origin":"test.healthcare_analytics.unique_stg_synthea__medications_medication_id.eb3ad4ae13"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__medications.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__observations","name":"stg_synthea__observations","not_compiled":false,"data_tests":10,"unit_tests":0,"badge":"10 data-tests · 0 unit-tests","detail":{"description":"Staging model for clinical observations (vital signs, lab results). One row per observation with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter. Note: ~10% of observations have null encounter_id (from external sources or historical data imports).\n"},{"name":"observation_at","data_type":null,"description":"Timestamp when observation was recorded"},{"name":"observation_code","data_type":null,"description":"LOINC code for the observation"},{"name":"observation_description","data_type":null,"description":"Description of the observation"},{"name":"observation_id","data_type":null,"description":"Surrogate key for the observation record"},{"name":"observation_type","data_type":null,"description":"Type of observation (numeric, text, etc.)"},{"name":"observation_value","data_type":null,"description":"Value of the observation (stored as string)"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"units","data_type":null,"description":"Units of measurement"}],"grain":{"value":"observation_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"observation_id","origin":"test.healthcare_analytics.unique_stg_synthea__observations_observation_id.c28ceeac85"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__observations.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__organizations","name":"stg_synthea__organizations","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Staging model for healthcare organizations/facilities. One row per organization with location and performance metrics.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Unique organization identifier (UUID)"},{"name":"organization_name","data_type":null,"description":"Name of the healthcare organization"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"organization_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"organization_id","origin":"test.healthcare_analytics.unique_stg_synthea__organizations_organization_id.23afabbc76"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__organizations.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__patients","name":"stg_synthea__patients","not_compiled":false,"data_tests":14,"unit_tests":1,"badge":"14 data-tests · 1 unit-test","detail":{"description":"Staging model for patient demographics and identifiers. One row per patient with personal information, location, and financial data.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"birth_date","data_type":null,"description":"Patient date of birth"},{"name":"birth_place","data_type":null,"description":"Place of birth"},{"name":"city","data_type":null,"description":"City of residence"},{"name":"county","data_type":null,"description":"County of residence"},{"name":"death_date","data_type":null,"description":"Patient date of death (null if alive)"},{"name":"drivers_license","data_type":null,"description":"Driver's license number"},{"name":"ethnicity","data_type":null,"description":"Patient ethnicity (hispanic or nonhispanic)"},{"name":"first_name","data_type":null,"description":"Patient's first name"},{"name":"gender","data_type":null,"description":"Patient gender (M or F)"},{"name":"healthcare_coverage","data_type":null,"description":"Total healthcare coverage received"},{"name":"healthcare_expenses","data_type":null,"description":"Total healthcare expenses incurred"},{"name":"last_name","data_type":null,"description":"Patient's last name"},{"name":"latitude","data_type":null,"description":"Latitude coordinate of residence"},{"name":"longitude","data_type":null,"description":"Longitude coordinate of residence"},{"name":"maiden_name","data_type":null,"description":"Maiden name (if applicable)"},{"name":"marital_status","data_type":null,"description":"Marital status (M=Married, S=Single, or blank)"},{"name":"name_prefix","data_type":null,"description":"Name prefix (Mr., Mrs., Ms., etc.)"},{"name":"name_suffix","data_type":null,"description":"Name suffix (Jr., Sr., III, etc.)"},{"name":"passport_number","data_type":null,"description":"Passport number"},{"name":"patient_id","data_type":null,"description":"Unique patient identifier (UUID)"},{"name":"race","data_type":null,"description":"Patient race"},{"name":"ssn_hash","data_type":null,"description":"MD5 hash of Social Security Number (masked for privacy)"},{"name":"state","data_type":null,"description":"State of residence (full state name, e.g., Massachusetts)"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"patient_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"patient_id","origin":"test.healthcare_analytics.unique_stg_synthea__patients_patient_id.ee61748f4d"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__patients.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[{"name":"test_stg_synthea__patients_renames_and_hashes_source_columns","yaml":"models/staging/synthea/_synthea__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.stg_synthea__payers","name":"stg_synthea__payers","not_compiled":false,"data_tests":6,"unit_tests":0,"badge":"6 data-tests · 0 unit-tests","detail":{"description":"Staging model for insurance payers. One row per payer with contact information and aggregate metrics.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"amount_covered","data_type":null,"description":"Total amount covered by payer"},{"name":"amount_uncovered","data_type":null,"description":"Total amount not covered by payer"},{"name":"average_quality_of_life_score","data_type":null,"description":"Average quality of life score for members"},{"name":"city","data_type":null,"description":"City"},{"name":"covered_encounters","data_type":null,"description":"Number of encounters covered"},{"name":"covered_immunizations","data_type":null,"description":"Number of immunizations covered"},{"name":"covered_medications","data_type":null,"description":"Number of medications covered"},{"name":"covered_procedures","data_type":null,"description":"Number of procedures covered"},{"name":"member_months","data_type":null,"description":"Total member months"},{"name":"payer_id","data_type":null,"description":"Unique payer identifier (UUID)"},{"name":"payer_name","data_type":null,"description":"Name of the insurance payer"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue collected"},{"name":"state","data_type":null,"description":"State where headquartered"},{"name":"uncovered_encounters","data_type":null,"description":"Number of encounters not covered"},{"name":"uncovered_immunizations","data_type":null,"description":"Number of immunizations not covered"},{"name":"uncovered_medications","data_type":null,"description":"Number of medications not covered"},{"name":"uncovered_procedures","data_type":null,"description":"Number of procedures not covered"},{"name":"unique_customers","data_type":null,"description":"Number of unique customers"},{"name":"zip_code","data_type":null,"description":"ZIP code (stored as numeric, 5 digits)"}],"grain":{"value":"payer_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"payer_id","origin":"test.healthcare_analytics.unique_stg_synthea__payers_payer_id.31542848ee"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__payers.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__procedures","name":"stg_synthea__procedures","not_compiled":false,"data_tests":12,"unit_tests":0,"badge":"12 data-tests · 0 unit-tests","detail":{"description":"Staging model for medical procedures performed. One row per procedure instance with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"base_cost","data_type":null,"description":"Base cost of the procedure"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"procedure_at","data_type":null,"description":"Timestamp when the procedure was performed"},{"name":"procedure_code","data_type":null,"description":"SNOMED CT code for the procedure"},{"name":"procedure_description","data_type":null,"description":"Description of the procedure"},{"name":"procedure_id","data_type":null,"description":"Surrogate key for the procedure record"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of the procedure"},{"name":"reason_description","data_type":null,"description":"Description of the reason for the procedure"}],"grain":{"value":"procedure_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"procedure_id","origin":"test.healthcare_analytics.unique_stg_synthea__procedures_procedure_id.73412d7f5a"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__procedures.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__providers","name":"stg_synthea__providers","not_compiled":false,"data_tests":11,"unit_tests":0,"badge":"11 data-tests · 0 unit-tests","detail":{"description":"Staging model for healthcare providers (doctors, nurses, etc.). One row per provider with specialization and affiliated organization.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"gender","data_type":null,"description":"Provider gender (M or F)"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Foreign key to the provider's organization"},{"name":"provider_id","data_type":null,"description":"Unique provider identifier (UUID)"},{"name":"provider_name","data_type":null,"description":"Full name of the provider"},{"name":"specialty","data_type":null,"description":"Medical specialty"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"provider_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"provider_id","origin":"test.healthcare_analytics.unique_stg_synthea__providers_provider_id.4cb7d0e670"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__providers.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.v_encounter_summary","name":"v_encounter_summary","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"0 data-tests · 0 unit-tests","detail":{"description":"Enriched encounter view with dimension attributes for ad-hoc analysis.\nEphemeral (not persisted) - used as a building block for other queries.\nJoins encounters with patient, provider, organization, and payer details.\n\nUse cases:\n- Ad-hoc encounter analysis\n- Building block for custom reports\n- Quick encounter lookups with full context\n","materialized":"ephemeral","tags":["analytics","marts","view"],"meta":[],"columns":[{"name":"encounter_class","data_type":null,"description":"Type of encounter"},{"name":"encounter_date","data_type":null,"description":"Date of the encounter"},{"name":"encounter_id","data_type":null,"description":"Unique encounter identifier"},{"name":"organization_id","data_type":null,"description":"Organization identifier"},{"name":"organization_name","data_type":null,"description":"Organization name"},{"name":"patient_id","data_type":null,"description":"Patient identifier"},{"name":"patient_name","data_type":null,"description":"Full patient name"},{"name":"patient_responsibility","data_type":null,"description":"Amount owed by patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"payer_id","data_type":null,"description":"Payer identifier"},{"name":"payer_name","data_type":null,"description":"Payer name"},{"name":"provider_id","data_type":null,"description":"Provider identifier"},{"name":"provider_name","data_type":null,"description":"Full provider name"},{"name":"total_cost","data_type":null,"description":"Total claim cost"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/marts/analytics/views/v_encounter_summary.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.v_patient_current_conditions","name":"v_patient_current_conditions","not_compiled":false,"data_tests":1,"unit_tests":0,"badge":"1 data-test · 0 unit-tests","detail":{"description":"Current (active) conditions for each patient, filtered from fct_condition_cohorts.\nUse for patient panels, disease management dashboards, and care gap identification.\nGrain: (patient_id, condition_code) - only active conditions\n\nUse cases:\n- Patient panel management\n- Active disease registries\n- Care gap identification\n- Real-time patient condition views\n","materialized":"table","tags":["analytics","marts","view"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Get all active conditions for a specific patient\",\"name\":\"Patient active conditions lookup\",\"sql\":\"select\\n    vpcc.patient_id\\n    , vpcc.condition_code\\n    , vpcc.condition_description\\n    , vpcc.first_diagnosis_date\\n    , vpcc.months_with_condition\\n    , vpcc.encounter_count\\nfrom main_marts.v_patient_current_conditions vpcc\\nwhere vpcc.patient_id = 'patient-uuid-here'\\norder by vpcc.first_diagnosis_date\"},{\"description\":\"Count of patients by active condition for disease registries\",\"name\":\"Active condition summary\",\"sql\":\"select\\n    vpcc.condition_code\\n    , vpcc.condition_description\\n    , count(distinct vpcc.patient_id) as active_patient_count\\n    , round(avg(vpcc.months_with_condition), 1) as avg_duration_months\\n    , round(avg(vpcc.encounter_count), 1) as avg_encounters\\nfrom main_marts.v_patient_current_conditions vpcc\\ngroup by 1, 2\\norder by active_patient_count desc\\nlimit 20\"}]"},{"key":"grain","value":"patient_id + condition_code"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Patient panel displays\",\"Active condition registries\",\"Care gap dashboards\"]"}],"columns":[{"name":"condition_code","data_type":null,"description":"ICD/SNOMED condition code"},{"name":"condition_description","data_type":null,"description":"Full condition name"},{"name":"condition_key","data_type":null,"description":"Foreign key to dim_conditions"},{"name":"encounter_count","data_type":null,"description":"Number of encounters with this condition"},{"name":"first_diagnosis_date","data_type":null,"description":"Date of first diagnosis"},{"name":"months_with_condition","data_type":null,"description":"Duration of condition in months"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"}],"grain":{"value":"patient_id + condition_code","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"patient_id + condition_code","origin":"config.meta.grain"}]}},"paths":{"sql":"models/marts/analytics/views/v_patient_current_conditions.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.v_provider_active_patients","name":"v_provider_active_patients","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Active patient count per provider for panel management and workload analysis.\nAggregates patients with active conditions by their treating provider.\nGrain: provider_id\n\nUse cases:\n- Provider panel size management\n- Workload distribution analysis\n- Capacity planning\n- Provider assignment optimization\n","materialized":"table","tags":["analytics","marts","view"],"meta":[{"key":"example_queries","value":"[{\"description\":\"View provider workload by active patient and condition counts\",\"name\":\"Provider panel sizes\",\"sql\":\"select\\n    vpap.provider_id\\n    , vpap.provider_name\\n    , vpap.active_patient_count\\n    , vpap.total_active_conditions\\n    , vpap.avg_conditions_per_patient\\nfrom main_marts.v_provider_active_patients vpap\\nwhere vpap.active_patient_count > 0\\norder by vpap.active_patient_count desc\\nlimit 25\"},{\"description\":\"Analyze distribution of patient panels across providers\",\"name\":\"Provider workload distribution\",\"sql\":\"select\\n    case\\n        when vpap.active_patient_count = 0 then '0'\\n        when vpap.active_patient_count <= 10 then '1-10'\\n        when vpap.active_patient_count <= 50 then '11-50'\\n        when vpap.active_patient_count <= 100 then '51-100'\\n        else '100+'\\n    end as panel_size_bucket\\n    , count(*) as provider_count\\n    , sum(vpap.active_patient_count) as total_patients\\nfrom main_marts.v_provider_active_patients vpap\\ngroup by 1\\norder by 1\"}]"},{"key":"grain","value":"provider_id"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Provider panel management\",\"Workload balancing\",\"Capacity planning\"]"}],"columns":[{"name":"active_patient_count","data_type":null,"description":"Number of patients with active conditions"},{"name":"avg_conditions_per_patient","data_type":null,"description":"Average number of active conditions per patient"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers"},{"name":"provider_name","data_type":null,"description":"Full name of the provider"},{"name":"total_active_conditions","data_type":null,"description":"Total number of active conditions managed"}],"grain":{"value":"provider_id","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"provider_id","origin":"config.meta.grain"},{"kind":"unique test","value":"provider_id","origin":"test.healthcare_analytics.unique_v_provider_active_patients_provider_id.68f4dd3a27"},{"kind":"unique test","value":"provider_key","origin":"test.healthcare_analytics.unique_v_provider_active_patients_provider_key.95907c77fb"}]}},"paths":{"sql":"models/marts/analytics/views/v_provider_active_patients.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}}],"edges":[{"from":"model.healthcare_analytics.dim_conditions","to":"model.healthcare_analytics.fct_condition_cohorts"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_cost_analysis"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_encounters_monthly"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_encounters_yearly"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_provider_metrics"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.mart_date_state_grid"},{"from":"model.healthcare_analytics.dim_organizations","to":"model.healthcare_analytics.dim_providers"},{"from":"model.healthcare_analytics.dim_organizations","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_organizations","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.fct_condition_cohorts"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.int_patients__with_conditions"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_payers","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_payers","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_providers","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_providers","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_providers","to":"model.healthcare_analytics.v_provider_active_patients"},{"from":"model.healthcare_analytics.fct_condition_cohorts","to":"model.healthcare_analytics.v_patient_current_conditions"},{"from":"model.healthcare_analytics.fct_condition_cohorts","to":"model.healthcare_analytics.v_provider_active_patients"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_cost_analysis"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_encounters_monthly"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_encounters_yearly"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_provider_metrics"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.v_provider_active_patients"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.dim_conditions"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.fct_condition_cohorts"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.int_patients__with_conditions"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.fct_encounters_incremental"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.int_dq_quarantine__encounters"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.int_patients__never_admitted"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.mart_dq_summary"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.int_dq_quarantine__medications"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.mart_dq_summary"},{"from":"model.healthcare_analytics.stg_synthea__organizations","to":"model.healthcare_analytics.dim_organizations"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"model.healthcare_analytics.dim_patients"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"model.healthcare_analytics.int_patients__never_admitted"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"model.healthcare_analytics.mart_date_state_grid"},{"from":"model.healthcare_analytics.stg_synthea__payers","to":"model.healthcare_analytics.dim_payers"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_cost_analysis"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_provider_metrics"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.stg_synthea__providers","to":"model.healthcare_analytics.dim_providers"}],"cte_dags":{"model.healthcare_analytics.dim_conditions":{"nodes":[{"id":"conditions_source","role":"import"},{"id":"condition_aggregates","role":"transform"},{"id":"deduped","role":"transform"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_conditions.sql","role":"final"}],"edges":[{"from":"conditions_source","to":"condition_aggregates","edge_type":"from"},{"from":"condition_aggregates","to":"deduped","edge_type":"from"},{"from":"deduped","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_date":{"nodes":[{"id":"date_spine","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_date.sql","role":"final"}],"edges":[{"from":"date_spine","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_organizations":{"nodes":[{"id":"source","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_organizations.sql","role":"final"}],"edges":[{"from":"source","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_patients":{"nodes":[{"id":"snapshot_source","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_patients.sql","role":"final"}],"edges":[{"from":"snapshot_source","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_payers":{"nodes":[{"id":"source","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_payers.sql","role":"final"}],"edges":[{"from":"source","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_providers":{"nodes":[{"id":"providers","role":"import"},{"id":"organizations","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_providers.sql","role":"final"}],"edges":[{"from":"providers","to":"sequenced","edge_type":"from"},{"from":"organizations","to":"sequenced","edge_type":"left"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_clinical_events":{"nodes":[{"id":"valid_encounters","role":"import"},{"id":"conditions","role":"import"},{"id":"medications","role":"import"},{"id":"procedures","role":"import"},{"id":"all_events","role":"transform"},{"id":"patients","role":"import"},{"id":"dim_date","role":"import"},{"id":"encounters","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_clinical_events.sql","role":"final"}],"edges":[{"from":"conditions","to":"all_events","edge_type":"union_all"},{"from":"medications","to":"all_events","edge_type":"union_all"},{"from":"procedures","to":"all_events","edge_type":"union_all"},{"from":"all_events","to":"final","edge_type":"from"},{"from":"patients","to":"final","edge_type":"left"},{"from":"encounters","to":"final","edge_type":"left"},{"from":"dim_date","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_condition_cohorts":{"nodes":[{"id":"conditions_source","role":"import"},{"id":"patients","role":"import"},{"id":"dim_conditions","role":"import"},{"id":"condition_windows","role":"transform"},{"id":"with_dimensions","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_condition_cohorts.sql","role":"final"}],"edges":[{"from":"conditions_source","to":"condition_windows","edge_type":"from"},{"from":"condition_windows","to":"with_dimensions","edge_type":"from"},{"from":"patients","to":"with_dimensions","edge_type":"left"},{"from":"dim_conditions","to":"with_dimensions","edge_type":"left"},{"from":"with_dimensions","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_cost_analysis":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"procedures","role":"import"},{"id":"encounters_enriched","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_cost_analysis.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_enriched","edge_type":"from"},{"from":"dim_date","to":"encounters_enriched","edge_type":"left"},{"from":"procedures","to":"encounters_enriched","edge_type":"left"},{"from":"encounters_enriched","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters":{"nodes":[{"id":"encounters","role":"import"},{"id":"patients","role":"import"},{"id":"providers","role":"import"},{"id":"organizations","role":"import"},{"id":"payers","role":"import"},{"id":"dim_date","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_encounters.sql","role":"final"}],"edges":[{"from":"encounters","to":"final","edge_type":"from"},{"from":"patients","to":"final","edge_type":"left"},{"from":"providers","to":"final","edge_type":"left"},{"from":"organizations","to":"final","edge_type":"left"},{"from":"payers","to":"final","edge_type":"left"},{"from":"dim_date","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters_incremental":{"nodes":[{"id":"source","role":"import"},{"id":"(final select)","label":"fct_encounters_incremental.sql","role":"final"}],"edges":[{"from":"source","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters_monthly":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"encounters_with_date","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_encounters_monthly.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_date","edge_type":"from"},{"from":"dim_date","to":"encounters_with_date","edge_type":"inner"},{"from":"encounters_with_date","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters_yearly":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"encounters_with_date","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_encounters_yearly.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_date","edge_type":"from"},{"from":"dim_date","to":"encounters_with_date","edge_type":"inner"},{"from":"encounters_with_date","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_patient_summary":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"procedures","role":"import"},{"id":"conditions","role":"import"},{"id":"encounters_with_year","role":"transform"},{"id":"conditions_per_patient_year","role":"transform"},{"id":"patient_year_agg","role":"transform"},{"id":"with_conditions","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_patient_summary.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_year","edge_type":"from"},{"from":"dim_date","to":"encounters_with_year","edge_type":"inner"},{"from":"procedures","to":"encounters_with_year","edge_type":"left"},{"from":"conditions","to":"conditions_per_patient_year","edge_type":"from"},{"from":"encounters_with_year","to":"patient_year_agg","edge_type":"from"},{"from":"patient_year_agg","to":"with_conditions","edge_type":"from"},{"from":"conditions_per_patient_year","to":"with_conditions","edge_type":"left"},{"from":"with_conditions","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_provider_metrics":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"procedures","role":"import"},{"id":"encounters_with_date","role":"transform"},{"id":"provider_month_agg","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_provider_metrics.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_date","edge_type":"from"},{"from":"dim_date","to":"encounters_with_date","edge_type":"inner"},{"from":"procedures","to":"encounters_with_date","edge_type":"left"},{"from":"encounters_with_date","to":"provider_month_agg","edge_type":"from"},{"from":"provider_month_agg","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.int_encounters__enriched":{"nodes":[{"id":"encounters","role":"import"},{"id":"conditions","role":"import"},{"id":"medications","role":"import"},{"id":"procedures","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"int_encounters__enriched.sql","role":"final"}],"edges":[{"from":"encounters","to":"final","edge_type":"from"},{"from":"conditions","to":"final","edge_type":"left"},{"from":"medications","to":"final","edge_type":"left"},{"from":"procedures","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.int_patients__with_conditions":{"nodes":[{"id":"patients","role":"import"},{"id":"conditions","role":"import"},{"id":"condition_stats","role":"transform"},{"id":"chronic_flags","role":"transform"},{"id":"chronic_count","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"int_patients__with_conditions.sql","role":"final"}],"edges":[{"from":"conditions","to":"condition_stats","edge_type":"from"},{"from":"conditions","to":"chronic_flags","edge_type":"from"},{"from":"chronic_flags","to":"chronic_count","edge_type":"from"},{"from":"patients","to":"final","edge_type":"from"},{"from":"condition_stats","to":"final","edge_type":"left"},{"from":"chronic_flags","to":"final","edge_type":"left"},{"from":"chronic_count","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.mart_date_state_grid":{"nodes":[{"id":"months","role":"import"},{"id":"states","role":"import"},{"id":"grid","role":"transform"},{"id":"(final select)","label":"mart_date_state_grid.sql","role":"final"}],"edges":[{"from":"months","to":"grid","edge_type":"from"},{"from":"states","to":"grid","edge_type":"cross"},{"from":"grid","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.mart_dq_summary":{"nodes":[{"id":"encounter_metrics","role":"import"},{"id":"medication_metrics","role":"import"},{"id":"combined_metrics","role":"transform"},{"id":"(final select)","label":"mart_dq_summary.sql","role":"final"}],"edges":[{"from":"encounter_metrics","to":"combined_metrics","edge_type":"union_all"},{"from":"medication_metrics","to":"combined_metrics","edge_type":"union_all"},{"from":"combined_metrics","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__conditions":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__conditions.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__encounters":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_dq_flags","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__encounters.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_dq_flags","edge_type":"from"},{"from":"with_dq_flags","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__medications":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_row_number","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"with_dq_flags","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__medications.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_row_number","edge_type":"from"},{"from":"with_row_number","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"with_dq_flags","edge_type":"from"},{"from":"with_dq_flags","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__observations":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_row_number","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__observations.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_row_number","edge_type":"from"},{"from":"with_row_number","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__organizations":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__organizations.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__patients":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__patients.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__payers":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__payers.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__procedures":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__procedures.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__providers":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__providers.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.v_encounter_summary":{"nodes":[{"id":"encounters","role":"import"},{"id":"patients","role":"import"},{"id":"providers","role":"import"},{"id":"organizations","role":"import"},{"id":"payers","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"v_encounter_summary.sql","role":"final"}],"edges":[{"from":"encounters","to":"final","edge_type":"from"},{"from":"patients","to":"final","edge_type":"left"},{"from":"providers","to":"final","edge_type":"left"},{"from":"organizations","to":"final","edge_type":"left"},{"from":"payers","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.v_patient_current_conditions":{"nodes":[{"id":"condition_cohorts","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"v_patient_current_conditions.sql","role":"final"}],"edges":[{"from":"condition_cohorts","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.v_provider_active_patients":{"nodes":[{"id":"providers","role":"import"},{"id":"current_conditions","role":"import"},{"id":"patient_recent_encounters","role":"import"},{"id":"patient_provider_assignment","role":"transform"},{"id":"active_conditions_by_provider","role":"transform"},{"id":"provider_summary","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"v_provider_active_patients.sql","role":"final"}],"edges":[{"from":"patient_recent_encounters","to":"patient_provider_assignment","edge_type":"from"},{"from":"current_conditions","to":"active_conditions_by_provider","edge_type":"from"},{"from":"patient_provider_assignment","to":"active_conditions_by_provider","edge_type":"inner"},{"from":"active_conditions_by_provider","to":"provider_summary","edge_type":"from"},{"from":"providers","to":"final","edge_type":"from"},{"from":"provider_summary","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]}}}</script>
+<script type="application/json" id="explore-dag-data">{"nodes":[{"id":"exposure.healthcare_analytics.provider_quality_dashboard","name":"provider_quality_dashboard","node_type":"exposure","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"model.healthcare_analytics.dim_conditions","name":"dim_conditions","node_type":"model","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Master condition dimension for healthcare analytics.\nOne row per unique ICD/SNOMED condition code, deduplicated from staging.\nUse for filtering and grouping by condition across fact tables.\n\nUse cases:\n- Condition-based cohort analysis\n- Disease prevalence tracking\n- Condition frequency and distribution reporting\n- Join target for condition-related facts\n","materialized":"table","tags":["analytics","marts","dimension"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Identify the most prevalent conditions in the patient population\",\"name\":\"Top 10 most common conditions\",\"sql\":\"select\\n    condition_code\\n    , condition_description\\n    , patient_count\\n    , encounter_count\\nfrom main_marts.dim_conditions\\norder by patient_count desc\\nlimit 10\"},{\"description\":\"Find conditions that drive the most healthcare utilization\",\"name\":\"Conditions by encounter frequency\",\"sql\":\"select\\n    condition_code\\n    , condition_description\\n    , encounter_count\\n    , patient_count\\n    , round(encounter_count * 1.0 / patient_count, 2) as avg_encounters_per_patient\\nfrom main_marts.dim_conditions\\nwhere patient_count > 0\\norder by encounter_count desc\\nlimit 20\"},{\"description\":\"Find conditions first diagnosed in the last year\",\"name\":\"Recently diagnosed conditions\",\"sql\":\"select\\n    condition_code\\n    , condition_description\\n    , first_occurrence_date\\n    , last_occurrence_date\\n    , patient_count\\nfrom main_marts.dim_conditions\\nwhere first_occurrence_date >= current_date - interval '1 year'\\norder by first_occurrence_date desc\"}]"},{"key":"grain","value":"condition_code"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Condition lookup and filtering\",\"Cohort analysis by diagnosis\",\"Disease prevalence reporting\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"condition_code","data_type":null,"description":"ICD/SNOMED code (natural key)"},{"name":"condition_description","data_type":null,"description":"Full condition name/description"},{"name":"condition_key","data_type":null,"description":"Surrogate key (row_number)"},{"name":"encounter_count","data_type":null,"description":"Total number of encounters with this condition"},{"name":"first_occurrence_date","data_type":null,"description":"Earliest date this condition was diagnosed in the dataset"},{"name":"last_occurrence_date","data_type":null,"description":"Most recent date this condition was diagnosed"},{"name":"patient_count","data_type":null,"description":"Number of unique patients with this condition"}],"grain":{"value":"condition_code","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"condition_code","origin":"config.meta.grain"},{"kind":"unique test","value":"condition_code","origin":"test.healthcare_analytics.unique_dim_conditions_condition_code.99cd9f3457"},{"kind":"unique test","value":"condition_key","origin":"test.healthcare_analytics.unique_dim_conditions_condition_key.93802fac5a"}]}},"paths":{"sql":"models/marts/analytics/dim_conditions.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_date","name":"dim_date","node_type":"model","not_compiled":false,"data_tests":31,"unit_tests":0,"badge":"31 data-tests · 0 unit-tests","detail":{"description":"Calendar dimension covering 1909-01-01 to 2025-12-31. Provides date attributes, day/week/month/quarter/year hierarchies, weekend flags, and US holiday identification.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"date_actual","data_type":null,"description":"The actual date value"},{"name":"date_key","data_type":null,"description":"Surrogate key in YYYYMMDD integer format (e.g., 20240115)"},{"name":"day_name","data_type":null,"description":"Full day name (e.g., Monday, Tuesday)"},{"name":"day_name_short","data_type":null,"description":"Abbreviated day name (e.g., Mon, Tue)"},{"name":"day_of_month","data_type":null,"description":"Day of the month (1-31)"},{"name":"day_of_week","data_type":null,"description":"Day of week number (US convention - Sunday=1, Saturday=7)"},{"name":"day_of_year","data_type":null,"description":"Day of the year (1-366)"},{"name":"holiday_name","data_type":null,"description":"Name of the US holiday (null if not a holiday)"},{"name":"is_us_holiday","data_type":null,"description":"Boolean flag indicating if date is a recognized US holiday"},{"name":"is_weekend","data_type":null,"description":"Boolean flag indicating if date falls on Saturday or Sunday"},{"name":"month_actual","data_type":null,"description":"Month number (1-12)"},{"name":"month_name","data_type":null,"description":"Full month name (e.g., January, February)"},{"name":"month_name_short","data_type":null,"description":"Abbreviated month name (e.g., Jan, Feb)"},{"name":"quarter_actual","data_type":null,"description":"Quarter number (1-4)"},{"name":"quarter_name","data_type":null,"description":"Quarter name (Q1, Q2, Q3, Q4)"},{"name":"week_of_year","data_type":null,"description":"Week of the year (1-53)"},{"name":"year_actual","data_type":null,"description":"Year number"}],"grain":{"value":"date_actual","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"date_actual","origin":"test.healthcare_analytics.unique_dim_date_date_actual.107fe1b6a2"},{"kind":"unique test","value":"date_key","origin":"test.healthcare_analytics.unique_dim_date_date_key.0869fd48f9"}]}},"paths":{"sql":"models/marts/core/dim_date.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_organizations","name":"dim_organizations","node_type":"model","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Organization dimension containing healthcare facilities. Includes an unknown member row (organization_key = -1) for handling missing lookups.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier (UUID)"},{"name":"organization_key","data_type":null,"description":"Surrogate key (-1 for unknown member)"},{"name":"organization_name","data_type":null,"description":"Name of the healthcare organization"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"organization_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"organization_key","origin":"test.healthcare_analytics.unique_dim_organizations_organization_key.096582bf56"}]}},"paths":{"sql":"models/marts/core/dim_organizations.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_patients","name":"dim_patients","node_type":"model","not_compiled":false,"data_tests":20,"unit_tests":0,"badge":"20 data-tests · 0 unit-tests","detail":{"description":"Patient dimension with SCD Type 2 history tracking. Each row represents a specific version of a patient's record. Includes an unknown member row (patient_key = -1) for handling missing lookups.\nSCD Type 2 columns: patient_key (surrogate), patient_id (natural), valid_from, valid_to, is_current.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"age_years","data_type":null,"description":"Current age or age at death (in years)"},{"name":"birth_date","data_type":null,"description":"Patient date of birth"},{"name":"city","data_type":null,"description":"City of residence"},{"name":"county","data_type":null,"description":"County of residence"},{"name":"death_date","data_type":null,"description":"Patient date of death (null if alive)"},{"name":"ethnicity","data_type":null,"description":"Patient ethnicity (hispanic or nonhispanic)"},{"name":"first_name","data_type":null,"description":"Patient's first name"},{"name":"full_name","data_type":null,"description":"Patient's full name (first + last)"},{"name":"gender","data_type":null,"description":"Patient gender (M or F)"},{"name":"healthcare_coverage","data_type":null,"description":"Total healthcare coverage received"},{"name":"healthcare_expenses","data_type":null,"description":"Total healthcare expenses incurred"},{"name":"is_current","data_type":null,"description":"Boolean flag indicating if this is the current version"},{"name":"is_deceased","data_type":null,"description":"Boolean flag indicating if patient has died"},{"name":"last_name","data_type":null,"description":"Patient's last name"},{"name":"latitude","data_type":null,"description":"Latitude coordinate of residence"},{"name":"longitude","data_type":null,"description":"Longitude coordinate of residence"},{"name":"marital_status","data_type":null,"description":"Marital status (M=Married, S=Single, or blank)"},{"name":"name_prefix","data_type":null,"description":"Name prefix (Mr., Mrs., Ms., etc.)"},{"name":"name_suffix","data_type":null,"description":"Name suffix (Jr., Sr., III, etc.)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier (UUID), same across SCD2 versions"},{"name":"patient_key","data_type":null,"description":"Surrogate key (unique per version, -1 for unknown member)"},{"name":"race","data_type":null,"description":"Patient race"},{"name":"state","data_type":null,"description":"State of residence (full state name)"},{"name":"valid_from","data_type":null,"description":"Date when this SCD2 version became active"},{"name":"valid_to","data_type":null,"description":"Date when this SCD2 version was superseded (null = current)"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"patient_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"patient_key","origin":"test.healthcare_analytics.unique_dim_patients_patient_key.a372c8896a"}]}},"paths":{"sql":"models/marts/core/dim_patients.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.dim_payers","name":"dim_payers","node_type":"model","not_compiled":false,"data_tests":8,"unit_tests":1,"badge":"8 data-tests · 1 unit-test","detail":{"description":"Payer dimension containing insurance payers. Includes an unknown member row (payer_key = -1) for handling missing lookups.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"amount_covered","data_type":null,"description":"Total amount covered by payer"},{"name":"amount_uncovered","data_type":null,"description":"Total amount not covered by payer"},{"name":"average_quality_of_life_score","data_type":null,"description":"Average quality of life score for members"},{"name":"city","data_type":null,"description":"City"},{"name":"coverage_rate","data_type":null,"description":"Derived coverage rate (amount_covered / total amount)"},{"name":"covered_encounters","data_type":null,"description":"Number of encounters covered"},{"name":"covered_immunizations","data_type":null,"description":"Number of immunizations covered"},{"name":"covered_medications","data_type":null,"description":"Number of medications covered"},{"name":"covered_procedures","data_type":null,"description":"Number of procedures covered"},{"name":"member_months","data_type":null,"description":"Total member months"},{"name":"payer_id","data_type":null,"description":"Natural payer identifier (UUID)"},{"name":"payer_key","data_type":null,"description":"Surrogate key (-1 for unknown member)"},{"name":"payer_name","data_type":null,"description":"Name of the insurance payer"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue collected"},{"name":"state","data_type":null,"description":"State"},{"name":"uncovered_encounters","data_type":null,"description":"Number of encounters not covered"},{"name":"uncovered_immunizations","data_type":null,"description":"Number of immunizations not covered"},{"name":"uncovered_medications","data_type":null,"description":"Number of medications not covered"},{"name":"uncovered_procedures","data_type":null,"description":"Number of procedures not covered"},{"name":"unique_customers","data_type":null,"description":"Number of unique customers"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"payer_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"payer_key","origin":"test.healthcare_analytics.unique_dim_payers_payer_key.953b1f5fd2"}]}},"paths":{"sql":"models/marts/core/dim_payers.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[{"name":"test_dim_payers_injects_unknown_sentinel","yaml":"models/marts/core/_core__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.dim_providers","name":"dim_providers","node_type":"model","not_compiled":false,"data_tests":10,"unit_tests":0,"badge":"10 data-tests · 0 unit-tests","detail":{"description":"Provider dimension containing healthcare providers (doctors, nurses, etc.). Includes an unknown member row (provider_key = -1) for handling missing lookups.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"gender","data_type":null,"description":"Provider gender (M or F)"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations (-1 for unknown)"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier (UUID)"},{"name":"provider_key","data_type":null,"description":"Surrogate key (-1 for unknown member)"},{"name":"provider_name","data_type":null,"description":"Full name of the provider"},{"name":"specialty","data_type":null,"description":"Medical specialty"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"provider_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"provider_key","origin":"test.healthcare_analytics.unique_dim_providers_provider_key.02ac65c919"}]}},"paths":{"sql":"models/marts/core/dim_providers.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_clinical_events","name":"fct_clinical_events","node_type":"model","not_compiled":false,"data_tests":22,"unit_tests":0,"badge":"22 data-tests · 0 unit-tests","detail":{"description":"Unified clinical events fact table combining conditions, medications, and procedures. Each row represents a single clinical event with standardized structure. Links to patient and encounter dimensions.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"clinical_event_key","data_type":null,"description":"Surrogate key for the clinical event"},{"name":"code","data_type":null,"description":"Clinical code (SNOMED-CT or RxNorm)"},{"name":"code_system","data_type":null,"description":"Code system (SNOMED-CT or RXNORM)"},{"name":"description","data_type":null,"description":"Description of the clinical event"},{"name":"encounter_id","data_type":null,"description":"Natural encounter identifier"},{"name":"encounter_key","data_type":null,"description":"Foreign key to fct_encounters (-1 for unknown)"},{"name":"event_cost","data_type":null,"description":"Cost of the clinical event"},{"name":"event_date_key","data_type":null,"description":"Foreign key to dim_date for event start"},{"name":"event_end_date","data_type":null,"description":"End date of the clinical event (null if ongoing or one-time)"},{"name":"event_id","data_type":null,"description":"Natural event identifier (condition_id, medication_id, or procedure_id)"},{"name":"event_start_date","data_type":null,"description":"Start date of the clinical event"},{"name":"event_type","data_type":null,"description":"Type of clinical event (CONDITION, MEDICATION, PROCEDURE)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients (-1 for unknown)"},{"name":"reason_code","data_type":null,"description":"Clinical code for the reason of the event"},{"name":"reason_description","data_type":null,"description":"Description of the reason for the event"}],"grain":{"value":"clinical_event_key","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"clinical_event_key","origin":"test.healthcare_analytics.unique_fct_clinical_events_clinical_event_key.2af827606b"}]}},"paths":{"sql":"models/marts/core/fct_clinical_events.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_condition_cohorts","name":"fct_condition_cohorts","node_type":"model","not_compiled":false,"data_tests":15,"unit_tests":0,"badge":"15 data-tests · 0 unit-tests","detail":{"description":"Patient-condition cohort analysis for disease management and population health.\nOne row per unique patient-condition combination with timeline and encounter details.\nGrain: (patient_id, condition_code)\n\nUse cases:\n- Disease management program enrollment\n- Cohort identification for clinical trials\n- Chronic condition tracking\n- Care gap analysis\n- Risk stratification by condition\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Find conditions with the most patients for population health programs\",\"name\":\"Largest condition cohorts\",\"sql\":\"select\\n    fcc.condition_code\\n    , fcc.condition_description\\n    , count(distinct fcc.patient_id) as patient_count\\n    , sum(fcc.encounter_count) as total_encounters\\n    , round(avg(fcc.months_with_condition), 1) as avg_months_with_condition\\n    , sum(case when fcc.is_active then 1 else 0 end) as active_patients\\nfrom main_marts.fct_condition_cohorts fcc\\ngroup by 1, 2\\norder by patient_count desc\\nlimit 15\"},{\"description\":\"Identify patients with long-standing conditions for care management\",\"name\":\"Chronic condition patients (long duration)\",\"sql\":\"select\\n    p.patient_id\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , fcc.condition_description\\n    , fcc.first_diagnosis_date\\n    , fcc.months_with_condition\\n    , fcc.encounter_count\\n    , fcc.is_active\\nfrom main_marts.fct_condition_cohorts fcc\\njoin main_marts.dim_patients p\\n    on fcc.patient_key = p.patient_key\\nwhere fcc.months_with_condition >= 24\\n    and fcc.is_active = true\\norder by fcc.months_with_condition desc\\nlimit 50\"},{\"description\":\"Find patients with comorbidities for complex care programs\",\"name\":\"Patients with multiple conditions\",\"sql\":\"with patient_condition_counts as (\\n    select\\n        patient_id\\n        , patient_key\\n        , count(distinct condition_code) as condition_count\\n        , sum(case when is_active then 1 else 0 end) as active_condition_count\\n    from main_marts.fct_condition_cohorts\\n    group by 1, 2\\n)\\nselect\\n    p.patient_id\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , pcc.condition_count\\n    , pcc.active_condition_count\\nfrom patient_condition_counts pcc\\njoin main_marts.dim_patients p\\n    on pcc.patient_key = p.patient_key\\nwhere pcc.condition_count >= 3\\norder by pcc.condition_count desc\\nlimit 25\"}]"},{"key":"grain","value":"patient_id + condition_code"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Disease management programs\",\"Cohort identification\",\"Chronic condition tracking\",\"Care gap analysis\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"condition_code","data_type":null,"description":"ICD/SNOMED condition code"},{"name":"condition_cohort_key","data_type":null,"description":"Surrogate key (MD5 hash of patient_id + condition_code)"},{"name":"condition_description","data_type":null,"description":"Full condition name"},{"name":"condition_key","data_type":null,"description":"Foreign key to dim_conditions"},{"name":"encounter_count","data_type":null,"description":"Number of encounters with this condition"},{"name":"first_diagnosis_date","data_type":null,"description":"Date of first diagnosis"},{"name":"first_diagnosis_year","data_type":null,"description":"Year of first diagnosis"},{"name":"is_active","data_type":null,"description":"True if condition has no end date (currently active)"},{"name":"last_diagnosis_date","data_type":null,"description":"Date of most recent diagnosis (null if first occurrence only)"},{"name":"months_with_condition","data_type":null,"description":"Months between first and last diagnosis (0 if single occurrence)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"}],"grain":{"value":"patient_id + condition_code","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"patient_id + condition_code","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"patient_id, condition_code","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_fct_condition_cohorts_patient_id__condition_code.48b30357e0"},{"kind":"unique test","value":"condition_cohort_key","origin":"test.healthcare_analytics.unique_fct_condition_cohorts_condition_cohort_key.f8c8f721d9"}]}},"paths":{"sql":"models/marts/analytics/fct_condition_cohorts.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_cost_analysis","name":"fct_cost_analysis","node_type":"model","not_compiled":false,"data_tests":17,"unit_tests":0,"badge":"17 data-tests · 0 unit-tests","detail":{"description":"Detailed cost breakdown for financial analysis and revenue cycle management.\nOne row per encounter with cost allocation details across payer and patient.\nGrain: encounter_id\n\nUse cases:\n- Financial performance reporting\n- Payer mix analysis\n- Patient out-of-pocket tracking\n- Cost driver identification\n- Revenue cycle optimization\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Analyze cost distribution across different insurance payers\",\"name\":\"Cost breakdown by payer\",\"sql\":\"select\\n    py.payer_name\\n    , count(distinct fca.encounter_id) as encounter_count\\n    , round(sum(fca.total_cost), 2) as total_cost\\n    , round(sum(fca.payer_coverage), 2) as total_payer_coverage\\n    , round(sum(fca.patient_responsibility), 2) as total_patient_responsibility\\n    , round(avg(fca.coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_cost_analysis fca\\njoin main_marts.dim_payers py\\n    on fca.payer_key = py.payer_key\\ngroup by py.payer_name\\norder by total_cost desc\"},{\"description\":\"Track cost trends over time for financial forecasting\",\"name\":\"Monthly cost trends\",\"sql\":\"select\\n    strftime(fca.encounter_date, '%Y-%m') as year_month\\n    , count(distinct fca.encounter_id) as encounter_count\\n    , round(sum(fca.total_cost), 2) as total_cost\\n    , round(avg(fca.total_cost), 2) as avg_cost_per_encounter\\n    , round(sum(fca.payer_coverage), 2) as total_payer_coverage\\n    , round(avg(fca.coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_cost_analysis fca\\nwhere fca.year_actual >= 2023\\ngroup by 1\\norder by 1 desc\"},{\"description\":\"Compare costs across different encounter classes\",\"name\":\"Cost by encounter type\",\"sql\":\"select\\n    fca.encounter_class\\n    , count(distinct fca.encounter_id) as encounter_count\\n    , round(sum(fca.total_cost), 2) as total_cost\\n    , round(avg(fca.total_cost), 2) as avg_cost\\n    , round(avg(fca.procedure_count), 2) as avg_procedures\\n    , round(avg(fca.cost_per_procedure), 2) as avg_cost_per_procedure\\n    , round(avg(fca.coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_cost_analysis fca\\ngroup by fca.encounter_class\\norder by total_cost desc\"},{\"description\":\"Identify individual high-cost encounters for review\",\"name\":\"High-cost encounters\",\"sql\":\"select\\n    fca.encounter_id\\n    , fca.encounter_date\\n    , fca.encounter_class\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , py.payer_name\\n    , fca.total_cost\\n    , fca.payer_coverage\\n    , fca.patient_responsibility\\n    , fca.procedure_count\\nfrom main_marts.fct_cost_analysis fca\\njoin main_marts.dim_patients p\\n    on fca.patient_key = p.patient_key\\njoin main_marts.dim_payers py\\n    on fca.payer_key = py.payer_key\\norder by fca.total_cost desc\\nlimit 25\"}]"},{"key":"grain","value":"encounter_id"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Financial reporting\",\"Payer mix analysis\",\"Cost allocation tracking\",\"Revenue cycle management\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"cost_analysis_key","data_type":null,"description":"Surrogate key (MD5 hash of encounter_id)"},{"name":"cost_per_procedure","data_type":null,"description":"Average cost per procedure (null if no procedures)"},{"name":"coverage_pct","data_type":null,"description":"Percentage covered by insurance (0-100)"},{"name":"encounter_class","data_type":null,"description":"Type of encounter (ambulatory, wellness, etc.)"},{"name":"encounter_date","data_type":null,"description":"Date of the encounter"},{"name":"encounter_date_key","data_type":null,"description":"Foreign key to dim_date"},{"name":"encounter_id","data_type":null,"description":"Natural encounter identifier"},{"name":"encounter_key","data_type":null,"description":"Foreign key to fct_encounters"},{"name":"patient_cost_pct","data_type":null,"description":"Percentage owed by patient (0-100)"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"},{"name":"patient_responsibility","data_type":null,"description":"Amount owed by patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"payer_id","data_type":null,"description":"Natural payer identifier"},{"name":"payer_key","data_type":null,"description":"Foreign key to dim_payers"},{"name":"procedure_count","data_type":null,"description":"Number of procedures in the encounter"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers"},{"name":"total_cost","data_type":null,"description":"Total claim cost"},{"name":"year_actual","data_type":null,"description":"Calendar year of encounter"}],"grain":{"value":"encounter_id","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"encounter_id","origin":"config.meta.grain"},{"kind":"unique test","value":"cost_analysis_key","origin":"test.healthcare_analytics.unique_fct_cost_analysis_cost_analysis_key.2aecf62159"},{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_fct_cost_analysis_encounter_id.c11ffc0f22"}]}},"paths":{"sql":"models/marts/analytics/fct_cost_analysis.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_encounters","name":"fct_encounters","node_type":"model","not_compiled":false,"data_tests":30,"unit_tests":0,"badge":"30 data-tests · 0 unit-tests","detail":{"description":"Encounter fact table containing healthcare visits/encounters. Links to patient, provider, organization, and payer dimensions. Includes date keys, costs, and derived duration.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"base_encounter_cost","data_type":null,"description":"Base cost of the encounter"},{"name":"duration_minutes","data_type":null,"description":"Duration of encounter in minutes"},{"name":"encounter_class","data_type":null,"description":"Type of encounter (ambulatory, wellness, emergency, etc.)"},{"name":"encounter_code","data_type":null,"description":"SNOMED CT code for the encounter type"},{"name":"encounter_description","data_type":null,"description":"Description of the encounter type"},{"name":"encounter_end_at","data_type":null,"description":"End timestamp of the encounter"},{"name":"encounter_end_date_key","data_type":null,"description":"Foreign key to dim_date for encounter end"},{"name":"encounter_id","data_type":null,"description":"Natural encounter identifier (UUID)"},{"name":"encounter_key","data_type":null,"description":"Surrogate key for the encounter"},{"name":"encounter_start_at","data_type":null,"description":"Start timestamp of the encounter"},{"name":"encounter_start_date_key","data_type":null,"description":"Foreign key to dim_date for encounter start"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations (-1 for unknown)"},{"name":"patient_age_at_encounter","data_type":null,"description":"Patient's age at the time of the encounter"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients (-1 for unknown)"},{"name":"patient_responsibility","data_type":null,"description":"Amount patient is responsible for (total_claim_cost - payer_coverage)"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by payer"},{"name":"payer_id","data_type":null,"description":"Natural payer identifier"},{"name":"payer_key","data_type":null,"description":"Foreign key to dim_payers (-1 for unknown)"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers (-1 for unknown)"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of visit"},{"name":"reason_description","data_type":null,"description":"Description of the reason for visit"},{"name":"total_claim_cost","data_type":null,"description":"Total claim cost"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_fct_encounters_encounter_id.ce88bae928"},{"kind":"unique test","value":"encounter_key","origin":"test.healthcare_analytics.unique_fct_encounters_encounter_key.a3b77e9141"}]}},"paths":{"sql":"models/marts/core/fct_encounters.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_encounters_incremental","name":"fct_encounters_incremental","node_type":"model","not_compiled":false,"data_tests":2,"unit_tests":1,"badge":"2 data-tests · 1 unit-test","detail":{"description":"Incremental fact table of encounter events. Appends encounters newer than the latest already-loaded start_time via an is_incremental() filter.","materialized":"incremental","tags":[],"meta":[],"columns":[{"name":"encounter_id","data_type":null,"description":"Natural key of the encounter (unique per visit)"},{"name":"encounter_type","data_type":null,"description":"Visit class (wellness, emergency, ...)"},{"name":"patient_id","data_type":null,"description":"Patient the encounter belongs to"},{"name":"start_time","data_type":null,"description":"Encounter start timestamp - the incremental high-water mark"},{"name":"total_cost","data_type":null,"description":"Total claim cost for the encounter"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_fct_encounters_incremental_encounter_id.a165c01d01"}]}},"paths":{"sql":"models/marts/core/fct_encounters_incremental.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[{"name":"test_fct_encounters_incremental_appends_new_encounters","yaml":"models/marts/core/_core__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.fct_encounters_monthly","name":"fct_encounters_monthly","node_type":"model","not_compiled":false,"data_tests":17,"unit_tests":0,"badge":"17 data-tests · 0 unit-tests","detail":{"description":"Monthly aggregated encounter statistics by encounter class. Provides counts, costs, and patient metrics grouped by year-month and encounter type.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"avg_duration_minutes","data_type":null,"description":"Average encounter duration in minutes"},{"name":"encounter_class","data_type":null,"description":"Type of encounter"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the month"},{"name":"month_actual","data_type":null,"description":"Month number (1-12)"},{"name":"total_claim_cost","data_type":null,"description":"Sum of total claim costs"},{"name":"total_patient_responsibility","data_type":null,"description":"Sum of patient responsibility amounts"},{"name":"total_payer_coverage","data_type":null,"description":"Sum of payer coverage amounts"},{"name":"unique_patients","data_type":null,"description":"Number of unique patients with encounters"},{"name":"year_actual","data_type":null,"description":"Year number"},{"name":"year_month","data_type":null,"description":"Year-month string (YYYY-MM format)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/marts/core/fct_encounters_monthly.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_encounters_yearly","name":"fct_encounters_yearly","node_type":"model","not_compiled":false,"data_tests":14,"unit_tests":0,"badge":"14 data-tests · 0 unit-tests","detail":{"description":"Yearly aggregated encounter statistics by encounter class. Provides counts, costs, patient metrics, and encounters per patient ratio.\n","materialized":"table","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"avg_duration_minutes","data_type":null,"description":"Average encounter duration in minutes"},{"name":"encounter_class","data_type":null,"description":"Type of encounter"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the year"},{"name":"encounters_per_patient","data_type":null,"description":"Average number of encounters per patient"},{"name":"total_claim_cost","data_type":null,"description":"Sum of total claim costs"},{"name":"total_patient_responsibility","data_type":null,"description":"Sum of patient responsibility amounts"},{"name":"total_payer_coverage","data_type":null,"description":"Sum of payer coverage amounts"},{"name":"unique_patients","data_type":null,"description":"Number of unique patients with encounters"},{"name":"year_actual","data_type":null,"description":"Year number"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/marts/core/fct_encounters_yearly.sql","schema_yaml":"models/marts/core/_core__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_patient_summary","name":"fct_patient_summary","node_type":"model","not_compiled":false,"data_tests":19,"unit_tests":0,"badge":"19 data-tests · 0 unit-tests","detail":{"description":"Annual patient-level aggregations for outcomes tracking and population health analysis.\nOne row per patient per calendar year with comprehensive utilization and cost metrics.\nGrain: (patient_id, year_actual)\n\nUse cases:\n- Patient outcomes tracking over time\n- Annual cost summaries and trends\n- Cohort analysis and patient stratification\n- Health trajectory visualization\n- High-cost patient identification\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Identify high-cost patients for care management programs\",\"name\":\"Top 10 costliest patients by year\",\"sql\":\"select\\n    p.patient_id\\n    , p.first_name || ' ' || p.last_name as patient_name\\n    , fps.year_actual\\n    , fps.total_cost\\n    , fps.encounter_count\\n    , fps.condition_count\\n    , fps.payer_coverage_pct\\nfrom main_marts.fct_patient_summary fps\\njoin main_marts.dim_patients p\\n    on fps.patient_key = p.patient_key\\nwhere fps.year_actual = 2024\\norder by fps.total_cost desc\\nlimit 10\"},{\"description\":\"Analyze patient population distribution and costs by age cohort\",\"name\":\"Patient count and cost by age group\",\"sql\":\"select\\n    case\\n        when fps.patient_age_at_year_end < 18 then '0-17'\\n        when fps.patient_age_at_year_end < 35 then '18-34'\\n        when fps.patient_age_at_year_end < 50 then '35-49'\\n        when fps.patient_age_at_year_end < 65 then '50-64'\\n        else '65+'\\n    end as age_group\\n    , count(distinct fps.patient_id) as patient_count\\n    , round(avg(fps.total_cost), 2) as avg_annual_cost\\n    , round(sum(fps.total_cost), 2) as total_cost\\n    , round(avg(fps.encounter_count), 2) as avg_encounters\\nfrom main_marts.fct_patient_summary fps\\nwhere fps.year_actual = 2024\\ngroup by 1\\norder by 1\"},{\"description\":\"Year-over-year comparison of costs and utilization metrics\",\"name\":\"Cost and utilization trends over time\",\"sql\":\"select\\n    fps.year_actual\\n    , count(distinct fps.patient_id) as patient_count\\n    , round(avg(fps.encounter_count), 2) as avg_encounters_per_patient\\n    , round(avg(fps.condition_count), 2) as avg_conditions_per_patient\\n    , round(avg(fps.total_cost), 2) as avg_annual_cost\\n    , round(sum(fps.total_cost), 2) as total_population_cost\\n    , round(avg(fps.payer_coverage_pct), 2) as avg_coverage_pct\\nfrom main_marts.fct_patient_summary fps\\ngroup by fps.year_actual\\norder by fps.year_actual desc\"},{\"description\":\"Find patients with above-average encounters and conditions\",\"name\":\"High utilization patients\",\"sql\":\"with averages as (\\n    select\\n        avg(encounter_count) as avg_encounters\\n        , avg(condition_count) as avg_conditions\\n    from main_marts.fct_patient_summary\\n    where year_actual = 2024\\n)\\nselect\\n    fps.patient_id\\n    , fps.encounter_count\\n    , fps.condition_count\\n    , fps.total_cost\\n    , fps.unique_providers\\nfrom main_marts.fct_patient_summary fps\\ncross join averages a\\nwhere fps.year_actual = 2024\\n    and fps.encounter_count > a.avg_encounters * 2\\n    and fps.condition_count > a.avg_conditions\\norder by fps.total_cost desc\\nlimit 25\"}]"},{"key":"grain","value":"patient_id + year_actual"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Population health reporting\",\"Cost and utilization analysis\",\"Patient stratification\",\"Year-over-year trending\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"condition_count","data_type":null,"description":"Number of distinct conditions diagnosed in the year"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the year"},{"name":"patient_age_at_year_end","data_type":null,"description":"Patient age as of December 31 of the year"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"},{"name":"patient_responsibility","data_type":null,"description":"Amount owed by patient (copay + coinsurance)"},{"name":"patient_summary_key","data_type":null,"description":"Surrogate key (MD5 hash of patient_id + year_actual)"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"payer_coverage_pct","data_type":null,"description":"Percentage of costs covered by insurance (0-100)"},{"name":"procedure_count","data_type":null,"description":"Number of procedures in the year"},{"name":"total_cost","data_type":null,"description":"Total claim cost for the year"},{"name":"unique_organizations","data_type":null,"description":"Number of distinct organizations visited"},{"name":"unique_providers","data_type":null,"description":"Number of distinct providers seen"},{"name":"year_actual","data_type":null,"description":"Calendar year of the summary"}],"grain":{"value":"patient_id + year_actual","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"patient_id + year_actual","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"patient_id, year_actual","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_fct_patient_summary_patient_id__year_actual.cdb3418166"},{"kind":"unique test","value":"patient_summary_key","origin":"test.healthcare_analytics.unique_fct_patient_summary_patient_summary_key.e532e1ff45"}]}},"paths":{"sql":"models/marts/analytics/fct_patient_summary.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.fct_provider_metrics","name":"fct_provider_metrics","node_type":"model","not_compiled":false,"data_tests":20,"unit_tests":0,"badge":"20 data-tests · 0 unit-tests","detail":{"description":"Monthly provider-level utilization and performance metrics.\nOne row per provider per calendar month with patient volumes, costs, and efficiency metrics.\nGrain: (provider_id, year_actual, month_actual)\n\nUse cases:\n- Provider performance tracking\n- Workload distribution analysis\n- Cost efficiency comparisons\n- Capacity planning and staffing\n- Quality improvement initiatives\n","materialized":"table","tags":["analytics","marts","fact"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Identify highest-volume providers for capacity planning\",\"name\":\"Top providers by patient volume\",\"sql\":\"select\\n    p.provider_id\\n    , p.name as provider_name\\n    , p.specialty\\n    , sum(fpm.encounter_count) as total_encounters\\n    , sum(fpm.unique_patient_count) as total_patients\\n    , round(avg(fpm.avg_cost_per_encounter), 2) as avg_cost_per_encounter\\nfrom main_marts.fct_provider_metrics fpm\\njoin main_marts.dim_providers p\\n    on fpm.provider_key = p.provider_key\\nwhere fpm.year_actual = 2024\\ngroup by 1, 2, 3\\norder by total_encounters desc\\nlimit 15\"},{\"description\":\"Track provider productivity over time\",\"name\":\"Provider metrics trend by month\",\"sql\":\"select\\n    fpm.year_month_str\\n    , count(distinct fpm.provider_id) as active_providers\\n    , sum(fpm.encounter_count) as total_encounters\\n    , sum(fpm.unique_patient_count) as total_patients\\n    , round(avg(fpm.avg_cost_per_encounter), 2) as avg_cost_per_encounter\\n    , round(avg(fpm.avg_encounter_duration_minutes), 2) as avg_duration_minutes\\nfrom main_marts.fct_provider_metrics fpm\\nwhere fpm.year_actual >= 2023\\ngroup by fpm.year_month_str\\norder by fpm.year_month_str desc\"},{\"description\":\"Compare providers by cost and volume efficiency\",\"name\":\"Provider efficiency comparison\",\"sql\":\"select\\n    p.provider_id\\n    , p.name as provider_name\\n    , p.specialty\\n    , sum(fpm.encounter_count) as total_encounters\\n    , round(sum(fpm.total_cost), 2) as total_cost\\n    , round(avg(fpm.avg_cost_per_encounter), 2) as avg_cost_per_encounter\\n    , round(avg(fpm.encounters_per_patient_avg), 2) as avg_encounters_per_patient\\n    , round(sum(fpm.total_procedures) * 1.0 / sum(fpm.encounter_count), 2) as procedures_per_encounter\\nfrom main_marts.fct_provider_metrics fpm\\njoin main_marts.dim_providers p\\n    on fpm.provider_key = p.provider_key\\nwhere fpm.year_actual = 2024\\ngroup by 1, 2, 3\\nhaving sum(fpm.encounter_count) >= 10\\norder by avg_cost_per_encounter\"}]"},{"key":"grain","value":"provider_id + year_month_str"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Provider productivity reporting\",\"Workload balancing\",\"Cost efficiency analysis\",\"Capacity planning\"]"}],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded"},{"name":"avg_cost_per_encounter","data_type":null,"description":"Average cost per encounter"},{"name":"avg_encounter_duration_minutes","data_type":null,"description":"Average encounter duration in minutes"},{"name":"avg_patient_age","data_type":null,"description":"Average age of patients seen"},{"name":"encounter_count","data_type":null,"description":"Number of encounters in the month"},{"name":"encounters_per_patient_avg","data_type":null,"description":"Average encounters per patient"},{"name":"month_actual","data_type":null,"description":"Calendar month (1-12)"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers"},{"name":"provider_metrics_key","data_type":null,"description":"Surrogate key (MD5 hash of provider_id + year_month_str)"},{"name":"total_cost","data_type":null,"description":"Total claim cost for the month"},{"name":"total_payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"total_procedures","data_type":null,"description":"Total procedures performed"},{"name":"unique_patient_count","data_type":null,"description":"Number of distinct patients seen"},{"name":"year_actual","data_type":null,"description":"Calendar year"},{"name":"year_month_str","data_type":null,"description":"Year-month string (YYYY-MM)"}],"grain":{"value":"provider_id + year_month_str","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"provider_id + year_month_str","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"provider_id, year_actual, month_actual","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_fct_provider_metrics_provider_id__year_actual__month_actual.a5b2cee14a"},{"kind":"unique test","value":"provider_metrics_key","origin":"test.healthcare_analytics.unique_fct_provider_metrics_provider_metrics_key.d58939d602"}]}},"paths":{"sql":"models/marts/analytics/fct_provider_metrics.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_dq_quarantine__encounters","name":"int_dq_quarantine__encounters","node_type":"model","not_compiled":false,"data_tests":5,"unit_tests":0,"badge":"5 data-tests · 0 unit-tests","detail":{"description":"Encounters that failed data quality validations and are excluded from downstream marts.\n\nRecords are quarantined when any of the following validations fail:\n- valid_encounter_timestamps: encounter_end_at >= encounter_start_at\n- no_future_encounter_dates: encounter_start_at <= current_timestamp\n- end_after_1900: encounter_end_at >= timestamp '1900-01-01'\n- start_after_1900: encounter_start_at >= timestamp '1900-01-01'\n\nThis table preserves data quality violations for investigation without polluting fact tables.\n","materialized":"table","tags":["intermediate","quarantine","data_quality"],"meta":[],"columns":[{"name":"encounter_id","data_type":null,"description":"Natural key for the encounter (from source system)"},{"name":"end_after_1900","data_type":null,"description":"Flag: encounter_end_at >= timestamp '1900-01-01'"},{"name":"failed_dq_tests","data_type":null,"description":"Array of failed validation test names"},{"name":"is_dq_valid","data_type":null,"description":"Data quality validity flag - should always be false in quarantine"},{"name":"no_future_encounter_dates","data_type":null,"description":"Flag: encounter_start_at <= current_timestamp"},{"name":"start_after_1900","data_type":null,"description":"Flag: encounter_start_at >= timestamp '1900-01-01'"},{"name":"valid_encounter_timestamps","data_type":null,"description":"Flag: encounter_end_at >= encounter_start_at"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_int_dq_quarantine__encounters_encounter_id.31321ef55a"}]}},"paths":{"sql":"models/intermediate/quarantine/int_dq_quarantine__encounters.sql","schema_yaml":"models/intermediate/quarantine/_quarantine__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_dq_quarantine__medications","name":"int_dq_quarantine__medications","node_type":"model","not_compiled":false,"data_tests":5,"unit_tests":0,"badge":"5 data-tests · 0 unit-tests","detail":{"description":"Medications that failed data quality validations and are excluded from downstream marts.\n\nRecords are quarantined when any of the following validations fail:\n- valid_medication_dates: medication_end_at is null or medication_end_at >= medication_start_at\n- no_future_medication_dates: cast(medication_start_at as date) <= current_date\n- start_after_1900: medication_start_at >= timestamp '1900-01-01'\n- end_after_1900_if_present: medication_end_at is null or medication_end_at >= timestamp '1900-01-01'\n\nThis table preserves data quality violations for investigation without polluting fact tables.\n","materialized":"table","tags":["intermediate","quarantine","data_quality"],"meta":[],"columns":[{"name":"end_after_1900_if_present","data_type":null,"description":"Flag: medication_end_at is null or medication_end_at >= timestamp '1900-01-01'"},{"name":"failed_dq_tests","data_type":null,"description":"Array of failed validation test names"},{"name":"is_dq_valid","data_type":null,"description":"Data quality validity flag - should always be false in quarantine"},{"name":"medication_id","data_type":null,"description":"Surrogate key for the medication record"},{"name":"no_future_medication_dates","data_type":null,"description":"Flag: cast(medication_start_at as date) <= current_date"},{"name":"start_after_1900","data_type":null,"description":"Flag: medication_start_at >= timestamp '1900-01-01'"},{"name":"valid_medication_dates","data_type":null,"description":"Flag: medication_end_at is null or medication_end_at >= medication_start_at"}],"grain":{"value":"medication_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"medication_id","origin":"test.healthcare_analytics.unique_int_dq_quarantine__medications_medication_id.06d855118f"}]}},"paths":{"sql":"models/intermediate/quarantine/int_dq_quarantine__medications.sql","schema_yaml":"models/intermediate/quarantine/_quarantine__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_encounters__enriched","name":"int_encounters__enriched","node_type":"model","not_compiled":false,"data_tests":19,"unit_tests":0,"badge":"19 data-tests · 0 unit-tests","detail":{"description":"Enriched encounter model that aggregates clinical event counts and costs per encounter. Joins conditions, medications, and procedures to provide a complete view of each encounter's clinical activity and associated costs.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"condition_count","data_type":null,"description":"Number of conditions diagnosed during this encounter"},{"name":"encounter_id","data_type":null,"description":"Unique encounter identifier (UUID), sourced from fct_encounters"},{"name":"medication_count","data_type":null,"description":"Number of medications prescribed during this encounter"},{"name":"procedure_count","data_type":null,"description":"Number of procedures performed during this encounter"},{"name":"total_condition_cost","data_type":null,"description":"Total cost associated with conditions (currently always 0 per model logic)"},{"name":"total_event_cost","data_type":null,"description":"Total cost of all clinical events (conditions + medications + procedures). Note: Condition costs are currently set to 0 in the model.\n"},{"name":"total_event_count","data_type":null,"description":"Total count of all clinical events (conditions + medications + procedures)"},{"name":"total_medication_cost","data_type":null,"description":"Total cost of medications prescribed during this encounter"},{"name":"total_procedure_cost","data_type":null,"description":"Total cost of procedures performed during this encounter"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_int_encounters__enriched_encounter_id.fdad6d4f82"}]}},"paths":{"sql":"models/intermediate/healthcare/int_encounters__enriched.sql","schema_yaml":"models/intermediate/healthcare/_healthcare__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.int_patients__never_admitted","name":"int_patients__never_admitted","node_type":"model","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"0 data-tests · 0 unit-tests","detail":{"description":"Patients with no encounter on record — the correlated NOT EXISTS anti-join idiom (cute-dbt#196 dogfood). Deliberately carries no unit test so the golden report shows the join.anti-join finding UNCOVERED with its inverted (matching-row) given sketch.","materialized":"table","tags":["intermediate","anti_join"],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/intermediate/int_patients__never_admitted.sql","schema_yaml":null,"unit_tests":[]}},{"id":"model.healthcare_analytics.int_patients__with_conditions","name":"int_patients__with_conditions","node_type":"model","not_compiled":false,"data_tests":17,"unit_tests":0,"badge":"17 data-tests · 0 unit-tests","detail":{"description":"Patient-level condition history with aggregated statistics and chronic disease flags. Provides counts of total and active conditions, condition date ranges, and boolean flags for common chronic conditions (diabetes, hypertension, heart disease).\nIMPORTANT: Chronic condition flags use simplified text matching on condition descriptions. This is for analytics/reporting only, not clinical decisions.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"active_conditions","data_type":null,"description":"Number of currently active conditions (no end date)"},{"name":"chronic_condition_count","data_type":null,"description":"Count of tracked chronic conditions (0-3, based on diabetes + hypertension + heart disease flags)"},{"name":"first_condition_date","data_type":null,"description":"Date of earliest condition diagnosis for this patient"},{"name":"has_diabetes","data_type":null,"description":"Boolean flag indicating if patient has any diabetes-related condition"},{"name":"has_heart_disease","data_type":null,"description":"Boolean flag indicating if patient has any heart disease condition"},{"name":"has_hypertension","data_type":null,"description":"Boolean flag indicating if patient has hypertension or high blood pressure"},{"name":"last_condition_date","data_type":null,"description":"Date of most recent condition diagnosis for this patient"},{"name":"patient_id","data_type":null,"description":"Unique patient identifier (UUID), sourced from current dim_patients records"},{"name":"total_conditions","data_type":null,"description":"Total number of conditions ever diagnosed for this patient"}],"grain":{"value":"patient_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"patient_id","origin":"test.healthcare_analytics.unique_int_patients__with_conditions_patient_id.dbb08a220b"}]}},"paths":{"sql":"models/intermediate/healthcare/int_patients__with_conditions.sql","schema_yaml":"models/intermediate/healthcare/_healthcare__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.mart_date_state_grid","name":"mart_date_state_grid","node_type":"model","not_compiled":false,"data_tests":5,"unit_tests":1,"badge":"5 data-tests · 1 unit-test","detail":{"description":"Dense month x state reporting scaffold.\nOne row per (calendar month x patient state) combination — the full\ncartesian product of dim_date months and the non-null states observed\nin patient staging. Left-join sparse activity facts against this grid\nso zero-activity cells render as explicit zeros.\nGrain: month_key x state\n\nUse cases:\n- Dense time-series dashboards (no missing month/state cells)\n- Zero-activity gap detection\n- cute-dbt cross-join CTE-edge demo (cute-dbt#64)\n","materialized":"table","tags":["analytics","reporting","marts"],"meta":[{"key":"grain","value":"month_key x state"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Dense reporting grids\",\"Zero-activity gap detection\"]"}],"columns":[{"name":"month_actual","data_type":null,"description":"Calendar month number (1-12) of the grid cell"},{"name":"month_key","data_type":null,"description":"Month surrogate key in YYYYMM integer form (e.g., 202401)"},{"name":"month_name","data_type":null,"description":"Full month name (e.g., January)"},{"name":"state","data_type":null,"description":"Patient state, distinct and non-null from staging"},{"name":"year_actual","data_type":null,"description":"Calendar year of the grid cell"}],"grain":{"value":"month_key x state","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"month_key x state","origin":"config.meta.grain"},{"kind":"compound-unique test","value":"month_key, state","origin":"test.healthcare_analytics.dbt_utils_unique_combination_of_columns_mart_date_state_grid_month_key__state.507f3592d3"}]}},"paths":{"sql":"models/marts/analytics/mart_date_state_grid.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[{"name":"test_mart_date_state_grid_cross_joins_months_and_states","yaml":"models/marts/analytics/_analytics__models.yml","fixtures":["tests/fixtures/mart_date_state_grid_patients.csv"]}]}},{"id":"model.healthcare_analytics.mart_dq_summary","name":"mart_dq_summary","node_type":"model","not_compiled":false,"data_tests":5,"unit_tests":2,"badge":"5 data-tests · 2 unit-tests","detail":{"description":"Data quality summary metrics for monitoring quarantine rates and validation failures.\nOne row per entity type (encounters, medications) with quarantine counts and failure breakdowns.\nGrain: entity_type\n\nUse cases:\n- Data quality monitoring dashboards\n- Quarantine rate trending\n- Validation failure root cause analysis\n- Data quality SLA tracking\n","materialized":"table","tags":["analytics","data_quality","marts"],"meta":[{"key":"grain","value":"entity_type"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Data quality dashboards\",\"Quarantine monitoring\",\"Data quality alerting\"]"}],"columns":[{"name":"_generated_at","data_type":null,"description":"Timestamp when summary was generated"},{"name":"entity_type","data_type":null,"description":"Type of entity being measured (encounters, medications)"},{"name":"failed_future_date_validations","data_type":null,"description":"Count of records with future dates"},{"name":"failed_historical_end_validations","data_type":null,"description":"Count of records with end dates before 1900"},{"name":"failed_historical_start_validations","data_type":null,"description":"Count of records with start dates before 1900"},{"name":"failed_timestamp_validations","data_type":null,"description":"Count of records failing timestamp/date sequence validations"},{"name":"quarantine_rate_pct","data_type":null,"description":"Percentage of records quarantined (quarantined_count / total_count * 100)"},{"name":"quarantined_count","data_type":null,"description":"Number of records failing data quality validations"},{"name":"total_count","data_type":null,"description":"Total number of records (valid + quarantined)"}],"grain":{"value":"entity_type","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"entity_type","origin":"config.meta.grain"}]}},"paths":{"sql":"models/marts/analytics/mart_dq_summary.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[{"name":"test_mart_dq_summary_combines_encounter_and_medication_metrics","yaml":"models/marts/analytics/_analytics__models.yml","fixtures":[]},{"name":"test_mart_dq_summary_zero_quarantined_when_all_valid","yaml":"models/marts/analytics/_analytics__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.stg_synthea__conditions","name":"stg_synthea__conditions","node_type":"model","not_compiled":false,"data_tests":12,"unit_tests":0,"badge":"12 data-tests · 0 unit-tests","detail":{"description":"Staging model for patient conditions/diagnoses. One row per condition instance with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"condition_code","data_type":null,"description":"SNOMED CT code for the condition"},{"name":"condition_description","data_type":null,"description":"Description of the condition"},{"name":"condition_end_date","data_type":null,"description":"Date when condition resolved (null if ongoing)"},{"name":"condition_id","data_type":null,"description":"Surrogate key for the condition record"},{"name":"condition_start_date","data_type":null,"description":"Date when condition was diagnosed"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"}],"grain":{"value":"condition_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"condition_id","origin":"test.healthcare_analytics.unique_stg_synthea__conditions_condition_id.46692af443"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__conditions.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__encounters","name":"stg_synthea__encounters","node_type":"model","not_compiled":false,"data_tests":19,"unit_tests":0,"badge":"19 data-tests · 0 unit-tests","detail":{"description":"Staging model for healthcare encounters/visits. One row per encounter with patient, provider, organization, and payer relationships.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"base_encounter_cost","data_type":null,"description":"Base cost of the encounter"},{"name":"encounter_class","data_type":null,"description":"Type of encounter (ambulatory, wellness, emergency, etc.)"},{"name":"encounter_code","data_type":null,"description":"SNOMED CT code for the encounter type"},{"name":"encounter_description","data_type":null,"description":"Description of the encounter type"},{"name":"encounter_end_at","data_type":null,"description":"End timestamp of the encounter"},{"name":"encounter_id","data_type":null,"description":"Unique encounter identifier (UUID)"},{"name":"encounter_start_at","data_type":null,"description":"Start timestamp of the encounter"},{"name":"organization_id","data_type":null,"description":"Foreign key to the organization"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by payer"},{"name":"payer_id","data_type":null,"description":"Foreign key to the payer"},{"name":"provider_id","data_type":null,"description":"Foreign key to the provider"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of visit"},{"name":"reason_description","data_type":null,"description":"Description of the reason for visit"},{"name":"total_claim_cost","data_type":null,"description":"Total claim cost"}],"grain":{"value":"encounter_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"encounter_id","origin":"test.healthcare_analytics.unique_stg_synthea__encounters_encounter_id.12bf18bf09"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__encounters.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__medications","name":"stg_synthea__medications","node_type":"model","not_compiled":false,"data_tests":18,"unit_tests":0,"badge":"18 data-tests · 0 unit-tests","detail":{"description":"Staging model for prescribed medications. One row per medication prescription with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"base_cost","data_type":null,"description":"Base cost per dispense"},{"name":"dispenses","data_type":null,"description":"Number of times medication was dispensed"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter"},{"name":"medication_code","data_type":null,"description":"RxNorm code for the medication"},{"name":"medication_description","data_type":null,"description":"Description of the medication"},{"name":"medication_end_at","data_type":null,"description":"Timestamp when medication ended (null if ongoing)"},{"name":"medication_id","data_type":null,"description":"Surrogate key for the medication record"},{"name":"medication_start_at","data_type":null,"description":"Timestamp when medication was prescribed"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by payer"},{"name":"payer_id","data_type":null,"description":"Foreign key to the payer"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of medication"},{"name":"reason_description","data_type":null,"description":"Description of the reason for medication"},{"name":"total_cost","data_type":null,"description":"Total cost of all dispenses"}],"grain":{"value":"medication_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"medication_id","origin":"test.healthcare_analytics.unique_stg_synthea__medications_medication_id.eb3ad4ae13"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__medications.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__observations","name":"stg_synthea__observations","node_type":"model","not_compiled":false,"data_tests":10,"unit_tests":0,"badge":"10 data-tests · 0 unit-tests","detail":{"description":"Staging model for clinical observations (vital signs, lab results). One row per observation with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter. Note: ~10% of observations have null encounter_id (from external sources or historical data imports).\n"},{"name":"observation_at","data_type":null,"description":"Timestamp when observation was recorded"},{"name":"observation_code","data_type":null,"description":"LOINC code for the observation"},{"name":"observation_description","data_type":null,"description":"Description of the observation"},{"name":"observation_id","data_type":null,"description":"Surrogate key for the observation record"},{"name":"observation_type","data_type":null,"description":"Type of observation (numeric, text, etc.)"},{"name":"observation_value","data_type":null,"description":"Value of the observation (stored as string)"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"units","data_type":null,"description":"Units of measurement"}],"grain":{"value":"observation_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"observation_id","origin":"test.healthcare_analytics.unique_stg_synthea__observations_observation_id.c28ceeac85"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__observations.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__organizations","name":"stg_synthea__organizations","node_type":"model","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Staging model for healthcare organizations/facilities. One row per organization with location and performance metrics.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Unique organization identifier (UUID)"},{"name":"organization_name","data_type":null,"description":"Name of the healthcare organization"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"organization_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"organization_id","origin":"test.healthcare_analytics.unique_stg_synthea__organizations_organization_id.23afabbc76"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__organizations.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__patients","name":"stg_synthea__patients","node_type":"model","not_compiled":false,"data_tests":14,"unit_tests":1,"badge":"14 data-tests · 1 unit-test","detail":{"description":"Staging model for patient demographics and identifiers. One row per patient with personal information, location, and financial data.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"birth_date","data_type":null,"description":"Patient date of birth"},{"name":"birth_place","data_type":null,"description":"Place of birth"},{"name":"city","data_type":null,"description":"City of residence"},{"name":"county","data_type":null,"description":"County of residence"},{"name":"death_date","data_type":null,"description":"Patient date of death (null if alive)"},{"name":"drivers_license","data_type":null,"description":"Driver's license number"},{"name":"ethnicity","data_type":null,"description":"Patient ethnicity (hispanic or nonhispanic)"},{"name":"first_name","data_type":null,"description":"Patient's first name"},{"name":"gender","data_type":null,"description":"Patient gender (M or F)"},{"name":"healthcare_coverage","data_type":null,"description":"Total healthcare coverage received"},{"name":"healthcare_expenses","data_type":null,"description":"Total healthcare expenses incurred"},{"name":"last_name","data_type":null,"description":"Patient's last name"},{"name":"latitude","data_type":null,"description":"Latitude coordinate of residence"},{"name":"longitude","data_type":null,"description":"Longitude coordinate of residence"},{"name":"maiden_name","data_type":null,"description":"Maiden name (if applicable)"},{"name":"marital_status","data_type":null,"description":"Marital status (M=Married, S=Single, or blank)"},{"name":"name_prefix","data_type":null,"description":"Name prefix (Mr., Mrs., Ms., etc.)"},{"name":"name_suffix","data_type":null,"description":"Name suffix (Jr., Sr., III, etc.)"},{"name":"passport_number","data_type":null,"description":"Passport number"},{"name":"patient_id","data_type":null,"description":"Unique patient identifier (UUID)"},{"name":"race","data_type":null,"description":"Patient race"},{"name":"ssn_hash","data_type":null,"description":"MD5 hash of Social Security Number (masked for privacy)"},{"name":"state","data_type":null,"description":"State of residence (full state name, e.g., Massachusetts)"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"patient_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"patient_id","origin":"test.healthcare_analytics.unique_stg_synthea__patients_patient_id.ee61748f4d"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__patients.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[{"name":"test_stg_synthea__patients_renames_and_hashes_source_columns","yaml":"models/staging/synthea/_synthea__models.yml","fixtures":[]}]}},{"id":"model.healthcare_analytics.stg_synthea__payers","name":"stg_synthea__payers","node_type":"model","not_compiled":false,"data_tests":6,"unit_tests":0,"badge":"6 data-tests · 0 unit-tests","detail":{"description":"Staging model for insurance payers. One row per payer with contact information and aggregate metrics.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"amount_covered","data_type":null,"description":"Total amount covered by payer"},{"name":"amount_uncovered","data_type":null,"description":"Total amount not covered by payer"},{"name":"average_quality_of_life_score","data_type":null,"description":"Average quality of life score for members"},{"name":"city","data_type":null,"description":"City"},{"name":"covered_encounters","data_type":null,"description":"Number of encounters covered"},{"name":"covered_immunizations","data_type":null,"description":"Number of immunizations covered"},{"name":"covered_medications","data_type":null,"description":"Number of medications covered"},{"name":"covered_procedures","data_type":null,"description":"Number of procedures covered"},{"name":"member_months","data_type":null,"description":"Total member months"},{"name":"payer_id","data_type":null,"description":"Unique payer identifier (UUID)"},{"name":"payer_name","data_type":null,"description":"Name of the insurance payer"},{"name":"phone","data_type":null,"description":"Phone number"},{"name":"revenue","data_type":null,"description":"Total revenue collected"},{"name":"state","data_type":null,"description":"State where headquartered"},{"name":"uncovered_encounters","data_type":null,"description":"Number of encounters not covered"},{"name":"uncovered_immunizations","data_type":null,"description":"Number of immunizations not covered"},{"name":"uncovered_medications","data_type":null,"description":"Number of medications not covered"},{"name":"uncovered_procedures","data_type":null,"description":"Number of procedures not covered"},{"name":"unique_customers","data_type":null,"description":"Number of unique customers"},{"name":"zip_code","data_type":null,"description":"ZIP code (stored as numeric, 5 digits)"}],"grain":{"value":"payer_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"payer_id","origin":"test.healthcare_analytics.unique_stg_synthea__payers_payer_id.31542848ee"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__payers.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__procedures","name":"stg_synthea__procedures","node_type":"model","not_compiled":false,"data_tests":12,"unit_tests":0,"badge":"12 data-tests · 0 unit-tests","detail":{"description":"Staging model for medical procedures performed. One row per procedure instance with surrogate key.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"base_cost","data_type":null,"description":"Base cost of the procedure"},{"name":"encounter_id","data_type":null,"description":"Foreign key to the encounter"},{"name":"patient_id","data_type":null,"description":"Foreign key to the patient"},{"name":"procedure_at","data_type":null,"description":"Timestamp when the procedure was performed"},{"name":"procedure_code","data_type":null,"description":"SNOMED CT code for the procedure"},{"name":"procedure_description","data_type":null,"description":"Description of the procedure"},{"name":"procedure_id","data_type":null,"description":"Surrogate key for the procedure record"},{"name":"reason_code","data_type":null,"description":"SNOMED CT code for the reason of the procedure"},{"name":"reason_description","data_type":null,"description":"Description of the reason for the procedure"}],"grain":{"value":"procedure_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"procedure_id","origin":"test.healthcare_analytics.unique_stg_synthea__procedures_procedure_id.73412d7f5a"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__procedures.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.stg_synthea__providers","name":"stg_synthea__providers","node_type":"model","not_compiled":false,"data_tests":11,"unit_tests":0,"badge":"11 data-tests · 0 unit-tests","detail":{"description":"Staging model for healthcare providers (doctors, nurses, etc.). One row per provider with specialization and affiliated organization.\n","materialized":"view","tags":[],"meta":[],"columns":[{"name":"_loaded_at","data_type":null,"description":"Timestamp when record was loaded into staging"},{"name":"address","data_type":null,"description":"Street address"},{"name":"city","data_type":null,"description":"City"},{"name":"gender","data_type":null,"description":"Provider gender (M or F)"},{"name":"latitude","data_type":null,"description":"Latitude coordinate"},{"name":"longitude","data_type":null,"description":"Longitude coordinate"},{"name":"organization_id","data_type":null,"description":"Foreign key to the provider's organization"},{"name":"provider_id","data_type":null,"description":"Unique provider identifier (UUID)"},{"name":"provider_name","data_type":null,"description":"Full name of the provider"},{"name":"specialty","data_type":null,"description":"Medical specialty"},{"name":"state","data_type":null,"description":"State (full state name)"},{"name":"utilization","data_type":null,"description":"Total utilization count"},{"name":"zip_code","data_type":null,"description":"ZIP code"}],"grain":{"value":"provider_id","source":"unique test","known":true,"detected":[{"kind":"unique test","value":"provider_id","origin":"test.healthcare_analytics.unique_stg_synthea__providers_provider_id.4cb7d0e670"}]}},"paths":{"sql":"models/staging/synthea/stg_synthea__providers.sql","schema_yaml":"models/staging/synthea/_synthea__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.v_encounter_summary","name":"v_encounter_summary","node_type":"model","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"0 data-tests · 0 unit-tests","detail":{"description":"Enriched encounter view with dimension attributes for ad-hoc analysis.\nEphemeral (not persisted) - used as a building block for other queries.\nJoins encounters with patient, provider, organization, and payer details.\n\nUse cases:\n- Ad-hoc encounter analysis\n- Building block for custom reports\n- Quick encounter lookups with full context\n","materialized":"ephemeral","tags":["analytics","marts","view"],"meta":[],"columns":[{"name":"encounter_class","data_type":null,"description":"Type of encounter"},{"name":"encounter_date","data_type":null,"description":"Date of the encounter"},{"name":"encounter_id","data_type":null,"description":"Unique encounter identifier"},{"name":"organization_id","data_type":null,"description":"Organization identifier"},{"name":"organization_name","data_type":null,"description":"Organization name"},{"name":"patient_id","data_type":null,"description":"Patient identifier"},{"name":"patient_name","data_type":null,"description":"Full patient name"},{"name":"patient_responsibility","data_type":null,"description":"Amount owed by patient"},{"name":"payer_coverage","data_type":null,"description":"Amount covered by insurance"},{"name":"payer_id","data_type":null,"description":"Payer identifier"},{"name":"payer_name","data_type":null,"description":"Payer name"},{"name":"provider_id","data_type":null,"description":"Provider identifier"},{"name":"provider_name","data_type":null,"description":"Full provider name"},{"name":"total_cost","data_type":null,"description":"Total claim cost"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"models/marts/analytics/views/v_encounter_summary.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.v_patient_current_conditions","name":"v_patient_current_conditions","node_type":"model","not_compiled":false,"data_tests":1,"unit_tests":0,"badge":"1 data-test · 0 unit-tests","detail":{"description":"Current (active) conditions for each patient, filtered from fct_condition_cohorts.\nUse for patient panels, disease management dashboards, and care gap identification.\nGrain: (patient_id, condition_code) - only active conditions\n\nUse cases:\n- Patient panel management\n- Active disease registries\n- Care gap identification\n- Real-time patient condition views\n","materialized":"table","tags":["analytics","marts","view"],"meta":[{"key":"example_queries","value":"[{\"description\":\"Get all active conditions for a specific patient\",\"name\":\"Patient active conditions lookup\",\"sql\":\"select\\n    vpcc.patient_id\\n    , vpcc.condition_code\\n    , vpcc.condition_description\\n    , vpcc.first_diagnosis_date\\n    , vpcc.months_with_condition\\n    , vpcc.encounter_count\\nfrom main_marts.v_patient_current_conditions vpcc\\nwhere vpcc.patient_id = 'patient-uuid-here'\\norder by vpcc.first_diagnosis_date\"},{\"description\":\"Count of patients by active condition for disease registries\",\"name\":\"Active condition summary\",\"sql\":\"select\\n    vpcc.condition_code\\n    , vpcc.condition_description\\n    , count(distinct vpcc.patient_id) as active_patient_count\\n    , round(avg(vpcc.months_with_condition), 1) as avg_duration_months\\n    , round(avg(vpcc.encounter_count), 1) as avg_encounters\\nfrom main_marts.v_patient_current_conditions vpcc\\ngroup by 1, 2\\norder by active_patient_count desc\\nlimit 20\"}]"},{"key":"grain","value":"patient_id + condition_code"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Patient panel displays\",\"Active condition registries\",\"Care gap dashboards\"]"}],"columns":[{"name":"condition_code","data_type":null,"description":"ICD/SNOMED condition code"},{"name":"condition_description","data_type":null,"description":"Full condition name"},{"name":"condition_key","data_type":null,"description":"Foreign key to dim_conditions"},{"name":"encounter_count","data_type":null,"description":"Number of encounters with this condition"},{"name":"first_diagnosis_date","data_type":null,"description":"Date of first diagnosis"},{"name":"months_with_condition","data_type":null,"description":"Duration of condition in months"},{"name":"patient_id","data_type":null,"description":"Natural patient identifier"},{"name":"patient_key","data_type":null,"description":"Foreign key to dim_patients"}],"grain":{"value":"patient_id + condition_code","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"patient_id + condition_code","origin":"config.meta.grain"}]}},"paths":{"sql":"models/marts/analytics/views/v_patient_current_conditions.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"model.healthcare_analytics.v_provider_active_patients","name":"v_provider_active_patients","node_type":"model","not_compiled":false,"data_tests":7,"unit_tests":0,"badge":"7 data-tests · 0 unit-tests","detail":{"description":"Active patient count per provider for panel management and workload analysis.\nAggregates patients with active conditions by their treating provider.\nGrain: provider_id\n\nUse cases:\n- Provider panel size management\n- Workload distribution analysis\n- Capacity planning\n- Provider assignment optimization\n","materialized":"table","tags":["analytics","marts","view"],"meta":[{"key":"example_queries","value":"[{\"description\":\"View provider workload by active patient and condition counts\",\"name\":\"Provider panel sizes\",\"sql\":\"select\\n    vpap.provider_id\\n    , vpap.provider_name\\n    , vpap.active_patient_count\\n    , vpap.total_active_conditions\\n    , vpap.avg_conditions_per_patient\\nfrom main_marts.v_provider_active_patients vpap\\nwhere vpap.active_patient_count > 0\\norder by vpap.active_patient_count desc\\nlimit 25\"},{\"description\":\"Analyze distribution of patient panels across providers\",\"name\":\"Provider workload distribution\",\"sql\":\"select\\n    case\\n        when vpap.active_patient_count = 0 then '0'\\n        when vpap.active_patient_count <= 10 then '1-10'\\n        when vpap.active_patient_count <= 50 then '11-50'\\n        when vpap.active_patient_count <= 100 then '51-100'\\n        else '100+'\\n    end as panel_size_bucket\\n    , count(*) as provider_count\\n    , sum(vpap.active_patient_count) as total_patients\\nfrom main_marts.v_provider_active_patients vpap\\ngroup by 1\\norder by 1\"}]"},{"key":"grain","value":"provider_id"},{"key":"owner","value":"healthcare_analytics"},{"key":"uses","value":"[\"Provider panel management\",\"Workload balancing\",\"Capacity planning\"]"}],"columns":[{"name":"active_patient_count","data_type":null,"description":"Number of patients with active conditions"},{"name":"avg_conditions_per_patient","data_type":null,"description":"Average number of active conditions per patient"},{"name":"organization_id","data_type":null,"description":"Natural organization identifier"},{"name":"organization_key","data_type":null,"description":"Foreign key to dim_organizations"},{"name":"provider_id","data_type":null,"description":"Natural provider identifier"},{"name":"provider_key","data_type":null,"description":"Foreign key to dim_providers"},{"name":"provider_name","data_type":null,"description":"Full name of the provider"},{"name":"total_active_conditions","data_type":null,"description":"Total number of active conditions managed"}],"grain":{"value":"provider_id","source":"config.meta.grain","known":true,"detected":[{"kind":"config.meta.grain","value":"provider_id","origin":"config.meta.grain"},{"kind":"unique test","value":"provider_id","origin":"test.healthcare_analytics.unique_v_provider_active_patients_provider_id.68f4dd3a27"},{"kind":"unique test","value":"provider_key","origin":"test.healthcare_analytics.unique_v_provider_active_patients_provider_key.95907c77fb"}]}},"paths":{"sql":"models/marts/analytics/views/v_provider_active_patients.sql","schema_yaml":"models/marts/analytics/_analytics__models.yml","unit_tests":[]}},{"id":"snapshot.healthcare_analytics.snp_patients","name":"snp_patients","node_type":"snapshot","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":"snapshot","tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":"snapshots/snp_patients.sql","schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.allergies","name":"synthea_raw.allergies","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.careplans","name":"synthea_raw.careplans","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.conditions","name":"synthea_raw.conditions","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.devices","name":"synthea_raw.devices","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.encounters","name":"synthea_raw.encounters","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[{"name":"Id","data_type":null,"description":"Unique encounter identifier (UUID)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.imaging_studies","name":"synthea_raw.imaging_studies","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.immunizations","name":"synthea_raw.immunizations","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.medications","name":"synthea_raw.medications","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.observations","name":"synthea_raw.observations","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.organizations","name":"synthea_raw.organizations","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[{"name":"Id","data_type":null,"description":"Unique organization identifier (UUID)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.patients","name":"synthea_raw.patients","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[{"name":"Id","data_type":null,"description":"Unique patient identifier (UUID)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.payer_transitions","name":"synthea_raw.payer_transitions","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.payers","name":"synthea_raw.payers","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[{"name":"Id","data_type":null,"description":"Unique payer identifier (UUID)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.procedures","name":"synthea_raw.procedures","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.providers","name":"synthea_raw.providers","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[{"name":"Id","data_type":null,"description":"Unique provider identifier (UUID)"}],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}},{"id":"source.healthcare_analytics.synthea_raw.supplies","name":"synthea_raw.supplies","node_type":"source","not_compiled":false,"data_tests":0,"unit_tests":0,"badge":"","detail":{"description":null,"materialized":null,"tags":[],"meta":[],"columns":[],"grain":{"value":"unknown","source":"unknown","known":false,"detected":[]}},"paths":{"sql":null,"schema_yaml":null,"unit_tests":[]}}],"edges":[{"from":"model.healthcare_analytics.dim_conditions","to":"model.healthcare_analytics.fct_condition_cohorts"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_cost_analysis"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_encounters_monthly"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_encounters_yearly"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.fct_provider_metrics"},{"from":"model.healthcare_analytics.dim_date","to":"model.healthcare_analytics.mart_date_state_grid"},{"from":"model.healthcare_analytics.dim_organizations","to":"model.healthcare_analytics.dim_providers"},{"from":"model.healthcare_analytics.dim_organizations","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_organizations","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.fct_condition_cohorts"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.int_patients__with_conditions"},{"from":"model.healthcare_analytics.dim_patients","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_payers","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_payers","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_providers","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.dim_providers","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.dim_providers","to":"model.healthcare_analytics.v_provider_active_patients"},{"from":"model.healthcare_analytics.fct_condition_cohorts","to":"model.healthcare_analytics.v_patient_current_conditions"},{"from":"model.healthcare_analytics.fct_condition_cohorts","to":"model.healthcare_analytics.v_provider_active_patients"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_cost_analysis"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_encounters_monthly"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_encounters_yearly"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.fct_provider_metrics"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.v_encounter_summary"},{"from":"model.healthcare_analytics.fct_encounters","to":"model.healthcare_analytics.v_provider_active_patients"},{"from":"model.healthcare_analytics.fct_provider_metrics","to":"exposure.healthcare_analytics.provider_quality_dashboard"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.dim_conditions"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.fct_condition_cohorts"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.stg_synthea__conditions","to":"model.healthcare_analytics.int_patients__with_conditions"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.fct_encounters"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.fct_encounters_incremental"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.int_dq_quarantine__encounters"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.int_patients__never_admitted"},{"from":"model.healthcare_analytics.stg_synthea__encounters","to":"model.healthcare_analytics.mart_dq_summary"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.int_dq_quarantine__medications"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.stg_synthea__medications","to":"model.healthcare_analytics.mart_dq_summary"},{"from":"model.healthcare_analytics.stg_synthea__organizations","to":"model.healthcare_analytics.dim_organizations"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"model.healthcare_analytics.dim_patients"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"model.healthcare_analytics.int_patients__never_admitted"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"model.healthcare_analytics.mart_date_state_grid"},{"from":"model.healthcare_analytics.stg_synthea__patients","to":"snapshot.healthcare_analytics.snp_patients"},{"from":"model.healthcare_analytics.stg_synthea__payers","to":"model.healthcare_analytics.dim_payers"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_clinical_events"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_cost_analysis"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_patient_summary"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.fct_provider_metrics"},{"from":"model.healthcare_analytics.stg_synthea__procedures","to":"model.healthcare_analytics.int_encounters__enriched"},{"from":"model.healthcare_analytics.stg_synthea__providers","to":"model.healthcare_analytics.dim_providers"},{"from":"snapshot.healthcare_analytics.snp_patients","to":"model.healthcare_analytics.dim_patients"},{"from":"source.healthcare_analytics.synthea_raw.conditions","to":"model.healthcare_analytics.stg_synthea__conditions"},{"from":"source.healthcare_analytics.synthea_raw.encounters","to":"model.healthcare_analytics.stg_synthea__encounters"},{"from":"source.healthcare_analytics.synthea_raw.medications","to":"model.healthcare_analytics.stg_synthea__medications"},{"from":"source.healthcare_analytics.synthea_raw.observations","to":"model.healthcare_analytics.stg_synthea__observations"},{"from":"source.healthcare_analytics.synthea_raw.organizations","to":"model.healthcare_analytics.stg_synthea__organizations"},{"from":"source.healthcare_analytics.synthea_raw.patients","to":"model.healthcare_analytics.stg_synthea__patients"},{"from":"source.healthcare_analytics.synthea_raw.payers","to":"model.healthcare_analytics.stg_synthea__payers"},{"from":"source.healthcare_analytics.synthea_raw.procedures","to":"model.healthcare_analytics.stg_synthea__procedures"},{"from":"source.healthcare_analytics.synthea_raw.providers","to":"model.healthcare_analytics.stg_synthea__providers"}],"cte_dags":{"model.healthcare_analytics.dim_conditions":{"nodes":[{"id":"conditions_source","role":"import"},{"id":"condition_aggregates","role":"transform"},{"id":"deduped","role":"transform"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_conditions.sql","role":"final"}],"edges":[{"from":"conditions_source","to":"condition_aggregates","edge_type":"from"},{"from":"condition_aggregates","to":"deduped","edge_type":"from"},{"from":"deduped","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_date":{"nodes":[{"id":"date_spine","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_date.sql","role":"final"}],"edges":[{"from":"date_spine","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_organizations":{"nodes":[{"id":"source","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_organizations.sql","role":"final"}],"edges":[{"from":"source","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_patients":{"nodes":[{"id":"snapshot_source","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_patients.sql","role":"final"}],"edges":[{"from":"snapshot_source","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_payers":{"nodes":[{"id":"source","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_payers.sql","role":"final"}],"edges":[{"from":"source","to":"sequenced","edge_type":"from"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.dim_providers":{"nodes":[{"id":"providers","role":"import"},{"id":"organizations","role":"import"},{"id":"sequenced","role":"transform"},{"id":"unknown_member","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"dim_providers.sql","role":"final"}],"edges":[{"from":"providers","to":"sequenced","edge_type":"from"},{"from":"organizations","to":"sequenced","edge_type":"left"},{"from":"unknown_member","to":"final","edge_type":"union_all"},{"from":"sequenced","to":"final","edge_type":"union_all"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_clinical_events":{"nodes":[{"id":"valid_encounters","role":"import"},{"id":"conditions","role":"import"},{"id":"medications","role":"import"},{"id":"procedures","role":"import"},{"id":"all_events","role":"transform"},{"id":"patients","role":"import"},{"id":"dim_date","role":"import"},{"id":"encounters","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_clinical_events.sql","role":"final"}],"edges":[{"from":"conditions","to":"all_events","edge_type":"union_all"},{"from":"medications","to":"all_events","edge_type":"union_all"},{"from":"procedures","to":"all_events","edge_type":"union_all"},{"from":"all_events","to":"final","edge_type":"from"},{"from":"patients","to":"final","edge_type":"left"},{"from":"encounters","to":"final","edge_type":"left"},{"from":"dim_date","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_condition_cohorts":{"nodes":[{"id":"conditions_source","role":"import"},{"id":"patients","role":"import"},{"id":"dim_conditions","role":"import"},{"id":"condition_windows","role":"transform"},{"id":"with_dimensions","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_condition_cohorts.sql","role":"final"}],"edges":[{"from":"conditions_source","to":"condition_windows","edge_type":"from"},{"from":"condition_windows","to":"with_dimensions","edge_type":"from"},{"from":"patients","to":"with_dimensions","edge_type":"left"},{"from":"dim_conditions","to":"with_dimensions","edge_type":"left"},{"from":"with_dimensions","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_cost_analysis":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"procedures","role":"import"},{"id":"encounters_enriched","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_cost_analysis.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_enriched","edge_type":"from"},{"from":"dim_date","to":"encounters_enriched","edge_type":"left"},{"from":"procedures","to":"encounters_enriched","edge_type":"left"},{"from":"encounters_enriched","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters":{"nodes":[{"id":"encounters","role":"import"},{"id":"patients","role":"import"},{"id":"providers","role":"import"},{"id":"organizations","role":"import"},{"id":"payers","role":"import"},{"id":"dim_date","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_encounters.sql","role":"final"}],"edges":[{"from":"encounters","to":"final","edge_type":"from"},{"from":"patients","to":"final","edge_type":"left"},{"from":"providers","to":"final","edge_type":"left"},{"from":"organizations","to":"final","edge_type":"left"},{"from":"payers","to":"final","edge_type":"left"},{"from":"dim_date","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters_incremental":{"nodes":[{"id":"source","role":"import"},{"id":"(final select)","label":"fct_encounters_incremental.sql","role":"final"}],"edges":[{"from":"source","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters_monthly":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"encounters_with_date","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_encounters_monthly.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_date","edge_type":"from"},{"from":"dim_date","to":"encounters_with_date","edge_type":"inner"},{"from":"encounters_with_date","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_encounters_yearly":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"encounters_with_date","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_encounters_yearly.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_date","edge_type":"from"},{"from":"dim_date","to":"encounters_with_date","edge_type":"inner"},{"from":"encounters_with_date","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_patient_summary":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"procedures","role":"import"},{"id":"conditions","role":"import"},{"id":"encounters_with_year","role":"transform"},{"id":"conditions_per_patient_year","role":"transform"},{"id":"patient_year_agg","role":"transform"},{"id":"with_conditions","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_patient_summary.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_year","edge_type":"from"},{"from":"dim_date","to":"encounters_with_year","edge_type":"inner"},{"from":"procedures","to":"encounters_with_year","edge_type":"left"},{"from":"conditions","to":"conditions_per_patient_year","edge_type":"from"},{"from":"encounters_with_year","to":"patient_year_agg","edge_type":"from"},{"from":"patient_year_agg","to":"with_conditions","edge_type":"from"},{"from":"conditions_per_patient_year","to":"with_conditions","edge_type":"left"},{"from":"with_conditions","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.fct_provider_metrics":{"nodes":[{"id":"encounters","role":"import"},{"id":"dim_date","role":"import"},{"id":"procedures","role":"import"},{"id":"encounters_with_date","role":"transform"},{"id":"provider_month_agg","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"fct_provider_metrics.sql","role":"final"}],"edges":[{"from":"encounters","to":"encounters_with_date","edge_type":"from"},{"from":"dim_date","to":"encounters_with_date","edge_type":"inner"},{"from":"procedures","to":"encounters_with_date","edge_type":"left"},{"from":"encounters_with_date","to":"provider_month_agg","edge_type":"from"},{"from":"provider_month_agg","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.int_encounters__enriched":{"nodes":[{"id":"encounters","role":"import"},{"id":"conditions","role":"import"},{"id":"medications","role":"import"},{"id":"procedures","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"int_encounters__enriched.sql","role":"final"}],"edges":[{"from":"encounters","to":"final","edge_type":"from"},{"from":"conditions","to":"final","edge_type":"left"},{"from":"medications","to":"final","edge_type":"left"},{"from":"procedures","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.int_patients__with_conditions":{"nodes":[{"id":"patients","role":"import"},{"id":"conditions","role":"import"},{"id":"condition_stats","role":"transform"},{"id":"chronic_flags","role":"transform"},{"id":"chronic_count","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"int_patients__with_conditions.sql","role":"final"}],"edges":[{"from":"conditions","to":"condition_stats","edge_type":"from"},{"from":"conditions","to":"chronic_flags","edge_type":"from"},{"from":"chronic_flags","to":"chronic_count","edge_type":"from"},{"from":"patients","to":"final","edge_type":"from"},{"from":"condition_stats","to":"final","edge_type":"left"},{"from":"chronic_flags","to":"final","edge_type":"left"},{"from":"chronic_count","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.mart_date_state_grid":{"nodes":[{"id":"months","role":"import"},{"id":"states","role":"import"},{"id":"grid","role":"transform"},{"id":"(final select)","label":"mart_date_state_grid.sql","role":"final"}],"edges":[{"from":"months","to":"grid","edge_type":"from"},{"from":"states","to":"grid","edge_type":"cross"},{"from":"grid","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.mart_dq_summary":{"nodes":[{"id":"encounter_metrics","role":"import"},{"id":"medication_metrics","role":"import"},{"id":"combined_metrics","role":"transform"},{"id":"(final select)","label":"mart_dq_summary.sql","role":"final"}],"edges":[{"from":"encounter_metrics","to":"combined_metrics","edge_type":"union_all"},{"from":"medication_metrics","to":"combined_metrics","edge_type":"union_all"},{"from":"combined_metrics","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__conditions":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__conditions.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__encounters":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_dq_flags","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__encounters.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_dq_flags","edge_type":"from"},{"from":"with_dq_flags","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__medications":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_row_number","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"with_dq_flags","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__medications.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_row_number","edge_type":"from"},{"from":"with_row_number","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"with_dq_flags","edge_type":"from"},{"from":"with_dq_flags","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__observations":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_row_number","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__observations.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_row_number","edge_type":"from"},{"from":"with_row_number","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__organizations":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__organizations.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__patients":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__patients.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__payers":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__payers.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__procedures":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"with_surrogate_key","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__procedures.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"with_surrogate_key","edge_type":"from"},{"from":"with_surrogate_key","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.stg_synthea__providers":{"nodes":[{"id":"source","role":"import"},{"id":"renamed","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"stg_synthea__providers.sql","role":"final"}],"edges":[{"from":"source","to":"renamed","edge_type":"from"},{"from":"renamed","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.v_encounter_summary":{"nodes":[{"id":"encounters","role":"import"},{"id":"patients","role":"import"},{"id":"providers","role":"import"},{"id":"organizations","role":"import"},{"id":"payers","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"v_encounter_summary.sql","role":"final"}],"edges":[{"from":"encounters","to":"final","edge_type":"from"},{"from":"patients","to":"final","edge_type":"left"},{"from":"providers","to":"final","edge_type":"left"},{"from":"organizations","to":"final","edge_type":"left"},{"from":"payers","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.v_patient_current_conditions":{"nodes":[{"id":"condition_cohorts","role":"import"},{"id":"final","role":"transform"},{"id":"(final select)","label":"v_patient_current_conditions.sql","role":"final"}],"edges":[{"from":"condition_cohorts","to":"final","edge_type":"from"},{"from":"final","to":"(final select)","edge_type":"from"}]},"model.healthcare_analytics.v_provider_active_patients":{"nodes":[{"id":"providers","role":"import"},{"id":"current_conditions","role":"import"},{"id":"patient_recent_encounters","role":"import"},{"id":"patient_provider_assignment","role":"transform"},{"id":"active_conditions_by_provider","role":"transform"},{"id":"provider_summary","role":"transform"},{"id":"final","role":"transform"},{"id":"(final select)","label":"v_provider_active_patients.sql","role":"final"}],"edges":[{"from":"patient_recent_encounters","to":"patient_provider_assignment","edge_type":"from"},{"from":"current_conditions","to":"active_conditions_by_provider","edge_type":"from"},{"from":"patient_provider_assignment","to":"active_conditions_by_provider","edge_type":"inner"},{"from":"active_conditions_by_provider","to":"provider_summary","edge_type":"from"},{"from":"providers","to":"final","edge_type":"from"},{"from":"provider_summary","to":"final","edge_type":"left"},{"from":"final","to":"(final select)","edge_type":"from"}]}}}</script>
 
 <script>
 
@@ -1217,12 +1235,17 @@ <h1>Model lineage</h1>
   var MAX_TEXT_WIDTH = 274;
   var measureCtx = document.createElement("canvas").getContext("2d");
   measureCtx.font = "13px " + FONT_STACK;
-  function nodeWidth(name, badge) {
+  // cute-dbt#253 — per-type horizontal padding: non-rectangular shapes
+  // (ellipse / barrel / round-tag) inscribe less text than a rectangle,
+  // so their labels need wider boxes to stay un-clipped.
+  var TYPE_PAD = { model: 26, snapshot: 34, seed: 44, source: 44, exposure: 44 };
+  function nodeWidth(name, badge, type) {
     var widest = Math.max(
       measureCtx.measureText(name).width,
       measureCtx.measureText(badge).width
     );
-    return Math.min(300, Math.ceil(widest) + 26);
+    var pad = TYPE_PAD[type] || 26;
+    return Math.min(300, Math.ceil(widest) + pad);
   }
   // Manual single-line ellipsis (the label is two lines under
   // `text-wrap: wrap` for the cute-dbt#103 badge, so Cytoscape's
@@ -1247,6 +1270,10 @@ <h1>Model lineage</h1>
     // are manifest test-count facts, not check-engine output.
     var name = ellipsize(String(n.name || n.id));
     var badge = String(n.badge || "");
+    // cute-dbt#253 — the typed-node vocabulary (model / snapshot / seed
+    // / source / exposure), the style/shape hook below. Pre-#253
+    // payloads carried models only; default accordingly.
+    var type = String(n.node_type || "model");
     elements.push({
       group: "nodes",
       // The element id is the full manifest node id. It is only ever
@@ -1256,7 +1283,8 @@ <h1>Model lineage</h1>
       data: {
         id: n.id,
         label: badge ? name + "\n" + badge : name,
-        w: nodeWidth(name, badge),
+        w: nodeWidth(name, badge, type),
+        type: type,
         notCompiled: n.not_compiled ? 1 : 0,
         // cute-dbt#106 — PR-diff change context. The payload omits the
         // key entirely on a no-context render, so `n.changed` is
@@ -1295,6 +1323,37 @@ <h1>Model lineage</h1>
       "transition-property": "opacity",
       "transition-duration": 120
     }},
+    // cute-dbt#253 — the typed-node vocabulary. Redundant coding (shape
+    // AND canvas-paired color) so the typing never rides color alone;
+    // the dag.html legend chips mirror these exact fills/strokes (the
+    // report's fixed-DAG-palette posture — identical in every theme).
+    // The explicit model selector restates the base style so the
+    // node-vocab completeness guard greps one selector per wire key.
+    { selector: 'node[type = "model"]', style: {
+      "shape": "round-rectangle",
+      "background-color": "#e8f1f8",
+      "border-color": "#0072B2"
+    }},
+    { selector: 'node[type = "snapshot"]', style: {
+      "shape": "cut-rectangle",
+      "background-color": "#f1ecf9",
+      "border-color": "#7b5ea7"
+    }},
+    { selector: 'node[type = "seed"]', style: {
+      "shape": "barrel",
+      "background-color": "#e6f4f2",
+      "border-color": "#00756d"
+    }},
+    { selector: 'node[type = "source"]', style: {
+      "shape": "ellipse",
+      "background-color": "#eef7ee",
+      "border-color": "#1f8a5b"
+    }},
+    { selector: 'node[type = "exposure"]', style: {
+      "shape": "round-tag",
+      "background-color": "#f4f4f5",
+      "border-color": "#6b6b76"
+    }},
     { selector: "node[notCompiled = 1]", style: {
       "background-color": "#f4f4f5",
       "border-color": "#b07400",
@@ -1427,9 +1486,17 @@ <h1>Model lineage</h1>
     var n = nodeById[id];
     if (!card || !n) return;
     var d = n.detail;
+    // cute-dbt#253 — type-aware facts: code-bearing nodes-map types
+    // carry files/grain; sources/exposures honestly omit what they
+    // structurally cannot have.
+    var type = String(n.node_type || "model");
+    var codeBearing = type === "model" || type === "snapshot" || type === "seed";
     while (card.firstChild) card.removeChild(card.firstChild);
 
     card.appendChild(el("h2", null, n.name || n.id));
+    if (type !== "model") {
+      card.appendChild(el("span", "detail-type type-" + type, type));
+    }
     if (n.not_compiled) {
       card.appendChild(el("span", "detail-notcompiled", "not compiled"));
     }
@@ -1443,11 +1510,17 @@ <h1>Model lineage</h1>
       : el("p", "detail-description detail-empty", "no description"));
 
     var facts = el("dl", "detail-facts", null);
-    fact(facts, "tests", document.createTextNode(n.badge || ""));
+    // The badge string is empty only on the cute-dbt#253 non-model
+    // types (models always carry the explicit 0/0 line).
+    fact(facts, "tests", n.badge
+      ? document.createTextNode(n.badge)
+      : el("span", "detail-empty", "none"));
     fact(facts, "materialized", d.materialized
       ? el("code", null, d.materialized)
       : el("span", "detail-empty", "not set"));
-    fact(facts, "grain", grainValueNode(d.grain));
+    // Grain is SQL-model semantics — sources/exposures have no grain
+    // ladder to consult, so the row is omitted, not "unknown".
+    if (codeBearing) fact(facts, "grain", grainValueNode(d.grain));
     var tagsNode = document.createElement("span");
     if (d.tags.length) {
       d.tags.forEach(function (tag) {
@@ -1470,27 +1543,32 @@ <h1>Model lineage</h1>
 
     // cute-dbt#105 — read-only per-node file paths (the external-drive
     // contract's NodePathsPayload, surfaced for humans too). All values
-    // are project-relative manifest facts; textContent only.
-    card.appendChild(el("p", "detail-section-title", "files"));
-    var pathFacts = el("dl", "detail-facts detail-paths", null);
-    fact(pathFacts, "sql", n.paths.sql
-      ? el("code", null, n.paths.sql)
-      : el("span", "detail-empty", "not in manifest"));
-    fact(pathFacts, "schema yaml", n.paths.schema_yaml
-      ? el("code", null, n.paths.schema_yaml)
-      : el("span", "detail-empty", "none"));
-    n.paths.unit_tests.forEach(function (t) {
-      var holder = document.createElement("span");
-      holder.appendChild(t.yaml
-        ? el("code", null, t.yaml)
-        : el("span", "detail-empty", "yaml not in manifest"));
-      t.fixtures.forEach(function (fixture) {
-        holder.appendChild(document.createTextNode(" "));
-        holder.appendChild(el("code", "detail-path-fixtures", fixture));
+    // are project-relative manifest facts; textContent only. Code-bearing
+    // nodes-map types only (cute-dbt#253): a source/exposure carries no
+    // per-node file paths in the payload, so an all-empty section would
+    // be noise.
+    if (codeBearing) {
+      card.appendChild(el("p", "detail-section-title", "files"));
+      var pathFacts = el("dl", "detail-facts detail-paths", null);
+      fact(pathFacts, "sql", n.paths.sql
+        ? el("code", null, n.paths.sql)
+        : el("span", "detail-empty", "not in manifest"));
+      fact(pathFacts, "schema yaml", n.paths.schema_yaml
+        ? el("code", null, n.paths.schema_yaml)
+        : el("span", "detail-empty", "none"));
+      n.paths.unit_tests.forEach(function (t) {
+        var holder = document.createElement("span");
+        holder.appendChild(t.yaml
+          ? el("code", null, t.yaml)
+          : el("span", "detail-empty", "yaml not in manifest"));
+        t.fixtures.forEach(function (fixture) {
+          holder.appendChild(document.createTextNode(" "));
+          holder.appendChild(el("code", "detail-path-fixtures", fixture));
+        });
+        fact(pathFacts, t.name, holder);
       });
-      fact(pathFacts, t.name, holder);
-    });
-    card.appendChild(pathFacts);
+      card.appendChild(pathFacts);
+    }
 
     card.appendChild(el("p", "detail-section-title", "columns"));
     if (d.columns.length) {
@@ -1530,13 +1608,25 @@ <h1>Model lineage</h1>
   function showTooltip(node) {
     var n = nodeById[node.id()];
     if (!tooltip || !n) return;
+    var type = String(n.node_type || "model");
     while (tooltip.firstChild) tooltip.removeChild(tooltip.firstChild);
     tooltip.appendChild(el("span", "tooltip-name", n.name || n.id));
-    tooltip.appendChild(el("span", "tooltip-fact", n.badge || ""));
+    // cute-dbt#253 — surface the non-model typing as a key fact; the
+    // badge line is skipped when empty (non-model types without tests).
+    if (type !== "model") {
+      tooltip.appendChild(el("span", "tooltip-fact", "type: " + type));
+    }
+    if (n.badge) {
+      tooltip.appendChild(el("span", "tooltip-fact", n.badge));
+    }
     if (n.detail.materialized) {
       tooltip.appendChild(el("span", "tooltip-fact", "materialized: " + n.detail.materialized));
     }
-    tooltip.appendChild(el("span", "tooltip-fact", "grain: " + n.detail.grain.value));
+    // Grain is SQL-model semantics (omitted for sources/exposures, the
+    // detail-card rule).
+    if (type === "model" || type === "snapshot" || type === "seed") {
+      tooltip.appendChild(el("span", "tooltip-fact", "grain: " + n.detail.grain.value));
+    }
     if (n.not_compiled) {
       tooltip.appendChild(el("span", "tooltip-fact", "not compiled"));
     }
@@ -1678,7 +1768,7 @@ <h1>Model lineage</h1>
     if (!matches.length) {
       var none = document.createElement("li");
       none.className = "lineage-search-none";
-      none.textContent = "no matching model";
+      none.textContent = "no matching node";
       list.appendChild(none);
     }
     matches.forEach(function (m, i) {
@@ -1978,10 +2068,22 @@ <h1>Model lineage</h1>
     });
   }
 
+  // cute-dbt#253 — the CTE view is MODEL semantics (per-model CTE DAGs
+  // off the cte_dags map, built for models only): a highlighted
+  // snapshot/seed/source/exposure keeps the CTE arm locked rather than
+  // opening a misleading "no CTE structure" sparse state for a node the
+  // engine never parsed. Pre-#253 payloads carry no node_type and stay
+  // model-typed by default.
+  function modelTyped(id) {
+    var n = modelById[id];
+    return !!n && (!n.node_type || n.node_type === "model");
+  }
+
   // ---- the view toggle (chrome + selection persist; same page) ------------
   function setView(next) {
     if (next === view) return;
-    if (next === "cte" && !highlightedId) return; // gated on a highlight
+    // gated on a MODEL highlight
+    if (next === "cte" && (!highlightedId || !modelTyped(highlightedId))) return;
     view = next;
     var isCte = view === "cte";
     lineageView.hidden = isCte;
@@ -2008,9 +2110,9 @@ <h1>Model lineage</h1>
   // and retargets an active CTE view in place.
   document.addEventListener("cute-explore-highlight", function (ev) {
     highlightedId = ev.detail ? ev.detail.id : null;
-    btnCte.disabled = !highlightedId;
+    btnCte.disabled = !highlightedId || !modelTyped(highlightedId);
     if (view !== "cte") return;
-    if (!highlightedId) {
+    if (!highlightedId || !modelTyped(highlightedId)) {
       setView("lineage");
       return;
     }
diff --git a/features/explore_lineage_dag.feature b/features/explore_lineage_dag.feature
index a25efa90..6ed324aa 100644
--- a/features/explore_lineage_dag.feature
+++ b/features/explore_lineage_dag.feature
@@ -57,3 +57,32 @@ Feature: explore's dag.html renders an interactive Cytoscape lineage with highli
     Then the exit code is 0
     And the lineage payload round-trips the name "evil</script><img src=x onerror=alert(1)>"
     And dag.html carries no unescaped script-closing markup in the payload carrier
+
+  @no-baseline-usage-error
+  Scenario: A snapshot mid-chain renders as a typed node and keeps the lineage connected
+    Given the explore manifest declares the model "stg_patients"
+    And the explore manifest declares the snapshot "snp_patients" built from "stg_patients"
+    And the explore manifest declares the model "dim_patients"
+    And the explore model "dim_patients" depends on the snapshot "snp_patients"
+    When I run cute-dbt explore on the synthetic manifest
+    Then the exit code is 0
+    And the lineage payload types "snp_patients" as "snapshot"
+    And dag.html carries a lineage edge from "stg_patients" to "snp_patients"
+    And dag.html carries a lineage edge from "snp_patients" to "dim_patients"
+
+  @no-baseline-usage-error
+  Scenario: Seeds, sources and exposures render as typed lineage nodes
+    Given the explore manifest declares the model "stg_orders"
+    And the explore manifest declares the seed "raw_orders"
+    And the explore manifest declares the source "raw" table "orders"
+    And the explore model "stg_orders" depends on the seed "raw_orders"
+    And the explore model "stg_orders" depends on the source "raw" table "orders"
+    And the explore manifest declares the exposure "orders_dashboard" on "stg_orders"
+    When I run cute-dbt explore on the synthetic manifest
+    Then the exit code is 0
+    And the lineage payload types "raw_orders" as "seed"
+    And the lineage payload types "raw.orders" as "source"
+    And the lineage payload types "orders_dashboard" as "exposure"
+    And dag.html carries a lineage edge from "raw_orders" to "stg_orders"
+    And dag.html carries a lineage edge from "raw.orders" to "stg_orders"
+    And dag.html carries a lineage edge from "stg_orders" to "orders_dashboard"
diff --git a/src/adapters/explore.rs b/src/adapters/explore.rs
index cc414402..6f7d986c 100644
--- a/src/adapters/explore.rs
+++ b/src/adapters/explore.rs
@@ -2,8 +2,9 @@
 //!
 //! Emits the full-manifest explorer into `--out-dir`:
 //!
-//! - **`dag.html`** — the **interactive** model-lineage DAG
-//!   (cute-dbt#101): every `model` node, edges from `depends_on.nodes`,
+//! - **`dag.html`** — the **interactive** lineage DAG (cute-dbt#101):
+//!   every `model` node plus — typed, since cute-dbt#253 — every
+//!   snapshot / seed / source / exposure, edges from `depends_on.nodes`,
 //!   rendered by the vendored Cytoscape UMD core + the cytoscape-dagre
 //!   layout extension (left-to-right ranks) and driven by the
 //!   first-party explore lineage engine
@@ -51,7 +52,8 @@ use crate::adapters::asset_embed::{
 };
 use crate::adapters::render::{DagPayload, ReportPayload};
 use crate::domain::{
-    GrainKind, Manifest, ModelInScopeSet, Node, NodeId, model_grain_signals, resolve_tested_model,
+    GrainKind, Manifest, ModelInScopeSet, Node, NodeId, SourceNode, model_grain_signals,
+    resolve_tested_model,
 };
 
 /// The explorer's external-drive contract version (cute-dbt#105).
@@ -76,13 +78,77 @@ use crate::domain::{
 /// event) — no separate versioning system.
 pub const EXPLORE_CONTRACT_VERSION: &str = "1";
 
-/// One model node in the lineage graph.
+/// Render-layer lineage node typing (cute-dbt#253) — the wire
+/// vocabulary for dag.html's typed DAG nodes.
+///
+/// Mirrors the manifest's own partition @ dbt-fusion `9977b6cb…`:
+/// `model` / `snapshot` / `seed` are `nodes`-map resource types (the
+/// serde tag on fusion's `DbtNode` enum, `dbt-schemas`
+/// `manifest/manifest.rs:52-64`); `source` entries live in the
+/// top-level `sources` map (`ManifestSource`) and `exposure` entries in
+/// the top-level `exposures` map (`ManifestExposure`). Serialized
+/// `snake_case` into the [`LineageNodePayload`] — the exhaustive
+/// [`Self::wire_key`] match is the compile-time half of the node-vocab
+/// completeness guard (the `edge_type_wire_key` precedent); the
+/// template-grep test below is the belt-and-braces half.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize)]
+#[serde(rename_all = "snake_case")]
+pub enum LineageNodeType {
+    /// A `model` node — the only type the pre-#253 lineage rendered.
+    Model,
+    /// A `snapshot` node (`nodes` map) — mid-graph: it both depends on
+    /// upstream nodes and feeds downstream models.
+    Snapshot,
+    /// A `seed` node (`nodes` map) — a root: seeds carry no
+    /// `depends_on.nodes` (fusion serializes the key absent).
+    Seed,
+    /// A `sources`-map entry — a root: sources declare no dependencies.
+    Source,
+    /// An `exposures`-map entry — a sink: the lineage terminus
+    /// (cute-dbt#253 folds exposures in alongside the AC types).
+    Exposure,
+}
+
+impl LineageNodeType {
+    /// Every variant — the iteration source for the completeness guard.
+    pub const ALL: [Self; 5] = [
+        Self::Model,
+        Self::Snapshot,
+        Self::Seed,
+        Self::Source,
+        Self::Exposure,
+    ];
+
+    /// Snake-case wire key — the exact serde string
+    /// (`rename_all = "snake_case"`). Exhaustive: a new variant fails to
+    /// compile here before it can ship untyped to the client engine.
+    #[must_use]
+    pub fn wire_key(self) -> &'static str {
+        match self {
+            Self::Model => "model",
+            Self::Snapshot => "snapshot",
+            Self::Seed => "seed",
+            Self::Source => "source",
+            Self::Exposure => "exposure",
+        }
+    }
+}
+
+/// One node in the lineage graph (typed since cute-dbt#253).
 #[derive(Debug, Clone, PartialEq, Eq)]
 pub struct LineageNode {
-    /// Full manifest node id (`model.<package>.<name>`).
+    /// Full manifest node id (`model.<package>.<name>`,
+    /// `snapshot.<package>.<name>`, `seed.<package>.<name>`,
+    /// `source.<package>.<source_name>.<name>`,
+    /// `exposure.<package>.<name>`).
     pub id: String,
-    /// Bare model name (the last dotted segment) — the rendered label.
+    /// Rendered label: the bare name (last dotted segment) for
+    /// `nodes`-map types and exposures; `source_name.table` for sources
+    /// (the two `source(...)` arguments — a bare table name could
+    /// collide with a model name in search).
     pub name: String,
+    /// The render-layer node type (cute-dbt#253).
+    pub node_type: LineageNodeType,
     /// `true` when the manifest carries `compiled_code: null` for this
     /// model (`dbt parse`) — rendered as a "not compiled" node, never
     /// raised (the cute-dbt#100 fail-open contract).
@@ -144,51 +210,112 @@ fn unit_test_counts(current: &Manifest) -> HashMap<NodeId, usize> {
     counts
 }
 
-/// The full-manifest model lineage: nodes in deterministic node-id
+/// The full-manifest lineage: typed nodes in deterministic full-id
 /// order, edges as `(from_index, to_index)` pairs pointing **upstream →
-/// downstream** (a model depends on its `from`).
+/// downstream** (a node depends on its `from`).
 #[derive(Debug, Clone, Default, PartialEq, Eq)]
 pub struct Lineage {
-    /// Every `model` node, ordered by node id.
+    /// Every lineage node (models + snapshots + seeds + sources +
+    /// exposures since cute-dbt#253), ordered by full node id.
     pub nodes: Vec<LineageNode>,
-    /// Dependency edges between models in `nodes` (indices), ordered.
+    /// Dependency edges between entries of `nodes` (indices), ordered.
     pub edges: Vec<(usize, usize)>,
 }
 
-/// Build the model-lineage graph for the explore scope.
+/// The rendered label for one typed lineage node (cute-dbt#253):
+/// `source_name.table` for sources, the entry's own `name` for
+/// exposures, the id's leaf segment otherwise.
+fn lineage_node_name(current: &Manifest, id: &NodeId, node_type: LineageNodeType) -> String {
+    match node_type {
+        LineageNodeType::Source => current.sources().get(id).map_or_else(
+            || leaf_segment(id.as_str()).to_owned(),
+            |s| format!("{}.{}", s.source_name(), s.name()),
+        ),
+        LineageNodeType::Exposure => current.exposures().get(id).map_or_else(
+            || leaf_segment(id.as_str()).to_owned(),
+            |e| e.name().to_owned(),
+        ),
+        _ => leaf_segment(id.as_str()).to_owned(),
+    }
+}
+
+/// Build the lineage graph for the explore scope.
+///
+/// Nodes are the `models` set (the
+/// [`all_models`](crate::domain::all_models) seam) **unioned with**
+/// (cute-dbt#253) every `snapshot`/`seed` node in the manifest's
+/// `nodes` map, every `sources`-map entry and every `exposures`-map
+/// entry — the typed-node fix for the severed `stg → snapshot →
+/// downstream` chain (a filtered-out snapshot split the graph and faked
+/// the downstream model as a root; absent seeds/sources faked further
+/// roots). The union iterates in deterministic full-id order
+/// (`BTreeMap`).
 ///
-/// Nodes are exactly the `models` set (the
-/// [`all_models`](crate::domain::all_models) seam), in its deterministic
-/// `BTreeSet` order. Edges come from each model's `depends_on.nodes`,
-/// filtered to ids inside the same set — sources, seeds, macros and
-/// cross-project refs outside the model set are silently skipped (they
-/// are not model-lineage edges in v0.x). Self-edges are skipped
-/// defensively (a manifest should never carry one).
+/// Edges come from each `nodes`-map entry's `depends_on.nodes` and each
+/// exposure's `depends_on.nodes`, filtered to ids inside the union —
+/// macros, cross-project refs and other resource types (`test`,
+/// `operation`, `analysis`, `function` — the remaining fusion `DbtNode`
+/// serde tags @ `9977b6cb…`) are silently skipped. Sources contribute
+/// no outgoing dependencies (roots by construction). Self-edges are
+/// skipped defensively (a manifest should never carry one).
 #[must_use]
 pub fn build_lineage(current: &Manifest, models: &ModelInScopeSet) -> Lineage {
+    // The typed union, ordered by full node id.
+    let mut typed: BTreeMap<&NodeId, LineageNodeType> = models
+        .iter()
+        .map(|id| (id, LineageNodeType::Model))
+        .collect();
+    for (id, node) in current.nodes() {
+        let node_type = match node.resource_type() {
+            "snapshot" => LineageNodeType::Snapshot,
+            "seed" => LineageNodeType::Seed,
+            _ => continue,
+        };
+        typed.entry(id).or_insert(node_type);
+    }
+    for id in current.sources().keys() {
+        typed.entry(id).or_insert(LineageNodeType::Source);
+    }
+    for id in current.exposures().keys() {
+        typed.entry(id).or_insert(LineageNodeType::Exposure);
+    }
+
     let index_of: HashMap<&NodeId, usize> =
-        models.iter().enumerate().map(|(i, id)| (id, i)).collect();
+        typed.keys().enumerate().map(|(i, id)| (*id, i)).collect();
     let data_tests = data_test_counts(current);
     let unit_tests = unit_test_counts(current);
-    let nodes: Vec<LineageNode> = models
+    let nodes: Vec<LineageNode> = typed
         .iter()
-        .map(|id| {
+        .map(|(id, &node_type)| {
             let node = current.node(id);
             LineageNode {
                 id: id.as_str().to_owned(),
-                name: leaf_segment(id.as_str()).to_owned(),
-                not_compiled: node.is_none_or(|n| n.compiled_code().is_none()),
-                data_tests: data_tests.get(id).copied().unwrap_or(0),
-                unit_tests: unit_tests.get(id).copied().unwrap_or(0),
+                name: lineage_node_name(current, id, node_type),
+                node_type,
+                // SQL-bearing types only — see [`LineageNodePayload::not_compiled`].
+                not_compiled: matches!(
+                    node_type,
+                    LineageNodeType::Model | LineageNodeType::Snapshot
+                ) && node.is_none_or(|n| n.compiled_code().is_none()),
+                data_tests: data_tests.get(*id).copied().unwrap_or(0),
+                unit_tests: unit_tests.get(*id).copied().unwrap_or(0),
             }
         })
         .collect();
+
     let mut edges: Vec<(usize, usize)> = Vec::new();
-    for (to_idx, id) in models.iter().enumerate() {
-        let Some(node) = current.node(id) else {
-            continue;
+    for (to_idx, (id, node_type)) in typed.iter().enumerate() {
+        let deps: &[NodeId] = match node_type {
+            LineageNodeType::Model | LineageNodeType::Snapshot | LineageNodeType::Seed => {
+                current.node(id).map_or(&[], |n| n.depends_on().nodes())
+            }
+            LineageNodeType::Exposure => current
+                .exposures()
+                .get(*id)
+                .map_or(&[], |e| e.depends_on().nodes()),
+            LineageNodeType::Source => &[],
         };
-        for dep in node.depends_on().nodes() {
+        for dep in deps {
             if let Some(&from_idx) = index_of.get(dep)
                 && from_idx != to_idx
             {
@@ -209,11 +336,24 @@ pub struct LineageNodePayload {
     /// element id and the value the Space focus commit writes to
     /// `document.body.dataset.selectedModel`.
     pub id: String,
-    /// Bare model name — the canvas-text label and the fuzzy-search
-    /// candidate.
+    /// Rendered label — the canvas-text label and the fuzzy-search
+    /// candidate (`source_name.table` for sources, the bare name
+    /// otherwise).
     pub name: String,
+    /// The render-layer node type (cute-dbt#253) — the engine's
+    /// `node[type = "…"]` style/shape hook and the legend vocabulary.
+    /// Always serialized (the explicit posture; `"model"` included).
+    pub node_type: LineageNodeType,
     /// The fail-open "not compiled" flag (cute-dbt#100) — rendered as a
-    /// dashed node, never raised.
+    /// dashed node, never raised. Honest per type (cute-dbt#253):
+    /// consulted only for SQL-bearing types (`model`, `snapshot` — both
+    /// engines backfill snapshot `compiled_code` on compile; fusion
+    /// null-fills it at parse, `dbt-tasks-sa/src/utils.rs:151-172` vs
+    /// `dbt-schemas/src/schemas/manifest/manifest_nodes.rs:616-617` @
+    /// `9977b6cb…`). Seeds are NEVER flagged: fusion null-fills seed
+    /// `compiled_code` unconditionally (`manifest_nodes.rs:232-233`) —
+    /// a seed has no SQL to compile, so the flag would be noise, not
+    /// honesty. Sources/exposures have no code at all.
     pub not_compiled: bool,
     /// YAML data-tests attached to this model (cute-dbt#103). Always
     /// serialized — the 0/0 badge is explicit, never an omitted key.
@@ -527,6 +667,29 @@ fn node_paths(node: Option<&Node>, unit_tests: Vec<UnitTestPathsPayload>) -> Nod
     }
 }
 
+/// Assemble the detail facts for a `sources`-map node (cute-dbt#253):
+/// the authored column descriptions are the only detail the ingested
+/// [`SourceNode`] carries (cute-dbt#235); every other fact stays the
+/// explicit default (the [`ModelDetailPayload`] absent shapes — `null`
+/// / `[]` / the explicit-unknown grain).
+fn source_detail(source: Option<&SourceNode>) -> ModelDetailPayload {
+    let Some(source) = source else {
+        return ModelDetailPayload::default();
+    };
+    ModelDetailPayload {
+        columns: source
+            .column_descriptions()
+            .iter()
+            .map(|(name, description)| ColumnDetailPayload {
+                name: name.clone(),
+                data_type: None,
+                description: Some(description.clone()),
+            })
+            .collect(),
+        ..Default::default()
+    }
+}
+
 /// One dependency edge in the serialized lineage payload, by node id.
 ///
 /// Edges are **forward only** — upstream (`from`) → downstream (`to`),
@@ -542,14 +705,15 @@ pub struct LineageEdgePayload {
 }
 
 /// The `explore-dag-data` JSON carrier embedded in `dag.html` —
-/// nodes = models, edges = forward dependency edges. An empty `nodes`
-/// array selects the page's empty-state message instead of a Cytoscape
-/// render.
+/// nodes = the typed union (models + snapshots + seeds + sources +
+/// exposures, cute-dbt#253), edges = forward dependency edges. An empty
+/// `nodes` array selects the page's empty-state message instead of a
+/// Cytoscape render.
 #[derive(Debug, Clone, Default, PartialEq, Eq, Serialize)]
 pub struct LineagePayload {
-    /// Every model node, in deterministic node-id order.
+    /// Every typed lineage node, in deterministic full-id order.
     pub nodes: Vec<LineageNodePayload>,
-    /// Forward dependency edges between models in `nodes`, ordered.
+    /// Forward dependency edges between entries of `nodes`, ordered.
     pub edges: Vec<LineageEdgePayload>,
     /// Per-model CTE DAGs (cute-dbt#102) — the CTE ⇄ model view
     /// toggle's data, keyed by full model node id. Each entry is the
@@ -564,10 +728,11 @@ pub struct LineagePayload {
 
 /// Build the serializable lineage payload for `dag.html` (cute-dbt#101).
 ///
-/// Composes [`build_lineage`] (nodes = the model set, edges =
-/// `depends_on.nodes` filtered to models, **forward only**) into the
-/// id-keyed POD the Cytoscape engine consumes. Pure assembly over owned
-/// manifest data — no I/O.
+/// Composes [`build_lineage`] (nodes = the typed union of the model set
+/// with the manifest's snapshots / seeds / sources / exposures since
+/// cute-dbt#253; edges = `depends_on.nodes` filtered to the union,
+/// **forward only**) into the id-keyed POD the Cytoscape engine
+/// consumes. Pure assembly over owned manifest data — no I/O.
 ///
 /// `changed` is the optional PR-diff **change context** (cute-dbt#106):
 /// `Some(set)` marks each member node `changed: true` (the set comes
@@ -590,24 +755,47 @@ pub fn build_lineage_payload(
             to: lineage.nodes[to].id.clone(),
         })
         .collect();
-    // `lineage.nodes` mirrors `models` one-to-one and in the same order
-    // (build_lineage maps the same set), so the zip rebinds each node to
-    // its manifest entry for the cute-dbt#104 detail assembly.
     let mut test_paths = unit_test_paths_by_model(current);
     let nodes = lineage
         .nodes
         .into_iter()
-        .zip(models.iter())
-        .map(|(n, id)| LineageNodePayload {
-            id: n.id,
-            name: n.name,
-            not_compiled: n.not_compiled,
-            data_tests: n.data_tests,
-            unit_tests: n.unit_tests,
-            badge: test_badge(n.data_tests, n.unit_tests),
-            detail: model_detail(current, current.node(id)),
-            paths: node_paths(current.node(id), test_paths.remove(id).unwrap_or_default()),
-            changed: changed.is_some_and(|set| set.contains(id)),
+        .map(|n| {
+            // Each lineage node carries its full manifest id — rebind it
+            // for the per-type detail/paths assembly (the pre-#253 zip
+            // against `models` no longer holds over the typed union).
+            let id = NodeId::new(n.id.as_str());
+            let (detail, paths) = match n.node_type {
+                // `nodes`-map types share the model detail assembly —
+                // snapshots/seeds carry the same authored description /
+                // config / columns surfaces (fusion's shared
+                // `ManifestNodeBaseAttributes` @ `9977b6cb…`).
+                LineageNodeType::Model | LineageNodeType::Snapshot | LineageNodeType::Seed => (
+                    model_detail(current, current.node(&id)),
+                    node_paths(
+                        current.node(&id),
+                        test_paths.remove(&id).unwrap_or_default(),
+                    ),
+                ),
+                LineageNodeType::Source => (
+                    source_detail(current.sources().get(&id)),
+                    NodePathsPayload::default(),
+                ),
+                LineageNodeType::Exposure => {
+                    (ModelDetailPayload::default(), NodePathsPayload::default())
+                }
+            };
+            LineageNodePayload {
+                badge: typed_badge(n.node_type, n.data_tests, n.unit_tests),
+                changed: changed.is_some_and(|set| set.contains(&id)),
+                id: n.id,
+                name: n.name,
+                node_type: n.node_type,
+                not_compiled: n.not_compiled,
+                data_tests: n.data_tests,
+                unit_tests: n.unit_tests,
+                detail,
+                paths,
+            }
         })
         .collect();
     LineagePayload {
@@ -702,6 +890,26 @@ fn test_badge(data_tests: usize, unit_tests: usize) -> String {
     )
 }
 
+/// The type-aware badge line (cute-dbt#253). Models keep the explicit
+/// 0/0 [`test_badge`] (the cute-dbt#103 posture). Snapshots / seeds /
+/// sources badge their data-test count only when non-zero — dbt unit
+/// tests cannot target them, so an explicit `"0 unit-tests"` would be
+/// structural noise, not honesty, and an all-zero line carries no fact.
+/// Exposures are untestable and never badge (single-line label).
+fn typed_badge(node_type: LineageNodeType, data_tests: usize, unit_tests: usize) -> String {
+    match node_type {
+        LineageNodeType::Model => test_badge(data_tests, unit_tests),
+        LineageNodeType::Snapshot | LineageNodeType::Seed | LineageNodeType::Source => {
+            if data_tests > 0 {
+                plural(data_tests, "data-test")
+            } else {
+                String::new()
+            }
+        }
+        LineageNodeType::Exposure => String::new(),
+    }
+}
+
 /// askama binding for `templates/explore-dag.html`.
 #[derive(Template)]
 #[template(path = "explore-dag.html", escape = "html")]
@@ -721,7 +929,15 @@ struct ExploreDagTemplate<'a> {
     /// Pre-escaped JSON for the `explore-dag-data` carrier (the
     /// [`LineagePayload`]).
     dag_json: &'a str,
+    /// `model`-typed lineage nodes only (cute-dbt#253 — the header's
+    /// typed counts; pre-#253 this was every node).
     model_count: usize,
+    /// Typed-node counts (cute-dbt#253) — each gates its header segment
+    /// and its legend chip (rendered only when present).
+    snapshot_count: usize,
+    seed_count: usize,
+    source_count: usize,
+    exposure_count: usize,
     edge_count: usize,
     not_compiled_count: usize,
     /// The external-drive contract version (cute-dbt#105) — rendered as
@@ -868,6 +1084,14 @@ pub fn render_explore(
     // The marked-node count (what actually renders), not `changed.len()`
     // — a defensive id outside the model set must not inflate the banner.
     let changed_count = lineage.nodes.iter().filter(|n| n.changed).count();
+    // cute-dbt#253 — typed counts for the header + the legend gating.
+    let count_of = |node_type: LineageNodeType| {
+        lineage
+            .nodes
+            .iter()
+            .filter(|n| n.node_type == node_type)
+            .count()
+    };
     let dag_json = json_for_html_script(&lineage)
         .map_err(|err| io::Error::other(format!("dag payload serialization: {err}")))?;
     let dag_html = ExploreDagTemplate {
@@ -879,7 +1103,11 @@ pub fn render_explore(
         explore_cte_js: EXPLORE_CTE_JS,
         favicon_data_uri: FAVICON_DATA_URI,
         dag_json: &dag_json,
-        model_count: lineage.nodes.len(),
+        model_count: count_of(LineageNodeType::Model),
+        snapshot_count: count_of(LineageNodeType::Snapshot),
+        seed_count: count_of(LineageNodeType::Seed),
+        source_count: count_of(LineageNodeType::Source),
+        exposure_count: count_of(LineageNodeType::Exposure),
         edge_count: lineage.edges.len(),
         not_compiled_count,
         contract_version: EXPLORE_CONTRACT_VERSION,
@@ -1029,6 +1257,387 @@ mod tests {
         assert_eq!(lineage.edges, vec![(0, 1), (2, 0)]);
     }
 
+    // ----- typed lineage nodes (cute-dbt#253) -------------------------
+
+    /// A `nodes`-map entry of an arbitrary resource type with explicit
+    /// dependency edges — the snapshot/seed builder.
+    fn typed_node(id: &str, resource_type: &str, compiled: Option<&str>, deps: &[&str]) -> Node {
+        Node::new(
+            NodeId::new(id),
+            resource_type,
+            Checksum::new("sha256", "ck"),
+            compiled.map(str::to_owned),
+            None,
+            DependsOn::new(Vec::new(), deps.iter().map(|d| NodeId::new(*d)).collect()),
+            None,
+            NodeConfig::default(),
+            None,
+            BTreeMap::new(),
+        )
+    }
+
+    /// A `sources`-map entry.
+    fn source_entry(id: &str, source_name: &str, table: &str) -> crate::domain::SourceNode {
+        crate::domain::SourceNode::new(
+            NodeId::new(id),
+            source_name,
+            table,
+            None,
+            "main",
+            None,
+            None,
+        )
+    }
+
+    /// An `exposures`-map entry depending on `deps`.
+    fn exposure_entry(id: &str, name: &str, deps: &[&str]) -> crate::domain::Exposure {
+        crate::domain::Exposure::new(
+            NodeId::new(id),
+            name,
+            Some("dashboard".to_owned()),
+            None,
+            None,
+            DependsOn::new(Vec::new(), deps.iter().map(|d| NodeId::new(*d)).collect()),
+        )
+    }
+
+    /// source → stg → snapshot → dim → exposure, plus seed → stg — every
+    /// cute-dbt#253 node type in one connected manifest.
+    fn typed_manifest() -> Manifest {
+        manifest_of(vec![
+            model(
+                "model.shop.stg_patients",
+                Some("select 1"),
+                &["source.shop.raw.patients", "seed.shop.raw_codes"],
+            ),
+            typed_node(
+                "snapshot.shop.snp_patients",
+                "snapshot",
+                Some("select 1"),
+                &["model.shop.stg_patients"],
+            ),
+            typed_node("seed.shop.raw_codes", "seed", None, &[]),
+            model(
+                "model.shop.dim_patients",
+                Some("select 1"),
+                &["snapshot.shop.snp_patients"],
+            ),
+        ])
+        .with_sources(
+            [(
+                NodeId::new("source.shop.raw.patients"),
+                source_entry("source.shop.raw.patients", "raw", "patients"),
+            )]
+            .into_iter()
+            .collect(),
+        )
+        .with_exposures(
+            [(
+                NodeId::new("exposure.shop.patient_dashboard"),
+                exposure_entry(
+                    "exposure.shop.patient_dashboard",
+                    "patient_dashboard",
+                    &["model.shop.dim_patients"],
+                ),
+            )]
+            .into_iter()
+            .collect(),
+        )
+    }
+
+    /// Edge lookup by node name — index-based assertions are brittle
+    /// across the typed union's id ordering.
+    fn edge_names(lineage: &Lineage) -> Vec<(String, String)> {
+        lineage
+            .edges
+            .iter()
+            .map(|&(from, to)| {
+                (
+                    lineage.nodes[from].name.clone(),
+                    lineage.nodes[to].name.clone(),
+                )
+            })
+            .collect()
+    }
+
+    #[test]
+    fn lineage_renders_a_snapshot_as_a_typed_mid_chain_node() {
+        // The cute-dbt#253 defect: stg → snapshot → dim must stay ONE
+        // connected chain — the snapshot is a typed node, never filtered
+        // (which severed the graph and faked dim as a root).
+        let current = typed_manifest();
+        let lineage = build_lineage(&current, &all_models(&current));
+        let snp = lineage
+            .nodes
+            .iter()
+            .find(|n| n.id == "snapshot.shop.snp_patients")
+            .expect("the snapshot is a lineage node");
+        assert_eq!(snp.node_type, LineageNodeType::Snapshot);
+        let edges = edge_names(&lineage);
+        assert!(
+            edges.contains(&("stg_patients".to_owned(), "snp_patients".to_owned())),
+            "upstream chain into the snapshot survives: {edges:?}",
+        );
+        assert!(
+            edges.contains(&("snp_patients".to_owned(), "dim_patients".to_owned())),
+            "downstream chain out of the snapshot survives (dim is NOT a false root): {edges:?}",
+        );
+    }
+
+    #[test]
+    fn lineage_renders_seeds_and_sources_as_typed_roots() {
+        let current = typed_manifest();
+        let lineage = build_lineage(&current, &all_models(&current));
+        let by_id: StdHashMap<&str, &LineageNode> =
+            lineage.nodes.iter().map(|n| (n.id.as_str(), n)).collect();
+        assert_eq!(
+            by_id["seed.shop.raw_codes"].node_type,
+            LineageNodeType::Seed
+        );
+        assert_eq!(
+            by_id["source.shop.raw.patients"].node_type,
+            LineageNodeType::Source
+        );
+        let edges = edge_names(&lineage);
+        assert!(
+            edges.contains(&("raw_codes".to_owned(), "stg_patients".to_owned())),
+            "seed feeds the staging model: {edges:?}",
+        );
+        assert!(
+            edges.contains(&("raw.patients".to_owned(), "stg_patients".to_owned())),
+            "source feeds the staging model (stg is NOT a false root): {edges:?}",
+        );
+        // Roots: nothing flows INTO a seed or a source.
+        for root in ["raw_codes", "raw.patients"] {
+            assert!(
+                !edges.iter().any(|(_, to)| to == root),
+                "{root} must have no incoming edge: {edges:?}",
+            );
+        }
+    }
+
+    #[test]
+    fn lineage_renders_exposures_as_typed_sinks() {
+        let current = typed_manifest();
+        let lineage = build_lineage(&current, &all_models(&current));
+        let exposure = lineage
+            .nodes
+            .iter()
+            .find(|n| n.id == "exposure.shop.patient_dashboard")
+            .expect("the exposure is a lineage node");
+        assert_eq!(exposure.node_type, LineageNodeType::Exposure);
+        let edges = edge_names(&lineage);
+        assert!(
+            edges.contains(&("dim_patients".to_owned(), "patient_dashboard".to_owned())),
+            "the exposure terminates the lineage: {edges:?}",
+        );
+        assert!(
+            !edges.iter().any(|(from, _)| from == "patient_dashboard"),
+            "an exposure is a sink — no outgoing edge: {edges:?}",
+        );
+    }
+
+    #[test]
+    fn lineage_source_labels_carry_the_source_name_prefix() {
+        let current = typed_manifest();
+        let lineage = build_lineage(&current, &all_models(&current));
+        let source = lineage
+            .nodes
+            .iter()
+            .find(|n| n.node_type == LineageNodeType::Source)
+            .expect("source node present");
+        assert_eq!(
+            source.name, "raw.patients",
+            "source labels are source_name.table — the two source(...) arguments",
+        );
+    }
+
+    #[test]
+    fn seeds_are_never_flagged_not_compiled() {
+        // fusion null-fills seed compiled_code UNCONDITIONALLY
+        // (manifest_nodes.rs:232-233 @ 9977b6cb…) — a seed has no SQL,
+        // so the dbt-parse "not compiled" treatment would be dishonest.
+        let current = typed_manifest();
+        let lineage = build_lineage(&current, &all_models(&current));
+        let seed = lineage
+            .nodes
+            .iter()
+            .find(|n| n.node_type == LineageNodeType::Seed)
+            .expect("seed node present");
+        assert!(!seed.not_compiled, "seeds never render dbt-parse-dashed");
+        let source = lineage
+            .nodes
+            .iter()
+            .find(|n| n.node_type == LineageNodeType::Source)
+            .expect("source node present");
+        assert!(!source.not_compiled, "sources carry no code at all");
+    }
+
+    #[test]
+    fn snapshot_not_compiled_mirrors_compiled_code_presence() {
+        // fusion null-fills snapshot compiled_code at parse
+        // (manifest_nodes.rs:616-617 @ 9977b6cb…) and backfills it on
+        // compile (dbt-tasks-sa/src/utils.rs:151-172) — the flag is the
+        // honest dbt-parse signal for snapshots, exactly like models.
+        let current = manifest_of(vec![
+            typed_node("snapshot.shop.compiled", "snapshot", Some("select 1"), &[]),
+            typed_node("snapshot.shop.parse_only", "snapshot", None, &[]),
+        ]);
+        let lineage = build_lineage(&current, &all_models(&current));
+        let by_id: StdHashMap<&str, bool> = lineage
+            .nodes
+            .iter()
+            .map(|n| (n.id.as_str(), n.not_compiled))
+            .collect();
+        assert!(!by_id["snapshot.shop.compiled"]);
+        assert!(by_id["snapshot.shop.parse_only"]);
+    }
+
+    #[test]
+    fn typed_nodes_order_deterministically_by_full_id() {
+        let current = typed_manifest();
+        let lineage = build_lineage(&current, &all_models(&current));
+        let ids: Vec<&str> = lineage.nodes.iter().map(|n| n.id.as_str()).collect();
+        let mut sorted = ids.clone();
+        sorted.sort_unstable();
+        assert_eq!(ids, sorted, "typed union iterates in full-id order");
+        assert_eq!(lineage.nodes.len(), 6, "all five types render");
+    }
+
+    #[test]
+    fn non_model_badges_show_data_tests_only_and_only_when_present() {
+        // Models keep the explicit 0/0 badge (the cute-dbt#103 posture).
+        // The new types show their data-test count only when non-zero
+        // (unit tests cannot target them — an explicit "0 unit-tests"
+        // there would be structural noise, not honesty); exposures are
+        // untestable and never badge.
+        let mut current = typed_manifest();
+        // Attach one data test to the snapshot and one to the source
+        // (the `attached_node` linkage names non-model parents here —
+        // pre-#253 those entries were inert; now they badge).
+        let t1 = data_test(
+            "test.shop.snp_check",
+            Some("snapshot.shop.snp_patients"),
+            &[],
+            None,
+        );
+        let t2 = data_test(
+            "test.shop.src_check",
+            Some("source.shop.raw.patients"),
+            &[],
+            None,
+        );
+        let mut nodes = current.nodes().clone();
+        nodes.insert(t1.id().clone(), t1);
+        nodes.insert(t2.id().clone(), t2);
+        current = Manifest::new(
+            ManifestMetadata::new("v12"),
+            nodes,
+            StdHashMap::new(),
+            StdHashMap::new(),
+        )
+        .with_sources(current.sources().clone())
+        .with_exposures(current.exposures().clone());
+        let payload = build_lineage_payload(&current, &all_models(&current), None);
+        let badge_of = |id: &str| -> &str {
+            payload
+                .nodes
+                .iter()
+                .find(|n| n.id == id)
+                .map_or_else(|| panic!("{id} missing from payload"), |n| n.badge.as_str())
+        };
+        assert_eq!(
+            badge_of("model.shop.dim_patients"),
+            "0 data-tests \u{b7} 0 unit-tests",
+            "models keep the explicit 0/0 badge",
+        );
+        assert_eq!(badge_of("snapshot.shop.snp_patients"), "1 data-test");
+        assert_eq!(badge_of("source.shop.raw.patients"), "1 data-test");
+        assert_eq!(
+            badge_of("seed.shop.raw_codes"),
+            "",
+            "untested seed: no badge line"
+        );
+        assert_eq!(badge_of("exposure.shop.patient_dashboard"), "");
+    }
+
+    #[test]
+    fn payload_serializes_node_type_wire_keys() {
+        let current = typed_manifest();
+        let payload = build_lineage_payload(&current, &all_models(&current), None);
+        let json: serde_json::Value = serde_json::to_value(&payload).expect("payload serializes");
+        let type_of = |id: &str| -> String {
+            json["nodes"]
+                .as_array()
+                .expect("nodes array")
+                .iter()
+                .find(|n| n["id"] == id)
+                .unwrap_or_else(|| panic!("{id} missing"))["node_type"]
+                .as_str()
+                .expect("node_type is a string")
+                .to_owned()
+        };
+        assert_eq!(type_of("model.shop.stg_patients"), "model");
+        assert_eq!(type_of("snapshot.shop.snp_patients"), "snapshot");
+        assert_eq!(type_of("seed.shop.raw_codes"), "seed");
+        assert_eq!(type_of("source.shop.raw.patients"), "source");
+        assert_eq!(type_of("exposure.shop.patient_dashboard"), "exposure");
+    }
+
+    #[test]
+    fn source_payload_detail_carries_column_descriptions_and_empty_paths() {
+        let mut sources = StdHashMap::new();
+        sources.insert(
+            NodeId::new("source.shop.raw.patients"),
+            source_entry("source.shop.raw.patients", "raw", "patients").with_column_descriptions(
+                [("patient_id".to_owned(), "natural key".to_owned())]
+                    .into_iter()
+                    .collect(),
+            ),
+        );
+        let current = manifest_of(vec![model(
+            "model.shop.stg_patients",
+            Some("select 1"),
+            &["source.shop.raw.patients"],
+        )])
+        .with_sources(sources);
+        let payload = build_lineage_payload(&current, &all_models(&current), None);
+        let source = payload
+            .nodes
+            .iter()
+            .find(|n| n.id == "source.shop.raw.patients")
+            .expect("source node present");
+        assert_eq!(source.detail.columns.len(), 1);
+        assert_eq!(source.detail.columns[0].name, "patient_id");
+        assert_eq!(
+            source.detail.columns[0].description.as_deref(),
+            Some("natural key"),
+        );
+        assert_eq!(source.paths, NodePathsPayload::default());
+    }
+
+    #[test]
+    fn every_lineage_node_type_is_styled_and_legended() {
+        // The node-vocab completeness guard (cute-dbt#253) — the
+        // edge-vocab-completeness twin, test-level: every wire key must
+        // have a Cytoscape style selector in the lineage engine AND a
+        // legend chip in the dag template. The exhaustive
+        // `wire_key` match is the compile-time half.
+        let engine = include_str!("../../templates/explore-lineage.js");
+        let template = include_str!("../../templates/explore-dag.html");
+        for node_type in LineageNodeType::ALL {
+            let key = node_type.wire_key();
+            assert!(
+                engine.contains(&format!("node[type = \"{key}\"]")),
+                "templates/explore-lineage.js must style node[type = \"{key}\"]",
+            );
+            assert!(
+                template.contains(&format!("legend-chip type-{key}")),
+                "templates/explore-dag.html must legend the {key} chip",
+            );
+        }
+    }
+
     #[test]
     fn lineage_marks_uncompiled_models_not_compiled() {
         let current = three_model_manifest();
diff --git a/templates/explore-cte.js b/templates/explore-cte.js
index 529a0e90..5a4873ab 100644
--- a/templates/explore-cte.js
+++ b/templates/explore-cte.js
@@ -221,10 +221,22 @@
     });
   }
 
+  // cute-dbt#253 — the CTE view is MODEL semantics (per-model CTE DAGs
+  // off the cte_dags map, built for models only): a highlighted
+  // snapshot/seed/source/exposure keeps the CTE arm locked rather than
+  // opening a misleading "no CTE structure" sparse state for a node the
+  // engine never parsed. Pre-#253 payloads carry no node_type and stay
+  // model-typed by default.
+  function modelTyped(id) {
+    var n = modelById[id];
+    return !!n && (!n.node_type || n.node_type === "model");
+  }
+
   // ---- the view toggle (chrome + selection persist; same page) ------------
   function setView(next) {
     if (next === view) return;
-    if (next === "cte" && !highlightedId) return; // gated on a highlight
+    // gated on a MODEL highlight
+    if (next === "cte" && (!highlightedId || !modelTyped(highlightedId))) return;
     view = next;
     var isCte = view === "cte";
     lineageView.hidden = isCte;
@@ -251,9 +263,9 @@
   // and retargets an active CTE view in place.
   document.addEventListener("cute-explore-highlight", function (ev) {
     highlightedId = ev.detail ? ev.detail.id : null;
-    btnCte.disabled = !highlightedId;
+    btnCte.disabled = !highlightedId || !modelTyped(highlightedId);
     if (view !== "cte") return;
-    if (!highlightedId) {
+    if (!highlightedId || !modelTyped(highlightedId)) {
       setView("lineage");
       return;
     }
diff --git a/templates/explore-dag.html b/templates/explore-dag.html
index f615605c..3bc14961 100644
--- a/templates/explore-dag.html
+++ b/templates/explore-dag.html
@@ -55,6 +55,16 @@
 .lineage-legend { color: var(--text-muted); font-size: 0.85rem; margin-top: 0.5rem; }
 .lineage-legend .legend-chip { display: inline-block; padding: 0 0.4rem; border: 1.5px solid var(--dag-import-stroke); border-radius: 4px; background: var(--dag-import-fill); color: var(--dag-node-text); }
 .lineage-legend .legend-chip.notcompiled { border-color: #b07400; border-style: dashed; background: var(--dag-transform-fill); }
+/* cute-dbt#253 — the typed-node vocabulary. Canvas-paired chips: these
+   exact fills/strokes are what explore-lineage.js draws per node type
+   (redundant shape+color coding on canvas; the chips mirror the colors
+   and approximate the shapes via border-radius). Shared by the legend
+   and the detail card's type chip. */
+.legend-chip.type-model, .detail-type.type-model { border-color: #0072B2; background: #e8f1f8; }
+.legend-chip.type-snapshot, .detail-type.type-snapshot { border-color: #7b5ea7; background: #f1ecf9; border-radius: 2px; }
+.legend-chip.type-seed, .detail-type.type-seed { border-color: #00756d; background: #e6f4f2; border-radius: 10px; }
+.legend-chip.type-source, .detail-type.type-source { border-color: #1f8a5b; background: #eef7ee; border-radius: 999px; }
+.legend-chip.type-exposure, .detail-type.type-exposure { border-color: #6b6b76; background: #f4f4f5; border-radius: 4px 12px 12px 4px; }
 /* cute-dbt#106 — the PR-diff change-context treatment: an amber halo
    mirroring the canvas underlay glow. A separate visual channel from
    the highlight vocabulary (border = selected, opacity = dim/trace)
@@ -110,6 +120,9 @@
 /* canvas-paired status chips (fixed across themes; dark fixed text on the
    fixed light fills stays readable on every theme by construction) */
 .model-detail-card .detail-notcompiled { display: inline-block; padding: 0 0.4rem; border: 1.5px dashed #b07400; border-radius: 4px; background: var(--dag-transform-fill); color: var(--dag-node-text); font-size: 0.8rem; }
+/* cute-dbt#253 — the detail card's node-type chip (non-model nodes only;
+   per-type colors above). */
+.model-detail-card .detail-type { display: inline-block; margin-right: 0.35rem; padding: 0 0.4rem; border: 1.5px solid var(--dag-import-stroke); border-radius: 4px; color: var(--dag-node-text); font-size: 0.8rem; }
 /* cute-dbt#106 — the detail card's "changed in this diff" chip (the
    change-context twin of .detail-notcompiled; both can show at once). */
 .model-detail-card .detail-changed { display: inline-block; margin-left: 0.35rem; padding: 0 0.4rem; border: 1.5px solid var(--dag-import-stroke); border-radius: 4px; background: var(--dag-import-fill); color: var(--dag-node-text); box-shadow: 0 0 0 2px rgba(230, 159, 0, 0.55); font-size: 0.8rem; }
@@ -125,7 +138,9 @@
 <header class="explore-header">
   <div>
     <h1>Model lineage</h1>
-    <p class="explore-counts">full manifest — {{ model_count }} model{% if model_count != 1 %}s{% endif %}, {{ edge_count }} edge{% if edge_count != 1 %}s{% endif %}{% if not_compiled_count > 0 %}, {{ not_compiled_count }} not compiled{% endif %}{% if has_change_context %}, {{ changed_count }} changed in this diff{% endif %}</p>
+    {# cute-dbt#253 — typed counts: the non-model segments render only
+       when present, so a models-only manifest keeps the pre-#253 line. #}
+    <p class="explore-counts">full manifest — {{ model_count }} model{% if model_count != 1 %}s{% endif %}{% if snapshot_count > 0 %}, {{ snapshot_count }} snapshot{% if snapshot_count != 1 %}s{% endif %}{% endif %}{% if seed_count > 0 %}, {{ seed_count }} seed{% if seed_count != 1 %}s{% endif %}{% endif %}{% if source_count > 0 %}, {{ source_count }} source{% if source_count != 1 %}s{% endif %}{% endif %}{% if exposure_count > 0 %}, {{ exposure_count }} exposure{% if exposure_count != 1 %}s{% endif %}{% endif %}, {{ edge_count }} edge{% if edge_count != 1 %}s{% endif %}{% if not_compiled_count > 0 %}, {{ not_compiled_count }} not compiled{% endif %}{% if has_change_context %}, {{ changed_count }} changed in this diff{% endif %}</p>
   </div>
   <nav class="explore-nav" aria-label="Explore pages">
     <a href="tests.html">Unit tests &rarr;</a>
@@ -135,11 +150,11 @@ <h1>Model lineage</h1>
 <section class="lineage" aria-label="Model lineage DAG">
   <div class="lineage-toolbar">
     <div class="lineage-search">
-      <input type="search" class="lineage-search-input" placeholder="Search models&hellip;"
-             aria-label="Search models" role="combobox" aria-expanded="false"
+      <input type="search" class="lineage-search-input" placeholder="Search nodes&hellip;"
+             aria-label="Search lineage nodes" role="combobox" aria-expanded="false"
              aria-controls="lineage-search-results" autocomplete="off" spellcheck="false">
       <ul class="lineage-search-results" id="lineage-search-results" role="listbox"
-          aria-label="Matching models" hidden></ul>
+          aria-label="Matching nodes" hidden></ul>
     </div>
     {# cute-dbt#102 — the CTE ⇄ model view toggle. The CTE arm is gated
        on a highlight (disabled at render time; explore-cte.js enables it
@@ -165,8 +180,17 @@ <h1>Model lineage</h1>
      attribute. The engine fills it with createElement/textContent only. #}
   <div class="lineage-tooltip" role="tooltip" aria-hidden="true" hidden></div>
   <p class="lineage-empty" hidden>No models in this manifest.</p>
+  {# cute-dbt#253 — typed-node chips render only for types present in
+     this manifest (the model chip always); the chip colors are
+     canvas-paired with the engine's per-type styles. The template
+     SOURCE carries every wire key's chip — the node-vocab completeness
+     guard greps this file. #}
   <div class="lineage-legend">
-    <span class="legend-chip">model</span>
+    <span class="legend-chip type-model">model</span>{% if snapshot_count > 0 %}
+    <span class="legend-chip type-snapshot">snapshot</span>{% endif %}{% if seed_count > 0 %}
+    <span class="legend-chip type-seed">seed</span>{% endif %}{% if source_count > 0 %}
+    <span class="legend-chip type-source">source</span>{% endif %}{% if exposure_count > 0 %}
+    <span class="legend-chip type-exposure">exposure</span>{% endif %}
     <span class="legend-chip notcompiled">not compiled</span>{% if has_change_context %}
     <span class="legend-chip changed">changed</span>{% endif %}
     &mdash; a dashed node has no compiled SQL in this manifest (<code>dbt parse</code>); run <code>dbt compile</code> to fill it in. The explorer renders it anyway (fail-open).{% if has_change_context %} An amber-glow node&rsquo;s file changed in this PR diff &mdash; change context only highlights; the full graph always renders every model.{% endif %}
diff --git a/templates/explore-lineage.js b/templates/explore-lineage.js
index 3b8727bc..ea66a317 100644
--- a/templates/explore-lineage.js
+++ b/templates/explore-lineage.js
@@ -148,12 +148,17 @@
   var MAX_TEXT_WIDTH = 274;
   var measureCtx = document.createElement("canvas").getContext("2d");
   measureCtx.font = "13px " + FONT_STACK;
-  function nodeWidth(name, badge) {
+  // cute-dbt#253 — per-type horizontal padding: non-rectangular shapes
+  // (ellipse / barrel / round-tag) inscribe less text than a rectangle,
+  // so their labels need wider boxes to stay un-clipped.
+  var TYPE_PAD = { model: 26, snapshot: 34, seed: 44, source: 44, exposure: 44 };
+  function nodeWidth(name, badge, type) {
     var widest = Math.max(
       measureCtx.measureText(name).width,
       measureCtx.measureText(badge).width
     );
-    return Math.min(300, Math.ceil(widest) + 26);
+    var pad = TYPE_PAD[type] || 26;
+    return Math.min(300, Math.ceil(widest) + pad);
   }
   // Manual single-line ellipsis (the label is two lines under
   // `text-wrap: wrap` for the cute-dbt#103 badge, so Cytoscape's
@@ -178,6 +183,10 @@
     // are manifest test-count facts, not check-engine output.
     var name = ellipsize(String(n.name || n.id));
     var badge = String(n.badge || "");
+    // cute-dbt#253 — the typed-node vocabulary (model / snapshot / seed
+    // / source / exposure), the style/shape hook below. Pre-#253
+    // payloads carried models only; default accordingly.
+    var type = String(n.node_type || "model");
     elements.push({
       group: "nodes",
       // The element id is the full manifest node id. It is only ever
@@ -187,7 +196,8 @@
       data: {
         id: n.id,
         label: badge ? name + "\n" + badge : name,
-        w: nodeWidth(name, badge),
+        w: nodeWidth(name, badge, type),
+        type: type,
         notCompiled: n.not_compiled ? 1 : 0,
         // cute-dbt#106 — PR-diff change context. The payload omits the
         // key entirely on a no-context render, so `n.changed` is
@@ -226,6 +236,37 @@
       "transition-property": "opacity",
       "transition-duration": 120
     }},
+    // cute-dbt#253 — the typed-node vocabulary. Redundant coding (shape
+    // AND canvas-paired color) so the typing never rides color alone;
+    // the dag.html legend chips mirror these exact fills/strokes (the
+    // report's fixed-DAG-palette posture — identical in every theme).
+    // The explicit model selector restates the base style so the
+    // node-vocab completeness guard greps one selector per wire key.
+    { selector: 'node[type = "model"]', style: {
+      "shape": "round-rectangle",
+      "background-color": "#e8f1f8",
+      "border-color": "#0072B2"
+    }},
+    { selector: 'node[type = "snapshot"]', style: {
+      "shape": "cut-rectangle",
+      "background-color": "#f1ecf9",
+      "border-color": "#7b5ea7"
+    }},
+    { selector: 'node[type = "seed"]', style: {
+      "shape": "barrel",
+      "background-color": "#e6f4f2",
+      "border-color": "#00756d"
+    }},
+    { selector: 'node[type = "source"]', style: {
+      "shape": "ellipse",
+      "background-color": "#eef7ee",
+      "border-color": "#1f8a5b"
+    }},
+    { selector: 'node[type = "exposure"]', style: {
+      "shape": "round-tag",
+      "background-color": "#f4f4f5",
+      "border-color": "#6b6b76"
+    }},
     { selector: "node[notCompiled = 1]", style: {
       "background-color": "#f4f4f5",
       "border-color": "#b07400",
@@ -358,9 +399,17 @@
     var n = nodeById[id];
     if (!card || !n) return;
     var d = n.detail;
+    // cute-dbt#253 — type-aware facts: code-bearing nodes-map types
+    // carry files/grain; sources/exposures honestly omit what they
+    // structurally cannot have.
+    var type = String(n.node_type || "model");
+    var codeBearing = type === "model" || type === "snapshot" || type === "seed";
     while (card.firstChild) card.removeChild(card.firstChild);
 
     card.appendChild(el("h2", null, n.name || n.id));
+    if (type !== "model") {
+      card.appendChild(el("span", "detail-type type-" + type, type));
+    }
     if (n.not_compiled) {
       card.appendChild(el("span", "detail-notcompiled", "not compiled"));
     }
@@ -374,11 +423,17 @@
       : el("p", "detail-description detail-empty", "no description"));
 
     var facts = el("dl", "detail-facts", null);
-    fact(facts, "tests", document.createTextNode(n.badge || ""));
+    // The badge string is empty only on the cute-dbt#253 non-model
+    // types (models always carry the explicit 0/0 line).
+    fact(facts, "tests", n.badge
+      ? document.createTextNode(n.badge)
+      : el("span", "detail-empty", "none"));
     fact(facts, "materialized", d.materialized
       ? el("code", null, d.materialized)
       : el("span", "detail-empty", "not set"));
-    fact(facts, "grain", grainValueNode(d.grain));
+    // Grain is SQL-model semantics — sources/exposures have no grain
+    // ladder to consult, so the row is omitted, not "unknown".
+    if (codeBearing) fact(facts, "grain", grainValueNode(d.grain));
     var tagsNode = document.createElement("span");
     if (d.tags.length) {
       d.tags.forEach(function (tag) {
@@ -401,27 +456,32 @@
 
     // cute-dbt#105 — read-only per-node file paths (the external-drive
     // contract's NodePathsPayload, surfaced for humans too). All values
-    // are project-relative manifest facts; textContent only.
-    card.appendChild(el("p", "detail-section-title", "files"));
-    var pathFacts = el("dl", "detail-facts detail-paths", null);
-    fact(pathFacts, "sql", n.paths.sql
-      ? el("code", null, n.paths.sql)
-      : el("span", "detail-empty", "not in manifest"));
-    fact(pathFacts, "schema yaml", n.paths.schema_yaml
-      ? el("code", null, n.paths.schema_yaml)
-      : el("span", "detail-empty", "none"));
-    n.paths.unit_tests.forEach(function (t) {
-      var holder = document.createElement("span");
-      holder.appendChild(t.yaml
-        ? el("code", null, t.yaml)
-        : el("span", "detail-empty", "yaml not in manifest"));
-      t.fixtures.forEach(function (fixture) {
-        holder.appendChild(document.createTextNode(" "));
-        holder.appendChild(el("code", "detail-path-fixtures", fixture));
+    // are project-relative manifest facts; textContent only. Code-bearing
+    // nodes-map types only (cute-dbt#253): a source/exposure carries no
+    // per-node file paths in the payload, so an all-empty section would
+    // be noise.
+    if (codeBearing) {
+      card.appendChild(el("p", "detail-section-title", "files"));
+      var pathFacts = el("dl", "detail-facts detail-paths", null);
+      fact(pathFacts, "sql", n.paths.sql
+        ? el("code", null, n.paths.sql)
+        : el("span", "detail-empty", "not in manifest"));
+      fact(pathFacts, "schema yaml", n.paths.schema_yaml
+        ? el("code", null, n.paths.schema_yaml)
+        : el("span", "detail-empty", "none"));
+      n.paths.unit_tests.forEach(function (t) {
+        var holder = document.createElement("span");
+        holder.appendChild(t.yaml
+          ? el("code", null, t.yaml)
+          : el("span", "detail-empty", "yaml not in manifest"));
+        t.fixtures.forEach(function (fixture) {
+          holder.appendChild(document.createTextNode(" "));
+          holder.appendChild(el("code", "detail-path-fixtures", fixture));
+        });
+        fact(pathFacts, t.name, holder);
       });
-      fact(pathFacts, t.name, holder);
-    });
-    card.appendChild(pathFacts);
+      card.appendChild(pathFacts);
+    }
 
     card.appendChild(el("p", "detail-section-title", "columns"));
     if (d.columns.length) {
@@ -461,13 +521,25 @@
   function showTooltip(node) {
     var n = nodeById[node.id()];
     if (!tooltip || !n) return;
+    var type = String(n.node_type || "model");
     while (tooltip.firstChild) tooltip.removeChild(tooltip.firstChild);
     tooltip.appendChild(el("span", "tooltip-name", n.name || n.id));
-    tooltip.appendChild(el("span", "tooltip-fact", n.badge || ""));
+    // cute-dbt#253 — surface the non-model typing as a key fact; the
+    // badge line is skipped when empty (non-model types without tests).
+    if (type !== "model") {
+      tooltip.appendChild(el("span", "tooltip-fact", "type: " + type));
+    }
+    if (n.badge) {
+      tooltip.appendChild(el("span", "tooltip-fact", n.badge));
+    }
     if (n.detail.materialized) {
       tooltip.appendChild(el("span", "tooltip-fact", "materialized: " + n.detail.materialized));
     }
-    tooltip.appendChild(el("span", "tooltip-fact", "grain: " + n.detail.grain.value));
+    // Grain is SQL-model semantics (omitted for sources/exposures, the
+    // detail-card rule).
+    if (type === "model" || type === "snapshot" || type === "seed") {
+      tooltip.appendChild(el("span", "tooltip-fact", "grain: " + n.detail.grain.value));
+    }
     if (n.not_compiled) {
       tooltip.appendChild(el("span", "tooltip-fact", "not compiled"));
     }
@@ -609,7 +681,7 @@
     if (!matches.length) {
       var none = document.createElement("li");
       none.className = "lineage-search-none";
-      none.textContent = "no matching model";
+      none.textContent = "no matching node";
       list.appendChild(none);
     }
     matches.forEach(function (m, i) {
diff --git a/tests/headless_zero_egress.rs b/tests/headless_zero_egress.rs
index 47988e73..c7820dc3 100644
--- a/tests/headless_zero_egress.rs
+++ b/tests/headless_zero_egress.rs
@@ -62,8 +62,8 @@ use headless_chrome::protocol::cdp::{Network, Runtime};
 use cute_dbt::adapters::explore::render_explore;
 use cute_dbt::adapters::render::build_payload;
 use cute_dbt::domain::{
-    Checksum, DependsOn, InScopeSet, Manifest, ManifestMetadata, ModelInScopeSet, Node, NodeConfig,
-    NodeId, TestMetadata, all_models,
+    Checksum, DependsOn, Exposure, InScopeSet, Manifest, ManifestMetadata, ModelInScopeSet, Node,
+    NodeConfig, NodeId, SourceNode, TestMetadata, all_models,
 };
 
 fn report_file_url(filename: &str) -> String {
@@ -72,6 +72,44 @@ fn report_file_url(filename: &str) -> String {
     format!("file://{p}")
 }
 
+/// The cute-dbt#253 universal lineage-fidelity probe, evaluated inside
+/// a booted dag.html: re-derives the connected components of the
+/// embedded `explore-dag-data` payload graph (union-find) and compares
+/// them against the LIVE Cytoscape instance's components. Returns the
+/// string `"ok"` iff every payload node is rendered AND each rendered
+/// component's node set equals its payload component — i.e. every node
+/// id in the manifest's connected component appears in ONE rendered
+/// component (the severed-snapshot defect would split it in two).
+const LINEAGE_COMPONENT_FIDELITY_JS: &str = r#"(function () {
+  try {
+    var data = JSON.parse(document.getElementById('explore-dag-data').textContent);
+    var cy = window.CuteExploreLineage && window.CuteExploreLineage.cyInstance();
+    if (!cy) return 'no cy instance';
+    if (cy.nodes().length !== data.nodes.length) {
+      return 'node count mismatch: cy=' + cy.nodes().length + ' payload=' + data.nodes.length;
+    }
+    var parent = {};
+    function find(x) { while (parent[x] !== x) { parent[x] = parent[parent[x]]; x = parent[x]; } return x; }
+    function union(a, b) { a = find(a); b = find(b); if (a !== b) parent[a] = b; }
+    data.nodes.forEach(function (n) { parent[n.id] = n.id; });
+    data.edges.forEach(function (e) { union(e.from, e.to); });
+    var payloadComp = {};
+    data.nodes.forEach(function (n) {
+      var root = find(n.id);
+      (payloadComp[root] = payloadComp[root] || []).push(n.id);
+    });
+    var mismatches = [];
+    cy.elements().components().forEach(function (comp) {
+      var ids = comp.nodes().map(function (el) { return el.id(); }).sort();
+      var expected = (payloadComp[find(ids[0])] || []).slice().sort();
+      if (ids.join('
') !== expected.join('
')) {
+        mismatches.push('[' + ids.join(',') + '] != [' + expected.join(',') + ']');
+      }
+    });
+    return mismatches.length ? 'component mismatch: ' + mismatches.join(' | ') : 'ok';
+  } catch (err) { return 'error: ' + String(err); }
+})()"#;
+
 #[derive(Debug, Clone)]
 struct ExternalRequest {
     url: String,
@@ -385,6 +423,17 @@ fn every_committed_explore_page_makes_zero_external_requests_when_opened_via_fil
                      .lineage-canvas — either the inlined Cytoscape/cytoscape-dagre UMD \
                      bundles are broken offline or the explore lineage engine failed to boot.",
                 ));
+            } else {
+                // cute-dbt#253 — the universal lineage-fidelity guard on
+                // the COMMITTED golden page: every payload node renders
+                // and every connected component survives intact (the
+                // severed-snapshot defect class).
+                let fidelity = eval(&tab, LINEAGE_COMPONENT_FIDELITY_JS);
+                if fidelity != serde_json::Value::String("ok".to_owned()) {
+                    failures.push(format!(
+                        "examples/{filename}: lineage component fidelity failed: {fidelity}",
+                    ));
+                }
             }
         } else {
             // `eval` is this file's Runtime.Evaluate helper (a CDP probe
@@ -532,6 +581,30 @@ fn render_explore_dag(stem: &str, nodes: Vec<Node>) -> String {
     format!("file://{}", p.to_str().expect("page path is valid UTF-8"))
 }
 
+/// Render an explore dag.html from a fully-assembled domain manifest
+/// (cute-dbt#253 — the typed-node scenarios attach `sources` /
+/// `exposures` maps the node-list helper above cannot express) and
+/// return its `file://` URL.
+fn render_explore_dag_manifest(stem: &str, manifest: &Manifest) -> String {
+    let models = all_models(manifest);
+    let payload = build_payload(
+        manifest,
+        &InScopeSet::new(),
+        &models,
+        &HashMap::new(),
+        &HashMap::new(),
+        &HashMap::new(),
+        &HashMap::new(),
+        &HashMap::new(),
+        "",
+    );
+    let dir = PathBuf::from(env!("CARGO_TARGET_TMPDIR")).join(stem);
+    let _ = std::fs::remove_dir_all(&dir);
+    render_explore(&dir, manifest, &models, None, &payload).expect("explore renders");
+    let p = dir.join("dag.html");
+    format!("file://{}", p.to_str().expect("page path is valid UTF-8"))
+}
+
 /// Render an explore dag.html with cute-dbt#106 change context and
 /// return its `file://` URL. `changed_ids` are full model node ids.
 fn render_explore_dag_with_context(stem: &str, nodes: Vec<Node>, changed_ids: &[&str]) -> String {
@@ -2461,3 +2534,181 @@ fn explore_dag_change_context_marks_changed_nodes_and_composes_with_highlight()
 
     let _ = tab.close(true);
 }
+
+// ===== cute-dbt#253 — typed DAG nodes (snapshots / seeds / sources / =====
+// ===== exposures) in a REAL booted lineage                          =====
+
+/// A `nodes`-map entry of an arbitrary resource type (snapshot / seed)
+/// with explicit dependency edges — the [`explore_node`] twin for the
+/// cute-dbt#253 typed-lineage scenarios.
+fn typed_explore_node(
+    id: &str,
+    resource_type: &str,
+    deps: &[&str],
+    compiled: Option<&str>,
+) -> Node {
+    Node::new(
+        NodeId::new(id),
+        resource_type,
+        Checksum::new("sha256", "ck"),
+        compiled.map(str::to_owned),
+        None,
+        DependsOn::new(Vec::new(), deps.iter().map(|d| NodeId::new(*d)).collect()),
+        None,
+        NodeConfig::default(),
+        None,
+        BTreeMap::new(),
+    )
+}
+
+#[test]
+#[ignore = "requires Chrome; runs explicitly in the headless-zero-egress CI job via `-- --ignored`"]
+fn explore_dag_renders_typed_nodes_in_one_connected_component() {
+    // cute-dbt#253 — typed DAG nodes end-to-end in a real browser:
+    //   1. the typed union renders: source / seed / snapshot / exposure
+    //      are live Cytoscape nodes carrying data('type'),
+    //   2. the UNIVERSAL fidelity guard: every node id in the payload's
+    //      connected component appears in ONE rendered component (the
+    //      severed-snapshot defect split `stg → snapshot → dim` in two
+    //      and faked dim as a root),
+    //   3. the CTE arm is MODEL semantics: a highlighted source keeps
+    //      it locked; a highlighted model unlocks it.
+    // The chain: source → stg → snapshot → dim → exposure, plus
+    // seed → stg — every type in one connected component.
+    let nodes = vec![
+        explore_node(
+            "model.shop.stg_patients",
+            &["source.shop.raw.patients", "seed.shop.raw_codes"],
+            Some("select 1"),
+        ),
+        typed_explore_node(
+            "snapshot.shop.snp_patients",
+            "snapshot",
+            &["model.shop.stg_patients"],
+            Some("select 1"),
+        ),
+        typed_explore_node("seed.shop.raw_codes", "seed", &[], None),
+        explore_node(
+            "model.shop.dim_patients",
+            &["snapshot.shop.snp_patients"],
+            Some("select 1"),
+        ),
+    ];
+    let manifest = Manifest::new(
+        ManifestMetadata::new("v12"),
+        nodes.into_iter().map(|n| (n.id().clone(), n)).collect(),
+        HashMap::new(),
+        HashMap::new(),
+    )
+    .with_sources(
+        [(
+            NodeId::new("source.shop.raw.patients"),
+            SourceNode::new(
+                NodeId::new("source.shop.raw.patients"),
+                "raw",
+                "patients",
+                None,
+                "main",
+                None,
+                None,
+            ),
+        )]
+        .into_iter()
+        .collect(),
+    )
+    .with_exposures(
+        [(
+            NodeId::new("exposure.shop.patient_dashboard"),
+            Exposure::new(
+                NodeId::new("exposure.shop.patient_dashboard"),
+                "patient_dashboard",
+                Some("dashboard".to_owned()),
+                None,
+                None,
+                DependsOn::new(Vec::new(), vec![NodeId::new("model.shop.dim_patients")]),
+            ),
+        )]
+        .into_iter()
+        .collect(),
+    );
+    let url = render_explore_dag_manifest("explore-typed-nodes", &manifest);
+
+    let browser = launch_browser();
+    let tab = browser.new_tab().expect("new tab");
+    tab.navigate_to(&url).expect("navigate to file:// URL");
+    tab.wait_until_navigated().expect("await navigation");
+    tab.wait_for_element_with_custom_timeout(".lineage-canvas canvas", Duration::from_secs(15))
+        .expect("the Cytoscape canvas boots offline");
+
+    // (1) every typed node is live, carrying its wire type.
+    for (id, expected_type) in [
+        ("model.shop.stg_patients", "model"),
+        ("snapshot.shop.snp_patients", "snapshot"),
+        ("seed.shop.raw_codes", "seed"),
+        ("source.shop.raw.patients", "source"),
+        ("exposure.shop.patient_dashboard", "exposure"),
+    ] {
+        let probe =
+            format!("window.CuteExploreLineage.cyInstance().getElementById({id:?}).data('type')",);
+        assert_eq!(
+            eval(&tab, &probe),
+            serde_json::Value::String(expected_type.to_owned()),
+            "{id} must render as a {expected_type}-typed Cytoscape node",
+        );
+    }
+
+    // (2) the universal fidelity guard: payload components == rendered
+    // components — and this manifest is ONE component by construction.
+    assert_eq!(
+        eval(&tab, LINEAGE_COMPONENT_FIDELITY_JS),
+        serde_json::Value::String("ok".to_owned()),
+        "every payload component must render as one connected component",
+    );
+    assert_eq!(
+        eval(
+            &tab,
+            "window.CuteExploreLineage.cyInstance().elements().components().length",
+        ),
+        serde_json::Value::from(1u64),
+        "source → stg → snapshot → dim → exposure (+ seed) is ONE chain — \
+         a second component is the severed-lineage defect",
+    );
+
+    // The seed never renders dbt-parse-dashed despite compiled_code: null
+    // (fusion null-fills seed compiled code unconditionally).
+    assert_eq!(
+        eval(
+            &tab,
+            "window.CuteExploreLineage.cyInstance().getElementById('seed.shop.raw_codes').data('notCompiled')",
+        ),
+        serde_json::Value::from(0u64),
+        "a seed is never 'not compiled'",
+    );
+
+    // (3) CTE-arm gating: model semantics only. focusModel is the
+    // host-forward hook — it highlights without committing.
+    assert_eq!(
+        eval(
+            &tab,
+            "(function () { \
+               window.focusModel('source.shop.raw.patients'); \
+               return document.querySelector('[data-view=\"cte\"]').disabled; \
+             })()",
+        ),
+        serde_json::Value::Bool(true),
+        "a highlighted SOURCE keeps the CTE arm locked (model semantics)",
+    );
+    assert_eq!(
+        eval(
+            &tab,
+            "(function () { \
+               window.focusModel('model.shop.stg_patients'); \
+               return document.querySelector('[data-view=\"cte\"]').disabled; \
+             })()",
+        ),
+        serde_json::Value::Bool(false),
+        "a highlighted MODEL unlocks the CTE arm",
+    );
+
+    let _ = tab.close(true);
+}
diff --git a/tests/render_integration.rs b/tests/render_integration.rs
index 88764ac9..3faa3017 100644
--- a/tests/render_integration.rs
+++ b/tests/render_integration.rs
@@ -490,3 +490,189 @@ fn source_given_binds_against_the_real_playground_fixture() {
          `source` import CTE via the sources-block resolution",
     );
 }
+
+// ===== cute-dbt#253 — typed lineage nodes, proven on the REAL fixtures =====
+//
+// The explorer lineage must render snapshots/seeds/sources/exposures as
+// typed DAG nodes: the pre-#253 model-only filter severed
+// `stg → snapshot → downstream` into two components and faked the
+// downstream model (and every source-fed staging model) as a root.
+// These tests are the fixture-proven halves of the cute-dbt#253 ACs:
+// the committed playground manifest carries a real mid-chain snapshot +
+// 16 sources + 1 exposure; the committed jaffle-shop manifest carries 3
+// seeds.
+
+/// Every manifest entry the typed lineage renders, with its expected
+/// type — models/snapshots/seeds from the `nodes` map plus the
+/// `sources`/`exposures` maps.
+fn renderable_ids(
+    manifest: &Manifest,
+) -> std::collections::HashMap<String, cute_dbt::adapters::explore::LineageNodeType> {
+    use cute_dbt::adapters::explore::LineageNodeType;
+    let mut ids = std::collections::HashMap::new();
+    for (id, node) in manifest.nodes() {
+        let node_type = match node.resource_type() {
+            "model" => LineageNodeType::Model,
+            "snapshot" => LineageNodeType::Snapshot,
+            "seed" => LineageNodeType::Seed,
+            _ => continue,
+        };
+        ids.insert(id.as_str().to_owned(), node_type);
+    }
+    for id in manifest.sources().keys() {
+        ids.insert(
+            id.as_str().to_owned(),
+            cute_dbt::adapters::explore::LineageNodeType::Source,
+        );
+    }
+    for id in manifest.exposures().keys() {
+        ids.insert(
+            id.as_str().to_owned(),
+            cute_dbt::adapters::explore::LineageNodeType::Exposure,
+        );
+    }
+    ids
+}
+
+/// Assert the lineage payload over `manifest` renders every renderable
+/// manifest entry, typed, with every dependency edge between renderable
+/// ids present (no severing ⇒ no false roots), and return the payload.
+fn assert_lineage_complete(manifest: &Manifest) -> cute_dbt::adapters::explore::LineagePayload {
+    use cute_dbt::adapters::explore::build_lineage_payload;
+    use cute_dbt::domain::all_models;
+    let expected = renderable_ids(manifest);
+    let payload = build_lineage_payload(manifest, &all_models(manifest), None);
+    // (1) node-set completeness + typing.
+    let rendered: std::collections::HashMap<&str, _> = payload
+        .nodes
+        .iter()
+        .map(|n| (n.id.as_str(), n.node_type))
+        .collect();
+    for (id, node_type) in &expected {
+        assert_eq!(
+            rendered.get(id.as_str()),
+            Some(node_type),
+            "{id} must render as a typed lineage node",
+        );
+    }
+    assert_eq!(
+        rendered.len(),
+        expected.len(),
+        "the lineage renders exactly the renderable manifest entries",
+    );
+    // (2) edge completeness: every manifest dependency between two
+    // renderable ids is a payload edge — the no-severing invariant
+    // (a missing edge is what manufactured the false roots).
+    let edges: std::collections::HashSet<(&str, &str)> = payload
+        .edges
+        .iter()
+        .map(|e| (e.from.as_str(), e.to.as_str()))
+        .collect();
+    let mut checked = 0usize;
+    let require_edge = |from: &str, to: &str| {
+        assert!(
+            edges.contains(&(from, to)),
+            "manifest dependency {from} -> {to} must be a lineage edge",
+        );
+    };
+    for (id, node) in manifest.nodes() {
+        if !expected.contains_key(id.as_str()) {
+            continue;
+        }
+        for dep in node.depends_on().nodes() {
+            if expected.contains_key(dep.as_str()) {
+                require_edge(dep.as_str(), id.as_str());
+                checked += 1;
+            }
+        }
+    }
+    for (id, exposure) in manifest.exposures() {
+        for dep in exposure.depends_on().nodes() {
+            if expected.contains_key(dep.as_str()) {
+                require_edge(dep.as_str(), id.as_str());
+                checked += 1;
+            }
+        }
+    }
+    assert!(checked > 0, "the fixture must exercise at least one edge");
+    payload
+}
+
+#[test]
+fn playground_lineage_renders_the_snapshot_mid_chain_with_no_false_roots() {
+    let current = load("playground-current.json");
+    let payload = assert_lineage_complete(&current);
+    // The cute-dbt#253 discovery chain, by id: the snapshot sits
+    // MID-CHAIN and both its edges survive.
+    let edges: std::collections::HashSet<(&str, &str)> = payload
+        .edges
+        .iter()
+        .map(|e| (e.from.as_str(), e.to.as_str()))
+        .collect();
+    assert!(edges.contains(&(
+        "model.healthcare_analytics.stg_synthea__patients",
+        "snapshot.healthcare_analytics.snp_patients",
+    )));
+    assert!(edges.contains(&(
+        "snapshot.healthcare_analytics.snp_patients",
+        "model.healthcare_analytics.dim_patients",
+    )));
+    // dim_patients is fed by the snapshot — NOT a false root.
+    assert!(
+        payload
+            .edges
+            .iter()
+            .any(|e| e.to == "model.healthcare_analytics.dim_patients"),
+        "dim_patients must have an incoming edge (the severed-chain defect)",
+    );
+    // The 16 sources render as roots; the exposure as a sink.
+    let sources = payload
+        .nodes
+        .iter()
+        .filter(|n| n.node_type == cute_dbt::adapters::explore::LineageNodeType::Source)
+        .count();
+    assert_eq!(sources, 16, "every playground source renders");
+    let exposure_id = "exposure.healthcare_analytics.provider_quality_dashboard";
+    assert!(
+        payload.edges.iter().any(|e| e.to == exposure_id),
+        "the exposure terminates a lineage chain",
+    );
+    assert!(
+        !payload.edges.iter().any(|e| e.from == exposure_id),
+        "an exposure is a sink",
+    );
+}
+
+#[test]
+fn jaffle_shop_lineage_renders_seeds_as_typed_roots() {
+    use cute_dbt::adapters::explore::LineageNodeType;
+    let current = load("jaffle-shop-current.json");
+    let payload = assert_lineage_complete(&current);
+    let seeds: Vec<&str> = payload
+        .nodes
+        .iter()
+        .filter(|n| n.node_type == LineageNodeType::Seed)
+        .map(|n| n.id.as_str())
+        .collect();
+    assert_eq!(seeds.len(), 3, "the jaffle-shop fixture carries 3 seeds");
+    for seed in seeds {
+        assert!(
+            payload.edges.iter().any(|e| e.from == seed),
+            "{seed} feeds at least one staging model",
+        );
+        assert!(
+            !payload.edges.iter().any(|e| e.to == seed),
+            "{seed} is a root (no incoming edges)",
+        );
+        assert!(
+            !payload
+                .nodes
+                .iter()
+                .find(|n| n.id == seed)
+                .expect("seed node present")
+                .not_compiled,
+            "{seed} never renders dbt-parse-dashed (fusion null-fills \
+             seed compiled_code unconditionally)",
+        );
+    }
+}
diff --git a/tests/steps/builders.rs b/tests/steps/builders.rs
index ea07eeaf..3f15597a 100644
--- a/tests/steps/builders.rs
+++ b/tests/steps/builders.rs
@@ -401,24 +401,34 @@ pub fn serialize_coverage_to_tmp(
 ///    (domain `NodeConfig` serializes nested; the wire reader flattens)
 ///    and the object-shaped `columns` map (the domain serializes a
 ///    name→type map the wire reader cannot ingest);
-/// 2. **test nodes** — each `(node id, node json)` entry is spliced
-///    into `nodes` verbatim in the real wire shape (`resource_type:
-///    "test"`, `attached_node`, `test_metadata`, flat `config.enabled`).
+/// 2. **raw nodes** — each `(node id, node json)` entry is spliced
+///    into `nodes` verbatim in the real wire shape: test nodes
+///    (`resource_type: "test"`, `attached_node`, `test_metadata`, flat
+///    `config.enabled`) and, since cute-dbt#253, snapshot/seed nodes;
+/// 3. **top-level map entries** (cute-dbt#253) — each
+///    `(map, entry key, entry json)` triple is spliced into a top-level
+///    manifest map (`sources` / `exposures`) verbatim, in the real wire
+///    shape the domain types do not round-trip (the domain serializes
+///    its own field names; the wire reader expects dbt's).
 #[must_use]
 pub fn serialize_explore_to_tmp(
     manifest: &Manifest,
     name: &str,
     node_patches: &[(String, String, Value)],
-    test_nodes: &[(String, Value)],
+    raw_nodes: &[(String, Value)],
+    top_map_entries: &[(String, String, Value)],
 ) -> PathBuf {
     let mut value: Value = serde_json::to_value(manifest).expect("manifest serializes to Value");
     for (bare, key, patch) in node_patches {
         let id = model_id(bare);
         value["nodes"][id.as_str()][key.as_str()] = patch.clone();
     }
-    for (id, node) in test_nodes {
+    for (id, node) in raw_nodes {
         value["nodes"][id.as_str()] = node.clone();
     }
+    for (map, key, entry) in top_map_entries {
+        value[map.as_str()][key.as_str()] = entry.clone();
+    }
     let path = Path::new(env!("CARGO_TARGET_TMPDIR")).join(format!("{name}.json"));
     std::fs::write(
         &path,
diff --git a/tests/steps/explore_full_manifest.rs b/tests/steps/explore_full_manifest.rs
index b6f5cde0..9c4a62fb 100644
--- a/tests/steps/explore_full_manifest.rs
+++ b/tests/steps/explore_full_manifest.rs
@@ -40,6 +40,7 @@ fn declares_model(world: &mut World, bare: String) {
         compiled: true,
         compiled_sql: None,
         deps: Vec::new(),
+        raw_deps: Vec::new(),
         tests: Vec::new(),
         description: None,
         tags: Vec::new(),
@@ -163,15 +164,111 @@ pub fn serialize_plan_manifest(world: &World, stem: &str) -> std::path::PathBuf
     for t in &plan.path_tests {
         manifest = with_unit_test(manifest, super::explore_js_contract::path_unit_test(t));
     }
+    // cute-dbt#253 — non-model dependencies (snapshot/seed/source ids)
+    // ride a wire `depends_on` patch: the domain decl's bare `deps` map
+    // through `model_id`, which is model-only by design.
+    for m in &plan.models {
+        if m.raw_deps.is_empty() {
+            continue;
+        }
+        let mut dep_ids: Vec<String> = m
+            .deps
+            .iter()
+            .map(|d| super::builders::model_id(d).as_str().to_owned())
+            .collect();
+        dep_ids.extend(m.raw_deps.iter().cloned());
+        node_patches.push((
+            m.bare.clone(),
+            "depends_on".to_owned(),
+            serde_json::json!({ "macros": [], "nodes": dep_ids }),
+        ));
+    }
     // cute-dbt#103 — splice the declared data-test nodes in the REAL
     // fusion wire shape (the coverage_checks.rs precedent: the domain
     // types do not round-trip a flat test-node `config`). An empty
     // declaration list degenerates to the plain serialization.
     // cute-dbt#104 — the uniqueness-test nodes ride the same splice.
-    let mut test_nodes: Vec<(String, serde_json::Value)> =
+    let mut raw_nodes: Vec<(String, serde_json::Value)> =
         plan.data_tests.iter().map(wire_data_test).collect();
-    test_nodes.extend(plan.uniqueness_tests.iter().map(wire_uniqueness_test));
-    serialize_explore_to_tmp(&manifest, stem, &node_patches, &test_nodes)
+    raw_nodes.extend(plan.uniqueness_tests.iter().map(wire_uniqueness_test));
+    // cute-dbt#253 — splice the declared snapshot/seed nodes in the
+    // REAL wire shapes: snapshots carry `compiled_code` (the fusion
+    // compile-backfill, `dbt-tasks-sa/src/utils.rs:151-172` @
+    // `9977b6cb…`); seeds carry `compiled_code: null` and a
+    // `depends_on` WITHOUT a `nodes` key (fusion null-fills seed
+    // compiled code unconditionally, `manifest_nodes.rs:232-233`).
+    for (bare, dep_bares) in &plan.snapshots {
+        let deps: Vec<String> = dep_bares
+            .iter()
+            .map(|d| super::builders::model_id(d).as_str().to_owned())
+            .collect();
+        raw_nodes.push((
+            format!("snapshot.jaffle_shop.{bare}"),
+            serde_json::json!({
+                "resource_type": "snapshot",
+                "name": bare,
+                "package_name": "jaffle_shop",
+                "checksum": { "name": "sha256", "checksum": "snapck" },
+                "raw_code": "select * from upstream",
+                "compiled_code": "select * from upstream",
+                "config": { "materialized": "snapshot" },
+                "depends_on": { "macros": [], "nodes": deps },
+                "original_file_path": format!("snapshots/{bare}.sql"),
+            }),
+        ));
+    }
+    for bare in &plan.seeds {
+        raw_nodes.push((
+            format!("seed.jaffle_shop.{bare}"),
+            serde_json::json!({
+                "resource_type": "seed",
+                "name": bare,
+                "package_name": "jaffle_shop",
+                "checksum": { "name": "sha256", "checksum": "seedck" },
+                "raw_code": "",
+                "compiled_code": null,
+                "depends_on": { "macros": [] },
+                "original_file_path": format!("seeds/{bare}.csv"),
+            }),
+        ));
+    }
+    // cute-dbt#253 — splice the declared sources/exposures into their
+    // top-level manifest maps in the real wire shape.
+    let mut top_map_entries: Vec<(String, String, serde_json::Value)> = Vec::new();
+    for (source_name, table) in &plan.sources {
+        top_map_entries.push((
+            "sources".to_owned(),
+            format!("source.jaffle_shop.{source_name}.{table}"),
+            serde_json::json!({
+                "resource_type": "source",
+                "source_name": source_name,
+                "name": table,
+                "identifier": table,
+                "schema": "main",
+                "database": null,
+                "relation_name": null,
+                "original_file_path": "models/staging/_sources.yml",
+            }),
+        ));
+    }
+    for (name, dep_bares) in &plan.exposures {
+        let deps: Vec<String> = dep_bares
+            .iter()
+            .map(|d| super::builders::model_id(d).as_str().to_owned())
+            .collect();
+        top_map_entries.push((
+            "exposures".to_owned(),
+            format!("exposure.jaffle_shop.{name}"),
+            serde_json::json!({
+                "resource_type": "exposure",
+                "name": name,
+                "type": "dashboard",
+                "owner": { "name": "analytics", "email": null },
+                "depends_on": { "macros": [], "nodes": deps },
+            }),
+        ));
+    }
+    serialize_explore_to_tmp(&manifest, stem, &node_patches, &raw_nodes, &top_map_entries)
 }
 
 // --- Then ----------------------------------------------------------------
diff --git a/tests/steps/explore_lineage_dag.rs b/tests/steps/explore_lineage_dag.rs
index 35f02b21..8e4a4e1d 100644
--- a/tests/steps/explore_lineage_dag.rs
+++ b/tests/steps/explore_lineage_dag.rs
@@ -12,12 +12,71 @@
 //! only the runtime Space commit writes it, which the headless suite
 //! drives with a real keyboard).
 
-use cucumber::then;
+use cucumber::{given, then};
 use serde_json::Value;
 
 use super::World;
 use super::explore_full_manifest::{lineage_payload, payload_node};
 
+// --- typed-node Givens (cute-dbt#253) -------------------------------------
+// Declarations accumulate on the ExplorePlan; the shared explore `When`
+// splices them into the serialized wire manifest in the REAL engine
+// shapes (snapshot/seed `nodes`-map entries, `sources`/`exposures`
+// top-level maps) — the subprocess wire-round-trip discipline.
+
+#[given(regex = r#"^the explore manifest declares the snapshot "([^"]+)" built from "([^"]+)"$"#)]
+fn declares_snapshot(world: &mut World, bare: String, upstream: String) {
+    world.explore_plan.snapshots.push((bare, vec![upstream]));
+}
+
+#[given(regex = r#"^the explore manifest declares the seed "([^"]+)"$"#)]
+fn declares_seed(world: &mut World, bare: String) {
+    world.explore_plan.seeds.push(bare);
+}
+
+#[given(regex = r#"^the explore manifest declares the source "([^"]+)" table "([^"]+)"$"#)]
+fn declares_source(world: &mut World, source_name: String, table: String) {
+    world.explore_plan.sources.push((source_name, table));
+}
+
+#[given(regex = r#"^the explore manifest declares the exposure "([^"]+)" on "([^"]+)"$"#)]
+fn declares_exposure(world: &mut World, name: String, target: String) {
+    world.explore_plan.exposures.push((name, vec![target]));
+}
+
+#[given(regex = r#"^the explore model "([^"]+)" depends on the snapshot "([^"]+)"$"#)]
+fn model_depends_on_snapshot(world: &mut World, bare: String, snapshot: String) {
+    model_raw_dep(world, &bare, format!("snapshot.jaffle_shop.{snapshot}"));
+}
+
+#[given(regex = r#"^the explore model "([^"]+)" depends on the seed "([^"]+)"$"#)]
+fn model_depends_on_seed(world: &mut World, bare: String, seed: String) {
+    model_raw_dep(world, &bare, format!("seed.jaffle_shop.{seed}"));
+}
+
+#[given(regex = r#"^the explore model "([^"]+)" depends on the source "([^"]+)" table "([^"]+)"$"#)]
+fn model_depends_on_source(world: &mut World, bare: String, source_name: String, table: String) {
+    model_raw_dep(
+        world,
+        &bare,
+        format!("source.jaffle_shop.{source_name}.{table}"),
+    );
+}
+
+/// Push a FULL-id dependency onto a declared model (the non-model
+/// `raw_deps` channel — bare `deps` map through the model-only
+/// `model_id`).
+fn model_raw_dep(world: &mut World, bare: &str, dep_id: String) {
+    world
+        .explore_plan
+        .models
+        .iter_mut()
+        .find(|m| m.bare == bare)
+        .unwrap_or_else(|| panic!("model {bare:?} must be declared before it is configured"))
+        .raw_deps
+        .push(dep_id);
+}
+
 /// The rendered dag.html, panicking with stderr context when absent.
 fn dag_html(world: &World) -> String {
     world
@@ -173,6 +232,19 @@ fn dag_no_selected_model_at_render(world: &mut World) {
     );
 }
 
+// --- typed nodes (cute-dbt#253) --------------------------------------------
+
+#[then(regex = r#"^the lineage payload types "([^"]+)" as "([^"]+)"$"#)]
+fn payload_types_node(world: &mut World, name: String, node_type: String) {
+    let payload = lineage_payload(world);
+    let node = payload_node(&payload, &name);
+    assert_eq!(
+        node["node_type"],
+        Value::String(node_type.clone()),
+        "{name:?} must carry node_type {node_type:?}: {payload}",
+    );
+}
+
 // --- hostile names --------------------------------------------------------
 
 #[then(regex = r#"^the lineage payload round-trips the name "(.+)"$"#)]
diff --git a/tests/steps/world.rs b/tests/steps/world.rs
index 2e7a9527..b8b5ace8 100644
--- a/tests/steps/world.rs
+++ b/tests/steps/world.rs
@@ -249,6 +249,25 @@ pub struct ExplorePlan {
     /// the wire shape — `rows: null` + `fixture`, the confirmed fusion
     /// external-fixture shape).
     pub path_tests: Vec<ExplorePathTestDecl>,
+    /// Declared snapshot nodes (cute-dbt#253 — the typed-lineage
+    /// scenarios): `(bare name, upstream bare model names)`. Spliced
+    /// into the serialized manifest's `nodes` map in the REAL wire
+    /// shape (`resource_type: "snapshot"`, `depends_on.nodes`,
+    /// `compiled_code` present — fusion's compile-backfill shape,
+    /// `dbt-tasks-sa/src/utils.rs:151-172` @ `9977b6cb…`).
+    pub snapshots: Vec<(String, Vec<String>)>,
+    /// Declared seed nodes (cute-dbt#253): bare names. Spliced in the
+    /// REAL fusion wire shape — `resource_type: "seed"`,
+    /// `compiled_code: null` (fusion null-fills it unconditionally,
+    /// `manifest_nodes.rs:232-233` @ `9977b6cb…`) and `depends_on`
+    /// WITHOUT a `nodes` key (seeds have no dependencies).
+    pub seeds: Vec<String>,
+    /// Declared `sources`-map entries (cute-dbt#253):
+    /// `(source_name, table)` — the two `source(...)` arguments.
+    pub sources: Vec<(String, String)>,
+    /// Declared `exposures`-map entries (cute-dbt#253):
+    /// `(name, depended-on bare model names)`.
+    pub exposures: Vec<(String, Vec<String>)>,
 }
 
 /// One path-bearing unit test in an [`ExplorePlan`] (cute-dbt#105).
@@ -314,6 +333,11 @@ pub struct ExploreModelDecl {
     pub compiled_sql: Option<String>,
     /// Bare names of models this model depends on (lineage edges).
     pub deps: Vec<String>,
+    /// FULL node ids of non-model dependencies (cute-dbt#253 —
+    /// `snapshot.…` / `seed.…` / `source.…`). Spliced as a wire
+    /// `depends_on` patch by the explore `When` (the bare `deps` map
+    /// through `model_id`, which is model-only).
+    pub raw_deps: Vec<String>,
     /// Bare names of unit tests targeting this model.
     pub tests: Vec<String>,
     /// Authored model description (cute-dbt#104) — rides the domain