Jajared / pe

0 stars 0 forks source link

Extensions for UC07 incomplete #9

Open Jajared opened 6 months ago

Jajared commented 6 months ago

Describe the bug The extensions listed in the use case is not detailed enough. For example, it does not account for throwing an error when a policy with the same policy number is added to the client. Beyond that, there are many other possible extensions such as invalid policy type, invalid premium term, etc. (in general, this can be classified as invalid parameters)

Screenshot DG Screenshot 2024-04-19 at 5.21.35 PM.png

UG Screenshot 2024-04-19 at 5.22.09 PM.png

nus-se-bot commented 6 months ago

Team's Response

Accepted and will update, however, it is of verylow severity as it does not affect functionality of InsureBook

Items for the Tester to Verify

:question: Issue severity

Team chose [severity.VeryLow] Originally [severity.High]

Reason for disagreement: Classifying this documentation omission as a Medium severity issue is justified because accurate documentation is crucial for ensuring that users fully understand and utilize the system’s capabilities effectively. In the case of InsureBook, where the application deals with sensitive and critical insurance data, clear documentation on how to add policies—including details on validation checks for duplicate policy numbers and parameter validation—is essential. If users are unaware of these features due to documentation shortcomings, they might not use the system as intended, leading to potential errors in usage or underutilisation of built-in safety features. This can indirectly affect data integrity and user efficiency, thus warranting a Medium severity classification to prompt timely correction, ensuring users are well-informed and can trust the system to perform as expected.

Because the product accurately reflects this shortcoming but the documentation does not, this can be considered as a Medium severity instead.