JIRA Pulse Dashboard

Track and analyze team performance metrics from JIRA

## Recent Updates ### Version 1.3.2 - **Kanban AI Prompt Enhancement:** The AI analysis prompt for Kanban boards now includes more detailed data: - CFD: Actual snapshot data (status counts for the end of the period). - Lead Time Distribution: The array of individual lead times (in days). - Throughput: Total throughput for the period, average weekly throughput, and a weekly breakdown of issues completed. - **AI Analysis Caching:** Implemented caching for the processed `stats` object used by the AI analysis. This significantly speeds up launching the AI analysis if the dashboard data is already loaded and up-to-date, avoiding redundant data fetching and processing. - **Code Cleanup:** Removed various `console.log` statements used during debugging. - **General Stability:** Fixed case-sensitivity issue in board type checking for AI service, ensuring Kanban metrics are correctly processed. ## Features - 📊 Real-time team performance metrics - 📈 Interactive charts and visualizations - **Scrum Boards:** - Sprint velocity tracking - Story Points by Resolver - Bug Count per Story Point by Resolver - Story Bug Ratio by Resolver - **Kanban Boards:** - Cumulative Flow Diagram (CFD) - Lead Time Distribution - Weekly Throughput - AI Analysis now includes detailed CFD snapshot, Lead Time Distribution data, and Weekly Throughput breakdown. - **Universal:** - Issues by type and status - Issue Count by Resolver - Average Resolution Time Trend (requires Swimlane ID) - Control chart for issue resolution times (underlying data for Resolution Time Trend & Lead Time) - Sprint health indicators (Scrum only) - 🤖 AI-powered team analysis (Powered by DeepSeek API) - Deep insights into team performance - Individual performance analysis - Actionable recommendations - Role-specific analysis (Developer, Tester, Automation) - Smart first-time user guide - Cached analysis results - Support for multiple AI models (DeepSeek Chat/Reasoner) - ⚙️ Advanced configuration options - Project filters and time ranges - User role mapping - User exclusion capabilities - Custom JQL queries - Board selection (Rapid View ID & Board Type - Scrum/Kanban) - Swimlane ID settings (for Resolution Time & Lead Time charts) - Smart field mapping with auto-detection - Field validation and compatibility checks - 🔄 Smart data management - Manual data refresh - Automatic caching system - Cache expiration handling - Background data updates - 🎨 Modern, responsive UI - Dark/Light theme support - Multiple view modes (Grid/List/Comparison) for Sprint Health (Scrum only) - Card appearance animations - View switching transitions - Interactive hover effects - Staggered loading animations - Smart tooltips with adaptive positioning - Fully unified light/dark theme switching for all pages, modals, dropdowns, tooltips, toasts, forms, and controls - Theme toggle button with smooth animation and instant feedback - All UI elements use global theme variables (no hardcoded colors) - Stable, unique profile identicon for each profile (does not change on refresh) - Active profile in the selection modal is clearly marked with a check_circle icon and accessible label - Modern card, modal, progress bar, and animation design - Accessible: active profile indicator uses aria-label - Profile import/export for easy sharing and backup - Multiple profiles with quick switching and visual indicator - All styles and themes are variable-driven for easy customization and extension - 👥 Team collaboration features - User filtering and exclusion - Team member progress tracking (Sprint Health - Scrum only) - Sprint health monitoring (Scrum only) - Configuration sharing - Profile import/export for easy sharing and backup - Multiple profiles with quick switching and visual indicator - 🔍 Detailed analysis capabilities - Issue type distribution - Status tracking - Story point analysis (Scrum) - Velocity metrics (Scrum) - Team member contributions - Sprint completion rates (Scrum) - ✅ System features - JIRA connection validation - Error handling and recovery - User feedback system - Configuration backup/restore - Localized interface (English/Chinese) ## Installation 1. Clone this repository: ```bash git clone https://github.com/oiahoon/JIRA-Pulse-Dashboard.git ``` 2. Open Chrome and navigate to `chrome://extensions/` 3. Enable "Developer mode" in the top right 4. Click "Load unpacked" and select the extension directory ## Configuration 1. Click the extension icon in your Chrome toolbar 2. If it's your first time, you'll be redirected to the configuration page 3. Enter your JIRA configuration: - JIRA Base URL - Project keys (This is handled by the JQL filter now, consider removing or rephrasing) - Filter JQL - Excluded users (Handled by role assignments now, consider rephrasing or noting it works via role settings if a user has no role assigned or is of a non-tracked role) - Default time range - Board Selection: - Select your JIRA board (Scrum or Kanban) from a list. - The extension will attempt to auto-detect the board type. - Swimlane ID (for issue resolution time and Lead Time Distribution calculation) - Go to your JIRA board - Open browser developer tools (F12) - Go to Network tab - Refresh the board page - Look for a request to "/rest/greenhopper/1.0/rapid/charts/controlchart.json" - The swimlane ID is in the request parameters (swimlaneId) 4. Configure Field Mappings: - Story Points field for velocity calculations - Resolver field for issue resolution tracking - Bug Type field for bug categorization - Epic Link field for epic grouping - Use Auto Detect for smart field detection - Field validation ensures correct field types 5. Configure AI Analysis (Optional): - Enter your DeepSeek API token - Choose between DeepSeek Chat (default) or DeepSeek Reasoner model - Note: Reasoner model provides more detailed analysis but takes longer to respond 6. Configure User Roles (Optional): - Map team members to specific roles (Developer, Tester, Automation) - Role-specific analysis will be provided based on these mappings 7. Test your JIRA connection to ensure proper setup 8. (Optional) Export your configuration to share with team members or backup ### Field Configuration The extension requires specific JIRA fields for optimal performance: 1. **Story Points Field** - Used for velocity calculations - Should be a number field - Auto-detection supports common names like "Story Points", "Points", "SP" 2. **Resolver Field** - Tracks who resolved the issue - Should be a user field - Auto-detection supports names like "Resolved By", "Fixer", "Completed By" 3. **Bug Type Field** - Distinguishes between production and story bugs - Should be a select field - Auto-detection supports names like "Bug Type", "Bug Category" 4. **Epic Link Field** - Groups issues by epic - Should be an epic link field - Auto-detection supports names like "Epic Link", "Parent", "Feature" ### Configuration Sharing The extension supports configuration sharing through export and import: 1. **Export Configuration** - Click the export button (📥) in the settings page - A JSON file will be downloaded with your current settings - Share this file with your team members 2. **Import Configuration** - Click the import button (📤) in the settings page - Select a previously exported configuration file - The settings will be automatically applied - Smart tooltips will guide you through the process ## Usage Once configured, the extension provides three main views: ### Dashboard View - Displays key metrics and performance indicators - Shows interactive charts for team performance - Allows switching between different time ranges - Automatically refreshes data periodically - Smart tooltips provide additional context and guidance - AI Analysis button with first-time user guide - Cached analysis results for better performance ### Sprint Health View - Provides detailed sprint health metrics - Shows sprint completion status - Displays team velocity trends - Highlights potential issues and blockers - Interactive tooltips for detailed information - Multiple view modes: - Grid view: Overview of team member progress - List view: Detailed task breakdown - Comparison view: Team member performance comparison - Progress tracking for: - Total issues and story points - In-progress items - Completed items - Sprint timeline visualization - Remaining days indicator with color coding ### Detailed Statistics View - Offers comprehensive issue analysis - Shows user-specific metrics and contributions - Provides timeline trends for various metrics - Includes detailed breakdowns by issue type and status - Contextual tooltips for better data understanding - Role-specific performance analysis - Quality and efficiency metrics - Monthly trends and patterns - Actionable recommendations - Risk assessment and mitigation - **Kanban specific charts:** CFD, Lead Time Distribution, Weekly Throughput. - **Kanban AI Analysis:** Prompts now include detailed CFD snapshot, Lead Time Distribution array, total throughput, average weekly throughput, and weekly throughput breakdown for richer insights.