Hawalayk.

com

Submitted by:

Esraa Abdelmobdy
Esraa Mahmoud Ramadan
Sahar Abdou Mahmoud
Asmaa Aly Mohamed
Zainab Mahmoud
Zainab Ramadan
Lujain Abdul Rahim
Aya Attalla

Under Supervision of:

Dr. Nada Mubarak
Dr. Eman Mousa

Department of Computer science

faculty of computer and information at South Valley University
June 2024
 ii

Contents
Abstract ..................................................................................................................................... iii
1. Introduction ............................................................................................................................ iv
1.1 Motivation ................................................................................................................................... iv
1.2 Objective ..................................................................................................................................... iv
2. Software Requirements Specification ....................................................................................1
2.1 Introduction .................................................................................................................................. 1
2.2 Overall Description ...................................................................................................................... 1
2.2.1 Product Features....................................................................................................................... 1
2.2.2 User Classes and Characteristics ............................................................................................. 2
2.2.3 Operating Environment............................................................................................................ 2
2.3 Functional Requirements.............................................................................................................. 2
3.3.1 Customer Functionality: ............................................................................................................... 2
2.3.1 Craftsman Functionality: ......................................................................................................... 4
2.3.2 Admin Functionality: ............................................................................................................... 4
2.4 Other Nonfunctional Requirements ............................................................................................. 5
2.4.1 Performance Requirements ...................................................................................................... 5
2.4.2 Usability Requirements............................................................................................................ 6
2.4.3 Security Requirements ............................................................................................................. 6
2.4.4 Reliability Requirements ......................................................................................................... 6
2.4.5 Scalability ................................................................................................................................ 6
2.4.6 Maintainability ......................................................................................................................... 6
2.4.7 Compatibility: .......................................................................................................................... 6
2.4.8 Other Requirements ................................................................................................................. 7
3. Appendix : Analysis Models ....................................................................................................8
3.1 Use case diagram......................................................................................................................... 9
3.2 sequence diagram for sign up/ login process ............................................................................. 10
3.5 Class diagram.................................................................................................................................... 11
3.3 sequence diagram for service request process............................................................................ 11
.4 Result.......................................................................................................................................13
4.1 Log in & registration .................................................................................................................. 13
4.2 The most important customer interfaces .................................................................................... 16
4.2.1 Customer log in ...................................................................................................................... 16
4.2.2 Customer Home page............................................................................................................. 18
4.2.3 Customer's order history ........................................................................................................ 24
4.2.4 Customer personal page ......................................................................................................... 25
4.3 The most important craftsman interfaces ................................................................................... 26
4.3.1 Craftsman log in..................................................................................................................... 26
The additional information is necessary for security purposes, and is needed by the administrator to
verify identity before approving registration. ......................................................................................... 26
4.3.2 Craftsman Home page............................................................................................................ 27
4.3.3 Craftsman's order history ....................................................................................................... 30
4.3.4 Craftsman personal page ........................................................................................................ 31
4.3.5 craft's gallery .......................................................................................................................... 33
4.4 Admin Dashboard ...................................................................................................................... 34
4.4.1 Reports ................................................................................................................................... 35
4.4.2 approving craftsman............................................................................................................... 35
4.4.3 Add/delete admin ................................................................................................................... 36
.5 Mobile Application Result .....................................................................................................37
6. Team members .......................................................................................................................38
7. Conclusion..........................................................................................................................39
 iii

Acknowledgment
We would like to extend our sincere gratitude to our supervisor, Dr. Nada Mubarak,
and Dr. Eman Mousa, for their guidance and support throughout this project. Their
expertise and valuable insights were instrumental in shaping the direction of the
project and ensuring its success.

Their guidance and mentorship have been instrumental in our growth as developers,
designers, and team members. We are grateful for their dedication to our education
and training, and we are proud to have had the opportunity to work under their
supervision.

Thank you both for your time, effort, and support. We hope that our project,
Hawalayk, will make a positive impact on the community and serve as a testament to
the value of hard work, teamwork, and mentorship.

Abstract
What is Hawalayk?

Hawalayk is a platform that connects customers with craftsmen (e.g. plumbers,

electricians, carpenters) through an online marketplace. The app allows customers
to:

* Quickly contact craftsmen and submit service requests at any time

* Browse a craft gallery and interact with artisans

For craftsmen, the app provides an electronic exhibition to display their crafts and
attract job opportunities from various locations.

The name "Hawalayk" means "always around you" in Arabic, emphasizing the
app's commitment to helping users solve problems in various aspects of their
daily lives. The app can be accessed via browser or downloaded as a mobile app
for free.
 iv

1. Introduction

1.1 Motivation
The Genesis of Hawalayk:

Hawalayk was born out of a pressing need to bridge the gap between customers and skilled
craftsmen in cities, particularly for those who are new to the area and don't have a network of
contacts. In emergency situations, having access to reliable and trustworthy craftsmen can be a
matter of urgency. Our team recognized this need and designed Hawalayk as a platform that
aggregates skilled craftsmen from 23 different fields under one roof.

Empowering Craftsmen:

We also considered the plight of lesser-known craftsmen who struggle to gain recognition in
their field. It's often the case that renowned craftsmen are those who have built a strong
reputation over time, leaving those just starting out with limited opportunities. Hawalayk aims to
level the playing field by providing an equal platform for all craftsmen, regardless of their level
of experience or reputation. Our app enables them to showcase their work, share their skills, and
attract clients from diverse locations.

1.2 Objective
Through Hawalayk , customers can:

• Easily find and contact qualified craftsmen in their area

• Browse a wide range of services across 23 fields
• Read reviews and ratings from other customers to make informed decisions
• Make voice calls directly to craftsmen
• Track service request progress in real-time

For craftsmen, Hawalayk offers:

• A platform to showcase their skills and work
• Opportunities to connect with new customers from diverse locations
• A way to manage their online presence and reputation
• Real-time job application tracking and management
• By providing a comprehensive platform for both customers and craftsmen, Hawalayk
aims to revolutionize the way people access skilled labor services, empowering
individuals to solve problems and achieve their goals with ease.
 1

2. Software Requirements Specification

2.1 Introduction
Hawalayk app is an application that connects skilled craftsmen with customers in need of their services.
This Software Requirements Specification (SRS) document outlines the functional and non-functional
requirements for the Hawalayk app, providing a comprehensive understanding of the software's
capabilities, features, and constraints.

2.2 Overall Description

2.2.1 Product Features

Customer-Facing Features:
• Search and Discovery: Customers can search for skilled craftsmen in their area and browse a list
of available services.
• Service Request: Customers can submit service requests, describing their problem and required
services.
• Craftsman Profile: Customers can view profiles of available craftsmen, including their skills,
posts, reviews, and ratings.
• Reviews and Ratings: Customers can rate and review craftsmen after completing a job.
Craftsman-Facing Features:
• Profile Management: Craftsmen can create and manage their online profiles, showcasing their
skills and work.
• Service Request notifications: Craftsmen get notified about new service requests in their
respective crafts and they can apply for it or ignore it.
• Real-time Tracking: Craftsmen can track the status of their job applications in real-time.
Additional Features:
• Communication: Customers and craftsmen can communicate through voice calls.
• Rating System: Customers can rate craftsmen after completing a job.
 2

2.2.2 User Classes and Characteristics

“Hawalayk”caters to three distinct classes of users: customers, craftsmen, and administrators.

Each user class has specific characteristics and requirements:

- Customers: Customers are individuals seeking skilled craftsmen for various services. They may have
different skill requirements and preferences.
Within “Hawalayk”, customers can browse different crafts, request services, provide comprehensive
reviews and ratings, manage their accounts, and report any issues or concerns encountered while using
the application.

- Craftsmen: Craftsmen are skilled professionals representing various crafts, such as carpentry,
electrical work, plumbing, metalwork, painting, handmade crafts, and culinary arts.
They can register on “Hawalayk”, apply for service requests that align with their expertise, showcase
their work through craft-specific galleries, manage their accounts, report bugs or technical issues, and
view customer interactions, including communications, accepted job applications, and submitted job
applications.

- Administrators: Administrators have the authority to manage the “Hawalayk”application and ensure
its smooth operation.
They can manage advertisements by adding or removing them as needed, access reports on user and
craftsman activities for monitoring and analysis purposes, handle account management by removing or
banning accounts when necessary, view statistical insights and generate reports and manage other
administrators by adding or removing them from the system.

2.2.3 Operating Environment

“Hawalayk” operates in a web-based environment accessible through popular web browsers such as
Google Chrome, Mozilla Firefox, and Safari.
Additionally, “Hawalayk” provides a dedicated mobile application compatible with both iOS and
Android devices, allowing users to access the platform on the go.
The application requires an active internet connection for full functionality, ensuring real-time updates,
notifications, and seamless communication between users.

2.3 Functional Requirements

3.3.1 Customer Functionality:

 3

Title: Customer Registration

Description: customer create an account by providing necessary information such as name, phone
number, address, password, image, gender, birthday

Title: Customer Login

Description: Only the customer who has registered has the ability to log in to the application and
interact with it.

Title: Change password

Description: The customer who has registered has the ability to change their password by receiving a
confirmation letter by SMS.

Title: Craftsmen Search

Description: Customers should be able to easily search for skilled craftsmen based on their specific
requirements (select craft).

Title: Browse Craftsmen

Description: Customers should have the ability to explore detailed profiles of craftsmen, including their
information and uploaded work.

Title: Service Requests

Description: Customers should be able to write service requests, providing relevant details about their
needs.

Title: Job application Management

Description: Customers should be able to accept or reject applications received from craftsmen for their
service requests.

Title: Request Cancellation

Description: Customers should have the ability to delete their service requests.

Title: Reviews and Ratings

Description: Customers should have the option to write reviews and rate the craftsman they have dealt
with.

Title: Blocking
Description: Customers should be able to block specific craftsmen if necessary.

Title: Account Management

Description: Customers should have the ability to update their personal information and delete their
accounts.
Title: Craft Galleries
Description: Customers should be able to browse galleries specific to each craft to gain insight about
craftsmen's work.
 4

Title: App Reporting

Description: Customers should be able to report any issues while using the app.

Title: craftsman reporting

Description: Customers should be able to report any craftsman whom they have dealt with for
problematic behavior.

2.3.1 Craftsman Functionality:

Title: Customer Registration

Description : customer create an account by providing necessary information such as name, SNN, phone
number, address, e-mail, password, image, gender, birthday ,craft name

Title: Customer Login

Description: Only registered customers have the ability to log in to the application

Title: change password

Description: The registered customer has the ability to change their password via SMS

Title: Service Application

Description: Craftsmen should be able to apply for service requests that align with their expertise.

Title: Portfolio Gallery

Description: Specific craftsmen have the ability to upload images from their portfolios to showcase their
work in craft-specific galleries.

Title: Manage Account

Description: Craftsmen should be able to update their personal information and manage their accounts.

Title: Customer Reporting

Description: Craftsman should be able to report any customer whom they have dealt with for
problematic behavior.

Title: App Reporting

Description: Craftsmen should have the ability to report any bugs or technical issues they encounter
within the application.

Title: Customer history

Description: Craftsmen should be able to view lists of customers who have contacted them through the
app and customers who have accepted their job applications.

2.3.2 Admin Functionality:

 5

Title: Advertisement Management

Description: Administrators should have the ability to add or remove advertisements as needed.

Title: Reviewing customer and Craftsman Reporting

Description: Admins should be able to access reports on customer and craftsman activities.

Title: Managing user account

Description: Administrators should have the authority to remove or ban accounts when necessary.

Title: Statistical Insights

Description: Admins should be able to view statistical information
About profit and customer behavior.

Title: Admin Management

Description: Administrators should have the ability to add or remove additional administrators.

Title: reviewing App Reports

Description: Admins should have access to reports about bugs or technical issues within the application.

2.4 Other Nonfunctional Requirements

2.4.1 Performance Requirements

• Page load time: All pages should load within 5 seconds for a seamless user experience.
• Search response time: Search results for craftsmen should be displayed within 5 seconds.
 6

• Service request handling: The app should handle up to 100 concurrent service requests without
performance degradation.
• Image loading: Images in galleries and profiles should load quickly and smoothly, even on
slower internet connections.

2.4.2 Usability Requirements

• Intuitive interface: The app's design should be simple and intuitive, requiring minimal effort for
users to navigate and complete tasks.
• Clear instructions: Provide clear and concise instructions for all features, especially for less tech-
savvy users.
• Mobile responsiveness: Optimize the app for optimal viewing and interaction on mobile devices.

2.4.3 Security Requirements

• User authentication: Require strong passwords and multi-factor authentication to protect user
accounts.
• Data encryption: Encrypt sensitive data, such as personal information
• Security audits: Conduct periodic security audits to identify and address potential risks.

2.4.4 Reliability Requirements

• Uptime: The app should be available 99.9% of the time to ensure uninterrupted service.
• Data integrity: Implement robust measures to prevent data loss or corruption.
• Error handling: Gracefully handle unexpected errors and provide informative messages to users.
• Backup and recovery: Establish regular backups and a recovery plan to minimize downtime in
case of system failures.

2.4.5 Scalability

• User growth: The app should be able to accommodate a growing user base without performance
degradation.
• Feature expansion: The architecture should support the addition of new features without
significant code refactoring.

2.4.6 Maintainability

• Modular design: Structure the code in a modular and well-documented manner to facilitate future
updates and bug fixes.

2.4.7 Compatibility:
 7

• The application should be compatible with popular web browsers (Chrome, Firefox, Safari) and mobile
platforms (iOS, Android).

2.4.8 Other Requirements

• Localization: Support Arabic languages To suit the category used for the application
• Legal compliance: Adhere to relevant laws and regulations, such as data protection laws.
 8

3. Appendix : Analysis Models

The following figures show a set of diagrams, in order:

1- Use case diagram

2- sequence diagram for sign up/ login process

3- sequence diagram for service request process

4- Class diagram
 9

3.1 Use case diagram

 10

3.2 sequence diagram for sign up/ login process

 11
3.3 sequence diagram for service request process
 12

3.5 Class diagram

 13

4. Result

4.1 Log in & registration

When the user (customer or craftsman) opens the application, these initial 5 pages appear before logging
in.
14
 15

A first-time app user (craftsman or customer) should see the login page when they open the app, see
Figure 1.
If the user has not registered, they should be able to do so on the registration page Figure 2.

Figure 1
 16

click on :

"I am a Craftsman" -
Register as a professional
craftsman to access
exclusive features and tools.
"I am a Customer" -
Register as a customer to
access our services and
benefits.

4.2 The most

important customer interfaces Figure 2

4.2.1 Customer log in

• Enter your full name, date of birth, and choose your gender

Then enter your address

 17

• Enter your username, phone number, and set a password

 18

• Once you click “Next,” you will receive an OTP message to verify your identity. Take the
numbers and put them in these fields.

4.2.2 Customer Home page

"Congratulations! Your registration is complete. You are now directed to the customer's home page,
where you can explore our comprehensive catalog of crafts and services. From here, you can easily
browse and order the services that catch your eye, or request a custom service from one of our skilled
craftsmen immediately."

Figure 2
 19

• If you select an urgent request, you will be taken to the next step, where you can provide more
details and specifications for your custom service

To initiate your urgent request, simply provide the following information:

• The craft or service you need

• The address where you would like the craftsman to visit
• A detailed description of the problem or issue you're experiencing
You can also enhance your request by uploading photos of the issue, if applicable. Once you've
completed the information, click "Request" to submit your request to the relevant craftsmen. Our system
will automatically notify all available craftsmen with expertise in your requested craft and those who are
closest to your location, ensuring prompt and efficient service

If the operation is completed successfully, you will see applicants for your request
 20

The system allows you to:

• View the list of applicants for your request

• See their rating (number of stars)
• Accept or reject their application
• View the initial price they offered for the problem
• Read their comments on your problem
The system allows you to cancel an order by clicking on the "Cancel Order Button" above.

When you click on the arrow, it will take you back to the home page
Return to page 13 Figure 2

• If you select an explore crafts, you'll be presented with a comprehensive list of crafts

You can search

for the name of
a craft, as it
rearranges the
crafts to show it
in the first
position
 21

Each item of this list is a gallery showcasing the work of its talented craftsmen.
You can browse through these galleries, selecting the crafts that resonate with you the most, and
even contact their owners.

(1)
 22

From the craft gallery (1), you can also access the individual accounts of the craftsmen, allowing you
to delve deeper into their portfolios, browse their work, and establish a direct connection with them.

You can search for a craftsman by name in the search box

 23

This is an example of a portfolio for a carpenter, where you can :

• browse the contact's photo
• call him
• block him
• report him
 24

• view reviews from others and rate your experience yourself

4.2.3 Customer's order history

This page allows you to view a history of ongoing and completed orders, as well as cancel ongoing
orders
 25

4.2.4 Customer personal page

• Modify your account information

• log out from your personal page
• Report a problem with the application

1. Choose the type of malfunction

2. describe what happened to you
 26

4.3 The most important craftsman interfaces

4.3.1 Craftsman log in

The craftsman login steps are similar to the customer login steps, but we need additional information
such as:
• your personal photo
• copy of your civil ID

The additional information is necessary for security purposes, and is needed by the administrator to
verify identity before approving registration.

Additionally, the registration process should include a field to specify the craft that the craftsman
practices, allowing for selection from a list of 23 available options
 27

4.3.2 Craftsman Home page

On the home page, you can go to:

1. sent requests
2. You have been accepted by
3. missed calls

When the craftsman logs in to his home page, he will be greeted with the latest notifications of urgent
orders that he can place for.
 28

1. sent requests

"After selecting a "sent request "from the home page , you will be redirected to the details of that
specific requests, where you can:

• apply any request

• reject any request

• enter your intial price

• provide a comment explaining your solution to the problem.
 29

2. You have been accepted by

you'll be able to view the orders you've applied for and been accepted. You'll also have the ability
to communicate with the customers, as well as options to block or report any issues with them

Example of an in-app voice call

 30

3. missed calls

You will be able to know about missed calls

4.3.3 Craftsman's order history

Your order history provides a comprehensive record of all your transactions, including the date,
customer information, and details of each order, giving you a clear overview of your sales activity
and customer interactions.
 31

4.3.4 Craftsman personal page

• Modify your account information

• Report a problem with the application
• Upload images either by adding them to your craft's photo gallery or by incorporating them into
your portfolio
• log out of the application
 32

• Example of uploading images to craft's photo gallery or into portfolio (both)

 33

4.3.5 craft's gallery

The crafts gallery is a curated space where artisans can showcase their artistic works related to a specific
craft, allowing them to discover and be inspired by the creations of their peers. As a craftsman, you can
access this gallery to stay up-to-date on the latest artistic developments and trends in your field.(only
your field)

• You can filter your own photos that you have uploaded to the gallery

• you can modify or delete them

 34

4.4 Admin Dashboard

The admin dashboard provides a comprehensive overview of the application's performance, featuring
key metrics such as the total number of craftsmen, clients, and orders. It also includes a graphical
representation of order volume by craft, allowing administrators to track trends and patterns.
Additionally, the dashboard displays real-time data on current users, including the percentage of active
users today and their numbers over the past month or week. Furthermore, it provides a list of the three
most recent transactions, with detailed information about each transaction
 35

4.4.1 Reports

The admin can review reports related to the application and reports between users and take the
necessary action

4.4.2 approving craftsman

The admin approves the craftsman's request to register in the application after verifying his identity
 36

4.4.3 Add/delete admin

The admin (we usually call him a super admin) can add and delete other admins. He can do this after
entering a password (we usually choose an admin to be the super admin and give him the password)
 37

5. Mobile Application Result

Our application is also available in the form of a mobile application, and these are some of the results
 38

6. Team members

This project was completed with the cooperation of the following team members:

• Esraa Abdelmobdy: Backend Developer & Software Tester& Team Leader

• Esraa Mahmoud Ramadan: Backend Developer & Software Tester
• Sahar Abdou Mahmoud: Backend Developer& Software Tester
• Asmaa Aly Mohamed: Backend Developer & Software Tester

• Zainab Mahmoud: Frontend Developer & UI/UX Designer

• Zainab Ramadan: Frontend Developer
• Lujain Abdul Rahim: Flutter Developer
• Aya Attalla: Full Stack Developer
All members of the group participated in the role of System Analyst, contributing to the comprehensive
analysis and design of the system. The teamwork and dedication demonstrated by all members were
pivotal in the successful completion of this project.
 39

7. Conclusion
‫تم بحمد هلل تعالى‬

We are proud to announce that the Hawalayk app has been successfully developed, marking a significant
milestone in our project journey. Our goal was to create an application that connects skilled craftsmen
with customers, streamlining the process of finding and hiring professionals for various services. We are
thrilled to report that our app features a user-friendly interface, robust user management capabilities, and
rating and review systems.

We would like to extend our gratitude to our supervisor, Dr. Nada Mubarak, for her guidance and
mentorship throughout the project. Her expertise and support were invaluable in helping us stay focused
and motivated. We would also like to thank Dr. Eman Mousa for her contributions to the project's
technical aspects.

We are confident that Hawalayk will make a positive impact in the lives of our users, providing them
with a convenient and efficient way to access professional services. We look forward to continuing to
improve and expand our app in the future.