# sobeymathew/ai_kiro_poc architecture

> Architecture diagram of the GitHub repository sobeymathew/ai_kiro_poc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sobeymathew/ai_kiro_poc
- Repository: https://github.com/sobeymathew/ai_kiro_poc

## Overview

This repository is an enterprise ITSM quality-assurance platform: its browser automation exercises Salesforce ITSM login and service-request flows, while test-case assets, traceability, and reporting support that testing. Sampled page objects implement login, incident creation, and service-request forms on a shared Playwright base class. The tree also documents AI-assisted test-generation capabilities, but the supplied excerpts do not show their runtime implementation or wiring. Relationships among unsampled tests, fixtures, management assets, and reports are therefore not asserted.

Main entry points: [`ai-test-framework/src/playwright/pages/base.page.ts`](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/base.page.ts) (Shared page behavior), [`ai-test-framework/src/playwright/pages/login.page.ts`](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/login.page.ts) (Login page), [`ai-test-framework/src/playwright/pages/incident-create.page.ts`](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/incident-create.page.ts) (Incident form), [`ai-test-framework/src/playwright/pages/coi-request.page.ts`](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/coi-request.page.ts) (COI request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_case_design["Test case assets"]
  node_feature_specs["Gherkin features"]
  node_step_defs["Step definitions"]
  node_test_cases["Test cases"]
  node_user_stories["User stories"]
end

subgraph group_browser_testing["Browser testing"]
  node_playwright_tests["Playwright tests"]
  node_login_page["Login page<br/>[login.page.ts]"]
  node_incident_page["Incident form"]
  node_coi_page["COI request"]
  node_expense_page["Expense request"]
  node_assessment_page["Request assessments"]
  node_security_page["Security exception"]
  node_base_page["Shared page behavior<br/>[base.page.ts]"]
end

subgraph group_framework_services["Framework services"]
  node_global_setup["Global setup<br/>[global-setup.ts]"]
  node_fixtures["Playwright fixtures"]
  node_assertions["Custom assertions"]
  node_api_utils["API utilities<br/>[api.util.ts]"]
  node_retry_utils["Retry utility<br/>[retry.util.ts]"]
  node_logger["Structured logger<br/>[logger.util.ts]"]
  node_test_data["ITSM test data<br/>[itsm-test-data.ts]"]
end

subgraph group_reporting["Traceability and reporting"]
  node_rtm["Traceability generator<br/>[rtm-generator.ts]"]
  node_dashboard["Dashboard generator"]
  node_analytics["Trend data<br/>[trends.json]"]
end

node_engineer(("QA engineer"))
node_portal["Salesforce ITSM"]

node_login_page -->|"extends"| node_base_page
node_incident_page -->|"extends"| node_base_page
node_coi_page -->|"extends"| node_base_page
node_expense_page -->|"extends"| node_base_page
node_assessment_page -->|"extends"| node_base_page
node_security_page -->|"extends"| node_base_page
node_base_page -->|"uses"| node_logger
node_global_setup -->|"uses"| node_logger
node_login_page -->|"drives browser"| node_portal
node_incident_page -->|"drives browser"| node_portal
node_coi_page -->|"drives browser"| node_portal
node_playwright_tests -.->|"tests flows"| node_portal

click node_feature_specs "https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/features"
click node_step_defs "https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/step-definitions"
click node_test_cases "https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/test-cases"
click node_user_stories "https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/user-stories"
click node_playwright_tests "https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/playwright/tests"
click node_login_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/login.page.ts"
click node_incident_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/incident-create.page.ts"
click node_coi_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/coi-request.page.ts"
click node_expense_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/expense-request.page.ts"
click node_assessment_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/request-assessments.page.ts"
click node_security_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/security-exception-request.page.ts"
click node_base_page "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/base.page.ts"
click node_global_setup "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/hooks/global-setup.ts"
click node_fixtures "https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/playwright/fixtures"
click node_assertions "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/assertions/custom.assertion.ts"
click node_api_utils "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/utils/api.util.ts"
click node_retry_utils "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/utils/retry.util.ts"
click node_logger "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/utils/logger.util.ts"
click node_test_data "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/test-data/itsm-test-data.ts"
click node_rtm "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/test-case-management/traceability/rtm-generator.ts"
click node_dashboard "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/reporting/dashboards/dashboard-generator.ts"
click node_analytics "https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/reporting/analytics/trends.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_feature_specs,node_step_defs,node_test_cases,node_user_stories toneBlue
class node_playwright_tests,node_login_page,node_incident_page,node_coi_page,node_expense_page,node_assessment_page,node_security_page,node_base_page toneAmber
class node_global_setup,node_fixtures,node_assertions,node_api_utils,node_retry_utils,node_logger,node_test_data toneMint
class node_rtm,node_dashboard,node_analytics toneRose
class node_engineer,node_portal toneIndigo
```

## Components

### Test case assets

- [Gherkin features](https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/features): `ai-test-framework/src/test-case-management/features`
- [Step definitions](https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/step-definitions): `ai-test-framework/src/test-case-management/step-definitions`
- [Test cases](https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/test-cases): `ai-test-framework/src/test-case-management/test-cases`
- [User stories](https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/test-case-management/user-stories): `ai-test-framework/src/test-case-management/user-stories`

### Browser testing

- [Playwright tests](https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/playwright/tests): `ai-test-framework/src/playwright/tests`
- [Login page](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/login.page.ts): `ai-test-framework/src/playwright/pages/login.page.ts`
- [Incident form](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/incident-create.page.ts): `ai-test-framework/src/playwright/pages/incident-create.page.ts`
- [COI request](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/coi-request.page.ts): `ai-test-framework/src/playwright/pages/coi-request.page.ts`
- [Expense request](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/expense-request.page.ts): `ai-test-framework/src/playwright/pages/expense-request.page.ts`
- [Request assessments](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/request-assessments.page.ts): `ai-test-framework/src/playwright/pages/request-assessments.page.ts`
- [Security exception](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/security-exception-request.page.ts): `ai-test-framework/src/playwright/pages/security-exception-request.page.ts`
- [Shared page behavior](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/pages/base.page.ts): `ai-test-framework/src/playwright/pages/base.page.ts`

### Framework services

- [Global setup](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/hooks/global-setup.ts): `ai-test-framework/src/playwright/hooks/global-setup.ts`
- [Playwright fixtures](https://github.com/sobeymathew/ai_kiro_poc/tree/main/ai-test-framework/src/playwright/fixtures): `ai-test-framework/src/playwright/fixtures`
- [Custom assertions](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/assertions/custom.assertion.ts): `ai-test-framework/src/playwright/assertions/custom.assertion.ts`
- [API utilities](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/utils/api.util.ts): `ai-test-framework/src/playwright/utils/api.util.ts`
- [Retry utility](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/utils/retry.util.ts): `ai-test-framework/src/playwright/utils/retry.util.ts`
- [Structured logger](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/playwright/utils/logger.util.ts): `ai-test-framework/src/playwright/utils/logger.util.ts`
- [ITSM test data](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/test-data/itsm-test-data.ts): `ai-test-framework/src/test-data/itsm-test-data.ts`

### Traceability and reporting

- [Traceability generator](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/test-case-management/traceability/rtm-generator.ts): `ai-test-framework/src/test-case-management/traceability/rtm-generator.ts`
- [Dashboard generator](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/reporting/dashboards/dashboard-generator.ts): `ai-test-framework/src/reporting/dashboards/dashboard-generator.ts`
- [Trend data](https://github.com/sobeymathew/ai_kiro_poc/blob/main/ai-test-framework/src/reporting/analytics/trends.json): `ai-test-framework/src/reporting/analytics/trends.json`

### Other components

- **QA engineer**
- **Salesforce ITSM**

## Connections

- Login page → Shared page behavior: extends (evidence: `ai-test-framework/src/playwright/pages/login.page.ts`)
- Incident form → Shared page behavior: extends (evidence: `ai-test-framework/src/playwright/pages/incident-create.page.ts`)
- COI request → Shared page behavior: extends (evidence: `ai-test-framework/src/playwright/pages/coi-request.page.ts`)
- Expense request → Shared page behavior: extends (evidence: `ai-test-framework/src/playwright/pages/expense-request.page.ts`)
- Request assessments → Shared page behavior: extends (evidence: `ai-test-framework/src/playwright/pages/request-assessments.page.ts`)
- Security exception → Shared page behavior: extends (evidence: `ai-test-framework/src/playwright/pages/security-exception-request.page.ts`)
- Shared page behavior → Structured logger: uses (evidence: `ai-test-framework/src/playwright/pages/base.page.ts`)
- Global setup → Structured logger: uses (evidence: `ai-test-framework/src/playwright/hooks/global-setup.ts`)
- Login page → Salesforce ITSM: drives browser (evidence: `ai-test-framework/src/playwright/pages/login.page.ts`)
- Incident form → Salesforce ITSM: drives browser (evidence: `ai-test-framework/src/playwright/pages/incident-create.page.ts`)
- COI request → Salesforce ITSM: drives browser (evidence: `ai-test-framework/src/playwright/pages/coi-request.page.ts`)
- Playwright tests → Salesforce ITSM: tests flows
