Commit c61698d
committed
Stacked on top of PR #6708 (the `excl. model store` PR). Completes the FR-2571 docs work by documenting the Model Store V2 and Auto Scaling Rules V2 surfaces that were intentionally deferred from #6708.
## Structural approach
Decided with the user: document **both legacy and V2 paths side-by-side, split by explicit Backend.AI manager version**. Legacy prose stays in place as-is; V2 is appended as a versioned `####` subsection with a `:::note` admonition pointing from the legacy block to the new block. No `<details>` collapsibles — both variants are equally visible.
The structural pattern used in every affected section:
```markdown
### Section Heading
<legacy prose — kept, with legacy screenshot>
:::note
From Backend.AI version 26.4.0 onwards, this section has been redesigned. If
you are on an older version, the description above still applies. Otherwise,
refer to [Section (version 26.4.0 and later)](#section-version-26-4-0-and-later) below.
:::
<a id="section-version-26-4-0-and-later"></a>
#### Section (version 26.4.0 and later)
<V2 prose with new V2 screenshot>
```
## Version resolution
**Backend.AI manager 26.4.0** is the cutover version for both V2 surfaces. Verified at:
- `src/lib/backend.ai-client-esm.ts:895–904` — `model-card-v2` (line 901) and `prometheus-auto-scaling-rule` (line 903) are both gated on `isManagerVersionCompatibleWith('26.4.0')`.
- `.specs/draft-auto-scaling-rule-ux/spec.md:48` — auto-scaling spec explicitly states `>=26.4.0`.
- `.specs/model-store-v2-migration/dev-plan.md:13-25` — same manager version for model-store V2.
## Changes (applied identically across en / ko / ja / th)
### `model_serving.md` — three V2 subsections appended
1. **`### Auto Scaling Rules` → `#### Auto Scaling Rules (version 26.4.0 and later)`**: new Prometheus metric source with preset + live preview, Single/Range condition segmented control with directional threshold, Time Window (replaces legacy CoolDown Seconds), Step Size as positive integer with contextual sign prefix, separate Min/Max Replicas fields, property filters + pagination + Last Triggered column, inline Edit/Delete on Condition cell.
2. **`## Model Store` → `### Model Store (version 26.4.0 and later)`**: search+sort layout (replaces Category/Task/Label dropdowns), card detail Drawer (replaces Modal), card 50%-opacity + Deploy-disabled state for zero-preset models, two-scenario Deploy flow (auto-deploy vs Deploy Model selection modal), explicit absence of Clone button with cross-page link to `../vfolder/vfolder.md`.
3. **`### Admin Model Store Management` → `#### Admin Model Store Management (version 26.4.0 and later)`**: new column set (Name / Title / Category / Task / Access Level / Domain / Project / Created At — no Labels, no separate Controls column), `Private` / `Public` access tags, name-only property filter, inline Edit/Delete on Name cell via `BAINameActionCell`, row-selection bulk delete, explicit note that `Scan Project Model Cards` button is not available in 26.4.0+.
### Ripple edits (3 sites augmented, not replaced)
- `### Guide to Steps for Using Model Service` `:::tip` block
- `### Creating a Service Definition File` (two references)
Pattern: ``Run this model`` button (``Deploy`` on version 26.4.0 and later).
### 7 new V2 screenshots
Captured in English UI, copied byte-identically to all 4 language `images/` dirs (MD5 verified).
- `auto_scaling_rules_v2.png`
- `auto_scaling_rules_modal_v2.png` (Kernel + Single)
- `auto_scaling_rules_modal_prometheus_v2.png` (Prometheus preset + Range)
- `model_store_page_v2.png`
- `model_card_detail_drawer.png`
- `model_card_deploy_modal.png`
- `admin_model_card_list_v2.png`
Existing legacy screenshots (`auto_scaling_rules.png`, `auto_scaling_rules_modal.png`, `model_store_page.png`, `model_card_detail_modal.png`, `model_clone_dialog.png`, `admin_model_card_list.png`) are untouched and continue to document the legacy variants.
### Bug fix
Broken cross-reference `[Data](#data)` → `[Data](../vfolder/vfolder.md)` (relative cross-page link per project convention).
## Structural parity verification
- 43 headings per file, identical `#`-level sequences across en/ko/ja/th.
- 3 English-only anchors (`auto-scaling-rules-version-26-4-0-and-later`, `model-store-version-26-4-0-and-later`, `admin-model-store-management-version-26-4-0-and-later`) present in all four files.
- All 7 V2 image references identical across languages.
- Legacy prose intact — only diffs outside the new V2 blocks are the 3 ripple-site rewrites.
- `book.config.yaml` unchanged (no new top-level pages introduced).
## Agent workflow
Planned via `docs-update-planner` → written via `docs-update-writer` → quality reviewed via `docs-update-reviewer` (18 auto-fixes applied: PUBLIC → Public tag casing, 3-space indented notes → `:::note` admonitions, `Backend.AI version 26.4.0` prefix consistency) → screenshots via `docs-screenshot-capturer`.
Artifacts (in `.agent-output/`, gitignored):
- `docs-update-plan-model-store-and-autoscaling.md`
- `docs-review-report-model-store-and-autoscaling.md`
**Checklist:**
- [x] Documentation
- [x] Structural parity across en/ko/ja/th verified
- [x] Version number resolved (26.4.0) and referenced consistently
- [x] Cross-page links and image references verified
- [x] Legacy prose preserved; V2 subsections appended via `:::note` + anchor pattern
- [x] No `TODO(needs-version)` markers remain
🤖 Generated with [Claude Code](https://claude.com/claude-code)
1 parent 5a3e5d8 commit c61698d
32 files changed
Lines changed: 606 additions & 25 deletions
File tree
- packages/backend.ai-webui-docs/src
- en
- images
- model_serving
- ja
- images
- model_serving
- ko
- images
- model_serving
- th
- images
- model_serving
Lines changed: 150 additions & 9 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
72 | 72 | | |
73 | 73 | | |
74 | 74 | | |
75 | | - | |
| 75 | + | |
76 | 76 | | |
77 | 77 | | |
78 | 78 | | |
| |||
293 | 293 | | |
294 | 294 | | |
295 | 295 | | |
296 | | - | |
297 | | - | |
298 | | - | |
299 | | - | |
| 296 | + | |
| 297 | + | |
| 298 | + | |
| 299 | + | |
300 | 300 | | |
301 | 301 | | |
302 | 302 | | |
| |||
340 | 340 | | |
341 | 341 | | |
342 | 342 | | |
343 | | - | |
344 | | - | |
345 | | - | |
346 | | - | |
| 343 | + | |
| 344 | + | |
| 345 | + | |
| 346 | + | |
347 | 347 | | |
348 | 348 | | |
349 | 349 | | |
| |||
587 | 587 | | |
588 | 588 | | |
589 | 589 | | |
| 590 | + | |
| 591 | + | |
| 592 | + | |
| 593 | + | |
| 594 | + | |
| 595 | + | |
| 596 | + | |
| 597 | + | |
| 598 | + | |
| 599 | + | |
| 600 | + | |
| 601 | + | |
| 602 | + | |
| 603 | + | |
| 604 | + | |
| 605 | + | |
| 606 | + | |
| 607 | + | |
| 608 | + | |
| 609 | + | |
| 610 | + | |
| 611 | + | |
| 612 | + | |
| 613 | + | |
| 614 | + | |
| 615 | + | |
| 616 | + | |
| 617 | + | |
| 618 | + | |
| 619 | + | |
| 620 | + | |
| 621 | + | |
| 622 | + | |
| 623 | + | |
| 624 | + | |
| 625 | + | |
| 626 | + | |
| 627 | + | |
| 628 | + | |
| 629 | + | |
| 630 | + | |
| 631 | + | |
590 | 632 | | |
591 | 633 | | |
592 | 634 | | |
| |||
750 | 792 | | |
751 | 793 | | |
752 | 794 | | |
| 795 | + | |
| 796 | + | |
| 797 | + | |
| 798 | + | |
| 799 | + | |
| 800 | + | |
| 801 | + | |
| 802 | + | |
| 803 | + | |
| 804 | + | |
| 805 | + | |
| 806 | + | |
| 807 | + | |
| 808 | + | |
| 809 | + | |
| 810 | + | |
| 811 | + | |
| 812 | + | |
| 813 | + | |
| 814 | + | |
| 815 | + | |
| 816 | + | |
| 817 | + | |
| 818 | + | |
| 819 | + | |
| 820 | + | |
| 821 | + | |
| 822 | + | |
| 823 | + | |
| 824 | + | |
| 825 | + | |
| 826 | + | |
| 827 | + | |
| 828 | + | |
| 829 | + | |
| 830 | + | |
| 831 | + | |
| 832 | + | |
| 833 | + | |
| 834 | + | |
| 835 | + | |
| 836 | + | |
| 837 | + | |
| 838 | + | |
| 839 | + | |
| 840 | + | |
| 841 | + | |
| 842 | + | |
| 843 | + | |
| 844 | + | |
| 845 | + | |
| 846 | + | |
| 847 | + | |
| 848 | + | |
| 849 | + | |
| 850 | + | |
| 851 | + | |
| 852 | + | |
| 853 | + | |
753 | 854 | | |
754 | 855 | | |
755 | 856 | | |
| |||
801 | 902 | | |
802 | 903 | | |
803 | 904 | | |
| 905 | + | |
| 906 | + | |
| 907 | + | |
| 908 | + | |
| 909 | + | |
| 910 | + | |
| 911 | + | |
| 912 | + | |
| 913 | + | |
| 914 | + | |
| 915 | + | |
| 916 | + | |
| 917 | + | |
| 918 | + | |
| 919 | + | |
| 920 | + | |
| 921 | + | |
| 922 | + | |
| 923 | + | |
| 924 | + | |
| 925 | + | |
| 926 | + | |
| 927 | + | |
| 928 | + | |
| 929 | + | |
| 930 | + | |
| 931 | + | |
| 932 | + | |
| 933 | + | |
| 934 | + | |
| 935 | + | |
| 936 | + | |
| 937 | + | |
| 938 | + | |
| 939 | + | |
| 940 | + | |
| 941 | + | |
| 942 | + | |
| 943 | + | |
| 944 | + | |
0 commit comments