Home > Education, IDIC, Informatics > C1005 C Programming Project Term 1 2008, Part 2, Documentation 2 final

C1005 C Programming Project Term 1 2008, Part 2, Documentation 2 final

February 2nd, 2009

This is the third post in C1005 C programming post series. You can see the previous post by clicking here.

6. Testing

6.1. Testing – Test plan


Test Case

Test Objective

1

To test that the program will be closed after user enter the wrong user name or password for three times.

2

To test that the main menu appear after signing in as administrator

3

To test the entry range for the main menu choice

4

To test that add member module appear after user choose ‘1′ from main menu

5

To test that Name field has minimum limit of three characters

6

To test that Name field has maximum limit of thirty characters

7

To test that Name field accepts alphabets only

8

To test that Gender field accepts ‘M’ or ‘F’ only

9

To test that NRIC/Passport field has minimum limit of 7 characters

10

To test that NRIC/Passport field has maximum limit of 9 characters

11

To test that NRIC/Passport field accepts alphanumeric data only

12

To test that Contact field has minimum limit of 6 digits

13

To test that Contact field has maximum limit of 16 digits

14

To test that Contact field accepts numeric data only

15

To test that Nationality field only accept two characters

16

To test that Nationality field accepts alphabets only

17

To test that Occupation field has minimum limit of 4 characters

18

To test that Occupation field has maximum limit of 15 characters

19

To test that Occupation field accepts alphabet only

20

To test that question to save can be answered by ‘Y’ or ‘N’ only

21

To test that question to add more record accept ‘Y’ or ‘N’ only

22

To test that the record is not saved if user choose not to save it

23

To test that the record is saved if the user choose to save it

24

To test that new member form appear if user choose to add more record

25

To test that main menu appear if user choose not to add more record

26

To test that that delete member module appear after user choose ‘2′ from the main menu

27

To test that warning message appear if ID not found in delete member module

28

To test that record is displayed if ID is found in delete member module

29

To test that record is deleted if user confirmed to delete the record

30

To test that display member module appear after user choose ‘3′ from main menu

31

To test that next 10 records appear after the first 10 records when there are more than 10 records saved in the file

32

To test that search member module appear after user choose ‘4′ from main menu

33

To test that a warning appear when the searched ID is not found in search member module

34

To test that record is displayed when the ID is found in search member module

35

To test that the search form is reset when the user choose to search for another record

36

To test that main menu appear if the user choose not to search for any more record

37

To test that edit member module appear after user choose ‘5′ from the main menu

38

To test that a warning appear when the searched ID is not found in edit member module

39

To test that record is displayed when the ID is found in edit member module

40

To test that pointer move to Name field if user choose ‘1′ in edit choice

41

To test that pointer move to Gender field if user choose ‘2′ in edit choice

42

To test that pointer move to NRIC/Passport field if user choose ‘3′ in edit choice

43

To test that pointer move to Contact field if user choose ‘4′ in edit choice

44

To test that pointer move to Nationality field if user choose ‘5′ in edit choice

45

To test that pointer move to Occupation field if user choose ‘6′ in edit choice

46

To test that main menu appear if the user choose ‘7′  in edit choice

47

To test that edit member module re-appear if user choose to edit another record

48

To test that main menu appear if user choose not to edit another record

49

To test that help menu appear after user choose ‘6′ in main menu

50

To test that “about super gamers”-help appear if user choose ‘1′ in help menu

51

To test that “about super gamers customer registration system”-help appear if user choose ‘2′ in help menu

52

To test that “How to add a new record”-help appear if user choose ‘3′ in help menu

53

To test that “How to delete a member record”-help appear if user choose ‘4′ in help menu

54

To test that “How to display all member records”-help appear if user choose ‘5′ in help menu

55

To test that “How to search a member record”-help appear if user choose ‘6′ in help menu

56

To test that “How to edit an existing member record”-help appear if user choose ‘7′ in help menu

57

To test that guest main menu appear when signing-in as guest

58

To test that only search module can be used by guest

59

To test that guest can use search module

60

To test that guest search module just show limited amount of information about a record

6.2. Testing – Test Case & Result

Test case

1

Objectives To test that the program will be closed after user enter the wrong user name or password for three times.
Test action Write a wrong user name and password three times
Expected result Trying chance become 0 and program closed
Actual result As shown below
Conclusion Successful

Before:

(Screen shot here)

After:

(Screen shot here)

Repeat this step for all test cases

6.3 Testing – Test Log

Test Case

Test Result

1

successful

2

successful

3

successful

4

successful

5

successful

6

successful

7

successful

8

successful

9

successful

10

successful

11

successful

12

successful

13

successful

14

successful

15

successful

16

successful

17

successful

18

successful

19

successful

20

successful

21

successful

22

successful

23

successful

24

successful

25

successful

26

successful

27

successful

28

successful

29

successful

30

successful

31

successful

32

successful

33

successful

34

successful

35

successful

36

successful

37

successful

38

successful

39

successful

40

successful

41

successful

42

successful

43

successful

44

successful

45

successful

46

successful

47

successful

48

successful

49

successful

50

successful

51

successful

52

successful

53

successful

54

successful

55

successful

56

successful

57

successful

58

successful

59

successful

60

successful

7.0 Program Implementation

7.1 Hardware & Software Configuration

7.1.1 Hardware Configuration

i.      Minimum Pentium 4

ii.      Hard disk

iii.      128 Mb RAM

iv.      CD-ROM

v.      Keyboard

vi.      Mouse

vii.      Color monitor

7.1.2 Software Configuration

i.      Windows XP or Windows Vista-32

ii.      Borland C++

7.2 User Manual

a) CD contents

The CD that come with this documentation come with some items:

  1. ThomasC1005Project.exe

This is the executable program; you can run the program by double clicking this application.

  1. Source Code – folder

This folder contains the original source code for “Super Gamers Customer Registration System”. The file name of the source code is “ThomasC1005Project.c”. You can use this file to see the program’s source code or use it to run the program using a C compiler.

  1. Support software – folder

There are some items in this folder that related to C programming:

Ø  C compiler – folder

This folder contains the C compiler “freecommandLinetools.exe” that you can install if you don’t have any java compiler in your computer.

If you choose to install this compiler, after installing it, you will need to copy the “ilink32.cfg” and “bcc32.cfg” which is in this folder, and paste these file to the bin folder of your compiler.

The default folder is “c:\\borland\bcc55\bin”

But if your computer already have a C compiler, you won’t need to install this compiler.

Ø  Borland C++ 5.02 – folder

This folder contains the installer for Borland C++ 5.02 IDE, just install it if you want to use this program to compile and run the source code. But if you plan to compile and run the source code using command prompt, you don’t need to install this program.

In case you want to install this program, just open this folder and double-click on setup.exe, then just follow the installation wizard.

  1. Documentation and drop box – folder

This folder contains the soft-copy of this documentation and also the mydropbox report.

  1. Readme.txt

This is a text file created using notepad that contain information about the CD contents.

b) Operating Guide

b.1) Starting the program

b.1.1) Insert the CD to your CD-ROM

b.1.2) Open the CD contents

b.1.3) Double-click on “ThomasC1005Project.exe”

b.1.4) You will now see the login screen

b.2) Login

b.2.1) Login as administrator

b.2.1.1) You will be able to use full feature of this program while signed -in as administrator

b.2.1.2) Enter user name : admin

b.2.1.3) Enter password : admin123

b.2.1.4) Press enter

b.2.1.5) After a notification that administrator access granted, press enter.

b.2.2) Login as guest

b.2.2.1) Guest profile don’t need any password, but it has very limited access to the program feature

b.2.2.2) Enter user name : guest

b.2.2.3) Leave the password field blank

b.2.2.4) Press enter

b.2.2.5) After a notification that you sign in as guest, press enter.

b.3) Administrator profile guide

b.3.1) Main menu

b.3.1.1) After signing-in as administrator, you will see the main menu

b.3.1.2) You can see the list of choice, and choose by entering the module number.

b.3.1.3) Enter your choice and press enter to use the corresponding module.

b.3.1.4) Choose ‘1′ to open add member module

b.3.1.5) Choose ‘2′ to open delete member module

b.3.1.6) Choose ‘3′ to open display member module

b.3.1.7) Choose ‘4′ to open search member module

b.3.1.8) Choose ‘5′ to open edit member module

b.3.1.9) Choose ‘6′ to open help menu

b.3.1.10) Choose ‘7′ to exit the program

b.3.2) Adding new member record

b.3.2.1) Open the add member module by choosing ‘1′ from main menu

b.3.2.2) You will see a form with fields that needs to be filled

b.3.2.3) The first field is member ID field, this is an auto-number field

b.3.2.4) Your pointer will start at name field, and move down to the next field sequentially after you finish filling a field with correct data

b.3.2.5) Enter alphabets with length from 3 to 30 for name field

b.3.2.6) Enter ‘M’ or ‘F’ for gender field

b.3.2.7) Enter alphanumeric with length from 7 to 9 for NRIC/Passport field

b.3.2.8) Enter numeric data with length from 6 to 16 for contact field

b.3.2.9) Enter two characters country code for nationality field. For example: Singapore – sg / Indonesia – id / India – in / China – cn

b.3.2.10) Enter alphabets with length from 4 to 15 for occupation field

b.3.3) Delete a member record

b.3.3.1) Open delete member module by choosing ‘2′ from main menu

b.3.3.2) You will be asked to enter the ID of the record that you want to delete

b.3.3.3) Enter the ID and press enter

b.3.3.4) If the ID is not found, a warning message will appear and you can press any key to go back to main menu

b.3.3.5) If the ID is found, the record will be displayed

b.3.3.6) You will be asked for confirmation to delete the record

b.3.3.6.1) Answer ‘Y‘ and press enter to delete the record, a message confirming that the record has been deleted will appear and you will back to main menu after pressing any key.

b.3.3.6.2) Answer ‘N‘ and press enter to cancel deleting the record, and you will back to main menu

b.3.4) Display member records

b.3.4.1) Open the display member record by choosing ‘3′  from main menu

b.3.4.2) The first 10 member records will be displayed.

b.3.4.3) If there are less than 10 records, you will back to main menu after you press any key

b.3.4.4) If there are more than 10 records, after you press any key, the next 10 records will be displayed on the screen

b.3.4.5) Press any key after the last record displayed to go back to main menu

b.3.5) Search a member record

b.3.5.1) Open the search member module by choosing ‘4′ from main menu

b.3.5.2) You will be asked to enter the ID of the record that you want to search

b.3.5.3) Enter the ID and press enter

b.3.5.4) If the ID is not found, a warning message will appear

b.3.5.5) If the ID is found, the corresponding record will be displayed

b.3.5.6) After the record is found or not found, you will be asked whether you want to search for another record

b.3.5.6.1) Choose ‘Y’ to search for another record

b.3.5.6.2) Choose ‘N‘ to go back to the main menu

b.3.6) Edit a member record

b.3.6.1) Open edit member module by choosing ‘5′ from the main menu

b.3.6.2) You will be asked to enter the ID of the record that you want to edit

b.3.6.3) Enter the ID and press enter

b.3.6.4) If the ID is not found, a warning message will appear

b.3.6.5) If the ID is found, the corresponding record will be displayed

b.3.6.6) Now you will have options to choose which field to edit from the record.

b.3.6.7) You can see the option below the displayed record, enter the option number as your choice

b.3.6.8) Enter your choice and press enter

b.3.6.8.1) Choose ‘1′ to edit the member’s name

b.3.6.8.2) Choose ‘2′ to edit the member’s gender

b.3.6.8.3) Choose ‘3′ to edit the member’s NRIC/Passport

b.3.6.8.4) Choose ‘4′ to edit the member’s contact

b.3.6.8.5) Choose ‘5′ to edit the member’s nationality

b.3.6.8.6) Choose ‘6′ to edit the member’s occupation

b.3.6.8.7) Choose ‘7′ to exit edit member module and back to main menu

b.3.6.9) After you edit a field or after your target record is not found, you will be asked whether you want to edit another record

b.3.6.9.1) Choose ‘Y‘ to edit another record.

b.3.6.9.2) Choose ‘N‘ to go back to the main menu

b.3.7) Help menu

b.3.7.1) Open the help menu by choosing ‘6′ from main menu

b.3.7.2) Help menu will be displayed and you will see the option list

b.3.7.3) Enter the number of the option as your choice

b.3.7.4) Enter your choice and press enter to see the corresponding help

b.3.7.4.1) Choose ‘1′ to see help about super gamers

b.3.7.4.2) Choose ‘2′ to see help about super gamers customer registration system

b.3.7.4.3) Choose ‘3′ to see help about how to use add member module

b.3.7.4.4) Choose ‘4′ to see help about how to use delete member module

b.3.7.4.5) Choose ‘5′ to see help about how to use display member module

b.3.7.4.6) Choose ‘6′ to see help about how to use search member module

b.3.7.4.7) Choose ‘7′ to see help about how to use edit member module

b.3.7.4.8) Choose ‘8′ to exit help menu and go back to the main menu

b.3.8) Exit the program

b.3.8.1) You can exit and close the program by choosing ‘7′ from main menu

b.3.8.2) A closing message will be displayed

b.3.8.3) Press any key to exit and close the program

b.4) Guest profile guide

Guest profile cannot use most of the program’s module

b.4.1) Guest – main menu

b.4.1.1) After signing in as guest, you will see the main menu for guest

b.4.1.2) You can see that even there are many option written, only option number 4, 6, and 7 is highlighted with different color, this means that you can just choose these 3 options

b.4.1.3) Enter your choice number and press enter

b.4.1.3.1) Choose ‘4′ to open guest-search member module

b.4.1.3.2) Choose ‘6′ to open guest-help menu

b.4.1.3.3) Choose ‘7′ to exit the program

b.4.2) Guest – search a member record

b.4.2.1) Open the guest-search member module by choosing ‘4′ from guest-main menu

b.4.2.2) You will be asked to enter the ID of the record that you want to search

b.4.2.3) Enter the ID and press enter

b.4.2.4) If the ID is not found, a warning message will appear

b.4.2.5) If the ID is found, the corresponding record will be displayed

b.4.2.6) The information you will see from a record is limited to just 3 fields because only administrator profile can see the complete information from a record

b.4.2.7) After the record is found or not found, you will be asked whether you want to search for another record

b.4.2.7.1) Choose ‘Y’ to search for another record

b.4.2.7.2) Choose ‘N‘ to go back to the main menu

b.4.3) Guest – Help menu

b.4.3.1) You use the help menu in the same way as administrator profile

b.4.3.2) Please refer to the administrator guide about help menu “b.3.7)

b.4.4) Exit the program

b.4.4.1) Please refer to the administrator guide about exiting the program “b.3.8)

8. Conclusion

In conclusion, this program (Super Gamers Customer Registration System) can work properly to manage the member records like add new member record, delete member record, display, search, and also edit an existing member record. In spite of that this program is working properly, this program is not yet perfect. There are some strengths and weakness in this program. And also we need to do further enhancements to the program in the future.

8.1. Program Strengths

First, let’s see at the strengths of this program. This program will help the company to manage its member records. With 5 useful module that is the add member module, delete member module, display member module, search member module, and edit member module. These five modules are enough to help the company staff to manage the member records more effectively. This program also equipped with some validation rules for each field in member record such as data length validation and also data type validation to prevent human error when entering a new member record.

Additionally, this program has its own help menu in the program to help the user use each module correctly and prevents error when using the program.

Finally, this program is protected with user name and password. So, it prevents unauthorized person to use the program. Only user that signed-in as administrator can use full feature of the program.

8.2. Program Weakness

There are some weaknesses in this program, especially in the validation rules for record fields. For example, validation for NRIC/Passport field just checks the length of characters and also makes sure that the input data is alphanumeric, but it cannot validate that the entered NRIC / Passport is a valid passport or NRIC number format. This problem also occurs to the occupation field, the validation rule cannot make sure that the input data is a valid occupation.

Additionally, because I can’t find out how to validate a valid e-mail address, so this program don’t have e-mail address field which is important these days.

8.3. Program Enhancements

After we see the program’s strength and weakness, some improvements can be done in the future. Maybe, we can add features like printing all the member records, so user can print any record when it’s needed.

Adding e-mail field to the record with proper validation rules can be done in the future. After we have the e-mail address from all members, maybe we can add feature like sending e-mail to all user to send an announcement or advertising if there is something new from the company.

Some more possible enhancements can be added to the program, like maybe we can add a feature to count monthly attendance of a customer, and then use that data to calculate a special discount or give the member a special reward.

Do you have any comment on this? maybe you have something to ask me or want to discuss with me about this?Or maybe you are IDIC student and taking this module also?
Feel free to use the comment box below (click here if you cannot see the comment box).

admin Education, IDIC, Informatics , , , ,

  1. Eunice
    March 30th, 2009 at 19:53 | #1

    Hi ..

    Do you have the CD content with you ??
    if you have it, is it possible to share ?
    cos I’m now currently doing my C++ projection doucmentation so would like to borrow it and have a look.

    Tks :)

  2. March 30th, 2009 at 20:06 | #2

    @Eunice
    Hi Eunice, what do you mean by CD content? is it the source code of the program that I make for the assignment? :)

  3. Eunice
    March 31st, 2009 at 19:49 | #3

    I think ya…cos I saw you have a ‘Operating Guide’ .. saying insert CD ROM and you can see all the content ..

  4. Eunice
    March 31st, 2009 at 20:30 | #4

    Hi:)

    Hope to hear reply from you soon cos I need to hand in my project this thursday ..thank you :)

  5. April 1st, 2009 at 08:28 | #5

    Hi Eunice,
    I try to send you a sample via e-mail, please check your e-mail.
    But basically this is what inside my submission CD:
    CD contents

    The CD that come with this documentation come with some items:
    1.ThomasC1005Project.exe
    This is the executable program;
    you can run the program by double clicking this application.

    2.Source Code – folder
    This folder contains the original source code for
    “Super Gamers Customer Registration System”.
    The file name of the source code is “ThomasC1005Project.c”.
    You can use this file to see the program’s source code
    or use it to run the program using a C compiler.

    3.Support software – folder
    There are some items in this folder that related to C programming:
    C compiler – folder
    This folder contains the C compiler “freecommandLinetools.exe”
    that you can install if you don’t have any C compiler in
    your computer.
    If you choose to install this compiler, after installing it,
    you will need to copy the “ilink32.cfg” and “bcc32.cfg”
    which is in this folder, and paste these file to the bin folder
    of your compiler.
    The default folder is “c:\\borland\bcc55\bin”
    But if your computer already have a C compiler,
    you won’t need to install this compiler.

    Borland C++ 5.02 – folder
    This folder contains the installer for Borland C++ 5.02 IDE,
    just install it if you want to use this program to compile and
    run the source code. But if you plan to compile and run the source code
    using command prompt, you don’t need to install this program.
    In case you want to install this program, just open this folder
    and double-click on setup.exe, then just follow the installation wizard.

    4.Documentation and drop box – folder
    This folder contains the soft-copy of this documentation
    and also the mydropbox report.

    5. tsg.dat
    This is the file that is used to store records by the program
    Actually you don’t need this file, because the program will make a
    new file for you if you just run it and add new record.

    But, in case if you just want to see, use this file by copying this file to
    your C drive “c:\\”, and now you can see the records using the program.

    Hope this helps..
    All the best! GOod Luck :D

  6. Eunice
    April 1st, 2009 at 19:53 | #6

    Thanks alot :)

  7. eunice
    May 4th, 2009 at 12:13 | #7

    i was nt d 1 replying uuuuuuuuuuu.pls i do not undrestand

  8. June 16th, 2009 at 09:15 | #8

    Hi. I read a few of your other posts and wanted to know if you would be interested in exchanging blogroll links?

  9. June 22nd, 2009 at 23:30 | #9

    Sure :)

  10. hasan
    March 26th, 2010 at 02:21 | #10

    hi i am hasan from sweden.doing my assignment related to this.is it possible to get the CD content like eunice?please do me this favour.i will be greatful to u.and really appreciate for ur good work.

  11. March 31st, 2010 at 09:51 | #11

    Of Course Hasan, I will send it to you via e-mail
    your e-mail is hasan.syl@gmail.com right?

  12. March 31st, 2010 at 09:51 | #12

    done, e-mail sent
    Good luck :)

  13. boogie
    April 5th, 2010 at 17:36 | #13

    Hello Admin,

    Can you also send to my email the sample CD? as same as with others im doing this for my project =)

    Thanks, and btw your posts are VERY HELPFUL!

  1. February 11th, 2010 at 08:11 | #1

Bad Behavior has blocked 205 access attempts in the last 7 days.

Bad Behavior has blocked 205 access attempts in the last 7 days.