docs(FR-2912): migrate deployment presets into admin menu and remove service launcher references

Author: agatha197

packages/backend.ai-webui-docs/src/book.config.yaml

@@ -67,10 +67,8 @@ navigation:
           path: sessions_all/sessions_all.md
         - title: Cluster Session
           path: cluster_session/cluster_session.md
-        - title: Model Serving
+        - title: Deployments
           path: model_serving/model_serving.md
-        - title: Deployment Presets
-          path: model_serving/deployment_presets.md
         - title: Chat
           path: chat/chat.md
         - title: Import Run
@@ -138,10 +136,8 @@ navigation:
           path: sessions_all/sessions_all.md
         - title: クラスターセッション
           path: cluster_session/cluster_session.md
-        - title: モデルサービング
+        - title: デプロイ
           path: model_serving/model_serving.md
-        - title: デプロイメントプリセット
-          path: model_serving/deployment_presets.md
         - title: チャット
           path: chat/chat.md
         - title: インポート＆実行
@@ -209,10 +205,8 @@ navigation:
           path: sessions_all/sessions_all.md
         - title: 클러스터 세션
           path: cluster_session/cluster_session.md
-        - title: 모델 서빙
+        - title: 배포
           path: model_serving/model_serving.md
-        - title: 배포 프리셋
-          path: model_serving/deployment_presets.md
         - title: 채팅
           path: chat/chat.md
         - title: 가져오기 및 실행
@@ -280,10 +274,8 @@ navigation:
           path: sessions_all/sessions_all.md
         - title: เซสชันคลัสเตอร์
           path: cluster_session/cluster_session.md
-        - title: การให้บริการโมเดล
+        - title: การปรับใช้
           path: model_serving/model_serving.md
-        - title: พรีเซ็ตการดีพลอย
-          path: model_serving/deployment_presets.md
         - title: แชท
           path: chat/chat.md
         - title: นำเข้าและรัน

packages/backend.ai-webui-docs/src/en/admin_menu/admin_menu.md

@@ -338,28 +338,30 @@ To enable the **Deploy** button on a model card in the Model Store, include `ser
 
 ## Admin Features
 
+<a id="admin-deployments-page"></a>
 <a id="admin-serving-page"></a>
 
-### Admin Serving Page
+### Admin Deployments Page
 
-Administrators and superadmins can access the Admin Serving page, which provides a cross-project view of all endpoints. This page shows the **Project** column in addition to the standard endpoint list columns, allowing admins to manage services across all projects.
+Administrators and superadmins can access the Admin Deployments page at `/admin-deployments`, which provides a cross-project view of every deployment in the cluster. This page shows the **Project** column in addition to the standard deployment list columns, allowing admins to manage deployments across all projects.
 
 ![](../images/admin_serving_page.png)
 
-The Admin Serving page has two tabs:
+The Admin Deployments page has three tabs:
 
-- **Serving**: Displays the endpoint list across all projects, with the same lifecycle and property filters as the user-facing Serving page.
+- **Deployments**: Displays the deployment list across all projects, with the same lifecycle and property filters as the user-facing Deployments page.
+- **Deployment Presets**: Lets administrators manage reusable deployment presets that end users can apply when deploying a model. See [Deployment Presets](#deployment-presets) below.
 - **Model Store Management**: Available to superadmins only. See the section below.
 
 :::note
-Each individual admin deployment now has its own dedicated route at `/admin-deployments/:id`. When you open a deployment from the Admin Serving page, the URL changes to this path so that the deployment detail can be linked to or bookmarked directly.
+Each individual admin deployment has its own dedicated route at `/admin-deployments/:id`. When you open a deployment from the Admin Deployments page, the URL changes to this path so that the deployment detail can be linked to or bookmarked directly.
 :::
 
 <a id="admin-model-store-management"></a>
 
 ### Admin Model Store Management
 
-Superadmins can manage model cards through the **Model Store Management** tab on the Admin Serving page.
+Superadmins can manage model cards through the **Model Store Management** tab on the Admin Deployments page.
 
 ![](../images/admin_model_card_list_v2.png)
 
@@ -419,6 +421,148 @@ The deletion confirmation dialog includes an **Also delete the associated model
 
 The same behavior applies to **bulk deletion** (the label becomes **Also delete all associated model folders**): each selected model card's linked storage folder is moved to the trash when the option is checked, and a trash notification is shown for each folder that was moved.
 
+<a id="deployment-presets"></a>
+
+## Deployment Presets
+
+A **Deployment Preset** is a reusable, administrator-curated bundle of deployment settings — image, runtime, resource slots, cluster mode, environment variables, startup command, replica count, visibility, and other defaults — that end users can apply when they create a model deployment from a storage folder. Presets let administrators publish a small set of vetted, known-good deployment shapes (for example, *vLLM-GPU-Large* or *SGLang-CPU-Small*) so that end users can deploy a model without having to choose every advanced field from scratch.
+
+![](../images/deployment_preset_list.png)
+
+### What Is a Deployment Preset?
+
+A Deployment Preset captures the defaults of a model deployment so that:
+
+- **Administrators** can offer end users a curated catalog of deployment shapes that match the organization's hardware and policy constraints.
+- **End users** can pick a preset when deploying a model from the Data page (via the *Create New Deployment with Preset* flow) and skip filling in advanced fields manually.
+- **Operators** can ensure that production deployments use consistent resource allocations, runtimes, and visibility defaults across the organization.
+
+When a deployment is created from a preset, the preset's values pre-populate the deployment launcher fields. Users can still review and adjust those fields before confirming the deployment.
+
+Each preset stores the following deployment defaults:
+
+- **Basic Info**: Name, description, runtime variant, rank (display ordering).
+- **Image**: The container image to deploy.
+- **Resources**: Resource slots (CPU, memory, GPU), shared memory (SHM), and resource options.
+- **Cluster**: Cluster mode (Single-Node or Multi-Node) and cluster size.
+- **Execution**: Startup command, environment variables, and bootstrap script.
+- **Deployment Defaults**: Replica count, revision history limit, and the *Open to Public* visibility default.
+- **Advanced**: Model definition JSON (when needed for a custom runtime).
+
+<a id="managing-deployment-presets"></a>
+
+### Managing Deployment Presets
+
+Only administrators can create, edit, or delete deployment presets. Administrators manage them from the **Deployment Presets** tab on the Admin Deployments page.
+
+![](../images/admin_deployment_preset_list.png)
+
+The list view shows each preset with its name, runtime, image, rank, and key resource fields. From this list, administrators can:
+
+- Filter presets by name, runtime, or tag.
+- Click a tag chip on any row to filter the list to presets sharing that tag.
+- Open a preset's detail view to inspect its full configuration.
+- Create, edit, or delete a preset.
+
+#### Create a Deployment Preset
+
+1. Click the **Create Preset** button at the top right of the preset list.
+2. Fill in the fields in the *Create Preset* dialog. The dialog is organized into the following sections:
+
+   - **Basic Info**:
+      * **Name**: A unique preset name (for example, `vLLM-GPU-Large`).
+      * **Description**: A short summary of the preset's intended use.
+      * **Runtime**: The runtime variant (for example, vLLM, SGLang, or Custom).
+      * **Rank**: Display ordering among presets of the same runtime. Lower values appear first.
+   - **Image**: The container image to use when deploying.
+   - **Resources**: Resource slots (CPU, memory, GPU), shared memory, and resource options (key/value pairs).
+   - **Cluster**: Cluster mode (Single-Node or Multi-Node) and cluster size.
+   - **Execution**: Startup command, environment variables, and bootstrap script.
+   - **Deployment Defaults**:
+      * **Replica Count**: Default number of replicas created from this preset.
+      * **Revision History Limit**: Number of past revisions kept for each deployment created from this preset.
+      * **Open to Public**: Whether the endpoint of deployments created from this preset is reachable without an access token by default.
+   - **Advanced** (optional): Model definition JSON for custom runtimes.
+
+   ![](../images/deployment_preset_create_modal.png)
+
+3. Click **Create Preset** to save. A success notification confirms the preset has been created.
+
+:::tip
+If a required field is missing or invalid, the **Create Preset** button stays disabled until the error is resolved. Required fields show inline validation messages as you type.
+:::
+
+#### Edit a Deployment Preset
+
+1. From the preset list, open the action menu on the preset row (or open the preset's detail view) and select **Edit Preset**.
+2. The *Edit Preset* dialog opens with the preset's current values pre-filled. The available sections are identical to the *Create Preset* dialog.
+3. Adjust the fields as needed, then click **Edit Preset** to save your changes.
+
+![](../images/deployment_preset_edit_modal.png)
+
+Editing a preset only changes the defaults for **future** deployments. Existing deployments that were already created from this preset are not modified.
+
+#### Delete a Deployment Preset
+
+1. From the preset list (or the preset's detail view), open the action menu on the preset and select **Delete Preset**.
+2. A typed-confirmation dialog appears asking you to type the preset's name to confirm. The **OK** button stays disabled until the typed value matches the preset name exactly.
+3. Type the preset's name, then click **OK** to confirm.
+
+:::danger
+Deleting a deployment preset is **irreversible**. The preset itself is removed, but deployments that were already created from it continue to run unaffected. Future deployments can no longer reference this preset.
+:::
+
+<a id="using-a-preset-when-deploying-a-model"></a>
+
+### Using a Preset When Deploying a Model
+
+End users apply a deployment preset through the **VFolder Deploy** modal, which opens when you deploy a model from a storage folder on the Data page.
+
+1. From the Data page, locate the model folder you want to deploy and click **Deploy as Service**.
+2. The VFolder Deploy modal opens, listing the deployment presets available for your project.
+3. Click a preset row to open its **Deployment Preset Detail** view. The detail view shows every field that the preset will apply when used — image, runtime, resources, cluster mode, replica count, visibility, and so on.
+
+   ![](../images/vfolder_deploy_preset_detail.png)
+
+4. From the detail view, choose how to proceed:
+
+   - **Auto-deploy**: Create the deployment immediately using the preset's values as-is. This is the fastest path; the deployment is created in one click with no further input required.
+   - **Manual deploy** (*Create New Deployment with Preset*): Open the deployment launcher with all fields pre-populated from the preset, so you can review and adjust before confirming.
+
+:::note
+The active preset, tab key, and other navigation state are preserved in the URL via `URLSearchParams`. You can share a link to a specific preset's detail view, and the recipient lands on the same screen.
+:::
+
+### Pre-Populated Launcher Fields
+
+When you choose the manual-deploy path, the deployment launcher opens with every field pre-filled from the selected preset:
+
+- Image, runtime variant, and resource group.
+- Resource slots, shared memory, and resource options.
+- Cluster mode and cluster size.
+- Startup command and environment variables.
+- Replica count, revision history limit, and **Open to Public** visibility.
+- Auto-selected resource preset, which is preserved across the launcher's initial-value resolution.
+
+You can edit any pre-populated field before deploying. Editing a field does **not** modify the underlying preset — it only changes the values used for this one deployment. The preset's defaults remain unchanged for future deployments.
+
+:::tip
+If the auto-selected resource preset is the right one for your workload, leave it as-is. The launcher preserves the auto-selection across the initial-values pass, so you do not need to re-select it after switching presets.
+:::
+
+### Filtering by Tags
+
+Both the user-facing preset list and the admin preset list support **clickable tag chips** that filter the list to presets sharing the clicked tag.
+
+![](../images/deployment_preset_tag_filter.png)
+<!-- TODO: Capture screenshot of the deployment preset list filtered by a tag chip -->
+
+1. Locate a preset row that has the tag you want to filter by.
+2. Click the tag chip on that row.
+3. The list refreshes to show only presets that include the selected tag. The active filter is reflected in the filter bar; clear it to return to the full list.
+
+This is useful when you have many presets and want to quickly narrow down to, for example, all GPU-backed presets or all presets for a specific runtime family.
+
 <a id="prometheus-query-presets"></a>
 
 ## Prometheus Query Presets

packages/backend.ai-webui-docs/src/en/images/serving_list_page.png

@@ -7,7 +7,7 @@ A **Deployment Preset** is a reusable, administrator-curated bundle of deploymen
 ![](../images/deployment_preset_list.png)
 
 :::info
-Deployment Presets are part of the Model Serving feature set introduced in version 26.4. Cross-references to preset-aware revision creation are documented in the [Model Serving](#model-serving) page.
+This page lives under the **Administration** section because only administrators can create, edit, and delete deployment presets. End users cannot manage presets themselves, but they can **apply** any preset that has been published to their project when they deploy a model. The two halves of this page reflect that split: [Managing Deployment Presets](#managing-deployment-presets) describes the admin workflow, and [Using a Preset When Deploying a Model](#using-a-preset-when-deploying-a-model) describes the end-user workflow. Preset-aware revision creation is also documented on the [Deployments](#model-serving) page.
 :::
 
 ## What Is a Deployment Preset?
@@ -30,9 +30,11 @@ Each preset stores the following deployment defaults:
 - **Deployment Defaults**: Replica count, revision history limit, and the *Open to Public* visibility default.
 - **Advanced**: Model definition JSON (when needed for a custom runtime).
 
-## (Admin) Manage Deployment Presets
+<a id="managing-deployment-presets"></a>
 
-Administrators manage deployment presets from the admin Model Serving area on the **Deployment Presets** tab.
+## Managing Deployment Presets
+
+Only administrators can create, edit, or delete deployment presets. Administrators manage them from the **Deployment Presets** tab on the Admin Deployments page.
 
 ![](../images/admin_deployment_preset_list.png)