@luquimbo/bi-superpowers 1.0.0

package/library/examples/hr-analytics/measures.dax

@@ -0,0 +1,460 @@
+// ============================================================================
+// HR ANALYTICS - DAX MEASURE LIBRARY
+// ============================================================================
+// Comprehensive measures for headcount, turnover, tenure, and diversity
+// All measures follow BI Agent Superpowers naming conventions
+// ============================================================================
+
+
+// ----------------------------------------------------------------------------
+// HEADCOUNT MEASURES
+// ----------------------------------------------------------------------------
+
+// Current active headcount
+Headcount =
+CALCULATE(
+    DISTINCTCOUNT(FactEmployeeSnap[EmployeeKey]),
+    DimEmployee[IsActive] = TRUE()
+)
+
+// Headcount at end of selected period
+Headcount EOP =
+CALCULATE(
+    [Headcount],
+    LASTDATE(DimDate[Date])
+)
+
+// Headcount at beginning of period
+Headcount BOP =
+CALCULATE(
+    [Headcount],
+    FIRSTDATE(DimDate[Date])
+)
+
+// Average headcount across period
+Headcount Avg =
+AVERAGEX(
+    VALUES(DimDate[YearMonth]),
+    CALCULATE([Headcount EOP], LASTDATE(DimDate[Date]))
+)
+
+// Full-Time Equivalents
+FTE =
+CALCULATE(
+    SUM(FactEmployeeSnap[FTEFactor]),
+    DimEmployee[IsActive] = TRUE(),
+    LASTDATE(DimDate[Date])
+)
+
+// Part-time headcount
+Part Time Count =
+CALCULATE(
+    DISTINCTCOUNT(FactEmployeeSnap[EmployeeKey]),
+    FactEmployeeSnap[FTEFactor] < 1,
+    DimEmployee[IsActive] = TRUE()
+)
+
+// Contractor count (if tracked)
+Contractor Count =
+CALCULATE(
+    [Headcount],
+    DimEmployee[EmployeeType] = "Contractor"
+)
+
+
+// ----------------------------------------------------------------------------
+// TURNOVER MEASURES
+// ----------------------------------------------------------------------------
+
+// Total terminations in period
+Terminations =
+VAR _MinDate = MIN(DimDate[Date])
+VAR _MaxDate = MAX(DimDate[Date])
+RETURN
+    CALCULATE(
+        COUNTROWS(DimEmployee),
+        DimEmployee[TermDate] >= _MinDate,
+        DimEmployee[TermDate] <= _MaxDate
+    )
+
+// Voluntary terminations
+Voluntary Terms =
+VAR _MinDate = MIN(DimDate[Date])
+VAR _MaxDate = MAX(DimDate[Date])
+RETURN
+    CALCULATE(
+        COUNTROWS(DimEmployee),
+        DimEmployee[TermDate] >= _MinDate,
+        DimEmployee[TermDate] <= _MaxDate,
+        DimEmployee[TermType] = "Voluntary"
+    )
+
+// Involuntary terminations
+Involuntary Terms =
+VAR _MinDate = MIN(DimDate[Date])
+VAR _MaxDate = MAX(DimDate[Date])
+RETURN
+    CALCULATE(
+        COUNTROWS(DimEmployee),
+        DimEmployee[TermDate] >= _MinDate,
+        DimEmployee[TermDate] <= _MaxDate,
+        DimEmployee[TermType] = "Involuntary"
+    )
+
+// Regrettable turnover (high performers who left voluntarily)
+Regrettable Terms =
+VAR _MinDate = MIN(DimDate[Date])
+VAR _MaxDate = MAX(DimDate[Date])
+RETURN
+    CALCULATE(
+        COUNTROWS(DimEmployee),
+        DimEmployee[TermDate] >= _MinDate,
+        DimEmployee[TermDate] <= _MaxDate,
+        DimEmployee[TermType] = "Voluntary",
+        DimEmployee[LastPerformanceRating] >= 4
+    )
+
+// Turnover Rate (annualized)
+Turnover Rate =
+VAR _Terms = [Terminations]
+VAR _AvgHC = [Headcount Avg]
+VAR _Months = DISTINCTCOUNT(DimDate[YearMonth])
+VAR _AnnualizationFactor = DIVIDE(12, _Months)
+RETURN
+    DIVIDE(_Terms, _AvgHC) * _AnnualizationFactor
+
+// Voluntary Turnover Rate
+Voluntary Turnover Rate =
+VAR _VolTerms = [Voluntary Terms]
+VAR _AvgHC = [Headcount Avg]
+VAR _Months = DISTINCTCOUNT(DimDate[YearMonth])
+VAR _AnnualizationFactor = DIVIDE(12, _Months)
+RETURN
+    DIVIDE(_VolTerms, _AvgHC) * _AnnualizationFactor
+
+// Regrettable Turnover Rate
+Regrettable Turnover Rate =
+VAR _RegTerms = [Regrettable Terms]
+VAR _AvgHC = [Headcount Avg]
+VAR _Months = DISTINCTCOUNT(DimDate[YearMonth])
+VAR _AnnualizationFactor = DIVIDE(12, _Months)
+RETURN
+    DIVIDE(_RegTerms, _AvgHC) * _AnnualizationFactor
+
+// Retention Rate
+Retention Rate =
+1 - [Turnover Rate]
+
+// 90-Day Turnover (early attrition)
+Early Attrition =
+VAR _MinDate = MIN(DimDate[Date])
+VAR _MaxDate = MAX(DimDate[Date])
+RETURN
+    CALCULATE(
+        COUNTROWS(DimEmployee),
+        DimEmployee[TermDate] >= _MinDate,
+        DimEmployee[TermDate] <= _MaxDate,
+        DimEmployee[TenureYears] * 365 <= 90
+    )
+
+// First Year Turnover
+First Year Turnover Rate =
+VAR _FirstYearTerms =
+    CALCULATE(
+        [Terminations],
+        DimEmployee[TenureYears] < 1
+    )
+VAR _NewHires = [New Hires]
+RETURN
+    DIVIDE(_FirstYearTerms, _NewHires)
+
+
+// ----------------------------------------------------------------------------
+// HIRING MEASURES
+// ----------------------------------------------------------------------------
+
+// New hires in period
+New Hires =
+VAR _MinDate = MIN(DimDate[Date])
+VAR _MaxDate = MAX(DimDate[Date])
+RETURN
+    CALCULATE(
+        COUNTROWS(DimEmployee),
+        DimEmployee[HireDate] >= _MinDate,
+        DimEmployee[HireDate] <= _MaxDate
+    )
+
+// Net headcount change
+Net Change =
+[New Hires] - [Terminations]
+
+// Hiring Rate
+Hiring Rate =
+VAR _Hires = [New Hires]
+VAR _AvgHC = [Headcount Avg]
+VAR _Months = DISTINCTCOUNT(DimDate[YearMonth])
+VAR _AnnualizationFactor = DIVIDE(12, _Months)
+RETURN
+    DIVIDE(_Hires, _AvgHC) * _AnnualizationFactor
+
+// Growth Rate
+Growth Rate =
+DIVIDE([Net Change], [Headcount BOP])
+
+
+// ----------------------------------------------------------------------------
+// TENURE MEASURES
+// ----------------------------------------------------------------------------
+
+// Average tenure (active employees)
+Avg Tenure =
+AVERAGEX(
+    FILTER(DimEmployee, DimEmployee[IsActive] = TRUE()),
+    DimEmployee[TenureYears]
+)
+
+// Median tenure
+Median Tenure =
+MEDIANX(
+    FILTER(DimEmployee, DimEmployee[IsActive] = TRUE()),
+    DimEmployee[TenureYears]
+)
+
+// Tenure by bucket (for visualization)
+Tenure < 1 Year =
+CALCULATE(
+    [Headcount],
+    DimEmployee[TenureBucket] = "< 1 Year"
+)
+
+Tenure 1-2 Years =
+CALCULATE(
+    [Headcount],
+    DimEmployee[TenureBucket] = "1-2 Years"
+)
+
+Tenure 2-5 Years =
+CALCULATE(
+    [Headcount],
+    DimEmployee[TenureBucket] = "2-5 Years"
+)
+
+Tenure 5-10 Years =
+CALCULATE(
+    [Headcount],
+    DimEmployee[TenureBucket] = "5-10 Years"
+)
+
+Tenure 10+ Years =
+CALCULATE(
+    [Headcount],
+    DimEmployee[TenureBucket] = ">= 10 Years"
+)
+
+
+// ----------------------------------------------------------------------------
+// DIVERSITY MEASURES
+// ----------------------------------------------------------------------------
+
+// Gender breakdown
+Female Count =
+CALCULATE([Headcount], DimEmployee[Gender] = "Female")
+
+Male Count =
+CALCULATE([Headcount], DimEmployee[Gender] = "Male")
+
+Non Binary Count =
+CALCULATE([Headcount], DimEmployee[Gender] = "Non-Binary")
+
+// Gender percentages
+Female % =
+DIVIDE([Female Count], [Headcount])
+
+Male % =
+DIVIDE([Male Count], [Headcount])
+
+// Female in management
+Female Managers % =
+DIVIDE(
+    CALCULATE([Headcount], DimEmployee[Gender] = "Female", DimJob[IsManagement] = TRUE()),
+    CALCULATE([Headcount], DimJob[IsManagement] = TRUE())
+)
+
+// Female in leadership (Director+)
+Female Leaders % =
+DIVIDE(
+    CALCULATE([Headcount], DimEmployee[Gender] = "Female", DimJob[JobLevel] >= 8),
+    CALCULATE([Headcount], DimJob[JobLevel] >= 8)
+)
+
+// Diversity Index (Blau Index: 1 - sum of squared proportions)
+Diversity Index =
+VAR _Total = [Headcount]
+VAR _ByEthnicity =
+    ADDCOLUMNS(
+        VALUES(DimEmployee[Ethnicity]),
+        "@Count", [Headcount]
+    )
+VAR _SumSquares =
+    SUMX(_ByEthnicity, POWER(DIVIDE([@Count], _Total), 2))
+RETURN
+    IF(_Total > 0, 1 - _SumSquares)
+
+
+// ----------------------------------------------------------------------------
+// COMPENSATION MEASURES
+// ----------------------------------------------------------------------------
+
+// Average salary
+Avg Salary =
+AVERAGE(FactEmployeeSnap[Salary])
+
+// Median salary
+Median Salary =
+MEDIAN(FactEmployeeSnap[Salary])
+
+// Salary per headcount (for budget tracking)
+Total Salary Expense =
+SUM(FactEmployeeSnap[Salary])
+
+// Compa-ratio average
+Avg Compa Ratio =
+AVERAGE(FactEmployeeSnap[CompaRatio])
+
+// Pay equity ratio (female / male median salary)
+Pay Equity Ratio =
+VAR _FemaleSalary =
+    CALCULATE(MEDIAN(FactEmployeeSnap[Salary]), DimEmployee[Gender] = "Female")
+VAR _MaleSalary =
+    CALCULATE(MEDIAN(FactEmployeeSnap[Salary]), DimEmployee[Gender] = "Male")
+RETURN
+    DIVIDE(_FemaleSalary, _MaleSalary)
+
+
+// ----------------------------------------------------------------------------
+// ENGAGEMENT & PERFORMANCE
+// ----------------------------------------------------------------------------
+
+// Average engagement score
+Avg Engagement =
+AVERAGE(FactEmployeeSnap[EngagementScore])
+
+// Average performance rating
+Avg Performance =
+AVERAGE(FactEmployeeSnap[PerformanceRating])
+
+// High performers (rating 4-5)
+High Performers =
+CALCULATE(
+    [Headcount],
+    FactEmployeeSnap[PerformanceRating] >= 4
+)
+
+High Performers % =
+DIVIDE([High Performers], [Headcount])
+
+// Low performers
+Low Performers =
+CALCULATE(
+    [Headcount],
+    FactEmployeeSnap[PerformanceRating] <= 2
+)
+
+// Flight risk (high performers with low engagement + long tenure)
+Flight Risk =
+CALCULATE(
+    [Headcount],
+    FactEmployeeSnap[PerformanceRating] >= 4,
+    FactEmployeeSnap[EngagementScore] < 3.5,
+    DimEmployee[TenureYears] >= 3
+)
+
+
+// ----------------------------------------------------------------------------
+// TIME COMPARISONS
+// ----------------------------------------------------------------------------
+
+// Prior year headcount
+Headcount PY =
+CALCULATE(
+    [Headcount EOP],
+    SAMEPERIODLASTYEAR(DimDate[Date])
+)
+
+// YoY headcount change
+Headcount YoY Change =
+[Headcount EOP] - [Headcount PY]
+
+Headcount YoY % =
+DIVIDE([Headcount YoY Change], [Headcount PY])
+
+// Prior year turnover
+Turnover Rate PY =
+CALCULATE(
+    [Turnover Rate],
+    SAMEPERIODLASTYEAR(DimDate[Date])
+)
+
+
+// ----------------------------------------------------------------------------
+// DISPLAY / FORMATTING
+// ----------------------------------------------------------------------------
+
+Headcount Display =
+FORMAT([Headcount], "#,##0")
+
+Turnover Display =
+FORMAT([Turnover Rate], "0.0%")
+
+Tenure Display =
+FORMAT([Avg Tenure], "0.0") & " years"
+
+Salary Display =
+FORMAT([Avg Salary], "$#,##0")
+
+// Trend indicator
+Turnover Trend =
+VAR _Current = [Turnover Rate]
+VAR _PY = [Turnover Rate PY]
+RETURN
+    SWITCH(
+        TRUE(),
+        ISBLANK(_PY), "•",
+        _Current < _PY * 0.95, "▼ Improving",
+        _Current > _PY * 1.05, "▲ Worsening",
+        "• Stable"
+    )
+
+
+// ============================================================================
+// MEASURE ORGANIZATION (Display Folders)
+// ============================================================================
+//
+// 👥 Headcount
+//    - Headcount, Headcount EOP, Headcount Avg, FTE
+//
+// 🚪 Turnover
+//    - Terminations, Voluntary Terms, Involuntary Terms
+//    - Turnover Rate, Voluntary Turnover Rate, Retention Rate
+//
+// 🆕 Hiring
+//    - New Hires, Net Change, Hiring Rate, Growth Rate
+//
+// ⏱️ Tenure
+//    - Avg Tenure, Median Tenure, Tenure buckets
+//
+// 🌍 Diversity
+//    - Female %, Female Managers %, Diversity Index
+//
+// 💰 Compensation
+//    - Avg Salary, Median Salary, Compa Ratio, Pay Equity
+//
+// ⭐ Performance
+//    - Avg Engagement, High Performers %, Flight Risk
+//
+// 📅 Time Comparison
+//    - Headcount PY, Headcount YoY %, Turnover Rate PY
+//
+// 🎨 Display
+//    - Headcount Display, Turnover Display, Tenure Display
+// ============================================================================

package/library/examples/marketing-analytics/README.md

@@ -0,0 +1,37 @@
+# Marketing Analytics Example
+
+Reference implementation for a marketing analytics Power BI model.
+
+## Business Context
+
+Analyze campaign performance, channel effectiveness, lead generation, and marketing ROI across digital and traditional channels.
+
+## Key Metrics
+
+| Metric | Description |
+|--------|-------------|
+| Cost Per Lead (CPL) | Total spend / leads generated |
+| Cost Per Acquisition (CPA) | Total spend / customers acquired |
+| Return on Ad Spend (ROAS) | Revenue attributed / ad spend |
+| Conversion Rate | Conversions / total interactions |
+| Click-Through Rate (CTR) | Clicks / impressions |
+| Customer Acquisition Cost (CAC) | Total marketing cost / new customers |
+| Marketing Qualified Leads (MQL) | Leads meeting qualification criteria |
+
+## Data Model
+
+See [data-model.md](data-model.md) for the complete star schema design.
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `data-model.md` | Star schema with tables and relationships |
+| `measures.dax` | Core DAX measures for marketing KPIs |
+
+## Report Pages
+
+1. **Campaign Overview** — Spend, leads, conversions by campaign
+2. **Channel Performance** — ROI comparison across channels
+3. **Funnel Analysis** — Lead → MQL → SQL → Opportunity → Customer
+4. **Attribution** — Multi-touch attribution analysis

package/library/examples/marketing-analytics/data-model.md

@@ -0,0 +1,62 @@
+# Marketing Analytics Data Model
+
+## Star Schema
+
+```
+                    ┌──────────────┐
+                    │   DimDate    │
+                    │──────────────│
+                    │ DateKey (PK) │
+                    │ Date         │
+                    │ Month        │
+                    │ Quarter      │
+                    │ Year         │
+                    │ WeekOfYear   │
+                    └──────┬───────┘
+                           │
+┌──────────────┐   ┌───────┴────────┐   ┌──────────────┐
+│ DimCampaign  │   │ FactCampaign   │   │ DimChannel   │
+│──────────────│   │ Performance    │   │──────────────│
+│ CampaignKey  │◄──│ CampaignKey   │──►│ ChannelKey   │
+│ CampaignName │   │ ChannelKey    │   │ ChannelName  │
+│ CampaignType │   │ DateKey       │   │ ChannelType  │
+│ StartDate    │   │ Impressions   │   │ IsDigital    │
+│ EndDate      │   │ Clicks        │   └──────────────┘
+│ Budget       │   │ Spend         │
+│ Objective    │   │ Leads         │
+└──────────────┘   │ Conversions   │
+                   │ Revenue       │
+                   └───────────────┘
+
+┌──────────────┐   ┌───────────────┐   ┌──────────────┐
+│ DimLeadSource│   │  FactLeads    │   │ DimLeadStage │
+│──────────────│   │───────────────│   │──────────────│
+│ SourceKey    │◄──│ SourceKey     │──►│ StageKey     │
+│ SourceName   │   │ StageKey      │   │ StageName    │
+│ SourceType   │   │ CampaignKey   │   │ StageOrder   │
+│ Medium       │   │ DateKey       │   │ IsQualified  │
+└──────────────┘   │ LeadKey       │   └──────────────┘
+                   │ IsConverted   │
+                   │ DaysInStage   │
+                   │ LeadScore     │
+                   └───────────────┘
+```
+
+## Relationships
+
+| From | To | Cardinality | Direction |
+|------|----|-------------|-----------|
+| FactCampaignPerformance[DateKey] | DimDate[DateKey] | Many-to-One | Single |
+| FactCampaignPerformance[CampaignKey] | DimCampaign[CampaignKey] | Many-to-One | Single |
+| FactCampaignPerformance[ChannelKey] | DimChannel[ChannelKey] | Many-to-One | Single |
+| FactLeads[DateKey] | DimDate[DateKey] | Many-to-One | Single |
+| FactLeads[SourceKey] | DimLeadSource[SourceKey] | Many-to-One | Single |
+| FactLeads[StageKey] | DimLeadStage[StageKey] | Many-to-One | Single |
+| FactLeads[CampaignKey] | DimCampaign[CampaignKey] | Many-to-One | Single |
+
+## Notes
+
+- `FactCampaignPerformance` is a daily snapshot of campaign metrics per channel
+- `FactLeads` tracks individual leads through the funnel (one row per lead per stage transition)
+- `DimLeadStage` defines the marketing/sales funnel stages
+- Connect to CRM data via `LeadKey` for full customer journey analysis

package/library/examples/marketing-analytics/measures.dax

@@ -0,0 +1,110 @@
+// Marketing Analytics KPI Measures
+// ================================
+// Core measures for marketing analytics model.
+
+// --- Spend & Volume Metrics ---
+
+// Total marketing spend across all campaigns
+TotalSpend =
+SUM(FactCampaignPerformance[Spend])
+
+// Total impressions served
+TotalImpressions =
+SUM(FactCampaignPerformance[Impressions])
+
+// Total clicks received
+TotalClicks =
+SUM(FactCampaignPerformance[Clicks])
+
+// Total leads generated from campaigns
+TotalLeads =
+SUM(FactCampaignPerformance[Leads])
+
+// Total conversions (leads that became customers)
+TotalConversions =
+SUM(FactCampaignPerformance[Conversions])
+
+// Revenue attributed to marketing campaigns
+TotalRevenue =
+SUM(FactCampaignPerformance[Revenue])
+
+// --- Efficiency Metrics ---
+
+// Click-through rate: clicks as percentage of impressions
+CTR =
+DIVIDE([TotalClicks], [TotalImpressions])
+
+// Conversion rate: conversions as percentage of clicks
+ConversionRate =
+DIVIDE([TotalConversions], [TotalClicks])
+
+// Cost per click
+CPC =
+DIVIDE([TotalSpend], [TotalClicks])
+
+// Cost per lead
+CPL =
+DIVIDE([TotalSpend], [TotalLeads])
+
+// Cost per acquisition (customer)
+CPA =
+DIVIDE([TotalSpend], [TotalConversions])
+
+// --- ROI Metrics ---
+
+// Return on ad spend: revenue generated per dollar spent
+ROAS =
+DIVIDE([TotalRevenue], [TotalSpend])
+
+// Marketing ROI: net profit from marketing as percentage of spend
+MarketingROI =
+DIVIDE([TotalRevenue] - [TotalSpend], [TotalSpend])
+
+// --- Funnel Metrics ---
+
+// Count of Marketing Qualified Leads
+MQLCount =
+CALCULATE(
+    DISTINCTCOUNT(FactLeads[LeadKey]),
+    RELATEDTABLE(DimLeadStage),
+    DimLeadStage[IsQualified] = TRUE()
+)
+
+// Lead-to-MQL conversion rate
+LeadToMQLRate =
+VAR _TotalLeads = DISTINCTCOUNT(FactLeads[LeadKey])
+RETURN DIVIDE([MQLCount], _TotalLeads)
+
+// Average days in current funnel stage
+AvgDaysInStage =
+AVERAGE(FactLeads[DaysInStage])
+
+// Average lead score
+AvgLeadScore =
+AVERAGE(FactLeads[LeadScore])
+
+// --- Budget Metrics ---
+
+// Budget utilization: actual spend vs allocated budget
+BudgetUtilization =
+VAR _ActualSpend = [TotalSpend]
+VAR _Budget = SUM(DimCampaign[Budget])
+RETURN DIVIDE(_ActualSpend, _Budget)
+
+// Budget remaining
+BudgetRemaining =
+SUM(DimCampaign[Budget]) - [TotalSpend]
+
+// --- Time Comparisons ---
+
+// Spend vs prior period (for any time selection)
+SpendVsPrior =
+VAR _Current = [TotalSpend]
+VAR _Prior = CALCULATE([TotalSpend], DATEADD('Date'[Date], -1, MONTH))
+RETURN _Current - _Prior
+
+// Spend growth rate
+SpendGrowthRate =
+VAR _Current = [TotalSpend]
+VAR _Prior = CALCULATE([TotalSpend], DATEADD('Date'[Date], -1, MONTH))
+RETURN DIVIDE(_Current - _Prior, _Prior)