Practitioner playbookPublic-sector delivery

Make go-live an evidence decision, not a calendar event.

User acceptance testing is where requirements, real workflows, accessibility, security, migration, integrations, training, support, continuity, and vendor promises either become usable evidence—or become production defects. This guide gives public-sector teams a disciplined way to plan UAT and decide whether a system is actually ready to launch.

Before testing

Define what UAT can accept—and what it cannot waive.

UAT should answer whether the delivered system supports the organization’s actual work under the conditions that matter. It should not become a late-stage substitute for requirements, security engineering, accessibility conformance, data reconciliation, or disaster recovery.

Create a short UAT charter before testing begins. Identify scope, environments, test data, participant roles, entry criteria, acceptance criteria, defect severity rules, retest expectations, decision authority, and the evidence required for sign-off. Separate business acceptance from technical release approval so one signature does not silently represent every discipline.

Entry criteria

  • Agreed build/version deployed to the UAT environment.
  • Critical integrations available or explicitly simulated.
  • Representative roles and permissions configured.
  • Test data loaded and privacy handling defined.
  • Known defects documented.
  • Security, accessibility, and migration evidence available enough for testing.

Acceptance boundaries

  • Define which defects block release.
  • Define who may accept residual risk.
  • Define whether temporary workarounds are allowed.
  • Define required evidence for closed defects.
  • Keep regulatory, security, privacy, accessibility, records, and continuity exceptions visible outside a generic pass/fail percentage.
Representative workflows

Test complete jobs, not isolated buttons.

A screen can work while the service fails. Build scenarios around what a real user is trying to accomplish and the dependencies that must cooperate.

Happy path

Verify the expected end-to-end workflow with realistic roles, data, approvals, records, notifications, exports, and integrations.

Exception path

Test missing data, duplicates, invalid formats, denied permissions, failed integrations, timeout behavior, rejected approvals, and interrupted work.

Recovery path

Test what users do after failure: resume, reconcile, retry safely, restore state, identify incomplete work, and avoid double-processing.

Write each case so another tester can reproduce the decision

Capture objective, preconditions, user role, steps, expected result, observed result, evidence, defect link, tester, date, and final disposition. Where the workflow changes records or money, include reconciliation evidence rather than relying on the UI message that says “success.”

Accessibility acceptance

Do not treat a vendor ACR or automated scan as the end of accessibility testing.

Section508.gov’s ICT Testing Baseline Portfolio describes standardized test components for evaluating Section 508 conformance and notes that the baseline is tool-agnostic. Federal procurement guidance also emphasizes validating contractor compliance after award and re-testing when products or software change.

For public-facing or employee-facing digital systems, include keyboard operation, focus order, visible focus, names and labels, error identification, forms, tables, modal behavior, zoom/reflow, color dependence, document outputs, and representative screen-reader workflows where applicable. Test the tasks users must actually complete, not only isolated pages.

Use the Accessibility Procurement Checklist to connect vendor claims, accessibility evidence, testing, remediation, and acceptance.

Security readiness

Verify the configured production behavior, not only the vendor’s program.

NIST’s SSDF provides secure-development practices for software producers, while CISA’s Secure by Demand guidance helps buyers ask for security outcomes. UAT should confirm the buyer-side configuration and operational controls that matter at launch.

Identity and authorization

  • Role boundaries and least privilege.
  • Administrative access and MFA behavior.
  • Disabled, expired, or terminated account handling.
  • Cross-role and cross-tenant access checks.
  • Session and authentication failure behavior.

Operational security

  • Audit events are generated for consequential actions.
  • Logs identify actor, action, object, result, and useful time context.
  • Security-relevant alerts reach the right owner.
  • Secrets and credentials are not exposed in UI, logs, exports, or client-side artifacts.
  • Known high-risk findings have an explicit disposition before release.

Do not ask ordinary business UAT participants to perform penetration testing. Instead, make security assessment evidence a release input and use focused UAT checks to confirm the configured controls that users and administrators can observe.

Data and migration

Reconcile meaning, not only record counts.

A migration can copy the expected number of rows and still fail operationally. Validate identifiers, relationships, attachments, metadata, timestamps, status values, permissions, retention flags, searchable fields, historical context, and reports that depend on transformed data.

Build a reconciliation set before cutover. Include known edge cases and records important enough to inspect manually. Define acceptable variance and who can approve it. If legacy and new systems must coexist, test the synchronization or handoff rules and define the source of truth during transition.

The Public-Sector Software Migration Readiness checklist expands this into data, file, relationship, access, integration, cutover, rollback, and recovery checks.

Cutover rehearsal

Practice the launch sequence before production makes every dependency real.

A production cutover is a coordinated operational event, not merely a deployment command. Rehearse the sequence with the same roles that will participate in the actual launch: business owner, technical lead, vendor, identity administrator, integration owner, service desk, communications owner, data or migration lead, and the person authorized to stop or roll back the release. The rehearsal should expose unclear handoffs, missing credentials, unavailable approvers, unrealistic timing, and dependencies that UAT did not reveal.

Write the cutover runbook around decisions as well as actions. Each major step should identify the expected evidence, the time or condition at which the team proceeds, the condition that requires escalation, and the point beyond which rollback becomes more complex. For a migration-heavy release, include reconciliation checkpoints before users are allowed to create new production records. For integrated services, include explicit confirmation that upstream and downstream systems are processing the new traffic correctly.

Define rollback before launch begins. A useful rollback criterion is observable and tied to impact: unresolved data corruption, authentication failure for a critical user population, duplicate financial or case transactions, inability to complete a mission-essential workflow, failed migration reconciliation beyond the accepted threshold, or an integration failure that creates unsafe manual work. “We will decide if it looks bad” is not a rollback plan because it forces the highest-pressure decision to be invented during the incident.

Plan the first production hours as part of readiness. Establish heightened monitoring, named support coverage, vendor escalation contacts, a defect triage channel, rapid access to logs and audit events, and a cadence for reviewing user-impact signals. Capture production findings against the exact release version and feed them back into future UAT cases. A strong launch process does not assume testing eliminated defects; it assumes the organization can detect, contain, explain, and recover from the defects that remain.

Production gate

Require evidence across the whole service before authorizing launch.

Go-live evidence

  • Business UAT acceptance.
  • Open-defect review and risk acceptance.
  • Security assessment disposition.
  • Accessibility acceptance and remediation plan.
  • Migration reconciliation.
  • Integration validation.
  • Support and escalation coverage.
  • Monitoring and alert ownership.
  • Training and user communications.
  • Backup/recovery and rollback readiness.

No-go triggers

  • Unknown data integrity or migration discrepancy.
  • Unresolved unauthorized-access path.
  • Critical workflow cannot be completed reliably.
  • Material accessibility barrier without an accepted plan and authority.
  • No credible rollback or recovery path for a high-impact release.
  • Required external dependency is not production-ready.
  • Support ownership or emergency escalation is undefined.

NIST SP 800-34 Rev. 1 remains useful for contingency-planning fundamentals: recovery requirements should connect to business impact and the system lifecycle. Even when a modern cloud service changes the technical recovery mechanism, the organization still needs to know what it will do if the launch fails.

Decision record

Preserve why the organization believed the system was ready.

The release record should identify the production version, approval date, decision authority, completed evidence, unresolved defects, accepted risks, migration reconciliation, rollback criteria, heightened monitoring period, and owners for post-launch issues. This creates a useful baseline for audit, vendor management, later upgrades, incident response, and lessons learned.

After launch, review actual defects and support demand against UAT results. If an issue reached production because the scenario was never tested, add that class of failure to future acceptance packs. If it was tested but accepted, revisit the severity and decision rule. The goal is a testing system that gets better with each release.

Put this guide to work

Turn Government Software UAT & Production Readiness Guide | Zeph Tech into a decision-ready next step.

Use the source-backed research to pressure-test assumptions, then build a reusable evaluation brief before you compare products, scope implementation, or request a fit review.