Add Conditions for Condition Index Calculation
Process Name:
Add Conditions to Calculate Condition Index
Feature/User Story Name:
Add Conditions for Condition Index Calculation
Description
This feature enables users to define multiple condition parameters for assets and calculate a Condition Index (CI) ranging from 0 to 10, with real-time updates. Calculations dynamically adjust based on user inputs and changes.
Actors
- Back-office user
User Story
As a back-office user,
I want to add conditions for an asset and generate its condition index,
so I can assess its overall condition and display the calculated index in relevant screens.
Goal
To enable the precise calculation and display of the Condition Index for assets using dynamic condition parameters, ensuring accuracy and real-time updates.
Storytelling
John from SWA face challenges in accurately evaluating asset conditions due to scattered and static parameters. Using this feature John uses a structured, dynamic way to define conditions, calculate a comprehensive Condition Index, and display it in relevant views for informed decision-making.
Process Flow Diagram
Major Steps Involved
- User accesses the "Add Conditions" modal from the asset row in the "Condition Index" list view.
- User selects parameters categorized into dropdown fields for Category and Subcategory (fetched from settings based on asset type).
- User assigns weightage scores (1-5) and a preference score (0-10) to each parameter.
- System recalculates weightages and decomposed weightages dynamically upon parameter addition or update.
- The Condition Index is calculated and displayed in the "Condition Index" column of the assets list view and in the detailed view conditions tab.
Business Rules
General Rules
- Data Source:
- Category and Subcategory Values: Fetched from settings based on the asset type.
- Initial Weightages: Distributed equally across all parameters, recalculated dynamically upon updates.
- Header of the form should display the following data of that particular asset and are fetched form asset registry.
- Asset name
- Asset ID
- Unit
- Plant
- Formulas:
- Category and Subcategory Weightage = (Weightage score of a parameter ÷ Sum of all weightage scores in the Parameters and parameters could be category or subcategory).
- Decomposed Weightage = Subcategory Weightage × Category Weightage.
- Condition Index = Σ(Decomposed Weightage × Preference Score).
- Condition Index Range: 0 to 10 with accuracy up to 1 decimal place.
- Dynamic Updates:
- Adding or removing a parameter redistributes weightages dynamically.
- Changes are reflected in real-time across all screens where the Condition Index is displayed.
UI/UX Behavior
- Mandatory Fields:
- Category: Dropdown.
- Subcategory: Dropdown.
- Weightage: Dropdown (values 1-5).
- Preference Score: Dropdown (0-10).
- Adding multiple categories and subcategories
- When user clicks on add button under subcategory new subcategory, Weightage for that subcategory and Preference score field should be added and in dropdown data of subcategories should be displayed which belongs to that specific category without including any subcategories that are added before.
- When user clicks on Add button in the bottom all the contents that are boxed should be repeated in the form and category dropdown should display all the categories added in the settings excluding the categories that are added already.
- Error Messages:
- "Please select a category" – if the Category field is left empty.
- "Please select a subcategory" – if the Subcategory field is left empty.
- "Please select a valid weightage score" – if Weightage is not selected.
- "Please select Preference score – if the Preference Score is left empty.
Display Rules
- Condition Index Column: Displays "N/A" until conditions are added for the asset.
- Condition Index Colors:
- 0-4: Red.
- 4.1-7: Yellow.
- 7.1-10: Green.
- Parameter Display:
- Detailed View Conditions Tab: Lists all parameters, weightages, and preference scores used to calculate the Condition Index.
Sample Data
- Asset: High-Pressure Pump.
- Category: Performance.
- Weightage Score: 4 (out of 5).
- Subcategory: Efficiency.
- Weightage Score: 4 (out of 5).
- Preference Score: 8 (out of 10).
Acceptance Criteria
- The user can successfully add multiple categories and subcategories.
- The weightages are recalculated dynamically upon addition or deletion of parameters.
- The calculated Condition Index is accurate and within the range of 0 to 10.
- The Condition Index updates dynamically in the assets list view and the detailed view conditions tab.
- Error messages are displayed for invalid or incomplete entries.
- Condition Index color codes (Red, Yellow, Green) display correctly based on the value.
- Detailed View Conditions Tab reflects the correct parameters, weightages, and preference scores used for calculation.