LDA QA Documentation

Test Strategy

Mục tiêu là đảm bảo LDA có thể release an toàn trên 3 lớp: website public, backend API và admin/CDP.

Loại kiểm thử

Môi trường test

• Admin frontend: pnpm install, pnpm dev trong core-ops-frontend-nextjs-main, port 3300.
• Website public: pnpm install, pnpm dev trong website-v2-master, port 3000.
• Backend Go: go run . migrate up, go run main.go.
• DB local: docker compose up -d trong backend.

Ghi chú quan trọng

• Không được kết luận GO nếu chưa chạy build, smoke test và core flow.
• Nếu test bằng mock, phải ghi rõ là mock pass, không được xem là integration pass.
• Những lỗi liên quan thanh toán, tổng tiền, quyền admin, role QC/KT phải ưu tiên P0/P1.

Test Scenarios

Danh sách dưới đây hiển thị các scenario chính theo module. File Markdown chi tiết có đủ 125 tình huống: 35 Website, 35 Backend API, 40 Admin/CDP và 15 Non-functional.

Website public

Backend API

Admin/CDP

Non-functional

Test Cases

Smoke test

Website public test cases

Regression checklist

• Homepage, collection, PDP, cart, checkout pass trên desktop/mobile.
• Backend health, catalog, homepage, navigation, SEO pass.
• Admin mutation quan trọng cần auth.
• Không còn bug Critical/High trước release.

Ghi chú khi chạy test case

• Mỗi test case phải có status: Pass, Fail, Blocked hoặc Not Run.
• Nếu Fail, phải có screenshot/log/API response và bug ID.
• Không ghi Pass nếu chỉ đọc source mà chưa chạy trên môi trường.

Acceptance Criteria

Definition of Done

• Code hoặc release candidate build được.
• Test cases Critical/High pass.
• QA report cập nhật kết quả, evidence và bug list.
• QC Gate đạt GO hoặc CONDITIONAL GO với điều kiện rõ ràng.

QA Report

NOT EXECUTED - prepared from source review

Bộ source trong C:\Users\Admin\Downloads\LDA\LDA đang ở dạng zip. Tài liệu này được lập từ README, docs sẵn có, package/go module, route và module source code. Chưa chạy dev server, chưa install dependency, chưa kết nối DB/ERP.

Phạm vi đã review

Rủi ro đã thấy

• High: Existing e2e report ghi nhận role gating fail trong stocktake variance.
• High: Trang kế toán stocktake thiếu timeline/context.
• Medium: Backend và website public có thể cùng dùng port 3000.
• Medium: Catalog phụ thuộc ERP readonly DSN.

App Foundation Status

Readiness score tạm thời

• Source organization: 8/10.
• Local setup clarity: 7/10.
• Test documentation: 7/10.
• Release confidence: 4/10 vì chưa chạy build/test thật.
• Security/permission confidence: 5/10 vì stocktake report ghi role gating fail.

Agent Order Flow

Flow tổng quát

Điều kiện Pass

• Agent đăng nhập được website v2 nếu release có login website thật.
• Agent đặt hàng thành công và lấy được mã đơn thật qua API/service order đã xác nhận.
• Agent đăng nhập được admin.
• Đơn tạo từ website xuất hiện trong admin; nếu Web BE chưa có order/checkout thì mục này phải ghi Blocked, không ghi Pass.
• Dữ liệu đơn trong admin khớp với dữ liệu đặt hàng.
• Admin xử lý/cập nhật trạng thái đơn thành công.
• Logout website và logout admin đều xóa session đúng.

Web/Admin Split

Phân loại source

Web FE cần test

• Trang chủ, header, menu, search.
• Danh mục sản phẩm, filter, sort, pagination.
• Chi tiết sản phẩm, gallery, giá, tồn kho, CTA.
• Giỏ hàng, voucher, checkout, trang thành công.
• Login/logout website nếu có user account; source hiện chưa thấy route /login, /dang-nhap, /tai-khoan trong Web FE.
• Blog, static pages, SEO, responsive.

Web BE cần test

• Health API: /ping, /version.
• Catalog: search, brands, categories, products, detail, reviews.
• Collection, homepage bundle, product enrichment.
• SEO: metadata, redirects, sitemap.
• Promotions, blog, user, admin API.
• Chưa thấy module order/checkout trong Web BE; E2E đặt hàng phải Blocked nếu không có service khác.
• Error handling, auth, permission, không leak stack trace.

Admin FE cần test

• Login/logout admin, protected route, token hết hạn.
• Sidebar, header, active menu, permission.
• Collection CMS, product enrichment, homepage CMS.
• Coupon/voucher, SEO admin, upload.
• Stocktake, variance workflow, role QLCH/QC/KT.
• Order management: source Admin FE có route /orders, /orders/[id], /orders/create.

Flow tích hợp bắt buộc

Ghi chú

• Không ghi chung “web pass” nếu chỉ test FE mà chưa test BE.
• Không ghi “admin pass” nếu chưa kiểm permission và action xử lý.
• Admin FE có module đơn hàng, nhưng dữ liệu đơn từ Web FE vẫn phụ thuộc API/service order.
• Nếu thiếu ERP DSN hoặc backend order API, phải ghi rõ Blocked/Skipped with reason.

Full Scenarios

Cấu trúc tài liệu đầy đủ

Ví dụ format mỗi kịch bản

Flow E2E quan trọng nhất

• Agent login Website v2 nếu flow login website có thật; nếu chưa có route/modal thì ghi Blocked/NA.
• Agent chọn sản phẩm, thêm giỏ, checkout UI.
• Web BE/service tạo/lưu/đồng bộ đơn; hiện source Web BE chưa thấy module order/checkout.
• Agent login Admin FE.
• Admin search mã đơn, kiểm chi tiết đơn.
• Admin xử lý trạng thái đơn.
• Agent logout cả website và admin.

Login/Logout bắt buộc phải có trong report

Ghi chú bắt buộc

• Nếu thiếu ERP DSN, test catalog thật phải ghi Blocked/Skipped with reason.
• Admin FE có module order, nhưng flow order từ Web FE sang Admin vẫn phải ghi Blocked - Missing Web BE order/checkout integration nếu chưa có API/service order.
• Không được kết luận Web FE pass nếu chưa test cart/checkout.
• Không được kết luận Admin FE pass nếu chưa test permission.
• Không được kết luận E2E pass nếu đơn từ Web FE không tạo được qua API/service thật và không tìm được trong Admin FE.