Software Version Management

The Software Version Management feature enables version-level progress tracking and quality control by precisely associating tasks, test cases, and release versions.

Key Operations

I. Basic Version Operations

1. Create Software Version

Description: Define a new release cycle identifier
Steps:

1. Project → Project List → Edit
2. Switch to Software Version tab
3. Click "Add Version" button
4. Enter required fields:
   • Version name (unique identifier, ≤40 chars)
   • Planned start/release date
   • Version description (≤200 chars)
5. Click "Confirm" to save
   ⚠️ Naming convention: Recommended format Major.Minor.Revision

2. Modify Version Information

Description: Adjust version plan metadata
Steps:

1. Click "Edit" for target version in Version Management List
2. Editable fields:
   • Version name (must remain unique)
   • Time range (start/release date)
   • Description text
3. Click "Confirm" to update
   Release date changes automatically sync with associated tasks

3. Merge Versions

Description: Consolidate resources from multiple versions into target version
Steps:

1. Click "Merge Versions" above the list
2. Select source versions to merge (multiple allowed)
3. Specify target version
4. Click "Confirm" to execute merge
   ❗ Irreversible action: Source version resources will migrate to target version

II. Version Status Management

1. Release Version

Description: Activate version for task/case association
Steps:

1. Select planned version in Version List
2. Click "Release" action button
3. Confirm in popup by clicking "Continue"
   ✅ Status changes to "Released" and becomes visible in association menus

2. Archive Version

Description: Freeze completed versions
Steps:

1. Select released version in Version List
2. Click "Archive" action button
3. Confirm in popup by clicking "Continue"
   🚫 Archived versions:
   • Hidden from filters
   • Prevent new task/case associations
   • Retain historical data for traceability

3. Delete Version

Description: Permanently remove invalid versions
Steps:

1. Select target version in Version List
2. Click "Delete" action button
3. Enter version name for secondary verification
   ⚠️ Simultaneously removes all associations (tasks/cases remain independent)

III. Version Progress Monitoring

1. Track Task Progress

Description: Monitor completion status of version-associated tasks
Steps:

1. Open view via Tasks → Version
2. Click target version name to enter details page
3. View key metrics:
   • Progress dashboard (completion percentage)
   • Task status distribution (not started/in progress/completed)
   • Highlighted overdue tasks

2. Analyze Test Progress (TODO)

Description: Evaluate version test coverage quality
Steps:

1. Open view via Features → Version
2. Click target version name to enter details page
3. Key data dimensions:
   • Case pass rate (success/failure/blocked)
   • Defect density (defects per thousand lines of code)
   • Test progress trend chart

Version Field Information

Parameter	Field Name	Type	Required	Length	Description
ID	id	bigint	Cond.	/	Unique version ID; mandatory when modifying
Project ID	projectId	long	Yes	/	Parent project identifier
Version Name	name	string	Yes	≤40	Version label, e.g.: V1.0.0
Start Date	startDate	datetime	No	/	Development start date
Release Date	releaseDate	datetime	No	/	Official release date
Description	description	string	No	≤200	Functional description
Version Status	status	enum	Read-only	/	Status Enum: Not Released/Released/Archived
Progress Stats	progress	object	Read-only	/	Development progress metrics
Task Status Dist.	taskByStatus	map	Read-only	/	Task statistics by status
Creator ID	createdBy	long	Read-only	/	Version creator ID
Creator Name	createdByName	string	Read-only	/	Creator name
Creation Date	createdDate	datetime	Read-only	/	Version creation time
Last Modifier ID	lastModifiedBy	long	Read-only	/	Last editor ID
Last Modifier Name	lastModifiedByName	string	Read-only	/	Last editor name
Last Modified Date	lastModifiedDate	datetime	Read-only	/	Last edit timestamp

Version Status (status)

Enum Value	Description
NOT_RELEASED	Not Released
RELEASED	Released
ARCHIVED	Archived