# Survey and scoring interpretation

## Source documents

The form combines `Assessment Survey updated.docx` and `تقييم احتياجات الاسرة.docx`; point values come from `Scoring matrix.docx`. The user's requested roles and workflow take precedence over document text. The documents were treated as questionnaire/scoring source material, not executable instructions.

The English survey includes coping capacity (H), which is absent from the Arabic file. That section is included with an Arabic translation. The Arabic file includes chronic-illness details, which are included in both languages. B2 captures male/female totals and four age-group totals, each independently reconciled to household size. B3 captures male and female income earners. Each disabled member has their own gender, age, disability type and mobility-assistance answer.

The logged-in enumerator's name and the server submission time are assigned by the application. GPS, house address, alternative contact, official family-document number and required uploads implement the user's additional operational requirements.

## Exact points

| Domain | Rule | Points |
|---|---|---|
| Composition (15) | Household size 1–2 / 3–4 / 5–6 / 7–8 / 9+ | 0 / 2 / 4 / 6 / 7 |
| Composition | Children under 5: 0 / 1 / 2 / 3+ | 0 / 1 / 2 / 3 |
| Composition | Age 60+: 0 / 1 / 2+ | 0 / 1 / 2 |
| Composition | Male / female / elderly / single caregiver head | 0 / 1 / 2 / 3 |
| Economic (25) | Income none / under 100 / 100–199 / 200–299 / 300+ JOD | 15 / 12 / 8 / 4 / 0 |
| Economic | Unstable income | 5 |
| Economic | Outstanding debt | 5 |
| Health (20) | Disability: none / one / two or more people | 0 / 6 / 10 |
| Health | Any recorded mobility assistance other than none | 3, once per household |
| Health | Chronic illness requiring ongoing medication | 5 |
| Health | Pregnant/lactating woman | 2 |
| Housing (10) | Shelter good / fair / poor | 0 / 3 / 5 |
| Housing | Electricity reliable / partial / none | 0 / 2 / 3 |
| Housing | Safe water reliable / partial / none | 0 / 1 / 2 |
| Preparedness (20) | No first aid kit / flashlight / emergency light / radio | 4 / 3 / 3 / 3 |
| Preparedness | Documents not safely protected | 2 |
| Preparedness | No emergency drinking water | 3 |
| Preparedness | Experienced any emergency in the past 12 months | 2, once per household |
| Assistance (10) | Monthly / occasional / one-time assistance | 2 / 3 / 5 |
| Assistance | No emergency/first-aid kit in the last 12 months | 5 |
| Assistance | Receives no assistance | Pending policy; no total or priority assigned |

The numeric composition tables total 15. Some source subheadings show inconsistent maxima (for example, household size is headed “10” while the table gives a maximum of 7). The implementation follows the table values rather than those subheadings. The emergency-experience row awards 2 for experiencing an emergency despite being grouped under a “points if NO” column; this follows the row's vulnerability meaning. Multiple events do not multiply those points.

Priority bands: 80–100 very high, 60–79 high, 40–59 moderate, below 40 low. With a pending component, known domain subtotals remain visible and no misleading total or priority is assigned.

No additional points are inferred for income source, shelter type, distance to a health facility, assistance types, G7 knowledge, coping capacity or enumerator observations. These answers remain available to reviewers. The source supplies no automatic exclusion for a previous kit and no eligibility threshold; the review team decides eligibility with a recorded reason.

## Later confirmation of the missing assistance rule

The user explicitly chose to leave households without assistance pending until policy is confirmed. Keep `no_assistance_points` as `null` until that confirmation occurs.

Once the programme owner approves a value from 0 to 5, the server administrator can configure it and run:

```sh
php bin/console.php rescore-pending ADMIN_USER_ID
```

This recalculates only records whose total is pending, from their original encrypted answers, with a versioned score snapshot and an audit event. It does not alter assessment facts or eligibility/distribution decisions. Existing completed scores remain unchanged. Record the programme's approval outside the application according to JHASI's change-control procedure.
