From f5a69135b070d95a4efbb5a503092825f54071e9 Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Mon, 29 Jun 2026 13:59:03 +0300 Subject: [PATCH 1/8] docs(user-guide): document feature flags migration to backend config --- .../platform-managed-mode-configuration.md | 35 ++--- .../codemie/customer-feature-configuration.md | 125 ++++++++++++------ ...-project-and-user-management-in-codemie.md | 11 +- 3 files changed, 115 insertions(+), 56 deletions(-) diff --git a/docs/admin/configuration/access-control/platform-managed-mode-configuration.md b/docs/admin/configuration/access-control/platform-managed-mode-configuration.md index 50d697b3..4749c131 100644 --- a/docs/admin/configuration/access-control/platform-managed-mode-configuration.md +++ b/docs/admin/configuration/access-control/platform-managed-mode-configuration.md @@ -31,9 +31,10 @@ For a comparison of both modes, see the ## Step 1: Configure Helm Values -:::warning Both components must be updated -The AI/Run CodeMie backend and the UI must be configured consistently. Enabling only one of them results -in either missing UI controls or API errors. +:::warning Both backend settings must be enabled +`ENABLE_USER_MANAGEMENT` activates Platform-managed mode in the backend, while the +`features:userManagement` flag in `customer-config.yaml` tells the UI to show the management +tabs. Enabling only one results in either missing UI controls or API errors. ::: ### AI/Run CodeMie Backend @@ -58,24 +59,26 @@ your organisation's policy. Apply the changes to the deployment. -### AI/Run CodeMie UI +### AI/Run CodeMie UI Feature Flags -The UI must be told that Platform-managed mode is active so it shows the in-app -**Users management** and **Projects management** tabs under **Settings → Administration**. - -In the `codemie-ui` Helm chart `values.yaml`, set: +The UI reads feature flags from the backend configuration to determine which management views +to show. Add the following entries to your `customer-config.yaml`: ```yaml -viteEnableUserManagement: true -viteEnableBudgetManagement: true +components: + - id: "features:userManagement" + settings: + enabled: true + - id: "features:budgetManagement" + settings: + enabled: true ``` -`viteEnableUserManagement` tells the UI that Platform-managed mode is active. When set to -`true`, the **Users management** and **Projects management** tabs appear under -**Settings → Administration**. +`features:userManagement` controls the **Users management** and **Projects management** tabs +under **Settings → Administration**. Set to `true` to enable them. -`viteEnableBudgetManagement` enables budget columns and the budget management section on -project detail pages. Set it to `false` if your deployment does not use budget tracking. +`features:budgetManagement` enables budget columns and the budget management section on project +detail pages. Set to `false` if your deployment does not use budget tracking. Apply the changes to the deployment. @@ -224,7 +227,7 @@ changes during the upgrade and what action, if any, is required from you. | Area | What happens | Action required | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Database schema | New user management tables (`users`, `user_projects`, and related tables) are created automatically when the pod starts | None — Alembic migrations run on startup | -| Platform-managed mode activation | Off by default in 2.19.0 (`ENABLE_USER_MANAGEMENT=false`) | Add the Helm values from [Step 1](#step-1-configure-helm-values) before or during the upgrade if you want to enable it | +| Platform-managed mode activation | Off by default in 2.19.0 (`ENABLE_USER_MANAGEMENT=false`) | Add the backend environment variable and feature flags from [Step 1](#step-1-configure-helm-values) before or during the upgrade if you want to enable it | | Existing Keycloak user assignments | Not migrated automatically | Follow [Step 2](#step-2-migrate-existing-keycloak-users-existing-deployments-only) on first startup if you use `IDP_PROVIDER=keycloak` and want to preserve project assignments | ### How to upgrade diff --git a/docs/admin/configuration/codemie/customer-feature-configuration.md b/docs/admin/configuration/codemie/customer-feature-configuration.md index 6cf33fa3..f0648b5b 100644 --- a/docs/admin/configuration/codemie/customer-feature-configuration.md +++ b/docs/admin/configuration/codemie/customer-feature-configuration.md @@ -15,43 +15,48 @@ Control which features, UI elements, and integrations are available to users in Use this table to quickly find where each component appears in the UI. -| Component ID | Where It Appears | When Enabled Shows | When Disabled Hides | Notes | -| ----------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | ----------------------------------------- | -| **CORE FEATURES** | | | | | -| `adminActions` | Settings → Administration | Menu items: AI/Run Adoption, Categories, MCPs, Projects, Providers | Entire Administration menu | | -| `feedbackAssistant` | Help Center, Quick actions (top-right) | Feedback assistant card/button | Feedback collection interface | | -| `mcpConnect` | Assistant/Workflow config → Tools | "MCP Servers" option in dropdown | MCP integration option | | -| `mcpCustomServersDisabled` | Assistant/Workflow config → MCP Servers | Catalog-referenced and custom MCP servers | Possibility to configure custom MCP servers | | -| `skills` | Navigation, Chat config, Assistant config | Skills menu, skill selector, management pages | Entire Skills subsystem | Major feature gate | -| `aiAdoption` | Analytics page, Settings → Administration | Analytics dashboard with 4 dimensions | Analytics dashboard and config | Enterprise Edition only | -| `visualWorkflowEditor` | Workflow editor page | Visual drag-and-drop editor (React Flow) | Visual editor (YAML only) | | -| `defaultConversationAssistant` | New chat creation | Pre-selects specified assistant | Default behavior (no pre-selection) | Requires `slug` parameter | -| `features:personalLiteLLMIntegrations` | Integrations → User tab | LiteLLM as a personal integration option for regular users | LiteLLM from personal integrations (only maintainers and administrators can manage) | Disabled by default | -| **DYNAMIC TOOLS (Chat Interface)** | | | | | -| `features:webSearch` | Chat → Dynamic tools settings (gear icon) | "Web Search" toggle | Web search option | If both disabled, entire section hidden | -| `features:dynamicCodeInterpreter` | Chat → Dynamic tools settings (gear icon) | "Code Interpreter" toggle | Code interpreter option | If both disabled, entire section hidden | -| **HELP CENTER LINKS** | | | | | -| `videoPortal` | Help Center → Learning Resources | Link card with "Open Guide" button | Link card | | -| `youtubeChannel` | Help Center → Learning Resources | YouTube channel link card | Link card | | -| `userGuide` | Help Center → Learning Resources | Documentation link card | Link card | | -| `userSurvey` | Help Center → Learning Resources | Survey form link card | Link card | | -| **CONTEXTUAL HELP (Conditional Display)** | | | | | -| `helpLinks:assistants:creating` | Create Assistant page (top-right) | Help documentation link | No documentation link | Triggers: Page load | -| `helpLinks:assistants:tools` | Assistant config → Tools section | Help documentation link | No documentation link | Triggers: User opens tools | -| `helpLinks:workflows:creating` | Create Workflow page (top-right) | Help documentation link | No documentation link | Triggers: Page load | -| `helpLinks:workflows:configuration` | Workflow editor → YAML tab | Help documentation link | No documentation link | Triggers: User switches to YAML | -| `helpLinks:integrations:selection:` | Integration creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | -| `helpLinks:datasources:selection:` | Data source creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | -| **ASSISTANT FEATURES** | | | | | -| `features:favorites` | Assistants list, Skills list, Workflows list | Favorite/Unfavorite action buttons | Favorite actions hidden | | -| `features:pinnedAssistants` | Assistants list, Navigation sidebar | Pin/Unpin actions and Pinned Assistants sidebar section | Pin actions and sidebar section hidden | | -| `features:favoritesPage` | Main navigation | Favorites page and navigation link | Favorites page and nav link hidden | Default: disabled | -| **DATASOURCE FEATURES** | | | | | -| `features:sharepointCodeMieOAuth` | Data Sources → SharePoint setup form | "Sign in with Microsoft (CodeMie Project)" authentication option | SharePoint PKCE auth option hidden | Requires `SHAREPOINT_PKCE_ENABLED=true` | -| **INTEGRATED APPLICATIONS** | | | | | -| `applications:` | Applications menu | Application card with icon | Application card | Type: `module`, `iframe`, or `link` | -| **PRECONFIGURED ASSISTANTS** | | | | | -| Any assistant ID | Assistants list, New chat dropdown, Help Center → AI Help | Assistant appears in all locations | Assistant hidden from all locations | Default: enabled if not configured | +| Component ID | Where It Appears | When Enabled Shows | When Disabled Hides | Notes | +| ----------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------- | +| **CORE FEATURES** | | | | | +| `adminActions` | Settings → Administration | Menu items: AI/Run Adoption, Categories, MCPs, Projects, Providers | Entire Administration menu | | +| `feedbackAssistant` | Help Center, Quick actions (top-right) | Feedback assistant card/button | Feedback collection interface | | +| `mcpConnect` | Assistant/Workflow config → Tools | "MCP Servers" option in dropdown | MCP integration option | | +| `mcpCustomServersDisabled` | Assistant/Workflow config → MCP Servers | Catalog-referenced and custom MCP servers | Possibility to configure custom MCP servers | | +| `skills` | Navigation, Chat config, Assistant config | Skills menu, skill selector, management pages | Entire Skills subsystem | Major feature gate | +| `aiAdoption` | Analytics page, Settings → Administration | Analytics dashboard with 4 dimensions | Analytics dashboard and config | Enterprise Edition only | +| `features:enterpriseEdition` | Analytics, navigation, Settings, profile | Analytics, AI adoption config, enterprise admin tabs, LiteLLM | All enterprise-only UI | Master enterprise switch | +| `features:showAllProjects` | Settings → Administration → project selector | All projects returned by admin project picker (no limit or search minimum) | Admin project picker limited to 5 results with 3-char search minimum | | +| `visualWorkflowEditor` | Workflow editor page | Visual drag-and-drop editor (React Flow) | Visual editor (YAML only) | | +| `defaultConversationAssistant` | New chat creation | Pre-selects specified assistant | Default behavior (no pre-selection) | Requires `slug` parameter | +| `features:personalLiteLLMIntegrations` | Integrations → User tab | LiteLLM as a personal integration option for regular users | LiteLLM from personal integrations (only maintainers and administrators can manage) | Disabled by default | +| **PLATFORM-MANAGED MODE** | | | | | +| `features:userManagement` | Settings → Administration | Users management and Projects management tabs | Management tabs | Requires `ENABLE_USER_MANAGEMENT=true` | +| `features:budgetManagement` | Project detail pages, Settings → Administration | Budget columns and budget management section | Budget tracking UI | | +| **DYNAMIC TOOLS (Chat Interface)** | | | | | +| `features:webSearch` | Chat → Dynamic tools settings (gear icon) | "Web Search" toggle | Web search option | If both disabled, entire section hidden | +| `features:dynamicCodeInterpreter` | Chat → Dynamic tools settings (gear icon) | "Code Interpreter" toggle | Code interpreter option | If both disabled, entire section hidden | +| **HELP CENTER LINKS** | | | | | +| `videoPortal` | Help Center → Learning Resources | Link card with "Open Guide" button | Link card | | +| `youtubeChannel` | Help Center → Learning Resources | YouTube channel link card | Link card | | +| `userGuide` | Help Center → Learning Resources | Documentation link card | Link card | | +| `userSurvey` | Help Center → Learning Resources | Survey form link card | Link card | | +| **CONTEXTUAL HELP (Conditional Display)** | | | | | +| `helpLinks:assistants:creating` | Create Assistant page (top-right) | Help documentation link | No documentation link | Triggers: Page load | +| `helpLinks:assistants:tools` | Assistant config → Tools section | Help documentation link | No documentation link | Triggers: User opens tools | +| `helpLinks:workflows:creating` | Create Workflow page (top-right) | Help documentation link | No documentation link | Triggers: Page load | +| `helpLinks:workflows:configuration` | Workflow editor → YAML tab | Help documentation link | No documentation link | Triggers: User switches to YAML | +| `helpLinks:integrations:selection:` | Integration creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | +| `helpLinks:datasources:selection:` | Data source creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | +| **ASSISTANT FEATURES** | | | | | +| `features:favorites` | Assistants list, Skills list, Workflows list | Favorite/Unfavorite action buttons | Favorite actions hidden | | +| `features:pinnedAssistants` | Assistants list, Navigation sidebar | Pin/Unpin actions and Pinned Assistants sidebar section | Pin actions and sidebar section hidden | | +| `features:favoritesPage` | Main navigation | Favorites page and navigation link | Favorites page and nav link hidden | Default: disabled | +| **DATASOURCE FEATURES** | | | | | +| `features:sharepointCodeMieOAuth` | Data Sources → SharePoint setup form | "Sign in with Microsoft (CodeMie Project)" authentication option | SharePoint PKCE auth option hidden | Requires `SHAREPOINT_PKCE_ENABLED=true` | +| **INTEGRATED APPLICATIONS** | | | | | +| `applications:` | Applications menu | Application card with icon | Application card | Type: `module`, `iframe`, or `link` | +| **PRECONFIGURED ASSISTANTS** | | | | | +| Any assistant ID | Assistants list, New chat dropdown, Help Center → AI Help | Assistant appears in all locations | Assistant hidden from all locations | Default: enabled if not configured | ## Configuration Parameters @@ -260,6 +265,28 @@ components: - id: "features:personalLiteLLMIntegrations" settings: enabled: true + + # WHERE: Settings → Administration → Users management, Projects management tabs + # ENABLED: Shows "Users management" and "Projects management" tabs under Settings → Administration + # DISABLED: Hides management tabs (Platform-managed mode UI is inactive) + # NOTE: Requires ENABLE_USER_MANAGEMENT=true in the backend + - id: "features:userManagement" + settings: + enabled: true + + # WHERE: Project detail pages, Settings → Administration → Budget management + # ENABLED: Shows budget columns in project lists and budget management section on project detail pages + # DISABLED: Hides all budget tracking UI + - id: "features:budgetManagement" + settings: + enabled: true + + # WHERE: Settings → Administration → project selector dropdown (admin-only) + # ENABLED: Admin project picker returns all projects with no result limit and no minimum search length + # DISABLED: Admin project picker returns up to 5 results and requires at least 3 characters to search + - id: "features:showAllProjects" + settings: + enabled: true ``` ### Advanced Features @@ -288,6 +315,14 @@ components: name: "Skills" description: "Modular knowledge units that provide domain-specific instructions to assistants" + # WHERE: Analytics routes, navigation, Settings admin tabs, profile page, integrations + # ENABLED: Activates all enterprise-only UI — analytics routes and nav link, AI adoption config, + # enterprise admin tabs (AI Adoption, Budgets, Categories, MCPs, Providers, Users). + # DISABLED: Hides all enterprise-specific UI; only the Projects management tab remains in admin + - id: "features:enterpriseEdition" + settings: + enabled: true + # WHERE: 1) Analytics page → AI Adoption dashboard # 2) Settings → Administration → AI Adoption Config # 3) Main navigation (Enterprise Edition only) @@ -1000,6 +1035,18 @@ extraObjects: settings: enabled: true + - id: "features:userManagement" + settings: + enabled: true + + - id: "features:budgetManagement" + settings: + enabled: true + + - id: "features:showAllProjects" + settings: + enabled: true + # Advanced Features - id: "skills" settings: @@ -1007,6 +1054,10 @@ extraObjects: name: "Skills" description: "Modular knowledge units that provide domain-specific instructions to assistants" + - id: "features:enterpriseEdition" + settings: + enabled: true + - id: "aiAdoption" settings: enabled: true diff --git a/faq/how-do-i-enable-project-and-user-management-in-codemie.md b/faq/how-do-i-enable-project-and-user-management-in-codemie.md index 43143b57..496d7db9 100644 --- a/faq/how-do-i-enable-project-and-user-management-in-codemie.md +++ b/faq/how-do-i-enable-project-and-user-management-in-codemie.md @@ -15,11 +15,16 @@ extraEnv: value: '3' ``` -**`codemie-ui` — `values.yaml`:** +**`customer-config.yaml` — feature flags:** ```yaml -viteEnableUserManagement: true -viteEnableBudgetManagement: true +components: + - id: "features:userManagement" + settings: + enabled: true + - id: "features:budgetManagement" + settings: + enabled: true ``` After applying both changes, the **Projects management** and **Users management** tabs From eb2a4ff7c00adaf1601d5cb0041f49d35453f551 Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Thu, 16 Jul 2026 15:51:13 +0300 Subject: [PATCH 2/8] docs(config): update feature flags docs and add 2.40.0 release notes (EPMCDME-12746) - customer-feature-configuration.md: mark features:userManagement and features:enterpriseEdition as runtime-computed; add mcpAuthTimeoutSeconds, bannerMessage, bannerLinkLabel, bannerLinkRoute entries; add idpProvider and mcpAuthOrigin as non-configurable runtime values - platform-managed-mode-configuration.md: remove outdated UI helm values section; only ENABLE_USER_MANAGEMENT=true is required in the backend - faq: remove codemie-ui helm values section; only backend env var needed - release-notes.md: add 2.40.0 section covering all four migration changes Co-Authored-By: Claude Sonnet 4.6 --- .../platform-managed-mode-configuration.md | 19 +- .../codemie/customer-feature-configuration.md | 224 +++++++++++++----- docs/admin/update/release-notes.md | 86 ++++++- ...-project-and-user-management-in-codemie.md | 16 +- 4 files changed, 249 insertions(+), 96 deletions(-) diff --git a/docs/admin/configuration/access-control/platform-managed-mode-configuration.md b/docs/admin/configuration/access-control/platform-managed-mode-configuration.md index 4749c131..f0f21d8b 100644 --- a/docs/admin/configuration/access-control/platform-managed-mode-configuration.md +++ b/docs/admin/configuration/access-control/platform-managed-mode-configuration.md @@ -31,12 +31,6 @@ For a comparison of both modes, see the ## Step 1: Configure Helm Values -:::warning Both backend settings must be enabled -`ENABLE_USER_MANAGEMENT` activates Platform-managed mode in the backend, while the -`features:userManagement` flag in `customer-config.yaml` tells the UI to show the management -tabs. Enabling only one results in either missing UI controls or API errors. -::: - ### AI/Run CodeMie Backend In the `codemie-api` Helm chart, add the following variables to the `extraEnv` list: @@ -59,26 +53,19 @@ your organisation's policy. Apply the changes to the deployment. -### AI/Run CodeMie UI Feature Flags +### AI/Run CodeMie UI -The UI reads feature flags from the backend configuration to determine which management views -to show. Add the following entries to your `customer-config.yaml`: +To enable budget tracking, add the following entry to `customer-config.yaml`: ```yaml components: - - id: "features:userManagement" - settings: - enabled: true - id: "features:budgetManagement" settings: enabled: true ``` -`features:userManagement` controls the **Users management** and **Projects management** tabs -under **Settings → Administration**. Set to `true` to enable them. - `features:budgetManagement` enables budget columns and the budget management section on project -detail pages. Set to `false` if your deployment does not use budget tracking. +detail pages. Set to `false` if the deployment does not use budget tracking. Apply the changes to the deployment. diff --git a/docs/admin/configuration/codemie/customer-feature-configuration.md b/docs/admin/configuration/codemie/customer-feature-configuration.md index f0648b5b..297f16f9 100644 --- a/docs/admin/configuration/codemie/customer-feature-configuration.md +++ b/docs/admin/configuration/codemie/customer-feature-configuration.md @@ -15,48 +15,57 @@ Control which features, UI elements, and integrations are available to users in Use this table to quickly find where each component appears in the UI. -| Component ID | Where It Appears | When Enabled Shows | When Disabled Hides | Notes | -| ----------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------- | -| **CORE FEATURES** | | | | | -| `adminActions` | Settings → Administration | Menu items: AI/Run Adoption, Categories, MCPs, Projects, Providers | Entire Administration menu | | -| `feedbackAssistant` | Help Center, Quick actions (top-right) | Feedback assistant card/button | Feedback collection interface | | -| `mcpConnect` | Assistant/Workflow config → Tools | "MCP Servers" option in dropdown | MCP integration option | | -| `mcpCustomServersDisabled` | Assistant/Workflow config → MCP Servers | Catalog-referenced and custom MCP servers | Possibility to configure custom MCP servers | | -| `skills` | Navigation, Chat config, Assistant config | Skills menu, skill selector, management pages | Entire Skills subsystem | Major feature gate | -| `aiAdoption` | Analytics page, Settings → Administration | Analytics dashboard with 4 dimensions | Analytics dashboard and config | Enterprise Edition only | -| `features:enterpriseEdition` | Analytics, navigation, Settings, profile | Analytics, AI adoption config, enterprise admin tabs, LiteLLM | All enterprise-only UI | Master enterprise switch | -| `features:showAllProjects` | Settings → Administration → project selector | All projects returned by admin project picker (no limit or search minimum) | Admin project picker limited to 5 results with 3-char search minimum | | -| `visualWorkflowEditor` | Workflow editor page | Visual drag-and-drop editor (React Flow) | Visual editor (YAML only) | | -| `defaultConversationAssistant` | New chat creation | Pre-selects specified assistant | Default behavior (no pre-selection) | Requires `slug` parameter | -| `features:personalLiteLLMIntegrations` | Integrations → User tab | LiteLLM as a personal integration option for regular users | LiteLLM from personal integrations (only maintainers and administrators can manage) | Disabled by default | -| **PLATFORM-MANAGED MODE** | | | | | -| `features:userManagement` | Settings → Administration | Users management and Projects management tabs | Management tabs | Requires `ENABLE_USER_MANAGEMENT=true` | -| `features:budgetManagement` | Project detail pages, Settings → Administration | Budget columns and budget management section | Budget tracking UI | | -| **DYNAMIC TOOLS (Chat Interface)** | | | | | -| `features:webSearch` | Chat → Dynamic tools settings (gear icon) | "Web Search" toggle | Web search option | If both disabled, entire section hidden | -| `features:dynamicCodeInterpreter` | Chat → Dynamic tools settings (gear icon) | "Code Interpreter" toggle | Code interpreter option | If both disabled, entire section hidden | -| **HELP CENTER LINKS** | | | | | -| `videoPortal` | Help Center → Learning Resources | Link card with "Open Guide" button | Link card | | -| `youtubeChannel` | Help Center → Learning Resources | YouTube channel link card | Link card | | -| `userGuide` | Help Center → Learning Resources | Documentation link card | Link card | | -| `userSurvey` | Help Center → Learning Resources | Survey form link card | Link card | | -| **CONTEXTUAL HELP (Conditional Display)** | | | | | -| `helpLinks:assistants:creating` | Create Assistant page (top-right) | Help documentation link | No documentation link | Triggers: Page load | -| `helpLinks:assistants:tools` | Assistant config → Tools section | Help documentation link | No documentation link | Triggers: User opens tools | -| `helpLinks:workflows:creating` | Create Workflow page (top-right) | Help documentation link | No documentation link | Triggers: Page load | -| `helpLinks:workflows:configuration` | Workflow editor → YAML tab | Help documentation link | No documentation link | Triggers: User switches to YAML | -| `helpLinks:integrations:selection:` | Integration creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | -| `helpLinks:datasources:selection:` | Data source creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | -| **ASSISTANT FEATURES** | | | | | -| `features:favorites` | Assistants list, Skills list, Workflows list | Favorite/Unfavorite action buttons | Favorite actions hidden | | -| `features:pinnedAssistants` | Assistants list, Navigation sidebar | Pin/Unpin actions and Pinned Assistants sidebar section | Pin actions and sidebar section hidden | | -| `features:favoritesPage` | Main navigation | Favorites page and navigation link | Favorites page and nav link hidden | Default: disabled | -| **DATASOURCE FEATURES** | | | | | -| `features:sharepointCodeMieOAuth` | Data Sources → SharePoint setup form | "Sign in with Microsoft (CodeMie Project)" authentication option | SharePoint PKCE auth option hidden | Requires `SHAREPOINT_PKCE_ENABLED=true` | -| **INTEGRATED APPLICATIONS** | | | | | -| `applications:` | Applications menu | Application card with icon | Application card | Type: `module`, `iframe`, or `link` | -| **PRECONFIGURED ASSISTANTS** | | | | | -| Any assistant ID | Assistants list, New chat dropdown, Help Center → AI Help | Assistant appears in all locations | Assistant hidden from all locations | Default: enabled if not configured | +| Component ID | Where It Appears | When Enabled Shows | When Disabled Hides | Notes | +| ----------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | +| **CORE FEATURES** | | | | | +| `adminActions` | Settings → Administration | Menu items: AI/Run Adoption, Categories, MCPs, Projects, Providers | Entire Administration menu | | +| `feedbackAssistant` | Help Center, Quick actions (top-right) | Feedback assistant card/button | Feedback collection interface | | +| `mcpConnect` | Assistant/Workflow config → Tools | "MCP Servers" option in dropdown | MCP integration option | | +| `mcpCustomServersDisabled` | Assistant/Workflow config → MCP Servers | Catalog-referenced and custom MCP servers | Possibility to configure custom MCP servers | | +| `skills` | Navigation, Chat config, Assistant config | Skills menu, skill selector, management pages | Entire Skills subsystem | Major feature gate | +| `aiAdoption` | Analytics page, Settings → Administration | Analytics dashboard with 4 dimensions | Analytics dashboard and config | Enterprise Edition only | +| `features:enterpriseEdition` | Analytics, navigation, Settings, profile | Analytics, AI adoption config, enterprise admin tabs, LiteLLM | All enterprise-only UI | **Runtime-computed** — reflects enterprise package auto-detection; not configurable via `customer-config.yaml` | +| `features:showAllProjects` | Settings → Administration → project selector | All projects returned by admin project picker (no limit or search minimum) | Admin project picker limited to 5 results with 3-char search minimum | | +| `visualWorkflowEditor` | Workflow editor page | Visual drag-and-drop editor (React Flow) | Visual editor (YAML only) | | +| `defaultConversationAssistant` | New chat creation | Pre-selects specified assistant | Default behavior (no pre-selection) | Requires `slug` parameter | +| `features:personalLiteLLMIntegrations` | Integrations → User tab | LiteLLM as a personal integration option for regular users | LiteLLM from personal integrations (only maintainers and administrators can manage) | Disabled by default | +| **PLATFORM-MANAGED MODE** | | | | | +| `features:userManagement` | Settings → Administration | Users management and Projects management tabs | Management tabs | **Runtime-computed** — reflects `ENABLE_USER_MANAGEMENT` backend env var; not configurable via `customer-config.yaml` | +| `features:budgetManagement` | Project detail pages, Settings → Administration | Budget columns and budget management section | Budget tracking UI | | +| **DYNAMIC TOOLS (Chat Interface)** | | | | | +| `features:webSearch` | Chat → Dynamic tools settings (gear icon) | "Web Search" toggle | Web search option | If both disabled, entire section hidden | +| `features:dynamicCodeInterpreter` | Chat → Dynamic tools settings (gear icon) | "Code Interpreter" toggle | Code interpreter option | If both disabled, entire section hidden | +| **BANNER CONFIGURATION** | | | | | +| `bannerMessage` | All pages (top banner) | Banner text displayed across the app | No banner shown | String, default: `""` — configurable via `customer-config.yaml` | +| `bannerLinkLabel` | All pages (top banner) | Label for the optional banner link | No link label shown | String, default: `""` — set alongside `bannerLinkRoute` | +| `bannerLinkRoute` | All pages (top banner) | Route for the optional banner link | No link route | String, default: `""` — set alongside `bannerLinkLabel` | +| **MCP CONFIGURATION** | | | | | +| `mcpAuthTimeoutSeconds` | MCP OAuth flow | MCP OAuth timeout duration | Uses default timeout | Integer, default: `60` — configurable via `customer-config.yaml` | +| **READ-ONLY RUNTIME FIELDS** | | | | | +| `idpProvider` | `/v1/config` API response | N/A (read-only field) | N/A | Reflects `IDP_PROVIDER` backend env var; default: `keycloak`; not configurable via `customer-config.yaml` | +| `mcpAuthOrigin` | `/v1/config` API response | N/A (read-only field) | N/A | Reflects `CALLBACK_API_BASE_URL` backend env var; not configurable via `customer-config.yaml` | +| **HELP CENTER LINKS** | | | | | +| `videoPortal` | Help Center → Learning Resources | Link card with "Open Guide" button | Link card | | +| `youtubeChannel` | Help Center → Learning Resources | YouTube channel link card | Link card | | +| `userGuide` | Help Center → Learning Resources | Documentation link card | Link card | | +| `userSurvey` | Help Center → Learning Resources | Survey form link card | Link card | | +| **CONTEXTUAL HELP (Conditional Display)** | | | | | +| `helpLinks:assistants:creating` | Create Assistant page (top-right) | Help documentation link | No documentation link | Triggers: Page load | +| `helpLinks:assistants:tools` | Assistant config → Tools section | Help documentation link | No documentation link | Triggers: User opens tools | +| `helpLinks:workflows:creating` | Create Workflow page (top-right) | Help documentation link | No documentation link | Triggers: Page load | +| `helpLinks:workflows:configuration` | Workflow editor → YAML tab | Help documentation link | No documentation link | Triggers: User switches to YAML | +| `helpLinks:integrations:selection:` | Integration creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | +| `helpLinks:datasources:selection:` | Data source creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | +| **ASSISTANT FEATURES** | | | | | +| `features:favorites` | Assistants list, Skills list, Workflows list | Favorite/Unfavorite action buttons | Favorite actions hidden | | +| `features:pinnedAssistants` | Assistants list, Navigation sidebar | Pin/Unpin actions and Pinned Assistants sidebar section | Pin actions and sidebar section hidden | | +| `features:favoritesPage` | Main navigation | Favorites page and navigation link | Favorites page and nav link hidden | Default: disabled | +| **DATASOURCE FEATURES** | | | | | +| `features:sharepointCodeMieOAuth` | Data Sources → SharePoint setup form | "Sign in with Microsoft (CodeMie Project)" authentication option | SharePoint PKCE auth option hidden | Requires `SHAREPOINT_PKCE_ENABLED=true` | +| **INTEGRATED APPLICATIONS** | | | | | +| `applications:` | Applications menu | Application card with icon | Application card | Type: `module`, `iframe`, or `link` | +| **PRECONFIGURED ASSISTANTS** | | | | | +| Any assistant ID | Assistants list, New chat dropdown, Help Center → AI Help | Assistant appears in all locations | Assistant hidden from all locations | Default: enabled if not configured | ## Configuration Parameters @@ -266,14 +275,6 @@ components: settings: enabled: true - # WHERE: Settings → Administration → Users management, Projects management tabs - # ENABLED: Shows "Users management" and "Projects management" tabs under Settings → Administration - # DISABLED: Hides management tabs (Platform-managed mode UI is inactive) - # NOTE: Requires ENABLE_USER_MANAGEMENT=true in the backend - - id: "features:userManagement" - settings: - enabled: true - # WHERE: Project detail pages, Settings → Administration → Budget management # ENABLED: Shows budget columns in project lists and budget management section on project detail pages # DISABLED: Hides all budget tracking UI @@ -289,6 +290,12 @@ components: enabled: true ``` +:::warning `features:userManagement` is runtime-computed +As of CodeMie 2.40.0, `features:userManagement` is derived automatically from the `ENABLE_USER_MANAGEMENT` backend environment variable. Setting this entry in `customer-config.yaml` has no effect. To enable the Platform-managed mode UI, set `ENABLE_USER_MANAGEMENT=true` in the `codemie-api` Helm chart. + +See [Platform-Managed Mode Configuration](../access-control/platform-managed-mode-configuration.md) for full setup instructions. +::: + ### Advanced Features **Fields used in this section:** @@ -315,14 +322,6 @@ components: name: "Skills" description: "Modular knowledge units that provide domain-specific instructions to assistants" - # WHERE: Analytics routes, navigation, Settings admin tabs, profile page, integrations - # ENABLED: Activates all enterprise-only UI — analytics routes and nav link, AI adoption config, - # enterprise admin tabs (AI Adoption, Budgets, Categories, MCPs, Providers, Users). - # DISABLED: Hides all enterprise-specific UI; only the Projects management tab remains in admin - - id: "features:enterpriseEdition" - settings: - enabled: true - # WHERE: 1) Analytics page → AI Adoption dashboard # 2) Settings → Administration → AI Adoption Config # 3) Main navigation (Enterprise Edition only) @@ -396,6 +395,87 @@ components: description: "Show Sign in with Microsoft (CodeMie Project) authentication option for SharePoint datasource" ``` +:::warning `features:enterpriseEdition` is runtime-computed +As of CodeMie 2.40.0, `features:enterpriseEdition` is determined automatically through enterprise package auto-detection. Setting this entry in `customer-config.yaml` has no effect. +::: + +### Banner Configuration + +Controls the banner message displayed at the top of all pages. + +**Fields used in this section:** + +```yaml +settings: + enabled: true # Required + value: "..." # String value for the configuration entry +``` + +```yaml +components: + # WHERE: All pages — top banner area + # WHEN SET: Displays a banner with the specified text across the entire application + # WHEN EMPTY: No banner is shown + # NOTE: Default is "" (empty — no banner displayed) + - id: "bannerMessage" + settings: + enabled: true + value: "Scheduled maintenance on Saturday 00:00–02:00 UTC" + + # WHERE: Top banner (appears alongside bannerMessage) + # WHEN SET: Shows a clickable link with this label in the banner + # WHEN EMPTY: No link label shown + # NOTE: Set alongside bannerLinkRoute; default is "" + - id: "bannerLinkLabel" + settings: + enabled: true + value: "Learn more" + + # WHERE: Top banner (appears alongside bannerMessage) + # WHEN SET: Route navigated to when the banner link is clicked + # WHEN EMPTY: No link route set + # NOTE: Set alongside bannerLinkLabel; default is "" + - id: "bannerLinkRoute" + settings: + enabled: true + value: "/help" +``` + +### MCP Auth Configuration + +Controls the timeout for MCP OAuth flows. + +**Fields used in this section:** + +```yaml +settings: + enabled: true + value: 60 # Integer — timeout in seconds +``` + +```yaml +components: + # Controls how long (in seconds) the MCP OAuth flow waits before timing out + # NOTE: Default is 60 seconds + - id: "mcpAuthTimeoutSeconds" + settings: + enabled: true + value: 60 +``` + +### Read-Only Runtime Fields + +The following fields appear in the `/v1/config` API response but are **not configurable** via `customer-config.yaml`. They reflect backend environment variables set in the `codemie-api` Helm chart. + +:::note Read-only fields +These values are served automatically from the backend configuration. No `customer-config.yaml` action is required. +::: + +| Field | Backend env var | Default | Description | +| --------------- | ----------------------- | ---------- | ---------------------------------- | +| `idpProvider` | `IDP_PROVIDER` | `keycloak` | Identity provider in use | +| `mcpAuthOrigin` | `CALLBACK_API_BASE_URL` | _(none)_ | Origin URL for MCP OAuth callbacks | + ### Datasource Features Controls authentication options available in the datasource setup UI. @@ -1035,17 +1115,35 @@ extraObjects: settings: enabled: true - - id: "features:userManagement" + - id: "features:budgetManagement" settings: enabled: true - - id: "features:budgetManagement" + - id: "features:showAllProjects" settings: enabled: true - - id: "features:showAllProjects" + # Banner Configuration + - id: "bannerMessage" + settings: + enabled: true + value: "Scheduled maintenance on Saturday 00:00–02:00 UTC" + + - id: "bannerLinkLabel" + settings: + enabled: true + value: "Learn more" + + - id: "bannerLinkRoute" + settings: + enabled: true + value: "/help" + + # MCP Auth Configuration + - id: "mcpAuthTimeoutSeconds" settings: enabled: true + value: 60 # Advanced Features - id: "skills" @@ -1054,10 +1152,6 @@ extraObjects: name: "Skills" description: "Modular knowledge units that provide domain-specific instructions to assistants" - - id: "features:enterpriseEdition" - settings: - enabled: true - - id: "aiAdoption" settings: enabled: true diff --git a/docs/admin/update/release-notes.md b/docs/admin/update/release-notes.md index 9c460357..304226bd 100644 --- a/docs/admin/update/release-notes.md +++ b/docs/admin/update/release-notes.md @@ -13,6 +13,90 @@ This page provides information about updated third-party components and configur --- +### CodeMie 2.40.0 {#v2-40-0} + +
+Release details + +**Release Date:** TBD · [GitHub Tag ↗](https://github.com/codemie-ai/codemie/releases/tag/2.40.0) + +

Third-Party Component Updates

+ +No third-party component updates in this release. + +

Configuration Changes

+ +1. **[BREAKING] Frontend feature flags moved to backend config** — the following UI configuration variables have been removed from the `codemie-ui` Helm chart and runtime config. They are now controlled through `customer-config.yaml`, allowing runtime changes without redeploying the UI. + + :::danger Breaking Change + If any of the removed variables were explicitly set to `true` in your deployment, you must add the corresponding entry to `customer-config.yaml` before upgrading. Failing to do so will cause affected features to silently revert to their disabled state. + ::: + + | Removed variable | Was in | Default | Replacement in `customer-config.yaml` | + | ---------------------------- | --------------------------- | ------- | ------------------------------------- | + | `viteEnableUserManagement` | `codemie-ui` Helm values | `false` | `features:userManagement` | + | `viteEnableBudgetManagement` | `codemie-ui` Helm values | `false` | `features:budgetManagement` | + | `VITE_IS_ENTERPRISE_EDITION` | `codemie-ui` runtime config | `false` | `features:enterpriseEdition` | + | `VITE_SHOW_ALL_PROJECTS` | `codemie-ui` runtime config | `false` | `features:showAllProjects` | + + Add the required entries to `customer-config.yaml`: + + ```yaml + components: + # Required if VITE_IS_ENTERPRISE_EDITION was true (enterprise deployments) + - id: "features:enterpriseEdition" + settings: + enabled: true + + # Required if viteEnableUserManagement was true + - id: "features:userManagement" + settings: + enabled: true + + # Required if viteEnableBudgetManagement was true + - id: "features:budgetManagement" + settings: + enabled: true + + # Required if VITE_SHOW_ALL_PROJECTS was true + - id: "features:showAllProjects" + settings: + enabled: true + ``` + + See [Customer Feature Configuration](../configuration/codemie/customer-feature-configuration.md) for full deployment instructions. + +2. **Additional frontend env vars removed from `codemie-ui`** — no `customer-config.yaml` action required for these; they are now computed at runtime by the backend. + + | Removed variable | Was in | Now computed from | + | ------------------- | ------------------------ | ----------------------------------------------- | + | `viteIdpProvider` | `codemie-ui` Helm values | `IDP_PROVIDER` environment variable | + | `viteMcpAuthOrigin` | `codemie-ui` Helm values | `CALLBACK_API_BASE_URL` environment variable | + | `viteBannerMessage` | `codemie-ui` Helm values | `bannerMessage` entry in `customer-config.yaml` | + + :::tip Banner message migration + If `viteBannerMessage` was set in your deployment, move its value to the new `bannerMessage` entry in `customer-config.yaml` (see item 4 below). + ::: + +3. **`features:userManagement` and `features:enterpriseEdition` are now runtime-computed** — remove these entries from `customer-config.yaml` if present; they are ignored at runtime. + + | Entry | Now computed from | + | ---------------------------- | ----------------------------------------------- | + | `features:userManagement` | `ENABLE_USER_MANAGEMENT` environment variable | + | `features:enterpriseEdition` | Enterprise package auto-detection | + +4. **New YAML-configurable entries added to `customer-config.yaml`**: + + | New entry | Description | + | ----------------------- | ------------------------------------------------------- | + | `mcpAuthTimeoutSeconds` | MCP authentication timeout in seconds (default: `60`) | + | `bannerMessage` | Text content of the banner message (default: disabled) | + | `bannerLinkLabel` | Label for the banner link (default: disabled) | + | `bannerLinkRoute` | Route/URL for the banner link (default: disabled) | + + See [Customer Feature Configuration](../configuration/codemie/customer-feature-configuration.md) for configuration details. + +
### CodeMie 2.39.0 {#v2-39-0}
@@ -833,4 +917,4 @@ To upgrade Fluent Bit to version 4.2.3.1, follow the [Fluent Bit Upgrade Guide]( No breaking configuration changes were introduced in this release. All existing Fluent Bit configurations remain compatible. -
+ \ No newline at end of file diff --git a/faq/how-do-i-enable-project-and-user-management-in-codemie.md b/faq/how-do-i-enable-project-and-user-management-in-codemie.md index 496d7db9..a3cafe28 100644 --- a/faq/how-do-i-enable-project-and-user-management-in-codemie.md +++ b/faq/how-do-i-enable-project-and-user-management-in-codemie.md @@ -3,7 +3,7 @@ Project & User Management requires **Platform-managed mode** to be enabled by a platform administrator. It is off by default. -To enable it, set the following values in your Helm charts and redeploy both components: +To enable it, add the following to the `codemie-api` Helm chart and redeploy: **`codemie-api` — `extraEnv`:** @@ -15,19 +15,7 @@ extraEnv: value: '3' ``` -**`customer-config.yaml` — feature flags:** - -```yaml -components: - - id: "features:userManagement" - settings: - enabled: true - - id: "features:budgetManagement" - settings: - enabled: true -``` - -After applying both changes, the **Projects management** and **Users management** tabs +After applying the change, the **Projects management** and **Users management** tabs appear under **Settings → Administration** for users with the Admin role. If you are switching from an existing Keycloak-managed deployment, you also need to run a From 642c0368dee1e0ff28a06effa0e7a82ebb4799aa Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Thu, 16 Jul 2026 16:22:42 +0300 Subject: [PATCH 3/8] docs(config): clean up customer-feature-configuration and release notes Remove runtime-computed entries (features:enterpriseEdition, features:userManagement, idpProvider, mcpAuthOrigin) and visualWorkflowEditor from the component overview table. Remove redundant runtime-computed warnings and the Banner Configuration section from customer-feature-configuration.md. Generated with AI Co-Authored-By: codemie-ai --- .../codemie/customer-feature-configuration.md | 148 ++++++------------ docs/admin/update/release-notes.md | 20 +-- 2 files changed, 55 insertions(+), 113 deletions(-) diff --git a/docs/admin/configuration/codemie/customer-feature-configuration.md b/docs/admin/configuration/codemie/customer-feature-configuration.md index 297f16f9..66da7e3b 100644 --- a/docs/admin/configuration/codemie/customer-feature-configuration.md +++ b/docs/admin/configuration/codemie/customer-feature-configuration.md @@ -15,57 +15,51 @@ Control which features, UI elements, and integrations are available to users in Use this table to quickly find where each component appears in the UI. -| Component ID | Where It Appears | When Enabled Shows | When Disabled Hides | Notes | -| ----------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -| **CORE FEATURES** | | | | | -| `adminActions` | Settings → Administration | Menu items: AI/Run Adoption, Categories, MCPs, Projects, Providers | Entire Administration menu | | -| `feedbackAssistant` | Help Center, Quick actions (top-right) | Feedback assistant card/button | Feedback collection interface | | -| `mcpConnect` | Assistant/Workflow config → Tools | "MCP Servers" option in dropdown | MCP integration option | | -| `mcpCustomServersDisabled` | Assistant/Workflow config → MCP Servers | Catalog-referenced and custom MCP servers | Possibility to configure custom MCP servers | | -| `skills` | Navigation, Chat config, Assistant config | Skills menu, skill selector, management pages | Entire Skills subsystem | Major feature gate | -| `aiAdoption` | Analytics page, Settings → Administration | Analytics dashboard with 4 dimensions | Analytics dashboard and config | Enterprise Edition only | -| `features:enterpriseEdition` | Analytics, navigation, Settings, profile | Analytics, AI adoption config, enterprise admin tabs, LiteLLM | All enterprise-only UI | **Runtime-computed** — reflects enterprise package auto-detection; not configurable via `customer-config.yaml` | -| `features:showAllProjects` | Settings → Administration → project selector | All projects returned by admin project picker (no limit or search minimum) | Admin project picker limited to 5 results with 3-char search minimum | | -| `visualWorkflowEditor` | Workflow editor page | Visual drag-and-drop editor (React Flow) | Visual editor (YAML only) | | -| `defaultConversationAssistant` | New chat creation | Pre-selects specified assistant | Default behavior (no pre-selection) | Requires `slug` parameter | -| `features:personalLiteLLMIntegrations` | Integrations → User tab | LiteLLM as a personal integration option for regular users | LiteLLM from personal integrations (only maintainers and administrators can manage) | Disabled by default | -| **PLATFORM-MANAGED MODE** | | | | | -| `features:userManagement` | Settings → Administration | Users management and Projects management tabs | Management tabs | **Runtime-computed** — reflects `ENABLE_USER_MANAGEMENT` backend env var; not configurable via `customer-config.yaml` | -| `features:budgetManagement` | Project detail pages, Settings → Administration | Budget columns and budget management section | Budget tracking UI | | -| **DYNAMIC TOOLS (Chat Interface)** | | | | | -| `features:webSearch` | Chat → Dynamic tools settings (gear icon) | "Web Search" toggle | Web search option | If both disabled, entire section hidden | -| `features:dynamicCodeInterpreter` | Chat → Dynamic tools settings (gear icon) | "Code Interpreter" toggle | Code interpreter option | If both disabled, entire section hidden | -| **BANNER CONFIGURATION** | | | | | -| `bannerMessage` | All pages (top banner) | Banner text displayed across the app | No banner shown | String, default: `""` — configurable via `customer-config.yaml` | -| `bannerLinkLabel` | All pages (top banner) | Label for the optional banner link | No link label shown | String, default: `""` — set alongside `bannerLinkRoute` | -| `bannerLinkRoute` | All pages (top banner) | Route for the optional banner link | No link route | String, default: `""` — set alongside `bannerLinkLabel` | -| **MCP CONFIGURATION** | | | | | -| `mcpAuthTimeoutSeconds` | MCP OAuth flow | MCP OAuth timeout duration | Uses default timeout | Integer, default: `60` — configurable via `customer-config.yaml` | -| **READ-ONLY RUNTIME FIELDS** | | | | | -| `idpProvider` | `/v1/config` API response | N/A (read-only field) | N/A | Reflects `IDP_PROVIDER` backend env var; default: `keycloak`; not configurable via `customer-config.yaml` | -| `mcpAuthOrigin` | `/v1/config` API response | N/A (read-only field) | N/A | Reflects `CALLBACK_API_BASE_URL` backend env var; not configurable via `customer-config.yaml` | -| **HELP CENTER LINKS** | | | | | -| `videoPortal` | Help Center → Learning Resources | Link card with "Open Guide" button | Link card | | -| `youtubeChannel` | Help Center → Learning Resources | YouTube channel link card | Link card | | -| `userGuide` | Help Center → Learning Resources | Documentation link card | Link card | | -| `userSurvey` | Help Center → Learning Resources | Survey form link card | Link card | | -| **CONTEXTUAL HELP (Conditional Display)** | | | | | -| `helpLinks:assistants:creating` | Create Assistant page (top-right) | Help documentation link | No documentation link | Triggers: Page load | -| `helpLinks:assistants:tools` | Assistant config → Tools section | Help documentation link | No documentation link | Triggers: User opens tools | -| `helpLinks:workflows:creating` | Create Workflow page (top-right) | Help documentation link | No documentation link | Triggers: Page load | -| `helpLinks:workflows:configuration` | Workflow editor → YAML tab | Help documentation link | No documentation link | Triggers: User switches to YAML | -| `helpLinks:integrations:selection:` | Integration creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | -| `helpLinks:datasources:selection:` | Data source creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | -| **ASSISTANT FEATURES** | | | | | -| `features:favorites` | Assistants list, Skills list, Workflows list | Favorite/Unfavorite action buttons | Favorite actions hidden | | -| `features:pinnedAssistants` | Assistants list, Navigation sidebar | Pin/Unpin actions and Pinned Assistants sidebar section | Pin actions and sidebar section hidden | | -| `features:favoritesPage` | Main navigation | Favorites page and navigation link | Favorites page and nav link hidden | Default: disabled | -| **DATASOURCE FEATURES** | | | | | -| `features:sharepointCodeMieOAuth` | Data Sources → SharePoint setup form | "Sign in with Microsoft (CodeMie Project)" authentication option | SharePoint PKCE auth option hidden | Requires `SHAREPOINT_PKCE_ENABLED=true` | -| **INTEGRATED APPLICATIONS** | | | | | -| `applications:` | Applications menu | Application card with icon | Application card | Type: `module`, `iframe`, or `link` | -| **PRECONFIGURED ASSISTANTS** | | | | | -| Any assistant ID | Assistants list, New chat dropdown, Help Center → AI Help | Assistant appears in all locations | Assistant hidden from all locations | Default: enabled if not configured | +| Component ID | Where It Appears | When Enabled Shows | When Disabled Hides | Notes | +| ----------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------- | +| **CORE FEATURES** | | | | | +| `adminActions` | Settings → Administration | Menu items: AI/Run Adoption, Categories, MCPs, Projects, Providers | Entire Administration menu | | +| `feedbackAssistant` | Help Center, Quick actions (top-right) | Feedback assistant card/button | Feedback collection interface | | +| `mcpConnect` | Assistant/Workflow config → Tools | "MCP Servers" option in dropdown | MCP integration option | | +| `mcpCustomServersDisabled` | Assistant/Workflow config → MCP Servers | Catalog-referenced and custom MCP servers | Possibility to configure custom MCP servers | | +| `skills` | Navigation, Chat config, Assistant config | Skills menu, skill selector, management pages | Entire Skills subsystem | Major feature gate | +| `aiAdoption` | Analytics page, Settings → Administration | Analytics dashboard with 4 dimensions | Analytics dashboard and config | Enterprise Edition only | +| `features:showAllProjects` | Settings → Administration → project selector | All projects returned by admin project picker (no limit or search minimum) | Admin project picker limited to 5 results with 3-char search minimum | | +| `defaultConversationAssistant` | New chat creation | Pre-selects specified assistant | Default behavior (no pre-selection) | Requires `slug` parameter | +| `features:personalLiteLLMIntegrations` | Integrations → User tab | LiteLLM as a personal integration option for regular users | LiteLLM from personal integrations (only maintainers and administrators can manage) | Disabled by default | +| **PLATFORM-MANAGED MODE** | | | | | +| `features:budgetManagement` | Project detail pages, Settings → Administration | Budget columns and budget management section | Budget tracking UI | | +| **DYNAMIC TOOLS (Chat Interface)** | | | | | +| `features:webSearch` | Chat → Dynamic tools settings (gear icon) | "Web Search" toggle | Web search option | If both disabled, entire section hidden | +| `features:dynamicCodeInterpreter` | Chat → Dynamic tools settings (gear icon) | "Code Interpreter" toggle | Code interpreter option | If both disabled, entire section hidden | +| **BANNER CONFIGURATION** | | | | | +| `bannerMessage` | All pages (top banner) | Banner text displayed across the app | No banner shown | String, default: `""` — configurable via `customer-config.yaml` | +| `bannerLinkLabel` | All pages (top banner) | Label for the optional banner link | No link label shown | String, default: `""` — set alongside `bannerLinkRoute` | +| `bannerLinkRoute` | All pages (top banner) | Route for the optional banner link | No link route | String, default: `""` — set alongside `bannerLinkLabel` | +| **MCP CONFIGURATION** | | | | | +| `mcpAuthTimeoutSeconds` | MCP OAuth flow | MCP OAuth timeout duration | Uses default timeout | Integer, default: `60` — configurable via `customer-config.yaml` | +| **HELP CENTER LINKS** | | | | | +| `videoPortal` | Help Center → Learning Resources | Link card with "Open Guide" button | Link card | | +| `youtubeChannel` | Help Center → Learning Resources | YouTube channel link card | Link card | | +| `userGuide` | Help Center → Learning Resources | Documentation link card | Link card | | +| `userSurvey` | Help Center → Learning Resources | Survey form link card | Link card | | +| **CONTEXTUAL HELP (Conditional Display)** | | | | | +| `helpLinks:assistants:creating` | Create Assistant page (top-right) | Help documentation link | No documentation link | Triggers: Page load | +| `helpLinks:assistants:tools` | Assistant config → Tools section | Help documentation link | No documentation link | Triggers: User opens tools | +| `helpLinks:workflows:creating` | Create Workflow page (top-right) | Help documentation link | No documentation link | Triggers: Page load | +| `helpLinks:workflows:configuration` | Workflow editor → YAML tab | Help documentation link | No documentation link | Triggers: User switches to YAML | +| `helpLinks:integrations:selection:` | Integration creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | +| `helpLinks:datasources:selection:` | Data source creation form | Help link for selected type | No documentation link | Triggers: User selects type from dropdown | +| **ASSISTANT FEATURES** | | | | | +| `features:favorites` | Assistants list, Skills list, Workflows list | Favorite/Unfavorite action buttons | Favorite actions hidden | | +| `features:pinnedAssistants` | Assistants list, Navigation sidebar | Pin/Unpin actions and Pinned Assistants sidebar section | Pin actions and sidebar section hidden | | +| `features:favoritesPage` | Main navigation | Favorites page and navigation link | Favorites page and nav link hidden | Default: disabled | +| **DATASOURCE FEATURES** | | | | | +| `features:sharepointCodeMieOAuth` | Data Sources → SharePoint setup form | "Sign in with Microsoft (CodeMie Project)" authentication option | SharePoint PKCE auth option hidden | Requires `SHAREPOINT_PKCE_ENABLED=true` | +| **INTEGRATED APPLICATIONS** | | | | | +| `applications:` | Applications menu | Application card with icon | Application card | Type: `module`, `iframe`, or `link` | +| **PRECONFIGURED ASSISTANTS** | | | | | +| Any assistant ID | Assistants list, New chat dropdown, Help Center → AI Help | Assistant appears in all locations | Assistant hidden from all locations | Default: enabled if not configured | ## Configuration Parameters @@ -290,12 +284,6 @@ components: enabled: true ``` -:::warning `features:userManagement` is runtime-computed -As of CodeMie 2.40.0, `features:userManagement` is derived automatically from the `ENABLE_USER_MANAGEMENT` backend environment variable. Setting this entry in `customer-config.yaml` has no effect. To enable the Platform-managed mode UI, set `ENABLE_USER_MANAGEMENT=true` in the `codemie-api` Helm chart. - -See [Platform-Managed Mode Configuration](../access-control/platform-managed-mode-configuration.md) for full setup instructions. -::: - ### Advanced Features **Fields used in this section:** @@ -395,52 +383,6 @@ components: description: "Show Sign in with Microsoft (CodeMie Project) authentication option for SharePoint datasource" ``` -:::warning `features:enterpriseEdition` is runtime-computed -As of CodeMie 2.40.0, `features:enterpriseEdition` is determined automatically through enterprise package auto-detection. Setting this entry in `customer-config.yaml` has no effect. -::: - -### Banner Configuration - -Controls the banner message displayed at the top of all pages. - -**Fields used in this section:** - -```yaml -settings: - enabled: true # Required - value: "..." # String value for the configuration entry -``` - -```yaml -components: - # WHERE: All pages — top banner area - # WHEN SET: Displays a banner with the specified text across the entire application - # WHEN EMPTY: No banner is shown - # NOTE: Default is "" (empty — no banner displayed) - - id: "bannerMessage" - settings: - enabled: true - value: "Scheduled maintenance on Saturday 00:00–02:00 UTC" - - # WHERE: Top banner (appears alongside bannerMessage) - # WHEN SET: Shows a clickable link with this label in the banner - # WHEN EMPTY: No link label shown - # NOTE: Set alongside bannerLinkRoute; default is "" - - id: "bannerLinkLabel" - settings: - enabled: true - value: "Learn more" - - # WHERE: Top banner (appears alongside bannerMessage) - # WHEN SET: Route navigated to when the banner link is clicked - # WHEN EMPTY: No link route set - # NOTE: Set alongside bannerLinkLabel; default is "" - - id: "bannerLinkRoute" - settings: - enabled: true - value: "/help" -``` - ### MCP Auth Configuration Controls the timeout for MCP OAuth flows. diff --git a/docs/admin/update/release-notes.md b/docs/admin/update/release-notes.md index 304226bd..fdb75697 100644 --- a/docs/admin/update/release-notes.md +++ b/docs/admin/update/release-notes.md @@ -80,19 +80,19 @@ No third-party component updates in this release. 3. **`features:userManagement` and `features:enterpriseEdition` are now runtime-computed** — remove these entries from `customer-config.yaml` if present; they are ignored at runtime. - | Entry | Now computed from | - | ---------------------------- | ----------------------------------------------- | - | `features:userManagement` | `ENABLE_USER_MANAGEMENT` environment variable | - | `features:enterpriseEdition` | Enterprise package auto-detection | + | Entry | Now computed from | + | ---------------------------- | --------------------------------------------- | + | `features:userManagement` | `ENABLE_USER_MANAGEMENT` environment variable | + | `features:enterpriseEdition` | Enterprise package auto-detection | 4. **New YAML-configurable entries added to `customer-config.yaml`**: - | New entry | Description | - | ----------------------- | ------------------------------------------------------- | + | New entry | Description | + | ----------------------- | ------------------------------------------------------ | | `mcpAuthTimeoutSeconds` | MCP authentication timeout in seconds (default: `60`) | - | `bannerMessage` | Text content of the banner message (default: disabled) | - | `bannerLinkLabel` | Label for the banner link (default: disabled) | - | `bannerLinkRoute` | Route/URL for the banner link (default: disabled) | + | `bannerMessage` | Text content of the banner message (default: disabled) | + | `bannerLinkLabel` | Label for the banner link (default: disabled) | + | `bannerLinkRoute` | Route/URL for the banner link (default: disabled) | See [Customer Feature Configuration](../configuration/codemie/customer-feature-configuration.md) for configuration details. @@ -917,4 +917,4 @@ To upgrade Fluent Bit to version 4.2.3.1, follow the [Fluent Bit Upgrade Guide]( No breaking configuration changes were introduced in this release. All existing Fluent Bit configurations remain compatible. - \ No newline at end of file + From 9f7d3f146c6dfa11255a38b3281920ae3c1354fd Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Thu, 16 Jul 2026 16:27:09 +0300 Subject: [PATCH 4/8] docs(config): fix 2.40.0 release notes for runtime-computed feature flags MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit viteEnableUserManagement and VITE_IS_ENTERPRISE_EDITION do not map to customer-config.yaml entries — they are computed on the backend from ENABLE_USER_MANAGEMENT env var and enterprise package presence. Move them to the backend-computed table (item 2) and remove features:userManagement and features:enterpriseEdition from the customer-config.yaml migration code block. Generated with AI Co-Authored-By: codemie-ai --- docs/admin/update/release-notes.md | 24 +++++++----------------- 1 file changed, 7 insertions(+), 17 deletions(-) diff --git a/docs/admin/update/release-notes.md b/docs/admin/update/release-notes.md index fdb75697..5da83b2f 100644 --- a/docs/admin/update/release-notes.md +++ b/docs/admin/update/release-notes.md @@ -34,25 +34,13 @@ No third-party component updates in this release. | Removed variable | Was in | Default | Replacement in `customer-config.yaml` | | ---------------------------- | --------------------------- | ------- | ------------------------------------- | - | `viteEnableUserManagement` | `codemie-ui` Helm values | `false` | `features:userManagement` | | `viteEnableBudgetManagement` | `codemie-ui` Helm values | `false` | `features:budgetManagement` | - | `VITE_IS_ENTERPRISE_EDITION` | `codemie-ui` runtime config | `false` | `features:enterpriseEdition` | | `VITE_SHOW_ALL_PROJECTS` | `codemie-ui` runtime config | `false` | `features:showAllProjects` | Add the required entries to `customer-config.yaml`: ```yaml components: - # Required if VITE_IS_ENTERPRISE_EDITION was true (enterprise deployments) - - id: "features:enterpriseEdition" - settings: - enabled: true - - # Required if viteEnableUserManagement was true - - id: "features:userManagement" - settings: - enabled: true - # Required if viteEnableBudgetManagement was true - id: "features:budgetManagement" settings: @@ -68,11 +56,13 @@ No third-party component updates in this release. 2. **Additional frontend env vars removed from `codemie-ui`** — no `customer-config.yaml` action required for these; they are now computed at runtime by the backend. - | Removed variable | Was in | Now computed from | - | ------------------- | ------------------------ | ----------------------------------------------- | - | `viteIdpProvider` | `codemie-ui` Helm values | `IDP_PROVIDER` environment variable | - | `viteMcpAuthOrigin` | `codemie-ui` Helm values | `CALLBACK_API_BASE_URL` environment variable | - | `viteBannerMessage` | `codemie-ui` Helm values | `bannerMessage` entry in `customer-config.yaml` | + | Removed variable | Was in | Now computed from | + | ---------------------------- | --------------------------- | ----------------------------------------------- | + | `viteEnableUserManagement` | `codemie-ui` Helm values | `ENABLE_USER_MANAGEMENT` backend env var | + | `VITE_IS_ENTERPRISE_EDITION` | `codemie-ui` runtime config | Enterprise package auto-detection | + | `viteIdpProvider` | `codemie-ui` Helm values | `IDP_PROVIDER` environment variable | + | `viteMcpAuthOrigin` | `codemie-ui` Helm values | `CALLBACK_API_BASE_URL` environment variable | + | `viteBannerMessage` | `codemie-ui` Helm values | `bannerMessage` entry in `customer-config.yaml` | :::tip Banner message migration If `viteBannerMessage` was set in your deployment, move its value to the new `bannerMessage` entry in `customer-config.yaml` (see item 4 below). From 72c5c7285790083297a86fbfdcd5815feabe2002 Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Thu, 16 Jul 2026 16:31:53 +0300 Subject: [PATCH 5/8] docs(config): clarify 2.40.0 breaking change for removed codemie-ui vars MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Consolidate items 1 and 2 into a single table covering all removed frontend variables with an explicit 'Action required?' column. The danger note now targets only viteEnableBudgetManagement and VITE_SHOW_ALL_PROJECTS — the two variables that need customer-config.yaml entries. Backend-computed variables are listed in the same table as no-action rows. Generated with AI Co-Authored-By: codemie-ai --- docs/admin/update/release-notes.md | 37 +++++++++++------------------- 1 file changed, 14 insertions(+), 23 deletions(-) diff --git a/docs/admin/update/release-notes.md b/docs/admin/update/release-notes.md index 5da83b2f..78393345 100644 --- a/docs/admin/update/release-notes.md +++ b/docs/admin/update/release-notes.md @@ -26,19 +26,22 @@ No third-party component updates in this release.

Configuration Changes

-1. **[BREAKING] Frontend feature flags moved to backend config** — the following UI configuration variables have been removed from the `codemie-ui` Helm chart and runtime config. They are now controlled through `customer-config.yaml`, allowing runtime changes without redeploying the UI. +1. **[BREAKING] Frontend environment variables removed from `codemie-ui`** — the following variables have been removed from the `codemie-ui` Helm chart and runtime config. Each has been replaced by a backend-side mechanism: either a `customer-config.yaml` entry or automatic backend computation. Review the table below to determine whether action is required in your deployment. + + | Removed variable | Was in | Default | Replaced by | Action required? | + | ---------------------------- | --------------------------- | ------- | ------------------------------------------------------ | ------------------------- | + | `viteEnableBudgetManagement` | `codemie-ui` Helm values | `false` | `features:budgetManagement` in `customer-config.yaml` | **Yes** — if was `true` | + | `VITE_SHOW_ALL_PROJECTS` | `codemie-ui` runtime config | `false` | `features:showAllProjects` in `customer-config.yaml` | **Yes** — if was `true` | + | `viteEnableUserManagement` | `codemie-ui` Helm values | `false` | Computed from `ENABLE_USER_MANAGEMENT` backend env var | No — backend-controlled | + | `VITE_IS_ENTERPRISE_EDITION` | `codemie-ui` runtime config | `false` | Computed from enterprise package auto-detection | No — backend-controlled | + | `viteIdpProvider` | `codemie-ui` Helm values | — | Computed from `IDP_PROVIDER` backend env var | No — backend-controlled | + | `viteMcpAuthOrigin` | `codemie-ui` Helm values | — | Computed from `CALLBACK_API_BASE_URL` backend env var | No — backend-controlled | + | `viteBannerMessage` | `codemie-ui` Helm values | — | `bannerMessage` entry in `customer-config.yaml` | Only if banner was in use | :::danger Breaking Change - If any of the removed variables were explicitly set to `true` in your deployment, you must add the corresponding entry to `customer-config.yaml` before upgrading. Failing to do so will cause affected features to silently revert to their disabled state. + If `viteEnableBudgetManagement` or `VITE_SHOW_ALL_PROJECTS` was explicitly set to `true` in your deployment, add the corresponding entry to `customer-config.yaml` before upgrading. Failing to do so will cause affected features to silently revert to their disabled state. ::: - | Removed variable | Was in | Default | Replacement in `customer-config.yaml` | - | ---------------------------- | --------------------------- | ------- | ------------------------------------- | - | `viteEnableBudgetManagement` | `codemie-ui` Helm values | `false` | `features:budgetManagement` | - | `VITE_SHOW_ALL_PROJECTS` | `codemie-ui` runtime config | `false` | `features:showAllProjects` | - - Add the required entries to `customer-config.yaml`: - ```yaml components: # Required if viteEnableBudgetManagement was true @@ -52,30 +55,18 @@ No third-party component updates in this release. enabled: true ``` - See [Customer Feature Configuration](../configuration/codemie/customer-feature-configuration.md) for full deployment instructions. - -2. **Additional frontend env vars removed from `codemie-ui`** — no `customer-config.yaml` action required for these; they are now computed at runtime by the backend. - - | Removed variable | Was in | Now computed from | - | ---------------------------- | --------------------------- | ----------------------------------------------- | - | `viteEnableUserManagement` | `codemie-ui` Helm values | `ENABLE_USER_MANAGEMENT` backend env var | - | `VITE_IS_ENTERPRISE_EDITION` | `codemie-ui` runtime config | Enterprise package auto-detection | - | `viteIdpProvider` | `codemie-ui` Helm values | `IDP_PROVIDER` environment variable | - | `viteMcpAuthOrigin` | `codemie-ui` Helm values | `CALLBACK_API_BASE_URL` environment variable | - | `viteBannerMessage` | `codemie-ui` Helm values | `bannerMessage` entry in `customer-config.yaml` | - :::tip Banner message migration If `viteBannerMessage` was set in your deployment, move its value to the new `bannerMessage` entry in `customer-config.yaml` (see item 4 below). ::: -3. **`features:userManagement` and `features:enterpriseEdition` are now runtime-computed** — remove these entries from `customer-config.yaml` if present; they are ignored at runtime. +2. **`features:userManagement` and `features:enterpriseEdition` are now runtime-computed** — remove these entries from `customer-config.yaml` if present; they are ignored at runtime. | Entry | Now computed from | | ---------------------------- | --------------------------------------------- | | `features:userManagement` | `ENABLE_USER_MANAGEMENT` environment variable | | `features:enterpriseEdition` | Enterprise package auto-detection | -4. **New YAML-configurable entries added to `customer-config.yaml`**: +3. **New YAML-configurable entries added to `customer-config.yaml`**: | New entry | Description | | ----------------------- | ------------------------------------------------------ | From e71957dcae4616a76afd66b85c6e0e4808159c77 Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Thu, 16 Jul 2026 16:36:05 +0300 Subject: [PATCH 6/8] docs(config): simplify 2.40.0 breaking change table in release notes Remove 'Was in' and 'Action required' columns, drop the danger/tip admonitions, the yaml codeblock, and the runtime-computed step. Single table now lists all removed codemie-ui vars with their backend replacements. Generated with AI Co-Authored-By: codemie-ai --- docs/admin/update/release-notes.md | 50 +++++++----------------------- 1 file changed, 12 insertions(+), 38 deletions(-) diff --git a/docs/admin/update/release-notes.md b/docs/admin/update/release-notes.md index 78393345..d27f11f2 100644 --- a/docs/admin/update/release-notes.md +++ b/docs/admin/update/release-notes.md @@ -26,47 +26,21 @@ No third-party component updates in this release.

Configuration Changes

-1. **[BREAKING] Frontend environment variables removed from `codemie-ui`** — the following variables have been removed from the `codemie-ui` Helm chart and runtime config. Each has been replaced by a backend-side mechanism: either a `customer-config.yaml` entry or automatic backend computation. Review the table below to determine whether action is required in your deployment. - - | Removed variable | Was in | Default | Replaced by | Action required? | - | ---------------------------- | --------------------------- | ------- | ------------------------------------------------------ | ------------------------- | - | `viteEnableBudgetManagement` | `codemie-ui` Helm values | `false` | `features:budgetManagement` in `customer-config.yaml` | **Yes** — if was `true` | - | `VITE_SHOW_ALL_PROJECTS` | `codemie-ui` runtime config | `false` | `features:showAllProjects` in `customer-config.yaml` | **Yes** — if was `true` | - | `viteEnableUserManagement` | `codemie-ui` Helm values | `false` | Computed from `ENABLE_USER_MANAGEMENT` backend env var | No — backend-controlled | - | `VITE_IS_ENTERPRISE_EDITION` | `codemie-ui` runtime config | `false` | Computed from enterprise package auto-detection | No — backend-controlled | - | `viteIdpProvider` | `codemie-ui` Helm values | — | Computed from `IDP_PROVIDER` backend env var | No — backend-controlled | - | `viteMcpAuthOrigin` | `codemie-ui` Helm values | — | Computed from `CALLBACK_API_BASE_URL` backend env var | No — backend-controlled | - | `viteBannerMessage` | `codemie-ui` Helm values | — | `bannerMessage` entry in `customer-config.yaml` | Only if banner was in use | +1. **[BREAKING] Frontend environment variables removed from `codemie-ui`** — the following variables have been removed from the `codemie-ui` Helm chart and runtime config and replaced by backend-side mechanisms. - :::danger Breaking Change - If `viteEnableBudgetManagement` or `VITE_SHOW_ALL_PROJECTS` was explicitly set to `true` in your deployment, add the corresponding entry to `customer-config.yaml` before upgrading. Failing to do so will cause affected features to silently revert to their disabled state. - ::: - - ```yaml - components: - # Required if viteEnableBudgetManagement was true - - id: "features:budgetManagement" - settings: - enabled: true - - # Required if VITE_SHOW_ALL_PROJECTS was true - - id: "features:showAllProjects" - settings: - enabled: true - ``` - - :::tip Banner message migration - If `viteBannerMessage` was set in your deployment, move its value to the new `bannerMessage` entry in `customer-config.yaml` (see item 4 below). - ::: - -2. **`features:userManagement` and `features:enterpriseEdition` are now runtime-computed** — remove these entries from `customer-config.yaml` if present; they are ignored at runtime. + | Removed variable | Default | Replaced by | + | ---------------------------- | ------- | ------------------------------------------------------ | + | `viteEnableBudgetManagement` | `false` | `features:budgetManagement` in `customer-config.yaml` | + | `VITE_SHOW_ALL_PROJECTS` | `false` | `features:showAllProjects` in `customer-config.yaml` | + | `viteEnableUserManagement` | `false` | Computed from `ENABLE_USER_MANAGEMENT` backend env var | + | `VITE_IS_ENTERPRISE_EDITION` | `false` | Computed from enterprise package auto-detection | + | `viteIdpProvider` | — | Computed from `IDP_PROVIDER` backend env var | + | `viteMcpAuthOrigin` | — | Computed from `CALLBACK_API_BASE_URL` backend env var | + | `viteBannerMessage` | — | `bannerMessage` entry in `customer-config.yaml` | - | Entry | Now computed from | - | ---------------------------- | --------------------------------------------- | - | `features:userManagement` | `ENABLE_USER_MANAGEMENT` environment variable | - | `features:enterpriseEdition` | Enterprise package auto-detection | + See [Customer Feature Configuration](../configuration/codemie/customer-feature-configuration.md) for full deployment instructions. -3. **New YAML-configurable entries added to `customer-config.yaml`**: +2. **New YAML-configurable entries added to `customer-config.yaml`**: | New entry | Description | | ----------------------- | ------------------------------------------------------ | From f8e86cb4cbe6930a653bdd9eea6cf0491228d7f1 Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Thu, 16 Jul 2026 16:47:56 +0300 Subject: [PATCH 7/8] docs(user-guide): document feature flags migration to backend config --- ...enable-project-and-user-management-in-codemie.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/faq/how-do-i-enable-project-and-user-management-in-codemie.md b/faq/how-do-i-enable-project-and-user-management-in-codemie.md index a3cafe28..4599e669 100644 --- a/faq/how-do-i-enable-project-and-user-management-in-codemie.md +++ b/faq/how-do-i-enable-project-and-user-management-in-codemie.md @@ -3,7 +3,7 @@ Project & User Management requires **Platform-managed mode** to be enabled by a platform administrator. It is off by default. -To enable it, add the following to the `codemie-api` Helm chart and redeploy: +To enable it, set the following values in your Helm charts and redeploy both components: **`codemie-api` — `extraEnv`:** @@ -15,7 +15,16 @@ extraEnv: value: '3' ``` -After applying the change, the **Projects management** and **Users management** tabs +**`customer-config.yaml` — feature flags:** + +```yaml +components: + - id: "features:budgetManagement" + settings: + enabled: true +``` + +After applying both changes, the **Projects management** and **Users management** tabs appear under **Settings → Administration** for users with the Admin role. If you are switching from an existing Keycloak-managed deployment, you also need to run a From ba91b9cbd03964571307c28f8cb0feed4fce259e Mon Sep 17 00:00:00 2001 From: Kostiantyn Pshenychnyi Date: Mon, 27 Jul 2026 15:36:43 +0300 Subject: [PATCH 8/8] docs(config): move budget management flag under backend section --- .../access-control/platform-managed-mode-configuration.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/admin/configuration/access-control/platform-managed-mode-configuration.md b/docs/admin/configuration/access-control/platform-managed-mode-configuration.md index f0f21d8b..485de6e5 100644 --- a/docs/admin/configuration/access-control/platform-managed-mode-configuration.md +++ b/docs/admin/configuration/access-control/platform-managed-mode-configuration.md @@ -24,7 +24,7 @@ For a comparison of both modes, see the ## Prerequisites -- Access to the Kubernetes cluster and Helm values file of AI/Run CodeMie Backend and UI +- Access to the Kubernetes cluster and the Helm values file of AI/Run CodeMie Backend (`codemie-api`) - If migrating from an existing Keycloak deployment: Keycloak service account client with `realm-management` roles in the target realm (see [Create Keycloak service account client](#create-keycloak-service-account-client)) --- @@ -51,10 +51,6 @@ UI instead of being read from Keycloak JWT claims. assigned to. Super Admins are always exempt from this limit. Adjust the value to match your organisation's policy. -Apply the changes to the deployment. - -### AI/Run CodeMie UI - To enable budget tracking, add the following entry to `customer-config.yaml`: ```yaml