@cplace/mcp-server 1.6.0 → 1.6.1

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

@@ -1,230 +0,0 @@
-# Research: Employee Report Chart Widget
-
-**Widget ID:** `cf.cplace.ctts.main.employeeReportChart`
-**Repository:** `cplace-ctts`
-**Definition Class:** `cf.cplace.ctts.main/src/main/java/cf/cplace/ctts/main/script/EmployeeReportChartWidgetDefinition.java`
-**Widget Name:** "Employees chart view Time Tracking" (EN) / "Mitarbeiter Chart Report Zeiterfassung" (DE)
-
----
-
-## Purpose
-
-The Employee Report Chart Widget is a time tracking visualization widget that displays an employee's booked working hours across different targets (projects/tasks) over a specified time period in a stacked column chart format using Highcharts.
-
-**1-2 Sentence Description:**
-This widget displays a visual chart report of an employee's time bookings, showing working hours distributed across different booking targets (projects/tasks) over a configurable date range. It provides an interactive Highcharts-based visualization with the ability to filter series, view totals, and optionally view reports on behalf of other employees through a representative mode.
-
----
-
-## Use Cases
-
-### Primary Use Case: Employee Time Tracking Overview
-**Who:** Employees, managers, administrators
-**When:** When users need a visual overview of time spent across different projects/tasks
-**What:** Users can:
-- View time bookings aggregated by month across a selected date range
-- See hours distributed across different booking targets (projects, tasks, etc.)
-- Identify time allocation patterns and workload distribution
-- Track total working hours per month
-
-### Use Case: Representative/Substitute Reporting
-**Who:** Managers, administrators, team leads, substitutes
-**When:** When someone needs to view or manage time tracking on behalf of another employee
-**What:** Users with appropriate permissions can:
-- Select another employee to view their time tracking data
-- Generate reports for team members or substitutes
-- Return to their own time tracking view
-- This is useful for managers reviewing team time allocation or when covering for someone
-
-### Use Case: Time Period Analysis
-**Who:** All users
-**When:** When analyzing time allocation over specific periods
-**What:** Users can:
-- Select custom start and end months using date pickers
-- View historical time tracking data
-- Analyze trends across multiple months
-- Compare time distribution between different periods
-
-### Use Case: Target-Specific Analysis
-**Who:** All users
-**When:** When focusing on specific projects or tasks
-**What:** Users can:
-- Show/hide individual targets (projects/tasks) in the chart
-- Toggle all targets on/off at once
-- View the total hours for currently visible targets
-- Analyze time spent on specific projects by filtering out others
-
----
-
-## Configuration Concepts
-
-### Access Control
-- **Allowed Groups Configuration**: The widget respects access control based on group membership
-  - Configured through `MainAppConfiguration.ALLOWED_GROUPS`
-  - Users not in allowed groups see a warning message: "$(AlertMessageNotAllowed)$"
-  - Access is checked via `PrincipalTool.isPersonInGroup()`
-
-### Date Range Selection
-- **From/To Date Pickers**: Month-level granularity date selection
-  - Users can select start month/year and end month/year
-  - Date range is stored per user, per space, and per report type
-  - Managed by `ReportDateRangeStore` for persistence across sessions
-  - Available years are calculated based on user's booking history
-
-### Representative Mode
-- **Representative Storage**: `RepresentativeTool.EMPLOYEE_REPORTS`
-  - Separate storage for employee reports representative mode
-  - Allows viewing another employee's data
-  - Button toggles between "Select Representative" and "Own Time Management"
-  - Shows current representative's name when active
-  - Managed through `RepresentativeEditHandler` and `RepresentativeClearHandler`
-
-### Chart Visualization
-- **Highcharts Configuration**: Interactive stacked column chart
-  - X-axis: Months in selected date range (e.g., "January 2024", "February 2024")
-  - Y-axis: Working hours
-  - Series: Each booking target (project/task) as a separate series
-  - Total Hours bar: Aggregated total for each month
-  - Tooltips: Show hours and percentage per target when hovering
-  - Legend: Clickable to show/hide individual targets
-
-### Data Display Features
-- **Show/Hide Series**: Toggle button to display or hide all targets at once
-- **Total Visible Hours**: Dynamic calculation showing sum of currently visible target hours
-  - Updates when toggling series visibility
-  - Displayed in HH:MM format
-- **Series Filtering**: Click legend items to show/hide specific targets
-  - Total recalculates based on visible series
-
-### Time Tracking Export Integration
-- **Optional Export Functionality**: If configured, shows time tracking export button
-  - Configured through `TimeTrackingExportAppConfiguration.EXPORT_TEMPLATES`
-  - Allows exporting time tracking data in configured formats
-  - Handled by `TimeTrackingExportEditHandler`
-
----
-
-## Context and Relationships
-
-### Related Widgets
-This widget is part of a suite of time tracking reporting widgets:
-
-1. **EmployeeReportGridWidgetDefinition** (`cf.cplace.ctts.main.employeeReportGrid`)
-   - Grid/table view of the same employee time tracking data
-   - Provides detailed, editable tabular representation
-   - Complementary to the chart widget
-
-2. **ProjectmanagerReportChartWidgetDefinition** (`cf.cplace.ctts.main.projectmanagerReportChart`)
-   - Similar chart widget but from project manager perspective
-   - Shows time bookings across employees for specific projects
-   - Uses similar chart rendering but different data aggregation
-
-3. **ProjectmanagerReportGridWidgetDefinition** (`cf.cplace.ctts.main.projectmanagerReportGrid`)
-   - Grid view for project manager reports
-
-4. **MainWidgetDefinition** (`cf.cplace.ctts.main.main`)
-   - Main time tracking widget for day-to-day time entry
-   - Source of the data visualized in this report widget
-
-### Data Flow
-1. **Data Source**: Time bookings stored in database (table with columns: `udate`, `utarget`, `uuser`, `ubookedtime`)
-2. **Backend Handler**: `ReportHandler` processes AJAX requests
-   - Calls `ReportEmployeeManager.generateReportData()` for EMPLOYEE_VIEW report type
-   - Aggregates bookings by month and target
-   - Returns `EmployeeReportResponseData` as JSON
-3. **Frontend Controller**: `CttsEmployeeChartCtrl` manages chart display
-   - Requests data via `CttsReportDataService`
-   - Builds Highcharts visualization
-   - Handles user interactions (date changes, series toggling, representative selection)
-
-### Prerequisites
-- **CTTS Plugin**: Part of the cplace Time Tracking System (CTTS)
-- **User Permissions**: Users must be in configured allowed groups
-- **Time Bookings**: Requires existing time booking data to display
-- **Page Context**: Widget must be embedded in a page within a workspace/space
-
-### Technology Stack
-- **Backend**: Java (widget definition, data handlers)
-- **Frontend**: AngularJS (directive, controller)
-- **Charting**: Highcharts library
-- **Templating**: cplace template system with HTM templates
-- **Data Transport**: JSON via AJAX handlers
-
----
-
-## Technical Implementation Notes
-
-### Key Classes and Files
-
-**Backend (Java):**
-- `EmployeeReportChartWidgetDefinition.java` - Widget definition class
-- `ReportWidgetSubstitution.java` - Template substitution base class
-- `ReportHandler.java` - HTTP handler for report data requests
-- `ReportEmployeeManager.java` - Business logic for employee report generation
-- `RepresentativeTool.java` - Manages representative/substitute mode
-
-**Frontend (TypeScript/JavaScript):**
-- `cfCplaceCttsEmployeeChart.ts` - AngularJS directive
-- `CttsEmployeeChartCtrl.ts` - Chart controller logic
-- `CttsReportDataService.ts` - Service for data fetching and state management
-
-**Templates:**
-- `employeeReportChartWidgetDefinition.htm` - Widget wrapper template
-- `angularTemplates.htm` - Contains Angular template at `/cf.cplace.ctts.main/cfCplaceCttsEmployeeChart`
-
-**Translations:**
-- `messages_en.properties` / `messages_de.properties` - Localized strings
-
-### Configuration Points
-
-1. **Access Control**: `MainAppConfiguration.ALLOWED_GROUPS`
-2. **Export Templates**: `TimeTrackingExportAppConfiguration.EXPORT_TEMPLATES` (optional)
-3. **Report Type**: Fixed to `ReportTypes.EMPLOYEE_VIEW` for this widget
-4. **Representative Storage**: Uses `RepresentativeTool.EMPLOYEE_REPORTS` storage instance
-
-### Key Features Summary
-
-| Feature | Description |
-|---------|-------------|
-| Chart Type | Stacked column chart (Highcharts) |
-| Date Range | Month-level selection, stored per user |
-| Series | One per booking target + total hours |
-| Interactivity | Toggle series, hover tooltips, legend filtering |
-| Representative Mode | View other employees' data with permissions |
-| Data Refresh | Automatic on date change or save events |
-| Localization | Full i18n support (EN/DE confirmed) |
-| Export | Optional integration with time tracking export |
-
----
-
-## Recommendations for Documentation
-
-When creating end-user documentation, consider:
-
-1. **Visual Examples**: Include screenshots showing:
-   - The chart with multiple targets
-   - Date range selection interface
-   - Representative mode selection
-   - Toggle series functionality
-   - Tooltip display on hover
-
-2. **Workflow Documentation**: Document common workflows:
-   - How to select a date range
-   - How to view reports for team members (representative mode)
-   - How to focus on specific projects by hiding others
-   - How to interpret the total hours display
-
-3. **Permission Requirements**: Clearly explain:
-   - Which user groups can access the widget
-   - Who can use representative mode
-   - Any workspace/space-level permissions needed
-
-4. **Relationship to Other Widgets**: Explain:
-   - Difference between chart and grid views
-   - How this relates to the main time tracking widget
-   - When to use employee vs. project manager reports
-
-5. **Troubleshooting**: Address common issues:
-   - No data displayed (no bookings in selected period)
-   - Access denied messages (group membership)
-   - Representative mode not available (permissions)

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

@@ -1,215 +0,0 @@
-# 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

@@ -1,192 +0,0 @@
-# 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"