LateNightHackingWiki: HeartsUserStories

HeartsUserStories is a Wiki site to track the status of user stories the the AgileMethodologyProjectGroup is using to develop their Hearts application.

These are the current user stories we have...

in chat, display real names as opposed to "Client 1". [1.5 xpu]
record score. Add a command to add points to a player's score [0.5 xpu]
choose the dealer and store the dealer. Use command for this. [1.5 xpu]
create unpass command [1.0]
create a script command that allows the customer to set up scenarios. Obviously some of these commands need to be disabled during normal play.

           "// set cards for each player"
           "N: setCards 2s 3s 4s 5s 6s 7s 8s 9s Xs Js Qs Ks As"
           "E: setCards 2c 3c 4c 5c 6c 7c 8c 9c Xc Jc Qc Kc Ac"
           "S: setCards 2d 3d 4d 5d 6d 7d 8d 9d Xd Jd Qd Kd Ad"
           "W: setCards 2h 3h 4h 5h 6h 7h 8h 9h Xh Jh Qh Kh Ah"

           "// check a couple of table views"
           "N: checkTable"
            "                                [13]"
            ""
            "        [13]                                              [13]"
            ""
            "                2s 3s 4s 5s 6s 7s 8s 9s Xs Js Qs Ks As"

           "W: checkTable"
            "                                [13]"
            ""
            "        [13]                                              [13]"
            ""
            "                2h 3h 4h 5h 6h 7h 8h 9h Xh Jh Qh Kh Ah"

            "// change order of cards for West"
            "W: setCards Xh 2h 4h 5h 6h Ah 7h 3h 8h 9h Jh Qh Kh"

            "// verify cards are sorted by value"
            "W: checkTable"
            "                                [13]"
            ""
            "        [13]                                              [13]"
            ""
            "                2h 3h 4h 5h 6h 7h 8h 9h Xh Jh Qh Kh Ah"

            "// give each player a random set of cards"
            "N: setCards Kc 6d Qh Ad 9s Qs 3c 3d Xc 7d Kd Jd 8h"
            "E: setCards As 7h 4d Js 9h 9d 4h 2c 7c 6s 8d 8c Qd"
            "S: setCards 6h Xs 5c Ks 2d 4c 5h 3h 2h 8s Xh 2s 7s"
            "W: setCards 5d 6c Jc 9c Jh Ah 5s 3s Xd 4s Ac Kh Qc"

            "// verify cards are sorted by value"
            "W: checkTable"
            "                                [13]"
            ""
            "        [13]                                              [13]"
            ""
            "                6c 9c Jc Qc Ac 5d Xd 3s 4s 5s Jh Kh Ah"

            "// pass some cards - one not correct
            "W: pass 6c, 2s, 4s to W"
            "W: checkTable"
            "                                [13]"
            ""
            "        [13]                                              [13]"
            ""
            "                6c 9c Jc Qc Ac 5d Xd 3s 4s 5s Jh Kh Ah"

            "// pass legitimate cards
            "W: pass 6c, 3s, 4s to W"
            "W: checkTable"
            "                                [13]"
            ""
            "        [13]  [3 from S]                                  [13]"
            ""
            "                    9c Jc Qc Ac 5d Xd 5s Jh Kh Ah"

            "N: checkTable"
            "                                [13]"
            ""
            "        [13]                                              [13]"
            ""
            "                3c Xc Kc 3d 6d 7d Jd Kd Ad 9s Qs 8h Qh  [3 from W]"

Completed user stories (incomplete list)

display back of pass sets on card table. Display could be [3 from North] or [3 from Nancy] [1.5 xpu]
each player picks up pass set on demand [1.0 xpu]
reset game state before deal (0.5 XPU) - done
"pick up" pass set ("accept") (1.0 XPU) - done

Completed during Iteration 6

winner of trick gathers and adds to stack of wins ("take") [partially done - 0.5 xpu left] (GC)
write a short text document defining the syntax of Hearts commands and what they do [0.3 xpu] (TB)
document the process for starting a game and having players join in [0.3 xpu] (TB)
complete the "deal" command [0.5 xpu] (AT)
acceptance testing [2.5 xpu] (LT)
- set up game [1.0 xpu]
- execute command [0.5 xpu]
- remember table [0.5 xpu]
- assertTable(Not)EqualSaved? [0.5 xpu]

 Hearts testfile.tst
    deal
    rememberTable
    deal
    assertTableNotEqualSaved?

get "pass" command working (for some reason, this command didn't seem to work in a demo) [0.5 xpu] (EV)

Completed during Iteration 7

chat display not obscuring table [1.0 xpu]
be case-indifferent everywhere on entry [0.5 xpu]
be white space forgiving [0.5 xpu]
allow 'pass' command with white space instead of commas [0.5 xpu]
sort cards in display (using fixed sort order) [1 xpu]

Completed during Iteration 8

no more than 4 players allowed [0.5 xpu] LT (done)
display cards in captured tricks at the end of each round to facilitate scoring [1.5] TB (done)
- ex: Tom: .....; Sally: .....
display name on table [1.5] GC (done)
create unplay command [0.5] EV (done)

Previous record of user stories...

chat - audio [infinity xpu]
chat - text [2 xpu]
choose the dealer and store the dealer [2 xpu]
dealer shuffles [1/2 xpu]
position and identify the players [2 xpu]
record score (a command to add points to a player's score) [1/2 xpu]
display updated card table (as text) [1 1/2 xpu]
display updated card table (as gui/bitmap) [5 xpu]
card handling user stories
- dealer deals the 52 card deck to four players [1/4 xpu]
- pass 3 cards to another player [2 xpu]
- player plays a card face up into the middle, making it to be clear to all who played the card [1xpu]
- player who won trick picks up trick and piles them up [1 xpu]
- take card from trick and put back in hand if played out-of-turn [1 xpu]
facilitate scoring of tricks [punt]

infrastructure pieces we need (ie, any card above depends on doing these)

comm protocol needs to be able to demultiplex chat and game messages [1 xpu]
instantiate cards [1/2 xpu]
create game model [1 1/2 xpu]

things that need to go in the display (ie, the model)

player cards
opponent cards (backs)
trick
player names
scores
captured tricks
passed card holding area