SmartestQADocs
REQUIREMENTS

Analyze (Requirements)

Manage your requirements, map them to test cases, and track coverage. Use the built-in AI tools to generate requirements from documents, assess quality, and automate test case creation.

Overview

The Analyze module is your requirements management hub. You can define requirements manually or import a document and let AI generate them automatically. Once created, map requirements to test cases, track coverage, view traceability, and run AI quality assessments.

Requirements

Define & organize

AI Generation

From documents

Mapping

Link to test cases

Traceability

Full matrix view

Page Layout

The page is divided into three panels:

Left — Tree Panel

Folder-based requirement tree. The + New button at the top opens a dropdown with three options:

  • New Requirement — create a requirement
  • Create Folder — add a folder
  • Add New Document — attach a document node

Center — Requirement Detail

Shows the Requirement Detail form when a requirement is selected:

  • Name & Description fields
  • Sub Requirements list (+ Add / Generate)
  • ID, Created by, Updated by info
  • Save button

When a folder is selected, shows the AI Import / Document Structure / AI Generated tabs instead.

Right — Info Panel

Has two tabs:

  • Detail — Status, Severity, Assignee, Start/End Date, Test Cases, Comments
  • AI — AI Assessment (quality score & suggestions)

Drawer / Fixed Panel Toggle: The right panel can be toggled between fixed (always visible) and drawer (slide-in on demand) mode using the pin icon at the top right. Your preference is saved automatically.

Creating Requirements

Click the + New button in the tree panel and select "New Requirement" from the dropdown.

CENTER Requirement Detail (center panel)

e.g. User should be able to login
e.g. Registered users can log in...
Sub Requirements
+ Add ✨ Generate
No Sub Requirements
ID: 512   Created by: User | date

RIGHT Detail Tab (right panel)

Test Cases + Add

You can add existing test cases to requirements

Comments

There are no comments yet.

Severity Levels

Critical

Business critical

High

Priority testing

Medium

Normal priority

Low

Nice to have

Sub Requirements

A main requirement can be broken down into smaller, testable sub requirements. Open a requirement, then use the Sub Requirements section in the center panel.

Manual Add

Click the "+ Add" button to open the sub requirement dialog. Fill in:

  • Name (required)
  • Description (required)
  • Status, Severity
  • Assignee, Start/End Date

AI Generate AI

Click the "Generate" button next to the Sub Requirements header. AI analyzes the main requirement's name and description and proposes 3–5 sub requirements automatically.

You can preview each generated sub requirement, select which ones to add using checkboxes, and then save them all at once.

Sub Requirements

Valid Login Credentials

User logs in with correct email and password

New High

Invalid Password Error

Error message shown on wrong password

New Medium

Tip: Clicking on a sub requirement in the list selects it, which updates the right panel to show only the test cases linked to that specific sub requirement.

AI Import & Analyze AI

When you select a folder in the tree (not a specific requirement), the center panel shows three AI-powered tabs: Import & Analyze, Document Structure, and AI Generated. This workflow lets you upload a document and have AI generate a full requirement hierarchy automatically.

1 Tab: Import & Analyze

Supported File Formats
PDF DOCX / DOC TXT MD / Markdown HTML / HTM JSON CSV / TSV YAML / YML XML
AI Analysis Preferences

Before running the analysis, configure how the AI should interpret your document:

Setting Options Description
Coverage Depth Minimal · Standard · Comprehensive How many requirements and test cases to generate per topic
Negative Test Intensity Low · Medium · High How many negative/edge-case test scenarios to include
Default Priority Low · Medium · High Default severity assigned to generated requirements
Requirement Type Functional · Non-Functional · Both Types of requirements to extract from the document
Additional Instructions Free text Optional instructions to guide the AI analysis
Entity Generation Options

Choose which entities the AI should generate. They are hierarchically linked — enabling a lower level automatically enables its parents:

Requirement (always on)
Sub Requirement
Test Case
Test Step
Analysis Flow
Small Document (< 20,000 chars)

The entire document is analyzed in a single AI call. Requirements are generated immediately and you are taken to the AI Generated tab to review results.

Large Document (> 20,000 chars)

The document is first split into logical modules (e.g., chapters or feature areas). You are taken to the Document Structure tab to analyze each module separately.

Auto-save: The uploaded file and your preferences are automatically saved per folder. Switching back to the folder later will restore your previous file and settings.

2 Tab: Document Structure (large documents only)

When a large document is uploaded, the AI first extracts its logical modules (sections, chapters, feature areas). This tab shows each module with its name, description, and estimated number of requirements.

Authentication Module

Login, logout, password reset flows

~8 reqs ✓ 8 reqs

User Management Module

Profile, roles, permissions

~12 reqs Analyzing...

Reporting Module

Reports, exports, dashboards

~6 reqs
1/3

Analysis progress bar — shows how many modules are completed.

Click "Analyze All" to process all pending/failed modules sequentially. Each module is analyzed one by one with a short delay between requests. When all modules are done, click "View Requirements" to switch to the AI Generated tab.

Warning: Do not refresh the page or navigate away during analysis. An alert banner is shown while analysis is in progress. The browser will also prompt you before unloading the page.

3 Tab: AI Generated AI

After analysis is complete, this tab shows all AI-generated requirements. Each requirement is shown with its name, description, severity, and any generated sub requirements and test cases.

User Login with Email and Password

Authentication • High severity

3 sub-reqs 5 test cases
↳ Sub: Valid credentials login  |  Invalid password error  |  Account lockout after retries

Password Reset Flow

Authentication • Medium severity

2 sub-reqs 4 test cases

Use the checkboxes to select which requirements (and which parent groups) to save. Then click "Save Selected" to create them in the system. The requirements, their sub requirements, and linked test cases are all saved at once.

Draft persistence: Generated results are saved as a draft per folder. If you navigate away and come back, your results will still be there for review.

Testcase Mapping

Link test cases to sub requirements to track which tests cover each requirement. Test cases can be linked from two places:

From Requirements page

Select a sub requirement, then click the "Link Test Case" button in the right panel. A dialog opens with your test case list to choose from.

From Test Case page

Open a test case and go to the "Requirements" tab to link it to one or more requirements.

REQ-001

User should be able to login with email and password

3 Tests Linked

TC-101: Login Happy Path

Login with correct email/password

PASS

TC-102: Login - Wrong Password

Wrong password error message

PASS

TC-103: Login - Empty Fields

Empty field validation

FAIL

AI Assessment AI

The right panel has an "AI Assessment" tab. This feature evaluates the quality of a requirement (main or sub) and provides a score, a summary, and actionable improvement suggestions.

How to use

  1. 1

    Select a requirement (main or sub) from the list.

  2. 2

    Switch to the "AI Assessment" tab in the right panel.

  3. 3

    Click "Analyze". Save any unsaved changes first — the button is disabled if there are unsaved edits.

  4. 4

    Review the quality score, summary, and suggestions.

Quality Score
72%
Good
Add acceptance criteria to make the requirement testable.
Specify the expected response time for login.

Score Breakdown (for main requirements)

For main requirements, the assessment also shows a breakdown of the coverage score (are sub requirements linked to test cases?) and the average quality score of all sub requirements. Any sub requirements that have not yet been assessed are listed in a warning.

85%

Overall Score

90%

Coverage Score

78%

Sub-Req Average

Persistence: Assessment scores and suggestions are saved to the requirement. When you re-open a requirement with a saved assessment, it loads automatically without needing to re-run.

Automate Requirement AI

The "Automate" button on a sub requirement opens the Automate Requirement modal. This AI feature analyzes the sub requirement and generates test cases with test steps ready to be saved to your test library.

How it works

  1. 1

    Select a sub requirement in the list.

  2. 2

    Click the "Automate" icon button () on the sub requirement row.

  3. 3

    Click "Analyze" in the dialog. AI generates test cases with steps and coverage info.

  4. 4

    Select which test cases to save using checkboxes, then click "Save".

Generated Test Case Example

TC: Valid login with correct credentials

Step 1: Navigate to login page

Step 2: Enter valid email

Step 3: Enter valid password

Step 4: Click Login — Expected: Dashboard shown

Coverage: 100%