[[TOC]]
[wiki:Haiti Haiti]
= Haiti Vol (Volunteer Management System) =

Dominic König (IRC nickname: nursix) is leading on this atm: #sahana-py

 * User Specification: This document
 * Technical Specification: [wiki:BluePrintVolunteer BluePrint Volunteer Management]

See also the New Module Development tutorial as this is new functionality for Py:
 * DeveloperGuidelinesNewModule

Keep it real simple to start with - get something usable quickly, which we can then refine later if we gets needs to do so.

----
== Status ==
 * A basic working system is operational on both the [http://haiti-orgsdev.sahanafoundation.org Dev site] & [http://demo.sahanapy.org Demo]
 1. You can create projects, and link projects to locations
 2. You can search for projects by location
 4. You can add a volunteer registration to any person
 3. You can add tasks to projects
 5. You can assign a task to any person with a volunteer registration
 6. You can update task status, or re-assign to another person

Started a "self service" menu for volunteers, currently just "My Tasks" but more to follow. However, that doesn't mean that every volunteer needs a user account - you can manage projects, tasks and volunteers without user accounts, and you can share this information across multiple instances without needing to register every volunteer as user on each instance.

Of course are any Person Registry information about volunteers also available in the Volunteer Module, such as:
 * Contact Information
 * Addresses
 * Identity Information
== !ToDo ==

  Prerequisites for volunteers:
  1. Introduce yourself to the team on #sahana at irc.freenode.org. (contact: nursix)
  2. Request Trac permission to edit this page.
  3. List yourself in the table below:

  ||'''IRC Nickname'''||'''Realname'''||'''working on||
  ||nursix||Dominic König||Blueprint, Implementation||
  ||flavour||Fran Boon||Codebase Guidance, Implementation||
  ||assad||Zubair Assad||Implementation||

  If you want to code, please see [wiki:DeveloperGuidelines Developer Guidelines]

  - Write user requirements, start with short user stories á la "As a <role>, I want to <action>". Add to the "User Stories" paragraph below.
  - Write a Blueprint to specify technical details, especially:
    - Data model
    - Workflow
    - Menu Structure
    - Forms layout (if not already specified in the model)
    - Framework integration (e.g., Person Registry)
    - Interoperability (e.g., Data exchange)
  - ~~Implement the module (Short name: "vol")~~
  - Test and eliminate bugs
  - Write Documentation:
    - Refine Blueprint
    - User Guideline

nursix is working on:
 1. You can add positions to a project and assign volunteers to positions
 2. a position can be shared among volunteers
 3. Org's can take ownership of positions, and set a payment rate
 4. Tasks will no longer be assigned to individuals, but to positions

 5. You can register how many hours a volunteer has spent in which position
 6. You can obtain reports of working hours per volunteer

 7. You can register resources (skills, tools etc.) to a volunteer
 8. You can add resource constraints to tasks
 9. resources and constraints will be used to auto-match volunteers and positions
 10. You can see position suggestions per volunteer
 11. You can see volunteer suggestions per position

More suggestions (in form of user stories) always welcome.

----
== User Stories ==

  * [wiki:ZubairAssad Zubair Assad]
  * ''add here''

----
== User Requirements ==

  * Process Ushahidi's volunteer line (like for [wiki:HaitiRMSToDo RMS]): http://200.ushahidi.com/rss.php
  * ''add here''

----
== !BluePrint Suggestions ==

  * ''add here''

----
[wiki:Haiti Haiti]