Hướng Dẫn Sử Dụng

Cách sử dụng Admin Panel quản lý rượu vang

1. Bắt Đầu

Kiến Trúc Hệ Thống

Hệ thống tách biệt Frontend-Backend:

  • Frontend: Next.js 15 - Website khách hàng xem (port 3000)
  • Backend API: Laravel 12 - API endpoints (port 8000)
  • Admin Panel: Filament 4 - Quản lý tại http://127.0.0.1:8000/admin

Truy Cập Hệ Thống

Backend Admin: http://127.0.0.1:8000/admin
Frontend Website: http://localhost:3000
API Endpoints: http://127.0.0.1:8000/api/v1

Đăng Nhập Admin

  1. Mở trình duyệt

    Vào http://127.0.0.1:8000/admin

  2. Nhập email & password

    Sử dụng tài khoản admin (default: admin@example.com)

  3. Click "Đăng nhập"

    Vào Dashboard

Khởi Động Hệ Thống

cd wincellarcloneBackend && php artisan serve cd ../wincellarcloneFrontEnd && npm run dev

Backend chạy port 8000, Frontend port 3000

2. Admin Panel (Filament)

Dashboard hiển thị: Tổng sản phẩm, bài viết, visitor, top products, top articles.

Sidebar menu: Sản phẩm, Bài viết, Taxonomy, Menu, Settings, Tracking, Social Links.

3. Sản Phẩm

Thêm Sản Phẩm

  1. Menu Sản Phẩm → Thêm Mới
  2. Điền tên sản phẩm

    VD: "Rượu Vang Đỏ Bordeaux Château Margaux 2015"

  3. Nhập giá & giá gốc

    Để tính % giảm auto

  4. Upload ảnh

    Ảnh chính + gallery (kéo thả)

  5. Điền độ cồn, vintage, dung tích
  6. Chọn phân loại

    Brand, origin, wine type, grapes

  7. Nhập mô tả & SEO
  8. Click "Lưu"

Các Trường Quan Trọng

  • Tên (Bắt buộc): Tên rượu đầy đủ
  • Slug: Auto tạo từ tên (dùng cho URL)
  • Giá: Giá hiện tại VND
  • Giá Gốc: Giá cũ (nếu sale)
  • Vintage: Năm sản xuất (VD: 2015)

4. Taxonomy (Phân Loại)

Taxonomy giúp phân loại sản phẩm theo nhiều tiêu chí để dễ tìm kiếm.

Các Taxonomy

  • Brands: Thương hiệu (Château Margaux, Penfolds...)
  • Origin > Country: Quốc gia (Pháp, Ý, Chile...)
  • Origin > Region: Vùng (Bordeaux, Tuscany...)
  • Wine Types: Loại (Đỏ, Trắng, Rosé, Sparkling)
  • Grapes: Giống nho (Cabernet, Merlot, Chardonnay...)

Thêm Term Mới

  1. Menu Taxonomy → chọn loại (VD: Brands)
  2. Click "Thêm Mới"
  3. Nhập tên term

    VD: "Château Latour"

  4. Upload logo/icon (tuỳ chọn)
  5. Click "Lưu"

5. Bài Viết

Thêm Bài Viết

  1. Menu Bài Viết → Thêm Mới
  2. Nhập tiêu đề

    VD: "Cách Chọn Rượu Vang Cho Bữa Tiệc"

  3. Upload ảnh bìa
  4. Viết nội dung

    Dùng Rich Text Editor (giống Word)

  5. Thêm gallery (tuỳ chọn)
  6. Cài đặt SEO

    Meta title, description

  7. Click "Xuất Bản"

7. Settings (Cài Đặt)

Quản lý thông tin chung của website: logo, hotline, email, địa chỉ, SEO defaults.

Các Cài Đặt Quan Trọng

  • Site Name: Tên website (VD: "Thiên Kim Wine")
  • Logo & Favicon: Upload ảnh
  • Hotline, Email, Địa chỉ, Giờ mở cửa
  • Google Maps Embed: Dán iframe từ Google Maps
  • Meta Defaults: Title, description, keywords cho SEO

8. SEO & Meta Tags

SEO giúp website xuất hiện trên Google khi khách tìm "rượu vang", "wine shop"...

Cài Đặt SEO Cho Sản Phẩm

  1. Vào sản phẩm cần chỉnh
  2. Cuộn đến phần "SEO Settings"
  3. Điền Meta Title

    VD: "Rượu Vang Đỏ Bordeaux 2015 - Thiên Kim Wine"

  4. Điền Meta Description

    VD: "Rượu vang Pháp cao cấp, độ cồn 13.5%, giá 2.5M. Giao hàng toàn quốc"

  5. Thêm Keywords

    VD: "rượu vang đỏ, bordeaux, pháp"

  6. Lưu
Mẹo: Viết mô tả tự nhiên cho người đọc, không spam từ khóa. Google thích nội dung hữu ích, không spam.

9. Tracking & Analytics

Xem có bao nhiêu người vào website, sản phẩm nào hot, bài viết nào phổ biến.

Xem Thống Kê

  1. Vào Dashboard
  2. Xem widget "Visitors Today"

    Số người hôm nay

  3. Xem "Top Products"

    Sản phẩm xem nhiều

  4. Xem "Popular Articles"

    Bài viết đọc nhiều

Dữ Liệu Thu Thập

  • Số lượt truy cập (không lưu IP, email)
  • Sản phẩm được xem (tracking)
  • Bài viết được đọc
  • Click "Liên hệ" (CTA tracking)