feat: Add Playwright tests and Page Object Models for authentication, login, and home page.

Author: Mukuldev21

pages/HomePage.ts

@@ -1,18 +1,82 @@
-import {Page, Locator, expect} from '@playwright/test';
+import { Page, Locator, expect } from '@playwright/test';
 
 export class HomePage {
     readonly page: Page;
     readonly expectedTitle: "Home";
     readonly loggedInUser: Locator;
 
-    constructor(page : Page) {
+    // Header elements
+    readonly accountLink: Locator;
+    readonly locationBadge: Locator;
+    readonly homeIcon: Locator;
+    readonly welcomeHeading: Locator;
+    readonly logoutButton: Locator;
+
+    // Dashboard Apps
+    readonly findPatientRecordApp: Locator;
+    readonly activeVisitsApp: Locator;
+    readonly captureVitalsApp: Locator;
+    readonly registerPatientApp: Locator;
+    readonly appointmentSchedulingApp: Locator;
+    readonly reportsApp: Locator;
+    readonly dataManagementApp: Locator;
+    readonly configureMetadataApp: Locator;
+    readonly systemAdministrationApp: Locator;
+
+    constructor(page: Page) {
         this.page = page;
         this.expectedTitle = "Home";
         this.loggedInUser = page.locator('li.nav-item.identifier');
+
+        // Initialize Header elements
+        this.accountLink = page.getByText('admin My Account');
+        // Note: The location badge might change based on selection, but using the one from codegen for now
+        // A more robust way would be to look for the ID or class, but sticking to codegen text as requested
+        this.locationBadge = page.getByRole('link', { name: /Inpatient Ward|Isolation Ward/ }).first();
+        this.homeIcon = page.getByRole('link').first();
+        this.welcomeHeading = page.getByRole('heading', { name: 'Logged in as Super User (' });
+        this.logoutButton = page.getByRole('link', { name: 'Logout ' });
+
+        // Initialize Dashboard Apps
+        this.findPatientRecordApp = page.getByRole('link', { name: ' Find Patient Record' });
+        this.activeVisitsApp = page.getByRole('link', { name: ' Active Visits' });
+        this.captureVitalsApp = page.getByRole('link', { name: ' Capture Vitals' });
+        this.registerPatientApp = page.getByRole('link', { name: ' Register a patient' });
+        this.appointmentSchedulingApp = page.getByRole('link', { name: ' Appointment Scheduling' });
+        this.reportsApp = page.getByRole('link', { name: ' Reports' });
+        this.dataManagementApp = page.getByRole('link', { name: ' Data Management' });
+        this.configureMetadataApp = page.getByRole('link', { name: ' Configure Metadata' });
+        this.systemAdministrationApp = page.getByRole('link', { name: ' System Administration' });
     }
 
     async verifyHomePage() {
         await expect(this.page).toHaveTitle(this.expectedTitle);
         await expect(this.loggedInUser).toBeVisible();
     }
+
+    async verifyDashboardElements() {
+        // Verify Header
+        await Promise.all([
+            expect(this.accountLink).toBeVisible(),
+            // Location badge might vary, checking if at least one is visible if we want to be strict, 
+            // but for now let's check the one we defined.
+            // await expect(this.locationBadge).toBeVisible(); // Commenting out as it might be flaky if location changes
+            expect(this.homeIcon).toBeVisible(),
+            expect(this.welcomeHeading).toBeVisible(),
+            expect(this.logoutButton).toBeVisible(),
+        ]);
+
+        // Verify Apps
+        await Promise.all([
+            expect(this.findPatientRecordApp).toBeVisible(),
+            expect(this.activeVisitsApp).toBeVisible(),
+            expect(this.captureVitalsApp).toBeVisible(),
+            expect(this.registerPatientApp).toBeVisible(),
+            expect(this.appointmentSchedulingApp).toBeVisible(),
+            expect(this.reportsApp).toBeVisible(),
+            expect(this.dataManagementApp).toBeVisible(),
+            expect(this.configureMetadataApp).toBeVisible(),
+            expect(this.systemAdministrationApp).toBeVisible(),
+        ]);
+    }
 }

tests/LoginTest.spec.ts

@@ -1,4 +1,4 @@
-import { test } from '@playwright/test';
+import { test, expect } from '@playwright/test';
 import { LoginPage } from '../pages/LoginPage';
 import { loginData } from '../fixtures/LoginData';
 import { HomePage } from '../pages/HomePage';
@@ -23,24 +23,34 @@ test.describe('Login Tests', () => {
 
     test.describe("Login Functionality", () => {
 
-        test('Successful login', async () => {
+        test('TC-A.1: Successful Login', async () => {
             await loginPage.login(validUser.username, validUser.password, validUser.location);
             homePage = new HomePage(loginPage.page);
             await homePage.verifyHomePage();
         });
 
-        test('Unsuccessful login', async () => {
+        test('TC-A.2: Invalid Credential Login', async () => {
             await loginPage.login(invalidUser.username, invalidUser.password, invalidUser.location);
             await loginPage.errorMessage.isVisible();
             await loginPage.assertErrorMessage(errorMessages.invalidCredentials);
         });
-        test('Login without selecting session location', async () => {
+
+        test('TC-A.3: Logout Functionality', async () => {
+            await loginPage.login(validUser.username, validUser.password, validUser.location);
+            homePage = new HomePage(loginPage.page);
+            await homePage.verifyHomePage();
+
+            await homePage.logoutButton.click();
+            await expect(loginPage.page).toHaveTitle("Login");
+            await expect(loginPage.loginButton).toBeVisible();
+        });
+        test('TC-A.4: Login without selecting session location', async () => {
             await loginPage.loginWithoutLocation(validUser.username, validUser.password);
             await loginPage.errorMessageSessionLocationSelect.isVisible();
             await loginPage.assertSessionLocationError(errorMessages.locationRequired);
         });
 
-        test('Verify session locations', async () => {
+        test('TC-A.5: Verify session locations', async () => {
             await loginPage.verifySessionLocations(sessionLocations);
         });
 

tests/auth.setup.ts

@@ -13,6 +13,21 @@ setup('authenticate', async ({ page }) => {
         fs.mkdirSync(authDir, { recursive: true });
     }
 
+    // Check if we already have a valid session
+    if (fs.existsSync(authFile)) {
+        try {
+            await page.context().addCookies(JSON.parse(fs.readFileSync(authFile, 'utf-8')).cookies);
+            await page.goto('https://o2.openmrs.org/openmrs/index.htm'); // Go to home page directly
+            // If we are redirected to login, then our session is invalid
+            if (await page.title() === 'Home') {
+                console.log('Using existing auth state');
+                return;
+            }
+        } catch (e) {
+            console.log('Error reading auth file or invalid state, re-authenticating...');
+        }
+    }
+
     const loginPage = new LoginPage(page);
     await loginPage.navigate();
     await loginPage.login(loginData.validUser.username, loginData.validUser.password, loginData.validUser.location);

tests/homePagetest.spec.ts

@@ -0,0 +1,17 @@
+import { test } from '@playwright/test';
+import { HomePage } from '../pages/HomePage';
+
+test.describe('Home Page Tests', () => {
+
+    let homePage: HomePage;
+
+    test.beforeEach(async ({ page }) => {
+        homePage = new HomePage(page);
+        await page.goto('/');
+    });
+
+    test('Verify Home Page Elements', async () => {
+        await homePage.verifyHomePage();
+        await homePage.verifyDashboardElements();
+    });
+});