# Aphoria User Acceptance Testing

End-to-end validation of Aphoria workflows.

## Quick Start

```bash
# Run the enterprise workflow UAT
./scripts/test-enterprise-workflow.sh
```

## UAT Reports

| Report | Status | Description |
|--------|--------|-------------|
| [Policy Source Tracking](./2026-02-04-uat-real-world-policy-source.md) | PASS | Trust Pack workflow validation |
| [Future Scenarios](./future-scenarios.md) | Planned | Deferred scenarios awaiting enterprise feedback |

## Scripts

| Script | Purpose | Status |
|--------|---------|--------|
| [test-enterprise-workflow.sh](./scripts/test-enterprise-workflow.sh) | Full Trust Pack round-trip test | PASS (12/12) |
| [test-multi-pack-conflict.sh](./scripts/test-multi-pack-conflict.sh) | Multiple packs, same concept | PASS (7/7) |
| [test-pack-version-update.sh](./scripts/test-pack-version-update.sh) | Pack version supersession | PASS (6/6) |

## CI Integration

The UAT is integrated into CI via `.github/workflows/ci.yml`:

```yaml
aphoria-uat:
  name: Aphoria Enterprise UAT
  runs-on: ubuntu-latest
  needs: [check, test]
  steps:
    - name: Build Aphoria
      run: cargo build --release --package aphoria
    - name: Run Enterprise Workflow UAT
      run: ./applications/aphoria/uat/scripts/test-enterprise-workflow.sh
```

## Adding New UAT Scenarios

1. Create `YYYY-MM-DD-uat-{scenario}.md` with test plan
2. Add automated script in `scripts/`
3. Update this README
4. Add to CI workflow if needed

## Structure

```
uat/
├── README.md                                    # This file
├── 2026-02-04-uat-real-world-policy-source.md  # Policy source tracking UAT
├── future-scenarios.md                          # Tested & deferred scenarios
└── scripts/
    ├── test-enterprise-workflow.sh              # Basic Trust Pack workflow
    ├── test-multi-pack-conflict.sh              # Multi-pack behavior
    └── test-pack-version-update.sh              # Version supersession
```