_____________________________________________________________________________________________________________________

System Requirements Specifications

Project Title: Liquid8 MarketPlace

for Group Digital Procument
Sprint Number: 1

Date: 24 April 2018

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 1 of 27
_____________________________________________________________________________________________________________________

Document Authorization
Document Title SRS_DOR for Sprint 1 of Liquid8

Document Version 1.0

Version Date 23 April 2018

Document Status Open

Distribution Internal

Name Signature Role Date

Prepared by Letchumi Sabapathy Business Analyst

Tan Kian Hee Project Manager

Solution
Reviewed by Adi Razwadi
Architecture

Huzaifah Dzulkifli Tech Lead

Business Project
Approved by M Hanafi B Jawati
Manager

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 2 of 27
_____________________________________________________________________________________________________________________

.................................................................................................................................................................

TABLE OF CONTENTS
1 INTRODUCTION.................................................................................................................................................... 4

1.1 PURPOSE .................................................................................................................................................. 4

1.2 INTENDED AUDIENCE ................................................................................................................................... 4
1.3 VERSION HISTORY ....................................................................................................................................... 4
1.4 ACRONYMS AND DEFINITIONS ........................................................................................................................ 5
1.5 USER STORIES SIGN OFF (PER SPRINTS) ............................................................................................................ 6
2 FUNCTIONAL REQUIREMENTS: USER STORIES ................................................................................................. 7

2.1 NEW USER STORIES FOR SPRINT 1 ................................................................................................................... 7

2.1.2 USER STORY 2: REGISTRATION PAGE ............................................................................................................. 9
2.1.3 USER STORY 3: SET PASSWORD PAGE .......................................................................................................... 12
2.1.4 USER STORY 4: LOGIN PAGE ...................................................................................................................... 14
2.1.5 USER STORY 10: MY ACCOUNT ................................................................................................................. 17
2.1.6 USER STORY 34: USER MANAGEMENT ........................................................................................................ 21
3 UI NAVIGATION ........................................................................................................................................... 27

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 3 of 27
_____________________________________________________________________________________________________________________

1 1 INTRODUCTION

1.1 Purpose

This document describes the functional requirements for Innovation Gateway Portal.

2.1 Intended Audience

Name Position/ Role OPU/ PET-ICT Action

M Hanafi B Jawati Business PM OPU Approve the SRS

Ahmad Ikrimah M Business Lead OPU Review the SRS

Yunus

Tan Kian Hee Project Manager PET-ICT Review the SRS

Adi Razwadi Solution PET-ICT Review the SRS

Architecture

Dinh Nhat Mai Solution FMAS Review the SRS

Architecture

Huzaifah Dzulkifli Tech Lead PET-ICT Review the SRS

Cuong Phan Scrum Master FSOFT Review the SRS

Khairul Anwar Release Planner PET-ICT For information

Ngalami

Atin Fatima Release Planner PET-ICT For information

Mohamad Zain

3.1 Version History

Version Date Author Comments
V0.1 23 April 2018 Letchumi Sabapathy Sprint 1
V1.0 27/4/2018 Letchumi Sabapathy Sprint1 (Incorporate changes
on User Profile)

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 4 of 27
_____________________________________________________________________________________________________________________

4.1 Acronyms and Definitions

Acronym Definition
PET-ICT PETRONAS ICT Sdn Bhd
PR Purchase Requisition
SAP Systems, Applications & Products in Data Processing
AD Outlook Directory
PETRONAS Petroliam Nasional Berhad
TM Technology Marketplace
BSR Business Requirements Statement
Enterprise ICT Services Services provided by PETRONAS Group ICT for PETRONAS.
Charges for the service are reflected in ‘VPM charges’ in the
project financials
SR Service Request
OPSR Online Project Service Request system. A workflow system that
is used to submit request until SOW is approved by both PET-
ICT and Business
PSR Project Service Request. A request submitted in OPSR will be
assigned with a unique identifier or number
SRS System Requirement Specification
SA Solution Architect
SCA System Criticality Assessment. A System Integration type of
work is required to perform SCA
SOW Statement of Work
SP Solution Proposal
OPE Out of Pocket expenses. The budget category used for travel
and expense claim, FOREX and miscellaneous expenses subject
to Business approval such as utilities, refreshment, OLAR
(Overtime Lamp and Air conditional Request Services), printing
and stationaries
Liquid8 Liquidity Market Place

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 5 of 27
 _____________________________________________________________________________________________________________________

5.1 User Stories Sign Off (per Sprints)

There are a total of 06 user stories for this sprint. User stories as per listed below:

No. User story Role User Stories Section Signature

number
EPIC: Welcome page

As a End user, I want to see the welcome while landing at Liquid8, so

1. 1 End User
that I can get the information, login or register a new account.

EPIC: Registration

As a External End User, I want to register an account in Liquid8 system,

2. 2 External User
so that I can submit my registration.

As a External End User, who submitted registration form, I want to get

3. 3 External User an activation email from Liquid8, so that I can ensure the authenticity
of Liquid8.

EPIC: Login page

As a End user, who has a login account, I want to log into Liquid8
4. 4 End User
system via the login page, so that I can access to my homepage.

EPIC: End User homepage

As a End User, who logged-in, I want to go to My Account and change

5. 5 End user my account information as well as changing password, so that I can
update and make my account secure.

EPIC: User management

As an Admin, I want to go to Administrator dashboard, so that I can

6. 36 Admin
perform all admin task.

As an Admin, I want to add – delete – edit – search user, manage roles

7. 41 Admin
so that I can manage users.

As an Admin, I want to assign roles to user so that I can allow user to

8. 42 Admin
perform task.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 6 of 27
_____________________________________________________________________________________________________________________

2 FUNCTIONAL REQUIREMENTS: USER STORIES

2.1 New User Stories for Sprint 1

2.1.1 USER STORY 1: The welcome page

ID Description
Module Welcome page
User Stories As a End User, I want to see the welcome while landing at Liquid8, so that I
can get the information, login or register a new account.
Role End User
Hyperlink
No Link title Action
1 Contact Us Go to Contact Us page
2 Login Go to Log in page
3 Register Go to Registration page

Text & Image - Liquid8 @ PETRONAS

areas

Acceptance 1. Go to browser and type in the URL or

Criteria 2. Click shortcut from PETRONAS Homepage. Liquid8 login page displayed.
3. Select relevant Domain.
4. Enterprise ID is the Outlook Email address (ex: Abu.Jalil) .Insert Outlook
email address and password.
5. Valid Enterprise ID and password should allow user to navigate to Liquid8
Landing page.
6. Invalid Enterprise ID and password will display error message for non-
authorized user. Refer to MSG-1
7. User can click on “Register Here” for new registration page. Once
registered, then able to “Login” and go to landing page.
8. Text and images should be shown up clearly and properly according to
the page layout.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 7 of 27
_____________________________________________________________________________________________________________________

Text Template None

User Interface

Email None
Template
Message Please enter correct Email Adddress

Message Code Message

MSG-1 Your account does not exist in the system.

Contact system adminstrator for access.

Workflow None

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 8 of 27
_____________________________________________________________________________________________________________________

2.1.2 USER STORY 2: Registration page

ID Description
Module Registration
User As a External User, I want to register an account in Liquid8 system, so that I
Stories can login to Liquid8 system.
Role External User
Input
Fields No Input Fields Datatype
1 First Name Alphanumeric - Symbol [Required]
2 Middle Name Alphanumeric - Symbol [Optional]
3 Last Name Alphanumeric - Symbol [Optional]
4 Company Alphanumeric - Symbol [Optional]
5 Position Alphanumeric - Symbol [Optional]
6 Location Alphanumeric - Symbol [Optional]
7 Contact Number Number - Symbol [Required]
8 Alternate Phone Number Number - Symbol [Optional]
9 Contact Email Email [Required]
10 Captcha Checkbox [Required]

Acceptance 1. User go to login page.

2. Click on “Register Here” option.
Criteria
3. System open registration page.
4. User allowed to key in all fields.
5. System do validation check for all mandatory fields. Ex: Email.
6. Registration form should be able to check if the User’s email address has
been registered before.
7. Registration form will not accept PETRONAS Groups email.
8. If user selects “Other” for Business Type, there should be a textbox
appears for him to input the Business Type.
9. If user selects “Yes” for PETRONAS Licensed Company, he should input
the “Registration No”.
10. User needs to check “I’m not robot” to be able to submit registration
form.
11. User should have all the mandatory information required in order to
submit registration.
12. User should get the notification message after submitting registration
form. Refer to MSG-2
13. The system needs to support Captcha services from Google.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 9 of 27
_____________________________________________________________________________________________________________________

Text Domain list to prevent PETRONAS group user from registering external account:
@petronas.com
Template
@petronas.com.my.. More sample as below.
@miscbhd.com
@pjh.com.my
@utp.edu.my
@klcc.com.my
@princecourt.com
@pli-petronas.com
@engenoil.com
@petronasenergy.com
User
Interface

Mock up screen

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 10 of 27
_____________________________________________________________________________________________________________________

Email Once submit registration, trigger email ET-1 to user for activation.
Template
Email Code ET-1
@{First Name and Last Name}
Send to

CC N/A
BCC N/A
[LIQUID8 @ PETRONAS] Activate new created account
Subject

Dear First / Last Name,

You are receiving this email because you have just

registered an account in LIQUID8 Portal at PETRONAS.

Your ID has been created, please click here

https://liquid8.petronas.com/iamweb/activation/setPass
Word.xhtml?vc=MTQwMDA5NDQ2OTA1Nw@@axFqfz1s2VV
PD2yLwTO8 (Sample) to activate it.

You need to set your password while activating your

Body account.

You have 24 hours to activate your account using this link.

If you are having difficulties activating your Account, then

please contact the IT Service Centre at:
http://liquid8.petronas.com/ContactUs

Note: This is a computer-generated email. Please do not

reply.
Message

Message Code Message

MSG-2 Thank you for registering. Registration successful.

Please click on the link provided to set Password.

Workflow None

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 11 of 27
_____________________________________________________________________________________________________________________

2.1.3 USER STORY 3: Set Password Page

ID Description
Module Registration
User As a External User, who submitted registration form, I want to get an activation
Stories email from Liquid8, so that I can ensure the authenticity of external user by setting
password.
Role External User
Input
Fields No Input Fields Data type
1 Input your password Alphanumeric - Symbol
2 Confirm your password Alphanumeric - Symbol

Acceptanc 1. User received email after submit registration. Refer to ET-1

2. User clicks on activation link from email.
e Criteria
3. User redirected to welcome page and immediately Password setting dialog box
pop-up. User must fill up “Set Your Password” and “Confirm Your Password”
and click on “Set password” button to set the password.
4. If both password same, then login automatically.
5. If “Set Your Password” and “Confirm Your Password” mismatches then
display error message MSG-3.
6. Activation link expires immediately right after the user set password
successfully (successful login)
7. In the case login fail, the activation link should be expired after 24 hours.
8. If user clicks on the link when it already expired, then he will be directed to
welcome page. User needs to wait 24 hours (next day) to register again with
the same email.
9. If it’s still before 24 hours, user still can click on the activation link for
activation.
10. The password must meet the criteria when creating a password (minimum 8
characters with at least 1 symbol + 1 alphabetic + 1 numeric characters).
11. Display error message if password is not complex enough as per MSG-4

Email
None
template

Message Message Code Message

MSG-3 Set Password and Confirm Password mismatch.

Kindly recheck.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 12 of 27
_____________________________________________________________________________________________________________________

MSG-4 Your password is not complex is enough. Password

must contain minimum 8 characters with at least 1
symbol + 1 alphabetic + 1 numeric characters.

User User insert password for the first time.

interface

Workflow

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 13 of 27
_____________________________________________________________________________________________________________________

2.1.4 USER STORY 4: Login page

ID Description
Module Login page
User As a End User, who has a login account, I want to log into Liquid8 system via the
Stories login page, so that I can access to my homepage.
Role End User
Input
Fields No Input Fields Datatype
1 Type of user Dropdown list
1. PETRONAS
2. EXTERNAL
2 Email Alphanumeric - Symbol
3 Password Alphanumeric - Symbol

Acceptanc 1. EXTERNAL user should input full email format to login, but PETRONAS user just
need to input ID (no need to input “@petronas.com”).
e Criteria
2. Error message should be shown up when email/password is not correct for
registered user. Refer MSG-1.
3. Error message should be shown up when user registered in the system at all .
Refer MSG-7.
4. Users will be redirected to their landing page after logging successfully.
5. User account will be blocked if I failed to login 5 times continuously. User
prompt for notification MSG-5.
6. User will be able to recover forgotten password by using forgot password link.
7. User are not allowed to use “forgot password” feature when the account is
being blocked. User prompt for notification MSG-6.
8. By using forgot password function, user will received a reset password link via
notification email. Refer to ET-2 template.
9. User needs to click on that link and will be directed to the “Set your password”
page like setting password for newly created account.
10. If user doesn’t click on that link, there is no change, and user is still able to
login with current password (This prevent user from trying to reset other’s
password).
11. Activation link should be expired after 24 hours. If user clicks on the link when
it already expired, then he will be directed to welcome page.
12. The system needs to support Captcha services from Google.
Email
template Email Code ET-2
@{First Name and Last Name}
Send to

CC N/A
BCC N/A

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 14 of 27
_____________________________________________________________________________________________________________________

[LIQUID8 @ PETRONAS] Forgotten password reset

Subject

Dear First / Last Name,

We have sent you this email in response to your request to

reset your password on Liquid8.

Please click on this link to reset your password: <The link>

If you don’t want to reset your password, please skip this
email.
We recommend that you keep your password secure and
not share it with anyone. If you feel your password has
Body been compromised, you can change it by going to your My
Account page.

If you need help, or you have any other questions, feel

free to contact us via ttp://liquid8.petronas.com/ContactUs
IT Support at Liquid8
Note: This is a computer-generated email. Please do not
reply.

Message Message Code Message

MSG-5 You have attempted 5 times. Your account will be

locked.

MSG-6 You have attempted more than 5 times. You are not
allowed to click “Forgot Password”.

MSG-7 You email has not registered in our account yet.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 15 of 27
_____________________________________________________________________________________________________________________

User Login page Forgot your password

interface

Open this page once click on “Reset Password”

Workflow

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 16 of 27
_____________________________________________________________________________________________________________________

2.1.5 USER STORY 10: My Account

ID Description
Module Login page
User As a End User, who logged-in, I want to go to My Account and change my account
Stories information as well as changing password, so that I can update and make my
account secure.
Role End User
Input Fields

No Input Fields Data type

1 First Name Alphanumeric - Symbol [Required]
2 Last Name Alphanumeric - Symbol [Optional]
3 Address Alphanumeric - Symbol [Required]
4 Contact Number Number - Symbol [Required]
5 Contact Email Email [Required]
6 PETRONAS Licensed Radio checkbox [Required]
o Yes
Company
Registration No:
____________________
o No
7 Business Type Select box [Required]:
o Oil and Gas Services
o Research Institution
o Manufacturer
o Technology Company
o Others (please specify): ________

8 Captcha Checkbox [Required]

Acceptance 1. User able to key in all fields.

2. User are not allowed to change the email once registered.
Criteria
3. The form should be able to check if the company ID has been registered
before.
4. User needs to click on “Save changes” button to update new account info. If
he doesn’t want to update, click on “Discard” button.
5. Click on “Change password” option. System open the “Change password”
screen.
6. User key in “Current Password” and click “New Password”. System do
validation check immediately. Display error message. Refer MSG-8
notification message.
7. Display error message when “New password” and “Confirm new password”
are not same. Refer MSG-9 notification message.
8. Display error message if password is not complex enough. Refer MSG-4
notification message.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 17 of 27
_____________________________________________________________________________________________________________________

9. User needs to click on “Save changes” button to update new password. If he

doesn’t want to update, click on “Discard” button.
Email
Template None

Message

Message Code Message

MSG-8 Current password incorrect.

MSG-9 New password” mismatches “Confirm new

password”

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 18 of 27
_____________________________________________________________________________________________________________________

User Liquid8 landing page

interface

My Account

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 19 of 27
_____________________________________________________________________________________________________________________

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 20 of 27
_____________________________________________________________________________________________________________________

2.1.6 USER STORY 34: User Management

ID Description
Module User Management
User As an Admin, I want to add – delete – edit – search user, manage roles, so that I
Stories
can manage user’s profile.
Role Admin
Input Fields
No Input Fields Datatype
1 Search email Alphanumeric - Symbol
2 Input email to retrieve Alphanumeric - Symbol
data
3 First name Alphabet
4 Last name Alphabet
5 Select a role to set Dropdown list
- End User (Internal/External
Project Engineers
- Material Owner
- Approver MGA
- Approver MPM
- Admin

Buttons No Button Action

User Management
1 Edit The pop-up Edit User Info page
appears
2 Delete The pop-up Delete User page
appears
3 Set Role The pop-up Set Role page appears
4 Activate The pop-up Activate User page
appears
5 Add internal user The pop-up Add Internal User page
appears
6 Next The next page appears
Edit User Info
1 Save changes Save all changes have been made

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 21 of 27
_____________________________________________________________________________________________________________________

2 Discard Cancel all changes have been

made
Set User Role
1 Set the Role Set the selected role to user
Add Internal User
1 Retrieve Retrieve user data from AD server
2 Add to Liquid8 Add the AD user to Liquid8 system
3 Cancel Cancel adding user to Liquid8
Delete/Activate User
1 Yes Proceed the action
(delete/activate)
2 No Cancel the action (delete/activate)
Acceptance Admin landing page:
1. The admin landing should have 03 “functional boxes”: My Account, User
Criteria
Management and Product Management.
User Management:
2. User Management page should shows list of user which is sortable.
3. The relevant pop-up page should appears when specific button is clicked.
4. “Set Role” button is available for internal user only, it grey out for external
user.
5. “Activate” button is active when we delete the user. Meaning deleted user
status set as “Inactive”. Simply click on “Activate” to set the status as
“Active”
6. “Delete” button greys out when user deletion finished.
7. Admin can add internal user only into Liquid8 by clicking on “Add” button.
External user need to register first.
8. Admin can search any user in the list by using the “Search email” box.
Edit User Info:
9. The acceptance criteria is same as Registration and Setting Password in the
first time login.
Set User Role:
10. User role should be set according to the selected role.
Add Internal User:
11. Data should be retrieved from AD server if the inputted email is existing.
12. The retrieved data should be shown up in “Account Info Retrieved” area.
13. Internal user should be add to Liquid8 system after admin clicks on “Add
Internal User”.
Delete User:
14. User should be deleted from the list after admin selects “Yes”. Refer
notification message MSG-10
15. The user selection is cancelled when admin selects “No”
Activate User:
1. User should be activated after admin selects “Yes”. Refer notification
message MSG-11
2. The user activation is cancelled when admin selects “No”.
Integration 1. Need API to retrieve internal user data from AD server.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 22 of 27
_____________________________________________________________________________________________________________________

User Admin landing page

interface

User Management

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 23 of 27
_____________________________________________________________________________________________________________________

Add Internal User

Edit Internal/External User

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 24 of 27
_____________________________________________________________________________________________________________________

Set Role

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 25 of 27
_____________________________________________________________________________________________________________________

Delete User

Activate User

Message

Message Code Message

MSG-10 Successfully deleted.

MSG-11 Successfully activated.

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 26 of 27
_____________________________________________________________________________________________________________________

3 UI Navigation

Open
_____________________________________________________________________________________________________________________
PSR4448 Page 27 of 27