## Overview

The Project Manager Report Grid widget is part of the CTTS (Collaborative Time Tracking System) timebooking solution. It provides project managers and leaders with a comprehensive tabular overview of time bookings across their projects. The widget aggregates and displays time tracking data to help project managers monitor resource allocation, verify time entries, and understand how team members' time is distributed across different projects.

Users can select a date range (start and end month/year) to view time tracking data for specific periods. The widget also supports representative mode, allowing authorized substitutes to view reports on behalf of other project managers.

## Use Cases

### Project Time Oversight
A project manager wants to see how much time team members have spent on various projects during a specific month or quarter to:
- Monitor project progress through time investment
- Identify resource allocation patterns
- Verify that team members are booking time correctly
- Prepare for project reviews or billing

### Cross-Project Analysis
A project manager overseeing multiple projects wants to understand:
- Which employees are working on which projects
- How employee time is distributed across projects (percentage view)
- Whether resources are balanced or overallocated

### Custom Reporting
Organizations can configure additional employee attributes to display in the report (such as cost center, seniority level, or department) for enhanced analysis and budget tracking.

### Representative/Substitute Viewing
When a project manager is unavailable, their designated substitute can use representative mode to review project time bookings without switching user accounts.

## Design Considerations

The widget provides data in a tabular/grid format, which is ideal for detailed analysis and comparison of time entries across employees and projects. It shares the same data retrieval logic with its chart counterpart, ensuring consistency between views.

Key features include:
- Persistent date range selection (remembered per user and space)
- Configurable custom person attributes for enriched reporting
- Permission-based access through group membership
- Workspace filtering for multi-tenant environments
- Integration with time tracking export functionality

## Alternatives

| Widget | When to Use |
|--------|-------------|
| **cf.cplace.ctts.main.projectmanagerReportChart** | When you need a graphical/chart visualization of the same project manager time tracking data instead of a table |
| **cf.cplace.ctts.main.employeeReportGrid** | When you need to view time bookings from an individual employee's perspective rather than a project manager's overview |
| **cf.cplace.ctts.main.widget** | When you need to enter time bookings rather than view/analyze existing data |