C1005 C Programming Project Term 1 2008, Part 2, Documentation 2 final
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 Objective |
|
| 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:
- ThomasC1005Project.exe
This is the executable program; you can run the program by double clicking this application.
- 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.
- 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.
- Documentation and drop box – folder
This folder contains the soft-copy of this documentation and also the mydropbox report.
- 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).



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
@Eunice
Hi Eunice, what do you mean by CD content? is it the source code of the program that I make for the assignment?
I think ya…cos I saw you have a ‘Operating Guide’ .. saying insert CD ROM and you can see all the content ..
Hi:)
Hope to hear reply from you soon cos I need to hand in my project this thursday ..thank you
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
Thanks alot
i was nt d 1 replying uuuuuuuuuuu.pls i do not undrestand
Hi. I read a few of your other posts and wanted to know if you would be interested in exchanging blogroll links?
Sure
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.
Of Course Hasan, I will send it to you via e-mail
your e-mail is hasan.syl@gmail.com right?
done, e-mail sent
Good luck
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!