# pramoddutta/aitesterblueprint4x architecture

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

- Interactive diagram: https://gitdiagram.com/pramoddutta/aitesterblueprint4x
- Repository: https://github.com/pramoddutta/aitesterblueprint4x

## Overview

AITester Blueprint 4x is a collection of learning examples for AI-powered testing, rather than one integrated runtime. The represented workflows cover Jira-to-test-case generation, Jira-to-test-plan generation, job tracking, LangFlow bug triage, screenshot-based bug drafting, and document retrieval/chat. The tree and excerpts support several internal calls; other chapter capabilities are documented but their implementation paths are not present here. Edges are limited to shown calls or documented behavior, so some integrations and cross-component wiring are omitted.

Main entry points: [`chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py) (Workflow Router), [`chapter_03_Local_TC_Generator/src/llm_client.py`](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/llm_client.py) (LLM Client), [`chapter_03_Local_TC_Generator/src/app.py`](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/app.py) (Test Case App), [`chapter_03_Local_TC_Generator/src/jira_client.py`](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/jira_client.py) (Jira Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_qa["QA Automation"]
  node_tc_app["Test Case App<br/>[app.py]"]
  node_tc_jira["Jira Client<br/>[jira_client.py]"]
  node_tc_llm["LLM Client<br/>[llm_client.py]"]
  node_tc_config[("Config Store<br/>[config_store.py]")]
  node_selenium_login["Login Page<br/>[LoginPage.java]"]
  node_selenium_config["Config Reader<br/>[ConfigReader.java]"]
  node_selenium_wait["Wait Utils<br/>[WaitUtils.java]"]
end

subgraph group_agents["AI Agents"]
  node_blast_app["Agent App<br/>[app.py]"]
  node_blast_nav["Workflow Router<br/>[navigation.py]"]
  node_blast_fetch["Jira Fetch<br/>[jira_fetch.py]"]
  node_blast_normalize["Ticket Normalize<br/>[normalize.py]"]
  node_blast_ready["Readiness Check<br/>[readiness.py]"]
  node_blast_plan["Plan Builder<br/>[plan_build.py]"]
  node_blast_render["Plan Renderer<br/>[render.py]"]
  node_blast_llm["LLM Client<br/>[llm_client.py]"]
  node_blast_config[("Config Store<br/>[config_store.py]")]
  node_triage_ui["Triage UI<br/>[App.jsx]"]
  node_triage_api["Flow API<br/>[run.js]"]
  node_screenshot_ui["Screenshot Bug UI<br/>[App.jsx]"]
  node_screenshot_api["Bug Report API<br/>[report.js]"]
end

subgraph group_career["Career Tools"]
  node_job_app["Job Tracker<br/>[App.jsx]"]
  node_job_db[("Job Store<br/>[db.js]")]
  node_resume_builder["Resume Builder<br/>[build_resume.js]"]
end

subgraph group_rag["RAG Explorer"]
  node_rag_ui["RAG Explorer UI<br/>[App.jsx]"]
  node_rag_engine["Search Engine<br/>[engine.js]"]
  node_rag_api["Chat API<br/>[chat.js]"]
  node_rag_server["Live Backend<br/>[app.py]"]
end

node_learner(("User"))
node_jira_service{{"Jira"}}
node_ollama{{"Ollama"}}
node_groq{{"Groq"}}
node_langflow{{"LangFlow"}}

node_learner -->|"submits ticket"| node_tc_app
node_tc_app -->|"fetches issue"| node_tc_jira
node_tc_app -->|"generates cases"| node_tc_llm
node_tc_jira -->|"reads settings"| node_tc_config
node_tc_llm -->|"reads settings"| node_tc_config
node_tc_jira -->|"requests issue"| node_jira_service
node_tc_llm -->|"tries local model"| node_ollama
node_tc_llm -->|"falls back"| node_groq
node_selenium_login -->|"reads settings"| node_selenium_config
node_selenium_login -->|"uses waits"| node_selenium_wait
node_learner -.->|"starts planning"| node_blast_app
node_blast_app -->|"routes workflow"| node_blast_nav
node_blast_nav -->|"fetches ticket"| node_blast_fetch
node_blast_nav -->|"normalizes ticket"| node_blast_normalize
node_blast_nav -->|"checks readiness"| node_blast_ready
node_blast_nav -->|"builds plan"| node_blast_plan
node_blast_nav -->|"renders output"| node_blast_render
node_blast_fetch -.->|"fetches ticket"| node_jira_service
node_blast_llm -->|"loads config"| node_blast_config
node_learner -.->|"tracks applications"| node_job_app
node_job_app -->|"saves jobs"| node_job_db
node_learner -->|"submits Jira key"| node_triage_ui
node_triage_ui -->|"posts run request"| node_triage_api
node_triage_api -.->|"runs flow"| node_langflow
node_learner -.->|"uploads screenshot"| node_screenshot_ui
node_learner -.->|"asks question"| node_rag_ui
node_rag_ui -->|"searches or chats"| node_rag_engine
node_rag_engine -->|"posts chat context"| node_rag_api
node_rag_engine -.->|"selects live mode"| node_rag_server

click node_tc_app "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/app.py"
click node_tc_jira "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/jira_client.py"
click node_tc_llm "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/llm_client.py"
click node_tc_config "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/config_store.py"
click node_selenium_login "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/pages/LoginPage.java"
click node_selenium_config "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/utils/ConfigReader.java"
click node_selenium_wait "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/utils/WaitUtils.java"
click node_blast_app "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/app.py"
click node_blast_nav "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py"
click node_blast_fetch "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/jira_fetch.py"
click node_blast_normalize "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/normalize.py"
click node_blast_ready "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/readiness.py"
click node_blast_plan "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/plan_build.py"
click node_blast_render "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/render.py"
click node_blast_llm "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/llm_client.py"
click node_blast_config "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/config_store.py"
click node_job_app "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_05_JobTrackerAI/src/App.jsx"
click node_job_db "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_05_JobTrackerAI/src/db.js"
click node_triage_ui "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_09_LangFlow/ui_bugtriage/src/App.jsx"
click node_triage_api "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_09_LangFlow/ui_bugtriage/api/run.js"
click node_screenshot_ui "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/ui_screenshotbugAIAgent/src/App.jsx"
click node_screenshot_api "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/ui_screenshotbugAIAgent/api/report.js"
click node_rag_ui "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/App.jsx"
click node_rag_engine "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/engine.js"
click node_rag_api "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/api/chat.js"
click node_rag_server "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/server/app.py"
click node_resume_builder "https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_04_JobKitAI/resume-helper/resume-tailor/scripts/build_resume.js"

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_tc_app,node_tc_jira,node_tc_llm,node_tc_config,node_selenium_login,node_selenium_config,node_selenium_wait,node_learner toneBlue
class node_blast_app,node_blast_nav,node_blast_fetch,node_blast_normalize,node_blast_ready,node_blast_plan,node_blast_render,node_blast_llm,node_blast_config,node_triage_ui,node_triage_api,node_screenshot_ui,node_screenshot_api toneAmber
class node_job_app,node_job_db,node_resume_builder toneMint
class node_rag_ui,node_rag_engine,node_rag_api,node_rag_server toneRose
class node_jira_service,node_ollama,node_groq,node_langflow toneIndigo
```

## Components

### QA Automation

- [Test Case App](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/app.py): `chapter_03_Local_TC_Generator/src/app.py`
- [Jira Client](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/jira_client.py): `chapter_03_Local_TC_Generator/src/jira_client.py`
- [LLM Client](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/llm_client.py): `chapter_03_Local_TC_Generator/src/llm_client.py`
- [Config Store](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_03_Local_TC_Generator/src/config_store.py): `chapter_03_Local_TC_Generator/src/config_store.py`
- [Login Page](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/pages/LoginPage.java): `chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/pages/LoginPage.java`
- [Config Reader](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/utils/ConfigReader.java): `chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/utils/ConfigReader.java`
- [Wait Utils](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/utils/WaitUtils.java): `chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/utils/WaitUtils.java`

### AI Agents

- [Agent App](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/app.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/app.py`
- [Workflow Router](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`
- [Jira Fetch](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/jira_fetch.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/jira_fetch.py`
- [Ticket Normalize](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/normalize.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/normalize.py`
- [Readiness Check](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/readiness.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/readiness.py`
- [Plan Builder](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/plan_build.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/plan_build.py`
- [Plan Renderer](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/render.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/render.py`
- [LLM Client](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/llm_client.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/llm_client.py`
- [Config Store](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/config_store.py): `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/config_store.py`
- [Triage UI](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_09_LangFlow/ui_bugtriage/src/App.jsx): `chapter_09_LangFlow/ui_bugtriage/src/App.jsx`
- [Flow API](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_09_LangFlow/ui_bugtriage/api/run.js): `chapter_09_LangFlow/ui_bugtriage/api/run.js`
- [Screenshot Bug UI](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/ui_screenshotbugAIAgent/src/App.jsx): `ui_screenshotbugAIAgent/src/App.jsx`
- [Bug Report API](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/ui_screenshotbugAIAgent/api/report.js): `ui_screenshotbugAIAgent/api/report.js`

### Career Tools

- [Job Tracker](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_05_JobTrackerAI/src/App.jsx): `chapter_05_JobTrackerAI/src/App.jsx`
- [Job Store](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_05_JobTrackerAI/src/db.js): `chapter_05_JobTrackerAI/src/db.js`
- [Resume Builder](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_04_JobKitAI/resume-helper/resume-tailor/scripts/build_resume.js): `chapter_04_JobKitAI/resume-helper/resume-tailor/scripts/build_resume.js`

### RAG Explorer

- [RAG Explorer UI](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/App.jsx): `chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/App.jsx`
- [Search Engine](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/engine.js): `chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/engine.js`
- [Chat API](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/api/chat.js): `chapter_10_RAG_Basics/01_RAG_Explorer/api/chat.js`
- [Live Backend](https://github.com/pramoddutta/aitesterblueprint4x/blob/main/chapter_10_RAG_Basics/01_RAG_Explorer/server/app.py): `chapter_10_RAG_Basics/01_RAG_Explorer/server/app.py`

### Other components

- **User**
- **Jira**
- **Ollama**
- **Groq**
- **LangFlow**

## Connections

- User → Test Case App: submits ticket (evidence: `chapter_03_Local_TC_Generator/src/app.py`)
- Test Case App → Jira Client: fetches issue (evidence: `chapter_03_Local_TC_Generator/src/app.py`)
- Test Case App → LLM Client: generates cases (evidence: `chapter_03_Local_TC_Generator/src/app.py`)
- Jira Client → Config Store: reads settings (evidence: `chapter_03_Local_TC_Generator/src/jira_client.py`)
- LLM Client → Config Store: reads settings (evidence: `chapter_03_Local_TC_Generator/src/llm_client.py`)
- Jira Client → Jira: requests issue (evidence: `chapter_03_Local_TC_Generator/src/jira_client.py`)
- LLM Client → Ollama: tries local model (evidence: `chapter_03_Local_TC_Generator/src/llm_client.py`)
- LLM Client → Groq: falls back (evidence: `chapter_03_Local_TC_Generator/src/llm_client.py`)
- Login Page → Config Reader: reads settings (evidence: `chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/pages/LoginPage.java`)
- Login Page → Wait Utils: uses waits (evidence: `chapter_02_Prompt_Eng/RICE_POT_SeleniumAdvanceFramework/src/main/java/com/salesforce/pages/LoginPage.java`)
- User → Agent App: starts planning
- Agent App → Workflow Router: routes workflow (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/app.py`)
- Workflow Router → Jira Fetch: fetches ticket (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`)
- Workflow Router → Ticket Normalize: normalizes ticket (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`)
- Workflow Router → Readiness Check: checks readiness (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`)
- Workflow Router → Plan Builder: builds plan (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`)
- Workflow Router → Plan Renderer: renders output (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/navigation.py`)
- Jira Fetch → Jira: fetches ticket
- LLM Client → Config Store: loads config (evidence: `chapter_07_AI_Agents/Test-Plan-Agent-Blast/tools/llm_client.py`)
- User → Job Tracker: tracks applications
- Job Tracker → Job Store: saves jobs (evidence: `chapter_05_JobTrackerAI/src/App.jsx`)
- User → Triage UI: submits Jira key (evidence: `chapter_09_LangFlow/ui_bugtriage/src/App.jsx`)
- Triage UI → Flow API: posts run request (evidence: `chapter_09_LangFlow/ui_bugtriage/src/App.jsx`)
- Flow API → LangFlow: runs flow
- User → Screenshot Bug UI: uploads screenshot
- User → RAG Explorer UI: asks question
- RAG Explorer UI → Search Engine: searches or chats (evidence: `chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/App.jsx`)
- Search Engine → Chat API: posts chat context (evidence: `chapter_10_RAG_Basics/01_RAG_Explorer/ui/src/engine.js`)
- Search Engine → Live Backend: selects live mode
