Files
nur-falah-prevention/e2e-jurisdiction-review.cjs
T
wmj 33a821e61d refactor: restructure navigation into 5 grouped hubs, off the 22-item flat strip
Implements the researched IA fix: mobile nav UX consensus caps primary
destinations at 4-5 (uxpin.com, fintech/banking 2026 UX research), and
this app had grown to 22 tabs in one horizontally-scrolling row —
exactly the anti-pattern that research flags for choice paralysis and
slower task completion.

New structure — 5 bottom-nav hubs, grouped by what the user is actually
trying to do, not build order:
- Home: Coverage (unchanged, still the landing screen)
- Estate: Assets, Faraid, Insurance, Wassiyah, Hibah, Family Waqf,
  Nominate, Claims (H2)
- Giving: Zakat, Sadaqah, Khairat
- Family: Tree, Trigger, Mutawalli, Manage (was 'Family', renamed to
  avoid colliding with the hub's own label), Neighbourhood
- Daily: Prayer Times, Qibla, Quran, Locate

Each hub reveals its own sub-nav one tap in, instead of every tab
competing for space in a single row. Settings moved out of the tab
strip entirely into a header gear icon, matching the banking-app pattern
of keeping settings out of primary thumb-reach real estate. The bottom
nav is now fixed (thumb-zone), sub-nav keeps the old sticky-top position.

Cross-component navigation (nav.js requestedTab, used by the Family
Tree's 'give sadaqah in memory' link) now resolves a tab label to its
owning (hub, sub-tab) pair instead of a flat index — verified live.

This touches every E2E suite: a single click on a tab's old selector no
longer reaches it (hub, then sub-tab). Added a shared gotoTab(page, label)
helper to e2e-auth-helper.cjs encapsulating the two-step navigation, and
migrated all ~22 affected test files off direct nav-button selectors —
mechanical substitution followed by manual fixes for local clickTab
wrappers, template-literal selectors, and active-state assertions that
needed to target the new .hub-tab/.subnav structure specifically.

Full regression after migration: every suite passes (one isolated
Family Tree flake confirmed clean on rerun, unrelated to navigation).
2026-08-14 14:55:09 +08:00

114 lines
6.9 KiB
JavaScript

// Verifies the whole-app jurisdiction setting (MY/SG/UK), its downstream
// effects on Wassiyah/will document/Zakat currency, and the professional
// review request workflow against the live backend.
const { chromium } = require('playwright');
const { signInFreshFamily, gotoTab } = require('./e2e-auth-helper.cjs');
const BASE = 'https://moslem04.falahos.my/';
const results = [];
const consoleErrors = [];
function record(name, pass, detail = '') { results.push({ name, pass, detail }); console.log(`${pass ? 'PASS' : 'FAIL'} ${name}${detail ? ' — ' + detail : ''}`); }
async function main() {
const browser = await chromium.launch();
const page = await browser.newPage({ viewport: { width: 390, height: 844 } });
page.on('console', m => { if (m.type() === 'error') consoleErrors.push(m.text()); });
page.on('pageerror', e => consoleErrors.push(e.message));
await signInFreshFamily(page, BASE, 'e2e-jurisdiction');
// ── Settings: jurisdiction selector, owner can change ──
await gotoTab(page, 'Settings');
await page.waitForTimeout(600);
const jurisdictionSelectVisible = await page.locator('.jurisdiction-setting select').isVisible().catch(() => false);
record('Settings: jurisdiction selector visible for owner', jurisdictionSelectVisible);
await page.locator('.jurisdiction-setting select').selectOption('SG');
await page.waitForTimeout(1000);
const savedBadge = await page.locator('.jurisdiction-setting .saved').isVisible().catch(() => false);
record('Settings: changing jurisdiction shows a saved confirmation', savedBadge);
// ── Zakat: currency defaults follow the family jurisdiction (SGD) ──
await gotoTab(page, 'Zakat');
await page.waitForTimeout(800);
const sgdLabelVisible = await page.locator('.field:has-text("Cash")').textContent();
record('Zakat: currency label reflects Singapore jurisdiction (SGD)', sgdLabelVisible.includes('SGD'), sgdLabelVisible);
const nisabValue = await page.locator('.field:has-text("Nisab") input').inputValue();
record('Zakat: Nisab default follows Singapore jurisdiction (8000)', nisabValue === '8000', nisabValue);
// Log an asset first so the one-third cap isn't zero (a fresh family with
// no assets has cap=0, which would make any bequest below "exceed" it).
await gotoTab(page, 'Assets');
await page.waitForTimeout(500);
await page.locator('.form-card .field:has-text("Description") input').fill('Savings');
await page.locator('.form-card .field:has-text("Estimated value") input').fill('30000');
await page.locator('.form-card button.btn-primary', { hasText: 'Add asset' }).click();
await page.waitForTimeout(1000);
// ── Wassiyah: jurisdiction dropdown includes Singapore, defaults from family setting ──
await gotoTab(page, 'Wassiyah');
await page.waitForTimeout(800);
const wassiyahJurisdiction = await page.locator('.field:has-text("Jurisdiction") select').inputValue();
record('Wassiyah: jurisdiction defaults to the family setting (SG)', wassiyahJurisdiction === 'SG', wassiyahJurisdiction);
const sgOptionVisible = await page.locator('.field:has-text("Jurisdiction") select option[value="SG"]').count();
record('Wassiyah: Singapore is a selectable jurisdiction option', sgOptionVisible === 1);
// ── Draft will document reflects Singapore-specific legal notes ──
await page.locator('.field:has-text("Full legal name") input').fill('Siti binte Rahman');
await page.locator('.field:has-text("Recipient name") input').fill('Local Mosque Fund');
await page.locator('.field:has-text("Relation to you") input').fill('charity');
await page.locator('.field:has-text("Description") input').fill('Cash gift');
await page.locator('.field:has-text("Value") input').first().fill('3000');
await page.locator('button.btn-primary', { hasText: 'Add bequest' }).click();
await page.waitForTimeout(1000);
const [docPage] = await Promise.all([
page.waitForEvent('popup'),
page.locator('button.btn-secondary', { hasText: 'Generate draft will document' }).click()
]);
await docPage.waitForLoadState();
const docText = await docPage.locator('body').innerText();
record('Will document: Singapore-specific legal note present (Wills Act 1838 / AMLA)', docText.includes('1838') && docText.includes('AMLA'), docText.slice(0, 50));
await docPage.close();
// ── Professional review request workflow ──
const notRequestedVisible = await page.locator('.review-card', { hasText: "hasn't been reviewed" }).isVisible().catch(() => false);
record('Wassiyah: starts as not-yet-reviewed', notRequestedVisible);
await page.locator('button.btn-secondary', { hasText: 'Request professional review' }).click();
await page.waitForTimeout(1000);
const requestedVisible = await page.locator('.review-card.review-requested').isVisible().catch(() => false);
record('Wassiyah: requesting review updates status', requestedVisible);
await page.locator('.reviewer-row input').fill('Ahmad & Co Solicitors');
await page.locator('.reviewer-row button', { hasText: 'Mark reviewed' }).click();
await page.waitForTimeout(1000);
const reviewedVisible = await page.locator('.review-card.review-reviewed', { hasText: 'Ahmad & Co Solicitors' }).isVisible().catch(() => false);
record('Wassiyah: marking reviewed records the reviewer name', reviewedVisible);
// Review status surfaces on the Mutawalli dashboard (owner-only family — owner sees own row)
await gotoTab(page, 'Mutawalli');
await page.waitForTimeout(800);
const mutawalliReviewBadge = await page.locator('.review-badge.review-reviewed').isVisible().catch(() => false);
const mutawalliGated = (await page.locator('.module').innerText()).includes('Only the mutawalli');
record('Mutawalli: review status surfaces on the dashboard (or family is correctly gated)', mutawalliReviewBadge || mutawalliGated);
// ── Isolation: a different family (same account) is unaffected by this jurisdiction change ──
const isolationPage = await browser.newPage({ viewport: { width: 390, height: 844 } });
await signInFreshFamily(isolationPage, BASE, 'e2e-jurisdiction-isolation');
await gotoTab(isolationPage, 'Settings');
await isolationPage.waitForTimeout(600);
const isolatedJurisdiction = await isolationPage.locator('.jurisdiction-setting select').inputValue();
record('Isolation: a different family defaults to MY, unaffected by the SG change above', isolatedJurisdiction === 'MY', isolatedJurisdiction);
await isolationPage.close();
record('No uncaught JS console errors during full session', consoleErrors.length === 0, consoleErrors.join(' || '));
await browser.close();
const passCount = results.filter(r => r.pass).length;
const failCount = results.length - passCount;
console.log(`\n${passCount} passed, ${failCount} failed, ${results.length} total`);
if (failCount > 0) results.filter(r => !r.pass).forEach(r => console.log(` - ${r.name}: ${r.detail}`));
process.exit(failCount > 0 ? 1 : 0);
}
main().catch(e => { console.error('SCRIPT ERROR:', e); process.exit(2); });