Department of Computer Science &

Information Technology

University of Sargodha

Final Project Guide Book

Version 1.0
Revision History
This section describes the revision history of this document.

Date Version Description of Change Author

October 10, 2012 1.0 First Draft of Final Project Deliverable Guideline Project Coordination
Office

Distribution List
This section describes the distribution list for the recipients of this document.

Recipient Role / Designation Office Contact Details

Muhammad Ikram ul haq Lecturer Department of Computer mikram01@uos.edu.pk

Science & Information ikramulhaq032@gmail.com
Technology
TABLE OF CONTENTS
CHAPTER 1: FINAL PROJECT PROPOSAL..............................................................7
1.1 INTRODUCTION...........................................................................................................7
1.2. PROJECT TITLE:.........................................................................................................8
1.3. PROJECT OVERVIEW STATEMENT:.............................................................................8
1.4. PROJECT GOALS & OBJECTIVES:............................................................................10
1.5. HIGH-LEVEL SYSTEM COMPONENTS:.......................................................................10
1.6. LIST OF OPTIONAL FUNCTIONAL UNITS:..................................................................10
1.7. EXCLUSIONS:...........................................................................................................11
1.8. APPLICATION ARCHITECTURE:................................................................................11
1.9. GANTT CHART:........................................................................................................11
1.10. HARDWARE AND SOFTWARE SPECIFICATION:......................................................12
1.11. TOOLS AND TECHNOLOGIES USED WITH REASONING:...........................................12
CHAPTER 2: FIRST DELIVERABLE.........................................................................13
2.1. INTRODUCTION........................................................................................................13
2.2. PROJECT/PRODUCT FEASIBILITY REPORT...............................................................14
2.2.1. Technical Feasibility.......................................................................................14
2.2.2. Operational Feasibility...................................................................................14
2.2.3. Economic Feasibility.......................................................................................14
2.2.4. Schedule Feasibility........................................................................................15
2.2.5. Specification Feasibility..................................................................................15
2.2.6. Information Feasibility....................................................................................15
2.2.7. Motivational Feasibility..................................................................................15
2.2.8. Legal & Ethical Feasibility.............................................................................15
2.3. PROJECT/PRODUCT SCOPE......................................................................................15
2.4. PROJECT/PRODUCT COSTING..................................................................................15
2.4.1. Project Cost Estimation By Function Point Analysis......................................16
2.4.2. Project Cost Estimation by using COCOMO’81 (Constructive Cost Model).18
2.4.3. Activity Based Costing.....................................................................................19
2.5. TASK DEPENDENCY TABLE.....................................................................................19
2.6. CPM - CRITICAL PATH METHOD............................................................................20
2.7. GANTT CHART.........................................................................................................23
2.8. INTRODUCTION TO TEAM MEMBER AND THEIR SKILL SET......................................24
2.9. TASK AND MEMBER ASSIGNMENT TABLE..............................................................24
2.10. TOOLS AND TECHNOLOGY WITH REASONING.......................................................27
2.11. VISION DOCUMENT...............................................................................................27
2.12. RISK LIST..............................................................................................................28
2.13. PRODUCT FEATURES/ PRODUCT DECOMPOSITION...............................................29
CHAPTER 3: SECOND DELIVERABLE FOR OBJECT ORIENTED APPROACH
...........................................................................................................................................30
3.1 INTRODUCTION:........................................................................................................30
3.1.1 Systems Specifications......................................................................................31
3.1.2. Identifying External Entities............................................................................32
 3.1.3. Context Level Data Flow Diagram:................................................................32
3.1.4. Capture "shall" Statements:............................................................................32
3.1.5. Allocate Requirements:...................................................................................32
3.1.6. Prioritize Requirements:.................................................................................33
3.1.7. Requirements Trace-ability Matrix:................................................................33
3.2. EXAMPLE:................................................................................................................33
3.2.1. Introduction.....................................................................................................33
3.2.2. Existing System................................................................................................33
3.2.3. Scope of the System.........................................................................................34
3.2.4. Summary of Requirements:(Initial Requirements)..........................................35
3.2.5. Identifying External Entities:..........................................................................36
3.2.6. Capture "shall" Statements:............................................................................37
3.2.7. Allocate Requirements:...................................................................................38
3.2.8. Priorities Requirements:.................................................................................39
3.2.9. Requirements Traceability Matrix:.................................................................43
3.2.10. High Level Usecase Diagram:......................................................................44
3.2.11. Analysis Level Usecase Diagram:.................................................................47
3.2.12. Usecase Description......................................................................................47
CHAPTER 4: THIRD DELIVERABLE FOR OBJECT ORIENTED APPROACH49
4.1. INTRODUCTION:.......................................................................................................50
4.2. DOMAIN MODEL......................................................................................................50
4.3. SYSTEM SEQUENCE DIAGRAM................................................................................51
4.4. SEQUENCE DIAGRAM..............................................................................................51
4.4.1. Defining a Sequence diagram.........................................................................52
4.4.2. Basic Sequence Diagram Symbols and Notations...........................................52
4. 4.3. Example..........................................................................................................55
4.4.4. Distributing Control Flow in Sequence Diagrams..........................................55
4.5. COLLABORATION DIAGRAM....................................................................................58
4.5.1. Contents of Collaboration Diagrams..............................................................59
4.5.2. Constructs of Collaboration Diagram:...........................................................60
4.6. OPERATION CONTRACTS.........................................................................................61
4.7. DESIGN CLASS DIAGRAM........................................................................................61
4.7.1. Create Initial Design Classes..........................................................................62
4.7.2. Designing Boundary Classes...........................................................................62
4.7.3. Designing Entity Classes.................................................................................62
4.7.4. Designing Control Classes..............................................................................62
4.7.5. Identify Persistent Classes...............................................................................63
4.7.6. Define Class Visibility.....................................................................................64
4.7.7. Design Class Relationships.............................................................................68
4.8. STATE CHART DIAGRAM..........................................................................................72
4.9. DATA MODEL..........................................................................................................73
CHAPTER 5: 2ND & 3RD DELIVERABLE FOR STRUCTURED APPROACH. .78
5.1. INTRODUCTION:.......................................................................................................79
5.2. ENTITY RELATIONSHIP DIAGRAM:..........................................................................79
5.3. DATA FLOW DIAGRAM (FUNCTIONAL MODEL).......................................................81
 5.4. STATE TRANSITION DIAGRAM................................................................................85
5.5. ARCHITECTURAL DESIGN........................................................................................86
5.6. COMPONENT LEVEL DESIGN...................................................................................90
CHAPTER 6: 4TH DELIVERABLE (USER INTERFACE DESIGN)........................91
6.1. INTRODUCTION........................................................................................................92
6.2. SITE MAPS...............................................................................................................92
6.3. STORY BOARDS.......................................................................................................93
6.4. NAVIGATIONAL MAPS:............................................................................................94
S1: MICROSOFT PRODUCTS.....................................................................................94
6.5 TRACE-ABILITY MATRIX..........................................................................................95
CHAPTER 7: 5TH DELIVERABLE (SOFTWARE TESTING)..................................96
7.1 INTRODUCTION:........................................................................................................97
7.2. TEST PLAN...............................................................................................................97
7.2.1. Purpose............................................................................................................97
7.2.2. Outline.............................................................................................................97
7.3. TEST DESIGN SPECIFICATION.................................................................................101
7.3.1. Purpose..........................................................................................................101
7.3.2. Outline...........................................................................................................101
7.4. TEST CASE SPECIFICATION...................................................................................104
7.4.1. Purpose..........................................................................................................104
7.4.2. Outline..........................................................................................................104
7.5. TEST PROCEDURE SPECIFICATION..........................................................................106
7.5.1. Purpose..........................................................................................................106
7.5.2 Outline............................................................................................................106
7.6. TEST ITEM TRANSMITTAL REPORT.........................................................................107
7.6.1. Purpose..........................................................................................................108
7.6.2. Outline...........................................................................................................108
7.7. TEST LOG...............................................................................................................109
7.7.1. Purpose.........................................................................................................109
7.7.2. Outline...........................................................................................................109
7.8. TEST INCIDENT REPORT.........................................................................................110
7.8.1. Purpose..........................................................................................................110
7.8.2. Outline...........................................................................................................110
7.9. TEST SUMMARY REPORT.......................................................................................111
7.9.1. Purpose..........................................................................................................111
7.9.2. Outline...........................................................................................................111
APPENDIXES:..............................................................................................................113
APPENDIX 1: USER INTERFACE............................................................................114
1.1. INTRODUCTION......................................................................................................114
1.2. FOCUS ON USERS...................................................................................................114
1.3. INTEGRATED WITH DESIGN....................................................................................114
1.4. EARLY USER TESTING............................................................................................115
1.5. ITERATIVE DESIGN.................................................................................................115
 1.6. GUIDELINES...........................................................................................................115
APPENDIX 2: GUIDELINES FOR RESEARCH PROJECTS................................130
APPENDIX 3: FINAL DOCUMENTATION FORMAT GUIDELINES................132
APPENDIX 4:FINAL DOCUMENTATION INTIAL PAGES................................136
APPENDIX 5: FINAL EVALUATION MATRIX FOR DEVELOPMENT PROJECTS
.........................................................................................................................................140
APPENDIX 6: FINAL EVALUATION MATRIX FOR RESEARCH PROJECTS142
APPENDIX 7: FINAL EVALUATION MATRIX FOR NETWORK PROJECTS143
APPENDIX 8: FINAL EVALUATION METRIC.....................................................144
APPENDIX 9: PROJECT REGISTRATION FORM...............................................145
APPENDIX 11: EVALUATION DELAY REQUEST FORM..................................147
APPENDIX 12: SHOW CAUSE FORM.....................................................................148
APPENDIX 13: PROJECT RENROLLEMNT FORM.............................................149
APPENDIX 14: CHANGE REQUEST FORM..........................................................150
Chapter 1: Final Project Proposal

1.1 Introduction
This guide will tell you how to prepare and submit the final project proposal that is the
documented work for the Project. A good project proposal must define the functional and non-
functional requirements in unambiguous statements, Scope of the Project, Development
Schedule, Development Process, Techniques, Tools, Platform with reasoning. However, a
professional and well-defined proposal should be composed under the following headings;

a. Project Title
b. Project Overview Statement
c. Project Goals
d. Project Objectives
e. High Level System Components
a. Component No.1
b. Component No.2
 c. Component No.3
d. Component No.4
i. ………..
f. List of Optional Functional Units
g. Exclusions
h. Application Architecture
i. Gantt chart

1.2. Project Title:

The title should be clear and unambiguous (do not make it "cute"). Think of your title as a mini-
abstract. A good title should paint a quick picture for the reader of the key idea(s) of your
project. The words you use in your title should clearly reflect the focus of your proposal. The
most important words should come first, then the less important words. Try to remove words
from your title that really are not necessary for understanding. Try and use only a single sentence
for your title. If the sentence is getting too long try removing some words. When all else fails try
using a two-part title with the parts separated by a colon (use only as a last resort!). Do not
attempt to use the title as an abstract of your entire proposal. If your proposal is built on
collaborating with other groups/organizations it is usually a good idea to include their names on
the Title/Cover Page.

1.3. Project Overview statement:

Think of the Project Overview as an Executive Summary (the busy executive probably only has
enough time to read your Overview - not the entire proposal). Be specific and concise. Do not go
into detail on aspects of your proposal that are further clarified at a later point in your proposal.
The Project Overview should "paint a picture" of your proposal in the mind of the reader. It
should establish the framework so that the rest of the proposal has a frame of reference. Use the
Project Overview to begin to show your knowledge of the organization from which you are
requesting funds. Key concerns of the funding organization can be briefly identified in relation to
your proposed project. If you will be collaborating with other organizations make sure some of
their interests are also highlighted in the Project Overview. This can assist in strengthening the
collaboration by recognizing them at the very beginning of your proposal. The best time to
prepare the Project Overview is after you have completed the entire proposal (and you
understand all aspects of your proposal very well). Let the Overview be your last piece of writing
and then insert it at the beginning of your proposal. Try to keep in mind that someone will be
reviewing your proposal and you would like to have this person be very positive about what you
have written. The Project Overview will probably form a strong impression in the mind of the
reviewer. Work on your Project Overview so that you can avoid giving this person the
opportunity to say things like:

1. Not an original idea

2. Rationale is weak
3. Writing is vague
4. Uncertain outcomes
5. Does not have relevant experience
6. Problem is not important
7. Proposal is unfocused
 8. Project is too large.

Project Overview Statement Template

Project Title:

Project Manager:
Project Members:
Name Registration # Email Address Signature

Project Goal:

Objectives:
Sr.
#
1
2
3
4
5
6

Project Success criteria:

Assumptions, Risks and Obstacles:

Organization Address (if any):

Type of project: Research Development

Target End users:

Development Technology: Object Oriented Structured

Platform: Web based Distributed
Desktop based Setup Configurations
Other_____________________
Approved By:
Date:

1.4. Project Goals & Objectives:

Try and differentiate between your goals and your objectives - and include both. Goals are the
large statements of what you hope to accomplish but usually aren't very measurable. They create
the setting for what you are proposing. Objectives are operational, describe specific things you
will be accomplishing in your project, and are very measurable. Your objectives will form the
basis for the activities of your project and will also serve as the basis for the evaluation of your
project. Try to insure that there is considerable overlap between the goals and objectives for your
proposal and the goals and objectives of the funding organization. If there is not a strong overlap
of goals and objectives then it might be best to identify a different funding organization.
Measurable objectives for your project should be presented. If you are dealing with "things" it is
easier for them to be measured than if you are dealing with abstract ideas. Your proposal is easier
for a prospective funding organization to understand (and the outcomes are much more clear) if
you describe your objectives in measurable ways.

1.5. High-level system components:

Information about the main functional units of the entire system should be present. Functional
units to be included will be the inclusive components of the project developed so that the system
must perform without taking any physical constraint into consideration. High-level system
components are generally, a set of cooperating components assembled together to deliver a
solution to a problem. They are frequently identified in terms of inputs, outputs, processes, and
stored data that are needed to satisfy the system improvement objectives. If these components are
missing the system fails to fulfill its primary mission.

1.6. List of optional functional units:

A list of functional units should be present which would include a description of other features,
characteristics, and constraints that define a satisfactory system. These functional units would be
developed under certain conditions (technology, expertise, or time dependent). Examples of
these optional functional units would include performance (throughput and response time); ease
of learning and use; budgets, costs, and cost savings; timetables and deadline; documentation and
training needs; quality management; and security and internal auditing controls.
They are often requirements that specify need of compliance with any legal and regulatory
requirements. They can also be design constraints due to the operating system used, the platform
environment, compatibility issues, or any application standards that apply. In general, you can
say that any requirement that does not allow for more than one design option should be regarded
as a design constraint.
If the optional functional units are missing the system can still (for a while) fulfill its
fundamental mission, but with degraded service quality.
While gathering and validating the optional functional requirements, maintain Assumptions and
Issues lists.
Some activities will not give you satisfactory answers. This can be due to lack of information, or
simply because you consider the answer threatens the viability of the design. Therefore, create
two lists, and maintain them through the design study:
Any assumptions you make during the requirements and design process, including the rationale
or thought processes behind those assumptions. Assumptions may be used to identify related
subprojects or items of work, which are outside the scope of or after this project any major issues
(significant concerns that could become show-stoppers).
The issues should be reviewed with the customer at the end of each phase. The assumptions need
to be reviewed also, at the end of each phase, but the customer might not always be the correct
person for the less important ones.
Assumptions and issues apply to all artifacts, but are particularly common for non-functional
requirement.

1.7. Exclusions:
A list of the functional units, which will not be intended to be develop or discussed during any
point in the project development, should be present. Time constraints or lack of resources for the
fulfillment of the required task or any sort of other constraint preventing the completion of the
functional unit could be described here.

1.8. Application Architecture:

Defines the overall application architecture e.g. a two-tier architecture or a three-tier architecture.
It must contain a diagram depicting the system architecture properly
Architecture is the highest-level concept of a system in its environment. The architecture of a
software system (at a given point in time) is its organization or structure of significant
components interacting through interfaces, those components being composed of successively
smaller components and interfaces.
Architecture can also be defined as the organizational structure of a system. Architecture can be
recursively decomposed into parts that interact through interfaces, relationships that connect
parts, and constraints for assembling parts. Parts that interact through interfaces include classes,
components and subsystems.
There are a number of typical patterns of distribution in systems, depending on the functionality
of the system and the type of application. In many cases, the distribution pattern is informally
used to describe the 'architecture' of the system, though the full architecture encompasses this but
also many more things. For example, many times a system will be described as having’ client-
server architecture', although this is only the distribution aspect of the architecture.

1.9. Gantt chart:

The Gantt chart enumerates the activities to be performed on the vertical axis and their
corresponding duration on the horizontal axis. It is possible to schedule activities by either early
start or late start logic. In the early start approach; each activity is initiated as early as possible
without violating the precedence relations. In the late start approach; each activity is delayed as
much as possible as long as the earliest finish time of the project is not compromised.
Based on the Work Breakdown Structure (WBS), a timeline or Gantt chart showing the
allocation of time to the project phases or iterations should be developed. This Gantt chart would
identify major milestones with their achievement criteria. It must contain duration estimation of
all the necessary activities to be carried out during the project development along with the human
resources responsible for the respective tasks. Activity dependencies are also required to be
mentioned in it.
Sample Gantt chart
Jul 6, '03 Jul 13, '03 Jul 20, '03
ID Task Name Duration Start Finish Predecessors W T F S S M T W T F S S M T W T F S
1
2 billing 7 days Thu 7/10/03 Fri 7/18/03
3 computing 8 days Mon 7/14/03 Wed 7/23/03
4 accounting 3 days Mon 7/14/03 Wed 7/16/03
5 marketing 10 days Mon 7/21/03 Fri 8/1/03 2
1.10. Hardware and Software Specification:
Any hardware or software specifications e.g. machine type required, operating system and other
utilities should be clearly specified for the system to be developed.

1.11. Tools and technologies used with reasoning:

The application tools, which are to be used on front and back end of the system to be developed,
should be listed. The reasons for these tools should also be enlisted.
Identify what the needs for tool support are, and what the constraints are, by looking at the
following:
 The development process. What tool support is required to effectively work? For
example, if the organization decide to employ an iterative development process, it is
necessary to automate the tests, since you will be testing several times during the project.
 Host (or development) platform(s).
 Target platform(s).
 The programming language(s) to be used.
 Existing tools. Evaluate any existing and proven tools and decide whether they can
continue to be used.
 The distribution of the development organization. Is the organization physically
distributed? Development tools generally support a physically distributed organization
differently.
 The size of the development effort. Tools support large organizations more or less well.
 Budget and time constraints