@cplace/mcp-server 1.6.0 → 1.6.1

package/dist/plugins/core-app-catalog/cf.cplace.projectPlanning.app.advanced.advancedScheduleManagement/README.md

@@ -0,0 +1,150 @@
+# Schedule Mgmt. (Advanced) (cf.cplace.projectPlanning.app.advanced.advancedScheduleManagement)
+
+## Overview
+
+Enables schedule management for complex use cases, including collaboration features such as subscriptions and cross-schedule links. This app extends the basic schedule management capabilities with advanced features for multi-schedule collaboration.
+
+**Icon:** `cf cf-gantt-square-o`
+
+## Dependencies
+
+Installing this app automatically installs the following dependencies:
+
+| App | Qualified Name | Description |
+|-----|----------------|-------------|
+| cplace Basis | `cf.cplace.platform` | Base platform (always installed) |
+| Schedule Mgmt. (Basic) | `cf.cplace.projectPlanning.app.basic.basicScheduleManagement` | Provides the core Schedule, Task, and Milestone types |
+| New Gantt | `cf.cplace.projectPlanning.app.gantt2.gantt2` | Provides the "New Gantt" widget for visualization |
+| Load Multiple Schedules | `cf.cplace.projectPlanning.app.configureRootNodes.configureGantt2Roots` | Enables loading multiple schedules into the New Gantt widget |
+
+## Types Provided
+
+The types are provided by the dependency **Schedule Mgmt. (Basic)** (`cf.cplace.projectPlanning.app.basic.basicScheduleManagement`), but the Advanced app adds the `allowSubscription` attribute to enable cross-schedule collaboration.
+
+### cf.schedule (Schedule)
+
+The root planning container that holds tasks and milestones.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Start | `startDate` | Date | No | The schedule starts in the morning of the specified day |
+| Finish | `endDate` | Date | No | The schedule finishes in the evening of the specified day |
+| Duration | `duration` | Number | Yes | Total duration of the schedule |
+| Duration Unit | `durationUnit` | Enumeration | Yes | Unit for duration (days, weeks, etc.) |
+| % Completed | `percentComplete` | Number | Yes | Progress percentage (0-100) |
+| Calendar Week Start | `startDateCalendarWeek` | Text | No | Calendar week of start date |
+| Calendar Week Finish | `endDateCalendarWeek` | Text | No | Calendar week of finish date |
+| Calendar ID | `calendarId` | Text | Yes | Reference to working calendar |
+| Gantt Version | `cf.cplace.gantt.ganttVersion` | Text | No | If "2.0", uses New Gantt widget |
+| Task Class | `activityClass` | Reference | No | Default visual styling for tasks |
+| Allow Subscribing | `allowSubscription` | Boolean | Yes | **Advanced feature:** Enable cross-schedule subscriptions |
+| Last Calculation | `lastCalculation` | Number | No | Timestamp of last schedule recalculation |
+
+### cf.activity (Task)
+
+Work items with duration that can be nested hierarchically within a schedule.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Parent object | `parent` | Reference | Yes | Parent task or schedule |
+| Schedule | `containingSchedule` | Reference | No | The schedule this task belongs to |
+| Start | `startDate` | Date | No | Task starts in the morning of this day |
+| Finish | `endDate` | Date | No | Task finishes in the evening of this day |
+| Duration | `duration` | Number | Yes | Task duration |
+| Duration Unit | `durationUnit` | Enumeration | Yes | Unit for duration |
+| % Completed | `percentComplete` | Number | Yes | Progress percentage |
+| Automatically scheduled | `automaticScheduling` | Boolean | No | Auto-reschedule when predecessors change |
+| Calendar Week Start | `startDateCalendarWeek` | Text | No | Calendar week of start date |
+| Calendar Week Finish | `endDateCalendarWeek` | Text | No | Calendar week of finish date |
+| Calendar ID | `calendarId` | Text | Yes | Working calendar reference |
+| Task Class | `activityClass` | Reference | No | Visual styling reference |
+
+### cf.milestone (Milestone)
+
+Point-in-time events marking significant dates in the schedule.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Parent object | `parent` | Reference | Yes | Parent task or schedule |
+| Schedule | `containingSchedule` | Reference | No | The schedule this milestone belongs to |
+| Date | `date` | Date | No | The milestone date |
+| % Completed | `percentComplete` | Number | Yes | Completion status (0 or 100) |
+| Automatically scheduled | `automaticScheduling` | Boolean | No | Auto-reschedule when predecessors change |
+| Calendar Week Date | `dateCalendarWeek` | Text | No | Calendar week of the date |
+| Calendar ID | `calendarId` | Text | Yes | Working calendar reference |
+| Task Class | `activityClass` | Reference | No | Visual styling reference |
+
+## Widgets Provided
+
+The **Advanced Schedule Management** app itself does not provide widgets directly, but brings in powerful widgets through its dependencies:
+
+### From New Gantt (`cf.cplace.projectPlanning.app.gantt2.gantt2`)
+
+| Widget | Kind | Description |
+|--------|------|-------------|
+| New Gantt | `cf.projektplanung.gantt` | Interactive Gantt chart for visualization and editing of planning elements. Built on Bryntum Gantt framework with drag-and-drop scheduling, dependency management, and hierarchical task structures. |
+
+### Platform Widgets (Always Available)
+
+Standard table, attribute, and chart widgets from `cf.cplace.platform` can be used to display schedule data.
+
+## Advanced Features
+
+### Subscriptions (Cross-Schedule Links)
+
+The key differentiator of the Advanced app is the **subscription** capability:
+
+- **What it does:** Allows planning elements (tasks, milestones) in one schedule to "subscribe" to elements in another schedule
+- **Use case:** Cross-project dependencies, portfolio-level milestone tracking
+- **Configuration:** Enable via `allowSubscription` attribute on the Schedule
+
+### Multi-Schedule Loading
+
+Through the `configureGantt2Roots` dependency:
+- Load and visualize multiple schedules simultaneously in the New Gantt widget
+- Useful for program-level views and cross-project analysis
+
+## Usage Notes
+
+### When to Use This App
+
+- **Complex project portfolios** with cross-project dependencies
+- **Program management** requiring visibility across multiple schedules
+- **Collaborative planning** where different teams need to reference each other's milestones
+- **Enterprise scheduling** with subscription-based dependency tracking
+
+### When Basic Is Sufficient
+
+Use **Schedule Mgmt. (Basic)** instead if you only need:
+- Single-schedule project planning
+- Standard Gantt visualization
+- No cross-schedule dependencies
+
+### Related Apps to Consider
+
+| App | Purpose |
+|-----|---------|
+| Project Planning (Basic) | Adds the original Gantt widget and structured table for schedules |
+| Project Planning (Extended) | Adds the Subscriptions widget for viewing cross-schedule references |
+| Task Classes | Visual categorization of tasks/milestones with colors and shapes |
+| Project Structure | Hierarchical organization of projects and schedules |
+| Building Blocks | Reusable schedule templates |
+
+## Type Hierarchy
+
+```
+Schedule (cf.schedule)
+├── Task (cf.activity) [can nest]
+│   ├── Task (cf.activity)
+│   ├── Milestone (cf.milestone)
+│   └── ...
+└── Milestone (cf.milestone)
+```
+
+Tasks can be nested to create work breakdown structures. Both tasks and milestones reference their containing schedule via `containingSchedule`.
+
+## Investigation Details
+
+- **Investigation Date:** 2026-02-02
+- **Workspace ID:** syar11emvu1nb0iqfh9vmw8sm
+- **Workspace Name:** [App Investigation] cf.cplace.projectPlanning.app.advanced.advancedScheduleManagement

package/dist/plugins/core-app-catalog/cf.cplace.projectPlanning.app.basic.basicScheduleManagement/README.md

@@ -0,0 +1,135 @@
+# Schedule Mgmt. (Basic) (cf.cplace.projectPlanning.app.basic.basicScheduleManagement)
+
+## Overview
+
+Enables schedule management for basic use cases with the types "Schedule", "Task", and "Milestone". This app provides the foundational data model for project scheduling in cplace, allowing users to create hierarchical project plans with tasks and milestones that can be visualized in Gantt charts.
+
+**Icon:** `cf cf-gantt-square-o`
+
+## Dependencies
+
+When this app is installed, the following apps are automatically installed:
+
+| App | Qualified Name | Description |
+|-----|----------------|-------------|
+| New Gantt | `cf.cplace.projectPlanning.app.gantt2.gantt2` | Provides the "New Gantt" widget for visualizing and editing planning elements |
+| cplace Basis | `cf.cplace.platform` | Base platform (always installed) |
+
+## Types Provided
+
+### cf.schedule (Schedule / Plan)
+
+The root container for project planning. A Schedule represents a complete project plan that contains tasks and milestones.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Start | `startDate` | Date | No | The schedule starts in the morning of the specified day |
+| Calendar Week Start | `startDateCalendarWeek` | Text | No | Calendar week of start date |
+| Finish | `endDate` | Date | No | The schedule finishes in the evening of the specified day |
+| Calendar Week Finish | `endDateCalendarWeek` | Text | No | Calendar week of finish date |
+| Duration | `duration` | Number | Yes | Duration of the schedule |
+| Duration Unit | `durationUnit` | Text | Yes | Unit for duration (e.g., days, weeks) |
+| Calendar ID | `calendarId` | Text | Yes | Working calendar for schedule calculation |
+| % Completed | `percentComplete` | Number | Yes | Overall progress percentage |
+| Gantt Version | `cf.cplace.gantt.ganttVersion` | Text | No | If value is "2.0", schedule loads in New Gantt Widget |
+| Last Calculation | `lastCalculation` | Number | No | Timestamp of last re-calculation in ms |
+
+**Icon:** `cf-gantt-square-o`
+
+---
+
+### cf.activity (Task / Vorgang)
+
+Represents a work item with duration within a schedule. Tasks can be nested hierarchically and linked with dependencies.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Parent object | `parent` | Reference | Yes | Parent task or schedule |
+| Schedule | `containingSchedule` | Reference | No | The containing schedule |
+| Automatically scheduled | `automaticScheduling` | Boolean | No | Reschedule when predecessor dates change |
+| Start | `startDate` | Date | No | Task starts in the morning of the specified day |
+| Calendar Week Start | `startDateCalendarWeek` | Text | No | Calendar week of start date |
+| Finish | `endDate` | Date | No | Task finishes in the evening of the specified day |
+| Calendar Week Finish | `endDateCalendarWeek` | Text | No | Calendar week of finish date |
+| Duration | `duration` | Number | Yes | Duration of the task |
+| Duration Unit | `durationUnit` | Text | Yes | Unit for duration |
+| Calendar ID | `calendarId` | Text | Yes | Working calendar for task calculation |
+| % Completed | `percentComplete` | Number | Yes | Task progress percentage |
+
+**Icon:** `fa-tasks`
+
+---
+
+### cf.milestone (Milestone / Meilenstein)
+
+Represents a significant point in time within a schedule, typically marking the completion of a phase or deliverable.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Parent object | `parent` | Reference | Yes | Parent task or schedule |
+| Schedule | `containingSchedule` | Reference | No | The containing schedule |
+| Automatically scheduled | `automaticScheduling` | Boolean | No | Reschedule when predecessor dates change |
+| Date | `date` | Date | No | The milestone date |
+| Calendar Week Date | `dateCalendarWeek` | Text | No | Calendar week of the milestone |
+| Calendar ID | `calendarId` | Text | Yes | Working calendar reference |
+| % Completed | `percentComplete` | Number | Yes | Milestone completion status (0 or 100) |
+
+**Icon:** `cf-milestone`
+
+## Widgets Provided
+
+This app itself does not define widgets. Visualization is provided through the **New Gantt** widget from the dependency app:
+
+| Widget | Kind | Required App | Description |
+|--------|------|--------------|-------------|
+| New Gantt | `cf.projektplanung.gantt` | `cf.cplace.projectPlanning.app.gantt2.gantt2` | Interactive Gantt chart for visualizing and editing schedules, tasks, and milestones with drag-and-drop support |
+
+## Type Hierarchy
+
+```
+Schedule (cf.schedule)
+  |
+  +-- Task (cf.activity) [via parent attribute]
+  |     |
+  |     +-- Task (nested, via parent)
+  |     +-- Milestone (via parent)
+  |
+  +-- Milestone (cf.milestone) [via parent attribute]
+```
+
+## Usage Notes
+
+### When to Use This App
+
+- **Basic project planning**: When you need simple schedule management with tasks and milestones
+- **Gantt visualization**: When you want to display project timelines in a Gantt chart
+- **Standalone schedules**: When projects are independent and don't require cross-project references
+
+### Common Patterns
+
+1. **Create a Schedule first**, then add Tasks and Milestones as children
+2. **Use the `parent` attribute** to build hierarchical task structures (Work Breakdown Structure)
+3. **Enable automatic scheduling** (`automaticScheduling`) to propagate date changes through dependencies
+4. **Set Gantt Version to "2.0"** on the Schedule to use the New Gantt widget
+
+### Limitations
+
+- No built-in support for cross-schedule dependencies (use Schedule Mgmt. (Advanced) for that)
+- No resource assignment capabilities (use Resource Management app for that)
+- No task class styling (use Task Classes app for visual categorization)
+
+### Related Apps
+
+| App | Purpose |
+|-----|---------|
+| Schedule Mgmt. (Advanced) | Adds subscriptions for cross-schedule references |
+| Task Classes | Visual categorization of tasks in Gantt |
+| Project Structure | Hierarchical project organization |
+| Resource Management | Resource assignment and planning |
+| Project Planning (Basic) | Alternative scheduling approach with additional widgets |
+
+## Investigation Details
+
+- **Investigated on:** 2026-02-02
+- **Workspace used:** `[App Investigation] cf.cplace.projectPlanning.app.basic.basicScheduleManagement`
+- **Workspace ID:** `w3ra47lbuvtmxepdli4dq2a0v`

package/dist/plugins/core-app-catalog/cf.cplace.projectPlanning.app.gantt2.gantt2/README.md

@@ -0,0 +1,73 @@
+# New Gantt (cf.cplace.projectPlanning.app.gantt2.gantt2)
+
+## Overview
+
+The New Gantt app provides the "New Gantt" widget, which enables the visualization and editing of planning elements and hybrid elements. It is built on the Bryntum Gantt framework and offers modern, interactive Gantt chart capabilities.
+
+**Important**: This app provides **only a widget** - no types are included. It requires existing schedule/task types (typically from Project Planning apps) to display and edit.
+
+## Dependencies
+
+- **cf.cplace.platform** (cplace Basis) - always installed
+
+No additional apps are auto-installed with this app.
+
+## Types Provided
+
+**None** - This app does not provide any types. It is a pure widget app that works with existing schedule and planning types from other apps (such as Project Planning Basic/Extended).
+
+## Widgets Provided
+
+| Widget | Internal Name | Description | Use Case |
+|--------|---------------|-------------|----------|
+| New Gantt / Neues Gantt | `cf.projektplanung.gantt` | Interactive Gantt chart for visualizing and editing planning elements | Project scheduling, timeline visualization, dependency management |
+
+### Widget Details: New Gantt (`cf.projektplanung.gantt`)
+
+**Capabilities:**
+- Visualization of planning elements (tasks, milestones) and hybrid elements
+- Drag-and-drop scheduling
+- Dependency management between tasks
+- Hierarchical task structures with expand/collapse
+- Real-time synchronization with cplace backend
+- Built on Bryntum Gantt framework
+
+**Required Context:**
+This widget requires schedule/planning types to be present in the workspace. Typically used with:
+- Schedule Management (Basic) - `cf.cplace.projectPlanning.app.basic.basicScheduleManagement`
+- Schedule Management (Advanced) - `cf.cplace.projectPlanning.app.advanced.advancedScheduleManagement`
+- Project Planning (Basic) - `cf.cplace.projektplanung.projektplanungBasic`
+
+**Comparison to Other Gantt Widgets:**
+- `cf.projektplanung.singleGantt` (Gantt-Diagramm) - Single schedule view, part of Project Planning (Basic)
+- `cf.projektplanung.multiGantt` (Multi-Gantt-Diagramm) - Multiple schedules, part of Project Planning (Basic)
+- `cf.projektplanung.gantt` (New Gantt) - Modern Bryntum-based widget, this app
+
+## Usage Notes
+
+### When to Use
+
+- When you need a modern, interactive Gantt chart experience
+- When you want Bryntum-based features like smooth drag-and-drop
+- When working with complex task hierarchies and dependencies
+- As an upgrade path from the legacy Gantt widgets
+
+### Prerequisites
+
+This app should be installed **after** a project planning app that provides the necessary types:
+1. Install a schedule/project planning app (e.g., `cf.cplace.projectPlanning.app.basic.basicScheduleManagement`)
+2. Install this app (`cf.cplace.projectPlanning.app.gantt2.gantt2`)
+3. Configure the widget on schedule pages
+
+### Typical Installation Combinations
+
+| Use Case | Apps to Install |
+|----------|-----------------|
+| Basic scheduling with new Gantt | `cf.cplace.projectPlanning.app.basic.basicScheduleManagement` + `cf.cplace.projectPlanning.app.gantt2.gantt2` |
+| Advanced scheduling with new Gantt | `cf.cplace.projectPlanning.app.advanced.advancedScheduleManagement` + `cf.cplace.projectPlanning.app.gantt2.gantt2` |
+| Full project planning | `cf.cplace.projektplanung.projektplanungBasic` + `cf.cplace.projectPlanning.app.gantt2.gantt2` |
+
+---
+
+*Investigation performed: 2026-02-02*
+*Workspace used: `[App Investigation] cf.cplace.projectPlanning.app.gantt2.gantt2` (ID: 85g6k7lxl8v3bdi6qfxdm0r8c)*

package/dist/plugins/core-app-catalog/cf.cplace.projectTree/README.md

@@ -0,0 +1,96 @@
+# Project Structure (cf.cplace.projectTree)
+
+## Overview
+
+The **Project Structure** app adds the app-specific type "Project" and allows schedules to be organized in a project structure. Additionally, the app enables new projects and schedules to be created within this project structure - based on a template, if required.
+
+This app is useful for organizing work into a hierarchical project portfolio structure, allowing users to group related schedules under projects and sub-projects.
+
+## Dependencies
+
+- **cf.cplace.platform** (cplace Basis) - Always installed as the base platform
+
+No additional dependencies are required. This app is self-contained and does not pull in any other apps.
+
+## Types Provided
+
+### cf.projectNavigator.project (Project)
+
+A container type for organizing schedules and sub-projects in a hierarchical structure.
+
+| Attribute | Internal Name | Type | Multiplicity | Description |
+|-----------|---------------|------|--------------|-------------|
+| Parent Project | `parent` | Reference (self-referencing) | Single | The parent project in the hierarchy. Access rights propagate from parent to child. |
+| Links to Other Projects | `additionalProjectLinks` | Reference (self-referencing) | Multiple | References to related projects for highlighting thematic relationships. These are informational only and do not affect access rights propagation. Optionally shown in the project tree under referenced projects. |
+
+**Type Properties:**
+- **Icon:** `fas fa-folder`
+- **Show in Explorer:** No
+- **Show in Global Search:** Yes
+- **Names are Unique:** No
+
+## Widgets Provided
+
+| Widget | Internal Name | Description | Use Case |
+|--------|---------------|-------------|----------|
+| Edit Project Structure | `cf.cplace.projectTree.editProjects` | Interactive tree view for creating and managing schedules and projects | Main widget for visualizing and editing the project hierarchy with drag-and-drop reorganization and context menu actions |
+
+### Edit Project Structure Widget Details
+
+**Widget:** `cf.cplace.projectTree.editProjects`
+
+- **Name:** Edit Project Structure / Projektstruktur bearbeiten
+- **Icon:** `cf-widget`
+- **Capabilities:**
+  - Displays hierarchical project structure as a tree
+  - Drag-and-drop reorganization of projects and schedules
+  - Context menu actions for creating subprojects and schedules
+  - Template-based creation support
+
+## Usage Notes
+
+### When to Use This App
+
+- **Portfolio Management:** When you need to organize multiple schedules under a hierarchical project structure
+- **Program/Project Hierarchy:** For creating multi-level project portfolios (Portfolio > Program > Project > Schedule)
+- **Access Rights Propagation:** When you want access rights to automatically flow from parent projects to children
+- **Cross-Project Linking:** When projects have thematic relationships that should be visible but don't affect permissions
+
+### Common Patterns
+
+1. **Simple Hierarchy:**
+   ```
+   Portfolio (Project)
+   ├── Program A (Project)
+   │   ├── Project A.1 (Project)
+   │   │   └── Schedule A.1.1
+   │   └── Project A.2 (Project)
+   │       └── Schedule A.2.1
+   └── Program B (Project)
+       └── Project B.1 (Project)
+           └── Schedule B.1.1
+   ```
+
+2. **With Cross-Project Links:**
+   - A project can reference other projects via `additionalProjectLinks` to show thematic relationships
+   - These links are informational and can optionally appear in the tree view
+   - Access rights are NOT propagated through these links
+
+### Integration with Other Apps
+
+This app is commonly used together with:
+- **Project Planning (Basic)** (`cf.cplace.projektplanung.projektplanungBasic`) - Provides Schedule, Task, and Milestone types
+- **Project Planning (Extended)** (`cf.cplace.projektplanung.projektplanungExtended`) - Advanced scheduling features
+- **New Gantt** (`cf.cplace.projectPlanning.app.gantt2.gantt2`) - Gantt visualization
+
+### Limitations
+
+- The app only provides the Project type and tree editing widget
+- Schedules must come from a Project Planning app (not included)
+- Without a Project Planning app installed, the tree widget can only manage Projects, not schedules
+
+## Investigation Details
+
+- **Investigated:** 2026-02-02
+- **Investigation Workspace:** `[App Investigation] cf.cplace.projectTree` (ID: `fv6dpuskn9paff2y3lvkwpwo0`)
+- **Platform Version:** cplace (current)

package/dist/plugins/core-app-catalog/cf.cplace.projektplanung.projektplanungBasic/README.md

@@ -0,0 +1,143 @@
+# Project Planning (Basic) (cf.cplace.projektplanung.projektplanungBasic)
+
+## Overview
+
+The "Project Planning (Basic)" app provides core Gantt chart functionality for managing schedules in cplace. It offers the fundamental planning elements: Schedule, Milestone, and Task. The app includes widgets for visualizing these elements in both single-schedule and multi-schedule Gantt charts, as well as a structured table view for editing task properties.
+
+**Key Capabilities:**
+- Classic Gantt chart visualization
+- Schedule, Milestone, and Task management
+- Hierarchical task structures (parent-child relationships)
+- Progress tracking (% complete)
+- RAG (Red-Amber-Green) rating for status
+- Calendar week display for dates
+- Multi-schedule visualization for portfolio views
+
+## Dependencies
+
+When installed, this app brings in:
+- **cf.cplace.platform** (cplace Basis) - Always present, base platform
+
+No additional dependencies are auto-installed beyond the base platform.
+
+## Types Provided
+
+### cf.schedule (Schedule / Plan)
+
+The container for a project schedule. Holds overall timeline and aggregated metrics.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Start | `startDate` | Date | No | The schedule starts in the morning of the specified day |
+| Calendar Week Start | `startDateCalendarWeek` | Number | No | Calendar week of start date |
+| Finish | `endDate` | Date | No | The schedule finishes in the evening of the specified day |
+| Calendar Week Finish | `endDateCalendarWeek` | Number | No | Calendar week of finish date |
+| Duration | `duration` | Number | Yes | Duration of the schedule |
+| Duration Unit | `durationUnit` | Text | Yes | Unit for duration (days, weeks, etc.) |
+| Calendar ID | `calendarId` | Text | Yes | Identifier for the working calendar |
+| % Completed | `percentComplete` | Number | Yes | Overall completion percentage |
+| RAG Rating | `ratingLight` | Enumeration | No | Status indicator (Red/Amber/Green) |
+| Note | `note` | Rich Text | No | Additional notes |
+| Print Profile | `printProfile` | Reference | No | Default profile for Presentation Graphics export |
+| Gantt Version | `cf.cplace.gantt.ganttVersion` | Text | No | If "2.0", loads in New Gantt Widget |
+| Last Calculation | `lastCalculation` | Number | No | Timestamp of last schedule recalculation (ms) |
+
+**Icon:** `cf-gantt-square-o`
+
+---
+
+### cf.milestone (Milestone / Meilenstein)
+
+A point-in-time marker within a schedule, typically representing a significant event or deliverable.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Parent object | `parent` | Reference | Yes | Parent task or schedule |
+| Schedule | `containingSchedule` | Reference | No | The schedule containing this milestone |
+| Date | `date` | Date | No | The milestone is in the evening of the specified day |
+| Calendar Week Date | `dateCalendarWeek` | Number | No | Calendar week of the date |
+| Calendar ID | `calendarId` | Text | Yes | Identifier for the working calendar |
+| % Completed | `percentComplete` | Number | Yes | Completion status (typically 0% or 100%) |
+| RAG Rating | `ratingLight` | Enumeration | No | Status indicator (Red/Amber/Green) |
+| Automatically scheduled | `automaticScheduling` | Boolean | No | Should date be rescheduled when predecessors change? |
+| Note | `note` | Rich Text | No | Additional notes |
+
+**Icon:** `cf-milestone`
+
+---
+
+### cf.activity (Task / Vorgang)
+
+A work item with start and end dates, representing actual work to be done.
+
+| Attribute | Internal Name | Type | Required | Description |
+|-----------|---------------|------|----------|-------------|
+| Parent object | `parent` | Reference | Yes | Parent task or schedule |
+| Schedule | `containingSchedule` | Reference | No | The schedule containing this task |
+| Start | `startDate` | Date | No | The task starts in the morning of the specified day |
+| Calendar Week Start | `startDateCalendarWeek` | Number | No | Calendar week of start date |
+| Finish | `endDate` | Date | No | The task finishes in the evening of the specified day |
+| Calendar Week Finish | `endDateCalendarWeek` | Number | No | Calendar week of finish date |
+| Duration | `duration` | Number | Yes | Task duration |
+| Duration Unit | `durationUnit` | Text | Yes | Unit for duration (days, weeks, etc.) |
+| Calendar ID | `calendarId` | Text | Yes | Identifier for the working calendar |
+| % Completed | `percentComplete` | Number | Yes | Task completion percentage |
+| RAG Rating | `ratingLight` | Enumeration | No | Status indicator (Red/Amber/Green) |
+| Automatically scheduled | `automaticScheduling` | Boolean | No | Should dates be rescheduled when predecessors change? |
+| Note | `note` | Rich Text | No | Additional notes |
+
+**Icon:** `fa-tasks`
+
+## Widgets Provided
+
+| Widget | Internal Name | Description | Use Case |
+|--------|---------------|-------------|----------|
+| **Gantt chart** | `cf.projektplanung.singleGantt` | Displays a Gantt chart of all tasks and milestones for a single schedule | Primary schedule visualization; automatically detects schedule context from page hierarchy |
+| **Multi Gantt Chart** | `cf.projektplanung.multiGantt` | Displays multiple schedules simultaneously in one Gantt view | Portfolio dashboards, executive summaries, cross-project views |
+| **Structured Table for Schedules** | `cf.projektplanung.scheduleTreeTable` | Tree table showing tasks and milestones with inline editing | Spreadsheet-like editing of task properties while maintaining hierarchy |
+| **Open Gantt Chart** | `cf.projektplanung.singleGanttLink` | Button that opens the Gantt chart in a new browser tab | Overview pages; provides quick access without full widget overhead |
+| **Schedule Edit State** | `cf.cplace.projektplanung.scheduleLockState` | Shows who is editing a schedule and provides lock management | Collaborative editing; prevents conflicts; shows lock owner and affected schedules |
+
+## Hierarchy Structure
+
+```
+Schedule (cf.schedule)
+├── Task (cf.activity)
+│   ├── Task (cf.activity)      # Sub-tasks via parent reference
+│   └── Milestone (cf.milestone)
+├── Task (cf.activity)
+└── Milestone (cf.milestone)
+```
+
+Tasks and Milestones reference their parent via the `parent` attribute. The `containingSchedule` attribute provides a direct reference to the top-level schedule for efficient queries.
+
+## Usage Notes
+
+### When to Use This App
+
+- **Basic project planning**: Single project schedules with tasks and milestones
+- **Timeline visualization**: When you need a Gantt chart view
+- **Progress tracking**: Tracking % complete and RAG status
+- **Portfolio overview**: Multi-Gantt for viewing multiple schedules together
+
+### Complementary Apps
+
+- **Project Planning (Extended)** (`cf.cplace.projektplanung.projektplanungExtended`): Adds subscriptions, dependencies, and advanced features
+- **Task Classes** (`cf.cplace.projektplanungMasterData`): Visual categorization of tasks with custom colors and shapes
+- **Project Structure** (`cf.cplace.projectTree`): Hierarchical project organization above schedules
+- **New Gantt** (`cf.cplace.projectPlanning.app.gantt2.gantt2`): Modern Bryntum-based Gantt with enhanced features
+- **Presentation Graphic** (`cf.cplace.pptexport`): Export schedules to PowerPoint
+
+### Best Practices
+
+1. **Page Hierarchy**: Create Schedules as child pages, then Tasks and Milestones beneath them
+2. **Parent References**: Always set the `parent` attribute to maintain proper hierarchy
+3. **Automatic Scheduling**: Enable `automaticScheduling` for tasks that should move with their predecessors
+4. **RAG Rating**: Use for quick visual status communication in Gantt views
+
+## Investigation Metadata
+
+- **Investigation Date**: 2026-02-02
+- **Workspace ID**: 58hyt6h0jscaz0hyd0rvnn4ch
+- **Workspace Name**: [App Investigation] cf.cplace.projektplanung.projektplanungBasic
+- **cplace Version**: Current (localhost testing environment)