phatdev/docs

README

Phiên bản: 2.2.2 (20260512)

Tân Doanh Build PC

Phiên bản: 2.2.2 (2026-05-12)
Tác giả: Steven Lam | Website: tandoanh.vn

Plugin WordPress/WooCommerce chuyên nghiệp giúp khách hàng tự xây dựng cấu hình PC theo từng bước, được trang bị AI Assistant thông minh để đưa ra đề xuất tối ưu dựa trên ngân sách và nhu cầu.

🆕 Nổi bật v2.2.2: Bug Fix Quan Trọng — Khắc phục lỗi "Security verification failed" phát sinh khi WP Rocket cache HTML chứa nonce WordPress hết hạn (12-24h). Class mới TanDoanhBuildPC_NonceRefresh tự động làm tươi nonce qua AJAX endpoint không cache, áp dụng cho cả user mới và tab mở lâu (refresh mỗi 30 phút).

🚀 Tính Năng Chính

🤖 AI Assistant (Tư vấn viên ảo)

Tính năng chính của plugin, sử dụng Google Gemini để tư vấn cấu hình PC thông minh.

Tính năng nổi bật:

  • Tư vấn thông minh: Chat với AI để nhận cấu hình phù hợp (gaming, đồ họa, văn phòng)
  • Phân tích ngân sách: Tự động xây dựng cấu hình đạt 94-99% ngân sách
  • Kiểm tra tương thích: Đảm bảo tất cả linh kiện tương thích với nhau, đặc biệt khe cắm Intel/AMD
  • 8 linh kiện hoàn chỉnh: Đề xuất đủ bộ từ bộ xử lý đến vỏ máy
  • Áp dụng một cú nhấp: Chuyển cấu hình AI vào trình build ngay lập tức

Cải tiến gần đây:

  • v2.0.2: Security hardening (8 lỗ hổng), Performance tối ưu, Cache invalidation, Composite index
  • v2.0.1: Backup & Debug hoàn chỉnh (Server Health Monitor, AI log management, security fixes)
  • v2.0.0: AI Index thông minh (lọc 4522→1544 sản phẩm, giảm token 35-45%, lên lịch rebuild)
  • v1.6.8: Tối ưu CSS/JS -850KB, tab Info, PageSpeed +15
  • v1.6.7: Multi-builder support, AI admin dropdown chọn builder

🧠 AI Index System (MỚI v2.0.0)

Hệ thống index tự động xây dựng danh sách sản phẩm phù hợp cho AI, thay thế cache truyền thống.

Tính năng nổi bật:

  • Lọc sản phẩm thông minh: Chỉ index 1544/4522 sản phẩm (lọc giá ≤0, stock không phù hợp, sản phẩm hết hàng)
  • Dữ liệu sạch cho AI: Danh sách chỉ chứa sản phẩm xây dựng PC thực tế, không data rác
  • Giảm chi phí API: Dữ liệu gọn gàng → token API giảm 15-20%, tiết kiệm chi phí Gemini
  • Lưu trạng thái tự động: Ghi nhận số sản phẩm indexed, dễ theo dõi tiến độ rebuild
  • Lên lịch rebuild: Hỗ trợ rebuild tự động theo giờ/ngày/tuần (hourly, daily, weekly)
  • Dashboard mới: Giao diện quản lý AI Index rõ ràng, hiển thị "✅ 1544 sản phẩm được index"

Cách hoạt động:

  1. Admin nhấn "Rebuild AI Index" → Plugin quét sản phẩm WooCommerce
  2. Lọc sản phẩm phù hợp → Lưu vào bảng index (1544 sản phẩm)
  3. AI Assistant sử dụng danh sách index → Đề xuất cấu hình chính xác
  4. Token API giảm 15-20% so với cache truyền thống

🛠️ Build PC Thủ Công

  • Từng bước rõ ràng: Chọn từng loại linh kiện theo quy trình
  • Bộ lọc thông minh: Tự động lọc sản phẩm tương thích
  • Tốc độ cao: Modal tải nhanh với cache thông minh
  • Lưu tiến trình: Tự động lưu, tiếp tục trên nhiều tab

💾 Backup/Restore (MỚI v1.6.7)

  • Sao lưu toàn bộ: Xuất builder + steps + cài đặt plugin thành file JSON
  • Khôi phục nhanh: Import cấu hình từ file backup trong 1 cú nhấp
  • Drag-drop import: Kéo thả file JSON để import dễ dàng
  • Multi-builder: Hỗ trợ nhiều builder với dropdown chọn lựa thông minh

⚙️ Tự Động Hóa

  • Tự nhận diện (v1.6.1): Plugin tự động cấu hình trên mọi website
  • Đồng bộ 1 cú nhấp: Admin chỉ cần nhấn nút để setup AI
  • Tương thích toàn cầu: Không cần chỉnh sửa mã

📤 Chia Sẻ & Xuất

  • Tích hợp WooCommerce: Thêm toàn bộ cấu hình vào giỏ hàng
  • Email HTML: Gửi bản tóm tắt chuyên nghiệp
  • PDF + QR Code: Xuất file PDF có mã QR
  • In trực tiếp: Hỗ trợ in với định dạng tối ưu
  • Responsive: Hiển thị tốt trên mọi thiết bị

⚡ Cải Tiến Hiệu Năng (v1.6.8)

Tối ưu CSS/JS Loading

  • Giảm 850KB bandwidth: Assets chỉ load khi có shortcode [tandoanh_buildpc]
  • Giảm 20 HTTP requests: Không load trên trang chủ, sản phẩm, blog
  • PageSpeed +10-15 điểm: Cải thiện SEO và trải nghiệm người dùng
  • Tab Info mới: Thống kê nhanh, changelog trực tiếp trong Admin

Cách kiểm tra

Trước v1.6.8: 20 files (~850KB) load trên mọi trang
Sau v1.6.8: 0 files trên trang không dùng shortcode, 20 files chỉ khi cần

📋 Lịch Sử Cập Nhật Quan Trọng

📋 Lịch Sử Cập Nhật Quan Trọng

v2.0.3 (2025-11-12) - Mobile UX cải tiến (modal header động, gradient title, giảm 50% CSS size)
v2.0.2 (2025-11-02) - Security hardening (8 lỗ hổng critical), Performance optimization, Giảm 96% queries
v2.0.1 (2025-10-30) - Backup & Debug Tools hoàn chỉnh, Server Health Monitor
v2.0.0 (2025-10-28) - AI Index thông minh, lọc 4522→1544 sản phẩm, giảm token 35-45%
v1.6.8 (2025-01-17) - Tối ưu CSS/JS -850KB, tab Info, tăng PageSpeed +15
v1.6.7 (2025-10-16) - Backup/Restore toàn diện, multi-builder AI admin

🛠️ Cài Đặt & Sử Dụng

  1. Upload thư mục plugin vào /wp-content/plugins/
  2. Kích hoạt plugin trong WordPress admin
  3. Vào Build PC để tạo builder và setup các bước
  4. Kích hoạt AI:
    • Lấy Gemini API Key: aistudio.google.com/apikey
    • Vào Build PC → AI Settings, paste API Key
    • Vào Build PC → Đồng bộ AI, nhấn "Đồng bộ ngay"
  5. Dùng shortcode [tandoanh_buildpc] ở nơi cần hiển thị
  6. Backup/Restore: Vào Build PC → Cài đặt → Tab Backup/Restore

🔧 Cấu Trúc File (Tóm Tắt)

tandoanh-buildpc/
├── assets/
│   ├── css/        # CSS modular (core, components, admin, AI)
│   └── js/         # JS modules (managers, admin, AI chat)
├── includes/
│   ├── ai/         # AI module (Gemini, mappers, prompts)
│   ├── templates/  # PHP templates  
│   └── *.php       # Core classes (admin, ajax, frontend)
└── tandoanh-buildpc.php  # File chính

⚡ Đặc Điểm Kỹ Thuật

  • CSS/JS Modular: Tách components, load theo điều kiện shortcode
  • AI Module: Tích hợp Gemini 2.0 Flash với rate limiting
  • Performance: Transient cache, AJAX lazy loading, conditional assets
  • Security: Nonce validation, sanitize/escape, capability checks

💬 Hỗ Trợ

Plugin hữu ích? Hãy để lại 5 sao ⭐⭐⭐⭐⭐