Add program schema support and payroll E2E tests

Pass beneficiary JSON schema during program creation so that
advanced criteria fields (educated_level, able_bodied, etc.) are
available in payment plan and payroll forms.  Harden login command
with cookie clearing and increased timeout.  Add initial payroll
spec and command helpers.

Author: Shahzaibahmad97

cypress/e2e/payment-plan.cy.js

@@ -15,6 +15,27 @@ describe('Payment plan workflows', () => {
   const groupProgramCode = `PPGP${Date.now().toString().slice(-4)}`;
   const groupProgramName = `E2E Payment Plan Group ${suiteTimestamp}`;
   const maxBeneficiaries = '50';
+  const beneficiarySchema = {
+    $id: 'https://example.com/beneficiares.schema.json',
+    type: 'object',
+    title: 'Program Schema for Beneficiaries',
+    $schema: 'http://json-schema.org/draft-04/schema#',
+    properties: {
+      able_bodied: {
+        type: 'boolean',
+        description: 'Flag determining whether someone is able bodied or not',
+      },
+      educated_level: {
+        type: 'string',
+        description: 'The level of person when it comes to the school/education/studies',
+      },
+      number_of_children: {
+        type: 'integer',
+        description: 'Number of children',
+      },
+    },
+    description: 'This document records the details beneficiares',
+  };
   const createdPaymentPlans = new Set();
 
   const planData = (label, benefitPlanName) => {
@@ -26,7 +47,9 @@ describe('Payment plan workflows', () => {
       name: `E2E Payment Plan ${label} ${timestamp}`,
       benefitPlanName,
       dateValidFrom: getDateOffset(0),
-      dateValidTo: getDateOffset(30),
+      // dateValidTo is intentionally omitted — it is optional for payment plans
+      // and the MUI DatePicker dialog overwrites typed values with "today",
+      // causing dateValidTo == dateValidFrom which hides plans from the list.
     };
   };
 
@@ -42,7 +65,7 @@ describe('Payment plan workflows', () => {
     cy.logoutAdminInterface();
 
     cy.login();
-    cy.createProgram(individualProgramCode, individualProgramName, maxBeneficiaries, 'INDIVIDUAL');
+    cy.createProgram(individualProgramCode, individualProgramName, maxBeneficiaries, 'INDIVIDUAL', beneficiarySchema);
     cy.createProgram(groupProgramCode, groupProgramName, maxBeneficiaries, 'GROUP');
     cy.logout();
   });
@@ -99,8 +122,7 @@ describe('Payment plan workflows', () => {
     cy.get('[title="Save changes"] button').should('not.be.disabled');
 
     cy.enterMuiInput('Code', existingPlan.code);
-    cy.get('[title="Please fill General Information fields first"] button', { timeout: 10000 })
-      .should('be.disabled');
+    cy.get('[title="Save changes"] button').should('be.disabled');
   });
 
   it('applies advanced criteria from the program JSON schema', () => {

cypress/e2e/payroll.cy.js

@@ -0,0 +1,168 @@
+import { getTimestamp } from '../support/utils';
+
+describe('Payroll workflows', () => {
+  const suiteTimestamp = getTimestamp();
+  const getDateOffset = (days) => {
+    const date = new Date();
+    date.setDate(date.getDate() + days);
+    const day = String(date.getDate()).padStart(2, '0');
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const year = date.getFullYear();
+    return `${day}-${month}-${year}`;
+  };
+
+  // Codes must be ≤ 8 characters (backend limit for program/payment-plan codes).
+  const ts = Date.now();
+  const programCode = `PR${ts.toString().slice(-6)}`;
+  const programName = `E2E Payroll Program ${suiteTimestamp}`;
+  const ppCode = `PP${ts.toString().slice(-6)}`;
+  const ppName = `E2E Payroll Plan ${suiteTimestamp}`;
+  // Payment cycle codes have no documented 8-char limit; use a longer unique value.
+  const cycleCode = `PCY${ts.toString().slice(-5)}`;
+
+  const createdPayrolls = new Set();
+
+  const payrollData = (label) => {
+    const timestamp = getTimestamp();
+    return {
+      name: `E2E Payroll ${label} ${timestamp}`,
+      paymentPlanCode: ppCode,
+      paymentPlanName: ppName,
+      paymentCycleCode: cycleCode,
+      dateValidFrom: getDateOffset(0),
+      dateValidTo: getDateOffset(30),
+      // paymentMethod is omitted → first available method is selected
+    };
+  };
+
+  const trackPayroll = (name) => {
+    createdPayrolls.add(name);
+  };
+
+  before(() => {
+    cy.loginAdminInterface();
+    cy.setModuleConfig('fe-core', 'menu-config-sp.json');
+    cy.setModuleConfig('social_protection', 'social-protection-config.json');
+    cy.setModuleConfig('individual', 'individual-config-minimal.json');
+    cy.logoutAdminInterface();
+
+    cy.login();
+    cy.createProgram(programCode, programName, '50', 'INDIVIDUAL');
+    cy.createPaymentPlan({
+      code: ppCode,
+      name: ppName,
+      benefitPlanName: programName,
+      dateValidFrom: getDateOffset(0),
+      dateValidTo: getDateOffset(365),
+    });
+    // The PaymentCyclePicker in the payroll form searches only ACTIVE cycles.
+    // Creating with status ACTIVE triggers a coreAlert dialog; dismiss it below.
+    cy.createPaymentCycle({
+      code: cycleCode,
+      startDate: getDateOffset(0),
+      endDate: getDateOffset(30),
+      status: 'ACTIVE',
+    });
+    cy.get('body').then(($body) => {
+      if ($body.find('[role="dialog"]').length > 0) {
+        cy.get('[role="dialog"] .MuiDialogActions-root button').first().click();
+      }
+    });
+    cy.logout();
+  });
+
+  after(() => {
+    cy.login();
+    // Only PENDING_APPROVAL payrolls have an enabled delete button in the UI.
+    // Tests that change the status are responsible for their own cleanup.
+    Array.from(createdPayrolls).forEach((name) => {
+      cy.deletePayrollFromList(name);
+    });
+    cy.deletePaymentPlan(ppName);
+    cy.deleteProgram(programName);
+    // Payment cycles have no UI delete; cycleCode records accumulate in the DB.
+    cy.logout();
+  });
+
+  beforeEach(() => {
+    cy.login();
+  });
+
+  it('validates required fields before allowing payroll creation', () => {
+    cy.openCreatePayroll();
+    cy.get('[title="Please fill General Information fields first"] button')
+      .should('be.disabled');
+  });
+
+  it('creates a payroll successfully', () => {
+    const payroll = payrollData('Create');
+
+    cy.createPayroll(payroll);
+    trackPayroll(payroll.name);
+
+    cy.filterPayrolls({ name: payroll.name });
+    cy.assertPayrollRowVisible({ name: payroll.name });
+  });
+
+  it('searches payrolls by name', () => {
+    const targetPayroll = payrollData('Search Target');
+    const otherPayroll = payrollData('Search Other');
+
+    cy.createPayroll(targetPayroll);
+    cy.createPayroll(otherPayroll);
+    trackPayroll(targetPayroll.name);
+    trackPayroll(otherPayroll.name);
+
+    cy.filterPayrolls({ name: targetPayroll.name });
+    cy.assertPayrollRowVisible({ name: targetPayroll.name });
+    cy.assertPayrollRowNotVisible({ name: otherPayroll.name });
+
+    cy.filterPayrolls({ name: otherPayroll.name });
+    cy.assertPayrollRowVisible({ name: otherPayroll.name });
+    cy.assertPayrollRowNotVisible({ name: targetPayroll.name });
+  });
+
+  it('views payroll details from the list', () => {
+    const payroll = payrollData('View');
+
+    cy.createPayroll(payroll);
+    trackPayroll(payroll.name);
+
+    cy.openPayrollForViewFromList(payroll.name);
+    cy.assertMuiInput('Name', payroll.name);
+  });
+
+  it('deletes a PENDING_APPROVAL payroll', () => {
+    const payroll = payrollData('Delete');
+
+    cy.createPayroll(payroll);
+    // Not tracked: deleted below, so no after() cleanup needed.
+
+    cy.deletePayrollFromList(payroll.name);
+    cy.filterPayrolls({ name: payroll.name });
+    cy.assertPayrollRowNotVisible({ name: payroll.name });
+  });
+
+  it('shows a newly-created payroll in the pending payrolls list', () => {
+    const payroll = payrollData('Pending');
+
+    cy.createPayroll(payroll);
+    trackPayroll(payroll.name);
+
+    cy.visit('/front/payrollsPending');
+    cy.contains('Payrolls Found');
+    cy.contains('button', 'Search').click();
+    cy.assertPayrollRowVisible({ name: payroll.name });
+  });
+
+  it('opens and closes the reconciliation summary dialog from the pending list', () => {
+    const payroll = payrollData('Reconcile Dialog');
+
+    cy.createPayroll(payroll);
+    trackPayroll(payroll.name);
+
+    cy.openPayrollPendingSummary(payroll.name);
+    cy.contains('button', 'Close').click();
+    cy.contains('View Reconciliation Summary:').should('not.exist');
+  });
+});

cypress/support/commands/auth.commands.js

@@ -1,8 +1,11 @@
 export function registerAuthCommands() {
   Cypress.Commands.add('login', () => {
+    // Clear cookies so we always land on a clean login page regardless of
+    // the state the previous test left the browser in.
+    cy.clearCookies();
     cy.visit('/front/login');
 
-    cy.get('body', { timeout: 15000 })
+    cy.get('body', { timeout: 30000 })
       .should(($body) => {
         const loggedIn = $body.find('button[title="Log out"]').length > 0
           || $body.text().includes('Welcome Admin Admin!');

cypress/support/commands/payments/index.js

@@ -1,7 +1,9 @@
 import { registerPaymentPlanCommands } from './payment-plan.commands';
 import { registerPaymentCycleCommands } from './payment-cycle.commands';
+import { registerPayrollCommands } from './payroll.commands';
 
 export function registerPaymentCommands() {
   registerPaymentPlanCommands();
   registerPaymentCycleCommands();
+  registerPayrollCommands();
 }