Dashboard and Metrics¶

This page explains the individual parts of the dashboard and the meaning of the displayed metrics.

Dashboard Overview¶

flowchart TB
    subgraph Dashboard["Dashboard"]
        A["Navigation"]
        B["Course Overview"]
        C["Team List"]
        D["Team Detail"]
        E["Student Detail"]
        F["Project Detail"]
    end

    A --> B
    B --> C
    C --> D
    D --> E
    D --> F

Navigation¶

Main Sections¶

Global Status Bar¶

A global sync status bar appears at the top of every page showing ongoing synchronizations:

• Number of queued, running, and completed jobs
• Auto-updates every 2 seconds
• Disappears after all jobs complete

Filtering and Searching¶

• Search: Find a team or student by name
• Filtering: Display by status (OK, Warning, Critical)
• Sorting: By compliance score, name, activity

Course Overview¶

Summary Metrics¶

On the course page you will see:

• Number of teams, students, and projects
• Average compliance score with trend vs. last week
• Team list with traffic-light status
• Alerts for teams needing attention

Team Statuses¶

Team List¶

Team Table¶

Team Detail¶

Detail Sections¶

1. Compliance Overview¶

Traffic-light status for each of the 13 Built-in Controls (R01-R13) plus custom controls (C01+).

pie title Compliance Breakdown
    "Issue (R01)" : 8
    "MR (R02-R05, R10-R11)" : 42
    "Review (R06-R09)" : 43
    "CI (R12)" : 7

2. Rubric¶

Weighted scores by rubric categories. Each category shows:

• Current score (%)
• Color indicator (green / yellow / red)
• List of controls in the category

3. Activity Charts¶

Interactive charts showing team activity over time - commits, MRs, issues.

4. Gaming Flags¶

5. Statistics¶

• Number of commits, MRs, issues, comments
• Review coverage (% of MRs with review)
• Pipeline success rate
• Test coverage

Student Detail¶

Individual Metrics¶

All metrics show comparison with team average.

Section Pagination¶

Student detail contains 8 sections with client-side pagination:

1. Commits
2. Merge Requests
3. Issues
4. Comments
5. Pipeline results
6. Review activity
7. AI enrichment

Compliance Metrics (R01-R13)¶

Category: Issue¶

Category: MR¶

Category: Review¶

Checks R06-R09 support partial scoring - score = weight × fulfillment ratio.

Category: CI¶

Configuration Export & Import¶

JSON Export¶

Export the complete course configuration including:

• Course settings
• Compliance controls and thresholds
• Rubric and categories
• Custom controls

JSON Import¶

Import configuration into a new or existing course. Useful for:

• Cloning settings between courses
• Sharing configuration between teachers
• Backup and restore

AI Enrichment¶

GitPulse provides LLM-generated summaries for:

• Team - overall overview of strengths and areas for improvement
• Student - individual contribution analysis

GitLab Roles and Scoring¶

Role Badges¶

On the team detail page, each member displays a colored badge reflecting their GitLab role:

Members with inherited membership (from parent group) have an additional "inherited" badge.

Non-Contributing Members¶

Members excluded from the team score are labeled (not in team score). Exclusion occurs when:

1. Low role + zero activity - Guest or Reporter with no commits, MRs, issues, or reviews
2. Inherited access + zero activity - inherited group member without any activity, regardless of role
3. Teacher - teachers marked as is_teacher=true

Further Reading¶

• Result Interpretation - How to read metrics correctly
• FAQ - Frequently asked questions