Testing

Verified Last updated: September 2026

AquaDealers has two test layers: unit tests via Vitest and end-to-end tests via Playwright.

Unit Tests (Vitest)

Configuration

Config file: vitest.config.ts
Environment: jsdom
Libraries: @testing-library/react, jest-dom
Run command: npm test

Test Files (11)

File	Coverage Area	Description
`useCheckout.test.ts`	Checkout flow	Tests the full checkout hook: payload building, bill creation, payment allocation, and post-checkout side effects (WhatsApp send, cache invalidation).
`cartStore.test.ts`	Cart state	Tests the Zustand cart store: add/remove items, quantity updates, price calculations, discount application, cart clearing.
`PaymentStep.test.tsx`	Payment UI	Tests the PaymentStep component rendering: payment mode selection, amount input, split payment handling, validation states.
`DuesFarmerRow.test.tsx`	Dues display	Tests the farmer row component in the dues list: amount formatting, ageing bucket display, overdue highlighting.
`financialService.test.ts`	Financial calculations	Tests financial service functions: revenue calculation, expense aggregation, profit computation, balance calculations.
`inventoryService.test.ts`	Inventory queries	Tests inventory service: stock level queries, lot lookups, low stock detection, valuation calculations.
`farmerService.test.ts`	Farmer operations	Tests farmer CRUD: creation, updates, search, balance queries, statement generation.
`reportBuilders.test.ts`	Report generation	Tests report builder functions: data aggregation, CSV formatting, date range filtering, summary calculations.
`dashboardCardUtils.test.ts`	Dashboard metrics	Tests dashboard utility functions: metric formatting, percentage calculations, trend indicators, card data shaping.
`supabase.test.ts`	Client config	Tests Supabase client initialization: URL configuration, key loading, auth persistence settings.
`utils.test.ts`	Utility functions	Tests shared utilities: phone normalization, currency formatting, date helpers, string manipulation.

E2E Tests (Playwright)

Configuration

Config file: playwright.config.ts
Browser: Chromium only
Credentials: Test dealer account via .env.e2e file
Run command: npm run test:e2e

Test Specs (5)

1. billing.spec.ts — Full Bill Creation

End-to-end bill creation flow:

Log in as test dealer
Navigate to New Bill
Select a farmer
Add products to cart
Set quantities and review totals
Choose payment method
Complete checkout
Verify bill appears in bill list

2. farmer-payment.spec.ts — Payment Collection

Payment recording flow:

Log in as test dealer
Navigate to a farmer with outstanding balance
Record a payment (cash or digital)
Verify balance updates
Verify payment appears in farmer ledger

3. stock-purchase.spec.ts — Stock Purchase

Inventory purchase flow:

Log in as test dealer
Navigate to Stock Purchase
Select supplier and products
Enter quantities, prices, and batch details
Complete purchase
Verify stock levels update

4. auth.spec.ts — Authentication Flows

Authentication flow tests:

Redirect unauthenticated users to login
Admin login page rendering

5. screenshot.spec.ts — Login/Register Screenshots

Utility spec that captures screenshots of the login and register pages for visual reference.

Support Files

tests/e2e/auth.setup.ts — Authentication setup (logs in before tests)
tests/e2e/fixtures.ts — Shared test fixtures
tests/e2e/helpers/db.ts — Database helper for test setup/teardown

Running Tests

Commands

# Unit tests (Vitest)
npm test

# Unit tests in watch mode
npm test -- --watch

# E2E tests (Playwright)
npm run test:e2e

# E2E tests with UI mode
npx playwright test --ui

# E2E tests for a specific spec
npx playwright test billing.spec.ts

E2E Prerequisites

Before running E2E tests:

Create a .env.e2e file with test dealer credentials
Ensure the dev server is running (npm run dev)
Install Playwright browsers: npx playwright install chromium
The test dealer account must have existing data (farmers, products, stock) for the tests to pass