= Use Cases = [[TOC]] == User Stories == === Before the Event === ==== Registering an HCT Organization ==== ''Oxfam, as a member of the HCT, is keen on using the system to implement the system with their facilities, supply items, kits, & packages, and give access to their employees to submit requests and manage the logistics of supplying goods and services for each request.'' 1. Oxfam country manager 1. opens the ShaRe application in her browser 1. clicks on Contact Us provided through the Menu 1. fills in her name, email, organization name, and a short comment 1. then clicks the submit button 1. immediately, she receives an automatic email saying that someone will contact her before 24 hours 1. ShaRe SysAdmin 1. receives an email from the system with respect to the Oxfam contact us message 1. then forwards the email to the HCT members to authenticate 1. receives the green-light to add Oxfam to the system 1. create a new user using the information received through the contact us message 1. username = email address 1. password = changeme 1. first name = name found in message 1. last name = left blank 1. Organization = creates a new organization called Oxfam 1. clicks the submit button; the system automatically sends an email to new user 1. Accesses the new user account to edit it and sets the role = Org Admin 1. === During the Event === ==== Declaring an Event ==== ==== Self-registration of relief assistance (Agency) ==== ''The HCT conducts a rapid joint assessment in areas affected by flooding and landslides to determine the immediate response needs of the affected communities. They identify across the selected sector-response areas: Shelter and NFI, WASH, Health, Food Security, Protection, and Education.'' '''Nuwan - I don't believe the below selection of a site and evacuation of families would be conducted by HCT actors, I will try to make a clearer version of the below story in the Google Drive''' 1. UNICEF and IOM (HCT members) visit several Divisions (L3 areas) in an affected District (L2 area) a. they assessed for any gaps in protection considerations and immediate assistance that can be provided for home repair or temporary shelter a. in Division-A, they realize the need for a temporary evacuation center a. A member of the evaluation team, with Request Logger role, accesses the system to record the need i. He records that 56 families need temporary shelter i. provides a breakdown of elders, adults, children, male, female i. indicates the area of the villages of Division-A where the affected families reside i. '''selects next operation = "assign to HCT"''' (i.e. not available for non-HCT members in system to commit. i. The system prompts user asking to select an Org, he selects UNICEF. i. Upon submit an email is sent to the UNICEF response team. 1. UNICEF response team member a. locates a nearby school to repurpose it as a temporary evacuation centre a. the team member contacts the school principal to obtain permission to adopt the facility a. a. in Division-A, they repurpose a school to serve UNICEF, in an assessment of a (a repurposed school) in Elapatha DSD, identifies a number of potential protection issues regarding the quality of the tents in use (e.g. lack of quality lighting for inside/outside tent, lock and zip located outside tent rather than inside) UNICEF identifies that the Grama Nilhadari and other local authorities are not able to provide the items and have not received information from Colombo on whether any of these items are available UNICEF calls regional warehouse, notified that the identified number of required tents at this standard and with portable, personal lights are available at this warehouse. The UNICEF Information Management Officer at the warehouse opens the ShaReHub platform and enters this information (reporting that UNICEF has identified the need and is able to provide the required response) The activity is marked as “in progress” in the system and the location of the activity is marked on the map This information is shared with the Ministry (both a focal point in the NDRSC and the EOC) and the humanitarian community via an email link Warehouse dispatches the items, marking this in the system At the delivery of the items, the UNICEF team has moved on to another camp. The appointed local official in charge of the evacuation site calls the UNICEF team to inform them. The UNICEF team report the delivery of the items to the warehouse where the activity is marked as complete (at XX time and date) in the system and map. (noted on the system that UNICEF/Protection or Shelter Sector actor/local authority should check back in 3 days on the state of the items and to assess whether they are meeting the needs of the affected people) ==== Shelter equipment for landslide victims ==== 1. A Local-Gov-Official visits the landslide site in Haputale a. identifies that 12 families have lost their homes and need shelter a. Calls the Gov National hotline (0112 555 1212) to request for assistance 1. Hotline staff, with Request_Logger role, answers the call a. Accesses the system and is presented with the Request form a. She asks the following questions to record the information i. Who am I speaking with? Local-Gov-Official provides his name i. How can we contact you? Tells his mobile number i. What is your affiliation and designation? Local Gov-Official i. What is your need? I need shelter equipment for 12 families, All of them need tents (or a facility), bedding, water, latrines; there are 18 women, 12 men, 3 children (< 5 yrs), 5 children (> 5 yrs), 5 elderly are in the group i. Where are the victims located? About 100m from the Olive Hiltop hotel; Haputhale, Uva Province i. She opens the map to find the location and marks it on the map i. '''selects next operation = "advertise request"''' a. She enters all the data and submits the request a. Upon submission i. Local-Gov-Official receives an SMS with the Request reference code and URL to view the entry 1. email & SMS is sent out to registered Div-Gov-Official (Divisional) with role = Request_Approver 1. Div-Gov-Official, aware of the situation a. clicks on the URL in the email to login and access the request a. she reviews the details and clicks the Approve button a. Upon approval an email is sent out to all the registered Donors (Suppliers) with the Request URL 1. Oxfam manager (HTC member) a. Finds out that the warehouse at the their Kandy office has all the requested items. a. The manager access the system to set the request status = committed a. The manager calls the "shelter management team" to prepare for dispatch a. Confirms with the the warehouse clerk with the equipment preparation a. Prints a delivery note from the system with the contact details of recipient (Gov-Official) and the delivery location information a. When the delivery truck leaves the warehouse, the manager updates the system to set the request status = dispatched (SMS is sent to the Gov-Official with the status update) 1. Local-Gov-Official a. Receives the equipment and the Oxfam personnel set it all up a. He calls the Gov National hotline (0112 555 1212) to report that the request has been completed 1. Gov hotline staff a. asks the Local-Gov-Official for the request reference code a. finds the request in the system a. sets the request status = complete a. the system sends an email to designated Evaluators in the respective Division check on the supplies 1. Oxfam shelter management team leader a. takes a few photos with his phone a. uploads them through the comments section of the particular request (no login required) 1. Evaluator, with Communications role, visits the location after 24 hours a. she takes photos with her mobile handheld a. returns to her desk to access the particular request (view only & comment only) a. uploads the photos and writes a comment commending the donor and expressing 4 out of 5 star satisfaction. 1. A Citizen Journalist (e.g. from [http://groundviews.org/ Groundviews]) a. finds the request in the system a. writes a short comment on the status and uploads a photo (no login required) == Use Case Diagrams == === Registering and Managing Users === There are four types of users: 1. Overall '''SHARE system administrator''', appointed by UN RCO and the HCT community, is responsible for a. verifying the user registration requests a. granting permissions to users 1. '''HCT organization administrator''' manages the organization specific: a. sites, facilities, and other relevant information a. creating users and granting permissions 1. Wider humanitarian community a. reporting aid requests ('''Requester_Logger & Request_Approver)''') a. supplying aid goods and services ('''Supplier''') [[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/BluePrint/ShaRe/UseCases/Register_Users.png)]] === Submit and Verify an Aid Request === 1. Authorized Request Logger receives a request for aid a. it is logged using the request type specific form a. includes identifying predefined item kits/packages and request site (location) 1. Upon submission of the request, the system prompts Request Logger to a. select designated Request Approvers from the area a. submit an email and/or SMS requesting for verification and validation 1. Approver confirms the request to be authentic a. clicks on approval URL in the Email or SMS a. log into the system to click approve 1. Upon approval the request is confirmed and made visible for processing [[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/BluePrint/ShaRe/UseCases/Request_Aid.png)]] === Supply Items and Verify Delivery === 1. Org Admin defines the a. supply items, kits, and packages a. locations for collecting the items (i.e. drop-off or assembly point) 1. Donor (Supplier) filters through list of requests to a. search for specific request (i.e. by location or category) a. commit to the request and specifies the items (goods & service) and quantities a. arranges for gathering and delivering the items to the requested location 1. Upon delivery and receipt of all items, the Requester updates the status = complete [[Image(http://eden.sahanafoundation.org/raw-attachment/wiki/BluePrint/ShaRe/UseCases/Supply_Aid.png)]] === See 4W reports === === Publish Sitreps & summary reports === === and a Another ===