Professional Documents
Culture Documents
Page
1.0 INTRODUCTION ............................................................................................................... 2
2.0 OVERALL DESCRIPTION .................................................................................................... 2
2.1
2.2
2.3
2.4
2.5
2.6
2.7
Product Perspective.................................................................................................................... .2
Product Features ......................................................................................................................... 3
User Classes and Classification .................................................................................................... 3
Operating Environment ............................................................................................................... 3
Design and Development Constraints ......................................................................................... 3
Assumptions and Dependencies ................................................................................................. 4
System Standard Formatting ....................................................................................................... 4
Dashboard ................................................................................................................................... 4
Business Plan ............................................................................................................................... 5
Project.......................................................................................................................................... 5
Schedule of Prices ........................................................................................................................ 5
Variation Order ............................................................................................................................ 5
Project Progress ........................................................................................................................... 5
Import and Export Database ....................................................................................................... 5
Reports ........................................................................................................................................ 5
Page 1
1.
INTRODUCTION
The scope of this project is to create and implement the CAPEX Project Monitoring System
(CPMS).The CPMS aims to develop a computer based monitoring and reporting system that
will provide a routine flow of information from the field level to the MWSS-RO, based on
predefined indicators, combined with periodic supervision and verification of the project
activities and associated inputs.
This project aims to establish a system that would provide an interface for storage of project
related data and for generation of report documents for verification and analysis of CAPEX
Projects.
2.
OVERALL DESCRIPTION
2.1.
Product Perspective
The CPMS is a new computer-based system that would serve as data banking system of
project related information. The system would replace the current procedures in storing and
creating reports for MWSS-RO.
Page 2
2.2.
Product Feature
The CPMS shall include the following capabilities and features:
Data entry of Approved Business Plan
Data entry of CAPEX projects actual implementation information and updates
o Schedule of Prices
o Variation Order
o Project details
o Project Progress (project updates)
Generate and view reports
o Approved Business Plan
o Asset Investment Report
o Asset Investment Report with variation Order
o Comparison of Business Plan to Commitment
2.3.
2.4.
Operating Environment
The CPMS operates with the following Web browsers:
Microsoft Internet Explorer 9 or better
Mozilla Firefox 7.0.1 or better
Google Chrome 14.0 or better
Safari 5.0 or better
2.5.
Page 3
The framework used to develop the system is CodeIgniter. For more details visit
http://codeigniter.com/
2.6.
2.7.
3.
MODULE DESCRIPTIONS
3.1.
Dashboard
The dashboard displays all the different features which are available for the user. The goal of
the dashboard is to automatically show the user links to functions in a usable and friendly
way.
Page 4
3.2.
Business Plan
This feature allows the user to enter data based on the approved business plan for each
concessionaire. Users may be able to add/edit/delete program descriptions and
add/edit/delete budget allocation for each program for a certain year. Approved Business
Plan may also be viewed from this module.
3.3.
Project
This feature enables the two concessionaires to create and input the project details. This
module is necessary for the creation of schedule of prices, variation order, monthly
accomplishment and all the reports being generated by the system.
3.4.
Schedule of Prices
This feature enables the two concessionaires to input the approved schedule of prices for
each project. Users may be able to add/edit/delete work descriptions and add/edit/delete
details for each specific item for the project. Data entered from this interface shall be used
for the different reports specified in this document. Viewing of the schedule of prices shall
be included in this module.
3.5.
Variation Order
This feature allows the input and view of Variation Order for specific projects. It may be an
over run, under run or non-bid items. Data from this module will be used in the generation
of different reports.
3.6.
Project Progress
On this module, the user shall input the summary of disbursement on a monthly basis
related to the resources or work done for a project within the specified period of coverage.
Items which are included in the original schedule of prices shall be added here in this
module.
3.7.
3.8.
Reports
Reports generated from the system shall conform to the existing reports being submitted
and analysed by the MWSS-RO and the two concessionaires. This feature allows the user to
Page 5
generate the following reports based on the data inputted from the various forms
mentioned:
4. DATABASE DESIGN
The Entity Relation Diagram (ERD) below represents the relationships between the tables within
the database for the system.
5. INSTALLATION PROCEDURES
5.1.
XAMPP Installation
1. Secure a copy of the XAMPP Installer or get the latest stable version of XAMPP on
http://www.apachefriends.org/en/xampp-windows.html
Page 6
In this guide, we are installing XAMPP 1.7.7 on Windows. This version consists of the
following components:
Apache 2.2.21
MySQL 5.5.16
PHP 5.3.8
phpMyAdmin 3.4.5
FileZilla FTP Server 0.9.39
Tomcat 7.0.21 (with mod_proxy_ajp as connector)
2. Locate the XAMPP installer then double click the icon. Note: You must have
Administration access in Windows to be able to install XAMPP.
3. When a User Account Control Warning occurs, click on the Yes button to continue with
the installation.
Page 7
5. You will be prompted with the XAMPP Setup Wizard. Click Next to begin installation.
7. On the SERVICE SECTION, check on the Install Apache as service and Install MySQL as
service. Click on Install.
Page 8
8. Wait for about 5 minutes while the XAMPP install is completed. Click the Finish button.
9. Wait for another 30 seconds while the Services is being started. Click on Yes to continue.
10. XAMPP Control Panel will be loaded. Make sure that Apache and MySQL are both
running.
11. Open
a
browser
(Recommended:
Mozilla
Firefox)
then
type
in
http://localhost/xampp/index.php on the address bar. If you can access the page on
figure 9, this confirms that you have successfully installed the system and it is currently
running properly.
CAPEX Project Monitoring System Users Manual
Page 9
Note: For more reference and troubleshooting visit the documentation of XAMPP online at
http://www.apachefriends.org/en/faq-xampp.html.
5.2.
Firefox)
then
type
in
Page 10
4. You will now see the Security Console. Fill up the form properly with the password found
on the supplied READ ME file.
Page 11
5.3.
Figure 16 privileges
Figure 17 Privileges
Page 12
4. On the password field, type in the Mysql Root password provided in the README file.
Click Go button.
Page 13
14. Your database is now ready, you may now open a web browser and open
http://localhost/cpms-mwsi to check if your installation is successful.
Note: Repeat steps for cpms-mwci.zip.
6.
TUTORIAL
6.1.
Business Plan
The Business Plan Module allows the user to enter data based on the approved business
plan for each concessionaire. Users are allowed to add/edit/delete Program Descriptions
and budget allocation for each program for a certain year.
The default page of this module is the Business Plan Listing Page.
6.1.1. Viewing the Business Plan Listing
There are two ways to access the Business Plan Listing:
On the Main Menu, click on the Dashboard icon. Under the Business Plan category, click
on the Business Plan Listing icon.
Dashboard icon
Main Menu
Dashboard
Business Plan Listing icon
Page 14
On the Main Menu, click on the Business Plan icon. It will automatically load the
Business Plan Listing page by default.
Note: You can use the pagination buttons located at the top of the Business Plan Listing for
easy navigation of business plan results.
Page 15
Page 16
3. On the Business Plan Details page, provide entries for concessionaire, title, start year
and end year fields. Click on the Save button.
4. To add a Program Description, provide a Category Name and its Code. Click on the Save
button.
Category Name input box
Save button
Page 17
6. To provide the budget allocation for each year for a certain program, enter the amount
in the specific year field adjacent to the Program Description. Click on the Submit
button.
6. To add another Program Description, refer to Step 5. Program Description input fields
are located at the lower part of the form.
7. To add another Program Description under a certain Program Description item, click on
the Add button
that corresponds to the selected Program Description. The Program
Description input fields will then appear just below the selected Program Description
row. Click on the Save button if you want to save the Program Description, else click on
the Cancel button.
Page 18
8. To finalize the business plan, click on the Finalize Business Plan button.
Note: Start and End Year drop-down boxes will be available if any Program Description
has not yet declared its budget allocation for each year.
Page 19
Note: To display the Code of a Program Description, click on the Show Code button that
corresponds to the Program Description. Hide Code button will be available once the code is
displayed.
5. To delete a Program Description, click on the Delete button (refer to the image above)
that corresponds to the Program Description. A dialog box will display for verification.
Click on the OK button if you want to continue to delete the Program Description, else
click on Cancel button.
Page 20
6. To update the Amount of a Program Description, click on the Update button that
corresponds to the Program. Amount input boxes will then be displayed to allow
modification. Click on the Save button.
Note: If the selected Business Plan is final, modification of its details is not allowed.
Page 21
Page 22
Page 23
3. A dialog box will display for verification. Click on the OK button if you want to continue
to delete the business plan, else click on Cancel button.
Page 24
6.2.
Managing Projects
The Project module allows the user to create new projects and sub-projects based on the
business plan.
6.2.1. Create New Project
1. On the Main Menu, click on the Create New Project icon. It will load the New Project
page by default.
2. The New Project page has 3 different areas. Category is on the top left, Business Plan is
on the top right and the Project Details at the bottom. By default, the Category will show
up - No category selected. This means that there is actual category connected to the
project since this is a new project.
3. You must first fill-up the Project Details Area. Those fields with * red asterisk mark are
required to be filled up, while the other are optional fields. Project Code is automatically
generated based on the Category selected after you have saved the project. Contract
Year is also automatically retrieved based on the contract effectivity date.
4. Once the form is complete, you may click on Save button to submit the project.
5. After saving, you may now select the Category to which this project belongs to.
Page 25
Page 26
6.3.
Page 27
2. On the Project Listing page, click on the row of the Project which the Variation
Orders associated with. This will redirect you to the Project Details page.
Note: On the Project Details page, there are three (3) buttons intended for
managing Variation Orders: V.O. Underrun, V.O. Overrun and V.O. - Extra Work
Order buttons.
Page 28
Page 29
Page 30
Page 31
Page 32