Initial build: Horizon 1 Prevention Suite + Horizon 2 Unlock demo

Svelte 5 + Vite PWA, styled to match moslem03.falahos.my's design system. Horizon 1: Faraid Calculator (shared calc core, 14 classical cases passing), Asset Registry, Wassiyah Generator (1/3 meter + heir-exclusion block), Hibah Tracker and Family Waqf Designator (shared marad al-mawt guardrail). Horizon 2: Digital Beneficial Claims — local non-custodial demo of the claim model and transfer restriction only. Two governance gates in this project's own PRDs were overridden per explicit product direction, and are flagged in-app and in README.md / deploy/DEPLOY.md rather than silently shipped as production-ready: - Family Waqf Designator ships ahead of scholarly sign-off (OPEN-01 in scholarly-review-log.md remains unresolved). - Horizon 2 ships ahead of the PRD's stated Phase 0 gate (legal opinion + signed institutional partner) with no confirmation that gate is cleared.
2026-08-13 16:55:58 +08:00
commit 6690696f7f
28 changed files with 7586 additions and 0 deletions
@@ -0,0 +1,49 @@
+# 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`.