# QA360 Examples

This directory contains example pack files for different testing scenarios.

## Quick Start

Copy an example to your project:

```bash
# Copy API basic example
cp examples/api-basic.yml qa360.yml

# Edit and customize
vim qa360.yml

# Run tests
qa360 run
```

## Available Examples

### 1. **api-basic.yml** - API Smoke Tests
Simple REST/GraphQL health checks.

**Gates**: `api_smoke`

**Use case**: Verify API endpoints are responding correctly

```bash
qa360 run examples/api-basic.yml
```

---

### 2. **ui-basic.yml** - UI/E2E Tests
Basic browser automation tests.

**Gates**: `ui`

**Use case**: Test web pages load correctly

```bash
qa360 run examples/ui-basic.yml
```

---

### 2b. **ui-advanced.yml** - UI Tests with Playwright++
Advanced UI testing with artifacts, video, screenshots, and HTML reports.

**Gates**: `ui`

**Features**:
- Automatic screenshots on failure
- Video recording
- Trace capture for debugging
- Interactive HTML report generation
- Configurable bail on failures

**Use case**: Full-featured UI testing with rich artifacts

```bash
qa360 run examples/ui-advanced.yml
```

---

### 2c. **crawler.yml** - Web Crawler
Auto-generate tests by crawling a web application.

**Gates**: `ui`

**Features**:
- Automatic discovery of pages and forms
- Generate test packs from existing sites
- Smart selector generation

**Use case**: Quick start with existing applications

```bash
qa360 run examples/crawler.yml
```

---

### 3. **fullstack.yml** - Full Stack Tests
API + UI + Performance testing.

**Gates**: `api_smoke`, `ui`, `perf`

**Use case**: Complete application testing with Docker Compose integration

```bash
qa360 run examples/fullstack.yml
```

---

### 4. **security.yml** - Security Suite
Comprehensive security scanning.

**Gates**: `sast`, `dast`, `secrets`, `deps`

**Use case**: Security audit with vulnerability scanning

```bash
qa360 run examples/security.yml
```

---

### 5. **accessibility.yml** - Accessibility Tests
WCAG compliance testing.

**Gates**: `ui`, `a11y`

**Use case**: Ensure website meets accessibility standards

```bash
qa360 run examples/accessibility.yml
```

---

### 6. **complete.yml** - Complete Test Suite
All quality gates enabled.

**Gates**: All (8 gates)

**Use case**: Comprehensive quality assurance for production-ready applications

```bash
qa360 run examples/complete.yml
```

---

## Interactive Generator

Generate a custom pack with:

```bash
qa360 init
```

This will walk you through creating a pack file tailored to your needs.

## Customization

All examples use placeholder URLs. Replace with your actual endpoints:

- `https://api.example.com` → Your API URL
- `https://example.com` → Your web application URL
- `http://localhost:3000` → Your local dev server

## Learn More

- [Pack Schema Documentation](https://github.com/xyqotech/qa360/blob/main/docs/pack-schema.md)
- [Quality Gates Reference](https://github.com/xyqotech/qa360/blob/main/docs/gates.md)
- [Full Documentation](https://github.com/xyqotech/qa360/blob/main/docs/README.md)