# Minerp Studio — Danh sách tính năng

**Minerp Studio** là workspace quản trị merchant tại `/studio` trên `storefront.vn` — dựng site, vận hành shop, automation và CSKH.

**Copy marketing trải nghiệm khách (storefront shop):** [`marketing/shop/00-index.md`](../../../../marketing/shop/00-index.md) · Brief merchant (Studio): [`marketing/studio/00-index.md`](../../../../marketing/studio/00-index.md)

> Cập nhật: 2026-10-05 · Nguồn: menu Studio (`studio-shell.tsx`), UG-003…012, `puck-config.tsx` (413 block).

---

## 0. Nền tảng & truy cập

| Tính năng | Mô tả |
|-----------|--------|
| **Đăng nhập Studio (IAM SSO)** | Staff đăng nhập qua platform auth — tách khách shopper |
| **License Studio** | SKU `storefront_studio`; hết hạn khóa chỉnh sửa, shop public vẫn chạy |
| **Launch link** | Link kích hoạt một lần sau checkout SaaS |
| **Multi-site picker** | Nhiều CMS site trên một tenant |
| **Song ngữ Studio UI** | VI / EN trên shell Studio |
| **Xem shop live** | Mở storefront public từ toolbar |
| **Thông báo in-app** | Bell + `/studio/notifications` |
| **License panel** | `/studio/license` — gói, gia hạn |
| **Onboarding** | `/studio/launch` |

---

## 1. Site — Dựng trang & nội dung

### Trang site (`/studio`)

- Danh sách trang CMS (landing, policy, FAQ…)
- **Minerp Page Builder** fullscreen: kéo-thả, lưu draft, preview token, publish
- **Revision history** — khôi phục bản cũ vào draft
- Slug `/c/{slug}` công khai sau publish
- **Copy landing (paragraph):** [`marketing/studio/site-pages.md`](../../../../marketing/studio/site-pages.md)

### Blog (`/studio/content/blog`)

- Entry editorial CCT `blog`
- Body soạn bằng **Minerp Page Builder**
- Workflow duyệt (draft → submit → approve)
- **Copy landing (paragraph):** [`marketing/studio/site-blog.md`](../../../../marketing/studio/site-blog.md)

### Templates (`/studio/templates`) — 5 loại

| Kind | Mục đích |
|------|----------|
| **Section** | Tái dùng section (mega menu panel…) |
| **Page** | Seed layout khi tạo trang mới |
| **Listing** | Layout **card** cho lưới sản phẩm/bài viết |
| **Theme** | 4 layout cố định: PLP, PDP, blog archive, blog detail |
| **Popup** | Overlay marketing tái sử dụng |

- **Copy landing (paragraph):** [`marketing/studio/site-templates.md`](../../../../marketing/studio/site-templates.md)

### Menus (`/studio/menus`)

- Menu điều hướng — kéo thả **4 cấp**, mã menu cố định
- Gắn section template cho mega dropdown
- Editor header/footer bind menu
- **Copy landing (paragraph):** [`marketing/studio/site-menu.md`](../../../../marketing/studio/site-menu.md)

### Header & Footer (`/studio/settings/header`, `/footer`)

- Soạn chrome Puck hoặc fallback link-list
- Search, giỏ, tài khoản luôn còn trên shop

---

## 2. Puck Page Builder (lõi Studio)

- **Copy landing (paragraph):** [`marketing/studio/page-builder.md`](../../../../marketing/studio/page-builder.md)

### Editor

- Canvas **Desktop / Tablet / Mobile**
- **Outline navigator** — cây block, reorder
- **Grid layout nâng cao** — cột/hàng, breakpoint
- **Theme tokens** — màu, typography site-wide live trên canvas
- Inspector **Content / Style / Advanced** cho từng block
- **Chèn section template** / **Lưu thành template**
- **Fullscreen editor** — focus mode

### Thư viện block — 413 widget Puck

| Nhóm | Ví dụ |
|------|--------|
| Layout | Container, Grid, Columns, Spacer… |
| Base | Heading, Text, Image, CTA, ContentListing, MapListing… |
| Creative | FlipBox, Scroll Marquee, Morph Slider, Stacking Cards… |
| Product Widgets | ProductGallery, AddToCart, MiniCart, ProductGrid/Slider… |
| Post Widgets | PostGrid, Masonry, Timeline, AuthorList, Breadcrumbs… |
| Smart Filter | Search, Range, Colors, Sort, Tabs, Accordion filters… |
| Marketing | Testimonials, PricingTable, Countdown, WhatsApp, Google Reviews… |
| Menu Widgets | MegaMenu, FullscreenMenu, SideMenu… |
| Hero | Video Hero, Split Hero, Persona Hero… |
| Media | Gallery, Video carousel, Audio player… |
| Infographic | Timeline, Charts, Funnel, Progress bars… |
| Tools | ContactForm, CookieConsent, ShopAssistant, SmartFilter, Calendar… |
| Form Builder fields | Field kéo vào form canvas |
| Typography / Buttons / Hover | Gradient text, animated buttons, hover effects… |

### Nâng cao trên block

- **Dynamic Visibility** — **57 loại condition** (meta, page, user, listing, date, product…) — ẩn/hiện block
- **Responsive Advanced** — override tablet/mobile
- **Open popup** — gắn popup campaign vào bất kỳ widget
- Block **ShopAssistant**, **AddToCart**, **SmartFilter** — chạy **live** trên shop (catalog thật)

### PDP description editor

- Palette block gọn riêng khi soạn mô tả sản phẩm (`product-{id}`)

---

## 3. Shop — Bàn thương mại

### Sản phẩm (`/studio/products`)

- CRUD SKU — tên, brand, giá thường/sale, ACTIVE
- Tồn **read-only** (từ ERP)
- **Tạo / sửa mô tả CMS** — trang `product-{id}` · Minerp Page Builder
- **Copy landing (paragraph):** [`marketing/studio/shop-products.md`](../../../../marketing/studio/shop-products.md)

### Sales (`/studio/sales`)

- **Temporary Price Change (TPC)** — đợt giảm giá theo SKU + ngày
- Apply → PDP/checkout đọc giá mới
- **Copy landing (paragraph):** [`marketing/studio/shop-sales.md`](../../../../marketing/studio/shop-sales.md)

### Đơn hàng (`/studio/orders`)

- List đơn web — lọc `state_code`
- **Hủy / Fulfill / Giao** theo trạng thái Minerp
- **Đơn hộ (walk-in / phone)** — picker kiểu POS, COD, giá PDP hiện tại
- **Áp voucher** đã phát hành trên đơn hộ
- **Copy landing (paragraph):** [`marketing/studio/shop-orders.md`](../../../../marketing/studio/shop-orders.md)

### Khách hàng (`/studio/customers`)

- Danh bạ B2C — tìm/tạo/sửa
- Picker khách cho đơn hộ
- Trùng SĐT/email → 409, không merge tự động
- **Copy landing (paragraph):** [`marketing/studio/shop-customers.md`](../../../../marketing/studio/shop-customers.md)

---

## 4. Thư viện — Data model & nội dung (JetEngine-lite)

### Loại nội dung (`/studio/content-types` + `/studio/content/{type}`)

- **Custom Content Types (CCT)** — schema field tùy biến
- **Entries** — CRUD + workflow duyệt
- Archive công khai `/t/{type}/{slug}`
- **Copy landing (paragraph):** [`marketing/studio/library-content-types.md`](../../../../marketing/studio/library-content-types.md)

### Taxonomies (`/studio/taxonomies`)

- Phân loại phân cấp / phẳng + terms
- **Copy landing (paragraph):** [`marketing/studio/library-taxonomies.md`](../../../../marketing/studio/library-taxonomies.md)

### Quan hệ (`/studio/relations`)

- Liên kết entry/term
- **Canvas** + **Graph view** — metadata trên link
- **Copy landing (paragraph):** [`marketing/studio/library-relations.md`](../../../../marketing/studio/library-relations.md)

### Truy vấn (`/studio/queries`)

- **Saved Queries** — nguồn items tái sử dụng (CCT, relation, REST, catalog)
- Golden path: **Query → Listing template → Content listing block**
- **Copy landing (paragraph):** [`marketing/studio/library-queries.md`](../../../../marketing/studio/library-queries.md)

### Biểu mẫu (`/studio/forms`)

- Form builder canvas
- **Submissions inbox** — `/studio/forms/{id}/submissions`
- Actions: email, redirect, ghi CCT, kích workflow
- **Copy landing (paragraph):** [`marketing/studio/library-forms.md`](../../../../marketing/studio/library-forms.md)

### Bộ lọc (`/studio/filters`)

- **Smart Filter builder** — soạn bộ lọc một lần, gắn PLP/blog
- **Copy landing (paragraph):** [`marketing/studio/library-filters.md`](../../../../marketing/studio/library-filters.md)

### Kết nối API (`/studio/connections`)

- HTTPS REST + preset catalog Minerp
- Dùng cho Saved Query `rest_api`
- **Copy landing (paragraph):** [`marketing/studio/library-connections.md`](../../../../marketing/studio/library-connections.md)

### Media (`/studio/media`)

- Upload ảnh/PDF/file
- URL công khai dùng trong page, email, form
- **Copy landing (paragraph):** [`marketing/studio/library-media.md`](../../../../marketing/studio/library-media.md)

---

## 5. Theme, Popup & Merchandising

### Theme locations (4 URL shop)

| Location | URL | Block live |
|----------|-----|------------|
| Product archive | `/products` | Smart Filter + Content listing |
| Product single | `/products/{id}` | Product Gallery + Add to cart |
| Blog archive | `/blog` | Filter + Content listing |
| Blog single | `/blog/{slug}` | Dynamic title/field |

### Popup campaigns

- Trigger: **load, click, exit, idle, scroll**
- Targeting: include/exclude path, lịch `starts_at`/`ends_at`
- Frequency: always / session / N ngày
- Chrome: classic, slide, bar, full + animation
- Gắn popup từ **Advanced → Open popup** trên bất kỳ block

---

## 6. Cài đặt site (`/studio/settings`)

| Tính năng | Mô tả |
|-----------|--------|
| **Brand & site metadata** | Tên shop, SEO cơ bản |
| **Theme kit** | Bộ màu, density (compact/comfortable) |
| **Typography tokens** | H1–H6, body toàn site |
| **Page content width** | Narrow → full width |
| **Shop URL / domain** | Slug `/s/{shop_id}/…`, bind host riêng |
| **Header/Footer source** | Menu Puck hoặc fallback |
| **Email legacy SMTP** | Fallback trước khi có Email Builder SKU |
| **Xuất / nhập gói CMS** | `.minerp-cms.zip` — backup/migrate (import = draft) |
| **Copy landing (paragraph):** [`marketing/studio/setup-site-settings.md`](../../../../marketing/studio/setup-site-settings.md) |

---

## 7. Email Builder *(add-on SKU `email_builder`)*

- **Copy landing (paragraph):** [`marketing/studio/library-email.md`](../../../../marketing/studio/library-email.md)

### Kết nối mail (`/studio/emails/connections`)

- Custom SMTP, **Gmail/Microsoft OAuth**
- SendGrid, Mailchimp Transactional
- **Platform relay**
- Test send, đặt connection mặc định
- Import SMTP từ Site settings

### Template email (`/studio/emails/templates`)

- **Block builder** (Puck → MJML/HTML) hoặc **HTML raw**
- Merge tokens: `{{shop.name}}`, `{{order.code}}`…
- Draft → Publish
- Preview, test send, thư viện shop sections

### Activity (`/studio/emails/activity`)

- Analytics deliveries
- **Cart abandon recovery**
- Workflow runs + step timeline
- Merchant tasks

---

## 8. Workflow Automation *(add-on SKU `workflow_builder`)*

- **Copy landing (paragraph):** [`marketing/studio/library-workflow.md`](../../../../marketing/studio/library-workflow.md)

### Canvas (`/studio/workflows`)

- Visual graph: Trigger → Wait → Condition → HTTP → Send email → Create task…
- Activate / test trigger / debug runs

### Trigger shop (Wave 2)

| Trigger | Sự kiện |
|---------|---------|
| `payment_failed` / `payment_confirmed` | Checkout CARD |
| `account_registered` | Đăng ký shopper |
| `cart_abandoned_reminder_2` | Giỏ bỏ quên |
| `price_change_scheduled/applied/ended` | TPC sale |
| `wishlist_price_drop` | Giá giảm trên wishlist |
| `back_in_stock` | Có hàng lại |
| `page_published` | Publish CMS page |
| `newsletter_subscribed` | Form capture email |
| `refund_issued` | Hoàn tiền đơn |
| `blog_published` | Approve blog entry |
| `product_activated` | SKU live |
| `promo_voucher_created` | Phát voucher |
| `campaign_started` | Popup vào cửa sổ schedule |

### Node bổ sung

- **Batch send** (audience max 50/lần)
- **Sync Mailchimp audience**
- **Tag customer**
- **HTTP webhook**
- **Create merchant task**

---

## 9. Shop AI *(add-on SKU `shop_ai`)*

- **Copy landing (paragraph):** [`marketing/studio/library-shop-ai.md`](../../../../marketing/studio/library-shop-ai.md)

Gói merchant trên **Minerp Agent** (runtime AI platform — service `multi-agent`). Chi tiết platform: [minerp-odm-features.md §4](./minerp-odm-features.md#4-minerp-agent--nền-tảng-ai-service-multi-agent).

### Tổng quan (`/studio/agents`)

- Hub thống kê bot + knowledge base

### Zalo CSKH (`/studio/agents/zalo`)

- OAuth OA (khuyến nghị) hoặc paste token
- Webhook URL, quản lý bot active/inactive

### Knowledge (`/studio/agents/knowledge`)

- Tạo KB, **FAQ Q&A editor**
- Upload PDF/TXT/MD → ingest Qdrant
- **Đồng bộ catalog → RAG** (sync ngay / hàng đêm)
- Gợi ý FAQ từ câu hỏi khách lặp lại

### Hội thoại (`/studio/agents/conversations`)

- Inbox **Widget web + Zalo + Messenger**
- **Live agent** — claim/release thread, round-robin
- Filter guest/logged-in, search trong thread

### Messenger (`/studio/agents/messenger`)

- Kết nối Facebook Page + webhook Meta

### Chất lượng chat (`/studio/agents/quality`)

- Báo cáo trả lời yếu, gap FAQ
- Link sang inbox / duyệt FAQ

### MCP tools (`/studio/agents/mcp`)

- Quản lý **MCP connections** readonly cho tenant (SKU `shop_ai`)
- Connector **Minerp shop CSKH** — catalog + tra cứu đơn qua hub
- Pack **Shop marketing** — ads metrics, calendar, email read (readonly)
- Test connection; bot Zalo/Messenger/widget dùng tool MCP khi connection active

### Báo cáo nền (`/studio/agents/background-jobs`)

- Inbox kết quả job Celery — danh sách + chi tiết `result_summary`
- Tạo báo cáo one-shot hoặc digest định kỳ từ Studio
- Tool **`schedule_report`** trong chat Shop AI / ERP
- Thông báo email/Zalo/Telegram qua notification service (tuỳ chọn)

### Trên storefront

- Block Puck **ShopAssistant** — chat AI embed trên shop

---

## 10. Dev / nội bộ

| Tính năng | Route |
|-----------|-------|
| **Block Lab** | `/dev/block-lab?block={Type}` — test block không cần login Studio |

---

## Chưa có / ngoài phạm vi Studio

| Không có trong Studio | Ghi chú |
|------------------------|---------|
| POS / till / Transaction desk | Out of scope |
| Tạo/sửa voucher Offer | Chỉ **áp** voucher đã phát hành |
| Merge khách trùng | 409 — mở bản có sẵn |
| Hoàn tiền PSP đầy đủ | ERP / wave sau |
| Marketplace multi-merchant | Initiative riêng |

---

## Tóm tắt menu Studio

```
Site      → Trang · Blog · Templates · Menus
Shop      → Sản phẩm · Sales · Đơn hàng · Khách hàng
Thư viện  → CCT · Taxonomies · Quan hệ · Truy vấn · Biểu mẫu
          → Email* · Workflow* · Shop AI* (incl. MCP) · Bộ lọc · API · Media
Cài đặt   → Brand, theme, domain, import/export CMS
```

\*Hiện khi tenant có entitlement SKU tương ứng.

---

## Tài liệu liên quan

| Loại | Path |
|------|------|
| **Marketing briefs Studio** (copy landing) | [`marketing/studio/00-index.md`](../../../../marketing/studio/00-index.md) |
| **Minerp ODM (core ERP + Agent)** | [`minerp-odm-features.md`](./minerp-odm-features.md) |
| User guides | `docs/user-guides/extension/bms-storefront-cms/` |
| Screenshot marketing | `www/storefront/public/marketing/screenshots/` |
| BA artifacts | `docs/ba/artifacts/packages/extension/bms/storefront/` |