Skip to main content

Dashboard Reference

Complete reference guide for Mosaic dashboards including Personal and Workspace dashboards

Published: January 15, 2025

Dashboard Reference

Mosaic provides comprehensive dashboard analytics to help you track productivity, monitor team performance, and gain insights into your work. This reference covers both Personal and Workspace dashboards with complete technical details.

Dashboard Types

Mosaic offers two primary dashboard views:

Personal Dashboard

Purpose: Track your individual productivity and tasks across all workspaces

Access: Left sidebar → Dashboard icon (📊)

Route: /Dashboard

Key Features:

  • Personal task metrics and productivity scores
  • Individual performance tracking
  • Today’s focus tasks
  • Personal activity feed
  • Workspace-scoped view option

Workspace Dashboard

Purpose: Monitor team performance and workspace-wide metrics

Access: Left sidebar → Workspace Dashboard (requires workspace selection)

Route: /WorkspaceDashboard

Key Features:

  • Team member engagement tracking
  • Workspace-wide task metrics
  • Spaces and projects performance
  • Assignee performance analysis
  • Bulk task management tools

Personal Dashboard

Overview

The Personal Dashboard provides a comprehensive view of your individual work across all workspaces (or filtered to a specific workspace).

Dashboard Sections

1. Key Metrics Cards

Total Tasks

  • Display: Total task count with pending tasks subtitle
  • Format: Number with pending count
  • Color: Blue
  • Shows: All tasks assigned to you or created by you

Productivity Score

  • Display: Percentage with progress bar
  • Calculation: (Completion rate × 70%) + (Timely completions × 30%)
  • Color: Green (≥80%), Yellow (60-79%), Red (<60%)
  • Shows: Overall productivity quality and timeliness

Overdue Tasks

  • Display: Count of overdue tasks
  • Format: Number
  • Color: Red (>0), Green (0)
  • Shows: Tasks past their due date that are not completed

Due Today

  • Display: Count of tasks due today
  • Format: Number with “due tomorrow” subtitle
  • Color: Yellow
  • Shows: Tasks requiring attention today

2. Time Tracking & Performance Cards

Time Accuracy

  • Display: Percentage
  • Calculation: Estimated vs actual time accuracy
  • Color: Green (≥90%), Yellow (70-89%), Red (<70%)
  • Shows: How accurately you estimate task durations

Completion Rate

  • Display: Percentage with progress bar
  • Calculation: (Completed tasks / Total tasks) × 100
  • Color: Green
  • Shows: Overall task completion percentage

Timely Completions

  • Display: Count
  • Format: Number
  • Color: Blue
  • Shows: Tasks completed on or before due date

Active Projects

  • Display: Count of projects you’re involved in
  • Format: Number
  • Color: Purple
  • Shows: Number of projects containing your tasks

3. Activity Summary Cards

Created Today

  • Display: Count of tasks created today
  • Format: Number
  • Color: Blue

Completed Today

  • Display: Count of tasks completed today
  • Format: Number
  • Color: Green

Due This Week

  • Display: Count of tasks due within 7 days
  • Format: Number
  • Color: Yellow

4. Charts and Visualizations

Productivity Trend Chart

  • Type: Line chart
  • Data: Tasks completed over time
  • Timeframes: 7 days, 30 days, 90 days
  • X-axis: Dates (formatted as “MMM DD”)
  • Y-axis: Task count

Task Distribution Chart

  • Type: Donut chart
  • Data: Current task status breakdown
  • Segments:
    • Completed (green)
    • Pending (yellow)
    • Overdue (red)
  • Center: Total task count

5. Today’s Focus

Purpose: Prioritize your most important tasks for today

Features:

  • Task filtering by status and priority
  • Virtual scrolling for large task lists (≥10 tasks)
  • Shows: Tasks due today, overdue tasks, or completed today
  • Empty state when no priority tasks exist

Task Filter Options:

  • Status: All task statuses available
  • Priority: All priority levels available
  • Persistent: Saved to localStorage

6. Recent Activity Feed

Shows:

  • Task creation and updates
  • Task completions
  • Project activities
  • Space activities
  • Task list activities
  • Comment activities

Limit: 50 most recent activities

Format: Compact activity feed with:

  • Activity type icon
  • Action description
  • Timestamp
  • User name
  • Target item name

7. Quick Actions

Available Actions:

  • Create Task (if permissions allow)
  • Today’s Focus (navigate to /Today)
  • My Tasks (navigate to /Tasks)
  • Upcoming (navigate to /Upcoming)
  • Team Dashboard (if workspace member)
  • Projects (navigate to /Projects)
  • Time Tracker (coming soon)
  • Weekly Report (coming soon)

Workspace Filtering

All Workspaces View:

  • Default view showing tasks across all workspaces
  • Indicator: “All Workspaces” badge with globe icon

Single Workspace View:

  • Filter to specific workspace
  • Indicator: Workspace name badge (clickable to clear)
  • Shows: Only tasks from selected workspace

Timeframe Selection

Available Timeframes:

  • Last 7 days
  • Last 30 days
  • Last 90 days

Affected Components:

  • Productivity trend chart
  • Activity calculations
  • Comment activities

Toggle: Click the timeframe button in the header

Workspace Dashboard

Overview

The Workspace Dashboard provides team-wide analytics and management tools for workspace administrators and members.

Dashboard Sections

1. Workspace Overview Cards

Total Spaces

  • Display: Count of spaces in workspace
  • Format: Number
  • Color: Blue
  • Subtitle: “Organizational units”

Active Projects

  • Display: Count of non-completed/non-cancelled projects
  • Format: Number with total projects subtitle
  • Color: Green
  • Shows: Currently active projects

Team Members

  • Display: Count of unique team members
  • Format: Number
  • Color: Purple
  • Calculated from: Unique assignees across all tasks

Team Engagement

  • Display: Average engagement percentage
  • Format: Percentage with progress bar
  • Color: Green (≥80%), Yellow (60-79%), Red (<60%)
  • Calculation: Average of all member engagement scores

Average Task Age

  • Display: Average age of pending tasks in days
  • Format: Number + “days”
  • Color: Red (>14), Yellow (7-14), Green (<7)
  • Status: Danger (>14), Warning (7-14), Good (<7)

Task Completion

  • Display: Workspace-wide completion rate
  • Format: Percentage with progress bar
  • Color: Green
  • Status: Good (≥80%), Warning (60-79%), Danger (<60%)

2. Team Member Engagement

Displays: List of team members with engagement metrics

Metrics per Member:

  • Engagement score (percentage)
  • Total tasks assigned
  • Completed tasks count
  • Recent activity count
  • Engagement label: High (≥80%), Medium (60-79%), Low (<60%)

Features:

  • Show top 6 members by default
  • “Show More” to display all members
  • Visual progress bars
  • Engagement status badges

3. Daily Activity Cards

Tasks Created Today

  • Count of tasks created today
  • Color: Blue

Tasks Completed Today

  • Count of tasks completed today
  • Color: Green

Overdue Tasks

  • Count of overdue tasks in workspace
  • Color: Red (>0), Green (0)
  • Status: Danger (>0), Good (0)

4. Spaces Performance

Displays: Performance metrics for each space

Metrics per Space:

  • Space title and color indicator
  • Project count
  • Task count
  • Completion rate (percentage with progress bar)
  • Clickable link to Space Dashboard

Features:

  • Show top 6 spaces by default
  • “Show More” to display all spaces
  • Empty state when no spaces exist

5. Charts

Team Activity Trend

  • Type: Line chart
  • Data: Tasks and project activity over time
  • Timeframes: 7, 30, or 90 days
  • X-axis: Dates
  • Y-axis: Activity count

Project Status Distribution

  • Type: Donut chart
  • Data: Projects grouped by status
  • Center: Total project count
  • Colors: Status-specific colors

6. Assignee Performance

Displays: Detailed performance metrics for each team member

Metrics per Assignee:

  • Performance score (percentage)
  • Completion rate (percentage)
  • Average task age (days)
  • Total tasks assigned
  • Completed tasks
  • Overdue tasks
  • High priority tasks
  • Recent activity count
  • Workload level: High, Medium, Low

Visual Elements:

  • Performance badge: Excellent (≥80%), Good (60-79%), Needs Improvement (<60%)
  • Colored avatar based on performance
  • Workload level badge
  • Status indicators (overdue, low activity, on track)
  • Progress bar for task completion

Features:

  • Show top 6 performers by default
  • “Show More” to display all assignees
  • Empty state when no assignees exist

7. Workspace Activity Feed

Shows:

  • Task activities
  • Project activities
  • Space activities
  • Task list activities
  • Comment activities

Limit: 40 most recent activities

Format: Compact feed with activity type, action, user, timestamp

8. Quick Actions

Standard Actions:

  • New Space (if permissions allow)
  • Invite Members (if permissions allow)
  • All Spaces (navigate to /Spaces)
  • All Projects (navigate to /Projects)
  • Team Management (if permissions allow)
  • Workspace Report (if permissions allow)

Enhanced Actions (conditional):

Rebalance Workload

  • Shown: When overloaded members exist
  • Condition: Members with >15 pending or >3 overdue tasks
  • Permission: Manage assignments
  • Opens: Workload rebalancing modal

Address Overdue

  • Shown: When overdue tasks exist
  • Displays: Count of overdue tasks
  • Permission: Manage tasks
  • Opens: Bulk task manager for overdue tasks

Review Blocked

  • Shown: When blocked tasks exist
  • Displays: Count of blocked tasks
  • Permission: Manage tasks
  • Opens: Bulk task manager for blocked tasks

Low Engagement

  • Shown: When low engagement members exist
  • Condition: Members with <60% engagement score
  • Permission: Manage workspace
  • Opens: Low engagement management modal
  • Label: “Experimental”

Bulk Task Management

Modes Available:

  1. Overdue tasks management
  2. Blocked tasks management

Features:

  • Bulk status updates
  • Bulk reassignments
  • Bulk priority changes
  • Task-by-task review

Data Processing

Asynchronous Processing

Both dashboards use an optimized asynchronous processing system for performance:

Processing Types:

  1. Personal Metrics (High Priority)

    • Task counts and calculations
    • Productivity scores
    • Due date calculations

  2. Assignee Performance (Medium Priority)

    • Performance scores
    • Workload analysis
    • Engagement metrics

  3. Chart Data (Low Priority)

    • Trend calculations
    • Distribution data

  4. Activity Generation (Low Priority)

    • Activity feed data
    • Comment activities

Progressive Loading:

  • Initial skeleton screens during first load
  • Background processing indicators
  • Section-by-section data population
  • Cache-based instant subsequent loads

Loading States

Initial Load:

  • Full-screen loading overlay
  • Processing progress indicator
  • Loading message
  • Minimum 100ms delay to show indicator

Background Processing:

  • Small indicator in header
  • Progress percentage (if available)
  • Non-blocking updates
  • Sections load progressively

Skeleton States:

  • Generic skeletons for metric cards
  • Chart skeletons for visualization areas
  • Activity skeletons for feed areas
  • Team/assignee skeletons for performance sections
  • Space skeletons for space performance lists

Real-time Updates

Data Reactivity

Automatic Updates:

  • Data changes trigger automatic recalculation
  • Workspace changes clear cache and reload
  • Task updates refresh relevant metrics
  • Project/space changes update related sections

Debounced Updates:

  • 200ms debounce on data changes
  • Prevents excessive re-processing
  • Optimizes performance

Manual Refresh

Methods:

  • Change timeframe (triggers immediate recalculation)
  • Switch workspace (clears cache and reloads)
  • Navigate away and back (fresh load)

Tooltips and Help

Metric Tooltips

Every metric card includes an info icon with tooltips explaining:

  • Title: Metric name
  • Content: What the metric measures
  • Calculation: How it’s calculated
  • Thresholds: What the values mean

Dashboard Types:

  • Personal dashboard metrics
  • Workspace dashboard metrics

Sections with Tooltips:

  • Metrics cards
  • Chart sections
  • Performance sections
  • Activity sections
  • Quick actions

Permissions

Personal Dashboard

View Access:

  • All authenticated users
  • Shows only user’s own tasks
  • Respects workspace permissions

Create Actions:

  • Create Task: Requires Create permission on MTask
  • Team Dashboard: Requires Read permission on Members

Workspace Dashboard

View Access:

  • Workspace members only
  • Filtered to current workspace

Management Actions:

  • Create Space: Requires Create permission on M Space
  • Invite Members: Requires Create permission on Members
  • Manage Members: Requires Read permission on Members
  • Manage Tasks: Requires Update permission on MTask
  • Manage Assignments: Requires Update permission on MTask
  • Manage Workspace: Requires Update permission on M Workspace
  • Generate Reports: Requires GenerateReports permission on M Workspace

Performance Monitoring

Development Mode

When running in development mode (VITE_DEVELOPER_MODE=true):

Performance Monitor Shows:

  • Task count
  • Assignee count
  • Project count
  • Space count
  • Cache hit rate
  • Processing status
  • Processing progress
  • Last updated timestamp

Actions Available:

  • Refresh dashboard
  • Clear performance cache
  • View processing errors

Technical Details

Components

Shared Components:

  • MetricCard.vue: Individual metric display
  • ChartWidget.vue: Chart visualizations
  • CompactActivityFeed.vue: Activity feed display
  • DashboardTooltip.vue: Metric explanations
  • SectionTooltip.vue: Section-level help
  • DashboardSectionWrapper.vue: Loading state wrapper
  • DashboardInitialLoading.vue: Full-screen loader
  • DashboardBackgroundIndicator.vue: Background processing indicator
  • DashboardSkeleton.vue: Various skeleton states

Workspace-Specific Components:

  • BulkTaskManagerModal.vue: Bulk task operations
  • WorkloadRebalanceModal.vue: Workload management
  • LowEngagementModal.vue: Engagement interventions
  • ReassignTasksDialog.vue: Task reassignment

Composables

Primary Composable:

  • useDashboard(): Unified dashboard logic
    • Context-aware (personal, workspace, space, project, tasklist)
    • Async processing system
    • Cache management
    • Loading state management
    • Activity generation utilities

Utility Composables:

  • useDashboardUtils(): Styling and formatting helpers
  • useDashboardActions(): Action management for workspace dashboard
  • useVirtualScrolling(): Optimized list rendering

Data Sources

Personal Dashboard:

  • tasks: User’s tasks (assigned to or created by user)
  • projects: Projects containing user’s tasks
  • spaces: Spaces containing user’s projects
  • taskLists: Task lists containing user’s tasks
  • personalComments: Comments on user’s tasks
  • userCreatedComments: Comments created by user

Workspace Dashboard:

  • workspaceTasks: All tasks in workspace
  • workspaceProjects: All projects in workspace
  • workspaceSpaces: All spaces in workspace
  • workspaceTaskLists: All task lists in workspace
  • workspaceComments: All comments in workspace
  • users: User information for name display

Caching Strategy

Cache Keys Format:

  • Personal: {type}-personal (e.g., personal-metrics-personal)
  • Workspace: {type}-workspace-{workspaceName} (e.g., workspace-metrics-workspace-MyWorkspace)

Cache Types:

  • personal-metrics: Personal task metrics
  • workspace-metrics: Workspace-wide metrics
  • assignee-performance: Assignee performance data
  • chart-data: Chart visualization data
  • activity-generation: Activity feed data
  • spaces-performance: Space performance metrics

Cache Invalidation:

  • Workspace change: Clear all workspace-specific caches
  • Data change: Schedule reprocessing
  • Manual: Development mode clear cache action

Best Practices

For Individual Users

Daily Review:

  1. Check Personal Dashboard each morning
  2. Review Today’s Focus section
  3. Address overdue tasks
  4. Plan priority work based on metrics

Weekly Analysis:

  1. Review productivity trend chart
  2. Analyze completion rates
  3. Identify patterns in task age
  4. Adjust workflow based on insights

Timeframe Selection:

  • Use 7-day view for daily/weekly planning
  • Use 30-day view for monthly reviews
  • Use 90-day view for quarterly analysis

For Workspace Administrators

Team Monitoring:

  1. Check Team Member Engagement section daily
  2. Monitor overdue and blocked task counts
  3. Review Space Performance regularly
  4. Track team engagement trends

Proactive Management:

  1. Use “Rebalance Workload” when members are overloaded
  2. Address overdue tasks promptly
  3. Investigate low engagement early
  4. Review blocked tasks weekly

Bulk Operations:

  • Use bulk task manager for efficient task updates
  • Reassign tasks to balance workload
  • Update priorities in batches
  • Address common blockers systematically

Troubleshooting

Dashboard Shows No Data

Possible Causes:

  1. No tasks assigned to you (Personal)
  2. No tasks in workspace (Workspace)
  3. Workspace filter applied (Personal)
  4. Data not yet loaded

Solutions:

  1. Wait for initial load to complete
  2. Check if you have tasks in Tasks page
  3. Clear workspace filter if applied
  4. Refresh the page
  5. Check browser console for errors

Metrics Seem Incorrect

Possible Causes:

  1. Cache showing stale data
  2. Timeframe filter applied
  3. Calculation still processing
  4. Data sync delay

Solutions:

  1. Change timeframe and change back
  2. Navigate away and return to dashboard
  3. Wait for background processing to complete
  4. In development mode, clear cache
  5. Check Performance Monitor for processing status

Charts Not Loading

Possible Causes:

  1. Low-priority async processing not complete
  2. Large dataset causing delay
  3. Browser performance issues

Solutions:

  1. Wait for background processing indicator
  2. Check Performance Monitor
  3. Reduce timeframe to 7 days
  4. Refresh page

Slow Dashboard Performance

Possible Causes:

  1. Large number of tasks
  2. Many assignees
  3. Long timeframe selected
  4. Browser resource constraints

Solutions:

  1. Use shorter timeframe (7 days instead of 90)
  2. Close unnecessary browser tabs
  3. Clear browser cache
  4. Wait for initial processing to complete
  5. Subsequent loads will be faster due to caching

Workspace Dashboard Not Accessible

Possible Causes:

  1. Not a member of any workspace
  2. Insufficient permissions
  3. No workspace selected

Solutions:

  1. Ensure you’re a member of a workspace
  2. Check with workspace administrator
  3. Select a workspace from workspace selector
  4. Verify permissions in Settings

API Integration

Backend Processing

Dashboard data is processed primarily on the frontend for performance. No dedicated backend dashboard API endpoints exist - data comes from standard resource endpoints:

  • tasks: /api/resource/MTask
  • projects: /api/resource/MProject
  • spaces: /api/resource/M Space
  • taskLists: /api/resource/MTaskList
  • comments: Filtered comment resources with workspace/timeframe

Data Filtering

Personal Dashboard:

  • Client-side filtering by current user
  • Workspace filtering when selected
  • Timeframe filtering for activities

Workspace Dashboard:

  • Client-side filtering by workspace
  • Hierarchical filtering: Workspace → Spaces → Projects → Tasks
  • Timeframe filtering for charts