🎭 Playwright TS build by Antigravity - Book Management

Playwright TS build by Antigravity là một framework kiểm thử tự động mạnh mẽ và hiện đại dành cho hệ thống Book Management. Framework này được thiết kế và tối ưu hóa bởi Antigravity AI, sử dụng Playwright kết hợp với TypeScript và mô hình Page Object Model (POM) để mang lại hiệu suất kiểm thử vượt trội cùng khả năng bảo trì linh hoạt.

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

🏗️ Page Object Model (POM): Cấu trúc code sạch sẽ, dễ bảo trì và tái sử dụng.
🛡️ TypeScript: Đảm bảo type-safety, giảm thiểu lỗi runtime và cải thiện trải nghiệm lập trình.
🎲 Faker.js Integration: Tự động tạo dữ liệu kiểm thử thực tế (Book names, prices, descriptions, etc.).
🚀 Parallel Execution: Hỗ trợ chạy song song nhiều tests (mặc định 3 workers) giúp tiết kiệm thời gian.
🌐 Cross-browser Testing: Kiểm thử mượt mà trên Chromium, Firefox và WebKit (Safari).
📊 Rich Reporting: Báo cáo HTML chi tiết kèm theo screenshots và video khi test thất bại.
🤖 CI/CD Ready: Tích hợp sẵn GitHub Actions để tự động chạy test khi có thay đổi code.
�️ Maximized Browser: Cấu hình tự động mở rộng trình duyệt tối đa để đảm bảo hiển thị đúng 100% scale.

🛠️ Công nghệ sử dụng

🏗️ Cấu trúc dự án

PlaywrightMCP_Antigravity/
├── .github/workflows/      # Cấu hình GitHub Actions CI/CD
├── data/                   # Data generator và hằng số test data
├── pages/                  # Page Object Models (POM) các trang
│   ├── base.page.ts        # Lớp cha chứa các utilities dùng chung
│   ├── login.page.ts       # Page object cho trang Đăng nhập
│   └── ...                 # Các trang khác (Add book, Management)
├── test-data/              # Assets cho việc test (Images, Files)
├── tests/                  # File chứa các kịch bản kiểm thử (.spec.ts)
├── playwright.config.ts    # Cấu hình chính của Playwright
├── package.json            # Các scripts và dependencies
└── tsconfig.json           # Cấu hình TypeScript

🚀 Hướng dẫn bắt đầu

1. Yêu cầu hệ thống

Node.js: Phiên bản 18 trở lên.
npm hoặc yarn.

2. Cài đặt

# Di chuyển vào thư mục dự án
cd PlaywrightMCP_Antigravity

# Cài đặt các thư viện cần thiết
npm install

# Cài đặt trình duyệt cho Playwright
npx playwright install

3. Chạy kiểm thử

Framework hỗ trợ nhiều câu lệnh chạy test linh hoạt:

📝 Danh sách kịch bản kiểm thử (Test Cases)

Dự án hiện tại bao quát các kịch bản chính cho hệ thống Quản lý sách:

TC01: Verify Login Successfully - Kiểm tra đăng nhập thành công.
TC02: Navigate to Book Management - Kiểm tra điều hướng trang.
TC03: Add New Book with Valid Data - Thêm mới sách với đầy đủ dữ liệu hợp lệ.
TC04: Missing Required Fields - Kiểm tra validate các trường bắt buộc.
TC05: Invalid Price - Kiểm tra validate khi nhập giá sách không hợp lệ.
TC06: Add Multiple Books in Parallel - Kiểm tra độ ổn định khi tạo nhiều sách đồng thời.
TC07: Verify Reset Button Functionality - Kiểm tra chức năng xóa sạch form của nút Reset.
TC08: Verify Form Validation on Empty Submit - Kiểm tra nút Create bị disabled khi chưa nhập liệu.

🤖 CI/CD Pipeline

Mỗi khi bạn push code lên nhánh main, quy trình tự động sẽ được kích hoạt:

Khởi tạo môi trường Node.js.
Cài đặt dependencies và browsers.
Chạy toàn bộ bộ test suite.
Upload báo cáo HTML lên GitHub Artifacts.

Bạn có thể tìm thấy kết quả chạy trong tab "Actions" trên GitHub.

🤝 Hỗ trợ

Dự án được phát triển và tối ưu hóa với sự hỗ trợ từ Antigravity AI. Nếu bạn có bất kỳ thắc mắc nào, vui lòng liên hệ admin hoặc tạo Issue trên kho lưu trữ.

📄 Giấy phép

Dự án này được phân phối dưới giấy phép ISC.

MCP Servers