# Nur Falah — Estate & Waqf Suite

Horizon 1 (Prevention Suite) + Horizon 2 (Unlock Programme, pre-pilot demo) from the
Nur Falah PRDs, built as a standalone Svelte 5 + Vite PWA, styled to match the visual
system of the live `moslem03.falahos.my` (Nur Falah Muslim Companion) app.

## Modules

| Module | Horizon | Status |
|---|---|---|
| Faraid Calculator | 1 | Shared calc core, 14 classical cases passing (`src/lib/calc/faraid.test.js`) |
| Asset Registry | 1 | Local-first, feeds every other module's estate total |
| Wassiyah Generator | 1 | 1/3 meter, heir-exclusion block, jurisdiction-aware export |
| Hibah Tracker | 1 | Shared marad al-mawt guardrail |
| Family Waqf Designator | 1 | **Built ahead of scholarly sign-off** — see below |
| Digital Beneficial Claims | 2 | **Pre-pilot demo only** — see below |

## Important: two governance gates were overridden for this build

Per explicit product direction, this build proceeded past two gates stated in the
project's own PRDs and review log:

1. **Family Waqf Designator** (Horizon 1 PRD §8.5) is gated on scholarly sign-off.
   `scholarly-review-log.md` (in the `digital-waqif` docs repo) tracks **OPEN-01** —
   whether a healthy-state waqf is subject to the one-third cap — as unresolved.
   This module ships anyway; the in-app copy states the open question rather than
   presenting invented certainty.
2. **Horizon 2** (Digital Beneficial Claims) PRD states: *"No engineering work begins
   until Phase 0 (legal opinion + signed institutional partner agreement) is
   complete."* No confirmation of Phase 0 completion was available. The Claims module
   ships as a local, non-custodial demonstration of the data model and transfer
   restriction only — no real legal wrapper, no institutional integration, no real
   claims issued. It carries a persistent in-app banner saying so.

Both are flagged here, in `deploy/DEPLOY.md`, and in the relevant module's source
comments so this isn't silently presented as production-ready.

## Development

```bash
npm install
npm run dev       # http://localhost:5173
npm run test      # classical faraid test suite
npm run build
```

## Deploy

See `deploy/DEPLOY.md`. Target: `moslem04.falahos.my`.