Handy Handicap

Document Sample
Handy Handicap Powered By Docstoc
					The Handy Handicap System User Manual                   1
8/8/2012




                               Handy Handicap

                                 User Manual

                              Thomas A. Garubba

                              December 1, 2003

                        Advisor: Dr. Robert McCloskey

                        CMPS 490 – Computer Projects
The Handy Handicap System User Manual                                                                                              2
8/8/2012


Chapter 1: Introduction ................................................................................................... 3
 1.1 Purpose..................................................................................................................... 3
 1.2 Scope......................................................................................................................... 3
 1.3      Glossary ............................................................................................................. 4
 1.4 References ................................................................................................................ 6
 1.5 Overview of Document ........................................................................................... 7
Chapter 2: Instructional Manual .................................................................................... 8
 2.1 Normal System Usage ............................................................................................. 8
    2.1.1 Logging In ......................................................................................................... 8
       2.1.1.1 Logging in .................................................................................................. 8
       2.1.1.2 Registering ................................................................................................. 9
       2.1.1.3 Forgotten Password .................................................................................. 9
    2.1.2 User Main Menu ............................................................................................ 10
       2.1.2.1 Update Profile.......................................................................................... 11
       2.1.2.2 Submit Score............................................................................................ 12
       2.1.2.3 Receive Handicap .................................................................................... 13
       2.1.2.4 Change Password .................................................................................... 14
    2.1.3 Administrator Main Menu ............................................................................ 15
       2.1.3.1 Update Course Profile ............................................................................ 16
       2.1.3.2 Add/Delete Course .................................................................................. 18
       2.1.3.3 Delete User ............................................................................................... 19
       2.1.3.4 Review Player Handicap ........................................................................ 20
       2.1.3.5 Change Password .................................................................................... 21
 2.2 Unusual Events ...................................................................................................... 22
Chapter 3: User Reference Manual.............................................................................. 23
 3.1 Listing of Services ................................................................................................. 23
 3.2. Error Messages and Error Recovery .................................................................... 23
Chapter 4: Installation Information.............................................................................. 24
The Handy Handicap System User Manual                                                       3
8/8/2012

                                 Chapter 1: Introduction

1.1 Purpose

       The purpose of this manual is to inform the two user types (administrator and

normal user) of the functionality of the Handy Handicap System. The user will gain

knowledge of how to operate the system under normal circumstances and how to handle

abnormal situations.



1.2 Scope

       This product will be setup and run by a golf club that whishes to allow its

members (and non-members who are potential future members )to easily keep track of

their United States Golf Association Handicap information. Also, it allows the club itself

to keep track of its members’ handicap information.

       This product is to be used by golfers, both club members and non club members,

who wish to accurately keep track of their United States Golf Association Handicap

Index. Those who use its services are expected to responsibly and truthfully log their

correct golf adjusted scores and correctly give all necessary information. These users

need not possess any knowledge of the USGA handicap system or the handicap

determination process.

       As for the administrator, the person or people chosen to act as the administrator

should be knowledgeable of the USGA handicap system and all processes involved in

determining handicap indexes. It is highly recommended that this person is not only of

high authority at the golf club, but is also on the Handicap Committee, an entity that is

required by the USGA.
The Handy Handicap System User Manual                                                     4
8/8/2012

1.3 Glossary

    Administrator - One who administers, especially one who works as a manager in the
    organization.

    Architecture - The overall design or structure of a complex system, including the all
    modules it is composed of.

    Browser - Short for Web browser, a software application used to locate and display
    Web pages. The two most popular browsers are Netscape Navigator and Microsoft
    Internet Explorer. Both of these are graphical browsers, which means that they can
    display graphics as well as text. In addition, most modern browsers can present
    multimedia information, including sound and video, though they require plug-ins for
    some formats.

     Course Handicap - A Course Handicap is the USGA’s mark that indicates the
     number of handicap strokes a player receives from a specific set of tees at the
     course being played to adjust his scoring ability to the level of scratch or 0-handicap
     golf. For a player with a plus Course Handicap, it is the number of handicap strokes
     the player gives to adjust his scoring ability to the level of scratch or 0-handicap
     golf. A Course Handicap is determined by applying the player’s USGA Handicap
     Index to a Course Handicap Table or Course Handicap Formula. A player’s Course
     Handicap is expressed as a whole number of strokes.

     Course Rating - USGA Course Rating is the USGA’s mark that indicates the
     evaluation of the playing difficulty of a course for scratch golfers under normal
     course and weather conditions. It is expressed as strokes taken to one decimal place,
     and is based on yardage and other obstacles to the extent that they affect the scoring
     ability of a scratch golfer.

     Database - Often abbreviated DB. A collection of information organized in such a
     way that a computer program can quickly select desired pieces of data. You can
     think of a database as an electronic filing system

    Database system - A collection of data arranged for ease and speed of search and
    retrieval. Also called data bank.

    Feature - A notable property of a device or software application. Many analysts
    bemoan the advent of featuritis -- the seemingly endless addition of more and more
    features onto what was once a simple application. One of the principal challenges of
    modern applications is to offer a multitude of features without making the
    application complex.

    Golf Club - A golf club is an organization of at least ten individual members that
    operates under bylaws with committees (including a Handicap Committee) to
    supervise golf activities, provide peer review, and maintain the integrity of the
The Handy Handicap System User Manual                                                      5
8/8/2012

    USGA Handicap System. Members of a golf club must have a reasonable and
    regular opportunity to play golf with each other. They must be able to return scores
    personally, and these scores must be immediately available for review by fellow
    club members.
    Note: For administrative reasons, some golf associations may require a golf club to
    have more than the USGA minimum of ten members in order for that club to be a
    member of the golf association.

    Handicap Committee - A Handicap Committee is the committee of a golf club that
    ensures compliance with the USGA Handicap System, including peer review. A
    majority of the Handicap Committee must be members of the club; club employees
    may serve on the Handicap Committee, but an employee may not serve as chairman.

    Handicap Differential - A handicap differential is the difference between a player’s
    adjusted gross score and the USGA Course Rating of the course on which the score
    was made, multiplied by 113, then divided by the USGA Slope Rating from the tees
    played and rounded to the nearest tenth. Handicap differentials are expressed as a
    number of strokes rounded to one decimal place, e.g. 12.8.

    Handicap Index - A Handicap Index is the USGA’s service mark used to indicate a
    measurement of a player’s potential ability on a course of standard playing
    difficulty. It is expressed as a number taken to one decimal place, and is used for
    conversion to a Course Handicap.

    HTML - Short for HyperText Markup Language, the authoring language used to
    create documents on the World Wide Web. HTML is similar to SGML, although it
    is not a strict subset.

    Module - In software, a module is a part of a program. Programs are composed of
    one or more independently developed modules that are not combined until the
    program is linked. A single module can contain one or several routines.

    PHP - Self-referentially short for PHP: Hypertext Preprocessor, an open source,
    server-side, HTML embedded scripting language used to create dynamic Web
    pages.

    Remote machine – computer which exists not locally, but somewhere on the internet

    Slope Rating - USGA Slope Rating is defined as the USGA’s mark that indicates the
    measurement of the relative difficulty of a course for players who are not scratch
    golfers compared to the Course Rating (i.e., compared to the difficulty of a course
    for scratch golfers). Slope Rating is computed from the difference between the
    Bogey Rating and the Course Rating. The lowest Slope Rating is 55 and the highest
    is 155. A golf course of standard playing difficulty has a USGA Slope Rating of
    113.
The Handy Handicap System User Manual                                                     6
8/8/2012

    Software Interface - the languages and codes that the applications use to
    communicate with each other and with the hardware.

    SQL - Pronounced “ess cue el” (each letter separately) and not “SEE kwill.” SQL is
    an open source RDBMS that relies on SQL for processing the data in the database.
    SQL is most commonly used for Web applications and for embedded applications
    and has become a popular alternative to proprietary database systems because of its
    speed and reliability. SQL can run on UNIX, Windows and Mac OS.

    System - A group of interdependent items that interact regularly to perform a task.

    System Environment - The entire set of conditions under which one operates a

    User - An individual who uses a computer. This includes expert programmers as
    well as novices. An end user is any individual who runs an application program.

    User Interface - the keyboard, mouse, menus of a computer system. The user
    interface allows the user to communicate with applications and the operating
    system.

     USGA Handicap System - The USGA Handicap System is the USGA’s mark which
     denotes the USGA’s method of evaluating golf skills so that golfers of differing
     abilities can compete on an equitable basis.

    Web Server – A server process running at a web site which sends out web pages in
    response to requests from remote browsers.


      *Note: Many golf definitions have been taken directly from the USGA Website at

http://www.usga.org

1.4 References

   The Handy Handicap, Software Requirements Specification. Thomas A Garubba III.

      The University of Scranton, 2003.

   The Handy Handicap, Software Design Description. Thomas A Garubba III. The

      University of Scranton, 2003.

   The Handy Handicap, System Test Design Document. Thomas A Garubba III. The

      University of Scranton, 2003.
The Handy Handicap System User Manual                                                      7
8/8/2012

1.5 Overview of Document

The remainder of this document is organized as follows:

Chapter 2: Instructional Manual – this section describes and walks through the functions
of the system that are available to each of the two user types. This section is divided into
sub-sections based on these two user types.
Chapter 3: User Reference Manual – this section contains an alphabetical listing of the
services provided to each user type and makes references to other parts of the document
but primarily chapter 2.
Chapter 4: Installation Information – this section describes in a step by step process how
a golf club can set up The Handy Handicap System on their own server.
The Handy Handicap System User Manual                                                      8
8/8/2012

                           Chapter 2: Instructional Manual


2.1 Normal System Usage

2.1.1 Logging In

       Upon accessing The Handy Handicap System, the user will be presented with the
following screen:




2.1.1.1 Logging in
      The user merely needs to click enter his or her username and password and click
on submit. At this point, the user will be directed to the appropriate main menu screen.
The Handy Handicap System User Manual                                                        9
8/8/2012


2.1.1.2 Registering
        If the user is accessing The Handy Handicap System for the first time, then “Click
here to register a new username.” should be clicked. The information on the following
screen should be filled in and the Submit button should be clicked.




2.1.1.3 Forgotten Password
       If the user has forgotten their Handy Handicap password, then “Ohh…No, I
forgot my password.” should be clicked. The username box on the following screen
should be filled in. The password will be sent to the email address in the user’s profile.
The Handy Handicap System User Manual                                                      10
8/8/2012

2.1.2 User Main Menu

       The user will be presented with the following main menu screen upon logging in:




       Note: At any point, the user can access help from this manual by clicking the help
button on the lef:.



        This screen gives all services available to the user with a brief description of
them. To access a service, the user needs to either click the link in the main frame or
click on the corresponding button on the left. Either method produces the same result.
The Handy Handicap System User Manual                                                      11
8/8/2012

2.1.2.1 Update Profile
       Upon clicking “Update Profile,” the user is presented with this page:




        It is necessary that all information be entered into the boxes for the user’s profile.
Some of it is necessary for the actual determination of handicap differentials and indexes.
After the information is input, click the submit button. If information is omitted,
“Incomplete Profile Description” error will be reported and the user will need to try
again, entering all information this time
The Handy Handicap System User Manual                                                   12
8/8/2012

2.1.2.2 Submit Score
        Upon clicking “Submit Score” on the Main Menu, the user is presented with this
page:




        It is necessary that all information be entered into the boxes for the score
information. All of it is necessary for the actual determination of handicap differentials
and indexes. If the holes played are 18, then the side (front or back)is not important. The
date to be selected from the drop down menus and text box should be the date the score
was achieved, NOT the date inputted into the system or the current date. After the
information is input, click the submit button.
        If any information is omitted the user will be informed of the error and will need
to resubmit. This error will be reported as: “Incomplete Score Description.”
The Handy Handicap System User Manual                                                  13
8/8/2012

2.1.2.3 Receive Handicap
        Upon clicking “Receive Handicap” on the Main Menu, the user is presented with
this page:




        The screen contains a table giving all dates, course names, scores, hand the
calculated Handicap Differentials. Underneath the table is the user’s current USGA
Handicap Index as calculated by the system. Use the scroll bar on the right of the
browser screen to scroll down to your 9-hole Handicap Index.
The Handy Handicap System User Manual                                                  14
8/8/2012


2.1.2.4 Change Password
        Upon clicking “Change Password” on the Main Menu, the user is presented with
this page:




       The user must first enter the old password then the new password twice (once in
each of the two boxes). If the new password is not entered exactly the same twice or the
old password was not correctly entered, an error message such as the one below will be
displayed and the user will need to try again.
The Handy Handicap System User Manual                                                 15
8/8/2012

2.1.3 Administrator Main Menu
       The administrator will be presented with the following main menu screen upon
logging in:




       Note: At any point, the user can access help from this manual by clicking the help
button on the left:



       This screen gives all services available to the administrator with a brief
description of them. To access a service, the user needs to either click the link in the
main frame or click on the corresponding button on the left. Either method produces the
same result.
The Handy Handicap System User Manual                                                      16
8/8/2012

2.1.3.1 Update Course Profile
        Upon clicking “Update Course Profile” on the Main Menu, the user is presented
with this page:




       The administrator must choose the desired course to edit from the drop down
menu. Then the administrator shall click the edit button and be presented with the
following screen:




        All information (Course Ratings and Slope Ratings) needs to be inputted in the
tables on the screen. This is important for the determining all user’s handicap indexes.
After the information is inputted, the administrator should click “Submit.” If any
The Handy Handicap System User Manual                                                17
8/8/2012

information is omitted, the admission will be informed of the error: “Incomplete Course
Description” Administrator then needs to go back and enter the information again.
The Handy Handicap System User Manual                                                   18
8/8/2012

2.1.3.2 Add/Delete Course
        Upon clicking “Add/Delete Course” on the Main Menu, the user is presented with
this page:




        The administrator must choose the desired course to delete from the drop down
menu or enter the name of a new course to add. Then the administrator shall click the
delete button or the add button.
The Handy Handicap System User Manual                                                 19
8/8/2012

2.1.3.3 Delete User
         Upon clicking “Delete User” on the Main Menu, the user is presented with a page
with a list of all members with information on each member and a drop down menu such
as this:




      The administrator must choose the desired user to delete from the drop down
menu. Then the administrator shall click the delete button.
The Handy Handicap System User Manual                                                   20
8/8/2012

2.1.3.4 Review Player Handicap
       Upon clicking “Review Player Handicap” on the Main Menu, the administrator is
presented with this page:

       The administrator must choose the user whose handicap information is desired.


       Then the administrator shall click the review button and be presented with the
following screen:




        The screen contains a table giving all dates, course names, scores, hand the
calculated Handicap Differentials. Underneath the table is the player’s current USGA
Handicap Index as calculated by the system. Use the scroll bar on the right of the
browser screen to scroll down to the 9-hole Handicap Index.
The Handy Handicap System User Manual                                                  21
8/8/2012

2.1.3.5 Change Password
        Upon clicking “Change Password” on the Main Menu, the user is presented with
this page:




       The user must first enter the old password then the new password twice (once in
each of the two boxes). If the new password is not entered exactly the same twice or the
old password was not correctly entered, an error message such as the one below will be
displayed and the user will need to try again.
The Handy Handicap System User Manual                                                 22
8/8/2012

2.2 Unusual Events
        There shouldn’t be many unusual events to merit worry over The Handy
Handicap System. Most unusual events that can occur will likely be the results of invalid
or insufficient data input. For example, the user’s USGA Handicap Index cannot be
properly determined unless all data relevant to each golf score is input to the system at
the time of submitting a score. Therefore one unusual situation that could occur would be
the submitting of a score without giving enough information. If such a situation arises,
the system inform the user of the error and request a resubmission.
The Handy Handicap System User Manual                        23
8/8/2012

                          Chapter 3: User Reference Manual

3.1 Listing of Services
Pre-Login
      2.1.1.3 Forgotten Password          9
      2.1.1.1 Logging in                  8
      2.1.1.2 Registering                 9


2.1.2 User Main Menu
       2.1.2.4 Change Password            14
       2.1.2.3 Receive Handicap           13
       2.1.2.2 Submit Score               12
       2.1.2.1 Update Profile             11

2.1.3 Administrator Main Menu

       2.1.3.2 Add/Delete Course          18
       2.1.3.3 Delete User                19
       2.1.3.4 Review Player Handicap     20
       2.1.3.1 Update Course Profile      16

3.2. Error Messages and Error Recovery
       Incomplete Course Description            17
       Incomplete Profile Description           11
       “Incomplete Score Description.”          12
       Incorrect Password                       21, 14
The Handy Handicap System User Manual                                                   24
8/8/2012

Chapter 4: Installation Information


       The Handy Handicap System is to be installed on a web server and hosted by a

golf club that follows and obeys the handicap rules set by the USGA. This server should

support PHP and the golf club should also re running have access to a MySQL server.

The installation of the Handy Handicap System requires that the environment just

described be previously installed.

       To install the Handy Handicap System simply copy (or unzip) all php and html

files from the source (probably a CD) to the appropriate directory on the web server. The

appropriate MySQL account information needs to be giver to the system. To do so, edit

the sqlconnection.php file and enter the appropriate information:

       $server = the name of your server

       $username = your username

       $password = your password

       $database = the name of the database



 Note: It is assumed that all of this information has been previously set up correctly on

the MySQL server.



       Finally, to set up the desired database, copy the dbsetup.sql file from the source

(probably a CD) into the working folder. Log into your MySQL account as you would

normally do and use the intended database. Then enter the following command:

       SOURCE setupdb.sql;
The Handy Handicap System User Manual                                                    25
8/8/2012

       This will setup all tables needed in the database for the system to work.

               Now installation is complete and the golf club’s members can enjoy full

functionality of the system.
The Handy Handicap System User Manual                                                                                           26
8/8/2012

                                                               Index


administrator ........... 3, 15, 16, 18, 19, 20                        Profile.................................. 2, 11, 16, 23
Course                                                                    Course Profile ................................. 16
  Add/Delete ...................................... 18                 Registering .................................. 2, 9, 23
Error ................................................ 2, 23           Review Player Handicap ..................... 20
  Messages ......................................... 23                Score ......................................... 2, 12, 23
Handicap .. 1, 2, 3, 4, 5, 6, 7, 8, 9, 13, 20,                         services .................................. 3, 7, 10, 15
  22, 23, 24                                                           Services ........................................... 2, 23
Installation ................................. 2, 7, 24                Table ..................................................... 4
Interface ............................................... 6            Unusual Events .............................. 2, 22
Logging in ................................... 2, 8, 23                user ... 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15,
Main Menu . 2, 10, 12, 13, 14, 15, 16, 18,                                16, 18, 19, 20, 21, 22
  19, 20, 21                                                           User
Module ................................................. 5                Deleting ........................................... 19
password ......................... 8, 9, 14, 21, 24                    username ..................................... 8, 9, 24
Password ......................... 2, 9, 14, 21, 23

				
DOCUMENT INFO
Shared By:
Categories:
Tags:
Stats:
views:12
posted:8/8/2012
language:English
pages:26