Tổng hợp Test Inventory

Snapshot lần ăn khớp với code thực tế. Cập nhật mỗi khi test counts thay đổi đáng kể. Xem features.md cho phạm vi feature, changelog.md cho lịch sử release.

Cập nhật lần cuối: 2026-05-05 (coverage audit lần đầu + branding.resolver.spec.ts lấp 0% gap)

Coverage snapshot 2026-05-05 (yarn test:cov từ root booking-api):

• Lines 83.66 % · Statements 82.33 % · Functions 78.32 % · Branches 68.81 %
• 0 % files (top gaps): core/email/{branding,booking-payload,branded-email,recipient}.{resolver,builder,processor}.ts, core/booking/on-{booking,payment}-email.listener.ts, auth-customer/auth-customer.{controller,service}.ts, common/filters/http-exception.filter.ts, core/loyalty/.../prisma-loyalty-redemption.repository.ts.
• Đã đóng: core/email/branding.resolver.ts (0 % → 100 % L · 89 % B · 100 % F) bằng branding.resolver.spec.ts (+21 tests covering tenant-not-found, ConfigService default, salonUrl trailing-slash strip, logo signing, branding fallbacks, address formatting, locale inference). Suite: 1577 → 1596 pass.
• Web: Vitest 4 chưa cấu hình @vitest/coverage-v8 → cần yarn add -D @vitest/coverage-v8 + coverage: { provider: 'v8' } trong vitest.config.ts mới đọc được số. Files mới ship 2026-05-02 (BrandingSection, FocalPointPicker, page.tsx, HomeContent.tsx, InvoiceClient.tsx) đều chưa có spec.

Tổng quan

‡ payment-settings-integration.spec.ts: hit live Bambora sandbox, gate bằng env E2E_BAMBORA_*, mặc định test.skip() ở local.

Lệnh chạy

Chạy từ root của mỗi repo (yarn-only).

# booking-api — Jest
yarn test                     # unit + integration, ~6s
yarn test:e2e                 # e2e against docker-compose DB + Redis
yarn test:cov                 # coverage report

# booking-web — Vitest + Playwright
yarn test                     # vitest (unit/component), ~4s
yarn test:watch               # vitest watch mode
yarn test:e2e                 # playwright, exclude @integration
yarn test:e2e:integration     # playwright, chỉ @integration (cần live PSP)
yarn test:e2e:ui              # playwright UI mode

booking-api — Jest

Unit + integration (yarn test)

Coverage chia theo bounded context / module. Số đếm dưới đây gom từ *.spec.ts thực tế trong src/**.

End-to-end (yarn test:e2e)

Boot Nest app trên Postgres + Redis sạch từ docker-compose.yml, seed fixtures per spec, assert HTTP responses.

booking-web — Vitest

Unit + component test chạy với jsdom + @testing-library/react. Colocated src/**/*.test.{ts,tsx}.

booking-web — Playwright

Headless Chromium mặc định (playwright.config.ts). Serial execution (workers: 1, fullyParallel: false) vì nhiều test PATCH shared studio-nordic tenant; finally block restore.

ownerApi / staffApi fixtures worker-scoped; loggedInPage / loggedInAsStaffPage load pre-saved storageState (login 1 lần per worker per role) — tránh trip 10-req/min login rate-limiter.

Smoke (admin)

Regression — Public booking (public-booking.spec.ts)

13 tests, chia 4 tranches (P1-3 đã thêm 2 case DateStrip clamp).

Tranche 0 — DateStrip clamp maxBookingDaysInAdvance

Tranche 1 — Service & staff selection

Tranche 2 — Settings enforcement

Tranche 3 — Validation & error states

Tranche 4 — Book again

data-testid catalogue

booking-mobile

Chưa có automated tests. Khi mobile scaffold start (sau Role-audit Phase 5), section này sẽ mirror layout của web.

Conventions

• TDD bắt buộc — viết failing test trước, rồi implement. Xem development-rules.md.
• E2E luôn restore settings trong finally block — studio-nordic tenant share giữa specs, serial execution depend trên known state.
• Worker-scoped fixtures cho auth — tránh rate-limiter false positive khi run > 5 tests / worker.
• Scope dropdown locators tới SearchSelect wrapper (qua data-testid) — dropdown render fixed-position <div> trong component root, page.locator('li') không scope sẽ leak sang lists khác.
• Playwright tạo bookings thật trên studio-nordic — intentional để dev spot-check trong admin sau run. Để discoverable marker trong customerName / notes (e.g. E2E Happy Path, E2E rebook seed <ts>).

Known Gaps (target tranche tiếp)

• Auth flows: chưa Playwright cover customer login / Google OAuth, admin login form, forgot-password round-trip.
• Admin calendar: drag-and-drop, conflict warning, booking drawer — vẫn manual-test only.
• Loyalty: unit coverage tốt nhưng chưa E2E redeem-on-checkout flow.
• Customer portal: booking list pagination + "my bookings" cancel flow chưa có E2E.
• Settings: chỉ Payments tab có E2E touch.
• Mobile: zero automated tests (xem trên).
• Status-matrix P1-4 retry: 26 unit tests cover backend path, FE chưa có Playwright assert UI hiển thị "Retry payment" button.

Track trong features.md ở mỗi module tương ứng.