PopChoice Docs
Portfolio evidence

Portfolio Evidence Pack

A source-linked PopChoice evidence index for future portfolio work.

PopChoice Portfolio Evidence Pack

This directory is a compact handoff for a future PopChoice case-study update in portfolio-2025. It does not replace canonical product or operations docs.

Status vocabulary

LabelMeaning
Production verifiedObserved on the public production surface on the stated date.
Development verifiedObserved in a controlled run against development code; not production behavior.
Shipped in developmentImplemented and backed by code/tests on development; not automatically claimed as live production behavior.
PlannedDocumented future work or issue-backed direction, not current behavior.
Anecdotal / unverifiedOwner recollection or a plausible historical statement without enough primary evidence.

Evidence index

  • Product flow: current browser path, audience variants, taste controls, result actions, and account boundaries.
  • Recommendation scenario: one reproducible deterministic, memory-aware scenario.
  • Controlled Duo quality: a fixed-candidate compromise protocol with a credit-free validation mode, one recorded rejected live result, and an explicitly manual quality-review boundary.
  • Persisted lifecycle: API, persistence, queue, polling, terminal states, and recovery evidence.
  • Operations: operator surfaces and their shipped/live-verification status.
  • Design evolution: evidence-backed design milestones and unresolved provenance.
  • Portfolio handoff: claim table, screenshot manifest, safe case-study copy, blockers, and next step.

Production snapshot

Production verified — 2026-07-16. /api/build reported PopChoice v0.2.0, channel/environment production, branch main, and commit d5da1cd. /api/health reported PostgreSQL and Redis healthy. The release commit is tagged v0.2.0.

This snapshot verifies deployment provenance and dependency health only. It does not prove recommendation quality, traffic, conversion, latency, reliability, or any protected operator surface.

Screenshot policy

Screenshots in assets/ use the English locale, a 1440 × 900 desktop viewport, reduced/disabled motion, no credentials, and no personal data. Assets 0104 are read-only public production states. Assets 0508 come from the isolated deterministic development harness: the Duo quiz completes through the real browser/API/database path, while progress and failure are controlled persisted states of that same result record. Images are evidence of UI and persistence contracts, not proof of AI quality, recommendation quality, product usage, or a real production incident.

Reproduce the deterministic captures

Run the capture only against the disposable E2E database:

npm run test:e2e:setup
CAPTURE_PORTFOLIO_EVIDENCE=1 npm run test:e2e:run -- --grep "normal duo"
npm run test:e2e:down

The capture branch inside apps/web/e2e/recommendation.spec.ts writes the four development screenshots, then restores the record to completed. The ordinary E2E run does not write evidence assets.

On this page