initial commit

docs/template_validation_status.md

@@ -0,0 +1,62 @@
+# Template Validation Status
+
+Last reviewed: 2026-05-12
+
+## Scope
+
+The reusable SQL templates in folders `01_medicine_lookups` through
+`06_advanced_methods` were checked with the Snowflake MCP against live table
+metadata and representative parameter values. Templates that use `SET`
+variables were validated by substituting safe example literals into the final
+`SELECT` statement before running `describe_query`.
+
+The `00_copied_reference` folder and `docs/training_intro_snowflake_sql` are
+historic/reference material. They are retained for learning and comparison,
+not as the preferred starting point for new analysis.
+
+## Live Metadata Checked
+
+- `REPORTING_DATASETS_ICB.SCRATCHPAD."MEDS__UnifiedPrescribingTable"`
+- `NATIONAL.GPMED."MedicinesDispensedInPrimarycare"`
+- `DATA_HUB.DWH."DimMedicineAndDevice"`
+- `DATA_HUB.DWH."DimOrganisationAndSite"`
+- `DATA_HUB.DWH."DimPerson"`
+- `DATA_HUB.PHM."ClinicalCodingClusterSnomedCodes"`
+- `DATA_HUB.PHM."PrimaryCareClinicalCoding"`
+- `PRIMARY_CARE.TPP."SRPrimaryCareMedication"`
+- `PRIMARY_CARE.TPP."SRPatient"`
+
+## Query Compilation Checks
+
+All files below passed Snowflake MCP `describe_query` validation:
+
+- `01_medicine_lookups/medicine_reference_lookup.sql`
+- `01_medicine_lookups/prescribing_by_vtm.sql`
+- `01_medicine_lookups/prescribing_by_vmp.sql`
+- `01_medicine_lookups/dispensing_by_vtm_or_vmp.sql`
+- `01_medicine_lookups/prescribing_for_patient_pseudonym.sql`
+- `02_prescribing_analysis/practice_level_bnf_prescribing_summary.sql`
+- `02_prescribing_analysis/high_prescribing_practices_quintile_template.sql`
+- `02_prescribing_analysis/prescribing_spend_by_patient_template.sql`
+- `03_cohorts_and_clinical_coding/cluster_code_lookup.sql`
+- `03_cohorts_and_clinical_coding/monthly_clinical_event_count_by_practice.sql`
+- `03_cohorts_and_clinical_coding/prescribing_plus_clinical_code_cohort.sql`
+- `04_rolling_and_pqs/rolling_period_generator.sql`
+- `04_rolling_and_pqs/latest_data_dates.sql`
+- `04_rolling_and_pqs/baseline_vs_evaluation_template.sql`
+- `04_rolling_and_pqs/dual_source_long_format_measure_template.sql`
+- `05_audit_detail/human_readable_prescribing_detail.sql`
+- `06_advanced_methods/product_price_and_quantity_parsing_template.sql`
+
+## Freshness Probe
+
+The `latest_data_dates.sql` query was also executed with Snowflake MCP. At the
+time of review it returned:
+
+- `NATIONAL.GPMED."MedicinesDispensedInPrimarycare"` latest
+  `ProcessingPeriodDate`: `2025-07-01`
+- `PRIMARY_CARE.TPP."SRPrimaryCareMedication"` latest `DateEventRecorded`
+  within the recent-window probe: `2026-03-28`
+- `REPORTING_DATASETS_ICB.SCRATCHPAD."MEDS__UnifiedPrescribingTable"` latest
+  non-future `DateMedicationStart`: `2026-05-12`
+