Add documentation for X-Ray Revenue and Count queries at SSMM

Care/Accouting/revenue_xray_ssmm.md

@@ -0,0 +1,43 @@
+
+# X-Ray Revenue - SSMM
+
+> Total revenue from X-ray charge items linked to issued/balanced invoices
+
+## Purpose
+
+Returns the total X-ray revenue at SSMM by summing `total_price` of charge items whose `charge_item_definition` belongs to the X-ray resource category (`category_id = 75`) and which are linked to a settled invoice.
+
+## Parameters
+
+| Parameter | Type | Description | Example |
+|-----------|------|-------------|---------|
+| `DATE` | DATE | Filter by date range (typically `inv.modified_date`) | `inv.modified_date BETWEEN '2026-05-01' AND '2026-05-04'` |
+
+---
+
+## Query
+
+```sql
+SELECT 
+    COALESCE(SUM(ci.total_price), 0) AS total_revenue
+FROM emr_chargeitem ci
+JOIN emr_chargeitemdefinition cid ON ci.charge_item_definition_id = cid.id
+JOIN emr_invoice inv ON ci.paid_invoice_id = inv.id
+WHERE cid.category_id = 75
+  AND inv.deleted = FALSE
+  AND ci.status IN ('paid', 'billed')
+  AND inv.status IN ('issued', 'balanced')
+  --[[AND {{DATE}}]]
+
+```
+
+
+## Notes
+
+- Hardcoded to `cid.category_id = 75` — the X-ray resource category. Update if this ID changes or new X-ray categories are added.
+- `COALESCE(SUM(...), 0)` ensures the result is `0` instead of `NULL` when no rows match.
+- Metabase-specific filters (`[[...]]`) allow dynamic filtering in dashboards
+
+*Last updated: 2026-05-04*
+
+````

Care/Encounter/xray_count_ssmm.md

@@ -0,0 +1,40 @@
+
+# X-Ray Count - SSMM
+
+> Total count of X-ray charge items (in the X-ray resource category)
+
+## Purpose
+
+Returns the total number of X-rays at SSMM by counting charge items whose `charge_item_definition` belongs to the X-ray resource category (`category_id = 75`) 
+
+## Parameters
+
+| Parameter | Type | Description | Example |
+|-----------|------|-------------|---------|
+| `DATE` | DATE | Filter by date range (typically `ci.modified_date`) | `ci.modified_date BETWEEN '2026-05-01' AND '2026-05-04'` |
+
+---
+
+## Query
+
+```sql
+SELECT 
+    COUNT(ci.id) AS total_tests
+FROM emr_chargeitem ci
+JOIN emr_chargeitemdefinition cid ON ci.charge_item_definition_id = cid.id
+WHERE cid.category_id = 75
+  AND ci.status IN ('paid', 'billed', 'billable')
+  --[[AND {{DATE}}]]
+
+```
+
+
+
+## Notes
+
+- Hardcoded to `cid.category_id = 75` — the X-ray resource category. Update if this category ID changes or new X-ray categories are added.
+- Metabase-specific filters (`[[...]]`) allow dynamic filtering in dashboards
+
+*Last updated: 2026-05-04*
+
+````