05 — Quản lý sản phẩm (Mantis Product)

Sản phẩm Mantis Tech (Loa AI, AI Chatbot, AI Meeting Notes, ERPNext, HRMS, Digital Employee, …) được quản lý bằng DocType Mantis Product. Mỗi sản phẩm sinh ra tự động:

• Một trang chi tiết tại /products/<slug>.
• Một card xuất hiện trên /products (và trang chủ nếu Is Featured = 1).

1. Mở danh sách sản phẩm

Desk → /app/mantis-product.

Danh sách cho phép lọc theo Pillar, Is Featured, Published bằng thanh filter phía trên.

2. Tạo sản phẩm mới 🛡️

Chỉ Website Manager / System Manager có quyền tạo mới. Content Editor chỉ sửa.

1. Bấm + New hoặc vào /app/mantis-product/new.
2. Điền các trường bắt buộc:
   • Product Name — ví dụ AI Meeting Notes.
   • Slug — chỉ ký tự a-z, số, dấu -. Ví dụ ai-meeting-notes. Không thay đổi slug sau khi đã publish — sẽ làm gãy link/SEO.
   • Pillar — chọn 1 trong 4 (AI / IoT / ERP / Hardware).
   • Short Description — ≤ 160 ký tự (dùng cho card + meta description).
3. Bấm Save. Hệ thống tự sinh Route = products/<slug>.
4. Tiếp tục điền các section còn lại (xem mục 3).
5. Tick Published = 1 → bấm Save lần nữa.

3. Cấu trúc form Mantis Product

3.1. Thông tin cơ bản

3.2. Ảnh

• Thumbnail Image Filename — tên file ảnh thumbnail (ví dụ product-loa-ai.svg). File phải tồn tại trong public/images/ hoặc File Manager.
• Hero Image Filename — tên file ảnh hero lớn cho trang chi tiết. Dùng cùng file với thumbnail nếu không có ảnh riêng.

Cách upload ảnh: xem 11 — Upload & tối ưu ảnh.

3.3. Description

• Short Description — 1–2 câu, dùng cho card sản phẩm và <meta name="description">. Tối đa 160 ký tự.
• Long Description — rich text editor đầy đủ. Dùng cho trang chi tiết; tối thiểu ~300 từ theo chuẩn SEO nội bộ.

3.4. Features (bảng)

Danh sách tính năng chính. Mỗi dòng là Mantis Product Feature:

• Title — tên tính năng.
• Description — mô tả ngắn.
• Icon (tuỳ chọn) — tên icon (ví dụ spark, chip, chart).

Thêm dòng: bấm Add Row dưới bảng → điền → Save.

3.5. Benefits (bảng)

Danh sách lợi ích nghiệp vụ (business benefits). Mỗi dòng là Mantis Product Benefit:

• Title — ví dụ Tiết kiệm 40% thời gian họp.
• Description — bổ sung chi tiết.

3.6. SEO

• Meta Title — fallback là Product Name | Mantis Tech. Nên override nếu muốn tối ưu từ khoá.
• Meta Description — fallback là Short Description.
• OG Image Filename — ảnh 1200×630 cho Facebook/Zalo/Twitter share.

4. Xuất hiện sản phẩm ở đâu trên site?

5. Xoá / ẩn sản phẩm

• Ẩn tạm: Mở sản phẩm → bỏ tick Published → Save. Trang /products/<slug> sẽ trả 404 với khách.
• Xoá vĩnh viễn 🛡️: Menu ⋮ → Delete. Hệ thống sẽ cảnh báo nếu sản phẩm đang được link từ đâu đó.

⚠️ Sản phẩm chưa publish cũng trả về 404 ngay cả khi biên tập viên đã đăng nhập — đây là hành vi mặc định của is_published_field trong Frappe WebsiteGenerator. Muốn xem thử trang chi tiết, tạm tick Published → xem → bỏ tick lại nếu cần.

6. Quy tắc đặt tên & ảnh

• Slug: viết thường, dấu gạch ngang, không dấu. Ví dụ đúng: ai-meeting-notes, digital-employee. Ví dụ sai: AI_Meeting_Notes, loa ai.
• Ảnh thumbnail: 600 × 400 px, định dạng WebP/SVG.
• Ảnh hero: 1200 × 900 px, WebP.
• OG image: 1200 × 630 px, PNG/JPG.
• Alt text ảnh: tiếng Việt, mô tả nội dung ảnh (không phải tên file).

7. Checklist trước khi Publish

• Product Name, Slug, Pillar, Short Description đã điền.
• Ít nhất 3 Features và 3 Benefits.
• Long Description ≥ 300 từ, có ít nhất 1 ảnh illustrate.
• Thumbnail + Hero image đã set và kiểm tra hiển thị.
• Meta Title ≤ 60 ký tự, Meta Description ≤ 160 ký tự.
• OG Image 1200×630 có sẵn.
• Tick Published, Save, kiểm tra live ở tab ẩn danh.