Core concepts

Sulu's domain model is small. These are the entities you'll see throughout the UI and the docs.

Workspace

A tenant container. Every project belongs to exactly one workspace. Workspaces have projects and members with a workspace role — Owner, Member, or Guest (a free, read-only, project-scoped role). See Permissions.

Project

The unit of work for a QA team. A project owns its own test cases, custom fields, attribute trees, members, launches, and API tokens. Soft-deletable.

TestCase

A persistent test scenario — name, steps, custom fields, tags, automation status. Lives inside one project. Soft-deletable (Trash + Restore).

Launch

A test execution run. Independent dimensions:

• Execution state: IN_PROGRESS → FINISHED / STOPPED / INTERRUPTED
• Closed: a read-only freeze applied after the run is fully triaged.

A Launch contains many TestResults.

TestResult

One outcome inside a Launch — a single test case's pass/fail/skip/broken/unknown for that run. Linked back to its TestCase.

TestStatus

A test result's outcome: PENDING, PASSED, FAILED, SKIPPED, BROKEN, UNKNOWN.

TestCaseStatus

A test case's authoring lifecycle: DRAFT, ACTIVE, REVIEW, OUTDATED. (Different from a TestResult's outcome — one is about the test definition, the other about a single execution.)

ProjectCustomField

Per-project metadata field on test cases. Each project owns its own fields — there's no global registry. Types: text, single-select, multi-select, date, user, link.

ProjectTree

An ordered list of custom-field IDs that defines a hierarchy. Picking a tree changes how test cases are grouped in the tree view.

Folder

A manual, nestable container for test cases — the alternative to attribute trees for organizing a project. Each project picks one mode; switching is non-destructive. See Folders.

Tag

A colored label from a project's tag registry. Tags are picked (not typed free-form) and shared across test cases, launches, and defects.

Defect

A first-class bug record inside a project, with a status and links to the test cases and results it affects, optionally tied to a Jira issue. See Defects.

Group

A workspace-scoped, admin-managed set of users that can be attached to projects with a role. Useful for "QA team has Read on all projects" patterns.