@cplace/test-mcp-server 0.1.15 → 1.1.0

package/dist/widget-specifications/cf.cplace.cplaceReportGeneration.generateReportWidget/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.cplaceReportGeneration.generateReportWidget",
+  "Description": "{\"en\":\"Widget for generating and downloading Office reports\",\"de\":\"Widget zum Erzeugen und Herunterladen von Office Reports\"}",
+  "Localized Name": "{\"en\":\"Report Creation\",\"de\":\"Berichterstellung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.officeReports",
+  "App": "cf.cplace.officeReports.cplaceReportGeneration",
+  "Localized App Name": "{\"en\":\"cplace Report Generation\",\"de\":\"cplace Report Generation\"}",
+  "Repository": "cplace-office-reports",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.cplaceReportGeneration.generateReportWidget/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "files",
+    "reporting",
+    "low-code",
+    "searchable",
+    "connected"
+  ],
+  "requiredApp": "cf.cplace.officeReports.cplaceReportGeneration"
+}

package/dist/widget-specifications/cf.cplace.cplaceReportGeneration.generateReportWidget/_overview.md

@@ -0,0 +1,45 @@
+## Overview
+
+Widget for generating and downloading Office reports.
+
+This widget displays a button that triggers the generation of Office documents (Word, PowerPoint, or Excel) directly from cplace pages. When clicked, the widget initiates a background job that executes a Low-Code script to populate a pre-defined Office template with data from cplace, then makes the generated report available for download or automatically attaches it to a specified page.
+
+The widget relies on a Report Configuration page that defines the template, script, and report behavior. This separation allows the same report template to be reused with different data sources across multiple widget instances.
+
+## Use Cases
+
+- **On-Demand Report Generation**: Generate a formatted Office document based on the current page's data (e.g., project status report from a project page showing milestones, risks, and team members)
+- **Batch Report Generation**: Generate reports containing data from multiple pages matching search criteria (e.g., Excel report listing all active projects with their KPIs)
+- **Table Selection Reports**: Generate reports based on specific rows selected in a connected table widget
+- **Custom Reports with User Input**: Collect additional information via a dialog before generating the report (e.g., prompt for a reporting period or comment)
+- **Automated Document Attachment**: Generate reports and automatically attach them to pages for record-keeping
+
+## Design Considerations
+
+### Data Source Modes
+
+The widget supports three primary data source modes:
+
+1. **Search Mode**: The report script receives search results as a binding, allowing bulk reports from filtered data
+2. **Connected Table Mode**: The script accesses data from a connected table widget, optionally limited to selected rows
+3. **Direct Mode**: The script works only with the embedding page context
+
+### Output Options
+
+- Reports can be generated in their native Office format (DOCX, PPTX, XLSX) or converted to PDF
+- Generated files can be downloaded directly or automatically attached to pages
+- Fixed filenames enable document version history by overwriting existing files with the same name
+
+### Embedding Constraints
+
+This widget can only be embedded within AttributesGroup or ConnectedAttributesGroup widgets. It cannot be placed directly on a page layout.
+
+### Access Control
+
+The widget can be hidden dynamically by implementing access interceptors on the report handler. The widget automatically hides itself if the user lacks access to the Report Configuration.
+
+## Related Patterns
+
+- **cf.cplace.officeReports.headlineForReports**: Displays visual report type indicator on Report Configuration pages
+- **cf.cplace.officeReports.scriptPlaceholders**: Shows script-defined placeholders for Report Configuration pages
+- **cf.cplace.officeReports.templatePlaceholders**: Displays placeholders found in Office templates for Report Configuration pages

package/dist/widget-specifications/cf.cplace.cplaceReportGeneration.generateReportWidget/_summary.md

@@ -0,0 +1 @@
+Widget for generating and downloading Office reports (Word, PowerPoint, Excel) based on configurable templates and Low-Code scripts that pull data from cplace pages.

package/dist/widget-specifications/cf.cplace.ctts.main.employeeReportChart/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ctts.main.employeeReportChart",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Employees chart view Time Tracking\",\"de\":\"Mitarbeiter Chart Report Zeiterfassung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ctts.main",
+  "App": "cf.cplace.ctts.main",
+  "Localized App Name": "{\"en\":\"Timebooking\",\"de\":\"Zeitrückmeldung\"}",
+  "Repository": "cplace-ctts",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ctts.main.employeeReportChart/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "chart",
+    "time-series",
+    "filterable",
+    "dashboard",
+    "reporting",
+    "read-only"
+  ],
+  "requiredApp": "cf.cplace.ctts.main"
+}

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

@@ -0,0 +1,79 @@
+## Overview
+
+The Employee Chart View widget provides an interactive Highcharts visualization of time tracking data from an employee's perspective. It displays booked time hours aggregated by booking targets over a selected date range, allowing employees to analyze their time distribution across different work activities. The widget is part of the CTTS (cplace Time Tracking System) and presents time bookings broken down by target (projects, tasks, or other booking categories) across months.
+
+## Use Cases
+
+### Employee Time Overview
+Employees can view an aggregated overview of their own time bookings, visualize how they allocate time across different targets (projects, tasks, activities), and identify time distribution patterns over selected date ranges.
+
+### Time Booking Analysis
+Analyze time booking trends over months or years, compare time spent on different targets side-by-side, calculate total hours booked across all visible targets, and toggle visibility of individual target series to focus on specific areas of work.
+
+### Representative View
+Managers or authorized users can view time tracking data on behalf of other employees through "representative mode". This is particularly useful for supervisors reviewing team member time allocations or HR personnel accessing employee records.
+
+### 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, and provides a list of years where time bookings exist for quick selection.
+
+## Design Considerations
+
+### When to Use This Widget
+
+Use this widget when you need to:
+- Understand how an employee allocates time across different work targets
+- Identify trends, patterns, or anomalies in time distribution
+- Get a visual overview of time bookings without manually aggregating tabular data
+- Monitor individual time allocation for performance reviews or capacity planning
+- Analyze personal time tracking patterns for time management improvement
+
+### Chart vs. Grid
+
+The chart view prioritizes visual analysis and trend spotting over detailed data entry, making it ideal for overview and monitoring scenarios. For detailed tabular views with more granular data and customization options, use the Grid variant instead (`cf.cplace.ctts.main.employeeReportGrid`).
+
+### Permission Requirements
+
+Access to this widget is controlled at the app configuration level through group membership (defined in `ALLOWED_GROUPS`). Only authorized users can access this view. If a user is not in an allowed group, they will see a "View not allowed" message. Employees typically have access to view their own time tracking data.
+
+### Runtime Configuration
+
+Unlike the Grid variant, the Chart widget has no custom configuration options exposed during widget setup. Users configure the widget behavior at runtime through:
+- Date range selection (start/end year and month)
+- Representative selection (viewing reports for other employees if authorized)
+- Series visibility toggles (show/hide individual target series)
+- Standard Highcharts interactions (zoom, hover for details with percentages)
+
+### Chart Features
+
+The widget provides rich interactive features:
+- **Stacked Bar Chart**: Shows time bookings as stacked bars with each target as a separate series
+- **Total Hours Bar**: Automatically calculates and displays total hours per time period
+- **Interactive Legend**: Click legend items to show/hide specific targets
+- **Hover Tooltips**: Display detailed information including hours and percentages when hovering over chart elements
+- **Toggle All Button**: Quickly show or hide all target series at once
+- **Visible Target Sum**: Displays the sum of all currently visible targets (excluding the total bar)
+
+## Common Pitfalls
+
+- **Missing Data**: The widget requires time booking data to display meaningful information. The `availableYears` list is generated from existing bookings for the current user.
+- **Permission Issues**: Users must be members of groups defined in `ALLOWED_GROUPS` app configuration to access the widget.
+- **Configuration Expectations**: Unlike the Grid variant, this widget has no custom configuration options for widget setup. All configuration happens at runtime.
+- **Representative Mode Context**: The widget uses `RepresentativeMode.Employee_Reports` for storing representative selections, separate from project manager report contexts.
+
+## Related Patterns
+
+### Time Tracking Report Family
+
+This widget is part of a family of four time tracking report widgets:
+
+- **Employee Report Chart** (`cf.cplace.ctts.main.employeeReportChart`) - This widget; shows time bookings from an employee's perspective using `EMPLOYEE_VIEW` report type
+- **Employee Report Grid** (`cf.cplace.ctts.main.employeeReportGrid`) - Table-based view of employee time tracking data with more detailed, tabular information
+- **Project Leader Chart** (`cf.cplace.ctts.main.projectmanagerReportChart`) - Shows time bookings from a project manager's perspective using `PROJECT_VIEW` report type
+- **Project Leader Grid** (`cf.cplace.ctts.main.projectmanagerReportGrid`) - Table-based view for project managers with configuration options
+
+### Visualization Choice
+
+- **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
+
+All four report widgets share a common base architecture (`ReportWidgetSubstitution`) but differ in report type (`EMPLOYEE_VIEW` vs `PROJECT_VIEW`), representative storage context, and configuration options.

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

@@ -0,0 +1 @@
+Displays a chart-based visualization of time tracking data aggregated by targets over a selected date range from an employee's perspective. Use for analyzing time distribution across work targets and identifying time allocation trends over months or years.

package/dist/widget-specifications/cf.cplace.ctts.main.employeeReportGrid/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ctts.main.employeeReportGrid",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Employees table view Time Tracking\",\"de\":\"Mitarbeiter Tabelle Report Zeiterfassung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ctts.main",
+  "App": "cf.cplace.ctts.main",
+  "Localized App Name": "{\"en\":\"Timebooking\",\"de\":\"Zeitrückmeldung\"}",
+  "Repository": "cplace-ctts",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ctts.main.employeeReportGrid/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "time-series",
+    "table",
+    "read-only",
+    "filterable",
+    "sortable",
+    "reporting"
+  ],
+  "requiredApp": "cf.cplace.ctts.main"
+}

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

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

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

@@ -0,0 +1 @@
+Displays an interactive grid view of time tracking data for an individual employee, showing time bookings aggregated across booking targets (projects, tasks) over a configurable date range with monthly breakdowns.

package/dist/widget-specifications/cf.cplace.ctts.main.projectmanagerReportChart/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ctts.main.projectmanagerReportChart",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Project Leader chart view Time Tracking\",\"de\":\"Projektleiter Chart Report Zeiterfassung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ctts.main",
+  "App": "cf.cplace.ctts.main",
+  "Localized App Name": "{\"en\":\"Timebooking\",\"de\":\"Zeitrückmeldung\"}",
+  "Repository": "cplace-ctts",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ctts.main.projectmanagerReportChart/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "chart",
+    "time-series",
+    "filterable",
+    "dashboard",
+    "reporting",
+    "read-only"
+  ],
+  "requiredApp": "cf.cplace.ctts.main"
+}

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

@@ -0,0 +1,68 @@
+## Overview
+
+The Project Leader Chart View widget provides an interactive Highcharts visualization 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. The widget is part of the CTTS (cplace Time Tracking System) and presents time bookings broken down by project across months.
+
+## Use Cases
+
+### 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, and identify time distribution patterns over selected date ranges.
+
+### 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, and toggle visibility of individual project series to focus on specific projects.
+
+### Representative View
+Project managers can view time tracking data on behalf of other users through "representative mode" where authorized users can access reports for others. This is particularly useful for managers overseeing multiple team members' time allocations.
+
+### 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, and provides a list of years where time bookings exist for quick selection.
+
+## Design Considerations
+
+### When to Use This Widget
+
+Use this widget when you need to:
+- Understand how time is distributed across projects from a management perspective
+- Identify trends, imbalances, or anomalies in time allocation
+- Get a visual overview of time bookings without manually aggregating tabular data
+- Monitor team time allocation across multiple projects
+- Analyze time tracking patterns for strategic planning
+
+### Chart vs. Grid
+
+The chart view prioritizes visual analysis and trend spotting over detailed data entry, making it ideal for overview and monitoring scenarios. For detailed tabular views with more granular data and customization options, use the Grid variant instead (`cf.cplace.ctts.main.projectmanagerReportGrid`).
+
+### Permission Requirements
+
+Access to this widget is controlled at the app configuration level through group membership (defined in `ALLOWED_GROUPS`). Only authorized users (typically project managers) can access this view. If a user is not in an allowed group, they will see a "View not allowed" message.
+
+### Runtime Configuration
+
+Unlike the Grid variant, the Chart widget has no custom configuration options exposed during widget setup. Users configure the widget behavior at runtime through:
+- Date range selection (start/end year and month)
+- Representative selection (viewing reports for other users if authorized)
+- Series visibility toggles (show/hide individual project series)
+- Standard Highcharts interactions (zoom, hover for details)
+
+## Common Pitfalls
+
+- **Missing Data**: The widget requires time booking data to display meaningful information. The `availableYears` list is generated from existing bookings for the current user.
+- **Permission Issues**: Users must be members of groups defined in `ALLOWED_GROUPS` app configuration to access the widget.
+- **Configuration Expectations**: Unlike the Grid variant, this widget has no custom configuration options for widget setup. All configuration happens at runtime.
+
+## Related Patterns
+
+### Time Tracking Report Family
+
+This widget is part of a family of four time tracking report widgets:
+
+- **Employee Report Chart** (`cf.cplace.ctts.main.employeeReportChart`) - Shows time bookings from an employee's perspective using `EMPLOYEE_VIEW` report type
+- **Employee Report Grid** (`cf.cplace.ctts.main.employeeReportGrid`) - Table-based view of employee time tracking data
+- **Project Leader Chart** (`cf.cplace.ctts.main.projectmanagerReportChart`) - This widget; shows time bookings from a project manager's perspective using `PROJECT_VIEW` report type
+- **Project Leader Grid** (`cf.cplace.ctts.main.projectmanagerReportGrid`) - Table-based view with more detailed, tabular information and configuration for displaying additional person attributes
+
+### Visualization Choice
+
+- **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
+
+All four report widgets share a common base architecture (`ReportWidgetSubstitution`) but differ in report type, representative storage context, and configuration options.

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

@@ -0,0 +1 @@
+Displays a chart-based visualization of time tracking data aggregated by projects over a selected date range from a project manager's perspective. Use for analyzing time distribution across managed projects and identifying time allocation trends over months or years.

package/dist/widget-specifications/cf.cplace.ctts.main.projectmanagerReportGrid/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ctts.main.projectmanagerReportGrid",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Project Leader table view Time Tracking\",\"de\":\"Projektleiter Tabelle Report Zeiterfassung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ctts.main",
+  "App": "cf.cplace.ctts.main",
+  "Localized App Name": "{\"en\":\"Timebooking\",\"de\":\"Zeitrückmeldung\"}",
+  "Repository": "cplace-ctts",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ctts.main.projectmanagerReportGrid/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "time-series",
+    "table",
+    "filterable",
+    "reporting"
+  ],
+  "requiredApp": "cf.cplace.ctts.main"
+}

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

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

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

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

package/dist/widget-specifications/cf.cplace.ctts.main.widget/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ctts.main.widget",
+  "Description": null,
+  "Localized Name": "{\"en\":\"CTTS Timebooking\",\"de\":\"CTTS Zeiterfassung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ctts.main",
+  "App": "cf.cplace.ctts.main",
+  "Localized App Name": "{\"en\":\"Timebooking\",\"de\":\"Zeitrückmeldung\"}",
+  "Repository": "cplace-ctts",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ctts.main.widget/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "form",
+    "inline-edit",
+    "time-series",
+    "dashboard",
+    "detail-view",
+    "low-code"
+  ],
+  "requiredApp": "cf.cplace.ctts.main"
+}

package/dist/widget-specifications/cf.cplace.ctts.main.widget/_overview.md

@@ -0,0 +1,157 @@
+## Overview
+
+The CTTS (Collaborative Time Tracking System) Time Booking Widget is the primary interface for employees to enter, track, and manage their work hours across projects and activities. This widget provides an interactive grid-based interface where users can book time to various targets (projects, tasks, activities) on a daily, weekly, or monthly basis. It serves as the central data entry point for the entire CTTS time tracking ecosystem.
+
+## Key Features
+
+### Interactive Time Entry
+Users can enter time bookings in multiple formats:
+- **Hour and minute format** (e.g., 8:30)
+- **Decimal format** (e.g., 8.5 or 8,5 depending on locale)
+- **Configurable time increments** (1 second, 1 minute, 15 minutes, 30 minutes, 1 hour)
+
+### Multiple View Modes
+The widget supports different time period views:
+- **Daily View**: Granular day-by-day time entry
+- **Weekly View**: Week-at-a-glance with daily columns
+- **Monthly View**: Complete month overview with optional single-value entry per month
+
+### Calendar Integration
+- Visual calendar picker for easy date navigation
+- Week selection support (configurable clickable weeks)
+- "Today" button for quick navigation to current period
+- Highlights holidays and non-working days
+
+### Target Management
+- Add multiple booking targets (projects, activities, tasks)
+- Favorites system for frequently used targets
+- Subsequent booking support (booking to past periods with restrictions)
+- Workspace filtering (optionally restrict targets to current workspace)
+
+### Data Validation and Controls
+- **Maximum booking time per day** validation
+- **Overbooking limits** with warnings
+- **Negative bookings** support (if configured)
+- **Month locking/release** functionality for approval workflows
+- **Difference display** showing target vs. actual hours
+- **Real-time calculation** of daily and period totals
+
+### Representative Mode
+Users with appropriate permissions can book time on behalf of other employees (substitute/delegation functionality).
+
+## Use Cases
+
+### Daily Time Tracking
+An employee starts their workday and uses the widget to:
+1. Navigate to the current week
+2. Select projects from their favorites or add new targets
+3. Enter hours worked per project per day
+4. See real-time totals and ensure they don't exceed daily limits
+5. Save their time bookings at the end of the day or week
+
+### Project Time Allocation
+A consultant working on multiple client projects:
+1. Adds all active client projects to their booking grid
+2. Distributes their 8-hour workday across 3 different projects
+3. Uses the percentage distribution view to see time allocation patterns
+4. Reviews weekly totals to ensure project budgets are tracked correctly
+
+### Month-End Approval Workflow
+At the end of the month:
+1. Employee reviews all time bookings for the month
+2. Clicks "Release Month" to submit for approval
+3. Manager reviews released bookings in project manager report widgets
+4. If corrections needed, manager revokes release status
+5. Employee makes corrections and re-releases for approval
+
+### Substitute Time Entry
+An administrative assistant books time on behalf of team members:
+1. Selects a team member via representative mode
+2. Enters time bookings for that person
+3. Bookings are attributed to the selected employee
+4. Assistant can switch between multiple employees as needed
+
+### Subsequent Booking (Retroactive Entry)
+An employee realizes they forgot to book time from two weeks ago:
+1. Uses "Add Subsequent Booking" feature
+2. System checks if retroactive booking is within allowed time frame (e.g., last 2 months)
+3. Employee adds the missed booking target and enters historical time
+4. System validates against month locking rules
+
+## Design Considerations
+
+### When to Use This Widget
+- Primary time entry interface for employee time tracking
+- Need for flexible daily, weekly, or monthly time booking views
+- Requirements for time validation and approval workflows
+- Multi-project time allocation tracking
+- Integration with project management and billing systems
+
+### Configuration Decisions
+
+**View Mode Selection**
+- **Weekly View** (default): Best balance between overview and detail for most users
+- **Monthly View**: Suitable for high-level time tracking or simplified booking scenarios
+- **Daily View**: When granular control is needed, though less commonly used
+
+**Time Format**
+- **Punctual (0:00)**: More intuitive for users thinking in hours and minutes
+- **Decimal (0.00 or 0,00)**: Better for billing calculations and integrations
+
+**Validation Rules**
+Consider organizational policies:
+- Maximum daily hours (prevent overbooking)
+- Overbook tolerance (allow slight overages)
+- Negative bookings (corrections, time off)
+- Holiday booking restrictions
+- Month locking for approval cycles
+
+### Integration Patterns
+
+The CTTS Main Widget is the data source for:
+- **Employee Report Widgets** (`cf.cplace.ctts.main.employeeReportGrid`, `cf.cplace.ctts.main.employeeReportChart`): Display time bookings from employee perspective
+- **Project Manager Report Widgets** (`cf.cplace.ctts.main.projectmanagerReportGrid`, `cf.cplace.ctts.main.projectmanagerReportChart`): Aggregate time bookings by project
+- **Time Tracking Export**: Generate reports for billing, payroll, or compliance
+- **Project Capacity Planning**: Analyze resource allocation and availability
+
+## Common Pitfalls
+
+### Incorrect Permission Configuration
+The widget checks group membership via app configuration. Users without proper group assignment see "You cannot make time bookings because you are not a member of a group with editing rights." Ensure all users who need to book time are in the configured allowed groups.
+
+### Month Locking Confusion
+Released/locked months cannot be edited without revoking the release. This is by design for approval workflows, but can confuse users who try to make corrections to past months.
+
+### Workspace Filtering Unexpected Results
+When "Show data from this workspace only" is enabled, users may not see expected targets if those pages are in different workspaces. This is intentional for multi-tenant scenarios but can be surprising.
+
+### Time Format Mismatches
+Users might enter "8:30" when decimal format is configured, or vice versa. The widget validates format, but clear user communication about the expected format prevents frustration.
+
+### Subsequent Booking Time Limits
+Users attempting to book time beyond the configured subsequent booking limit (e.g., trying to book 3 months ago when limit is 2 months) will be blocked. The time limit must be configured appropriately for organizational needs.
+
+## Related Widgets
+
+### cf.cplace.ctts.main.employeeReportGrid
+Displays the same time booking data entered via the main widget, but from a reporting perspective focused on individual employee views. Use together to provide both data entry and analysis capabilities.
+
+### cf.cplace.ctts.main.projectmanagerReportGrid
+Shows aggregated time bookings by project for project manager oversight. The main widget creates the data that this reporting widget displays in project-centric views.
+
+### cf.cplace.ctts.main.employeeReportChart
+Chart-based visualization alternative to the employee report grid, showing the same employee-focused time tracking data in graphical format.
+
+### cf.cplace.ctts.main.projectmanagerReportChart
+Chart-based visualization alternative to the project manager report grid, providing graphical views of project time allocation.
+
+## Alternative Patterns
+
+### Simple Form Widget
+For basic time entry without advanced features like validation, approval workflows, or multi-project allocation, consider using `cf.cplace.simpleForm.widget` with custom time tracking attributes.
+
+### Table Widget with Inline Editing
+For read-heavy time tracking scenarios where most interaction is viewing rather than editing, an `embeddedSearchAsTable` with inline editing might be simpler than the full CTTS solution.
+
+### External Time Tracking Integration
+Organizations with existing time tracking systems (Jira, Toggl, Harvest) may prefer to integrate those systems via API rather than implementing CTTS for time entry.

package/dist/widget-specifications/cf.cplace.ctts.main.widget/_summary.md

@@ -0,0 +1 @@
+Interactive time booking grid for entering and managing work hours on projects and targets. Primary widget for employees to record daily time allocations across multiple projects with calendar and grid views.

package/dist/widget-specifications/cf.cplace.demoWidgets.demoRichString/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.demoWidgets.demoRichString",
+  "Description": "{\"en\":\"A widget without frame to enter formatted text with a title. (Editable only in layout.)\",\"de\":\"Ein Widget ohne Rahmen für die Eingabe von formatiertem Text. (Nur über die Einstellungen bearbeitbar.)\"}",
+  "Localized Name": "{\"en\":\"Text without widget frame\",\"de\":\"Text ohne Widget-Rahmen\"}",
+  "Icon": "fa-font",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Text without Widget Frame' widget can be used to display a formatted text on a cplace page. This widget does not have a frame.</p>\n\n<p>The text can only be edited in the 'Layout' mode.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title: Bilingual text. Only displayed on the 'Layout' but not on the 'View' tab.</p>\n\n<p>// * Content: A Wiki component for entering formatted text to be displayed by the widget.</p>\n\n<p>// * Height: The height of the widget in pixels.</p>"
+}