RFP Lab — Variation Study

RFP review cockpit

One complete DRMG Sales workflow, compared three ways through the reusable VariationWorkbench: queue-first, evidence-first, and comparison-first. The lab uses local serializable data only.

Disposition is explicit. Shared lab chrome lives in ui-interactive; RFP-specific variant bodies stay in app-client-rfp.

§01

Cockpit variants

The lab is interactive, but remains disconnected from real RFP data. URL state carries the selected variant and item so screenshots and reviews are reproducible.

Loading cockpit lab.

§02

Why this pattern is ready

Readiness is computed from checked-in receipts rather than assigned as a catalogue label. The record connects lab fixtures to reusable owners and the real production data path.

Evidence-derived readiness

Review queued RFP answers, inspect evidence, and make an SME judgement without losing throughput.

Target user: SME reviewers working through generated procurement answers.

Promotion candidateverified 2026-07-14

Deterministic scenarios

  • libs/app-client/app-client-rfp/src/lib/review-cockpit-lab/rfp-review-cockpit-lab.data.ts
  • libs/testing/data-fixtures/src/lib/rfp-fixtures

Reusable owners

  • ReviewQueue

    @stackmates/ui-interactive/blocks · docs/design-system/contracts/rfp-review-cockpit.md

  • RfpReviewCockpitWorkspace

    @stackmates/app-client-rfp · docs/design-system/contracts/rfp-review-cockpit.md

Variant disposition

  • Queue-first

    promote

    Fixed: Serializable RFP review props · Semantic judgement actions · Queue, evidence, and criterion access

    Varied: Queue-led layout · Progressive detail density

    States: ready · loading · empty · error · permission denied · disabled

    Falsifier: Evidence inspection becomes the primary repeated job and queue triage no longer drives reviewer throughput.

  • Evidence-first

    revise

    Fixed: Serializable RFP review props · Semantic judgement actions · Queue, evidence, and criterion access

    Varied: Evidence-led hierarchy · Trust-first density

    States: ready · source inspection

    Falsifier: A production journey proves evidence inspection is the dominant workflow rather than a supporting review step.

  • Comparison-first

    lab-only

    Fixed: Serializable RFP review props · Semantic judgement actions · Queue, evidence, and criterion access

    Varied: Matrix-led layout · Exception-review density

    States: ready · procurement exception

    Falsifier: A repeated exception-review journey creates production pull for comparison as the default surface.

Quality proof

  • accessibility

    pass

    The reusable queue and cockpit proofs cover labelled controls, semantic states, keyboard-reachable actions, and disabled behavior.

    • libs/app-client/app-client-rfp/src/lib/review-cockpit/RfpReviewCockpit.spec.tsx
    • docs/design-system/contracts/rfp-review-cockpit.md#keyboard-and-accessibility
  • responsive

    pass

    The cockpit contract stacks queue, answer, evidence, and comparison on mobile and progressively splits detail at wider containers.

    • docs/design-system/contracts/rfp-review-cockpit.md#responsive-behavior
    • libs/app-client/app-client-rfp/src/lib/review-cockpit/RfpReviewCockpit.spec.tsx
  • interaction

    pass

    Workspace tests cover queue selection and controlled composition while the production route binds real queue data.

    • libs/app-client/app-client-rfp/src/lib/review-cockpit/RfpReviewCockpitWorkspace.spec.tsx
    • apps/dreamineering/drmg-sales/src/app/(app)/[orgSlug]/rfp/page.spec.tsx
  • performance

    not-applicable

    The first promotion decision has no large-collection or latency budget; queue scale remains caller-owned and creates a future falsifier.

    • libs/app-client/app-client-rfp/src/lib/review-cockpit/DESIGN.md

Production flow

Consumer
apps/dreamineering/drmg-sales/src/app/(app)/[orgSlug]/rfp/page.tsx
Producer
libs/app-server/app-server/src/actions/approved-answers.actions.ts#getSMEReviewQueueAction
Application
libs/application/src/lib/use-cases/sales__rfp/approved-answer-operations.use-case.ts#getSMEReviewQueue
Port
IPriorityAnswersRepository
Repository
PriorityAnswersDrizzleRepository
Scope
end-to-end

Fixture → model findings

  • objectiveScore | confidenceScoredomain-truth

    Review eligibility is derived from persisted answer confidence and objective scoring. Owner: PriorityAnswers.

  • queueItems | queueSummary | queueFiltersapplication-projection

    The production route maps approved-answer results into the serializable cockpit projection. Owner: DRMG Sales RFP route mapper.

  • selectedId | activeFilterpresentation-state

    Selection and filtering remain caller-owned workspace state and require no persistence. Owner: RfpReviewCockpitWorkspace.

  • comparisonRowsfixture-only

    The comparison matrix remains lab evidence until an exception-review producer and repository flow exist. Owner: RFP cockpit variation lab.

Readiness

Complete quality receipts and an end-to-end production pull support promotion review.

No blockers.

Next evidence

Apply the same evidence contract to the Data Tables study and its CRM production pull before promoting shared readiness automation.