## Overview

The Employee Report Grid widget provides a comprehensive tabular overview of time tracking bookings for an individual employee. It displays time entries aggregated across all booking targets (projects, tasks, etc.) within a configurable date range, with data broken down by month.

Use this widget when employees or authorized representatives need to:
- View aggregated time entries across all booking targets within a selected time period
- Analyze time distributions broken down by month
- Review total time spent per booking target and per time period
- Export time tracking data for reporting purposes

The widget uses a read-only spreadsheet-like grid (Handsontable) where rows represent booking targets, columns represent months, and cells show hours worked in HH:MM format.

## Use Cases

### Personal Time Tracking Review
Individual employees reviewing their own time bookings across all projects and tasks during a specific period, such as at the end of a month, quarter, or project milestone for performance reviews.

### Representative Time Tracking View
Managers, HR personnel, or administrative staff with representative permissions viewing and verifying time tracking entries on behalf of another employee during absence management, compliance reviews, or administrative tasks.

### Time Distribution Analysis
Employees and project managers analyzing how time was distributed across different booking targets over multiple months for project planning or retrospectives.

### Time Tracking Export Preparation
Employees needing to export time data to external systems for billing, external reporting, or integration with third-party systems, such as contractors generating invoices.

## Design Considerations

This widget is part of the cplace Time Tracking system and has no widget-level configuration options. All configuration comes from app-level settings, user selections at runtime (date range, representative), and workspace-level settings.

Key features include:
- Date range selection with persistent user preferences
- Representative mode for authorized users to view other employees' data
- Column sorting and filtering capabilities
- Optional export functionality when templates are configured

## Alternatives

### Employee Report Chart Widget
**ID:** `cf.cplace.ctts.main.employeeReportChart`
A companion widget that displays the same employee time tracking data in chart format rather than a tabular grid. Use when a visual/graphical representation is preferred over detailed numbers.

### Project Manager Report Grid Widget
**ID:** `cf.cplace.ctts.main.projectmanagerReportGrid`
A similar grid-based reporting widget for project managers that shows time bookings from a project/team perspective instead of individual employee view. Use when aggregating time across multiple employees for a project rather than across projects for one employee.