pos-system/tests/load/k6/README.md

GoodGo Platform — k6 Load Tests

EN: Load and performance tests for critical API paths. VI: Load và performance tests cho các API path quan trọng.

Prerequisites

brew install k6        # macOS
# or
choco install k6       # Windows
# or
sudo apt install k6    # Ubuntu/Debian

Test Scripts

Script	Target	Thresholds
order-creation.js	POST /api/v1/orders	p95 < 500ms, errors < 1%
catalog-listing.js	GET /api/v1/products	p95 < 200ms, errors < 0.5%
ads-tracking.js	POST /api/v1/tracking/events	p95 < 100ms, errors < 0.1%
signalr-connections.js	WS /hubs/pos + negotiate	p95 < 300ms, errors < 1%

Running Tests

# EN: Run against local environment / VI: Chạy với môi trường local
k6 run tests/load/k6/order-creation.js

# EN: Run against staging / VI: Chạy với staging
k6 run \
  --env BASE_URL=http://api.staging.goodgo.vn \
  --env JWT_TOKEN=<your-token> \
  --env SHOP_ID=<your-shop-id> \
  tests/load/k6/order-creation.js

# EN: Run with output to InfluxDB for Grafana / VI: Xuất kết quả ra InfluxDB cho Grafana
k6 run \
  --out influxdb=http://localhost:8086/k6 \
  tests/load/k6/order-creation.js

# EN: Run with HTML report / VI: Chạy với báo cáo HTML
k6 run \
  --out json=results/order-creation.json \
  tests/load/k6/order-creation.js

Environment Variables

Variable	Default	Description
BASE_URL	http://localhost:5010	API base URL
WS_URL	ws://localhost:5010	WebSocket base URL (SignalR)
JWT_TOKEN	test-bearer-token	Bearer token for auth
SHOP_ID	00000000-...01	Shop UUID for tenant isolation
PRODUCT_ID	00000000-...02	Sample product UUID
TRACKING_API_KEY	test-tracking-key	Ads tracking API key

CI Integration

Add to .github/workflows/ci-performance.yml:

- name: Run k6 load tests (smoke only in CI)
  run: |
    k6 run \
      --vus 5 --duration 30s \
      --env BASE_URL=${{ secrets.STAGING_API_URL }} \
      --env JWT_TOKEN=${{ secrets.STAGING_JWT_TOKEN }} \
      tests/load/k6/order-creation.js