feat: Add SQLite DB utility, UI+DB integration test, and documentation. Enhance DBActions for SQLite. Update tests, sample data, and docs for robust Playwright automation.

Author: kavitaj11

README.md

@@ -27,7 +27,7 @@ Explore the `README-ai.md` for details on AI test generation and advanced featur
 
 
 
-## 🧪 Automated Test Scenarios
+## Automated Test Scenarios
 
 
 The framework covers critical user journeys, advanced flows, component-level tests, E2E test flows, and visual regression for K11 Software Solutions, including:
@@ -48,7 +48,7 @@ Each scenario validates real user interactions, UI consistency, business logic,
 ---
 
 
-## 🏗️ Project Structure
+## Project Structure
 
 ```
 K11TechLab-playwright-javascript-ai-augmented-framework/
@@ -100,7 +100,7 @@ K11TechLab-playwright-javascript-ai-augmented-framework/
 
 ---
 
-## 🧪 Sample Test Flows
+## Sample Test Flows
 
 
 ### E2E Test Example (with UIElementActions)
@@ -133,7 +133,7 @@ Tests are business-readable, with implementation details handled in page objects
 
 ---
 
-## 🔗 API Testing
+## API Testing
 
 The framework supports API testing using Playwright's built-in APIRequestContext. You can:
 - Validate REST endpoints (GET, POST, PUT, DELETE, etc.)

apiresponse/api_testuser_2026-02-10T03-56-55-450Z.json

@@ -0,0 +1,4 @@
+{
+  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc3MTMwMDYxMywiaWF0IjoxNzcwNjk1ODEzLCJqdGkiOiIzYjliOGVhOGU5NGU0MWY5YmRiOGVjZmE5MzJlODdhZSIsInVzZXJfaWQiOiIxIn0.qEq4E4-hMe8OR1pRs7H-bZS4WJWUeld1xrwcAg8Edcw",
+  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzcwNjk5NDEzLCJpYXQiOjE3NzA2OTU4MTMsImp0aSI6IjRkYTQ4OTFjMDNjYzQzNzE5MmI0YTM2YzQxNzViYmY5IiwidXNlcl9pZCI6IjEifQ.lHUyVUAG4ajvdHQUqIXOlH89o1cyZhgX6rQvZGHmP8w"
+}

apiresponse/api_testuser_2026-02-10T03-56-55-915Z.json

@@ -0,0 +1,4 @@
+{
+  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc3MTMwMDYxMywiaWF0IjoxNzcwNjk1ODEzLCJqdGkiOiI5ZTNkN2QwOGFmMjY0YzFlYjNjMTE2YzZmMzllNDNmZiIsInVzZXJfaWQiOiIxIn0.bbvBMCELuaiTsZEQJt68CAsTEwB5YZn1tT3Z4UabTyo",
+  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzcwNjk5NDEzLCJpYXQiOjE3NzA2OTU4MTMsImp0aSI6ImMwODdmMjE5OTJlMTQ5NGJhYWFmNWJlMmMzYjNkNDBlIiwidXNlcl9pZCI6IjEifQ.zNBbNKFkIynap2QoJcmi_AETypO2QBrSTYgx219B_rY"
+}

apiresponse/api_testuser_2026-02-10T03-56-56-498Z.json

@@ -0,0 +1,4 @@
+{
+  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc3MTMwMDYxNCwiaWF0IjoxNzcwNjk1ODE0LCJqdGkiOiIwNTg5MDQxYjY5ZTc0Y2FhOGEwNTk4MjY2ZTVhNTViZSIsInVzZXJfaWQiOiIxIn0.uJMy9SHToVBIGcMHJ9ADz7ylw-pCNd9NmXI_a_v53kA",
+  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzcwNjk5NDE0LCJpYXQiOjE3NzA2OTU4MTQsImp0aSI6IjUwOThhMDQ4ZjhjOTQ5ZDBiZjgxNGRmNjFkZTVhZDBiIiwidXNlcl9pZCI6IjEifQ.-cv-Z9HeVXw63CQf0SrspEvPQPNfaOcE_u7fztWs7_4"
+}

apiresponse/api_testuser_2026-02-10T03-56-57-110Z.json

@@ -0,0 +1,4 @@
+{
+  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc3MTMwMDYxNCwiaWF0IjoxNzcwNjk1ODE0LCJqdGkiOiIzNDI0OTVjYjMwZGQ0YWE3YjMzMjI2NDllYTBkMGZjNyIsInVzZXJfaWQiOiIxIn0.QlhPzgP-HJvsn2RvDtSogYaCnUikaLCpvoqbE3eyvqc",
+  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzcwNjk5NDE0LCJpYXQiOjE3NzA2OTU4MTQsImp0aSI6Ijg1YTk4NzhkOTU3NzQzZGZhNTcxNDRlN2Q1N2I1YTUyIiwidXNlcl9pZCI6IjEifQ.IsSfFbN7PVsUvj4YKm3KGyVm80-1Nhq-lrwZ6jur1wc"
+}

apiresponse/api_testuser_2026-02-10T03-56-57-684Z.json

@@ -0,0 +1,4 @@
+{
+  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc3MTMwMDYxNSwiaWF0IjoxNzcwNjk1ODE1LCJqdGkiOiJjYTBkMzJiZDdhMDg0NzFkYjlmMWU5NTdlMTg1NmU1MyIsInVzZXJfaWQiOiIxIn0._S6zaZL5KHduThUl5NYT-5R1JTZrPqeFg1gL5hiXRGg",
+  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzcwNjk5NDE1LCJpYXQiOjE3NzA2OTU4MTUsImp0aSI6IjMyODFmZWE5OGUyZDQzZGI4ZTVmY2ZhNGFlZTZkZjdmIiwidXNlcl9pZCI6IjEifQ.ccFZkFrwle6ymKP1Zr8v8lJ38PnYNDWOmBAdcfwnt9k"
+}

doc/db-testing-playwright.md

@@ -0,0 +1,83 @@
+# Database Testing with Playwright (SQLite Example)
+
+This guide explains how to perform database integration testing in the K11TechLab Playwright JavaScript framework using a sample SQLite database.
+
+---
+
+## Why DB Testing?
+- Validate backend data consistency after UI/API actions
+- Ensure end-to-end flows update the database as expected
+- Enable data-driven test scenarios
+
+---
+
+## Sample Setup: SQLite
+
+### 1. Sample Database
+- The file `testdata/sample_db.sqlite` is a SQLite database with a `users` table and sample data.
+- The schema and data are defined in `testdata/sample_db.sql`.
+- To recreate the database, run:
+  ```bash
+  node testdata/create_sample_db.js
+  ```
+
+### 2. DB Test Example
+File: `tests/db/SampleSQLiteDB.spec.js`
+```js
+const { test, expect } = require('@playwright/test');
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '../../testdata/sample_db.sqlite');
+
+function runQuery(db, query) {
+  return new Promise((resolve, reject) => {
+    db.all(query, (err, rows) => {
+      if (err) reject(err);
+      else resolve(rows);
+    });
+  });
+}
+
+test.describe('Sample SQLite DB Integration', () => {
+  let db;
+  test.beforeAll(async () => {
+    db = new sqlite3.Database(dbPath);
+  });
+  test.afterAll(async () => {
+    db.close();
+  });
+
+  test('should fetch all users from the users table', async () => {
+    const rows = await runQuery(db, 'SELECT * FROM users;');
+    expect(rows.length).toBeGreaterThan(0);
+    expect(rows[0]).toHaveProperty('username');
+    expect(rows[0]).toHaveProperty('email');
+  });
+
+  test('should fetch admin user by username', async () => {
+    const rows = await runQuery(db, "SELECT * FROM users WHERE username = 'admin';");
+    expect(rows.length).toBe(1);
+    expect(rows[0].email).toBe('admin@example.com');
+  });
+});
+```
+
+---
+
+## Best Practices
+- Use a dedicated test database (never production!)
+- Clean up or reset data between tests if needed
+- Use environment variables for DB credentials in real DBs
+- For other DBs (Postgres, SQL Server), see `utils/DBActions.js`
+
+---
+
+## References
+- [sqlite3 Node.js package](https://www.npmjs.com/package/sqlite3)
+- [Playwright Test Docs](https://playwright.dev/docs/test-intro)
+- [DBActions Utility](../utils/DBActions.js)
+
+---
+
+**This example can be extended for other databases and more advanced scenarios.**