(test) O3-4227: Add e2e test for marking a patient as deceased

e2e/pages/index.ts

@@ -9,3 +9,4 @@ export * from './program-page';
 export * from './results-viewer-page';
 export * from './visits-page';
 export * from './vitals-and-biometrics-page';
+export * from './mark-patient-deceased-page';

e2e/pages/mark-patient-deceased-page.ts

@@ -0,0 +1,35 @@
+import { type Page } from '@playwright/test';
+
+export class MarkPatientDeceasedPage {
+  constructor(private readonly page: Page) {}
+
+  readonly actionsButton = () => this.page.getByRole('button', { name: /actions/i });
+  readonly markDeceasedMenuItem = () => this.page.getByRole('menuitem', { name: /mark patient deceased/i });
+  readonly deathDetailsForm = () => this.page.locator('form');
+  readonly dateOfDeathInput = () => this.page.getByPlaceholder(/dd\/mm\/yyyy/i);
+  readonly causeOfDeathRadio = (cause: string) => this.page.getByRole('radio', { name: cause });
+  readonly saveAndCloseButton = () => this.page.getByRole('button', { name: /save and close/i });
+  readonly deceasedTag = () => this.page.getByText(/deceased/i);
+
+  async goToPatientChart(patientUuid: string) {
+    await this.page.goto(`/openmrs/spa/patient/${patientUuid}/chart/Patient%20Summary`);
+  }
+
+  async openMarkDeceasedForm() {
+    await this.actionsButton().click();
+    await this.markDeceasedMenuItem().click();
+  }
+
+  async fillDeathDetails(date: string, causeOfDeath: string) {
+    await this.dateOfDeathInput().fill(date);
+    await this.causeOfDeathRadio(causeOfDeath).click();
+  }
+
+  async saveAndClose() {
+    await this.saveAndCloseButton().click();
+  }
+
+  async verifyDeceasedTag() {
+    await expect(this.deceasedTag()).toBeVisible();
+  }
+}

e2e/specs/mark-patient-deceased.spec.ts

@@ -0,0 +1,43 @@
+import { expect } from '@playwright/test';
+import { generateRandomPatient, deletePatient, type Patient } from '../commands';
+import { test } from '../core';
+import { MarkPatientDeceasedPage } from '../pages';
+
+let patient: Patient;
+
+test.beforeEach(async ({ api }) => {
+  patient = await generateRandomPatient(api);
+});
+
+test('Mark a patient as deceased', async ({ page }) => {
+  const markPatientDeceasedPage = new MarkPatientDeceasedPage(page);
+  const todayDate = new Date().toLocaleDateString('en-GB').replace(/\//g, '-');
+  const causeOfDeath = 'Neoplasm/cancer';
+
+  await test.step('When I go to the Patient’s chart page', async () => {
+    await markPatientDeceasedPage.goToPatientChart(patient.uuid);
+  });
+
+  await test.step('And I select "Mark patient deceased" from the Actions menu', async () => {
+    await markPatientDeceasedPage.openMarkDeceasedForm();
+  });
+
+  await test.step('Then I should see a form to enter death details', async () => {
+    await expect(markPatientDeceasedPage.deathDetailsForm()).toBeVisible();
+    await expect(markPatientDeceasedPage.dateOfDeathInput()).toBeVisible();
+    await expect(markPatientDeceasedPage.causeOfDeathRadio(causeOfDeath)).toBeVisible();
+  });
+
+  await test.step('When I fill out the death details and save', async () => {
+    await markPatientDeceasedPage.fillDeathDetails(todayDate, causeOfDeath);
+    await markPatientDeceasedPage.saveAndClose();
+  });
+
+  await test.step('Then I should see a “deceased” tag in the patient banner', async () => {
+    await markPatientDeceasedPage.verifyDeceasedTag();
+  });
+});
+
+test.afterEach(async ({ api }) => {
+  await deletePatient(api, patient.uuid);
+});