Help Center/ CodeArts Req/ Best Practices/ Using IPD-System Device Projects to Perform a Baseline Review (BR) on a Smart Watch R&D Project
Updated on 2024-11-15 GMT+08:00

Using IPD-System Device Projects to Perform a Baseline Review (BR) on a Smart Watch R&D Project

Overview

A product goes through a complex R&D process from planning to release. CodeArts Req helps to manage these processes by requirement baselines, change requests of controlled fields, change reviews, and change management. Baseline changes must reach specified gate thresholds before going to the next stage to keep teams on the right track.

A company plans to launch a smart watch, which requires collaboration across departments and teams. R&D requirements have been assigned to each production and research team after rounds of communication and clarification on requirements. To ensure that products are delivered on time and with high quality, all R&D and production teams need to devotedly carry out tasks based on specified requirements. Therefore, baseline control for requirements is necessary and baselined requirements cannot be modified randomly. This sector describes how to use an IPD-system device project to simulate the smart watch R&D project to perform a BR.

Procedure

The basic operation process of the simulation case is as follows.

Figure 1 Basic operation process
Table 1 CodeArts Req baseline control process description

Process

Description

Step 1: Select Requirements and Initiate a BR

Select R&D requirements and initiate a BR.

Step 2: (Review Experts) Complete Review

Review experts complete review of the BR.

Step 3: (Reviewer) Complete Decision-making

Organize approver decision-making on the BR.

Step 4: Baseline the Requirements

After the BR, the R&D requirements become baselined.

Preparations

Before performing a specific task, you need to complete the following preparations:

  • The project owner has registered a HUAWEI ID and enabled Huawei Cloud services. For details, see My Account - Signing up for a HUAWEI ID and Enabling Huawei Cloud Services.
  • The project owner has created IAM users for project members. For details, see Creating an IAM User.
  • You can purchase either CodeArts or CodeArts Req.
    • Purchasing CodeArts

      To complete all operations in this practice, you need to purchase CodeArts Pro Edition.

      1. Go to the Buy CodeArts page.
      2. Select CodeArts Pro, retain the default value for Users, set Required Duration to 1 month, agree to the statement, and click Next.
      3. Confirm the order and click Pay.
      4. Follow the prompts to complete the payment.
      5. Check the subscription record on the CodeArts page.
  • Creating an IPD-System Device Project

    Before starting the BR, the product owner Sarah creates a project.

    1. Click Access Service on the CodeArts console.
    2. Click Create Project and select IPD-System Device.
    3. Enter the project name Smart Watch and click OK. The project is created.
  • Adding Project Members

    Sarah creates accounts for team members and adds them to the project.

    This practice involves the following project roles, as shown in Table 2.
    Table 2 Project roles

    Member

    Role

    Responsibility

    Sarah

    Project creator (product owner)

    Creates a project and sets up a team.

    Maggie

    Project manager

    Approves the BR.

    Chris

    Developer

    Initiates the BR.

    Frank

    Test manager

    Serves as the review expert of the BR.

    Billy

    Tester

    Serves as the review expert of the BR.

    1. Access the smart watch project. Choose Settings > General > Service Permissions > Member.
    2. Click Add Members above the project member list and choose Users from My Enterprise from the drop-down list.
      Figure 2 Adding members
    3. In the displayed dialog box, click Create User. The Users page is displayed.
    4. Click Create User, and create users Maggie, Chris, Frank, and Billy in sequence.
    5. Return to the CodeArts page, refresh the browser, click Add Members above the member list, and choose Users from My Enterprise. Select members Maggie, Chris, Frank, and Billy, and click Next.
    6. Click the Role drop-down list in each row, select Project manager for Maggie, Developer for Chris, Test manager for Frank, and Tester for Billy, and then click Save.

Step 1: Select Requirements and Initiate a BR

Chris, a project member, hopes that the R&D requirements determined in rounds of clarification will not be easily changed. Therefore, Chris adds these R&D requirements to the BR so that they can be controlled by locking the baseline.

  1. Go to the smart watch project and choose Work > Req > R&D Requirements.
  2. View the R&D requirements of the current project. Select the R&D requirements to be baselined and click Baseline Review on the operation bar in the lower part of the page.

    Figure 3 R&D requirement list

  3. Go to the page for creating a BR. The R&D requirements selected in the previous step are automatically added to the Baseline Object list.

    Figure 4 Creating a BR

  4. Enter the following information and click Submit to initiate a BR.

    Table 3 BR description

    Parameter

    Description

    Example Value

    Title

    BR title.

    • The value can contain letters, hyphens (-), underscores (_), commas (,), semicolons (;), colons (:), dots (.), slashes (/), parentheses (()), and spaces.
    • The value can contain 1 to 256 characters.

    Retain the default value generated by the system in this document.

    Description

    Description of a review.

    • The value can contain images, links, letters, digits, hyphens (-), underscores (_), commas (,), semicolons (;), colons (:), dots (.), slashes (/), parentheses (()), and spaces.
    • The value can contain 1 to 50,000 characters.

    BR background: The requirement has been clarified for multiple rounds and has entered the R&D phase.

    BR value: The following R&D requirements must be baselined and cannot be modified randomly.

    BR details: For details, see the associated files.

    Require Decision-Making

    Whether this field is displayed in the review depends on whether Require Decision-Making is enabled on the Work Configuration > Review page. If the switch is enabled, this field is displayed in the review form. If not, this field is not displayed.

    • When this field is displayed in the review and the value is Yes, Reviewer is mandatory and Review Expert is optional.
    • When this field is displayed in the review and the value is No, Reviewer does not exist and Review Expert is mandatory.
    • When this field is not displayed in the review and the value is Yes, Reviewer is mandatory and Review Expert is optional.

    Yes

    Reviewer

    Approver of a review.

    • The approver makes decisions on the review.
    • This field is associated with the Require Decision-Making field. You can select only one value. Set the value range in the Reviewer Roles area on the Work > Review page.

    Maggie

    Review Expert

    Review expert of the review.

    • The review expert reviews the requirements.
    • Select one or more project members.

    Billy, Frank

    Baseline Object

    You can add more R&D requirements and system features (SFs) as baseline objects as required.

    Requirements selected in the R&D requirement list

Step 2: (Review Experts) Complete Review

After the BR is submitted successfully, the review experts Billy and Frank will receive a notification, access the review details page through the notification card, and review the requirements.

  1. Access the service homepage and click To-do Center in the upper right corner, or go to the smart watch project and choose Review > Baseline Review. On the Baseline Review page, select To be reviewed by me to view the BRs that need to be reviewed.

    Figure 5 List of BRs to be reviewed

  2. Click the title of the BR. On the review details page, click Expert Review in the upper right corner. The Expert Review dialog box is displayed.

    Figure 6 BR details
    Figure 7 Expert review

  3. After setting the following parameters, click OK to complete the BR review.

    Table 4 Expert review parameters

    Parameter

    Description

    Example Value

    Result

    Select a value as required. When Transfer to others is selected, the Review Expert selection box is displayed and you must set this parameter.

    Approve

    Comments

    This parameter is mandatory when Result is set to Approve or Reject.

    OK

    Expert Comments

    If multiple review experts participate in the review, their review comments will be displayed here.

    --

Step 3: (Reviewer) Complete Decision-making

When the percentage of review experts selecting Approve or Reject reaches the threshold set in the Review Methods area on the Work Configuration > Review page, the BR automatically moves from the review phase to the decision-making phase.

If the review result of the BR is Rejected, the decision-making result will automatically be Rejected and the BR will be in the End state.

After the review expert completes the review, Maggie, the approver of the review, will be notified to handle the project.

  1. Access the service homepage and click To-do Center in the upper right corner, or go to the smart watch project and choose Review > Baseline Review. On the Baseline Review page, select Pending decision-making to view the BRs that need to be approved.

    Figure 8 Notices

  2. Click the BR title to go to the review details page. Click Decide by reviewer in the upper right corner of the page. The Decide by reviewer dialog box is displayed.

    Figure 9 BR details
    Figure 10 Decide by reviewer

  3. After setting the following parameters, click OK to complete decision-making on the BR.

    Table 5 Approver decision-making parameters

    Parameter

    Description

    Example Value

    Result

    Select a value as required. When Transfer to others is selected, the Reviewer selection box is displayed and you must set this parameter.

    Approve

    Comments

    This parameter is mandatory when Result is set to Approve, Reject, or Deny.

    OK

    Review Result

    This parameter indicates the final result of the review.

    Passed

    Expert Comments

    The review results and comments of review experts are displayed here.

    --

Step 4: Baseline the Requirements

After the review is approved, the review transits to the End state, indicating that the review is completed. Chris, the creator of the review, will be notified to handle the project.

  1. Access the service homepage and click Messages in the upper right corner, or go to the smart watch project and choose Review > Baseline Review. On the Baseline Review page, select I created to view the created BRs and their review result in the Status column.

    Figure 11 Notices
    Figure 12 BR list page

  2. Click the R&D Requirements tab. On the displayed page, all R&D requirements added to the BR are in the Baselined state. The baseline locking of R&D requirements is implemented.

    Figure 13 R&D requirement list
    The locked baseline fields of baselined R&D requirements cannot be changed randomly. Changes take effect only after review.
    Figure 14 Change notification