Skip to main content

Viewer Guide

Welcome to TrendGate! As a Viewer, you have read-only access to quality dashboards and test results, allowing you to monitor project health and track quality metrics.

👁️ Your Access Level​

As a Viewer, you can:

  • ✅ View all quality dashboards
  • ✅ Access test run history
  • ✅ See quality trends and metrics
  • ✅ Read project reports
  • ✅ Export data for analysis

You cannot:

  • ❌ Create or modify policies
  • ❌ Generate API keys
  • ❌ Invite team members
  • ❌ Change system settings

🎯 Navigating TrendGate​

Main Dashboard​

Your home screen displays:

  1. Quality Overview

    • Current quality score
    • Test pass rates
    • Code coverage metrics
    • Performance indicators

  2. Recent Test Runs

    • Latest CI/CD results
    • Pass/fail status
    • Execution times
    • Trend indicators

  3. Project Health

    • Quality trends over time
    • Branch comparisons
    • Module-level breakdowns

📊 Understanding Quality Metrics​

Test Pass Rate​

The percentage of tests that passed in the most recent run:

  • 🟢 95-100 percent: Excellent
  • 🟢 85-95 percent: Good
  • 🟡 70-85 percent: Fair
  • 🟠 50-70 percent: Poor
  • 🔴 Less than 50 percent: Critical

Code Coverage​

How much of the code is tested:

  • Line Coverage: Percentage of code lines executed
  • Branch Coverage: Percentage of decision branches tested
  • Function Coverage: Percentage of functions called

Performance Scores​

Based on Lighthouse metrics:

  • Performance: Page load speed
  • Accessibility: Usability for all users
  • Best Practices: Code quality standards
  • SEO: Search engine optimization

🔍 Using the Test Runs Table​

The test runs table shows:

ColumnDescription
StatusPass ✅ or Fail ❌
ProjectRepository name
BranchGit branch tested
TestsTotal/Passed/Failed
CoverageCode coverage %
DurationTest execution time
TriggeredWho/what started the run

Filtering Options​

Use filters to find specific results:

  • Project: Select specific repositories
  • Branch: Filter by branch name
  • Status: Show only passes or failures
  • Date Range: Focus on specific time periods

📈 Reading Quality Trends​

Trend Charts​

The trend chart shows quality evolution:

  • X-axis: Time (days/weeks/months)
  • Y-axis: Quality metrics (%)
  • Lines: Different metrics tracked
  • Upward trend 📈: Quality improving
  • Downward trend 📉: Quality declining
  • Flat line ➡️: Stable quality
  • Spikes 📊: Investigate anomalies

🎨 Dashboard Customization​

Even as a Viewer, you can personalize your experience:

View Options​

  • Compact View: More data, less space
  • Detailed View: Full information display
  • Chart Types: Line, bar, or area charts
  • Time Ranges: Last 7/30/90 days

Saved Views​

Create personal dashboard configurations:

  1. Adjust filters and layout
  2. Click "Save View"
  3. Name your configuration
  4. Access from "My Views" dropdown

📥 Exporting Data​

Extract data for external analysis:

Export Formats​

  • CSV: For spreadsheet analysis
  • JSON: For programmatic processing
  • PDF: For reports and presentations

Export Steps​

  1. Apply desired filters
  2. Click "Export" button
  3. Choose format
  4. Select data range
  5. Download file

🔔 Staying Informed​

Email Notifications​

Configure alerts for:

  • Daily/weekly quality summaries
  • Critical quality drops
  • Milestone achievements

Dashboard Alerts​

In-app notifications for:

  • New test results
  • Policy violations
  • System announcements

💡 Tips for Effective Monitoring​

1. Regular Check-ins​

  • Review dashboard daily
  • Focus on your projects
  • Note unusual patterns

2. Trend Analysis​

  • Compare week-over-week
  • Identify improvement areas
  • Track long-term progress

3. Collaborate​

  • Share observations with team
  • Ask questions about metrics
  • Suggest improvements

4. Learn Patterns​

  • Understand normal ranges
  • Recognize warning signs
  • Anticipate issues

🚀 Making the Most of Viewer Access​

For Project Managers​

  • Track sprint quality
  • Monitor release readiness
  • Identify risk areas

For Stakeholders​

  • Understand project health
  • Review quality reports
  • Make informed decisions

For Team Members​

  • See impact of changes
  • Learn from failures
  • Celebrate improvements

❓ Common Questions​

Q: Why can't I see certain projects? A: You can only view projects your organization has access to.

Q: How often is data updated? A: Test results appear within 2 minutes of CI/CD completion.

Q: Can I share dashboard links? A: Yes, but recipients need appropriate access to view them.

Q: What does "baseline" mean? A: The baseline is the quality standard (usually from the main branch) that other branches are compared against.

📚 Learn More​

Need help? Contact your team's QA Lead or visit our Support Center.