@nocobase/plugin-ai 2.1.0-beta.44 → 2.1.0-beta.46

package/dist/ai/docs/nocobase/solution/all-in-one/installation.md

@@ -0,0 +1,181 @@
+---
+title: "All-in-One Business Suite - Installation"
+description: "Install the All-in-One Business Suite: one-click restore of the .nbdata backup file via Backup Manager. Requires NocoBase v2.1.0-alpha.40 or above and PostgreSQL 16; DB_UNDERSCORED must not be true."
+keywords: "all-in-one business suite installation, All-in-One, backup restore, Backup Manager, nbdata, PostgreSQL, NocoBase"
+---
+
+# Installation
+
+The All-in-One Business Suite covers six modules: **CRM, Sales Management, Help Desk, Project Management, IT Asset Management, and HR**. Use NocoBase's built-in **Backup Manager** plugin to restore the `.nbdata` backup file in one click and get the complete dataset.
+
+:::tip Prerequisites
+
+- A working NocoBase environment. For the main installation, see the [official installation docs](https://docs.nocobase.com/welcome/getting-started/installation)
+- NocoBase **v2.1.0-alpha.40 or above** (the Backup Manager plugin is open source since this version, available in the Community Edition)
+- The backup file downloaded: [nocobase_all_in_one_backup_260521.nbdata](https://static-docs.nocobase.com/nocobase_all_in_one_backup_260521.nbdata)
+
+:::
+
+:::warning Note
+
+- The solution is built on **PostgreSQL 16** — your environment must use PostgreSQL 16
+- **`DB_UNDERSCORED` must not be `true`** — check your `docker-compose.yml`; restore will fail if it is set to `true`
+- **Restore overwrites ALL data in the target app** — if the target already has data, back up the current app first and run the restore carefully
+
+:::
+
+The current release is deployed via **backup restore**. Future releases will switch to incremental migration to make integration with existing NocoBase systems easier.
+
+---
+
+## Steps
+
+### Step 1: Start the app with the `full` image
+
+Use the `full` Docker image. It bundles the database client and other companion tools, so no extra configuration is needed:
+
+```bash
+docker pull nocobase/nocobase:alpha-full
+```
+
+Then start NocoBase from this image.
+
+:::tip
+
+Without the `full` image, you may need to install the `pg_dump` client inside the container manually — a tedious and brittle process.
+
+:::
+
+### Step 2: Enable the Backup Manager plugin
+
+1. Sign in to NocoBase
+2. Open **Plugin Manager**
+3. Find and enable **Backup Manager**
+
+### Step 3: Restore from the local backup file
+
+1. After enabling the plugin, refresh the page
+2. From the left menu, go to **System Management / Backup Manager**
+
+   ![Backup Manager main UI](https://static-docs.nocobase.com/202510302154966.png)
+
+3. Click **Restore from local backup** in the top right
+4. Drag the downloaded `nocobase_all_in_one_backup_260521.nbdata` file onto the upload area
+
+   ![Restore from local backup file (upload dialog)](https://static-docs.nocobase.com/202510302155602.png)
+
+5. Click **Submit** and wait for the restore to complete — typically tens of seconds to a few minutes
+
+---
+
+## Notes
+
+- **Database compatibility** — PostgreSQL version, character set, and case sensitivity must match the backup source; the `schema` name in particular must be identical
+- **Commercial plugin match** — every commercial plugin used in the backup must be installed and enabled locally first, or the restore will be interrupted. The All-in-One solution uses commercial plugins such as Email Manager, Audit Log, and AI Employees. On the Community Edition, the entry points for missing plugins simply do not appear and the other modules are unaffected
+
+---
+
+## Post-install configuration
+
+The system is usable once the restore finishes, but two settings still point at our demo environment and need to be switched to your own.
+
+### 1. File storage engine (OSS / local)
+
+The demo backup ships with a storage engine pointing at our Alibaba Cloud OSS. The Access Key is not public, so any attachment field, print template, or AI employee avatar upload will fail.
+
+Local storage is usually enough; switch to your own OSS only when you need CDN acceleration or large-file workloads.
+
+**Switching steps:**
+
+1. Open **Plugin Manager / File Manager** (or go to `/admin/settings/file-manager`)
+
+2. **Option A — use local storage** (simplest, suited for self-hosted deployments):
+
+   - Find the auto-created **Local Storage** entry
+   - Click **Edit**, check **Set as default storage engine** at the bottom of the config panel, then submit
+
+   ![Storage engine common config (the "Set as default storage engine" toggle at the bottom)](https://static-docs.nocobase.com/20240529115151.png)
+
+   :::warning Note
+
+   For Docker deployments, local storage lives inside the container; deleting the container loses the files. In production, mount a volume or use cloud storage.
+
+   :::
+
+3. **Option B — use your own OSS / S3 / COS**:
+
+   - Click **Add new**, choose the matching type (Alibaba Cloud OSS / Amazon S3 / Tencent Cloud COS / S3 Pro)
+   - Fill in Access Key, Bucket, Region, domain, and other parameters, check **Set as default storage engine**, then submit
+
+   ![Alibaba Cloud OSS storage engine config example](https://static-docs.nocobase.com/20240712220011.png)
+
+4. Delete or disable the demo-preset OSS entry to avoid accidental use
+
+See [Storage engine overview](../../file-manager/storage/index.md) for parameter details.
+
+### 2. AI Employees LLM service keys
+
+The demo backup preloads several LLM service entries (OpenAI, Claude, Gemini, DeepSeek, Qwen, Kimi, etc.) using our own API keys, which **will not work for you**. The AI Employees features are unusable until you swap them out.
+
+**Configuration steps:**
+
+1. Open **System Settings / AI Employees / LLM service** (or go to `/admin/settings/ai/llm-services`)
+
+   ![Opening the LLM service config page](https://static-docs.nocobase.com/00_QuickStart_cn-2025-09-29-15-40-47.png)
+
+2. The preloaded service list supports drag-to-reorder and an **Enabled** toggle
+
+   ![LLM service list (enable toggle + sorting)](https://static-docs.nocobase.com/ai-employees/2026-02-14/llm-service-list-enabled-and-sort.png)
+
+3. For each service you plan to use:
+
+   - Click **Edit**
+   - Replace **API Key** with your own (from the matching provider account: OpenAI, Anthropic, Google AI Studio, DeepSeek, Qwen, Kimi, etc.)
+   - Adjust **Base URL** if you use a proxy or a regional relay
+   - In **Enabled Models**, keep the models you need and remove the rest
+
+   ![Editing an LLM service (API Key, Base URL, Enabled Models)](https://static-docs.nocobase.com/00_QuickStart_cn-2025-09-29-15-45-27.png)
+
+4. Click **Test flight** at the bottom to check connectivity, then **Submit** to save
+
+   ![Test flight connection check](https://static-docs.nocobase.com/00_QuickStart_cn-2025-09-29-16-18-25.png)
+
+5. For services you do not plan to use, just toggle **Disabled** — no need to delete
+
+See [Configure LLM service](../../ai-employees/features/llm-service.md) for the full configuration.
+
+:::tip
+
+These two are the only must-change items after restoring the demo. Other settings (site logo, SMTP, Enterprise plugins, etc.) can be tuned as needed.
+
+:::
+
+---
+
+## FAQ
+
+### Will it work on the Community Edition? Any errors?
+
+Yes, it works out of the box with no errors. Backup Manager has been open source since `v2.1.0-alpha.40`, so the Community Edition can install it. The demo does use some Enterprise plugins (Email Manager, Audit Log, AI Employees, etc.); on the Community Edition, the entry points for those features simply do not appear, but other modules are unaffected. For example, the Audit Log entry disappears, while CRM, Sales, Help Desk, Project, Asset, HR, and other core modules work normally.
+
+### Which version should I use after restore?
+
+Use the latest `alpha-full` image (`nocobase/nocobase:alpha-full`). The `full` image bundles the database client and other dependencies, avoiding restore failures caused by missing tools.
+
+### The logo does not display after restore?
+
+The logo in the official online demo has a domain restriction and cannot load on a local domain. Open **System Settings** and upload your own logo.
+
+### File upload fails (OSS key error)?
+
+The demo backup's preset storage engine points at our own OSS, and the key is not public. Open **Plugin Manager / File Manager**, set **Local Storage** as the default storage, save, and uploads will work again.
+
+See the [File storage engine](#1-file-storage-engine-oss--local) section above for details.
+
+### How do I switch languages?
+
+The All-in-One solution ships with localization for 20+ languages (under the `nb_demo` namespace). After restore, the default language is Chinese; switch via **System Settings / enable the target language**.
+
+### What about incremental upgrades?
+
+Today the upgrade path is a full replacement, which means custom changes are overwritten. Always back up before upgrading. An incremental migration plan is in the works.

package/dist/ai/docs/nocobase/solution/crm/changelog.md

@@ -8,7 +8,6 @@ This page documents the update history for the CRM solution. New entries are add
 
 **Backup files**:
 - [nocobase_crm_v2_backup_260406.nbdata](https://static-docs.nocobase.com/nocobase_crm_v2_backup_260406.nbdata)
-- [nocobase_crm_v2_sql_260406.zip](https://static-docs.nocobase.com/nocobase_crm_v2_sql_260406.zip)
 
 **Changes**:
 - Fixed table Summary aggregation display issue
@@ -24,7 +23,6 @@ This page documents the update history for the CRM solution. New entries are add
 
 **Backup files**:
 - [nocobase_crm_v2_backup_260327.nbdata](https://static-docs.nocobase.com/nocobase_crm_v2_backup_260327.nbdata)
-- [nocobase_crm_v2_sql_260327.zip](https://static-docs.nocobase.com/nocobase_crm_v2_sql_260327.zip)
 
 **Changes**:
 
@@ -52,7 +50,6 @@ This page documents the update history for the CRM solution. New entries are add
 
 **Backup files**:
 - nocobase_crm_v2_backup_260223.nbdata
-- nocobase_crm_v2_sql_260223.zip
 
 **Changes**:
 - Initial release of CRM 2.0

package/dist/ai/docs/nocobase/solution/crm/installation.md

@@ -2,15 +2,13 @@
 
 > The current version is deployed via **backup and restore**. In future versions, we may switch to **incremental migration** to make it easier to integrate the solution into your existing systems.
 
-To help you deploy the CRM 2.0 solution smoothly to your own NocoBase environment, we provide two restoration methods. Please choose the one that best suits your edition and technical background.
+> **The Backup Manager plugin is now open-source**: The "[Backup Manager](https://docs-cn.nocobase.com/handbook/backups)" plugin needed to restore the solution is now open-source and available to all editions (including the Community Edition). We recommend restoring directly via this plugin.
 
 Before you begin, please ensure:
 
 - You have a basic NocoBase running environment. For main system installation, please refer to the [official installation documentation](https://docs-cn.nocobase.com/welcome/getting-started/installation).
 - NocoBase version **v2.1.0-beta.2 or above**.
-- You have downloaded the corresponding CRM system files:
-  - **Backup file**: [nocobase_crm_v2_backup_260406.nbdata](https://static-docs.nocobase.com/nocobase_crm_v2_backup_260406.nbdata) - For Method 1
-  - **SQL file**: [nocobase_crm_v2_sql_260406.zip](https://static-docs.nocobase.com/nocobase_crm_v2_sql_260406.zip) - For Method 2
+- You have downloaded the CRM system backup file: [nocobase_crm_v2_backup_260523.nbdata](https://static-docs.nocobase.com/nocobase_crm_v2_backup_260523.nbdata)
 
 **Important Notes**:
 - This solution is built on **PostgreSQL 16**. Please ensure your environment uses PostgreSQL 16.
@@ -18,9 +16,9 @@ Before you begin, please ensure:
 
 ---
 
-## Method 1: Restore Using Backup Manager (Recommended for Pro/Enterprise Users)
+## Restore Using Backup Manager
 
-This method uses NocoBase's built-in "[Backup Manager](https://docs-cn.nocobase.com/handbook/backups)" (Pro/Enterprise Edition) plugin for one-click restoration. It is the simplest operation but has certain requirements for the environment and edition.
+This method uses NocoBase's built-in "[Backup Manager](https://docs-cn.nocobase.com/handbook/backups)" plugin for one-click restoration. It is the simplest operation. This plugin is now open-source and available to all editions (including the Community Edition).
 
 ### Key Characteristics
 
@@ -28,9 +26,8 @@ This method uses NocoBase's built-in "[Backup Manager](https://docs-cn.nocobase.
   1. **Convenient operation**: Completed within the UI, allowing for full restoration of all configurations including plugins.
   2. **Complete restoration**: **Able to restore all system files**, including print template files and files uploaded via file fields in collections, ensuring full functional integrity.
 * **Limitations**:
-  1. **Pro/Enterprise Edition only**: "Backup Manager" is an enterprise-level plugin available only to Pro/Enterprise users.
-  2. **Strict environment requirements**: Requires your database environment (version, case sensitivity settings, etc.) to be highly compatible with the environment where the backup was created.
-  3. **Plugin dependency**: If the solution includes commercial plugins not present in your local environment, the restoration will fail.
+  1. **Strict environment requirements**: Requires your database environment (version, case sensitivity settings, etc.) to be highly compatible with the environment where the backup was created.
+  2. **Plugin dependency**: If the solution includes commercial plugins not present in your local environment, the restoration will fail.
 
 ### Steps
 
@@ -69,69 +66,6 @@ Then use this image to start your NocoBase service.
 
 ---
 
-## Method 2: Direct SQL File Import (Universal, Better for Community Edition)
-
-This method restores data by directly operating on the database, bypassing the "Backup Manager" plugin, and therefore has no Pro/Enterprise Edition restrictions.
-
-### Key Characteristics
-
-* **Advantages**:
-  1. **No edition restrictions**: Suitable for all NocoBase users, including Community Edition.
-  2. **High compatibility**: Does not rely on the `dump` tool within the application; as long as you can connect to the database, you can operate.
-  3. **High fault tolerance**: If the solution includes commercial plugins you do not have, the related features will not be enabled, but it will not affect the normal use of other features, and the application can start successfully.
-* **Limitations**:
-  1. **Requires database operation skills**: Users need basic database operation skills, such as how to execute a `.sql` file.
-  2. **System file loss**: **This method will lose all system files**, including print template files and files uploaded via file fields in collections.
-
-### Steps
-
-**Step 1: Prepare a clean database**
-
-Prepare a brand new, empty database for the data you are about to import.
-
-**Step 2: Import the `.sql` file into the database**
-
-Obtain the downloaded database file (usually in `.sql` format) and import its content into the database you prepared in the previous step. There are several ways to execute this, depending on your environment:
-
-* **Option A: Via server command line (using Docker as an example)**
-  If you use Docker to install NocoBase and the database, you can upload the `.sql` file to the server and then use the `docker exec` command to perform the import. Assuming your PostgreSQL container is named `my-nocobase-db` and the filename is `nocobase_crm_v2_sql_260327.sql`:
-
-  ```bash
-  # Copy the sql file into the container
-  docker cp nocobase_crm_v2_sql_260327.sql my-nocobase-db:/tmp/
-  # Enter the container and execute the import command
-  docker exec -it my-nocobase-db psql -U nocobase -d nocobase -f /tmp/nocobase_crm_v2_sql_260327.sql
-  ```
-* **Option B: Via a remote database client (Navicat, etc.)**
-  If your database port is exposed, you can use any graphical database client (such as Navicat, DBeaver, pgAdmin, etc.) to connect to the database, then:
-  1. Right-click the target database.
-  2. Select "Run SQL File" or "Execute SQL Script".
-  3. Select the downloaded `.sql` file and execute.
-
-**Step 3: Connect to the database and start the application**
-
-Configure your NocoBase startup parameters (such as environment variables `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USER`, `DB_PASSWORD`, etc.) to point to the database where you just imported the data. Then, start the NocoBase service normally.
-
-### Notes
-
-* **Database permissions**: This method requires you to have an account and password that can directly operate on the database.
-* **Plugin status**: After a successful import, although the data for commercial plugins included in the system exists, if you have not installed and enabled the corresponding plugins locally, the related features will not be displayed or usable, but this will not cause the application to crash.
-
----
-
-## Summary and Comparison
-
-| Feature | Method 1: Backup Manager | Method 2: Direct SQL Import |
-| :-------------- | :--------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------- |
-| **Applicable Users** | **Pro/Enterprise Edition** users | **All users** (including Community Edition) |
-| **Ease of Use** | ⭐⭐⭐⭐⭐ (Very simple, UI operation) | ⭐⭐⭐ (Requires basic database knowledge) |
-| **Environment Requirements** | **Strict**, database and system versions must be highly compatible | **General**, requires database compatibility |
-| **Plugin Dependency** | **Strong dependency**, plugins are validated during restoration; missing any plugin will cause **restoration failure**. | **Features strongly depend on plugins**. Data can be imported independently, and the system will have basic functionality. However, if corresponding plugins are missing, related features will be **completely unusable**. |
-| **System Files** | **Fully preserved** (print templates, uploaded files, etc.) | **Will be lost** (print templates, uploaded files, etc.) |
-| **Recommended Scenarios** | Enterprise users with controlled, consistent environments needing full functionality | Missing some plugins, seeking high compatibility and flexibility, non-Pro/Enterprise users, or those who can accept the loss of file features |
-
----
-
 ## FAQ
 
 ### Can Pro Edition users install this? Will it cause errors?
@@ -146,10 +80,6 @@ We recommend the latest `beta-full` image (e.g., `nocobase/nocobase:beta-full`).
 
 The demo's logo is configured with a domain restriction and cannot load on local domains. Go to **System Settings** and re-upload your own logo.
 
-### File upload error (OSS Key error)?
-
-After SQL import, file uploads may fail with an OSS-related error. Solution: go to **Plugin Manager → File Manager**, set **Local Storage** as the default storage, and save. Uploads will work normally after this.
-
 ### What about incremental upgrades?
 
 Currently, version upgrades are full replacements — your custom modifications will be overwritten. Always back up before upgrading. An incremental migration solution is being planned and will prioritize Pro/Enterprise editions. Community edition support is more difficult due to the lack of the migration management plugin.

package/dist/ai/docs/nocobase/solution/crm/v1.md

@@ -21,13 +21,13 @@ The legacy CRM includes the following functional modules:
 
 > The current version is deployed via backup and restoration.
 
+> **The Backup Manager plugin is now open-source**: The "[Backup Manager](https://docs.nocobase.com/handbook/backups)" plugin needed to restore the solution is now open-source and available to all editions (including the Community Edition). We recommend restoring directly via this plugin.
+
 Before you begin, please ensure:
 
 - You have a basic NocoBase runtime environment. For main system installation, please refer to the detailed [Official Installation Documentation](https://docs.nocobase.com/welcome/getting-started/installation).
 - NocoBase version **v2.1.0-beta.2 or higher**.
-- You have downloaded the corresponding CRM v1 files:
-  - **Backup file**: [nocobase_crm_v1_backup_260224.nbdata](https://static-docs.nocobase.com/nocobase_crm_v1_backup_260224.nbdata) — Applicable to Method 1.
-  - **SQL file**: [nocobase_crm_v1_sql_260224.zip](https://static-docs.nocobase.com/nocobase_crm_v1_sql_260224.zip) — Applicable to Method 2.
+- You have downloaded the CRM v1 backup file: [nocobase_crm_v1_backup_260224.nbdata](https://static-docs.nocobase.com/nocobase_crm_v1_backup_260224.nbdata)
 
 **Important Notes**:
 - This solution is based on the **PostgreSQL 16** database. Please ensure your environment uses PostgreSQL 16.
@@ -35,9 +35,9 @@ Before you begin, please ensure:
 
 ---
 
-## Method 1: Restore using Backup Manager (Recommended for Pro/Enterprise users)
+## Restore using Backup Manager
 
-This method uses the built-in "**Backup Manager**" (Pro/Enterprise) plugin for one-click restoration, which is the simplest approach.
+This method uses the built-in "**Backup Manager**" plugin for one-click restoration, which is the simplest approach. This plugin is now open-source and available to all editions (including the Community Edition).
 
 ### Steps
 
@@ -57,34 +57,5 @@ This method uses the built-in "**Backup Manager**" (Pro/Enterprise) plugin for o
 
 ### Notes
 
-* **Pro/Enterprise Edition Only**: "Backup Manager" is an enterprise-level plugin and is only available to Pro/Enterprise users.
+* **Database Compatibility**: Your PostgreSQL version, character set, and case sensitivity settings must match the backup source file.
 * **Commercial Plugin Compatibility**: Please ensure you have obtained and enabled the commercial plugins required for this solution.
-
----
-
-## Method 2: Import SQL file directly (General)
-
-This method restores data by directly operating on the database and is applicable to all NocoBase users.
-
-### Steps
-
-**Step 1: Prepare a clean database**
-
-Prepare a brand new, empty database for the data you are about to import.
-
-**Step 2: Import the `.sql` file into the database**
-
-* **Via Command Line (Docker Example)**:
-
-  ```bash
-  # Copy the sql file into the container
-  docker cp nocobase_crm_v1_sql_260224.sql my-nocobase-db:/tmp/
-  # Enter the container and execute the import command
-  docker exec -it my-nocobase-db psql -U nocobase -d nocobase -f /tmp/nocobase_crm_v1_sql_260224.sql
-  ```
-
-* **Via Database Client**: Use tools like DBeaver, Navicat, or pgAdmin to connect to the database and execute the SQL file.
-
-**Step 3: Connect to the database and start the application**
-
-Configure NocoBase startup parameters to point to the database where the data was imported, then start the service.

package/dist/ai/docs/nocobase/solution/ticket-system/changelog.md

@@ -8,7 +8,6 @@ This page documents the update history for the Ticketing System solution. New en
 
 **Backup files**:
 - [nocobase_tickets_v2_backup_260324.nbdata](https://static-docs.nocobase.com/nocobase_tickets_v2_backup_260324.nbdata)
-- [nocobase_tickets_v2_sql_260324.zip](https://static-docs.nocobase.com/nocobase_tickets_v2_sql_260324.zip)
 
 **Changes**:
 - Fixed error "SLA Config not found" when marking a ticket as completed
@@ -21,7 +20,6 @@ This page documents the update history for the Ticketing System solution. New en
 
 **Backup files**:
 - nocobase_tts_v2_backup_260302.nbdata
-- nocobase_tts_v2_sql_260302.zip
 
 **Changes**:
 - Initial release of Ticketing System v2

package/dist/ai/docs/nocobase/solution/ticket-system/installation.md

@@ -2,15 +2,13 @@
 
 > The current version uses **backup and restoration** for deployment. In future versions, we may switch to **incremental migration** to facilitate the integration of the solution into your existing systems.
 
-To ensure you can deploy the ticketing solution to your own NocoBase environment quickly and smoothly, we provide two restoration methods. Please choose the one that best suits your user version and technical background.
+> **The Backup Manager plugin is now open-source**: The "[Backup Manager](https://docs.nocobase.com/handbook/backups)" plugin needed to restore the solution is now open-source and available to all editions (including the Community Edition). We recommend restoring directly via this plugin.
 
 Before you begin, please ensure:
 
 - You already have a basic NocoBase running environment. For main system installation, please refer to the detailed [official installation documentation](https://docs.nocobase.com/welcome/getting-started/installation).
 - NocoBase version **2.0.0-beta.5 and above**.
-- You have downloaded the corresponding files for the ticketing system:
-  - **Backup file**: [nocobase_tickets_v2_backup_260324.nbdata](https://static-docs.nocobase.com/nocobase_tickets_v2_backup_260324.nbdata) - For Method 1
-  - **SQL file**: [nocobase_tickets_v2_sql_260324.zip](https://static-docs.nocobase.com/nocobase_tickets_v2_sql_260324.zip) - For Method 2
+- You have downloaded the ticketing system backup file: [nocobase_tickets_v2_backup_260324.nbdata](https://static-docs.nocobase.com/nocobase_tickets_v2_backup_260324.nbdata)
 
 **Important Notes**:
 - This solution is built on **PostgreSQL 16**. Please ensure your environment uses PostgreSQL 16.
@@ -18,9 +16,9 @@ Before you begin, please ensure:
 
 ---
 
-## Method 1: Restore Using Backup Manager (Recommended for Pro/Enterprise Users)
+## Restore Using Backup Manager
 
-This method uses the built-in "[Backup Manager](https://docs.nocobase.com/handbook/backups)" (Pro/Enterprise) plugin for one-click restoration, which is the simplest operation. However, it has certain requirements for the environment and user version.
+This method uses the built-in "[Backup Manager](https://docs.nocobase.com/handbook/backups)" plugin for one-click restoration, which is the simplest operation. This plugin is now open-source and available to all editions (including the Community Edition).
 
 ### Core Features
 
@@ -28,9 +26,8 @@ This method uses the built-in "[Backup Manager](https://docs.nocobase.com/handbo
   1. **Convenient Operation**: Can be completed via the UI, allowing for full restoration of all configurations, including plugins.
   2. **Complete Restoration**: **Able to restore all system files**, including print templates, files uploaded to attachment fields, etc., ensuring full functionality.
 * **Limitations**:
-  1. **Pro/Enterprise Only**: "Backup Manager" is an enterprise-level plugin, available only to Pro/Enterprise users.
-  2. **Strict Environment Requirements**: Requires your database environment (version, case sensitivity, etc.) to be highly compatible with the environment where the backup was created.
-  3. **Plugin Dependencies**: If the solution includes commercial plugins not present in your local environment, the restoration will fail.
+  1. **Strict Environment Requirements**: Requires your database environment (version, case sensitivity, etc.) to be highly compatible with the environment where the backup was created.
+  2. **Plugin Dependencies**: If the solution includes commercial plugins not present in your local environment, the restoration will fail.
 
 ### Steps
 
@@ -67,66 +64,6 @@ Then use this image to start your NocoBase service.
 * **Database Compatibility**: This is the most critical point for this method. Your PostgreSQL database **version, character set, and case sensitivity settings** must match the backup source file. In particular, the `schema` name must be consistent.
 * **Commercial Plugin Matching**: Please ensure you have and have enabled all commercial plugins required by the solution, otherwise the restoration will be interrupted.
 
----
-
-## Method 2: Direct SQL File Import (Universal, More Suitable for Community Edition)
-
-This method restores data by directly operating the database, bypassing the "Backup Manager" plugin, and therefore has no Pro/Enterprise plugin restrictions.
-
-### Core Features
-
-* **Advantages**:
-  1. **No Version Restrictions**: Applicable to all NocoBase users, including the Community Edition.
-  2. **High Compatibility**: Does not depend on the application's `dump` tool; it works as long as you can connect to the database.
-  3. **High Fault Tolerance**: If the solution contains commercial plugins you do not have, the related features will not be enabled, but this will not affect other functions, and the application can start successfully.
-* **Limitations**:
-  1. **Requires Database Operation Skills**: Users need basic database operation skills, such as how to execute a `.sql` file.
-  2. **System Files Lost**: **This method will lose all system files**, including print templates, files uploaded to attachment fields, etc.
-
-### Steps
-
-**Step 1: Prepare a clean database**
-
-Prepare a brand new, empty database for the data you are about to import.
-
-**Step 2: Import the `.sql` file into the database**
-
-Get the downloaded database file (usually in `.sql` format) and import its contents into the database prepared in the previous step. There are several ways to do this, depending on your environment:
-
-* **Option A: Via server command line (Docker example)**
-  If you use Docker to install NocoBase and the database, you can upload the `.sql` file to the server and use the `docker exec` command to perform the import. Assuming your PostgreSQL container is named `my-nocobase-db` and the file is named `ticket_system.sql`:
-
-  ```bash
-  # Copy the sql file into the container
-  docker cp ticket_system.sql my-nocobase-db:/tmp/
-  # Enter the container and execute the import command
-  docker exec -it my-nocobase-db psql -U your_username -d your_database_name -f /tmp/ticket_system.sql
-  ```
-* **Option B: Via remote database client**
-  If your database port is exposed, you can use any graphical database client (such as DBeaver, Navicat, pgAdmin, etc.) to connect to the database, open a new query window, paste the entire contents of the `.sql` file, and execute it.
-
-**Step 3: Connect to the database and start the application**
-
-Configure your NocoBase startup parameters (such as environment variables `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USER`, `DB_PASSWORD`, etc.) to point to the database where you just imported the data. Then, start the NocoBase service normally.
-
-### Notes
-
-* **Database Permissions**: This method requires an account and password with permissions to directly operate the database.
-* **Plugin Status**: After a successful import, although the commercial plugin data exists in the system, if you have not installed and enabled the corresponding plugins locally, the related features will not be displayed or usable, but this will not cause the application to crash.
-
----
-
-## Summary and Comparison
-
-| Feature | Method 1: Backup Manager | Method 2: Direct SQL Import |
-| :-------------- | :--------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------- |
-| **Target Users** | **Pro/Enterprise** users | **All users** (including Community Edition) |
-| **Ease of Use** | ⭐⭐⭐⭐⭐ (Very simple, UI operation) | ⭐⭐⭐ (Requires basic database knowledge) |
-| **Environment Requirements** | **Strict**, database and system versions must be highly compatible | **General**, requires database compatibility |
-| **Plugin Dependencies** | **Strong dependency**, plugins are verified during restoration; missing any plugin will cause **restoration failure**. | **Features depend on plugins**. Data can be imported independently, and the system will have basic functionality. However, if corresponding plugins are missing, related features will be **completely unusable**. |
-| **System Files** | **Fully preserved** (print templates, uploaded files, etc.) | **Will be lost** (print templates, uploaded files, etc.) |
-| **Recommended Scenarios** | Enterprise users with a controlled, consistent environment who need complete functionality | Missing some plugins, seeking high compatibility and flexibility, non-Pro/Enterprise users, can accept the loss of file-related functions |
-
 We hope this tutorial helps you successfully deploy the ticketing system. If you encounter any issues during the process, please feel free to contact us!
 ---
 

package/dist/ai/docs/nocobase/workflow/advanced/options.md

@@ -1,5 +1,49 @@
 # Advanced Configuration
 
+## Timeout Settings
+
+Starting from version `2.1.0`, workflows support timeout settings to limit the maximum duration of a single execution from the time it starts processing until it ends. Timeout settings are useful for preventing workflows from occupying execution resources indefinitely because of long-running operations, manual processing, or waiting for external callbacks.
+
+In the workflow creation or editing dialog, expand "Advanced options" to configure "Timeout settings":
+
+![20260604212454](https://static-docs.nocobase.com/20260604212454.png)
+
+The available options are:
+
+- Enter `0` to set no timeout limit (default).
+- Enter a value greater than `0` to enable the timeout limit. The interface supports seconds, minutes, hours, and days as units.
+- The maximum timeout is 180 days.
+
+### Timing Rules
+
+The timeout starts counting when the workflow first enters a processor. After a workflow is triggered, time spent waiting in the queue for scheduling, or stored for delayed start, does not count toward the timeout.
+
+After entering a processor, the timeout continues to count, including actual node execution time and time spent by nodes that have entered a waiting state, such as manual processing, approval, delay, or waiting for an external callback. The timeout does not pause when the workflow is waiting for user action.
+
+The timeout deadline is determined when the execution starts. Changing a workflow's timeout settings only affects executions that start processing afterward; it does not recalculate executions that have already started.
+
+### Timeout Handling
+
+If the execution has not ended when the timeout is reached, the system terminates it:
+
+- The execution history status changes to "Aborted", and the termination reason is shown as "Timed out".
+- Node jobs that are currently running or waiting are marked as "Aborted".
+- Subsequent nodes will not continue to execute.
+- If this execution has running subflow executions, those subflows are also aborted together with the parent execution.
+
+Examples:
+
+- If a loop node runs an extremely long loop and the processing inside the loop is time-consuming, causing the whole loop node to exceed the configured timeout, the currently running loop node and its internal nodes are forcibly terminated, and subsequent nodes will not continue to execute.
+- If a manual processing or approval node waits for a long time and exceeds the configured timeout, the currently waiting manual processing node is forcibly terminated, subsequent nodes will not continue to execute, and the related tasks are canceled.
+
+:::info{title=Note}
+Timeout settings are a global limit for the entire workflow execution, not a timeout for an individual node. If you only need to limit the waiting time of a specific node, such as an HTTP Request or JavaScript Script node, use that node's own timeout settings.
+:::
+
+:::info{title=Note}
+If you need to implement business-level time-limited handling, such as "mark a work order as timed out if nobody processes it within 10 minutes", usually use the [Delay node](../nodes/delay.md) together with parallel branches to arrange the follow-up handling. The global timeout directly terminates the current execution, so it is suitable as a fallback protection mechanism, not for carrying subsequent business branches.
+:::
+
 ## Execution Mode
 
 Workflows are executed either asynchronously or synchronously, based on a trigger type selected during creation. Asynchronous mode means that after a specific event is triggered, the workflow enters a queue and is executed one by one by background scheduling. Synchronous mode, on the other hand, does not enter the scheduling queue after being triggered; it starts executing directly and provides immediate feedback upon completion.
@@ -30,4 +74,4 @@ It is recommended not to enable auto-deletion of execution history when debuggin
 
 :::info{title=Note}
 Deleting a workflow's history does not reduce its execution count.
-:::
+:::