Files
nur-falah-prevention/e2e-fastpath.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

132 lines
7.4 KiB
JavaScript

// Targeted E2E for the new fast-path mechanism: Coverage, Hibah asset-link,
// Waqf corpus-link, Nomination, Death Trigger. Run after the general e2e-uat.cjs.
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-fastpath');
const clickTab = async label => { await gotoTab(page, label); await page.waitForTimeout(500); };
// New tabs exist and are reachable
for (const label of ['Coverage', 'Nominate', 'Trigger']) {
await gotoTab(page, label);
await page.waitForTimeout(300);
const reached = label === 'Coverage'
? await page.locator('.hub-tab.active[aria-label="Home"]').isVisible().catch(() => false)
: await page.locator('.subnav .tab.active', { hasText: label }).isVisible().catch(() => false);
record(`Nav: "${label}" tab exists`, reached);
}
// Add an asset
await clickTab('Assets');
await page.locator('.field:has-text("Description") input').fill('Land parcel, Perak');
await page.locator('.field:has-text("Estimated value") input').fill('400000');
await page.locator('button.btn-primary', { hasText: 'Add asset' }).click();
await page.waitForTimeout(500);
// Coverage should show 0% before any fast-path instrument
await clickTab('Coverage');
const pctBefore = await page.locator('.big-percent').textContent();
record('Coverage: shows 0% before any fast-path instrument attached', pctBefore.trim() === '0%', pctBefore);
const warningVisible = await page.locator('.warning-box').isVisible();
record('Coverage: warning box shown when exposure > 0', warningVisible);
// Link the asset via Hibah
await clickTab('Hibah');
await page.locator('.field:has-text("Recipient") input').fill('My Nephew');
await page.locator('.field:has-text("Relation to you") input').fill('nephew');
await page.locator('.field:has-text("Asset / gift description") input').fill('Land parcel gift');
const linkSelect = page.locator('select').first();
await linkSelect.locator('option').nth(1).waitFor({ state: 'attached', timeout: 10000 }).catch(() => {});
await linkSelect.selectOption({ index: 1 });
await page.locator('button.btn-primary', { hasText: 'Log this hibah' }).click();
await page.waitForTimeout(500);
await page.locator('.guard-buttons button.btn-secondary', { hasText: 'No' }).click();
await page.waitForTimeout(500);
await page.locator('button.btn-primary', { hasText: 'Confirm and save' }).click();
const fastBadgeVisible = await page.locator('.fast-badge').waitFor({ state: 'visible', timeout: 10000 }).then(() => true).catch(() => false);
record('Hibah: linked gift shows fast-path badge', fastBadgeVisible);
// Coverage should now show 100%
await clickTab('Coverage');
const pctAfter = await page.locator('.big-percent').textContent();
record('Coverage: reflects 100% after asset linked to completed Hibah', pctAfter.trim() === '100%', pctAfter);
const successVisible = await page.locator('.success-box').isVisible();
record('Coverage: success box shown at full coverage', successVisible);
// Wassiyah slow-path warning
await clickTab('Wassiyah');
const slowWarningVisible = await page.locator('.slow-path-warning').isVisible();
const slowWarningText = await page.locator('.slow-path-warning').textContent();
record('Wassiyah: slow-path warning visible and explicit', slowWarningVisible && slowWarningText.includes('does not bypass'));
// Nomination Registry basic flow
await clickTab('Assets');
await page.locator('.field:has-text("Description") input').fill('EPF savings');
await page.locator('.field:has-text("Estimated value") input').fill('200000');
await page.locator('.form-card select').first().selectOption('Cash / Bank');
await page.locator('button.btn-primary', { hasText: 'Add asset' }).click();
await page.waitForTimeout(500);
await clickTab('Nominate');
const nomSelect = page.locator('select').first();
await nomSelect.locator('option').nth(1).waitFor({ state: 'attached', timeout: 10000 }).catch(() => {});
const epfVal = await nomSelect.evaluate(el => Array.from(el.options).find(o => o.textContent.includes('EPF savings'))?.value);
await nomSelect.selectOption(epfVal || { index: 1 });
await page.locator('.field:has-text("Nominee name") input').fill('My Wife');
await page.locator('.field:has-text("Institution") input').fill('KWSP');
await page.locator('button.btn-primary', { hasText: 'Add nomination' }).click();
const nominationRowVisible = await page.locator('.nomination-row', { hasText: 'My Wife' }).waitFor({ state: 'visible', timeout: 10000 }).then(() => true).catch(() => false);
record('Nomination: adding a nomination creates a row', nominationRowVisible);
// Death Trigger: cannot fire without threshold
await clickTab('Trigger');
const fireBtnDisabledInitially = await page.locator('button.btn-danger-solid').isDisabled();
record('Death Trigger: fire button disabled with no attestor confirmations', fireBtnDisabledInitially);
const attestorInputs = page.locator('.attestor-row input');
await attestorInputs.nth(0).fill('Executor Ahmad');
await page.locator('.attestor-row .confirm-btn').nth(0).click();
await attestorInputs.nth(1).fill('Witness Fatimah');
await page.locator('.attestor-row .confirm-btn').nth(1).click();
await page.locator('.field:has-text("Date of death") input').fill('2026-08-13');
await page.locator('.field:has-text("Death certificate reference") input').fill('DC-2026-00123');
await page.waitForTimeout(500);
const fireBtnEnabled = await page.locator('button.btn-danger-solid').isEnabled();
record('Death Trigger: fire button enables once 2 attestors confirm + cert ref present', fireBtnEnabled);
await page.locator('button.btn-danger-solid').click();
await page.waitForTimeout(600);
const triggeredBannerVisible = await page.locator('.triggered-banner').isVisible();
record('Death Trigger: fires and shows triggered banner', triggeredBannerVisible);
const packetRowVisible = await page.locator('.packet-row').first().isVisible();
record('Death Trigger: execution packet(s) generated for covered assets', packetRowVisible);
const [download] = await Promise.all([
page.waitForEvent('download'),
page.locator('.packet-row .btn-small').first().click()
]);
record('Death Trigger: packet download works', download.suggestedFilename().includes('execution-packet'), download.suggestedFilename());
record('No uncaught JS console errors during fast-path 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); });