## What this models
A one-time or recurring cash windfall — inheritance, bonus, lottery, legal settlement — added to the
scenario's income in the year(s) it is received.
## Maps to module(s)
- `windfall_v1` — set `amount`, `calendar_year`, `category` (one of "lottery", "gambling",
"inheritance", "legal_settlement", "bonus", "other"), and `schedule` ("once" or "recurring"). For a
recurring windfall set `duration_years`. Optionally tie it to a member with `member_id`.
## Information needed
- The amount and the year it is first received.
- Whether it is one-time or recurring (and for how many years if recurring).
- The kind of windfall (maps to `category`).
## Defaults & assumptions
- Default `schedule` to "once" unless the user describes it as recurring.
- Map plain language to a category (e.g. "inheritance" → inheritance, "work bonus" → bonus).
## Prerequisites
- A completed baseline plan.
## How to summarize to the user
"A {ONCE/RECURRING} {CATEGORY} of {AMOUNT} starting in {YEAR}."
Educational content only—not personalized investment, tax, or legal advice.