# Readiness evidence summary

## What it does

`ReadinessSummary.vue` gives Funnel Journey and Sales Projects the same compact
seven-area evidence control. Selecting an icon opens its source facts in the shared
Modal, including the requirement still to establish. It works with keyboard and
touch as well as pointer input.

## How it works

- `records` is the server's readiness projection: each area has `state`, `why`
  and `facts`. The component does not calculate readiness or substitute the
  Overall AI verdict. A missing projection is shown as unavailable.
- `states` and `rules` carry server-owned names, colors and evidence requirements.
  Area order and icons reuse `utils/readinessEvidence.js`.
- `context` identifies whether this is Stage 1 or a specific purchase. Sales
  Projects supplies the **engagement row's** project-scoped `readiness_records`;
  borrowing the lead's global record would let another purchase's loan or unit
  falsely complete this one.
- `name` identifies the customer in the modal; `leadUuid` supplies the existing
  customer Journey link. All internal destinations preserve the resolved suite.
- Journey's gap counts and `jreadiness` filtering remain server-owned. They apply
  to the current node and attendance cohort before pagination; one customer's
  gaps may appear in multiple areas. Switching nodes clears the gap filter,
  while refresh and pagination retain it.
- Financial preparation stays in the existing shared FPA progress cells. Payment
  is a branch of Stage 1 and the Stage 3 handoff in Stage 2, never proof that all
  readiness areas are complete.

## Reference usage

`FunnelJourneyWorkspace.vue` passes `board.readiness.states` / `rules` and each
roster row's `readiness_records`. `EngagementTable.vue` passes the same metadata
from `leadColumnProps`, while taking records from the engagement row. The table's
In Progress preset shows Readiness / Next action, Total includes it in Progress /
Outcome, and expanded rows keep it available in other layouts.

## Related files

- `resources/js/Components/Leads/ReadinessSummary.vue` and its component test.
- `resources/js/Pages/Manage/Events/Funnels/Partials/Tabs/FunnelJourneyWorkspace.vue`
  and its selection/filter regression test.
- `resources/js/Components/Sales/EngagementTable.vue` and its component test.
- `resources/js/utils/{readinessEvidence,engagementColumnPresets}.js`.
- [Funnel Journey](/docs/modules_handbook/manage/leads/funnel-journey/readMe.md).
- [Sales Projects](/docs/modules_handbook/manage/engagement/sales-projects.md).
- [Lead readiness verdict](/docs/modules_handbook/manage/leads/readiness-verdict.md).
