mirror of
https://github.com/opensourcepos/opensourcepos.git
synced 2026-06-02 04:40:17 -04:00
3c5f4c1465
- Add basic Docker integration tests (run-integration-tests.sh) - Validates Docker stack startup - Checks login page accessibility and HTTP status - Verifies login form presence - Add Playwright E2E test suite - Login tests: valid/invalid credentials, protected pages - Items tests: create, update, verify in inventory table - Customers tests: create with details, search, table verification - Sales tests: full sale flow with items, customers, payment, and receipt validation - Configure Playwright with multi-browser support (Chrome, Firefox) - Add GitHub Actions workflow for CI/CD - Runs on push/PR to master - Includes both basic and Playwright tests - Uploads screenshots, traces, and logs on failure - Organize tests in integration-tests/ directory - Update package.json with test scripts - Include comprehensive documentation This provides automated testing for core POS workflows including item management, customer management, and complete sales transactions with receipt generation verification.
Integration Tests for Open Source POS
This directory contains integration tests for Open Source POS using Docker Compose and Playwright.
Test Suites
1. Basic Integration Tests (run-integration-tests.sh)
Simple HTTP-based tests that verify the application is running and accessible.
Tests:
- Application startup
- Login page accessibility
- HTTP status code validation
- Login form presence
- Database connectivity (indirect)
2. Playwright E2E Tests (tests/)
Full browser automation tests using Playwright.
Login Tests (tests/login.spec.ts)
- Display login page
- Login with valid credentials
- Reject invalid credentials
- Redirect protected pages to login
- Console error detection
Item/Inventory Tests (tests/items.spec.ts)
- Create new item with basic details
- Create item with category selection
- Update existing item
- Verify items appear in inventory table
Customer Tests (tests/customers.spec.ts)
- Create new customer with basic details
- Create customer with complete address information
- Search for existing customers
- Verify customer details in table format
Sales Tests (tests/sales.spec.ts)
- Create sale with item and customer
- Add payment to sale
- Complete sale transaction
- Verify receipt generation
- Multi-item sale scenarios
- Different payment methods (cash)
- Receipt validation and display
Combined Operations
- Create item and customer sequentially
- Verify both entities appear in their respective tables
Prerequisites
- Docker and Docker Compose
- Node.js 18+
- npm
Local Setup
- Install Node.js dependencies:
npm install
- Install Playwright browsers:
npx playwright install --with-deps chromium firefox
Running Tests
Basic Integration Tests
chmod +x run-integration-tests.sh
./run-integration-tests.sh
Playwright Tests
npm test
Run with UI:
npm run test:ui
Run with headed browser:
npm run test:headed
Debug mode:
npm run test:debug
GitHub Actions
The CI pipeline runs both test suites on push/PR to master:
- Integration Job: Basic Docker stack tests
- Playwright Job: Full browser automation tests
Artifacts uploaded on failure:
- Playwright HTML report
- Test screenshots
- Trace files
- Docker container logs
Test Results
- Playwright HTML reports:
playwright-report/ - Test results:
test-results/ - Screenshots (on failure):
test-results/**/*.png - Traces (on failure):
test-results/**/*.zip
Environment Variables
BASE_URL: Application base URL (default: http://localhost)
Clean Up
Stop and clean Docker resources:
docker compose down -v
Note on Local Playwright Setup
Playwright requires system dependencies to be installed. If you don't have sudo access, you can:
- Use CI environment (GitHub Actions)
- Run Playwright tests in Docker container with proper permissions
- Use the basic integration tests instead