Skip to main content

Overview

The Areas Management feature provides a strategic dashboard for comparing performance metrics across different organizational areas or business departments. This powerful analytics tool helps administrators identify high-performing teams, detect risk areas, and make data-driven decisions about resource allocation.
This feature is accessible to both administrators (with full client filtering) and client users (limited to their own organization’s data).

Key Metrics Dashboard

The Areas dashboard displays 5 critical KPIs at the top of the page:

Active Areas

Total number of organizational areas with assigned dilemmas

Active Dilemmas

Total dilemmas deployed across all areas

Participation Rate

Percentage of invited users who started at least one dilemma

Completion Rate

Percentage of users who finished their assigned dilemmas

Average Correctness

Average percentage of correct answers across all areas

Comparative Ranking Table

The main feature is a comprehensive ranking table that compares all areas side-by-side:

Metrics Tracked per Area

  • Dilemas: Number of dilemmas assigned to the area
  • Invitados (Invited): Total users invited from this area
  • Iniciados (Started): Users who began at least one dilemma
  • Finalizados (Finished): Users who completed their dilemmas
  • Participación: Participation rate with color-coded badges
    • 🟢 Green: ≥70%
    • 🟡 Yellow: 40-69%
    • 🔴 Red: <40%
  • Finalización: Completion rate with color-coded indicators
  • Correctas: Average percentage of correct answers
  • Engagement: Overall engagement score
  • Tiempo: Average completion time in minutes
Areas with low participation (<40%) or completion rates are highlighted in red to draw attention to potential issues.

Filtering Options

For Administrators

Administrators can filter the dashboard by client using the dropdown selector:
// Accessible via GET parameter
?client_id=123
This allows admins to focus on specific clients or view aggregated data across all clients.

For Client Users

Client users automatically see data filtered to their own organization only. The client name is displayed as a read-only badge.

PDF Export Capability

The entire dashboard can be exported to PDF format for reporting purposes:
1

Click Export PDF Button

Click the blue “Exportar PDF” button in the top-right corner
2

PDF Generation

The system generates a landscape-format PDF with all KPIs and the ranking table
3

Download

The PDF is automatically downloaded as dashboard_areas.pdf
Technical Details:
  • Format: Letter size, landscape orientation
  • Quality: High resolution (scale: 2, JPEG quality: 0.98)
  • Filename: dashboard_areas.pdf
  • The export button is temporarily hidden during PDF generation

Area Detail Navigation

Each area in the ranking table has a “Detalle” (Detail) button that navigates to a dedicated area detail page:
area_detail.php?area={area_name}
This provides drill-down analytics for specific areas.

Use Cases

Performance Benchmarking

Compare areas to identify best practices and underperforming teams

Resource Allocation

Determine which areas need additional training or support

Risk Detection

Identify areas with low engagement or completion rates

Executive Reporting

Export professional PDFs for stakeholder presentations

Access Control

Access Level: Mixed
  • Administrators: Full access with client filtering capabilities
  • Client Users: Restricted to their own client’s data only
  • Regular Users: No access
// Access control logic (areas.php:7-12)
$userClientName = check_is_admin() ? null : get_user_client_name($_SESSION['user_id'] ?? 0);

if (!$userClientName && !check_is_admin()) {
    $userClientName = get_current_user_name();
}

Color-Coded Status System

All percentage metrics use a consistent color-coding system:
RangeColorMeaning
≥70%🟢 GreenGood performance
40-69%🟡 YellowNeeds attention
<40%🔴 RedCritical - requires intervention
This visual system allows quick identification of problem areas at a glance.

Best Practices

For Administrators:
  • Review the Areas dashboard weekly to track trends
  • Export PDFs for monthly executive reports
  • Focus interventions on red-flagged areas
  • Use the engagement score to identify disengaged teams
For Analysis:
  • Compare completion rates across similar-sized areas
  • Investigate areas with high participation but low completion
  • Look for correlations between average time and correctness scores

Build docs developers (and LLMs) love