# pramoddutta/aitesterblueprint architecture

> Architecture diagram of the GitHub repository pramoddutta/aitesterblueprint, 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/pramoddutta/aitesterblueprint
- Repository: https://github.com/pramoddutta/aitesterblueprint

## Overview

AI Tester Blueprint is a hands-on course repository, not one integrated runtime: its projects teach separate AI-assisted testing, automation, retrieval, and evaluation workflows. The graph shows representative runnable workflows and meaningful internal layers supported by the supplied excerpts or README; project boundaries are kept distinct. Several README capabilities have no corresponding runtime files in the supplied tree and are therefore not expanded. Evidence is limited to the README and sampled/indexed source; unsampled modules are not assumed to be connected.

Main entry points: [`Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx`](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx) (Job Tracker), [`Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/app.py) (RAG Explorer API), [`Project_14_RAG_VIBE_CODING/app.py`](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/app.py) (Modular RAG API), [`Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py`](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py) (RAG Chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generation["Test Generation"]
  node_test_api["Generation API<br/>[app.py]"]
  node_case_generator["Case Generator"]
  node_converter_ui["Converter UI<br/>[App.tsx]"]
  node_converter_server["Conversion Server<br/>[server.js]"]
end

subgraph group_apps["QA Applications"]
  node_job_app["Job Tracker<br/>[App.tsx]"]
  node_kanban["Kanban Board<br/>[KanbanColumn.tsx]"]
  node_job_modal["Job Editor<br/>[JobModal.tsx]"]
  node_statistics["Job Statistics<br/>[Statistics.tsx]"]
  node_job_storage[("Local Persistence<br/>[useLocalStorage.ts]")]
  node_plan_agent["JIRA Test Agent"]
end

subgraph group_retrieval["RAG Systems"]
  node_modular_rag["Modular RAG API<br/>[app.py]"]
  node_rag_ingest["Document Ingestion<br/>[ingester.py]"]
  node_rag_generator["Answer Generation<br/>[generator.py]"]
  node_chroma[("ChromaDB<br/>[ingester.py]")]
  node_rag_explorer["RAG Explorer API<br/>[app.py]"]
  node_document_processing["Load and Chunk<br/>[ingest.py]"]
  node_embedding["Embeddings<br/>[embed.py]"]
  node_vector_store[("Vector Store<br/>[store.py]")]
  node_rag_chat["RAG Chat<br/>[chat.py]"]
end

subgraph group_evaluation["AI Evaluation"]
  node_verifier["Metric Verifier<br/>[app.py]"]
  node_verifier_v2["Guided Verifier<br/>[app.py]"]
  node_lessons["Metric Lessons<br/>[metric_lessons.py]"]
  node_eval_dashboard["Evaluation Dashboard<br/>[app.py]"]
  node_metric_registry["Metric Registry<br/>[registry.py]"]
  node_metric_runner["Metric Runner<br/>[runner.py]"]
end

node_tester(("QA Engineer"))
node_local_llm{{"Ollama"}}

node_tester -->|"submits story"| node_test_api
node_test_api -->|"calls generator"| node_case_generator
node_tester -.->|"provides source"| node_converter_ui
node_converter_ui -.->|"sends conversion"| node_converter_server
node_converter_server -.->|"uses model"| node_local_llm
node_tester -.->|"tracks applications"| node_job_app
node_job_app -->|"renders board"| node_kanban
node_job_app -->|"opens editor"| node_job_modal
node_job_app -->|"renders statistics"| node_statistics
node_job_app -.->|"persists jobs"| node_job_storage
node_tester -.->|"requests test plan"| node_plan_agent
node_tester -->|"uploads and asks"| node_modular_rag
node_modular_rag -->|"ingests upload"| node_rag_ingest
node_rag_ingest -->|"writes chunks"| node_chroma
node_modular_rag -->|"generates answer"| node_rag_generator
node_tester -.->|"explores documents"| node_rag_explorer
node_rag_explorer -->|"loads and chunks"| node_document_processing
node_rag_explorer -->|"embeds query"| node_embedding
node_rag_explorer -->|"searches chunks"| node_vector_store
node_rag_explorer -.->|"serves chat"| node_rag_chat
node_rag_chat -->|"embeds query"| node_embedding
node_rag_chat -->|"retrieves context"| node_vector_store
node_tester -->|"scores responses"| node_verifier
node_tester -.->|"practices metrics"| node_verifier_v2
node_verifier_v2 -->|"uses lessons"| node_lessons
node_tester -.->|"runs evaluations"| node_eval_dashboard
node_eval_dashboard -->|"lists metrics"| node_metric_registry
node_eval_dashboard -->|"runs metric"| node_metric_runner

click node_test_api "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_01_LocalTestCaseGenerator/backend/app.py"
click node_case_generator "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_01_LocalTestCaseGenerator/tools/generate_test_cases.py"
click node_converter_ui "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_02_Selenium2PlaywrightLocalLLM/ui/src/App.tsx"
click node_converter_server "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_02_Selenium2PlaywrightLocalLLM/server.js"
click node_job_app "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx"
click node_kanban "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/KanbanColumn.tsx"
click node_job_modal "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/JobModal.tsx"
click node_statistics "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/Statistics.tsx"
click node_job_storage "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/hooks/useLocalStorage.ts"
click node_plan_agent "https://github.com/pramoddutta/aitesterblueprint/tree/main/Project_07_TestPlan_AI_AGENT_JIRA/intelligent-test-plan-agent/backend/src"
click node_modular_rag "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/app.py"
click node_rag_ingest "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/rag/ingester.py"
click node_rag_generator "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/rag/generator.py"
click node_chroma "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/rag/ingester.py"
click node_rag_explorer "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/app.py"
click node_document_processing "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/ingest.py"
click node_embedding "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/embed.py"
click node_vector_store "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/store.py"
click node_rag_chat "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py"
click node_verifier "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_21_DeepEval_SDET/verifier/app.py"
click node_verifier_v2 "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_21_DeepEval_SDET/verifier_v2/app.py"
click node_lessons "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_21_DeepEval_SDET/verifier_v2/metric_lessons.py"
click node_eval_dashboard "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/app.py"
click node_metric_registry "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/registry.py"
click node_metric_runner "https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/runner.py"

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_test_api,node_case_generator,node_converter_ui,node_converter_server toneBlue
class node_job_app,node_kanban,node_job_modal,node_statistics,node_job_storage,node_plan_agent toneAmber
class node_modular_rag,node_rag_ingest,node_rag_generator,node_chroma,node_rag_explorer,node_document_processing,node_embedding,node_vector_store,node_rag_chat toneMint
class node_verifier,node_verifier_v2,node_lessons,node_eval_dashboard,node_metric_registry,node_metric_runner toneRose
class node_tester,node_local_llm toneIndigo
```

## Components

### Test Generation

- [Generation API](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_01_LocalTestCaseGenerator/backend/app.py): `Project_01_LocalTestCaseGenerator/backend/app.py`
- [Case Generator](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_01_LocalTestCaseGenerator/tools/generate_test_cases.py): `Project_01_LocalTestCaseGenerator/tools/generate_test_cases.py`
- [Converter UI](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_02_Selenium2PlaywrightLocalLLM/ui/src/App.tsx): `Project_02_Selenium2PlaywrightLocalLLM/ui/src/App.tsx`
- [Conversion Server](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_02_Selenium2PlaywrightLocalLLM/server.js): `Project_02_Selenium2PlaywrightLocalLLM/server.js`

### QA Applications

- [Job Tracker](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx): `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx`
- [Kanban Board](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/KanbanColumn.tsx): `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/KanbanColumn.tsx`
- [Job Editor](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/JobModal.tsx): `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/JobModal.tsx`
- [Job Statistics](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/Statistics.tsx): `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/components/Statistics.tsx`
- [Local Persistence](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/hooks/useLocalStorage.ts): `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/hooks/useLocalStorage.ts`
- [JIRA Test Agent](https://github.com/pramoddutta/aitesterblueprint/tree/main/Project_07_TestPlan_AI_AGENT_JIRA/intelligent-test-plan-agent/backend/src): `Project_07_TestPlan_AI_AGENT_JIRA/intelligent-test-plan-agent/backend/src`

### RAG Systems

- [Modular RAG API](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/app.py): `Project_14_RAG_VIBE_CODING/app.py`
- [Document Ingestion](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/rag/ingester.py): `Project_14_RAG_VIBE_CODING/rag/ingester.py`
- [Answer Generation](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/rag/generator.py): `Project_14_RAG_VIBE_CODING/rag/generator.py`
- [ChromaDB](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_14_RAG_VIBE_CODING/rag/ingester.py): `Project_14_RAG_VIBE_CODING/rag/ingester.py`
- [RAG Explorer API](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/app.py): `Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`
- [Load and Chunk](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/ingest.py): `Project_23_DeepEvAL_Framework/02_rag_explorer/rag/ingest.py`
- [Embeddings](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/embed.py): `Project_23_DeepEvAL_Framework/02_rag_explorer/rag/embed.py`
- [Vector Store](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/store.py): `Project_23_DeepEvAL_Framework/02_rag_explorer/rag/store.py`
- [RAG Chat](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py): `Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py`

### AI Evaluation

- [Metric Verifier](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_21_DeepEval_SDET/verifier/app.py): `Project_21_DeepEval_SDET/verifier/app.py`
- [Guided Verifier](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_21_DeepEval_SDET/verifier_v2/app.py): `Project_21_DeepEval_SDET/verifier_v2/app.py`
- [Metric Lessons](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_21_DeepEval_SDET/verifier_v2/metric_lessons.py): `Project_21_DeepEval_SDET/verifier_v2/metric_lessons.py`
- [Evaluation Dashboard](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/app.py): `Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/app.py`
- [Metric Registry](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/registry.py): `Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/registry.py`
- [Metric Runner](https://github.com/pramoddutta/aitesterblueprint/blob/main/Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/runner.py): `Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/runner.py`

### Other components

- **QA Engineer**
- **Ollama**

## Connections

- QA Engineer → Generation API: submits story (evidence: `Project_01_LocalTestCaseGenerator/backend/app.py`)
- Generation API → Case Generator: calls generator (evidence: `Project_01_LocalTestCaseGenerator/backend/app.py`)
- QA Engineer → Converter UI: provides source (evidence: `README.md`)
- Converter UI → Conversion Server: sends conversion
- Conversion Server → Ollama: uses model (evidence: `README.md`)
- QA Engineer → Job Tracker: tracks applications (evidence: `README.md`)
- Job Tracker → Kanban Board: renders board (evidence: `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx`)
- Job Tracker → Job Editor: opens editor (evidence: `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx`)
- Job Tracker → Job Statistics: renders statistics (evidence: `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx`)
- Job Tracker → Local Persistence: persists jobs (evidence: `Project_05_ClaudeCodeJobAssistantBoard/job-board-assistant/src/App.tsx`)
- QA Engineer → JIRA Test Agent: requests test plan (evidence: `README.md`)
- QA Engineer → Modular RAG API: uploads and asks (evidence: `Project_14_RAG_VIBE_CODING/app.py`)
- Modular RAG API → Document Ingestion: ingests upload (evidence: `Project_14_RAG_VIBE_CODING/app.py`)
- Document Ingestion → ChromaDB: writes chunks (evidence: `Project_14_RAG_VIBE_CODING/rag/ingester.py`)
- Modular RAG API → Answer Generation: generates answer (evidence: `Project_14_RAG_VIBE_CODING/app.py`)
- QA Engineer → RAG Explorer API: explores documents (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`)
- RAG Explorer API → Load and Chunk: loads and chunks (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`)
- RAG Explorer API → Embeddings: embeds query (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`)
- RAG Explorer API → Vector Store: searches chunks (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`)
- RAG Explorer API → RAG Chat: serves chat (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/app.py`)
- RAG Chat → Embeddings: embeds query (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py`)
- RAG Chat → Vector Store: retrieves context (evidence: `Project_23_DeepEvAL_Framework/02_rag_explorer/rag/chat.py`)
- QA Engineer → Metric Verifier: scores responses (evidence: `Project_21_DeepEval_SDET/verifier/app.py`)
- QA Engineer → Guided Verifier: practices metrics (evidence: `Project_21_DeepEval_SDET/verifier_v2/app.py`)
- Guided Verifier → Metric Lessons: uses lessons (evidence: `Project_21_DeepEval_SDET/verifier_v2/app.py`)
- QA Engineer → Evaluation Dashboard: runs evaluations (evidence: `Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/app.py`)
- Evaluation Dashboard → Metric Registry: lists metrics (evidence: `Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/app.py`)
- Evaluation Dashboard → Metric Runner: runs metric (evidence: `Project_23_DeepEvAL_Framework/03_deepeval_framework/dashboard/app.py`)
