QA (Quality Assurance)

This section is the public QA catalog for the G3N Retail Stack. It consolidates:

• All tests (contract/CLI/unit/smoke/e2e/workflow/usecase/super usecases),
• All use cases (verbose, headless-only operations catalog),
• All super use cases (SU1/SU2/SU3),
• Test harness outcomes (PASS/FAIL/timeouts/warnings as recorded),
• Grouped playbooks for QA execution and per-service SOPs.

Source of truth

• Test suites: /tests (generated into Tests)
• Super use cases + full use-case catalog: /docs/story/super-usecases.md and /docs/story/operations.md (mirrored here)
• Harness outcomes: /QA.md (mirrored here)

QA harnesses (common commands)

• npm run lint
• npm run build
• npm run smoke
• npm run ci
• CDK_TELEMETRY_OPTOUT=1 AWS_PROFILE=g3nretailstack AWS_REGION=us-east-1 npm run ci:full (full live gate)
• RUN_OFM_WORKFLOWS=1 RUN_PVM_USECASES=1 RUN_PVM_E2E_OPS=1 RUN_USM_SWEEP_E2E=1 RUN_USM_APIKEY_E2E=1 MRS_AWS_SDK_TESTS=1 CDK_TELEMETRY_OPTOUT=1 AWS_PROFILE=g3nretailstack AWS_REGION=us-east-1 npm run ci:full (deep live gate)
• RUN_SUPER_USECASES=1 npm run test:super
• AWS_PROFILE=g3nretailstack AWS_REGION=us-east-1 npm run super:bootstrap

Update discipline

1. Update QA log in /QA.md after any meaningful run.
2. Regenerate QA docs (node scripts/generate-qa-docs.mjs) or run npm run docs:build.
3. Publish docs via BUILD_MAJOR=MONDAY BUILD_MINOR=$(date +%s) AWS_PROFILE=g3nretailstack AWS_REGION=us-east-1 npm run publish:content.

Where to go next

• Use Cases — verbose headless use-case catalog.
• Super Use Cases — SU1/SU2/SU3 scenarios + coverage.
• Tests — full test suite inventory.
• Outcomes — recorded harness outcomes and QA log.
• Playbooks — grouped QA playbooks + per-service SOPs.