Skip to content

feat(background-check): redesign overview and report to surface real verification methodology#2836

Merged
tofikwest merged 1 commit into
mainfrom
tofik/bg-check-ui-redesign
May 13, 2026
Merged

feat(background-check): redesign overview and report to surface real verification methodology#2836
tofikwest merged 1 commit into
mainfrom
tofik/bg-check-ui-redesign

Conversation

@tofikwest
Copy link
Copy Markdown
Contributor

@tofikwest tofikwest commented May 13, 2026

Summary

The customer perception that our background check is "just LinkedIn scraping" is wrong — but our own UI was making it look that way. This PR rewrites the customer-facing copy and structure of the Employee Background Check overview + completed report to name what we actually do.

What the system actually does (verified against the trycompai/background-check repo):

  • Biometric identity + liveness via AWS Rekognition + ID document OCR
  • HR-confirmed employment — tokenized verification emails to each past employer
  • Structured reference questionnaires with per-reference responses (the source of the partially_verified status)
  • Right-to-work documentation extracted from gov ID
  • AI-augmented public-source research via Firecrawl + LinkdAPI + OpenAI — this is the LinkedIn piece, and it's one of five components, not the product
  • FCRA-style adjudication with candidate review + dispute flow

What changed

NewBackgroundCheckMethodology.tsx
Shared methodology components reused by both wizard overview and report so the copy stays in sync:

  • MethodologyTrustSignals — four trust signal chips (Biometric / Human-verified / FCRA / AI-augmented)
  • MethodologyIncluded — five detailed "What's included" cards with one-line method explanations
  • MethodologyComplianceNote — FCRA adverse-action callout
  • MethodologyReportBanner — compact banner for the top of the completed report

UpdatedBackgroundCheckWizardParts.tsx

  • Replaces 6 generic bullets ("Required for Compliance", "Social media verifications", etc.) with the methodology block
  • New headline: "Background-checked the right way"
  • Tagline: "A serious check, designed for compliance hiring — biometric, human-verified, and FCRA-aligned."

UpdatedBackgroundCheckReport.tsx

  • Adds the methodology banner at the top of every completed report
  • Renames "Social and media research""Public-source research"
  • Each section now shows its verification method as a subtitle (e.g., "HR-confirmed by email per employer")
  • Empty state copy now reads "Awaiting candidate submission for this section." instead of the broken-sounding "Not included in the synced report snapshot."

Updated — tests

  • EmployeeBackgroundCheck.test.tsx and BackgroundCheckStatusView.test.tsx assertions updated to match new copy.

Verification

  • audit-design-system clean — no @trycompai/ui or lucide-react imports, no className on DS components that reject it
  • ✅ Modified tests pass (renders methodology overview…, skips the overview…, status view section labels)
  • ✅ No new typecheck errors in any background-check file
  • ⚠️ Pre-existing failures in EmployeeBackgroundCheck.test.tsx (PointerEvent is not defined from a Switch component) are unrelated — confirmed by stashing my changes and re-running.

…verification methodology

Replaces generic benefit bullets ("Required for Compliance",
"Social media verifications") with a marketing-forward methodology block
that names what we actually do: biometric ID + liveness, HR-confirmed
employment, structured reference questionnaires, AI-augmented
public-source research, and FCRA-style adjudication.

The completed report now opens with a methodology banner and each section
shows its verification method as a subtitle. Renames "Social and media
research" to "Public-source research" so LinkedIn stops reading as the
whole product.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
app Ready Ready Preview, Comment May 13, 2026 10:07pm
comp-framework-editor Ready Ready Preview, Comment May 13, 2026 10:07pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
portal Skipped Skipped May 13, 2026 10:07pm

Request Review

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 5 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

@tofikwest tofikwest merged commit 1f46329 into main May 13, 2026
11 checks passed
@tofikwest tofikwest deleted the tofik/bg-check-ui-redesign branch May 13, 2026 22:08
@claudfuen
Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 3.54.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants