Core concepts
The entities Qualflare is built on, from workspaces and projects to test cases, suites, plans, launches, defects and AI features, and how they relate.
Last updated
In Qualflare, a workspace holds your team, its plan and its projects, and each project holds its own test cases, launches, defects and settings; people get one of five roles, from Guest to Owner.
The entities fall into four groups: organizational (who has access to what), testing (what you're going to test and how it's organized), execution (what happened when you ran it), and AI & automation (what Qualflare infers on top of your results). Each row below links to the page that covers that entity, where there is one.
Entity hierarchy
Workspace
├── Members and roles
├── Tags
├── Integrations (installed here, set up per project)
├── Audit Logs
└── Project
├── Test Suites
│ └── Test Cases
│ └── Test Steps
├── Shared Steps
├── Test Plans
├── Saved queries
├── Milestones
├── Launches (test runs)
│ └── Suite Runs
│ └── Case Runs
├── Defects
├── Failure Clusters (AI)
├── AI Insights
├── Teams
├── Environments
└── Access TokensOrganizational entities
| Entity | Description | Link |
|---|---|---|
| Workspace | The top-level container for your projects, members, plan and integrations | Workspaces and Workspace Settings |
| Project | An isolated space for test assets, results and settings | Create and manage projects |
| Users and roles | Team members, each with one of five roles from Guest to Owner | Roles and permissions |
| Team | A named group of project members that suites and defects can be assigned to | Project teams |
| Tag | A label for test cases, managed once per workspace on Tags and shared by its projects | — |
| Audit log | A record of workspace activity for compliance and security | Audit Logs |
Testing entities
| Entity | Description | Link |
|---|---|---|
| Test case | An individual test scenario with steps and expected results | Test Cases |
| Test suite | A group of related test cases | Test Suites |
| Test plan | A structured plan for executing a set of test cases | Test Plans |
| Shared steps | Reusable step sequences referenced across multiple cases | Shared Steps |
| Saved query | A named filter on the Explore page, shared with every project member | Explore Cases and saved queries |
Execution and QA entities
| Entity | Description | Link |
|---|---|---|
| Launch | A test run containing the results of executing test cases | Launches |
| Case run | The result of running a single test case in a launch | Case Runs |
| Defect | A tracked bug or issue linked to a failed test | Defects |
| Milestone | A release or project milestone that groups launches | Milestones |
| Environment | A named target system (Dev, Staging, Production) that a launch runs against | Environments |
AI and automation
| Entity | Description | Link |
|---|---|---|
| AI features | An overview of the Quo agent, launch analysis, failure clusters, the AI filter and Insights | AI in Qualflare |
| Quo agent | AI assistant for coverage analysis and test generation | Quo agent |
| AI launch analysis | An automatic summary after each launch, with a risk level, failing areas and recommendations | AI Launch Analysis |
| Failure cluster | AI-grouped similar test failures with root cause analysis | Failure Clusters |
| AI filter | Plain-English searches on the Explore page, translated into structured filters | AI filter in Explore |
| AI Insights | Recommendations that flag flaky and redundant test cases | AI Insights |
| Claude Code plugin | Generate tests, run your suite, upload results and fix failures from Claude Code | Claude Code plugin |
Related
- Guides: Quickstart · Test management overview · Run tests: manual and automated
- Reference: Glossary · Roles and permissions · FAQ
- CLI and API: Qualflare CLI · API & MCP
Quickstart
Get started with Qualflare in minutes: create your first test case, install the qf CLI, upload a test results file and open the launch it creates.
Search, filters and shortcuts
Filter Qualflare lists with key:value tokens, save Explore queries, and jump to any page with the command palette and keyboard shortcuts.