Skip to main content

​
Onboarding Run Filter UX - Deploy Proof

Feature: Org dropdown, Run dropdown, runOnly toggle, wizard deep-link Merge SHA (main): 46dd248b66539e2eca642d8a8f3f6fe810034f07 Commits merged:
  • 4386d70 feat(onboarding): add runs endpoint + runOnly batch filtering
  • de88d6e feat(onboarding-ui): org+run selectors and runOnly filter with wizard deep link
Expected SHAs for deploy verification:
  • BACKEND_SHA: 4386d70 (or merge SHA — both touch api/)
  • FRONTEND_SHA: 46dd248 (merge SHA touches dashboard/)

​
Step 5 — Deployment Status (fill after CI completes)

​
Backend (GitHub Actions WIF)

Because api/** changed, both Cloud Run services must deploy:
ServiceWorkflow Run IDCloud Run RevisionDeployed GIT_COMMIT_SHA
payroll-backend-prod(check Actions)
payroll-pipeline-cbs-api(check Actions)
Verification: Run .\scripts\verify_owner_rollup_post_merge_qa.ps1 (or equivalent). Both services should report git_commit_sha matching merge SHA.

​
Frontend (Vercel)

Deployment IDCommit SHAStatus
(check Vercel Deployments)46dd248

​
Step 6 — Production Smoke Test

After deploys complete:
  1. Onboarding page: /admin/onboarding/businesses?periodLabel=2025-12-01&orgId=cbs-main
    • Org dropdown visible and selectable
    • Run dropdown loads runs
    • “Show only businesses in this run” toggle exists
    • Selecting run + enabling runOnly restricts list to run cohort
    • Search works within runOnly
    • Pagination behaves (runOnly ≤500 fetch-all; >500 paginated)
  2. Wizard deep-link: From wizard “Configure Businesses”
    • Opens onboarding with batchId, runOnly=1, source=wizard
    • Optional search prefilled from first blocker
  3. No regressions:
    • Pagination works when runOnly off
    • /api/v1/admin/onboarding/runs returns 200
    • List endpoint with run_only + batch_id returns 200

​
Stop Conditions

Stop if:
  • Backend SHAs don’t match expected commit
  • Vercel deployed wrong commit
  • Org/Run UI missing after hard refresh
  • runOnly returns tenant-wide list (invariant violation)
  • 4xx/5xx on runs or list endpoint
Proof doc created: merge pushed to main. Deploy verification and smoke test pending.