Repository navigation
Marketing Analytics Explorer - Live Databricks Integration
Complete implementation of Feature 004 with 5 React dashboards fetching live data from Unity Catalog.
π― Features Implemented
Analytics Dashboards (5 total)
- β DataOverview: Summary metrics across all data sources
- β CampaignPerformance: Campaign analytics with role-based filtering
- β ContentEngagement: Event tracking and content analysis
- β AudienceInsights: Segment demographics and comparison
- β AttributionAnalysis: Funnel metrics and attribution models
Data Integration
- β
Unity Catalog integration (
bryan_li.synthetic_datasets,bryan_li.analytics) - β SQL Warehouse queries via Statement Execution API 2.0
- β React Query hooks for caching and state management
- β Role-based access control (CMO vs Analyst)
- β Sync table fallback to Delta Lake
π§ Infrastructure Improvements
CORS & API Configuration
- β Vite proxy configuration for local development
- β dbsqlClient with relative URLs in dev mode
- β Environment validation (warehouse ID, tokens, catalog)
- β Dev mode mock authentication
Schema Corrections
- β
Fixed:
raw_dataβsynthetic_datasets - β
Fixed:
target_segmentsβtarget_segment - β
Fixed:
total_engagementsβevent_count - β
Removed
_syncsuffix assumptions - β Added schema validation with DESCRIBE commands
π Documentation
Project Constitution
- β 14 core principles for Databricks development
- β Mandatory Unity Catalog, serverless compute, Asset Bundles
- β Schema validation and testing practices
- β Version control and release management requirements
- β Lessons learned from implementation
π§ͺ Testing
- β Contract tests for all 5 gold table schemas
- β Real Databricks infrastructure validation
- β Schema mismatch detection and prevention
π¦ Tech Stack
- React 18 + Vite + Material-UI v5
- TanStack React Query
- Recharts + Nivo (visualizations)
- Databricks SQL Warehouse (03560442e95cb440)
- Unity Catalog with medallion architecture
π Deployment
Access dashboards at: http://localhost:5173/dashboards/overview
Environment Variables Required:
VITE_DATABRICKS_HOST=https://e2-demo-field-eng.cloud.databricks.com
VITE_DATABRICKS_TOKEN=<your-pat-token>
VITE_DATABRICKS_WAREHOUSE_ID=03560442e95cb440
VITE_DATABRICKS_CATALOG=bryan_li
π Rollback
To rollback to previous version: git checkout v0.3.0
Full Changelog: v0.3.0...v0.4.0