VIET NAM NATIONAL UNIVERSITY HOCHIMINH CITYUNIVERSITY OF INFORMATION TECHNOLOGY ADVANCED PROGRAM IN INFORMATION SYSTEMS Tran Quốc Huy - 16520532 Hoang Ngọc Bảo Minh - 16520734 GRADUATE T
INTRODUCTION 1 Thesis name 2 Thesis objecfive cớ 1 3 Thesis research content, scope and method . -ô- Í 3.1 Content z2 <5EEE ạ
SCOpe Hee 1 1 Functional feafures - ¿5c ccccccrererrrrerrerrrrrerrrree 1 2 Non-functional features: - 55-5 S+cc+ccrrtererrrrrrerrrree 2 3.3 Method HH HH ai 2 3.4 7) ÔÀ 6 ế
Due to the limited research time, we only focus on the main features such as:
+ Manage incoming booking, delivery orders
+ Check in booking, delivery orders
+ Matching available warehouse and rental demand
+ Friendly & easy-to-use user interface.
Using available libraries, technologies for building website and API server such as: + ReactJS for building user interfaces.
+ NodeJS for building an API server.
Use Docker to pack system components into containers, use Docker compose to link these containers together to form a comprehensive system.
Using pgAdmin4 to easily manage the Postgre database, used to do things such as: backup, create new tables, retrieve data,
Use to test the API before integrating into the frontend.
BACKGROUND AND THEORY cc 555cc 3 1 Background -o-SẶ St H Hi 3 1.1 Problem 5-5552 S+St2 22H HH2 221 re 3 2 _ Technical background - - + tk ki 7 2.1 Postgres SQL Ă SH rà 7 2.2 React JS che 8 2.3 Node JS HH HH nà 9 2.3.1 Nodejs processing model vs Traditional Web Application
Basic concepfs - cư 12
Sh ttps://www.journaldev.com/7462/node-js-architecture-single-threaded-event-loop#node-js platform (Node JS Architecture — Single Threaded Event Loop)
An application programming interface is a computing interface that defines interactions between multiple software intermediaries It defines the kinds of calls or requests that can be made, how to make them, the data formats that should be used, the conventions to follow, etc It can also provide extension mechanisms so that users can extend existing functionality in various ways and to varying degrees.[1] An API can be entirely custom, specific to a component, or designed based on an industry- standard to ensure interoperability Through information hiding, APIs enable modular programming, allowing users to use the interface independently of the implementation.
This is a means for two or more applications to exchange and interact with each other, creating a more efficient and convenient interaction between the user and the application With the API, programmers can access and retrieve data from the server, making it easier to present them on their software application or website.!!
"| https://www.business-standard.com/about/what-is-api
Figure 2.4: Relationship between client, API and server 12
Representational state transfer (REST) is a software architectural style that defines a set of constraints to be used for creating Web services Web services that conform to the REST architectural style, called RESTful Web services, provide interoperability between computer systems on the internet RESTful Web services allow the requesting systems to access and manipulate textual representations of Web resources by using a uniform and predefined set of stateless operations Other kinds of Web services, such as SOAP Web services, expose their own arbitrary sets of operations. https://medium.com/@perrysetgo/what-exactly-is-an-api-69f36968a4 If (Application Programming
REST determines how the API looks like It stands for “Representational State Transfer” It is a set of rules that developers follow when they create their API One of these rules states that you should be able to get a piece of data (called a resource) when you link to a specific URL.
REST was originally designed for use with web services However, any software can use REST as a bridge to communicate with other applications better and more efficiently That is also the reason why REST is the default standard for most protocols And the APIs that are designed according to a REST architecture are called
13 https://en.wikipedia.org/wiki/Representational_state_transfer '4 https://viblo.asia/p/restful-api-la-gi-1JeSEDJ4InL
ANALYZING, DESIGNING SYSTEM 1 Architecture, overview of a warehouse sharing platform
System use case Architecture, overview of a warehouse sharing platform
Manage >- ~; compensations Manage goods
1.2 Describe actors of use case
Renter Are businesses, people who have products, an they want to host their products.
Functions of the renter in the system + Manage booking
+ Book for spaces + Request for delivery + Manage delivery
Host People who have space available and they want to earn extra income from it Then in this system the host posts the repository and the system will process the host's repository. When the warehouse is published, the warehouse will be imported when a suitable renters are found.
+ Post the warehouse + Inventory management + Manage products in stock + View comments and ratings
Staff Staff is the employee of the system
+ Check in to verify and set up pallets into warehouse
+ Check-in and process renter's request booking space and delivery order
No | Use case Actors Description
1 | Register Host, Renter Registering account to be the member of the system
2 | Login Host, Renter, Staff Login the system to use the functions of the system such as:
+ Host: Publish warehouse, manage warehouse,
+ Renter: Book for spaces, mange booking,
+ Staff: Process space booking requests and delivery process.
3 | Manage spaces Host Host manage all of information of warehouse and products into _ their warehouse.
4 | Publish a space Host When staff check in and setup pallets into host’s warehouse, host is published warehouse on the system to wait for matching renter.
Host When renters _— products export out to deliver, host create the goods delivery note This situation to ensure that there is no loss of goods in warehouse To be specific, managing for their warehouse.
Host When renter’s product is imported into host’s warehouse, host creates goods received notes That is to say, this purpose is to ensure that sufficient quantity of product import host’s warehouse.
Manage booking Renter Renter view about the booking process clearly to manage their product during the time system handle renter’s request.
Renter can cancel without staff to confirm the order
Book for spaces Renter When renter book a warehouse to store their product, renter create the request booking and wait for the system handle matching warehouse.
Renter When renter want to get product to deliver for their customer, renter create a request for delivery Then the system handle renter’s request and find warehouse nearest with renter’s customer to deliver.
10 Manage delivery Renter Renter view about the delivery order clearly to manage their product order during the time system handle renter’s request.
Renter can cancel without staff to confirm the order
Renter Renter view the items status to manage renter’s products into warehouse.
Staff Staff will check in the warehouse code, then staff will set up the pallets into the warehouse to store the products when put into the warehouse.
Staff Staff will check in the renter code, then staff will confirm the booking request and send back to renter the request for booking confirmation After
20 that, when renter confirmed, the system will automatically find the warehouse After having the warehouse, the system will automatically arrange products into pallets in the warehouse.
Staff Staff will check the renter code, then staff will confirm the delivery order and send back to renter the request for delivery confirmation After the renter confirmed, the system will find the nearest warehouse for delivery.
Table 3.2: Describe the use case
21 delivery_request_pallete ˆ stored_item
HÌÌ space_request_stored_item + compensation_item
———ơ d eae space_verification_process account 5 ¢ space_request OT compensation_ticket
| s_location jam space Space_stored_ite
22 Ô _ #pace verification process wo wo 7 sid wu ,
TT rented at TINESTANP(S) ITHOUT TNE ZONE 'space_request_stored item ‘pdated.st TIMESTANPIG) WITHOUT TINE Z0ME
Far wo eœesdlby WO „ request id WO , imel by WO Pa
— iene OHMMCTAMUNG tence COAMCTER ARNG
` updated st TIMESTAMP) WITHOUT TIRE ZONE created_by WO , updded by WUD 7
Tr) 3 acc ped TAGS MTHOUT TNE ONE | ted by WO 2| updated by UU0 7 yryyryyy
Pe we nn ce tae] me ne CHARACTER VARYING
SE es TT“ TNETHNNG HTT THE ZONE
= =e ơ MCEAVINNS pene coanaren amo wee =e
#eithinuael cose ơ ^ aeons updated et TRMESTANP(€)WITMOUT TIME ZONE ao sa Pp) | med mare so Hg (| pdt ——_TMESANRG THOU mE ZOE
"meson ov TRE KE mss THON THE ME wo Fd | delivery request fie wo requester WUD A wo wỊ uti TEER sex ane MACTE ANG dein ous ROH động oun coBOH eed TMESHNNS WTHOUTTE NE | crested by UU 2 updated by UUO Kì
Aidt jé wu itemid wD comity NHEER var request aus created compen
THESTANE( WITHOUT TIE ZONE Updated ot TNESTANP(O WITHOUT THE ZONE rented by U00 updated by UUD omer WUD nee CHARACTER VARYING
"` weight DOUREPRECSION quantity NTEGER item situs rored ten eat crested e TMESTANP(G WITHOUT THE ZONE Updated st TMESTANP(G WITHOUT TE ZONE creaed_by WUD
7 crested TWESTANES WITHOUT TE ZONE updated at TMESTANFG WITHOUT THE ZONE erated by WUD a updeted by WUD Là
Column name Data type Description account_type enum Type of account avatar varchar Picture of user create_at datetime Time created
23 email varchar Email of user Ífirst_ name varchar First name id uuid ID of user is_verified boolean Verify status of user last_name varchar Last name of user password varchar Password of account personal_id varchar Personal ID of user updated_at datetime The time updated number_stored_items int The quanity of items
Column name Data type Description id uuid ID of space owner uuid Owner width float Width of warehouse depth float Depth of warehouse height float Height of warehouse number_of_avai_plt int Numver of available pallets space_name varchar Name of warehouse status enum Status of warehouse create_at datetime The time the warehouse created updated_at datetime The time the warehouse updated create_by uuid Who created warehouse updated_by uuid Who updated warehouse
Column name Data type Description
1d uuid ID of location address varchar Address long float Long from the location to warehouse lat float Latitude of warehouse space_id uuid Id of space create_at datetime The time the location created updated_at datetime The time the location updated create_by uuid Who created location updated_by uuid Who updated location
Column name Data type Description id uuid ID space_id uuid Id of space staff_id uuid Id of Staff status enum Status of space create_at datetime The created time updated_at datetime The updated time create_by uuid Who created
25 updated_by uuid Who updated
Column name Data type Description id uuid ID pallet_id uuid Id of pallte stored_item_id uuid ID of item stored request_id uuid ID of request stored_quantity int Quantity of item stored package_idx int Package number create_at datetime The created time updated_at datetime The updated time create_by uuid Who created updated_by uuid Who updated
Column name Data type Description id uuid ID space_id uuid Id of space rack_idx int ID of rack col_idx int ID of column row_idx int ID of row is_available boolen Is available
26 create_at datetime The created time updated_at datetime The updated time create_by uuid Who created updated_by uuid Who updated
Column name Data type Description id uuid ID requester uuid ID of requester space_id uuid Id of space status enum Status booking order staff_id uuid Id of Staff create_at datetime The created time updated_at datetime The updated time create_by uuid Who created updated_by uuid Who updated matched_spaces uuid[] List of space matches space
ID num_of_approve interger Number of approving booking process
Column name Data type Description id uuid ID request_id uuid ID of request requester uuid ID of requester reason_id uuid ID of reason reason_desc text Describe a text for reason create_at datetime The created time updated_at datetime The updated time create_by uuid Who created updated_by uuid Who updated
Column name Data type Description id uuid ID label varchar Name of reason cancel_type enum Type of cancel
Column name Data type Description id uuid ID request_id uuid ID of request status enum Status of compensation create_at datetime The created time updated_at datetime The updated time
28 create_ by uuid Who created updated_by uuid Who updated