How hanish9193/agentic-ai-automation-handoff works
This is an AI test-automation platform: users create projects and ingest requirements, generate and review scenarios and test cases, then generate Playwright scripts, execute tests, analyze failures, and review reports. FastAPI serves the browser UI and API; a LangGraph workflow routes shared state through specialized agents, while services handle execution, persistence, security, and integrations. The README documents major capabilities beyond the sampled code; edges for those are documented relationships, not claims that unsampled implementations were inspected.
Main entry points: workflow.py LangGraph workflow · main.py REST API · project_repository.py Project repository · batch_queue_manager.py Batch execution
Components 27
User product
- Web dashboard
frontend/js/app.js - REST API
backend/main.py - Project workspace
backend/services/project_service.py - Reports and metrics
backend/services/report_service.py
AI workflow
- Requirements
backend/models/requirement.py - Workflow service
backend/services/workflow_service.py - LangGraph workflow
backend/graph/workflow.py - Scenario generation
backend/agents/scenario_agent.py - Test case generation
backend/agents/supervisor_agent.py - Quality evaluation
backend/agents/evaluation_agent.py - Human review
backend/agents/human_approval_agent.py - Script generation
backend/agents/playwright_agent.py - Workflow state
backend/models/state.py
Test execution
- Batch execution
backend/services/batch_queue_manager.py - Playwright runner
backend/services/playwright_runner.py - Runner API
backend/playwrightt/app/api/execute/route.ts - Execution engine
backend/playwrightt/lib/execution-engine.ts - Failure analysis
backend/agents/execution_analysis_agent.py
Platform services
- Project repository
backend/repository/project_repository.py - PostgreSQL repository
backend/repository/postgres_project_repository.py - JSON store
backend/repository/project_repository.py - Authentication
backend/services/auth_service.py
Integrations
- JIRA integration
backend/services/jira_service.py - RAG knowledge base
backend/services/rag_service.py - LLM providers
backend/services/llm.py
Other components
- QA user
- Target application
Connections 34
- QA user → Web dashboard: uses
README.md - Web dashboard → REST API: HTTP requests
README.md - REST API → Project workspace: manages projects
backend/main.py - REST API → Workflow service: starts workflows
backend/main.py - REST API → Authentication: authenticates
backend/main.py - REST API → Reports and metrics: serves metrics
backend/main.py - REST API → Project repository: stores records
backend/main.py - Project workspace → Project repository: persists projects
- Project repository → JSON store: reads and writes
backend/repository/project_repository.py - Project repository → PostgreSQL repository: selects provider
backend/repository/project_repository.py - Workflow service → LangGraph workflow: invokes workflow
- LangGraph workflow → Workflow state: routes state
backend/graph/workflow.py - LangGraph workflow → Scenario generation: dispatches
backend/graph/workflow.py - LangGraph workflow → Test case generation: dispatches
backend/graph/workflow.py - LangGraph workflow → Quality evaluation: dispatches
backend/graph/workflow.py - LangGraph workflow → Human review: dispatches
backend/graph/workflow.py - LangGraph workflow → Script generation: dispatches
backend/graph/workflow.py - Requirements → LangGraph workflow: starts pipeline
README.md - LangGraph workflow → Scenario generation: generates scenarios
README.md - LangGraph workflow → Test case generation: creates test cases
README.md - LangGraph workflow → Quality evaluation: scores quality
README.md - LangGraph workflow → Human review: requests review
README.md - LangGraph workflow → Script generation: generates scripts
README.md - Script generation → Batch execution: queues approved tests
- Batch execution → Playwright runner: runs scripts
backend/services/batch_queue_manager.py - Playwright runner → Runner API: delegates execution
- Runner API → Execution engine: starts execution
- Execution engine → Target application: drives browser
- Batch execution → Project repository: loads test scripts
backend/services/batch_queue_manager.py - LangGraph workflow → Failure analysis: analyzes failures
README.md - LangGraph workflow → Reports and metrics: produces results
README.md - LangGraph workflow → JIRA integration: syncs issues
README.md - LangGraph workflow → LLM providers: requests completions
- LangGraph workflow → RAG knowledge base: retrieves context
README.md