PaNeTranG - Extension dịch toàn bộ trang web cho trình duyệt Chromium

Mục tiêu

PaNeTranG giúp bạn dịch toàn bộ nội dung trang web sang ngôn ngữ mong muốn chỉ với một cú nhấp chuột, tối ưu cho người Việt và các trình duyệt nhân Chromium (Chrome, Edge, Brave...).

Tính năng chính

• Dịch tự động toàn bộ trang web hoặc từng phần chọn lọc.
• Giai đoạn đầu ưu tiên sử dụng 2 API dịch: Google Translate và Open Router (cấu hình dễ dàng, tốc độ cao, ổn định).
• Giao diện popup thân thiện, dễ sử dụng, thao tác một chạm.
• Tùy chỉnh whitelist/blacklist trang web.
• Lưu cấu hình cá nhân, không thu thập dữ liệu nhạy cảm.
• Tối ưu hiệu năng, không làm chậm trang web.
• Module hóa User-first: mọi tính năng, giao diện, cấu trúc code đều ưu tiên trải nghiệm người dùng.

Cài đặt & sử dụng

1. Clone hoặc tải về mã nguồn dự án.
2. Vào chrome://extensions/, bật "Chế độ dành cho nhà phát triển".
3. Chọn "Tải tiện ích đã giải nén" và trỏ tới thư mục PaNeTranG.
4. Cấu hình API dịch (Google Translate, Open Router) trong popup hoặc trang cấu hình.
5. Truy cập trang web bất kỳ và sử dụng extension để dịch.

Đóng gói & publish lên Chrome Web Store

1. Đảm bảo đã kiểm thử đầy đủ các tính năng và unit test đều pass.
2. Xóa các file test, file không cần thiết khỏi thư mục extension.
3. Đóng gói toàn bộ thư mục extension (không bao gồm node_modules, tests, file phát triển) thành file .zip.
4. Đăng nhập vào tài khoản Chrome Web Store Developer, tạo extension mới.

Lịch sử cập nhật

• Xem chi tiết các thay đổi, tính năng mới, sửa lỗi tại CHANGELOG.md.

5. Upload file .zip, điền thông tin mô tả, icon, screenshot, email hỗ trợ (nghiaphm26@gmail.com).
6. Gửi duyệt và theo dõi trạng thái trên Developer Dashboard.

Kiểm thử extension

1. Đảm bảo đã lưu toàn bộ file code, test, cấu hình.
2. Vào chrome://extensions/, bật "Chế độ dành cho nhà phát triển".
3. Chọn "Tải tiện ích đã giải nén" và trỏ tới thư mục PaNeTranG.
4. Kiểm tra popup, dịch toàn trang, dịch vùng chọn, cấu hình, notification, help.
5. Để kiểm thử tự động:
   • Cài đặt Jest (npm install --save-dev jest) và chạy lệnh jest trong thư mục extension để kiểm tra các module chính.
   • Cài đặt Playwright (npm install --save-dev @playwright/test) và chạy script kiểm thử UI tại MCP/BrowserUse/ui-test-playwright.js để giả lập thao tác người dùng với extension (xem comment đầu file để cấu hình).

Đóng góp & phát triển

• Xem chi tiết kiến trúc, module hóa User-first, quy tắc phát triển tại PLANNING.md.
• Theo dõi tiến độ, nhiệm vụ tại TASK.md.
• Quy tắc toàn cục xem tại QUYTACTOANCUC.md.
• Đóng góp code, báo lỗi hoặc đề xuất tính năng mới qua pull request hoặc issue.

Liên hệ

• Email: nghiaphm26@gmail.com

---

Dự án tuân thủ bộ quy tắc prompting, module hóa User-first, ưu tiên tiếng Việt và trải nghiệm người dùng. Chi tiết xem trong PLANNING.md và QUYTACTOANCUC.md.