REQ_S270157.md

Author: Seyedali Mousavi, S270157

Abstract

Today there have been a great progress in every working area for all people using the benefits of IT systems. For example, drivers would want to know about the prices of gas in different stations and would like to know where each gas station is located so that they are able to choose the best price or the closest station among them.

Considering this situation, a group of developers decide to develop an application to support these drivers to fulfill their needs finding gas stations around and see the prices of each one. Moreover, that could help gas station owners to introduce their gas station to more customers. Gas stations owners update their information in the application. For example, they update the price for a specific fuel and drivers find about the price through this app. Drivers, also with the aid of GPS, can find all gas stations locations on a map.

Stakeholders

Stakeholder name	Description
Drivers	Use this application to find out about the prices of fuels and gas station location around them.
Gas station owners	Use this application to update their fuels prices and also share location of their gas station.

Context Diagram and interfaces

Context Diagram

Interfaces

Actor	Logical Interface	Physical Interface
Drivers	GUI	Smartphone, Screen, Keyboard
Gas station owners	GUI	Smartphone, PC
API Manager	Commands and Controls	Internet Connection, Server

Stories and personas

Jim uses public transportation to go to work every morning. One day he misses the early bus and he comes to this result that it would be so late if he waited for the next bus to arrive. So, he decided to go back home to take his own car to go to work. Unfortunately, he finds out that he is out of gas and there’s no time to refill the car tank. Hopefully, he knew about the existence of an application which was called “EZGas” which could help him find the nearest gas station around. He knew that by using that application he would be able to know about the exact location of gas stations and the fuel prices. So, he finds a gas station in the route of his office and without wasting any time he was able to refill his car and get to the office on time.

On the other hand, Luigi is gas station owner. He spends too much time on his gas station, but he has a few customers. Since he does not expend much money to introduce his gas station to people around, his earning is low. His gas station was not in the main district of the city and not anybody was aware of existence of this gas station. Joe, one of his friends, introduces the “EZGas” application to him in which he can add his gas station to the list of all gas stations to show on the map for drivers. Also, he was able to insert the prices of fuels and possibly open/close hours. Now, he can count on having more customers in his gas station.

Functional and non functional requirements

Functional Requirements

ID	Description
FR1	Driver sets his location using phone’s GPS
FR2	Driver filters gas stations based on price
FR3	Driver filters gas stations based on distance
FR4	Driver filters gas stations based on fuel type
FR5	Driver can contact the gas station through the application
FR6	Driver can rank a gas station based on its facilities
FR7	Gas station owner adds his location in the map
FR8	Gas station owner sets the fuel prices
FR9	Gas station owner can share some photos of his station
FR10	Gas station owner adds his contact information
FR11	Gas station owner can offer discounts

Non Functional Requirements

ID	Type (efficiency, reliability, .. see iso 9126)	Description	Refers to
NFR1	Usability	The application should be used with no training by any person (Driver, Gas station owner, …)	All FR
NFR2	Performance	All functions should complete in < 0.5 sec	All FR
NFR3	Portability	The application should run on android, iOS and windows phone devices	All FR
NFR4	Portability	The application should be available on computer browsers too	All FR
NFR5	Portability	The application data (Users accounts) should be portable from one smartphone to another smartphone	All FR
NFR6	Localization	Numbers are shown in a efficient view separated by comma and dots.	FR9,10,11,14,15
NFR7	Localization	Name of the gas stations may be in other languages which demands usage and support of Unicode	All FR

Use case diagram and use cases

Use case diagram

Seeking for a gas station:

Notifications and Recharge stations

Use Cases

Use case 1, UC 1 – Driver FRs

Actors Involved	Driver
Precondition	The driver should have a smartphone or laptop and internet connection.
Post condition	The car tank is full.
Nominal Scenario	The driver opens application and by phone’s GPS he finds gas stations around and the driver heads toward the station.
Variants	The searching criteria returns no result (no gas station around based on the filtered data) so the driver needs to perform another search.

Use case 2, UC 2 – Gas station owner FRs

Actors Involved	Gas station owner
Precondition	He/she should have a smartphone or laptop with internet connection and of course fuel to sell.
Post condition	The gas station is shown in the map of the application.
Nominal Scenario	The gas station owner sets up his account in the application and shares information about the gas station he/she owns so that customers can find it.
Variants	The gas station owner can offer discounts on some days of the year.

Relevant scenarios

Scenario 1

Scenario ID: SC1	Corresponds to UC1
Description	A driver uses the EZGas application to find a gas station which is near to him and also to check the prices of fuel.
Precondition	No gas station is found based on search criteria.
Postcondition	A gas station is found based on search criteria.
Step#	Step description
1	The drivers set some parameters to find an appropriate gas station.
2	The application shows some results to the driver
3	The driver can filter the results based on their needs.
4	The application returns new results for the driver.

Scenario 2

Scenario ID: SC2	Corresponds to UC1
Description	A gas station owner would like to show its location to the users of the EZGas application.
Precondition	The gas station owner has a location and has some services.
Postcondition	The gas station is shown in the map of the application
Step#	Step description
1	The gas station owner has to present some information about the station and certifications he has.
2	The owner presents exact information of the location of the gas station and shares pictures of it.
3	The gas station owner can offer some discounts occasionally.

Glossary