= Occupy Sandy =
[[TOC]]

= Phase 2 =

[BluePrint/OccupyProjects Sandy Relief Phase Two Blueprints]
= Phase 1 =

[http://interoccupy.net/occupysandy/ OccupySandy] is a project to support the survivors of Hurricane Sandy by mobilizing the local community.

== Using Sahana ==
* [http://eden.sahanafoundation.org/raw-attachment/wiki/Deployments/Sandy/Occupy/Comms_Volunteer_Sahana_User_Onesheet.pdf One Page Guide] for new Comms staff
* [UserGuidelines/Tutorial/RequestAndInventory User Guide for Requests & Inventory]
* The list of gDocs (being replaced): https://sites.google.com/site/occupysandydocs/

== Working on Sahana: Technical Information ==
* Sahana instances (Please only register if you are actively working on the project)
 * Production: http://sandyrelief.sahanafoundation.org
 * Test: http://sandyrelieftest.sahanafoundation.org
  * Can be used to test data imports and other training with dummy data
  * Can be used to test new code
  * Database refreshed from Production to test database migration during upgrades
  * '''How to get an account''': To get a test account, it's best to instead sign up on the production site, where your login will automatically be transferred to test every so often. Alternatively, approvals for the test system are forwarded to the occupy mailing list.
* Code
 * Trunk with !SandyRelief template: https://github.com/flavour/eden/tree/master/private/templates/SandyRelief
* Bugs to fix
 * [http://eden.sahanafoundation.org/report/37 Open Tickets]

=== Developers: Getting started ===
1. [http://eden.sahanafoundation.org/wiki/InstallationGuidelines Set up Sahana on your local machine]
2. Once you've run Sahana once, you will have a file called models/000_config.py
 1. Update this file to use the SandyRelief template to see Erica's beautiful theme & have the other relevant settings.
 2. Also uncomment the settings.base.prepopulate = ["IFRC_Train"] line to get sample data. [This is obsolete.]
3. Go through the tutorial in the online book: http://eden.sahanafoundation.org/wiki/Book
4. To log in to your local instance: username admin@example.com, password testing
5. Join the community: http://eden.sahanafoundation.org/wiki#Contact
 1. Use the #SandyRelief channel on Freenode IRC as that is where the users of the system will be
 2. Ask questions and say hello on the email lists:
  * Desired Functionality: [http://lists.occupy.net/lists/info/sahana sahana@lists.occupy.net]
  * Sahana Eden (the global project): [https://groups.google.com/forum/?fromgroups=#!forum/sahana-eden sahana-eden@googlegroups.com]
6. [https://eden.sahanafoundation.org/login Open an account] on this website to get access to the bug tracker.

== Requirements ==
These should be written as User Stories: BluePrint/Guidelines

Raw:
* Phase 2 "Sandy Relief" gdoc: https://docs.google.com/document/d/14P57OQBQ71WF3Bjjm-WoEd0G4tr0J-TtUrF6DqU2ZuE/edit
* Phase 1 "HelpNY" gDoc: https://docs.google.com/document/d/1ZUiAiEozox5dZbgf3W_JK3CZMx0xfNNjg67bGb24-1M/edit
* Hackpad: https://hackpad.com/uWF14mmRQqy#Sahana-Sandy
=== Requests ===
Hub Dispatchers want to log Requests into the system
* Supplies (1st priority)
* Volunteers
* Assets (needs enabling/testing)

Should we start simple, by just enabling the 'Other' type of Request so that all of the detail is in a free-text form?
- no need to fiddle with the item catalog
=== Inventory ===
Only a single process will be done:
* Daily Stock Take focussing on top 20-25 items & probably down to case level.
This will use the Stock Adjustment process, to which photos may be optionally added.
A dropdown can be used for the Item Selector.

Historical reports can also be produced from these (probably reqwuiring a little work down the line)

==== Old Ideas ====
Simplify intake form?
 * Hide CTN
 * Hide Price per Pack
 * Hide Status

Should we use simplified process for adding Stock? (i.e. direct access without going through stock adjustment. This is the current setting in HelpNY template)
* Also add ability to Send Shipment without having Stock yet added to Warehouse & record negative stock
 * This still allows accountability, so separate switch: inv.send_item_without_stock = True
 * /eden/inv/send/1/track_item currently has Item as a Dropdown from Warehouse Stock

Improve Item Selector
* Autocomplete+Add (nursix)
 * http://www.aliaspooryorik.com/blog/index.cfm/e/posts.details/post/adding-data-to-jquery-ui-autocomplete-342

Stock Reports should be visible to Public
* Transparency
* Make it clear what is NOT needed
=== Volunteers ===
==== Registration process ====
Current Registration form (which feeds CiviCRM):
* http://interoccupy.net/occupysandy/volunteer/

Implementation Notes:
* BluePrint/UserManagement

==== Sign-up to 'Tasks' (Skills Requests) ====
Port from Give2LA branch?
* https://code.launchpad.net/~flavour/sahana-eden/la

==== 'Sync' (!Import/Export) volunteers between Sahana & CiviCRM ====
nursix looking at with Jamie & Joseph from Occupy
* http://projects.occupy.net/projects/owsoutreach
* CiviCRM Imports: http://book.civicrm.org/developer/current/techniques/imports/
* Sahana REST API: wiki:S3XRC/RESTfulAPI
* [wiki:BluePrint/CiviCRMSynchronisation CiviCRM Data Synchronization]

==== Allocations of Volunteers to Tasks ====
Shoudl we buildon the Rostering tool?
* UserGuidelines/Rostering

=== Mapping ===
Hubs, Distribution Centers, Medical Clinics & Residential Buildings are all Types of org_facility.

This allows a common /map view & popup definitions.

* Types w diff Icons DONE
* Color-coding by whether they have an open / urgent request?
* !OnHover tooltip to show description DONE
* Click to show Requests (custom popup representation) DONE

* Embeddable map in other websites (iframe with flexible size) DONE

* Sync data with Google Fusion Tables?
 * At least write back to Fusion as this feeds Google Crisis Response
 * http://support.google.com/fusiontables/answer/2571232/?hl=en&

=== Recurring Requests ===
Fran DONE (mostly)

e.g. 3 people needed to serve hot food at lunch and dinner at this location - repeats daily
* Simple UI to the Scheduler - like is done for Sync currently

=== Smartphone access to forms ===
Need to define exactly which forms & decide whether to write custom /m pages for these forms or else develop a Mobile Theme (autodetected vuia WURFL?)

* BluePrint/Mobile/Portal

=== SMS Communications ===
We have access to the OccupySMS gateway (!MobileCommons) for both Inbound & Outbound SMS
* Inbound uses shortcode 69866 and is shared, so not all keywords are available for us.
* http://occupysms.org
* https://docs.google.com/document/d/1cGiQN9MRlYEXdjDHs1F60yuqCj9OpC4Y2xAawEQmb2w/edit
* http://www.mobilecommons.com/mobile-commons-api/
* Code:
 * Original/launch: https://github.com/cjohnson7/Sandy-Response
 * Improvements: https://github.com/disantlor/OccupySMS-Web