*** Overview
Enhancement request to add waitlist management functionality into HeadCount.  If implemented, this is a major feature.

Currently, an addon user can define party groups (groups 1 through 8) with the following labels:
- 'Raid list' groups
- 'Wait list' groups
- 'No list' groups

Consider the following example:
1. Addon user defines party groups 1 and 2 as 'Raid list' groups.
2. Addon user defines party groups 3, 4, 5, and 6 as 'Wait list' groups.
3. Addon user defines party groups 7 and 8 as 'No list' groups.
4. A new player joins a HeadCount tracked raid and is placed in group 1 ('Raid list').  This means this player will be displayed in the user interface and also will be eligible to be tracked for attendance export and boss kills.
5. A new player joins a HeadCount tracked raid and is placed in group 3 ('Wait list').  This means this player will be displayed in the user interface and also will be eligible to be tracked for attendance export.  Since this player is in the 'Wait list', the player will NOT be eligible to be tracked for boss kill attendance.
6. A new player joins a HeadCount tracked raid and is placed in group 7 ('No list').  This player will not be displayed or tracked for anything.

Often, addon users will want to add a member to the waitlist who is not in the actual raid.  This would allow members who are not in the actual raid group to be tracked.

*** Functionality
1. Configuration options
1.1 Announcement channel (Options: guild, officer, party, etc.)
1.2 Announcement duration

Use cases:
* Addon owner would accept waitlist whispers for the duration of the tracked raid.
* Addon owner would accept waitlist whispers for a period of time, but what would be a reasonable range?  (1 minute - 30 minutes).

2. Waitlist announce
2.1 Addon user initiates a new waitlist announcement (via command-line, dropdown configuration, or user interface).
* Active raid
** No current waitlist announce in progress: New channel announcement that whispers are being accepted.  Whisper acceptance timer begins for configured duration.
** Current waitlist announce in progress: Existing timer stops.  New channel announcement and acceptance timer begins.
* Non-active raid: Display warning message that waitlist announce cannot occur because there is no active raid.

2.2 Player whispers addon user, "Hello".
* Active raid
** No current waitlist announce in progress: No response.
** Current waitlist announce in progress: No response.
* Non-active raid: No response.

2.3 Player whispers addon user, "waitlist gjdfkgjdflgjkl".
* Active raid
** No current waitlist announce in progress: No response.
** Current waitlist announce in progress: Respond to player that the waitlist operation is invalid with proper command list.
* Non-active raid: No response.

2.4 Player whispers addon user, "waitlist add".
* Active raid
** No current waitlist announce in progress: No response.
** Current waitlist announce in progress
*** Player is already on waitlist: Respond to player that he or she cannot be added because he or she is already on the waitlist.
*** Player is not on waitlist
**** Player is in the actual raid in a 'Raid list' group: Respond to player that he or she is already in the raid and will not be added to the waitlist.
**** Player is in the actual raid in a 'Wait list' group: Internal error.  Respond to player with internal addon error message.  If player is moved to a wait list group, they should be automatically added to the wait list.
**** Player is in the actual raid in a 'No list' group: Add player to waitlist and respond to player with success message.
**** Player is not in the actual raid: Add player to waitlist and respond to player with success message.
* Non-active raid: No response.

2.5 Player whispers addon user, "waitlist remove".
* Active raid (feature is not dependent on whether or not waitlist announce is active)
** Player is already on waitlist: Respond to player that he or she has been removed from the waitlist with success message.
** Player is not on waitlist: Respond to player that he or she cannot be removed because he or she is not on the waitlist.
* Non-active raid: No response.

2.6 Player whispers addon user, "waitlist status".
* Active raid (feature is not dependent on whether or not waitlist announce is active)
** Player is already on waitlist: Respond to player that he or she is currently on the waitlist.
** Player is not on waitlist: Respond to player that he or she is currently not on the waitlist.
* Non-active raid: No response.

2.7 Active raid ends in middle of whisper acceptance duration.
Timer is canceled.  Raid is finalized.  Raid tracker is set to no active raid in progress.

3. Manual waitlist addition
3.1 Addon user manually adds player to the waitlist via command-line.
* Active raid
** Player is already on waitlist: Display warning message that player is already on the waitlist.
** Player is not on waitlist
*** Player is in the actual raid in a 'Raid list' group: Display warning message that player is already in the raid and will not be added to the waitlist.
*** Player is in the actual raid in a 'Wait list' group: Internal error.  Display error message that an internal addon error has occurred.
*** Player is in the actual raid in a 'No list' group: Add player to waitlist and display success message.
*** Player is not in the actual raid: Add player to waitlist and display success message.
* Non-active raid: Display warning that player can not be added to the waitlist because there is no active raid.

4. User interface waitlist removal
4.1 Addon user chooses to begin waitlist rollcall announcement.
* Confirmation box displays with 'Yes/No' or 'Confirm/Cancel' options.
** Addon user selects to begin waitlist rollcall announcement operation: Begin procedure in Waitlist announce design section.
** Addon user select to cancel waitlist rollcall announcement operation: No action taken.

4.2 Addon user navigates to waitlist display and selects to remove player from the waitlist.
* Confirmation box displays with 'Yes/No' or 'Remove/Cancel' options.
** Addon user selects to remove player: Player is removed from the waitlist.
** Addon user selects to cancel operation: No action taken.

5. Manual waitlist removal

6. Raid organization
6.1 Player is moved by a raid leader or raid assistant from a 'Wait list' group to the 'Raid list' group.
*  Should waitlist flag be set to false or remain true in this scenario?  If the flag is set to false, then moving a player to a raid list group will always automatically remove the player from the waitlist.  If the flag is set to true, then it is designed that once a player is on the waitlist, the only way to remove the player is to remove him or her manually.  This may be grounds for a configuration option, but it is a slippery slope.  It may be best to commit to one way or another.

6.2 Player is moved by a raid leader or raid assistant from a 'Wait list' group to another 'Wait list' group.
* No action.

6.3 Player is moved by a raid leader or raid assistant from a 'Wait list' group to the 'No list' group.
* No action (player is moved to no list group, but waitlist flag remains).

6.4 Player is moved by a raid leader or raid assistant from a 'Raid list' group to another 'Raid list' group.
* No action.

6.5 Player is moved by a raid leader or raid assistant from a 'Raid list' group to the 'Wait list' group.
* Set waitlist flag to true (this is different than the waitlist group flag).

6.6 Player is moved by a raid leader or raid assistant from a 'Raid list' group to the 'No list' group.
* No action.

6.7 Player is moved by a raid leader or raid assistant from a 'No list' group to the 'Raid list' group.
* No action.

6.8 Player is moved by a raid leader or raid assistant from a 'No list' group to the 'Wait list' group.
* Set waitlist flag to true (this is different than the waitlist group flag).

6.9 Player is moved by a raid leader or raid assistant from a 'No list' group to another 'No list' group.
* No action.

6.10 New player joins the raid and is first placed in a 'Raid list' group.
* No action.

6.11 New player joins the raid and is first placed in a 'Wait list' group.
* Set waitlist flag to true (this is different than the waitlist group flag).

6.12 New player joins the raid and is first placed in a 'No list' group.
* No action.

6.13 Existing player leaves the raid group.
* No action.

7. Waitlist user interface display

- Notes
1. Care needs to be taken if and when this feature is implemented because a wait list is an artificial construct that is also not supported by the standard WoW API.  Assumptions will need to be made, so choose carefully.

It is considered to big of an overhead to track how long a player is on the waitlist.  If a player whispers to join the waitlist, then that player will join the raid at the specified time in the waitlist group with the waitlist flag enabled.  On the following raid update, since that player is not in the raid, he or she will automatically be moved to the no list, but the waitlist flag will remain.

Example:
Name: Player
Join: 12:00:00
Leave: 12:00:05

That being said, it may make sense to track the time when the player was given the waitlist flag for ordering the players properly in the display.  This would reduce some of the overhead for time tracking.

Also, it may be a good idea to extend this feature for purposes of boss tracking.  If implemented, this feature enhancement will be present in a separate work ticket.

- Basic use cases
1. The addon user can determine which player has priority to join the raid group once an available raid group spot becomes free.
2. The addon user can add users outside the scope of the actual raid to the waitlist, thereby tracking players who are not explicitly in the raid group.

---

Initial configuration options:
* Announce wait list - Announcement is made to configured channel that waitlist whispers are now being accepted.
* List wait list - List all players who are currently on the waitlist to the configured channel.
* Broadcast channel - The default chat channel to use for wait list information broadcasts.
* Duration - The amount of time to accept wait list whispers once an announcement has been made (0 minutes - 30 minutes).  If set to 0 minutes, HeadCount will accept waitlist whispers as long as a raid is active.
* Automatic removal - If enabled, HeadCount will automatically remove a player from the wait list if they are moved into a raid list group.  If disabled, HeadCount will not remove a player's wait list status even if they move into a raid list group.
* Display incoming whispers - If enabled, incoming wait list whispers will be displayed in the chat frame.  If disabled, incoming wait list whispers will be squelched.
* Display outgoing whispers - If enabled, outgoing wait list whispers will be displayed in the chat frame.  If disabled, outgoing wait list whispers will be squelched.
* Add player - Manually add a player to the wait list for the currently active raid.

User interface changes
* Announce button - A new announce button will be present above the raid history frame.  This will be a modal frame.  The announce frame will allow users to select what type of announcement they wish to make to a selectable channel.  The following announcements will be allowed (Announce wait list, List wait list members, List all raid members).

Configuration options (initial revision)
* Announce wait list - Announces that the wait list is active via a chat channel message.  Also, enables wait list message acceptance for a configurable duration.  If no current raid is active, no announcement is made.
* List wait list - Lists the current raid's wait list via a chat channel message.  If no current raid is active, no announcement is made.
* Announcement duration - Can be set between 0 minutes and 30 minutes.  If set to 0 minutes, wait list acceptance is allowed for the entire raid.  If set to a non-zero value, the announcement lasts for this amount of time.  Once the duration is complete, the wait list message acceptance will be disabled.
* Raid list automatic removal - If a player who is waitlisted joins a raid list group, their waitlist flag is automatically removed.
* Display incoming messages - If enabled, incoming wait list messages are displayed as normal.  If disabled, incoming wait list messages are hidden from the addon user.
* Display outgoing messages - If enabled, outgoing wait list messages are displayed as normal.  If disabled, outgoing wait list messages are hidden from the addon user.