workspace-architect 1.3.0

package/assets/instructions/power-bi-report-design-best-practices.instructions.md

@@ -0,0 +1,752 @@
+---
+description: 'Comprehensive Power BI report design and visualization best practices based on Microsoft guidance for creating effective, accessible, and performant reports and dashboards.'
+applyTo: '**/*.{pbix,md,json,txt}'
+---
+
+# Power BI Report Design and Visualization Best Practices
+
+## Overview
+This document provides comprehensive instructions for designing effective, accessible, and performant Power BI reports and dashboards following Microsoft's official guidance and user experience best practices.
+
+## Fundamental Design Principles
+
+### 1. Information Architecture
+**Visual Hierarchy** - Organize information by importance:
+- **Primary**: Key metrics, KPIs, most critical insights (top-left, header area)
+- **Secondary**: Supporting details, trends, comparisons (main body)
+- **Tertiary**: Filters, controls, navigation elements (sidebars, footers)
+
+**Content Structure**:
+```
+Report Page Layout:
+┌─────────────────────────────────────┐
+│ Header: Title, KPIs, Key Metrics    │
+├─────────────────────────────────────┤
+│ Main Content Area                   │
+│ ┌─────────────┐ ┌─────────────────┐ │
+│ │  Primary    │ │  Supporting     │ │
+│ │  Visual     │ │  Visuals        │ │
+│ └─────────────┘ └─────────────────┘ │
+├─────────────────────────────────────┤
+│ Footer: Filters, Navigation, Notes  │
+└─────────────────────────────────────┘
+```
+
+### 2. User Experience Principles
+**Clarity**: Every element should have a clear purpose and meaning
+**Consistency**: Use consistent styling, colors, and interactions across all reports
+**Context**: Provide sufficient context for users to interpret data correctly
+**Action**: Guide users toward actionable insights and decisions
+
+## Chart Type Selection Guidelines
+
+### 1. Comparison Visualizations
+```
+Bar/Column Charts:
+✅ Comparing categories or entities
+✅ Ranking items by value
+✅ Showing changes over discrete time periods
+✅ When category names are long (use horizontal bars)
+
+Best Practices:
+- Start axis at zero for accurate comparison
+- Sort categories by value for ranking
+- Use consistent colors within category groups
+- Limit to 7-10 categories for readability
+
+Example Use Cases:
+- Sales by product category
+- Revenue by region  
+- Employee count by department
+- Customer satisfaction by service type
+```
+
+```
+Line Charts:
+✅ Showing trends over continuous time periods
+✅ Comparing multiple metrics over time
+✅ Identifying patterns, seasonality, cycles
+✅ Forecasting and projection scenarios
+
+Best Practices:
+- Use consistent time intervals
+- Start Y-axis at zero when showing absolute values
+- Use different line styles for multiple series
+- Include data point markers for sparse data
+
+Example Use Cases:
+- Monthly sales trends
+- Website traffic over time
+- Stock price movements
+- Performance metrics tracking
+```
+
+### 2. Composition Visualizations
+```
+Pie/Donut Charts:
+✅ Parts-of-whole relationships
+✅ Maximum 5-7 categories
+✅ When percentages are more important than absolute values
+✅ Simple composition scenarios
+
+Limitations:
+❌ Difficult to compare similar-sized segments
+❌ Not suitable for many categories
+❌ Hard to show changes over time
+
+Alternative: Use stacked bar charts for better readability
+
+Example Use Cases:
+- Market share by competitor
+- Budget allocation by category
+- Customer segments by type
+```
+
+```
+Stacked Charts:
+✅ Showing composition and total simultaneously
+✅ Comparing composition across categories
+✅ Multiple sub-categories within main categories
+✅ When you need both part and whole perspective
+
+Types:
+- 100% Stacked: Focus on proportions
+- Regular Stacked: Show both absolute and relative values
+- Clustered: Compare sub-categories side-by-side
+
+Example Use Cases:
+- Sales by product category and region
+- Revenue breakdown by service type over time
+- Employee distribution by department and level
+```
+
+### 3. Relationship and Distribution Visualizations
+```
+Scatter Plots:
+✅ Correlation between two continuous variables
+✅ Outlier identification
+✅ Clustering analysis
+✅ Performance quadrant analysis
+
+Best Practices:
+- Use size for third dimension (bubble chart)
+- Apply color coding for categories
+- Include trend lines when appropriate
+- Label outliers and key points
+
+Example Use Cases:
+- Sales vs. marketing spend by product
+- Customer satisfaction vs. loyalty scores
+- Risk vs. return analysis
+- Performance vs. cost efficiency
+```
+
+```
+Heat Maps:
+✅ Showing patterns across two categorical dimensions
+✅ Performance matrices
+✅ Time-based pattern analysis
+✅ Dense data visualization
+
+Configuration:
+- Use color scales that are colorblind-friendly
+- Include data labels when space permits
+- Provide clear legend with value ranges
+- Consider using conditional formatting
+
+Example Use Cases:
+- Sales performance by month and product
+- Website traffic by hour and day of week
+- Employee performance ratings by department and quarter
+```
+
+## Report Layout and Navigation Design
+
+### 1. Page Layout Strategies
+```
+Single Page Dashboard:
+✅ Executive summaries
+✅ Real-time monitoring
+✅ Simple KPI tracking
+✅ Mobile-first scenarios
+
+Design Guidelines:
+- Maximum 6-8 visuals per page
+- Clear visual hierarchy
+- Logical grouping of related content
+- Responsive design considerations
+```
+
+```
+Multi-Page Report:
+✅ Complex analytical scenarios
+✅ Different user personas
+✅ Detailed drill-down analysis
+✅ Comprehensive business reporting
+
+Page Organization:
+Page 1: Executive Summary (high-level KPIs)
+Page 2: Detailed Analysis (trends, comparisons)
+Page 3: Operational Details (transaction-level data)
+Page 4: Appendix (methodology, definitions)
+```
+
+### 2. Navigation Patterns
+```
+Tab Navigation:
+✅ Related content areas
+✅ Different views of same data
+✅ User role-based sections
+✅ Temporal analysis (daily, weekly, monthly)
+
+Implementation:
+- Use descriptive tab names
+- Maintain consistent layout across tabs
+- Highlight active tab clearly
+- Consider tab ordering by importance
+```
+
+```
+Bookmark Navigation:
+✅ Predefined scenarios
+✅ Filtered views
+✅ Story-telling sequences
+✅ Guided analysis paths
+
+Best Practices:
+- Create bookmarks for common filter combinations
+- Use descriptive bookmark names
+- Group related bookmarks
+- Test bookmark functionality thoroughly
+```
+
+```
+Button Navigation:
+✅ Custom navigation flows
+✅ Action-oriented interactions
+✅ Drill-down scenarios
+✅ External link integration
+
+Button Design:
+- Use consistent styling
+- Clear, action-oriented labels
+- Appropriate sizing for touch interfaces
+- Visual feedback for interactions
+```
+
+## Interactive Features Implementation
+
+### 1. Tooltip Design Strategy
+```
+Default Tooltips:
+✅ Additional context information
+✅ Formatted numeric values
+✅ Related metrics not shown in visual
+✅ Explanatory text for complex measures
+
+Configuration:
+- Include relevant dimensions
+- Format numbers appropriately
+- Keep text concise and readable
+- Use consistent formatting
+
+Example:
+Visual: Sales by Product Category
+Tooltip: 
+- Product Category: Electronics
+- Total Sales: $2.3M (↑15% vs last year)
+- Order Count: 1,247 orders
+- Avg Order Value: $1,845
+```
+
+```
+Report Page Tooltips:
+✅ Complex additional information
+✅ Mini-dashboard for context
+✅ Detailed breakdowns
+✅ Visual explanations
+
+Design Requirements:
+- Optimal size: 320x240 pixels
+- Match main report styling
+- Fast loading performance
+- Meaningful additional insights
+
+Implementation:
+1. Create dedicated tooltip page
+2. Set page type to "Tooltip"
+3. Configure appropriate filters
+4. Enable tooltip on target visuals
+5. Test with realistic data
+```
+
+### 2. Drillthrough Implementation
+```
+Drillthrough Scenarios:
+
+Summary to Detail:
+Source: Monthly Sales Summary
+Target: Transaction-level details for selected month
+Filter: Month, Product Category, Region
+
+Context Enhancement:
+Source: Product Performance Metric
+Target: Comprehensive product analysis
+Content: Sales trends, customer feedback, inventory levels
+
+Design Guidelines:
+✅ Clear visual indication of drillthrough availability
+✅ Consistent styling between source and target pages
+✅ Automatic back button (provided by Power BI)
+✅ Contextual filters properly applied
+✅ Hidden drillthrough pages from main navigation
+
+Implementation Steps:
+1. Create target drillthrough page
+2. Add drillthrough filters in Fields pane
+3. Design page with filtered context in mind
+4. Test drillthrough functionality
+5. Configure source visuals for drillthrough
+```
+
+### 3. Cross-Filtering Strategy
+```
+When to Enable Cross-Filtering:
+✅ Related visuals showing different perspectives
+✅ Clear logical connections between visuals
+✅ Enhanced analytical understanding
+✅ Reasonable performance impact
+
+When to Disable Cross-Filtering:
+❌ Independent analysis requirements
+❌ Performance concerns with large datasets
+❌ Confusing or misleading interactions
+❌ Too many visuals causing cluttered highlighting
+
+Configuration Best Practices:
+- Edit interactions thoughtfully for each visual pair
+- Test with realistic data volumes and user scenarios
+- Provide clear visual feedback for selections
+- Consider mobile touch interaction experience
+- Document interaction design decisions
+```
+
+## Visual Design and Formatting
+
+### 1. Color Strategy
+```
+Color Usage Hierarchy:
+
+Semantic Colors (Consistent Meaning):
+- Green: Positive performance, growth, success, on-target
+- Red: Negative performance, decline, alerts, over-budget
+- Blue: Neutral information, base metrics, corporate branding
+- Orange: Warnings, attention needed, moderate concern
+- Gray: Inactive, disabled, or reference information
+
+Brand Integration:
+✅ Use corporate color palette consistently
+✅ Maintain accessibility standards (4.5:1 contrast ratio minimum)
+✅ Consider colorblind accessibility (8% of males affected)
+✅ Test colors in different contexts (projectors, mobile, print)
+
+Color Application:
+Primary Color: Main brand color for key metrics and highlights
+Secondary Colors: Supporting brand colors for categories
+Accent Colors: High-contrast colors for alerts and callouts
+Neutral Colors: Backgrounds, text, borders, inactive states
+```
+
+```
+Accessibility-First Color Design:
+
+Colorblind Considerations:
+✅ Don't rely solely on color to convey information
+✅ Use patterns, shapes, or text labels as alternatives
+✅ Test with colorblind simulation tools
+✅ Use high contrast color combinations
+✅ Provide alternative visual cues (icons, patterns)
+
+Implementation:
+- Red-Green combinations: Add blue or use different saturations
+- Use tools like Colour Oracle for testing
+- Include data labels where color is the primary differentiator
+- Consider grayscale versions of reports for printing
+```
+
+### 2. Typography and Readability
+```
+Font Hierarchy:
+
+Report Titles: 18-24pt, Bold, Corporate font or clear sans-serif
+Page Titles: 16-20pt, Semi-bold, Consistent with report title
+Section Headers: 14-16pt, Semi-bold, Used for content grouping
+Visual Titles: 12-14pt, Semi-bold, Descriptive and concise
+Body Text: 10-12pt, Regular, Used in text boxes and descriptions
+Data Labels: 9-11pt, Regular, Clear and not overlapping
+Captions/Legends: 8-10pt, Regular, Supplementary information
+
+Readability Guidelines:
+✅ Minimum 10pt font size for data visualization
+✅ High contrast between text and background
+✅ Consistent font family throughout report (max 2 families)
+✅ Adequate white space around text elements
+✅ Left-align text for readability (except centered titles)
+```
+
+```
+Content Writing Best Practices:
+
+Titles and Labels:
+✅ Clear, descriptive, and action-oriented
+✅ Avoid jargon and technical abbreviations
+✅ Use consistent terminology throughout
+✅ Include time periods and context when relevant
+
+Examples:
+Good: "Monthly Sales Revenue by Product Category"
+Poor: "Sales Data"
+
+Good: "Customer Satisfaction Score (1-10 scale)"
+Poor: "CSAT"
+
+Data Storytelling:
+✅ Use subtitles to provide context
+✅ Include methodology notes where necessary
+✅ Explain unusual data points or outliers
+✅ Provide actionable insights in text boxes
+```
+
+### 3. Layout and Spacing
+```
+Visual Spacing:
+Grid System: Use consistent spacing multiples (8px, 16px, 24px)
+Padding: Adequate white space around content areas
+Margins: Consistent margins between visual elements
+Alignment: Use alignment guides for professional appearance
+
+Visual Grouping:
+Related Content: Group related visuals with consistent spacing
+Separation: Use white space to separate unrelated content areas
+Visual Hierarchy: Use size, color, and spacing to indicate importance
+Balance: Distribute visual weight evenly across the page
+```
+
+## Performance Optimization for Reports
+
+### 1. Visual Performance Guidelines
+```
+Visual Count Management:
+✅ Maximum 6-8 visuals per page for optimal performance
+✅ Use tabbed navigation for complex scenarios
+✅ Implement drill-through instead of cramming details
+✅ Consider multiple focused pages vs. one cluttered page
+
+Query Optimization:
+✅ Apply filters early in design process
+✅ Use page-level filters for common filtering scenarios
+✅ Avoid high-cardinality fields in slicers when possible
+✅ Pre-filter large datasets to relevant subsets
+
+Performance Testing:
+✅ Test with realistic data volumes
+✅ Monitor Performance Analyzer results
+✅ Test concurrent user scenarios
+✅ Validate mobile performance
+✅ Check different network conditions
+```
+
+### 2. Loading Performance Optimization
+```
+Initial Page Load:
+✅ Minimize visuals on landing page
+✅ Use summary views with drill-through to details
+✅ Apply default filters to reduce initial data volume
+✅ Consider progressive disclosure of information
+
+Interaction Performance:
+✅ Optimize slicer queries and combinations
+✅ Use efficient cross-filtering patterns
+✅ Minimize complex calculated visuals
+✅ Implement appropriate caching strategies
+
+Visual Selection for Performance:
+Fast Loading: Card, KPI, Gauge (simple aggregations)
+Moderate: Bar, Column, Line charts (standard aggregations)
+Slower: Scatter plots, Maps, Custom visuals (complex calculations)
+Slowest: Matrix, Table with many columns (detailed data)
+```
+
+## Mobile and Responsive Design
+
+### 1. Mobile Layout Strategy
+```
+Mobile-First Design Principles:
+✅ Portrait orientation as primary layout
+✅ Touch-friendly interaction targets (minimum 44px)
+✅ Simplified navigation patterns
+✅ Reduced visual density and information overload
+✅ Key metrics prominently displayed
+
+Mobile Layout Considerations:
+Screen Sizes: Design for smallest target device first
+Touch Interactions: Ensure buttons and slicers are easily tappable
+Scrolling: Vertical scrolling acceptable, horizontal scrolling problematic
+Text Size: Increase font sizes for mobile readability
+Visual Selection: Prefer simple chart types for mobile
+```
+
+### 2. Responsive Design Implementation
+```
+Power BI Mobile Layout:
+1. Switch to Mobile layout view in Power BI Desktop
+2. Rearrange visuals for portrait orientation
+3. Resize and reposition for mobile screens
+4. Test key interactions work with touch
+5. Verify text remains readable at mobile sizes
+
+Adaptive Content:
+✅ Prioritize most important information
+✅ Hide or consolidate less critical visuals
+✅ Use drill-through for detailed analysis
+✅ Simplify filter interfaces
+✅ Ensure data refresh works on mobile connections
+
+Testing Strategy:
+✅ Test on actual mobile devices
+✅ Verify performance on slower networks
+✅ Check battery usage during extended use
+✅ Validate offline capabilities where applicable
+```
+
+## Accessibility and Inclusive Design
+
+### 1. Universal Design Principles
+```
+Visual Accessibility:
+✅ High contrast ratios (minimum 4.5:1)
+✅ Colorblind-friendly color schemes
+✅ Alternative text for images and icons
+✅ Consistent navigation patterns
+✅ Clear visual hierarchy
+
+Interaction Accessibility:
+✅ Keyboard navigation support
+✅ Screen reader compatibility
+✅ Clear focus indicators
+✅ Logical tab order
+✅ Descriptive link text and button labels
+
+Content Accessibility:
+✅ Plain language explanations
+✅ Consistent terminology
+✅ Context for abbreviations and acronyms
+✅ Alternative formats when needed
+```
+
+### 2. Inclusive Design Implementation
+```
+Multi-Sensory Design:
+✅ Don't rely solely on color to convey information
+✅ Use patterns, shapes, and text labels
+✅ Include audio descriptions for complex visuals
+✅ Provide data in multiple formats
+
+Cognitive Accessibility:
+✅ Clear, simple language
+✅ Logical information flow
+✅ Consistent layouts and interactions
+✅ Progressive disclosure of complexity
+✅ Help and guidance text where needed
+
+Testing for Accessibility:
+✅ Use screen readers to test navigation
+✅ Test keyboard-only navigation
+✅ Verify with colorblind simulation tools
+✅ Get feedback from users with disabilities
+✅ Regular accessibility audits
+```
+
+## Advanced Visualization Techniques
+
+### 1. Conditional Formatting
+```
+Dynamic Visual Enhancement:
+
+Data Bars:
+✅ Quick visual comparison within tables
+✅ Consistent scale across all rows
+✅ Appropriate color choices (light to dark)
+✅ Consider mobile visibility
+
+Background Colors:
+✅ Heat map-style formatting
+✅ Status-based coloring (red/yellow/green)
+✅ Performance thresholds
+✅ Trend indicators
+
+Font Formatting:
+✅ Size based on importance or values
+✅ Color based on performance metrics
+✅ Bold for emphasis and highlights
+✅ Italics for secondary information
+
+Implementation Examples:
+Sales Performance Table:
+- Green background: >110% of target
+- Yellow background: 90-110% of target  
+- Red background: <90% of target
+- Data bars: Relative performance within each category
+```
+
+### 2. Custom Visuals Integration
+```
+Custom Visual Selection Criteria:
+
+Evaluation Framework:
+✅ Active community support and regular updates
+✅ Microsoft AppSource certification (preferred)
+✅ Clear documentation and examples
+✅ Performance characteristics acceptable
+✅ Accessibility compliance
+
+Due Diligence:
+✅ Test thoroughly with your data types and volumes
+✅ Verify mobile compatibility
+✅ Check refresh and performance impact
+✅ Review security and data handling
+✅ Plan for maintenance and updates
+
+Governance:
+✅ Approval process for custom visuals
+✅ Standard set of approved custom visuals
+✅ Documentation of approved visuals and use cases
+✅ Monitoring and maintenance procedures
+✅ Fallback strategies if custom visual becomes unavailable
+```
+
+## Report Testing and Quality Assurance
+
+### 1. Functional Testing Checklist
+```
+Visual Functionality:
+□ All charts display data correctly
+□ Filters work as intended
+□ Cross-filtering behaves appropriately  
+□ Drill-through functions correctly
+□ Tooltips show relevant information
+□ Bookmarks restore correct state
+□ Export functions work properly
+
+Interaction Testing:
+□ Button navigation functions correctly
+□ Slicer combinations work as expected
+□ Report pages load within acceptable time
+□ Mobile layout displays properly
+□ Responsive design adapts correctly
+□ Print layouts are readable
+
+Data Accuracy:
+□ Totals match source systems
+□ Calculations produce expected results
+□ Filters don't inadvertently exclude data
+□ Date ranges are correct
+□ Business rules are properly implemented
+□ Edge cases handled appropriately
+```
+
+### 2. User Experience Testing
+```
+Usability Testing:
+✅ Test with actual business users
+✅ Observe user behavior and pain points
+✅ Time common tasks and interactions
+✅ Gather feedback on clarity and usefulness
+✅ Test with different user skill levels
+
+Performance Testing:
+✅ Load testing with realistic data volumes
+✅ Concurrent user testing
+✅ Network condition variations
+✅ Mobile device performance
+✅ Refresh performance during peak usage
+
+Cross-Platform Testing:
+✅ Desktop browsers (Chrome, Firefox, Edge, Safari)
+✅ Mobile devices (iOS, Android)
+✅ Power BI Mobile app
+✅ Different screen resolutions
+✅ Various network speeds
+```
+
+### 3. Quality Assurance Framework
+```
+Review Process:
+1. Developer Testing: Initial functionality verification
+2. Peer Review: Design and technical review by colleagues
+3. Business Review: Content accuracy and usefulness validation
+4. User Acceptance: Testing with end users
+5. Performance Review: Load and response time validation
+6. Accessibility Review: Compliance with accessibility standards
+
+Documentation:
+✅ Report purpose and target audience
+✅ Data sources and refresh schedule
+✅ Business rules and calculation explanations
+✅ User guide and training materials
+✅ Known limitations and workarounds
+✅ Maintenance and update procedures
+
+Continuous Improvement:
+✅ Regular usage analytics review
+✅ User feedback collection and analysis
+✅ Performance monitoring and optimization
+✅ Content relevance and accuracy updates
+✅ Technology and feature adoption
+```
+
+## Common Anti-Patterns to Avoid
+
+### 1. Design Anti-Patterns
+```
+❌ Chart Junk:
+- Unnecessary 3D effects
+- Excessive animation
+- Decorative elements that don't add value
+- Over-complicated visual effects
+
+❌ Information Overload:
+- Too many visuals on single page
+- Cluttered layouts with insufficient white space
+- Multiple competing focal points
+- Overwhelming color usage
+
+❌ Poor Color Choices:
+- Red-green combinations without alternatives
+- Low contrast ratios
+- Inconsistent color meanings
+- Over-use of bright or saturated colors
+```
+
+### 2. Interaction Anti-Patterns
+```
+❌ Navigation Confusion:
+- Inconsistent navigation patterns
+- Hidden or unclear navigation options
+- Broken or unexpected drill-through behavior
+- Circular navigation loops
+
+❌ Performance Problems:
+- Too many visuals causing slow loading
+- Inefficient cross-filtering
+- Unnecessary real-time refresh
+- Large datasets without proper filtering
+
+❌ Mobile Unfriendly:
+- Small touch targets
+- Horizontal scrolling requirements
+- Unreadable text on mobile
+- Non-functional mobile interactions
+```
+
+Remember: Always design with your specific users and use cases in mind. Test early and often with real users and realistic data to ensure your reports effectively communicate insights and enable data-driven decision making.