proamlan / chirpradio Goto Github PK

As Volunteer Coordinator I want to create a new task then assign points and
volunteers to that task on the same screen.

Currently one has to create a task then go to the task assignment screen
for each assignment, which is cumbersome.

Notes: this can work just like the meeting attendance tracker: the
Volunteer Coordinator can start typing the name of a volunteer in a box
then press the tabe key to assign that volunteer.

What steps will reproduce the problem?
1. create a task with potential points of 2
2. assign that task to a volunteer
3. go back and edit the task so that the potential points become 2.5

What is the expected output? What do you see instead?

All task assignments that have not been Completed or Canceled should be
updated with the new point value.  Currently, the assigned tasks are not
updated.


Please use labels and text to provide additional information.

As Volunteer Coordinator I want to mark a task "canceled by volunteer" in
case a volunteer needs to back out of a task

As an admin I want to be able to modify an scheduled traffic log

As Volunteer Admin I want to see how volunteers found about CHIRP so that
we can track promotional efforts

Add multi select box: How did you find out about Chirp? 

that includes (and in which I can select more than one):

Friends
Chirp Website
Website other than Chirp's
News article
Record Fair
WLUW
Table at a Festival or Show
Other

And, then, ideally, a small box where I can write in the name of the
website or friend or festival if they give it.

As a Volunteer Coordinator I want to view the list of meetings a volunteer
has attended and the status of his / her tasks so that I can keep track of
activity on an individual volunteer level.

A DJ currently has to enter a title for a review.  Remove the title field
so that they just enter the review.  Also remove title from the preview and
rendered review.

When a DJ enters or deletes a live, on-air playlist entry, this should be
published to the live site.

The Playlist Tracker runs on Google App Engine but the live site runs in a
PHP site on Mediatemple.

To make this happen in realtime, some ideas:
- Use the task queue API to signal an add/delete change -
http://code.google.com/appengine/docs/python/taskqueue/
- Implement something sophisticated like PubHubSub (publish/subscribe)
using http://code.google.com/p/pubsubhubbub/

Open questions:

- What format should it be sent to the live site in?  Probably XML or JSON.
- What form of authentication should be used to ensure the playlist data is
coming from the right place?  A simple public/private key?  Full blown PGP?
 Or OAuth?  http://oauth.net/

only the on-air dj should be able to read/log traffic log entries

As a Volunteer I want to login and see a list of tasks that I have
committed to. 

See VolunteersCanViewCommitments for details

As a Volunteer I want to login to the tracker and mark my finished tasks as
completed so that the Volunteer Coordinator doesn't have to do this for me.

Note that this is similar to Issue 23 but will be a much simpler change
form.  Just one button, "done" !

Also note that the Volunteer will not be able to set the points allotted
for the task since that is controlled by the Coordinator.

When tasks are marked completed, the Coordinator will still need to
*approve* the completed task so she should receive an email prompting this.

As Volunteer Coordinator I want to filter task assignments by volunteer so
that management is quick and painless.

From Jenna: It would rock if I could "search" on the task assignment screen
- i.e. be able to type in a volunteer name or a task title or date and jump
to just those tasks

As a DJ I want to browse through the library for core, local, and heavy /
light rotation items so that I can add items to my shelf for my show.

The links to each item should be very prominent, probably somewhere in the
top menu (e.g. a link to Core, a link to Local, etc)

See issue 48 which will let the Music Director mark albums with these
categories.

core : these define the "CHIRP sound"
local : these are local Chicago albums, new or old
heavy rotation : these are brand new releases
light rotation : these are recent releases

As a DJ I want to add freeform tags to songs, albums, and artists so that
we can start to organize the library by tag (i.e. cross pollinate).

The DJ should be prompted to autocomplete a tag when it already exists so
that we don't end up with two tags that are spelled differently (e.g. psych
vs. psychedelic)

As Music Director I want to mark albums as core, local, heavy / light
rotation so that DJs can find them.

core : these define the "CHIRP sound"
local : these are local Chicago albums, new or old
heavy rotation : these are brand new releases
light rotation : these are recent releases

As volunteer coordinator I want the ability to make changes in bulk to the
status of tasks.  For example, I want to set all record fair tasks to
completed after the event.

What steps will reproduce the problem?
1. Create an event that lasts for a day but ends after midnight the next day

What is the expected output? What do you see instead?

The site won't let you add tasks past midnight, which is a bug.


What version of the product are you using? On what operating system?


Please provide any additional information below.


As for a fix?  The duration in days should probably be replaced with an
explicit end time for the event.

As Volunteer Coordinator I want to enter in the list of volunteers from the
sign up sheet so that over time CHIRP can track the attendance rate of its
volunteers

The interface for this should make it as easy as possible to enter in
names.  There will be a lot of names to type.  I'm thinking some kind of
ajax screen with a text box that autocompletes to a known volunteer and
saves as you work.

As Volunteer Coordinator I want to name meetings so that I can browse them
easier when auditing the point tally system.

Note that there is a separate story where volunteer coordinators want to be
able to track attendance for multiple meetings on the same date.  This
should help fulfill that story too.

only the on-air dj should be able to read/log traffic log entries

As a Committee Head I want to post tasks that volunteers can claim and
maybe even present them in order of priority.

As an traffic log admin, need to be able to search for spots to assign to a
time slot (constraint).

Should be displayed on the the default spot list page.

initial go at traffic log on appengine, will have all the log entries for a
particular day listed by hour:slot... should use some ajax-fu to log
readtime's with out reloading page

All volunteer users need to be migrated from sqlite to App Engine so that
DJs and volunteers can login and use the new system.

We may have to run this migration script several times so be sure it does
not import duplicate users.  

Also, I'm not sure how to handle auth.  We will probably need to have a
flag in the database that forces migrated users to reset their password the
first time they log in to app engine?

Jon W I'm making you the owner of this but I'm also cc'ing Jon T so he can
help with the auth stuff.

To support Issue 15 we need a more concurrent database like PostgreSQL. 
Details about the migration are in MigrateSqliteToPostgresql

As a Volunteer Coordinator I want to add event-based tasks. 

See CoordinatorCanMakeEventTasks for details

old log functionality to be ported... using a js clock function, scroll the
log page to the current hour, and "activate" readtime checkboxes for that hour

http://code.google.com/p/chirpradio/source/browse/traffic_log/models.py?spec=svn
96bda143135caddd161e4dbe4d53807e1d01fa77&r=f8278ca568343ae0f07c22f731b05135e0329
c15#24

For volunteer screen:

- Change the heading of "Active in these Committees" to "Interested in
these Committees" - at least until I know if/how I am actually going to
track who is active in what, says Jenna.

- Add the following fields:

Emergency Contact Name:
Number:
Relationship:

"DJ's are encouraged to enter items as they are happening so that the time
is correct, not let them batch up."

I agree it is good to do it realtime, cuz batching it sucks.  but in the
event that it does get batched, it would be good to let them take a guess
at what time the event happened.  

Also, make it easy to back up the time by like 10 seconds - if the event
started a min ago, hit the button 6 times.

As Volunteer I want to login to the Volunteer Tracker and claim a task. 

See VolunteersCanClaimTasks for details

As a DJ I want to see a red box and warning when I enter an item not in the
database so that I don't spell something wrong or make a mistake.

Currently, the artist name, track name, or album name is auto-completed
when it exists in the library.  The input box should turn red or something
if a name is entered that is not auto-completed.  In other words, we should
discourage DJs from entering items freehand.

Currently non-JavaScript browsers (like on a Blackberry) cannot claim
volunteer tasks.  This can be solved by making a static version of the task
claiming interface.

Note: I started this but didn't finish.  Here is the diff so far - Kumar

Each time a volunteer attends a meeting (as noted by the meeting tracker) then 
she should earn 1 
hour of volunteering time.

As a volunteer I want to login and enter info about a task I did so that
Jenna (Volunteer Coordinator) doesn't have to.  Jenna will still need to
*approve* the task and hours after it has been entered.

The screen for volunteers would look like:

- Date of task
- Time frame of task
- Type of task (have this be a pull-down screen with some very basic options)
- Description of task (if unclear from task type)
- For which committee (again, a pull-down with the option of "Unknown" so
that Jenna can fill it in in case the volunteer is not sure)

As Volunteer Coordinator I want to create volunteer users easily

So that I can add volunteers faster

_

Currently you have to add volunteers by 
1) going to the Users section
2) entering a username / password
3) adding the user to the right groups
4) mark as staff

This takes many screens and #3 and #4 should be automatic.  Maybe the
volunteer screen can be modified to allow all this on one screen.

As Volunteer Coordinator I want a report that shows how many points each
Volunteer has so that I can keep tabs on the required number of
volunteering hours for CHIRP members

rename "Skills" on the volunteer screen to "Previous Experience/Skills"
rename "Additional Resources" to "Ideas for the station/Other comments"

Jenna wants to change the order/terminology for a few things on the
Volunteer "add" screen when possible.  The below order would be best as it
correlates to the order things are in on the Intake Form which will make
entering things a bit easier.

For the Volunteer File:

Name
Phone 1
Phone 2
Address with City/State/Zip
Email

Emergency Contact Info
Name
Relationship
Phone 1
Phone 2

How did you find out about Chirp? (options that are there now are great;
with the "details" box)

Previous Radio Experience

Skills/Additional Resources

Boxes for Has A Car, etc (Has Equipment should be Has DJ Equipment)

Best Availability

on the volunteer screen the users dropdown box should be sorted
alphabetically by username or last name

As a DJ who is reviewing records and inputting my review into the database
I want to be able to tag individual tracks as either clean or profane. This
should alert billy to update the tags.

Some volunteers will have their dues waived.  Currently there is no option
for this on the Volunteer screen

As Volunteer Coordinator I want to view a list of volunteer who have not
yet paid dues so that I can send an email to those volunteers.

As Volunteer Admin I want to track who is interested in what committees and
/ or committee activities so that volunteers can be allocated accordingly

There is currently a dropdown for what committee a volunteer is a part of.
 Jenna has no way of knowing that yet so it should change to "what
committees a volunteer is interested in."  Also, since there can be
multiple it should be a multi-select

On intake forms, volunteers often say they are interested in "other" i.e.
Record Fair, Pitchfork, which are generally activities.  Add a text box to
enter in this info.

As a Volunteer Coordinator I want to enter data for new volunteers just
like the paper form.  See attached for an example.  This may require some
new forms but mostly will be moving around existing form fields.

Volunteer User

Name
Address w/ City, State, Zip
Phone 1
Phone 2
Email

Emergency Contact Name
Phone 1
Phone 2
Email

Dues Paid up to:
Volunteer Info Sheet on File?

Discovered Chirp by: Pulldown
Details:

Have you worked at other radio stations? If so, which ones? What did you
do? Still involved?

What skills do you bring to CHIRP? Have a car? Equipment to use at CHIRP
events? Know
computers? Are you a carpenter? A plumber? Know a lot of folks at record
labels?

Checkboxes for:
Car
Has DJ equipment

What ideas do you have for CHIRP?

Generally, what is your best availability? (Evenings/weekends/etc)

Anything else we should know?

Active in these committees: Highlight-able box.

On task assignment screen, Completed checkbox is unecessary since status
can be set to Completed.

As Volunteer Coordinator I want to prevent volunteers from claiming tasks
until I'm done entering all tasks for an event.  This is so that they don't
claim a task that might later get edited, deleted, etc, while I'm sorting
out the event.

Kumar: Maybe a checkbox would be sufficient for this.

From Jenna: when I create tasks for these events, it would be sweet if I
could just "duplicate" a task and maybe just change the date or time, etc,
to create a new one with most of the same details as the original to help
speed things along.

- maybe task types should be expanded for this case? (Kumar)

As a DJ I want to manage items from the music library on a virtual shelf so
that I can prepare some songs to play on an upcoming show.

A DJ should see a button next to songs to add to her shelf.  A DJ should be
able to see items in the shelf on a separate screen.  And also maybe in a
sidebar?  A DJ will also want to remove items from the shelf easily.  It
would be nice if there was a Clear Shelf button for after a show is over.

FYI, the term "shelf" was chosen to model the online library after a
physical music library in a radio station.

When a DJ enters or deletes on-air playlist entries, those need to be
reflected in real time on the live site.

The live site runs in PHP and thus a simple PHP script needs to be written
that accepts a request that communicates the following:

For posting new entries:

- name of track played
- name of artist
- name of album
- name of label
- DJ who played the track
- time the track was played

It should return an ID number

For deleting entries:

- ID number to delete

Note that updates will be done by a delete followed by a post.

The easiest thing is to make this RESTful.  I.E. send a POST request to
add, send a DELETE request to delete.

Note that the push operation is covered by Issue 43