Vendor testing and screenshots index
Nội dung này hiện chưa có sẵn bằng ngôn ngữ của bạn.
Executive summary
Section titled “Executive summary”This page defines and tracks the required quality gate for vendor-web screen work:
- Unit tests for screen logic
- E2E tests for user flows
- Docs screenshots for documented screens
When adding or changing a vendor screen, update this index in the same PR.
Required baseline (mandatory)
Section titled “Required baseline (mandatory)”For every user-facing vendor screen:
- Unit test set (component/hook/schema/service adapter logic in
apps/vendor-web/src/**). - E2E test set (Playwright flow in
apps/vendor-web/e2e/**). - Screenshot for docs (PNG under
apps/docs/public/screenshots/vendor/, captured by Playwright docs screenshot specs).
If one item is missing, the screen is not documentation-complete.
Current project index (as-is)
Section titled “Current project index (as-is)”Existing automated files
Section titled “Existing automated files”- E2E specs:
apps/vendor-web/e2e/login.spec.tsapps/vendor-web/e2e/docs-screenshots.spec.tsapps/vendor-web/e2e/docs-cashier-screenshots.spec.ts— Cashier help center PNGs underscreenshots/cashier/apps/vendor-web/e2e/pos-place-order-surfaces.spec.ts— source contract for sharedusePosPlaceOrderon dashboard POS, POS workspace sale, and create order (see POS guide → Place order — shared client hook).
- Vendor-web unit specs (examples; full set under
apps/vendor-web/src/**/*.spec.ts):apps/vendor-web/src/lib/pos-place-order-mutation-handlers.spec.ts— stock highlight helpers used byusePosPlaceOrder.apps/vendor-web/src/lib/pos-order-receipt-finalize.spec.ts— post-checkoutrunVendorPosOrderReceiptFinalize(fetch, TanStack invalidations, fallback snapshot, silent print). See POS guide → Receipt after checkout — shared finalize helper.apps/vendor-web/src/hooks/use-pos-place-order.contract.spec.ts— asserts the three checkout surfaces still wire the hook.
- Vendor docs screenshots:
apps/docs/public/screenshots/vendor/vendor-login-sign-in.png
Screen status matrix
Section titled “Screen status matrix”| Screen / flow | Unit tests (vendor-web) | E2E tests | Docs screenshot | Status |
|---|---|---|---|---|
/login (sign-in) | ⛔ | ✅ (login.spec.ts) | ✅ (vendor-login-sign-in.png) | Partial (missing unit set) |
/forgot-password | ⛔ | ⛔ | ⛔ | Backlog |
/verify-otp | ⛔ | ⛔ | ⛔ | Backlog |
/reset-password | ⛔ | ⛔ | ⛔ | Backlog |
/dashboard (home) | ⛔ | ⛔ | ⛔ | Backlog |
/pos | ✅ (POS libs + use-pos-place-order.contract) | ✅ (pos-place-order-surfaces.spec.ts contract) | ⛔ | Partial |
Cashier /point-of-sale/sale | ✅ (POS libs) | ⛔ (flow) | ⛔ (docs-cashier-screenshots.spec.ts) | Partial |
/point-of-sale/orders, returns, report, settings | ⛔ | ⛔ | ⛔ (batch in cashier docs spec) | Backlog |
Core dashboard screens (orders, products, inventory, finance, customers, discounts, settings) | ⛔ | ⛔ | ⛔ | Backlog |
Legend: ✅ complete, ⛔ missing.
How to update this index
Section titled “How to update this index”When implementing a new screen or changing behavior:
- Add/update unit specs under
src/**. - Add/update Playwright E2E under
e2e/**. - Capture/update docs screenshot via
docs-screenshots.spec.tsordocs-cashier-screenshots.spec.ts(Cashier help). - Update the corresponding row in this index.
- Rebuild docs:
cd apps/docs && npm run build.
Related
Section titled “Related”- E2E retail roadmap and checklist — P0/P1 screen checklist, phased work packages, and release gate (schedule TBD)
- System test cases (index) — cross-module happy / unhappy catalogue and E2E suitability notes (supersedes ad-hoc QA lists over time)
- Vendor panel overview
- Sign-in and account (Vendor)
- Cashier help center — user guide for
/point-of-sale/* - Frontend applications