eMancala

by Sasa Junuzovic and Jeff Terrell

eMancala is an excellent program. You should try it. Yay.

Final Report

Here is our final presentation.

User Stories

• Johnny double-clicks on the "eMancala" icon, and a user selection dialog appears, followed by a game selection screen. After a game is started, a Mancala board is shown to him. He can click on the board to play the game.
• After clicking on the "eMancala" icon, Joseph creates a new user profile called JoeMan. In the future, he can select this profile from a list.
• Jackie wants to play Egyptian rules Mancala, so he selects the Egyptian rule set and begins a game against a computer. He could also play against a human if he wanted to, in which case he may have to specify which user.
• After a game is finished, Jimmy wants to see how well he has done, so he brings up some statistics of all his games. Among other things, he sees a graphical representation of his average winning margin, both against all users and against the user he just played.
• After playing Johnny, Josephine wants to know how he has been doing, so she brings up a graphical representation of his statistics, shown in a form similar to her own statistics. The statistics are only as recent as the last time she played Johnny.
• During a game, Jamie thinks Joseph's last move was terrible, so she uses a chat box to type "Haha I 0wn j00!" to Joseph. Joseph replies via the same chat box on his screen, "u r such a n00b lolol!!!"
• Jessica realizes she could have made a better last move, so before Johnny makes his move, she undoes her move. Johnny sees that she undid her move, and knows that it is her turn again.
• In the middle of a game, Jackie's power goes out. She is not worried because she knows her statistics cannot be corrupted.
• Joaquin has never played Mancala or "eMancala" before. When he first starts "eMancala", he is confused by the user selection screen, so he clicks "help" and reads the explanation that appears. Later, during a game, he looks up the rules, also by clicking "help".

Or, see the common user stories.

Technical Infrastructure

We are implementing eMancala using side-by-side extreme programming methodology, Eclipse, and Java 5.0.

Download

Download the release version 1.0 here. Release notes and installation instructions are included in the zip file. (Beta versions 0.5 and 0.6 are also available.)

Hour log

18 hours (of an estimated 18.5) were spent on the first release, including:

• Drawing the game board: 4 hours (6 estimated)
• Valid mouse move: 2.5 hours (4 est.)
• Invalid mouse move: 2 hours (2 est.)
• Playing against simple computer: 4.75 hours (2 est.)
• Quitting the game: 2.25 hours (0.5 est.)
• Displaying user statistics: 2.25 hours (4 est.)
• Displaying game rules: 0.25 hours (2 est.)

6.25 was spent on refactoring the beta-0.5 version.

17.5 hours (of an estimated 12) have been spent on release 2, including:

• User login: 2 hours (2 est.)
• Choosing the opponent: 2 hours (2 est.)
• Connecting to remote player: 1.75 hours (4 est.)
• Saving user statistics: 4.5 hour (2 est.)
• Playing Multiple Times: 5.25 hours (2 est.)

Here are the hours worked per day.

• 2006-03-23: 1.5
• 2006-03-25: 0.5
• 2006-03-28: 3.0
• 2006-03-29: 2.25
• 2006-03-31: 7.0
• 2006-04-01: 2.75
• 2006-04-04: 3.5
• 2006-04-05: 2.75
• 2006-04-06: 0.25
• 2006-04-10: 2.0
• 2006-04-11: 4.75
• 2006-04-12: 2.0
• 2006-04-14: 0.5
• 2006-04-15: 2.5
• 2006-04-17: 3.75
• 2006-04-18: 2.0
• total: 16 sessions, 42 hours

Last updated: 7:16pm Tue Apr 18, 2006