ADDIS ABABA CITY PUBLIC TAXI ZONE

ASSIGNMENT AND CONTROLLING SYSTEM

USER MANUAL DOCUMENT

January, 2019
Group Members
Dawit Ayalew GSE/6327/10
Tamiru Desta GSE/3295/10
Henok Habte GSE/7024/10
Tebibu Solomon GSE/6675/10
Yared Tadele GSE/9707/10
TABLE OF CONTENTS

List of Tables .......................................................................................................................................................... 2

List of Figures ........................................................................................................................................................ 3
1. GENERAL INFORMATION ................................................................................................................................... 4
1.1 System Overview ..................................................................................................................................... 4
1.2 Organization of the Manual .................................................................................................................. 5
1.3 Acronyms and Abbreviations................................................................................................................ 5
2. SYSTEM SUMMARY .............................................................................................................................................. 6
2.1 System Configuration ............................................................................................................................. 6
2.2 Data Flows ................................................................................................................................................. 7
2.3 User Access Levels ................................................................................................................................... 7
3. GETTING STARTED ............................................................................................................................................... 9
3.1 Logging On ................................................................................................................................................ 9
3.2 AACPTZACS System Menu .................................................................................................................. 10
3.3. Changing User ID and Password ............................................................................................................. 11
3.4 Exit System .............................................................................................................................................. 12
4. SYSTEM FUNCTIONALITIES (ONLINE) ........................................................................................................... 13
4.1. USING the SYSTEM (Online) .................................................................................................................... 13
4.2. User Management Subsystem ................................................................................................................. 13
4.3. Zone Management Subsystem ................................................................................................................ 16
4.4. Route Management Subsystem .............................................................................................................. 17
4.5. Tariff Management Subsystem ............................................................................................................... 19
4.6. Taxi Management Subsystem .................................................................................................................. 20
4.7. Taxi Owner Management Subsystem .................................................................................................... 20
4.8. Driver Management Subsystem .............................................................................................................. 21
4.9. Zone Assignment Subsystem ................................................................................................................... 22
4.10. Mobile Apps .............................................................................................................................................. 24
4.10.1. Attendance Management ................................................................................................................... 24
4.10.2 Unavailability Report subsystem ........................................................................................................ 29
4.10.3 Public Taxi User Complain Subsystem .............................................................................................. 30
4.10.4 Public Taxi Status Subsystem .............................................................................................................. 32
4.11 Report Management Subsystem ........................................................................................................... 33

1
List of Tables
Table 1: Functionalities and access privileges-user mapping ..................................................................... 13

2
List of Figures
Figure 1: System Architecture ................................................................................................................... 6
Figure 2: Sign in page ................................................................................................................................ 9
Figure 3: system menu ................................................................................................................................ 10
Figure 4: Change password link .............................................................................................................. 11
Figure 5: The change password dialog window ................................................................................... 12
Figure 6: sign out link ............................................................................................................................... 12
Figure 7: Add New User ........................................................................................................................... 14
Figure 8: Update User Account ............................................................................................................... 15
Figure 9: Block User Account .................................................................................................................. 15
Figure 10: Block Account Confirmation ................................................................................................. 16
Figure 11: Add Zone ................................................................................................................................. 16
Figure 12: View Zone ................................................................................................................................ 17
Figure 13: Update and Deleted Zone ..................................................................................................... 17
Figure 14: Add Route ............................................................................................................................... 18
Figure 15: View Route .............................................................................................................................. 18
Figure 16: Update and Deleted Zone ..................................................................................................... 19
Figure 17: Add Zone ................................................................................................................................. 19
Figure 18: View tariff ................................................................................................................................ 20
Figure 19: Update and Delete tariff ........................................................................................................ 20
Figure 20: Add Driver ............................................................................................................................... 21
Figure 21: View Driver .............................................................................................................................. 22
Figure 22: Update and Deleted Zone ..................................................................................................... 22
Figure 23: Add Zone Assignment ........................................................................................................... 23
Figure 24: View Zone ................................................................................................................................ 24
Figure 25: Update and Deleted Zone ..................................................................................................... 24
Figure 26: public taxi mobile app ............................................................................................................... 25
Figure 27: Mobile apps main page ......................................................................................................... 26
Figure 28: Mobile Apps User Selection Menu ...................................................................................... 26
Figure 29: Attendance Mobile Apps Login page .................................................................................. 27
Figure 30: Attendance record ................................................................................................................. 28
Figure 31: Driver PIN ................................................................................................................................ 29
Figure 32: unavailability /absence report .............................................................................................. 30
Figure 33: Public taxi user complain ...................................................................................................... 31
Figure 34: Public Taxi ............................................................................................................................... 32
Figure 35: View Zone ................................................................................................................................ 33
Figure 36: Update and Deleted Zone ..................................................................................................... 33
Figure 37: Analysis team window .............................................................................................................. 34
Figure 38: Zone Report ............................................................................................................................... 35
Figure 39: Attendance Report ..................................................................................................................... 35
Figure 40: complain Report ........................................................................................................................ 36

3
1. GENERAL INFORMATION

1.1 System Overview

The Addis Ababa City Public Taxi Zone Assignment and Controlling system is indigenous state of

the art technological solution. It is self-contained system initiated in response to the problems in

the public taxi zone transport management in managing zone and route assignment and

controlling existing major problems and replacing the current traditional multi stand approach in

public taxi zone management.

The system will automate the existing activities in managing and controlling public taxi zone

management by providing up to date and real time information about public taxi zone assignment

and management. In achieving this, the system will be equipped with a large, highly organized

data management system which will play greater role in organizing information and generating

all the necessary reports related to the system’s operation. The system has a main aim of availing

public taxi zone assignment, controlling and real time status information for decision making

process.

The System includes the following features and functionalities:

• A web and android based system

• Manage system user’s information

• Manages the available taxi for the taxi service of the city

• Manage and assigns the zone and routes of the city with the perspective tariff of the city’s

service roads

• Collect taxi users complain and organize

• Take attendance for taxi

• Assign taxi to zones and routes

• Assess the activities of the individual taxi service delivery status

4
The system has two distinct interfaces the first one is web system. Which will be used for in office

purpose to perform major functions like:

• Register and manage User

• Register and manage department and role

• Register and manage Taxi

• Register and manage Zone

• Register and manage Route

• Add and manage tariff

• Assign Public taxi to appropriate zone and route

• Generate status reports

• Gather and interpret customer complaint

The second system is android system with two level of privileges the first privilege is used for

taking attendance of the taxi service which required the login of the user and Taxi management

for driver and owner through PIN number. The other privilege is non-log in required system which

will be used to collect complain from taxi users.

1.2 Organization of the Manual

User’s Manual v0.01.

1.3 Acronyms and Abbreviations

App: Application

System: Addis Ababa City Public Taxi Zone Assignment and Controlling System

AACPTZSCS: Addis Ababa City Public Taxi Zone Assignment and Controlling System

RAD Requirement Analysis Document

5
2. SYSTEM SUMMARY

2.1 System Configuration

The diagram below briefly describes the overall system architecture that the AACPTZSCS uses.

The main parts included in the system:

Figure 1: System Architecture

The mobile Unit

The mobile unit is an android app that will be installed on each android based smart phones so

as to send public taxi attendance report regularly. In addition, it will work for public taxi complain

collection and public taxi unavailability status.

Internet
Internet (WAN) is the infrastructure by which remote users access the system and perform their

designated tasks with respect to their roles and privileges.

6
Central station
This is a place where AACPTZSCS servers reside, all information is stored and where web

application along with database is hosted.

2.2 Data Flows

All major basic information first will be entered using the web-based system in the office by the

respective department employees to make the information easily available to use on android

devices. The information will be validated on both the client side and server sides and will be

stored on the central server.

Field supervisors input license number of the taxi by using an on-screen virtual keyboard to enter

the attendance the driver will confirm the information by using personal pin. The information

inserted by the field supervisor will be stored on the central server. The analysis team will interpret

the gathered information and give the necessary suggestion to resolve any issues with the service

delivery process

2.3 User Access Levels

The system has five different level of user access

• Administrator: -the super admin with the privilege to

o Add and manage role

o Add and manage Department

o Add and manage User

o Block and Unblock User

• Transport Officer: - has the privilege to

o Add and manage Zone

o Add and manage Route

o Add and manage Tariff

o Add and manage Taxi and taxi owner’s information

o Assign Taxi to zone and route

• Field Supervisors:

7
 o Collect taxi attendance on site

• Analysis: -

o View Taxi Attendance, Zone and Route

o Generate Reports

• Taxi owners/Driver

o View their zone and route assignment and respective tariff information

o Report Unavailability

8
3. GETTING STARTED
The AACPTZSCS web system can be accessed using any web browser by the URL-
http://PublicIP(DomainName)/AACPTZACS/Login and the login page will be the first to be
accessed by the user.

3.1 Logging On
On the front page of the AACPTZACS page you will be provided with a login textbox.

Figure 2: Sign in page

A user ID and password is required to log onto all web, android and taxi owner interfaces. But the

complaint management mobile interface is freely accessible without the requirement to login to

the system. Complaint management interface used by Public taxi user to send their comment and

complain regarding public taxi zonal activities.

You must enter a valid user name and password and then click on the [Sing in] button to log into

the system. If you don’t have a username and password ask for a higher privileged user to create

it for you. If you entered either a wrong user name or password, you’ll receive a “Your login

attempt was not successful. Please try again.” message. If you entered the right user name and

password you will be allowed into the system and will be enabled to access the system services

depending on your privilege levels. If you forget your user name and password notify the System

Administrator immediately so you that you can get a new one.

9
 Note: - When you enter the user name and click login some browsers will give you the choice

to remember you afterwards, don’t accept this offer or check the “Remember me next time.”

Checkbox if you are not the only person using that computer. Accepting the Remember me

offer will enable other users to login to the system using your privileges and make unnecessary

changes.

3.2 AACPTZACS System Menu

Figure 3: system menu

The AACPTZACS application interface can be divided into four parts

1. Logging Information

2. Subsystem’s Links

3. Navigation Tree

4. Work Window

A. Logging Information

Here the logged in user’s name and a link to sign out and change password will be displayed.

Note: - Since every action will be logged to the system and any task logged using your name

will imply that you were the user that performed that specific task, you should be extra careful

about using your username and password.

10
 Note: - Make sure that you logout whenever you finished your work or when you want to leave

your workstation, even for a short period of time.

Note: - Anytime if you have the doubt that your user name and password is no longer secret,
you should immediately change it. In fact, you should make changing your password after a
while (every 2 or 3 months) a habit. The way to do so is described in the Changing Password
section.

B. Subsystem Links

This links used to access the work area to perform the activity mentioned on the subsystem link.

C. Navigation Tree

This is used to navigate through pages and to organize links so it would be easier for user to know

the work area or window.

D. Work Window

All the links in the subsystem menu will load a new page into the work window. This window will

be the area where all the tasks will be performed. The work window has controls (buttons, labels,

drop down lists, textboxes, radio buttons, grid view, and table. Hence the user can manipulate

resources by interacting with available controls.

3.3. Changing User ID and Password

In order to change a user password first you have to log in to the system. After logging in, choose

the Change Password links form logging information bar.

Figure 4: Change password link

11
Once the page has been loaded, the user clicks on “Change Password” tab then enter existing

password and the new password twice for confirmation. And after doing so click on the change

password button.

Figure 5: The change password dialog window

3.4 Exit System

The sign out of the system simply press “Sign out” links on the logging information bar.

Figure 6: sign out link

12
4. SYSTEM FUNCTIONALITIES (ONLINE)

4.1. USING the SYSTEM (Online)

The AACPTZSCS system has five access levels and based on their access privilege the user can use

the system functionality. The main system functionalities and the user access levels that have the

privileged of using them have been listed below and the way to perform these functionalities will

be described in details in the sub sections.

System Admin Registration Supervisors Analysis Taxi Owner

User Management ✓

Zone Management ✓ ✓

Route Management ✓

Tariff Management ✓

Taxi Management ✓

Taxi Owner Management ✓

Taxi Driver Management ✓ ✓

Zone Assignment ✓

Attendance Management ✓ ✓

Complain Management ✓

Report Management ✓
Table 1: Functionalities and access privileges-user mapping

4.2. User Management Subsystem

This page only available for administrator user which help to manage the system major users like

(Analyst, Supervisor). The page will give the necessary possible actions to add, update and blocks

in the system. To register a user the administrator should fill the registration form.

After filling the form, the system admin should click on the respective button to add the user into

the system. If there is a problem in the information given the system validates and gives back an

error message and allow the administrator to edit and resubmit. To update a user the

administrator must first select the information form the list to be updated and then he/she will

13
change the necessary information and click on update. The system validates and update the

respective information on the server.

Add User
To add a system user first sign in with Administrator privilege user name and password and then

follow the following steps to create and add new system users.

Step 1: Select Add Account menu

Step 2: when open the Add Account menu Below windows will open

Figure 7: Add New User

Step 3: Enter all Required Information According the forms

Step 4: Save All Information

Step 5: User Registration Completion message will appear

Update User
In order to update and Edit User Account first click a menu Edit Account form Side Bar and click

Edit link on the right corner of the account list.

14
Figure 8: Update User Account

On the next window update records and click the save button. At the completion of updating

and editing records conformation message will display.

Block User
The system has a feature of blocking and unblocking user if security issues happens on the system.

To block a user firs login using Administrator Account and follows the following steps:

Step 1: Click on Block Account Menu from left corner side Menu

Figure 9: Block User Account

Step 2: Search the User Account to be Blocked

Step 3: After Searching and found the user account click on Block link on right corner of user list

Step 4: When you click the Block link new windows will appears as follows

15
Figure 10: Block Account Confirmation

Step 5: Click on Block User Button

Step 6: Check the Conformation Message

Unblock User
In order to unblock the blocked account, use a link UnBlock Account from subsystem links and

follows the same procedures as Blocking Account.

4.3. Zone Management Subsystem

This subsystem allows users to record or register all available public taxi zones. It is by using the

links in the subsystem that a user can view registered zones and their parameters.

To register zones the user first clicks on [Add Zone] link from Zone Management Subsystem

Menu. After doing so the following page will be displayed

Figure 11: Add Zone

16
In Zone Registration user should enter the following field in order to properly record the zone
information such as: Zone Name, Zone Description and Zone Created Date as per the required
data type parameter.

To view Registered zones the user first clicks [View Zone] link from Zone Management Subsystem

Menu. After doing so the following page will be displayed

Figure 12: View Zone

To Update and Delete registered zones first clicks [Edit || Delete] link form Zone list View as

shown below

Figure 13: Update and Deleted Zone

4.4. Route Management Subsystem

This subsystem allows users to record or register all available public taxi route within the zone. It

is by using the links in the subsystem that a user can view registered route and their parameters.

To register route the user first clicks on [Add Route] link from Route Management Subsystem

Menu. After doing so the following page will be displayed.

17
Figure 14: Add Route

To view Registered zones the user first clicks [View Route] link from Route Management

Subsystem Menu. After doing so the following page will be displayed

Figure 15: View Route

To Update and Delete registered route first clicks [Edit || Delete] link form route list View and

follow on screen dialogue.

18
Figure 16: Update and Deleted Zone

4.5. Tariff Management Subsystem

This subsystem allows users to record or register all available public taxi tariff information within

the zone. It is by using the links in the subsystem that a user can view registered and updated

tariffs and their parameters. To register tariff the user first clicks on [Add Tariff] link from Tariff

Management Subsystem Menu. After doing so the following page will be displayed.

Figure 17: Add Zone

To view Registered Tariffs the user first clicks [View Tariff] link from Tariff Management

Subsystem Menu. After doing so the following page will be displayed

19
Figure 18: View tariff

To Update and Delete registered tariff first clicks [Edit || Delete] link form tariff list View as shown

below

Figure 19: Update and Delete tariff

4.6. Taxi Management Subsystem

This subsystem allows users to record or register all available public taxi data. It is by using the

links in the subsystem that a user can view registered public taxi and their parameters.

To view Registered Taxi the user first clicks [View Taxi] link from Taxi Management Subsystem

Menu. To Update and Delete registered taxi use [Edit || Delete] link form Taxi list View.

4.7. Taxi Owner Management Subsystem

This subsystem allows users to record or register all available public taxi owner information within

the zone. It is by using the links in the subsystem that a user can view registered public taxi owner

and their parameters.

20
To register public taxi owner the user clicks on [Add Taxi Owner] link from Taxi Owner

Management Subsystem Menu. To view Registered Taxi owner the user clicks [View Taxi Owner]

link from Taxi Owner Management Subsystem Menu. To Update and Delete registered Taxi Owner

clicks [Edit || Delete] link form Taxi Owner list View.

4.8. Driver Management Subsystem

This subsystem allows users to record or register all public taxi driver within the zone. It is by using

the links in the subsystem that a user can view registered driver and their parameters.

To register driver the user first clicks on [Add Driver] link from Driver Management Subsystem

Menu. After doing so the following page will be displayed.

Figure 20: Add Driver

To view Registered driver the user first clicks [View Driver] link from Driver Management

Subsystem Menu. After doing so the following page will be displayed

21
Figure 21: View Driver

To Update and Delete registered Driver first clicks [Edit || Delete] link form Driver list View as

shown below

Figure 22: Update and Deleted Zone

4.9. Zone Assignment Subsystem

This subsystem allows Transport officers to Assign public taxi to zones and route. It is by using

the links in the subsystem that a user can Assign zones and their parameters.

To Assign zones the user first clicks on [Add Zone Assignment] link from Zone Management

Subsystem Menu. After doing so the following page will be displayed.

22
Figure 23: Add Zone Assignment

Based on the pages the user first enters assignment starting date and assignment end date. This

is from RAD document which zonal assignment works for a fixed month so the user expected to

enter starting and ending zone. In most cases the zone period is one month after end of each

month zone assignment will proceed for the next month. After that the user should select the

Zone name which is registered under zone management, while selecting appropriate zone the

system displays all available zone within the selected zone. The Zone assignment process use a

load factor parameter which was assigned for each route in the route registration, the load factor

ranges from high to low representing with number 1 up to 5. So, the user after getting available

route for zone assignment press [Assign] button to finalize the zone assignment process and

display conformation message.

Note: Zone assignment process takes available route with their load factor values as a first

parameter and number of public taxis within the selected zone as a second parameter. Then

takes high percentage of public taxi with high load factor number and finalize zone assignment

process.

23
To view Registered zones the user first clicks [View Zone Assignment] link from Zone

Management Subsystem Menu. After doing so the following page will be displayed

Figure 24: View Zone

To Update and Delete registered zones first clicks [Edit || Delete] link form Zone list View as

shown below

Figure 25: Update and Deleted Zone

4.10. Mobile Apps

4.10.1. Attendance Management

This is an android interface is accessed only by the field supervisors to take attendance of the taxi

that are available for the service. From any android based smart phone press mobile app as

follows:

24
Figure 26: public taxi mobile app

25
After doing that the following dialog will open

Figure 27: Mobile apps main page

As shown above the user clicks on [connect to the system] button to access the attendance
page. While pressing the button User Menu Selection page will automatically loaded

Figure 28: Mobile Apps User Selection Menu

26
From user type drop down list select Supervisor/ተቆጣጣሪ option to enter the attendance record
page. After selecting the option Attendance Login page will display.

Figure 29: Attendance Mobile Apps Login page

To login to attendance management page, the supervisor should first enter the user name and
password which created by system admin for supervisor. After successfully setting the user name
and password the login page will disappear and attendance record page loaded in new window.

27
Figure 30: Attendance record

In order to record attendance of the public taxi zone dispatching activities, the supervisor first

search or enter the plate number of the taxi. Searching and Enter plate number will automatically

retrieve zone and route information of the given plate number. To finalize recording of attendance

of the taxi the supervisor expected to Enter attendance date through press calendar icon,

confirming and validation all records automatically process at background and lead the supervisor

to press the [Enter] button for final recording of daily attendance of the public taxi zone activities.

28
4.10.2 Unavailability Report subsystem
This subsystem will focus for reporting of public taxi unavailability, in which the public taxi would

be out of service for several reason and it is expected to information the Addis Ababa city

transport authority for its condition. This subsystem uses a mobile apps to easily transfer the

public taxi condition and the subsystem can only accessed by public taxi driver those who

assigned by public taxi owner as a driver. The application runs on android based smart phones.

In order to use the system, the driver first tab the icon of android apps as figure 30 and follows

the same process as figure 31 and 32.

Form the user type menu of figure 32 select taxi driver, after doing that the following page will

load automatically:

Figure 31: Driver PIN

PIN number it is generated while registration of public taxi and received by public taxi owner for

management public taxi service in the city. Therefore, the public taxi can transfer the PIN number

to his/her Driver.

29
The Driver will Enter the PIN number to go through unavailability report subsystem. unavailability

report subsystem interface looks as below and the driver expected to enter reason and date of

absence/unavailability and to send the status press the [ላክ] button.

Figure 32: unavailability /absence report

4.10.3 Public Taxi User Complain Subsystem

In this subsystem it is required to gather user complain and comment regarding public taxi zonal

service. The system will use android apps which runs on android based smartphones and

integrated with central station system. The android app will help the public taxi users to send

them complain while they use the services. The user should have android-based smartphone and

expected to download the android mobile app from the agency’s website or google play store.

After downloading and installing the application, the user tab the icon as figure 30 and follows

the same process as figure 31 and 32.

30
Form the user type menu of figure 32 select taxi user, after doing that the following page will load

automatically:

Figure 33: Public taxi user complain

While the user Enter or Search the plate number, the system automatically displays zone, route,

and tariff information related to the given plate number. So, the user expected to enter date and

comment accordingly and finally press the [ላክ] button to send the complaint.

31
4.10.4 Public Taxi Status Subsystem
This subsystem will help the public taxi owners to get the information related to zone, route and

tariff. The public taxi owner can access the system through mobile app similar to above

subsystems. The public taxi owner expected to have a smartphone capable of running android-

based apps and internet connection.

To manipulate the application and get information, the public taxi owner first tab icon on android

based smartphone and follow the same procedure as previous subsystems. Following all steps

finally the following page will be loaded

Figure 34: Public Taxi

As show above figure, the public taxi owner expected to see the status information only means
zone, route and tariff information.

32
To view Registered zones the user first clicks [View Zone Assignment] link from Zone

Management Subsystem Menu. After doing so the following page will be displayed.

Figure 35: View Zone

To Update and Delete registered zones first clicks [Edit || Delete] link form Zone list View as

shown below

Figure 36: Update and Deleted Zone

4.11 Report Management Subsystem

This subsystem designed for analysis team those are working on analysis of public taxi zonal

assignment activities and operation. The subsystem will help the analysis team through graphical

representation of activities and process of zone activities. This means the system will display zone

and attendance information in bar graph.

33
In order to use the subsystem, the analysis team enter in to the system with appropriate user

name and password. The separate window will display after authentication of analysis team

username and password and the windows looks as show below.

Figure 37: Analysis team window

The analysis team simply access the system by clicks the following sub menus:

• Zone Report

• Attendance Report

• Complain Report
Zone Report
In this sub menu the analysis team first select zone name and the system will populate the bar
graph with number of registered zones, Number of Registered Route, Assigned Zone, Active Zone
in the form of report as show below:

34
Figure 38: Zone Report

Attendance Report
In this sub menu the analysis team first enter date ranges from and end date and the system will
populate the bar graph with the following report parameter number of registered taxis, number
of available taxis, number of routes, Number of zones, number unavailability taxi in the form of
report as show below.

Figure 39: Attendance Report

35
Complain Report
In this sub menu the analysis team first enter date ranges from and end date and the system will
populate the bar graph with the following report parameter over charge, out of zone, and ethics
in the form of report as show below.

Figure 40: complain Report

36