wmj 9767c0d626 docs: add personas and user journey map
Six personas mapped against the app's actual roles and features: Head of
Family (owner), Family Member, Estate Agent/Mutawalli, the multi-family
professional-mutawalli variant, plus two no-account personas reached only
through data others enter — the Heir/Beneficiary (notified by the
notify-heirs email relay once a trigger fires) and the Professional
Reviewer (tracked via the Wassiyah review-request workflow). Each journey
is stage-by-stage through real tabs, not generic template steps.
2026-08-14 12:52:31 +08:00

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

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.

S
Description
Nur Falah Horizon 1 Prevention Suite + Horizon 2 Unlock demo. Deploy target moslem04.falahos.my
Readme 1.1 MiB
Languages
Svelte 51.9%
JavaScript 47.9%
HTML 0.1%