Use Cases¶

Login Flow¶

Precondition¶

The user visits the site for the first time in a new browser.

Main Flow¶

The system presents the user with a button to login using their Google Account
The user clicks the login button and is taken to Google’s site to authenticate with their Google account.
The user is presented with the option to authorize as themselves to foodtastechess
The user chooses to authorize.
The user is brought back to the application

Post-Condition¶

The user is logged in to the application.

Resume Game Flow¶

Precondition¶

The user is in the Lobby screen.

Main Flow¶

The system presents a list of games the user is playing or has played in.
The user clicks a row for a particular game.

Post-Condition¶

The user is in the In-Game screen for the selected game.

Create Game Flow¶

Precondition¶

The user has logged in.
The user is viewing the Lobby screen

Main Flow¶

The system presents a “Create New Game” button.
The user clicks the “Create New Game” button.
The system presents a modal popup with a screen with game options. The system also presents a text box with a unique game invite URL and a button to copy the URL to the clipboard.
The user clicks the button to copy the URL.
The system changes this button to “Start Game.”
The user (externally to the system) sends the copied URL to a friend.
The system, meanwhile, brings the user to the In-Game screen.

Post-Condition¶

The user sees the game screen and may begin playing, provided it is their turn.

Join Game Flow¶

Precondition¶

The user has been given a game invite URL.
The user opens the URL in a web browser.
If necessary, the user logs in following the Login Flow.

Main Flow¶

The system presents the user with a modal popup confirmation dialog presenting the game options. The dialog includes a button labeled “Start Game.”
The user accepts the options and clicks the button.
The system brings the user to the In-Game screen.

Post-Condition¶

The user sees the game screen and may begin playing, provided it is their turn.

Return to Lobby Flow¶

Precondition¶

The user is in the In-Game screen.

Main Flow¶

The user finds and clicks the Return to Lobby button.

Post-Condition¶

The user is in the Lobby screen.

Make Move Flow¶

The Make Move Flow comprises the user making a valid move, possible resulting in one of the Scenarios listed.

Precondition¶

The user is in the In-Game screen.
It is the user’s turn in the game presented: the turn marker label reads “YOUR TURN.”

Main Flow¶

Click Twice Method¶

The user clicks a piece.
The system highlights the valid squares where the piece may move.
The user clicks one of the highlighted squares.
By default, the system shows the piece in the new square and presents a popover menu with two buttons:
- An X button : Canceling the move
- A Check button : Confirming the move.
The user clicks the Check button.

Click and Drag Method¶

The user presses the mouse button on a piece without releasing it. (Click and Drag gesture)
The system highlights the valid squares where the piece may move.
The user moves the mouse to the valid square.
The system presents the piece moving along with the mouse cursor.
The user releases the mouse button.
By default, the system shows the piece in the new square and presents a popover menu with two buttons:
- An X button : Canceling the move
- A Check button : Confirming the move.
The user clicks the Check button.

Post-Condition¶

The piece is in the selected new location.
The turn marker label reads “[opponent’s name]‘S TURN.”

Scenarios¶

Capture¶

Precondition: The user has made a move that results in a piece moving to a square occupied by their opponent’s piece.
Post-condition: The user’s piece is in that square. The opponent’s piece is not and instead appears in the captured pieces display.

Check¶

Precondition: The user has moved a piece so that it is in capturing range of their opponent’s King.
Postcondition: Upon the user’s opponent viewing the In-Game screen, the system will present a modal popup to that opponent reading “CHECK”

Checkmate¶

Precondition: The user has made a move so that the state of the game is Checkmate for their opponent.
Postcondition: The system presents a modal popup informing the user of their Victory, and the turn marker label reads “YOU WON” upon dismissal of the modal.

Pawn Promotion¶

Precondition: The user has made a move bringing a Pawn to the opposing rank of the board
Postcondition: The system changes that Pawn to a Queen belonging to the user in its new location.

Invalid Move Flow¶

Precondition¶

The user has followed the Make Move Flow using either method up to step 2.

Main Flow¶

1. In the case of the Click Twice method, the user clicks a non-highlighted square.
2. In the case of the Click and Drag method, the user releases the mouse on a non-highlighted square.
The system highlights the selected square in red and shows the piece move back to its original location.

Post-Condition¶

The piece is in its original location.
The turn marker label still reads “YOUR TURN.”

Concession Flow¶

Precondition¶

The user is in an unfortunate and/or dire situation and cannot honorably continue to play.
The user is in the In-Game screen.

Main Flow¶

The user finds and clicks the Concede button.
The system presents a modal popup confirmation dialog asking the user if they are certain that they wish to concede. The system presents two buttons in the modal:
- A Cancel button
- A Concede button
The user clicks the Concede button.

Post-Condition¶

The system presents a modal popup informing the user of their loss.
After dismissing the modal, the system presents the board in its final state for reviewing.
The turn marker label reads “[opponent’s name] WON”

Offer Draw Flow¶

Precondition¶

The user is in the In-Game screen.
The user believes the game to be unwinnable by either player, or otherwise just wishes to offer a draw.

Main Flow¶

The user finds and clicks the Offer a Draw button.
The system presents a modal popup confirmation dialog asking the user if they are certain that they wish to offer a draw. The system presents two buttons in the modal:
- A Cancel button
- An Offer a Draw button
The user clicks the Offer a Draw button.

Post-Condition¶

The modal is dismissed.
The turn marker label reads “Draw Offered.”

Accept Draw Flaw¶

Precondition¶

The user is in the In-Game screen.
The user’s opponent has offered a draw.

Main Flow¶

The system presents a modal popup informing the user of their opponent’s offer. The system presents two buttons in the modal:
- A Cancel button
- An Accept Draw button
The user clicks the Accept Draw button.

Post-Condition¶

The game is over.
The turn marker label reads “STALEMATE.”

Replay Moves Flow¶

Precondition¶

The user is in the In-Game screen.
The user wishes to review the moves made in the game from either the beginning or from another point in the game history.

Main Flow¶

The Replay Moves Flow, rather than being a prescribed set of actions, is instead a user interaction flow based on the user pressing history navigation buttons any number of times and observing the result after each press.

There are four (4) buttons:

Rewind Fully: This button rewinds the game back to the start, before any moves have been made by either player.

Step Back 1: This button rewinds the game a single move, as defined by one player making a single piece move.

Step Forward 1: This button forwards the game a single move, according to the same definition.

Skip to Most Recent: This button forwards the game to the most recent move made.

The flow is considered to have ended when the user has returned to the most recent move, either by navigating one move at a time, or by clicking the Skip to Most Recent button.

Post-Condition¶

After each button press, the system state should reflect the game at that point in its move history.
If the game cannot move forward or backward because the state is at the start or end, the corresponding buttons should be disabled.
If the game state is not on the most recent move, the system should signify how to exit the flow by highlighting the Skip to Most Recent button.