Add learning-path.md and update docs for Playwright test categories and automation

Author: kavitaj11

README-ai.md

@@ -1,11 +1,28 @@
+
+# Playwright Basic to Advanced Learning (with K11softwaresolutions.com Demos)
+
+Before leveraging AI-powered test generation, this framework provides a comprehensive suite of Playwright demo tests—ranging from basic to advanced—using real-world scenarios on [K11softwaresolutions.com](https://k11softwaresolutions.com).
+
+**What you'll learn:**
+- Playwright setup and configuration
+- Writing your first E2E test
+- Advanced selectors and assertions
+- Component and API testing
+- Context-aware flows with XState
+- Data-driven and parameterized testing
+- Robust error handling and reporting
+
+Explore the `tests/` directory for hands-on examples and best practices. These demos serve as a foundation for mastering Playwright before moving to AI-augmented automation.
+
 # AI Test Generator (OpenAI-powered)
 
 This module enables AI-driven Playwright test generation using OpenAI's API and prompt templates.
 
 ## Features
-- Generates Playwright tests from prompt templates and config data
-- Supports CSV-driven test data, API endpoints, and DB config
-- Uses OpenAI API for intelligent test creation
+- Playwright demo tests (basic to advanced) for K11softwaresolutions.com
+- Context-aware flows using XState
+- AI-powered Playwright test generation from prompt templates and config data
+- CSV-driven test data, API endpoints, and DB config support
 - Secure API key management via `.env`
 
 ## Usage
@@ -31,8 +48,9 @@ This module enables AI-driven Playwright test generation using OpenAI's API and
    - The generated test will be saved to `tests/mab/AI_GeneratedTest.spec.js`.
 
 ## Customization
-- Add new prompt templates for different test scenarios.
-- Update `ai/generate_generic_tests_ai.js` to use your desired prompt file.
+- Add new prompt templates for different test scenarios
+- Update `ai/generate_generic_tests_ai.js` to use your desired prompt file
+- Extend demo tests in `tests/` for new learning modules
 
 ## Security
 - `.env` is gitignored by default.
@@ -50,10 +68,11 @@ See `prompts/playwright_login_test_generation.txt` for a sample login test promp
 MIT
 
 **Experimental Stage:**
-This AI test generator is currently in an experimental phase. Features and workflows may change, and reliability is not guaranteed for production use. Feedback and contributions are welcome!
+This framework is currently in an experimental phase. Features and workflows may change, and reliability is not guaranteed for production use. Feedback and contributions are welcome!
 
 ## Future Enhancements Planned
 
+- More advanced Playwright demo modules
 - Support for Playwright API and DB test generation
 - Multi-prompt scenario chaining
 - Improved error handling and reporting

README.md

@@ -4,9 +4,25 @@
     <img src="artifacts/assets/javascript-logo.svg" alt="JavaScript Logo" height="60" style="margin-right:20px;vertical-align:middle;"/>
 </p>
 
-# K11TechLab Playwright Automation – K11 Software Solutions
 
-A robust, real-world Playwright automation framework for **K11 Software Solutions**. This project demonstrates best practices in UI automation, advanced reporting, and artifact management for a modern SaaS web application.
+# K11TechLab Playwright Automation
+
+A robust, real-world Playwright automation framework for **K11 Software Solutions**. This project demonstrates best practices in UI automation, advanced reporting, artifact management, and introduces cutting-edge AI-powered test generation for modern web applications.
+
+
+## 🚀 Capabilities & Innovations
+
+- **Playwright basic to advanced learning path:** Step-by-step demo tests and documentation guide you from Playwright fundamentals to advanced automation. Explore real-world scenarios on K11softwaresolutions.com, with code in the `tests/` directory and detailed articles in `/doc`.
+- **AI-powered test generation:** Leverage OpenAI to automatically generate Playwright tests from prompt templates and config data, accelerating test authoring and coverage.
+- **Context-aware flows:** Integrate XState for stateful, dynamic test scenarios and advanced automation logic.
+- **Data-driven testing:** Use CSV, API, and DB config for parameterized, scalable test cases.
+- **Secure config management:** `.env` and `.env.example` for safe API key handling and sharing.
+- **Comprehensive demo suite:** Basic to advanced Playwright tests on real-world K11softwaresolutions.com scenarios.
+- **Component, E2E, and API testing:** Unified structure for UI, API, and component-level validation.
+- **Advanced reporting:** Allure, HTML, and video artifacts for rich evidence and debugging.
+- **CI/CD ready:** Scalable, maintainable structure for enterprise automation.
+
+Explore the `README-ai.md` for details on AI test generation and advanced features.
 
 
 

learning-path.md

@@ -0,0 +1,54 @@
+# Playwright Learning Path & Test Categories
+
+This document guides you through the learning path for mastering Playwright automation in the K11TechLab framework, with references to demo tests and advanced categories including MCP (Model Context Protocol).
+
+---
+
+## 1. Getting Started: Playwright Basics
+- **Simple navigation and assertions**
+  - Example: `tests/smoke/HomeTest.spec.js`
+- **Selectors and element actions**
+  - Example: `utils/ElementAction.js`
+- **Waits and synchronization**
+  - Example: `utils/WaitIUtils.js`
+
+## 2. Intermediate: Data-Driven & Parameterized Testing
+- **CSV-driven test data**
+  - Example: `testdata/login_data.csv`, `utils/DataProvider.js`
+- **Parameterized test flows**
+  - Example: `tests/smoke/LoginTest.spec.js`
+
+## 3. Advanced: Component, API, and Visual Testing
+- **Component-level tests (React, UI)**
+  - Example: `components/QuickActions.js`, `tests/component/HeroCarousel.spec.js`
+- **API testing and network mocking**
+  - Example: `tests/api/AlApiTest.spec.js`
+- **Visual regression and screenshot validation**
+  - Example: `artifacts/`, custom fixtures
+
+## 4. Context-Aware & State Management
+- **XState integration for context-aware flows**
+  - Example: `hooks/hook.js`, `doc/xstate-overview.md`
+
+## 5. MCP (Model Context Protocol) Automation
+- **MCP login and scenario tests**
+  - Example: `tests/mcp/MCPLoginTest.spec.js`
+- **MCP reports and artifacts**
+  - Example: `reports/mcp/`
+
+## 6. AI-Augmented Test Generation
+- **AI-powered Playwright test generation**
+  - Example: `ai/generate_generic_tests_ai.js`, `prompts/playwright_login_test_generation.txt`
+  - See: `README-ai.md`
+
+---
+
+## 📚 Documentation & Further Reading
+- Component testing: `doc/component-testing.md`
+- Playwright JS/TS/Python comparison: `doc/cypress-vs-playwright.md`
+- XState overview: `doc/xstate-overview.md`
+- MCP and AI integration: `README-ai.md`
+
+---
+
+**Follow this path to build foundational skills, then explore advanced automation and AI-driven workflows for real-world web applications.**