# c1oudreamw/ai-testcase-manager architecture

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

- Interactive diagram: https://gitdiagram.com/c1oudreamw/ai-testcase-manager
- Repository: https://github.com/c1oudreamw/ai-testcase-manager

## Overview

This is an AI-assisted test-case generation and management platform. Users import requirements and design assets, confirm extracted feature points, generate cases through a resumable workflow, review and quality-check them before accepting them into the library, then run test tasks and evaluate regressions. The system also provides project knowledge retrieval and a read-only AI assistant. The README documents these product flows; source excerpts and the index substantiate selected routing, model, persistence, and UI relationships, but many backend handlers and workflow internals were not sampled.

Main entry points: [`backend/app/main.py`](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/workflows/generation`](https://github.com/c1oudreamw/ai-testcase-manager/tree/main/backend/app/workflows/generation) (Generation workflow), [`backend/app/api/evaluations.py`](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/evaluations.py) (Quality and evaluation), [`frontend/src/services/api.js`](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/services/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web["Application routes<br/>[App.jsx]"]
  node_generate_ui["Generation wizard<br/>[GenerateFlow.jsx]"]
  node_review_ui["Case review UI<br/>[StepReview.jsx]"]
  node_mindmap["Case mindmap"]
  node_task_ui["Test task UI"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API and domain"]
  node_api_server["FastAPI application<br/>[main.py]"]
  node_requirements["Requirements and designs<br/>[requirements.py]"]
  node_generations["Generation endpoints<br/>[generations.py]"]
  node_testcases["Case library<br/>[testcases.py]"]
  node_test_tasks["Test tasks<br/>[test_tasks.py]"]
end

subgraph group_generation["Generation and quality"]
  node_generation_flow["Generation workflow"]
  node_skills["Skill plugins"]
  node_quality["Quality and evaluation<br/>[evaluations.py]"]
end

subgraph group_knowledge["Knowledge and AI"]
  node_knowledge_api["Knowledge service<br/>[knowledge.py]"]
  node_retrieval["Hybrid retrieval<br/>[retrievers.py]"]
  node_agent["AI test assistant<br/>[runner.py]"]
end

subgraph group_platform["Platform services"]
  node_model_calls["LLM integration<br/>[llm.py]"]
  node_settings["Model settings"]
  node_database[("Application database<br/>[database.py]")]
  node_auth["Authentication<br/>[auth.py]"]
end

node_user(("Test team"))

node_user -->|"uses"| node_web
node_web -->|"routes to"| node_generate_ui
node_generate_ui -.->|"requests data"| node_api_client
node_review_ui -->|"renders"| node_mindmap
node_task_ui -->|"requests tasks"| node_api_client
node_api_client -->|"calls API"| node_api_server
node_api_server -->|"routes requests"| node_requirements
node_api_server -->|"routes requests"| node_generations
node_api_server -->|"routes requests"| node_testcases
node_api_server -->|"routes requests"| node_test_tasks
node_api_server -->|"routes requests"| node_quality
node_api_server -->|"routes requests"| node_knowledge_api
node_api_server -->|"routes requests"| node_agent
node_requirements -.->|"starts generation"| node_generation_flow
node_generation_flow -.->|"uses skills"| node_skills
node_generation_flow -.->|"calls models"| node_model_calls
node_generation_flow -.->|"retrieves context"| node_retrieval
node_generation_flow -.->|"quality checks"| node_quality
node_quality -.->|"accepts cases"| node_testcases
node_knowledge_api -.->|"searches knowledge"| node_retrieval
node_agent -.->|"uses models"| node_model_calls
node_settings -->|"configures models"| node_model_calls
node_api_server -->|"authenticates requests"| node_auth
node_api_server -->|"initializes"| node_database
node_user -->|"imports PRD and designs"| node_requirements
node_generation_flow -.->|"stores accepted cases"| node_testcases
node_test_tasks -.->|"persists tasks"| node_database
node_user -->|"runs evaluations"| node_quality

click node_web "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/App.jsx"
click node_generate_ui "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/pages/GenerateFlow.jsx"
click node_review_ui "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/pages/generate/StepReview.jsx"
click node_mindmap "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/components/TestCaseMindmap.jsx"
click node_task_ui "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/pages/ProjectTestTasks.jsx"
click node_api_client "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/services/api.js"
click node_api_server "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/main.py"
click node_requirements "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/requirements.py"
click node_generations "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/generations.py"
click node_testcases "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/testcases.py"
click node_test_tasks "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/test_tasks.py"
click node_generation_flow "https://github.com/c1oudreamw/ai-testcase-manager/tree/main/backend/app/workflows/generation"
click node_skills "https://github.com/c1oudreamw/ai-testcase-manager/tree/main/backend/app/skills"
click node_quality "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/evaluations.py"
click node_knowledge_api "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/knowledge.py"
click node_retrieval "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/ai/retrievers.py"
click node_agent "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/agent/runner.py"
click node_model_calls "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/services/llm.py"
click node_settings "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/services/settings_service.py"
click node_database "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/database.py"
click node_auth "https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/auth.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_web,node_generate_ui,node_review_ui,node_mindmap,node_task_ui,node_api_client toneBlue
class node_api_server,node_requirements,node_generations,node_testcases,node_test_tasks toneAmber
class node_generation_flow,node_skills,node_quality toneMint
class node_knowledge_api,node_retrieval,node_agent toneRose
class node_model_calls,node_settings,node_database,node_auth,node_user toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Generation wizard](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/pages/GenerateFlow.jsx): `frontend/src/pages/GenerateFlow.jsx`
- [Case review UI](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/pages/generate/StepReview.jsx): `frontend/src/pages/generate/StepReview.jsx`
- [Case mindmap](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/components/TestCaseMindmap.jsx): `frontend/src/components/TestCaseMindmap.jsx`
- [Test task UI](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/pages/ProjectTestTasks.jsx): `frontend/src/pages/ProjectTestTasks.jsx`
- [API client](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and domain

- [FastAPI application](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/main.py): `backend/app/main.py`
- [Requirements and designs](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/requirements.py): `backend/app/api/requirements.py`
- [Generation endpoints](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/generations.py): `backend/app/api/generations.py`
- [Case library](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/testcases.py): `backend/app/api/testcases.py`
- [Test tasks](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/test_tasks.py): `backend/app/api/test_tasks.py`

### Generation and quality

- [Generation workflow](https://github.com/c1oudreamw/ai-testcase-manager/tree/main/backend/app/workflows/generation): `backend/app/workflows/generation`
- [Skill plugins](https://github.com/c1oudreamw/ai-testcase-manager/tree/main/backend/app/skills): `backend/app/skills`
- [Quality and evaluation](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/evaluations.py): `backend/app/api/evaluations.py`

### Knowledge and AI

- [Knowledge service](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/knowledge.py): `backend/app/api/knowledge.py`
- [Hybrid retrieval](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/ai/retrievers.py): `backend/app/ai/retrievers.py`
- [AI test assistant](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/agent/runner.py): `backend/app/agent/runner.py`

### Platform services

- [LLM integration](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/services/llm.py): `backend/app/services/llm.py`
- [Model settings](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/services/settings_service.py): `backend/app/services/settings_service.py`
- [Application database](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/database.py): `backend/app/database.py`
- [Authentication](https://github.com/c1oudreamw/ai-testcase-manager/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`

### Other components

- **Test team**

## Connections

- Test team → Application routes: uses (evidence: `README.md`)
- Application routes → Generation wizard: routes to (evidence: `frontend/src/App.jsx`)
- Generation wizard → API client: requests data
- Case review UI → Case mindmap: renders (evidence: `frontend/src/pages/generate/StepReview.jsx`)
- Test task UI → API client: requests tasks (evidence: `frontend/src/pages/ProjectTestTasks.jsx`)
- API client → FastAPI application: calls API (evidence: `frontend/src/services/api.js`)
- FastAPI application → Requirements and designs: routes requests (evidence: `backend/app/main.py`)
- FastAPI application → Generation endpoints: routes requests (evidence: `backend/app/main.py`)
- FastAPI application → Case library: routes requests (evidence: `backend/app/main.py`)
- FastAPI application → Test tasks: routes requests (evidence: `backend/app/main.py`)
- FastAPI application → Quality and evaluation: routes requests (evidence: `backend/app/main.py`)
- FastAPI application → Knowledge service: routes requests (evidence: `backend/app/main.py`)
- FastAPI application → AI test assistant: routes requests (evidence: `backend/app/main.py`)
- Requirements and designs → Generation workflow: starts generation
- Generation workflow → Skill plugins: uses skills
- Generation workflow → LLM integration: calls models
- Generation workflow → Hybrid retrieval: retrieves context
- Generation workflow → Quality and evaluation: quality checks
- Quality and evaluation → Case library: accepts cases
- Knowledge service → Hybrid retrieval: searches knowledge
- AI test assistant → LLM integration: uses models
- Model settings → LLM integration: configures models (evidence: `backend/app/services/llm.py`)
- FastAPI application → Authentication: authenticates requests (evidence: `backend/app/main.py`)
- FastAPI application → Application database: initializes (evidence: `backend/app/main.py`)
- Test team → Requirements and designs: imports PRD and designs (evidence: `README.md`)
- Generation workflow → Case library: stores accepted cases
- Test tasks → Application database: persists tasks
- Test team → Quality and evaluation: runs evaluations (evidence: `README.md`)
