@cplace/test-mcp-server 0.1.15 → 1.1.0

package/dist/widget-specifications/_research_from_ga_products/cf-cplace-ctts-main-employeeReportGrid/research.md

@@ -0,0 +1,215 @@
+# Widget Research: cf.cplace.ctts.main.employeeReportGrid
+
+## Widget Description
+
+The Employee Report Grid widget displays an interactive table view of time tracking data for an individual employee, showing time bookings aggregated across multiple booking targets (projects, tasks, etc.) over a configurable date range.
+
+## Purpose
+
+This widget provides employees and authorized users with a comprehensive tabular overview of time tracking bookings, enabling them to:
+- View aggregated time entries across all booking targets within a selected time period
+- See time distributions broken down by month
+- Analyze total time spent per booking target and per time period
+- Export time tracking data for reporting purposes
+
+## Use Cases
+
+### 1. Personal Time Tracking Review
+**Who:** Individual employees
+**When:** End of month, quarter, or project milestone
+**Why:** To review their own time bookings across all projects and tasks they've worked on during a specific period.
+
+**Example:** An employee wants to see how much time they spent on each project during Q1 2026 to prepare for a performance review.
+
+### 2. Representative Time Tracking View
+**Who:** Managers, HR personnel, or administrative staff with representative permissions
+**When:** During absence management, compliance reviews, or administrative tasks
+**Why:** To view and verify time tracking entries on behalf of another employee.
+
+**Example:** An HR manager needs to review time bookings for an employee who is on leave to verify their recorded hours before payroll processing.
+
+### 3. Time Distribution Analysis
+**Who:** Employees and project managers
+**When:** During project planning or retrospectives
+**Why:** To analyze how time was distributed across different booking targets over multiple months.
+
+**Example:** A consultant wants to see their time distribution pattern across 5 different client projects over the past 6 months to identify capacity allocation trends.
+
+### 4. Time Tracking Export Preparation
+**Who:** Employees needing to export time data to external systems
+**When:** For billing, external reporting, or integration with third-party systems
+**Why:** To select a specific time range and set of booking targets for export.
+
+**Example:** A contractor needs to export their tracked hours for specific projects to generate an invoice for their client.
+
+## Core Functionality
+
+### Data Display
+- **Interactive Grid:** Uses Handsontable library to display time tracking data in a spreadsheet-like format
+- **Read-Only View:** The grid is configured as read-only (data modification happens in the main booking widget)
+- **Columns:**
+  - Row header column: Booking target names (projects, tasks, etc.)
+  - Sum column: Total time per target across all shown periods
+  - Month columns: One column per month in the selected date range
+  - Header format: "MMM YYYY" (e.g., "Jan 2026")
+- **Rows:**
+  - First row: Sum per time period (total for each month)
+  - Data rows: One row per booking target with time entries
+  - Time format: Hours and minutes (HH:MM)
+
+### Date Range Selection
+- **Start/End Period:** Users can select start year/month and end year/month
+- **Available Years:** The widget shows years for which time bookings exist
+- **Persistent Selection:** Date range selection is persisted per user, per space, per report type
+
+### Representative Mode
+- **View as Representative:** Authorized users can select another employee to view their time tracking data
+- **Current User Default:** By default, shows the logged-in user's own time bookings
+- **Permission-Based:** Access controlled via app configuration (ALLOWED_GROUPS setting)
+
+### Filtering & Sorting
+- **Column Sorting:** Users can sort by any column
+- **Filtering:** Supports filter by condition and filter by value
+- **Custom Sort Function:** Uses special sorting logic for time values
+
+### Time Tracking Export
+- **Export Button:** Conditionally shown if time tracking export templates are configured
+- **Export Dialog:** Opens a dialog to select export template and format
+- **Selected Data:** Exports the currently displayed date range and booking targets
+
+## Configuration Concepts
+
+### Permission Control
+The widget respects app-level configuration for access control:
+- **ALLOWED_GROUPS:** Only users in specified groups can view the widget
+- **Access Denied Message:** Shows "View not allowed" alert if user lacks permissions
+
+### Representative Storage
+The widget uses `RepresentativeTool.EMPLOYEE_REPORTS` storage mode, which:
+- Tracks which user's data is currently being viewed
+- Enables switching between viewing own data and representative data
+- Maintains separate storage from project manager reports
+
+### Workspace Filtering
+- **Workspace-Specific Data:** The widget can be configured to show only booking targets from the current workspace
+- **Cross-Workspace Visibility:** Depending on configuration, may show targets from multiple workspaces
+
+### Time Tracking Export Integration
+- **Optional Feature:** Export functionality only appears if export templates are configured in the app settings
+- **Template Selection:** Users can choose from configured export templates
+- **Format Support:** Supports various export formats based on template configuration
+
+## Related Widgets
+
+### Employee Report Chart Widget
+**ID:** `cf.cplace.ctts.main.employeeReportChart`
+- Companion widget that displays the same data in chart format
+- Uses the same `ReportWidgetSubstitution` base class
+- Shares the same representative storage and date range selection
+- Provides visual/graphical representation instead of tabular
+
+### Project Manager Report Grid Widget
+**ID:** `cf.cplace.ctts.main.projectmanagerReportGrid`
+- Similar grid-based reporting for project managers
+- Shows time bookings from a project/team perspective instead of individual employee
+- Has additional configuration options for selecting person attributes to display
+- Uses `RepresentativeTool.PROJECTMANAGER_REPORTS` storage mode
+
+## Technical Context
+
+### Data Source
+- **Handler:** `ReportHandler` with report type `EMPLOYEE_VIEW`
+- **Data Manager:** `ReportEmployeeManager` generates aggregated time booking data
+- **Database Query:** Queries time booking data from the database, filtered by:
+  - User ID (current user or representative)
+  - Date range (start/end year and month)
+  - Workspace (based on configuration)
+  - Read permissions (only shows targets the user can access)
+
+### Frontend Components
+- **Directive:** `cfCplaceCttsEmployeeGrid` (AngularJS directive)
+- **Controller:** `CttsEmployeeGridCtrl`
+- **Service:** `CttsReportDataService` manages report data requests and updates
+- **Template:** `employeeReportGridWidgetDefinition.htm`
+
+### Data Flow
+1. Widget initializes with date range from `ReportDateRangeStore`
+2. User selects date range or representative
+3. Frontend requests data from `ReportHandler` with parameters:
+   - Report type: `EMPLOYEE_VIEW`
+   - Start/end year and month
+   - Current user ID or selected representative ID
+4. Backend aggregates time bookings from database
+5. Data transformed into grid format with:
+   - Monthly aggregations
+   - Target display names
+   - Time sums per target and per period
+6. Handsontable renders the grid with sorting and filtering
+
+### Dependencies
+- **App:** Part of `cf.cplace.ctts.main` plugin (cplace Time Tracking)
+- **App Configuration:** Uses `MainAppConfiguration` for permission settings
+- **Extension Point:** Uses `BookingTargetDisplayTextAppExtension` to determine how booking targets are displayed
+- **Libraries:** Handsontable (commercial license included in code)
+- **Framework:** AngularJS for frontend, Java backend
+
+## Key Implementation Details
+
+### Time Format
+- **Storage:** Time is stored in seconds in the database
+- **Display:** Converted to "HH:MM" format using `CttsGridUtils.secondsToHourMinutesFormat()`
+- **Aggregation:** Times are summed across bookings for the same target and month
+
+### Month Aggregation
+- **Data Structure:** `EmployeeReportTimeData` contains:
+  - Month and year
+  - Display name (e.g., "January 2026")
+  - List of `AggregatedMonthTargetMinutes` (one per booking target)
+- **Calculation:** Backend calculates ordinal values for months to determine date ranges and offsets
+
+### Target Filtering
+- **Read Permissions:** Only shows booking targets the user has read access to
+- **Workspace Filtering:** Optionally filters targets based on workspace configuration using `TimeBookingDataFinder.shouldTargetBeShownInThisWorkspace()`
+- **Dynamic Target List:** If new targets appear in the selected date range, they're added to all month aggregations (with 0 time for months without bookings)
+
+### Representative Functionality
+- **Mode Enum:** Uses `RepresentativeMode.Employee_Reports`
+- **User Switching:** Handlers allow selecting a different user via dialog
+- **Clear Function:** Ability to reset back to viewing own data
+- **Permission Check:** Uses `PrincipalTool.isPersonInGroup()` to verify access rights
+
+## Configuration vs. Usage Notes
+
+**No Widget-Level Configuration:** Unlike the Project Manager Report Grid widget, the Employee Report Grid has no widget-specific configuration options. All configuration comes from:
+- App-level settings in `MainAppConfiguration`
+- User selections at runtime (date range, representative)
+- Workspace-level settings
+
+**Runtime Customization:** Users customize their view through:
+- Date range selection (start/end month/year)
+- Representative selection (if authorized)
+- Column sorting and filtering
+- Export template selection (if enabled)
+
+## Architecture Patterns
+
+### Shared Base Class
+Both employee and project manager report widgets extend `ReportWidgetSubstitution`, which provides:
+- Common state initialization
+- Date range management
+- Representative mode handling
+- Handler URL generation
+- Time tracking export integration
+
+### Storage Pattern
+Uses `RepresentativeStorage` to maintain session-based state for:
+- Currently selected representative user
+- Representative selection dialog state
+- Separation between different report types
+
+### Date Range Persistence
+`ReportDateRangeStore` maintains date range selections:
+- Per user
+- Per workspace/page space
+- Per report type (employee view vs. project view)
+- Survives page refreshes within the same session

package/dist/widget-specifications/_research_from_ga_products/cf-cplace-ctts-main-projectmanagerReportChart/research.md

@@ -0,0 +1,192 @@
+# Widget Research: cf.cplace.ctts.main.projectmanagerReportChart
+
+## Widget Overview
+
+**Widget ID:** `cf.cplace.ctts.main.projectmanagerReportChart`
+**Widget Name:** Project Leader chart view Time Tracking
+**Repository:** cplace-ctts
+**Plugin:** cf.cplace.ctts.main
+**Definition Class:** `ProjectmanagerReportChartWidgetDefinition.java`
+
+## 1. Purpose and Description
+
+The **Project Leader chart view Time Tracking** widget provides a visual chart-based representation of time tracking data from a project manager's perspective. It displays booked time hours aggregated by projects over a selected date range, allowing project managers to analyze time distribution across the projects they manage.
+
+This widget is part of the CTTS (cplace Time Tracking System) and presents time tracking data as an interactive Highcharts visualization, showing time bookings broken down by project across months.
+
+## 2. Use Cases
+
+### Primary Use Cases
+
+1. **Project Manager Time Overview**
+   - Project managers can view an aggregated overview of time bookings across all their projects
+   - Visualize how team members allocate time across different projects
+   - Identify time distribution patterns over selected date ranges
+
+2. **Time Booking Analysis**
+   - Analyze time booking trends over months or years
+   - Compare time spent on different projects side-by-side
+   - Calculate total hours booked across all visible projects
+   - Toggle visibility of individual project series to focus on specific projects
+
+3. **Representative View**
+   - Project managers can view time tracking data on behalf of other users
+   - Supports "representative mode" where authorized users can access reports for others
+   - Useful for managers overseeing multiple team members' time allocations
+
+4. **Date Range Filtering**
+   - Users can select custom date ranges (start/end year and month)
+   - The widget remembers the last selected date range per user and space
+   - Provides a list of years where time bookings exist for quick selection
+
+### Problem Solved
+
+This widget solves the challenge of understanding and visualizing how time is distributed across projects from a management perspective. Without this visual representation, project managers would need to manually aggregate and analyze tabular time booking data, making it difficult to spot trends, imbalances, or anomalies in time allocation.
+
+## 3. Configuration Concepts
+
+### High-Level Configuration
+
+**Note:** Unlike the Grid variant (`projectmanagerReportGrid`), the Chart widget has **no custom configuration options**. It does not expose any widget-specific configuration attributes.
+
+The widget behavior is controlled by:
+
+1. **App Configuration (MainAppConfiguration)**
+   - `ALLOWED_GROUPS`: Defines which user groups have permission to access the widget
+   - If a user is not in an allowed group, they see an "View not allowed" message
+
+2. **Time Tracking Export Configuration** (Optional)
+   - If configured in the space, the widget shows an export button for time tracking data
+   - Controlled by `TimeTrackingExportAppConfiguration.EXPORT_TEMPLATES`
+
+### Runtime Configuration
+
+Users configure the widget behavior at runtime through:
+
+- **Date Range Selection**: Start/end year and month
+- **Representative Selection**: Option to view reports for other users (if authorized)
+- **Series Visibility**: Toggle individual project series on/off in the chart
+- **Chart Interaction**: Zoom, hover for details, etc. (standard Highcharts features)
+
+## 4. Context and Relationships
+
+### Related Widgets
+
+The Project Leader Chart widget is part of a family of four time tracking report widgets:
+
+1. **Employee Report Chart** (`cf.cplace.ctts.main.employeeReportChart`)
+   - Shows time bookings from an employee's perspective
+   - Displays "Employees chart view Time Tracking"
+   - Uses `EMPLOYEE_VIEW` report type and `EMPLOYEE_REPORTS` representative storage
+
+2. **Employee Report Grid** (`cf.cplace.ctts.main.employeeReportGrid`)
+   - Table-based view of employee time tracking data
+   - Alternative to the chart view with more detailed information
+
+3. **Project Leader Chart** (`cf.cplace.ctts.main.projectmanagerReportChart`) ← **This Widget**
+   - Shows time bookings from a project manager's perspective
+   - Displays "Project Leader chart view Time Tracking"
+   - Uses `PROJECT_VIEW` report type and `PROJECTMANAGER_REPORTS` representative storage
+
+4. **Project Leader Grid** (`cf.cplace.ctts.main.projectmanagerReportGrid`)
+   - Table-based view of project manager time tracking data
+   - Includes configuration for displaying additional person attributes
+   - Alternative to the chart view with more detailed, tabular information
+
+### Chart vs. Grid Distinction
+
+- **Chart Widgets**: Provide visual, graphical representations using Highcharts for trend analysis and quick overviews
+- **Grid Widgets**: Provide detailed tabular views with more granular data and customization options
+
+### Technical Relationships
+
+**Backend Components:**
+- `ReportWidgetSubstitution`: Shared base class for all four report widgets
+- `ReportHandler`: Backend handler that processes report requests
+- `ReportProjectManager`: Generates project-specific report data from the database
+- `RepresentativeTool`: Manages different representative storage contexts (CTTS, Employee, Project Manager)
+- `ReportDateRangeStore`: Stores and retrieves user-specific date range selections
+
+**Frontend Components:**
+- `CttsProjectChartCtrl`: Controller managing chart state and data requests
+- `cfCplaceCttsProjectChart`: Angular directive binding the controller to the template
+- `CttsReportDataService`: Service handling data fetching and caching
+- `CttsChartUtils`: Utility functions for chart calculations and formatting
+
+### Prerequisites and Dependencies
+
+1. **Permission Requirements**
+   - User must be a member of groups defined in `ALLOWED_GROUPS` app configuration
+   - If not authorized, the widget displays: "View not allowed"
+
+2. **Data Requirements**
+   - Time booking data must exist in the system for the widget to display meaningful information
+   - The `availableYears` list is generated from existing bookings for the current user
+
+3. **Integration Requirements**
+   - The widget integrates with the broader CTTS (cplace Time Tracking System)
+   - Requires proper configuration of time tracking targets (projects) and booking data
+   - Optional integration with Time Tracking Export functionality for export features
+
+## 5. Technical Implementation Details
+
+### Report Type
+- Uses `ReportTypes.PROJECT_VIEW` to fetch project-centric data
+- Data is grouped by projects (targets) with time distributed across months
+
+### Representative Mode
+- Utilizes `RepresentativeTool.PROJECTMANAGER_REPORTS` storage
+- Allows viewing reports for other users if permission is granted
+- Separate storage ensures project manager and employee views don't interfere
+
+### Data Flow
+1. User selects date range and optional representative
+2. Frontend sends request to `ReportHandler` with parameters
+3. `ReportProjectManager` queries database and aggregates time bookings by project
+4. Data is returned as JSON with series data (project name, monthly time values)
+5. Frontend renders Highcharts visualization with interactive features
+
+### Visualization Features
+- Monthly breakdown on X-axis (e.g., "Jan. 2025", "Feb. 2025")
+- Project series on Y-axis (hours as decimal values)
+- Total visible target sum displayed
+- Toggle button to show/hide all series
+- Interactive hover tooltips with detailed information
+
+## 6. Key Insights
+
+1. **No Widget Configuration**: This widget is simpler than the Grid variant and has no custom configuration options exposed to the user during widget setup.
+
+2. **Shared Architecture**: All four report widgets (Employee Chart/Grid, Project Leader Chart/Grid) share a common base (`ReportWidgetSubstitution`) but differ in:
+   - Report type (`EMPLOYEE_VIEW` vs `PROJECT_VIEW`)
+   - Representative storage context
+   - Configuration options (Grid widgets have more)
+
+3. **User Experience Focus**: The chart view prioritizes visual analysis and trend spotting over detailed data entry, making it ideal for overview and monitoring scenarios.
+
+4. **Permission-Based Access**: Access control is managed at the app configuration level through group membership, ensuring only authorized users (typically project managers) can access this view.
+
+5. **Persistence**: The widget remembers the last selected date range per user and space, providing a personalized experience.
+
+## 7. Related Files
+
+### Backend
+- `ProjectmanagerReportChartWidgetDefinition.java` - Widget definition
+- `ReportWidgetSubstitution.java` - Base substitution class
+- `ReportHandler.java` - HTTP request handler
+- `ReportProjectManager.java` - Data generation logic
+- `RepresentativeTool.java` - Representative mode management
+- `MainAppConfiguration.java` - App-level configuration
+
+### Frontend
+- `CttsProjectChartCtrl.ts` - Chart controller
+- `cfCplaceCttsProjectChart.ts` - Angular directive
+- `CttsReportDataService.ts` - Data service
+- `CttsChartUtils.ts` - Chart utility functions
+- `ProjectReportInterfaces.ts` - TypeScript interfaces
+
+### Localization
+- `messages_en.properties` - English translations
+- `messages_de.properties` - German translations
+  - Widget name: "Project Leader chart view Time Tracking"
+  - Alert message: "View not allowed"

package/dist/widget-specifications/_research_from_ga_products/cf-cplace-ctts-main-projectmanagerReportGrid/research.md

@@ -0,0 +1,178 @@
+# Widget Research: cf.cplace.ctts.main.projectmanagerReportGrid
+
+## Quick Description
+
+The Project Manager Report Grid widget displays time booking data in a tabular format from a project leader's perspective, showing which employees worked on which projects and for how long during a selected time period.
+
+## Purpose
+
+This widget is part of the CTTS (Collaborative Time Tracking System) timebooking solution and provides project managers/leaders with a comprehensive overview of time bookings across their projects. It aggregates and displays time tracking data to help project managers monitor resource allocation and time spent on different projects by team members.
+
+## Key Concepts
+
+### 1. Report Types
+The widget is specifically designed for the **Project Manager View** (PROJECT_VIEW) report type, which differs from the Employee View. It shows data organized by projects and employees rather than by individual employee timesheets.
+
+### 2. Representative Mode
+The widget supports viewing time tracking data on behalf of other users (substitution/representative mode). This is controlled through the `RepresentativeStorage.PROJECTMANAGER_REPORTS` storage, allowing authorized users to view reports for different project managers.
+
+### 3. Time Period Selection
+Users can select a date range to view time tracking data:
+- Start and end date selection (year and month)
+- The selected date range is persisted per user and space
+- Previous selections are remembered when returning to the widget
+
+### 4. Data Structure
+The widget displays:
+- **Projects**: The booked targets (pages) that employees worked on
+- **Employees**: The people who booked time to projects
+- **Time Data**: Hours/time booked per project per employee
+- **Project Distribution**: Percentage distribution showing how team members' time is allocated across projects
+- **Additional Person Attributes**: Configurable custom attributes from employee profiles
+
+## Configuration Options
+
+### Widget Configuration
+
+The widget supports one main configuration option:
+
+**REPORT_PERSON_ATTRIBUTES** (`cf.cplace.ctts.main.reportPersonAttributes`)
+- Type: Multi-string attribute with dynamic enumeration
+- Purpose: Allows selection of additional person attributes to display in the report
+- Label: "Choose custom attributes"
+- Use case: Display extra information about employees (e.g., department, role, cost center) alongside their time bookings
+
+This configuration is loaded from the widget configuration and used by `ReportAdditionalAttributes` to enrich the report data with custom person information.
+
+### App Configuration
+
+The widget respects app-level configurations from `MainAppConfiguration`, particularly:
+- **ALLOWED_GROUPS**: Determines who can view the report through permission checking
+- **showDataFromThisWorkspaceOnly**: Filters which booked targets are visible based on workspace membership
+
+## Use Cases
+
+### Primary Use Case: 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
+
+### Use Case: 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
+
+### Use Case: Custom Reporting
+An organization needs to include additional employee information in project reports, such as:
+- Cost center information for budget tracking
+- Employee seniority level for capacity planning
+- Department information for cross-functional project analysis
+
+They configure the `REPORT_PERSON_ATTRIBUTES` setting to include these custom attributes in the report grid.
+
+### Use Case: Representative/Substitute Viewing
+A project manager is on vacation, and their substitute needs to review project time bookings. The substitute uses the representative mode to view the project manager's reports without switching user accounts.
+
+## Related Widgets
+
+### cf.cplace.ctts.main.projectmanagerReportChart
+- **Relationship**: Companion widget to the grid view
+- **Difference**: Displays the same project manager time tracking data in a chart/graphical format instead of a table
+- **Shared Code**: Both widgets use the same `ReportWidgetSubstitution` base class and `ReportHandler` for data retrieval
+- **Use Together**: Organizations typically offer both widgets so users can choose between tabular data (grid) and visual analysis (chart)
+
+### cf.cplace.ctts.main.employeeReportGrid
+- **Relationship**: Similar widget but from employee perspective
+- **Difference**: Shows time bookings from an individual employee's viewpoint rather than a project manager's overview
+- **Report Type**: Uses EMPLOYEE_VIEW instead of PROJECT_VIEW
+
+### cf.cplace.ctts.main.MainWidget
+- **Relationship**: The primary time booking widget
+- **Difference**: Used for entering time bookings, while the project manager report grid is for viewing/analyzing already entered data
+- **Data Flow**: Time entered in MainWidget becomes the data displayed in the report grid
+
+## Technical Architecture
+
+### Handler Chain
+1. Widget renders with initial state using `ReportWidgetSubstitution`
+2. User interactions trigger `ReportHandler` via AJAX
+3. `ReportHandler` delegates to `ReportProjectManager` for data generation
+4. `ReportProjectManager` uses `ReportProjectManagerDatabaseUtilities` to query time bookings
+5. Data is returned as JSON through `ProjectReportBaseData` structure
+
+### Data Flow
+1. Widget initialization loads saved date range from `ReportDateRangeStore`
+2. Frontend sends request with date range and current user ID
+3. Backend queries time booking database for projects managed by the selected user
+4. Results are filtered by workspace visibility rules
+5. Additional person attributes are loaded if configured
+6. Project distribution percentages are calculated
+7. Data is serialized as JSON and sent to frontend for display
+
+### Key Classes
+- **ProjectmanagerReportGridWidgetDefinition**: Widget definition and configuration type
+- **ReportWidgetSubstitution**: Template substitution providing state and handlers
+- **ReportHandler**: HTTP handler for report data requests
+- **ReportProjectManager**: Business logic for generating project manager report data
+- **ReportAdditionalAttributes**: Manages custom person attributes in reports
+- **RepresentativeTool**: Manages representative/substitute user selection
+
+## Dependencies and Prerequisites
+
+### Required Permissions
+- User must be member of groups defined in `MainAppConfiguration.ALLOWED_GROUPS`
+- Without proper group membership, the widget displays "View not allowed" message
+
+### Data Prerequisites
+- Time bookings must exist in the system (entered via MainWidget)
+- Projects/targets must be properly configured as time booking targets
+- Project manager assignments must be configured (determines which projects a user can see)
+
+### Related Features
+- **Time Tracking Export**: Integration with time tracking export functionality (button visible if export templates configured)
+- **Project Manager Configuration App**: Used to assign project managers to projects/targets
+- **Representative System**: Requires representative/substitute user configuration
+
+## Frontend Integration
+
+### State Object
+The widget provides a comprehensive state object to the frontend including:
+- `reportHandlerURL`: Endpoint for fetching report data
+- `selectRepresentativeHandlerURL`: Endpoint for selecting substitute user
+- `clearRepresentativeHandlerURL`: Endpoint for clearing substitute selection
+- `selectTimeTrackingExportHandlerURL`: Endpoint for time tracking export
+- `uid`: Widget ID
+- `availableYears`: List of years with booking data
+- `startYear`, `startMonth`, `endYear`, `endMonth`: Current date range
+- `showTimeTrackingButton`: Boolean flag for export functionality
+- Representative/substitute user information
+
+### User Interface Elements
+Based on the localization messages, the widget likely provides:
+- Date range selectors (start/end year and month)
+- Representative/substitute user selection
+- Employee and project columns
+- Time data display (hours/percentage)
+- Time tracking export button (if configured)
+- Custom attribute columns (if configured)
+
+## Localization
+
+### Widget Name
+- **English**: "Project Leader table view Time Tracking"
+- **German**: "Projektleiter Tabelle Report Zeiterfassung"
+
+### Configuration Labels
+- **English**: "Choose custom attributes"
+- **German**: "Wählen Sie weitere Attribute"
+
+### Report Headline
+- **English**: "Project Leader Report Timebooking"
+- **German**: "Report Projektleiteransicht"
+
+## Summary
+
+The Project Manager Report Grid widget is a specialized reporting widget that provides project managers with a tabular view of time bookings across their projects. It enables oversight of resource allocation, supports custom employee attributes for enriched reporting, and integrates with the broader CTTS time tracking ecosystem. The widget is highly configurable, supports representative viewing for delegation scenarios, and works in tandem with its chart counterpart for flexible data visualization options.