call-center/docs/uat/README.md

UAT Pilot Package

This folder contains the operational UAT package for Stage 4 pilot acceptance.

Scope Control

• The frozen MVP pilot scope is defined in docs/gates/mvp-pilot-baseline.md.
• Out-of-scope requests must be redirected to docs/roadmap/05-wave2-backlog.md.
• During pilot close-out, only P1 and P2 defects are remediated in MVP.

Workflow

1. Run preflight before participants join:
   • Existing environment: python scripts/uat_preflight.py --base-url http://<gateway-host>:8080
   • Local auto-start: python scripts/uat_preflight.py --auto-start
2. Run automated dry-run and generate UAT package:
   • Existing environment: python scripts/uat_dry_run.py --base-url http://<gateway-host>:8080 --update-defect-register
   • Local auto-start: python scripts/uat_dry_run.py --auto-start --update-defect-register
3. Create/adjust a session protocol from template (or from generated dry-run package):
   • docs/uat/session-template.md
   • Or prepare a full manual bundle:
     • python scripts/uat_manual_prepare.py --environment-url http://<pilot-gateway>:8080
4. Execute all scenarios:
   • docs/uat/scenario-checklist.md
5. Register all defects:
   • docs/uat/defect-log-template.csv
6. Capture sign-off:
   • docs/uat/signoff-template.md
7. Attach preflight report from:
   • docs/uat/evidence/
8. After signatures and zero open P1/P2, close Gate 4:
   • Optional validation only:
     • python scripts/finalize_mvp_pilot.py --session-dir docs/uat/evidence/manual_<session-id> --dry-run
   • python scripts/finalize_mvp_pilot.py --session-dir docs/uat/evidence/manual_<session-id>

Triage Rules

• P1: pilot acceptance is impossible
• P2: key MVP user journey is broken
• P3: acceptable with limitation, defer unless it blocks sign-off
• P4: cosmetic or low-priority backlog item

P3 and P4 findings should be logged and moved to post-MVP backlog instead of stretching the MVP remediation cycle.

Mandatory Evidence Bundle

• preflight report
• completed session protocol
• completed scenario checklist
• filled defect log
• signed sign-off sheet
• updated docs/gates/p1-p2-defects.md

Exit Criteria

• All mandatory scenarios executed
• No open P1/P2 defects
• Signed protocol by business and IT owners