--- title: "README" url: https://phatdev.net/docs/tandoanh-buildpc/readme lang: vi updated: 2026-10-20 alternate: en: https://phatdev.net/en/docs/tandoanh-buildpc/readme markdown: https://phatdev.net/docs/tandoanh-buildpc/readme.md --- # README Thuộc bộ tài liệu: [PC Builder](https://phatdev.net/docs/tandoanh-buildpc.md) > Plugin WordPress/WooCommerce giúp khách tự ráp cấu hình PC theo từng bước, có trợ lý AI tư vấn theo ngân sách và nhu cầu. ## Tân Doanh Build PC **Phiên bản:** 2.10.5 (2026-10-06) **Tác giả:** Steven Lam | **Website:** [tandoanh.vn](https://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. Lưu ý: phiên bản hiện tại là 2.10.5. Phần mô tả bên dưới tổng hợp các tính năng chính của dòng 1.x và 2.x; thay đổi từ bản 2.2.2 trở đi xem [Changelog](https://phatdev.net/docs/tandoanh-buildpc/changelog). **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](https://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ợ - **Tài liệu**: [docs.tandoanh.vn](https://docs.tandoanh.vn) - **Email**: admin@tandoanh.vn - **Hotline**: +84.379.678910 --- **Plugin hữu ích? Hãy để lại 5 sao**